Skip to main content

Nostr

This is a shipped config-backed outbound surface. Nostr relay subscriber runtime is not implemented yet

At A Glance

FieldValue
Catalog idnostr
Config keynostr
Implementation statusconfig_backed
Transportnostr_relays
Aliasesnone
Default send target kindaddress

Minimal Config

[nostr]
enabled = true
relay_urls_env = "NOSTR_RELAY_URLS"
private_key_env = "NOSTR_PRIVATE_KEY"

Smoke Test

loong nostr-send --text "hello from loong"

Command Surface

OperationCommandUsage or status
relay publishnostr-sendUsage: loong nostr-send [OPTIONS] —text <TEXT>
relay subscribernostr-servenostr relay subscriber runtime is not implemented yet

Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enablednostr.enabled
nostr.accounts.<account>.enabled
nonenone
relay urlsnostr.relay_urls
nostr.accounts.<account>.relay_urls
nostr.relay_urls_env
nostr.accounts.<account>.relay_urls_env
NOSTR_RELAY_URLS
private keynostr.private_key
nostr.accounts.<account>.private_key
nostr.private_key_env
nostr.accounts.<account>.private_key_env
NOSTR_PRIVATE_KEY

Gateway And Ownership

This surface is a direct-send delivery lane. It does not join multi-channel-serve or the gateway-owned reply-loop contract today.

Operator Notes

  • Nostr send publishes signed notes to one or more relays. The relay-subscriber serve contract remains planned.
  • Continue to Channel Guides for the full shipped channel matrix.
  • Continue to Channels for the conceptual surface model.
  • Continue to Channel Setup for the shared public setup contract.