`broadcast` — publish events to relays

Publishes one event to the given relays and prints a per-relay result (OK, REJECTED, or NO-RESPONSE). Accepts three kinds of input:

Pre-signed event JSON — sent as-is (no signer needed).
Unsigned event JSON or inline build (--kind + --content) — signed with --privkey or the active accounts login identity.
Build a text note inline — --kind 1 --content "..." plus a signer.

ndk broadcast [options] <relay> [relay ...]

Event source (exactly one required):

Option	Description
`--event <json>`	Inline event JSON
`--file <path>`	Read event JSON from file
`--stdin`	Read event JSON from stdin (pipe or interactive)
`--kind <int>` + `--content <text>`	Build an unsigned text note inline
`--pubkey <hex\\|npub>`	Pubkey for inline build (defaults to active account)

Signing:

Option	Description
`--privkey <hex\\|nsec>`	Sign with this key (overrides the active account)
(none)	Use the active account from `ndk accounts login`

Output control:

Option	Description
`--relay <url>`	Target relay (repeatable; also accepted positionally)
`--timeout <sec>`	Per-event broadcast timeout (default `10`)
`--consider-done <0..1>`	Fraction of OKs to wait for (default `0.5`)
`--no-cache`	Don't save event to local cache

# publish a text note using the active account
ndk accounts login nsec nsec1...    # one-time
ndk broadcast --kind 1 --content "hello from ndk cli" relay.damus.io nos.lol

# publish a text note with an explicit private key
ndk broadcast --kind 1 --content "hello" --privkey nsec1... relay.damus.io

# broadcast a pre-signed event from a file
ndk broadcast --file signed.json relay.damus.io

# broadcast a pre-signed event piped on stdin
cat signed.json | ndk broadcast --stdin relay.damus.io

# custom OK threshold and timeout
ndk broadcast --event '{...}' --consider-done 1.0 --timeout 20 \
    relay.damus.io nos.lol relay.nostr.band

Exit code is 0 if at least one relay accepted the event, 1 otherwise.

broadcast — publish events to relays

`broadcast` — publish events to relays