aiolabs/nostrrelay
9
0
Fork 0
Code Issues 8 Pull requests Projects Releases 2 Packages Wiki Activity Actions
nostrrelay/README.md
Patrick Mulligan fd19acff97 fix(nip09): honour a tags in deletion requests 
A kind-5 request could only name events by `e` tag. Worse, one that
carried `a` tags and no `e` tags built a filter with an empty id list,
which matched every event by that author and marked them all deleted.

Handle `a` tags per NIP-09: parse `kind:pubkey:d` (the `d` value may
contain ':'), require the pubkey to be the request author and the kind
to be replaceable or addressable, and remove only versions up to the
request's `created_at` so a later re-publication survives. An empty
`d` addresses a replaceable kind.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Tbyw6FwjhEJg3gHfPHxWt
(cherry picked from commit e695f9c66881d3d520d40f0cd3e9c95d9435938c)
2026-09-13 17:54:00 +02:00

4.9 KiB
Raw Permalink Blame History

Nostr Relay

One click and spin up your own Nostr relay. Share with the world, or use privately.

Configure:

  • Free Plan: with limitted storage (limit can be changed)
  • Paid Plan: pay to join and pay for storage
  • Storage Limit (can buy more)
  • Rate Limit
  • Filter Limit
  • Allow/Block accounts
  • Optional Auth for Events and Filters

Supported NIPs

  • NIP-01: Basic protocol flow
    • Regular Events
    • Replaceable Events (kinds 10000-19999)
    • Ephemeral Events (kinds 20000-29999)
    • Addressable Events (kinds 30000-39999)
  • NIP-02: Contact List and Petnames
    • kind: 3: delete past contact lists as soon as the relay receives a new one
  • NIP-04: Encrypted Direct Message
    • if AUTH enabled: send only to the intended target
  • NIP-09: Event Deletion
    • e tags: delete events by id
    • a tags: delete replaceable / addressable events by kind:pubkey:d
  • NIP-11: Relay Information Document
  • NIP-12: Generic Tag Queries
    • todo
  • NIP-15: End of Stored Events Notice
  • NIP-16: Event Treatment
    • Regular Events
    • Replaceable Events
    • Ephemeral Events
  • NIP-17: Private Direct Messages
    • kind: 1059 gift wraps stored and broadcast like regular events
    • if AUTH enabled for kind: 1059: deliver only to the recipient named in the p tag (same gating as NIP-04)
    • encryption (NIP-44) and wrapping (NIP-59) are client-side concerns; the relay handles transport only
  • NIP-20: Command Results
    • todo: use correct prefixes
  • NIP-22: Event created_at Limits
  • NIP-26: Delegated Event Signing
    • not planned
  • NIP-28 Public Chat
    • kind: 41: handled similar to kind 0 metadata events
  • NIP-33: Addressable Events (moved to NIP-01)
    • ✅ Implemented as part of NIP-01 addressable events
  • NIP-40: Expiration Timestamp
    • todo
  • NIP-42: Authentication of clients to relays
    • todo: use correct prefix
  • NIP-44: Encrypted Payloads (Versioned)
    • relay treats payloads as opaque; encryption is client-side
  • NIP-50: Search Capability
    • todo
  • NIP-59: Gift Wrap
    • kind: 13 (seal) and kind: 1059 (gift wrap) accepted; unwrapping is client-side

Create Relay

Creating a new relay is straightforward. Just click New Relay then enter the Relay Info.

Note

The relay can be activated/deactivated.

  • New Relay Dialog
    • image

Configure Relay

Find your Relay in the list and click the expand button (+) to configure it.

Relay Info

This tab contains data according to NIP-11 (Relay Information Document).

Note

: the domain is added automatically and shoud be corrected manually if needed. This value is used for NIP-42 (Authentication of clients to relays)

  • Relay Info Tab
    • image

Payment

By default the relay is free to access, but it can be configured to ask for payments. It is encourage to also activate the Require Auth option for paid relays.

Note

: check the info button (I) tooltip for a description of each field.

  • Payment Config Tab
    • image

Click on the Relay ID (or visit https://{your_domain}/nostrrelay/${relay_id}) for the Relay public page. Here the entry and storage fees can be paid.

  • Relay Public Page
    • image

Config

Configure NIP-22 (Event created_at Limits), NIP-42 (Authentication of clients to relays) and other Relay parameters.

Some configurations are not standard (NIPs) but they help control what clients are allowed to do, thus blocking (some) attack vectors.

Note

: check the info button (I) tooltip for a description of each field.

  • Config Tab
    • image

Accounts

Allows the Relay operator to Block or Allow certain accounts.

If an account is allowed then it is not required to pay to join.

When an account is blocked it does not matter if it paid to join or if it is allowed.

  • Accounts Tab
    • image

Development

Create Symbolic Link:

ln -s /Users/my-user/git-repos/nostr-relay-extension/ /Users/my-user/git-repos/lnbits/lnbits/extensions/nostrrelay