Changelog
[0.8.0-rc.54]
Section titled “[0.8.0-rc.54]”- Adds a control plane to the huddle
/rtcdoor onncli relay: a client announcesmedia(mic, camera or screen sharelive/off) and saysleavebefore hanging up, the relay fans both out with each peer’s media also listed onjoined, andleftnow carriesreason(leave,evictedordropped). A stopped camera or a hang-up no longer looks like a lost connection to the other side;joinedlistsfeaturesso clients can tell. (#253)
- Fixes WebRTC huddle peers on
ncli relaynever hearing about anyone else joining or leaving: the room’s control messages were discarded for them. Revoking a peer’s relay membership now also closes its WebRTC session instead of leaving it connected outside the room. (#253) - Fixes the relay’s own NIP-66 stats (kind 30166) keeping stale zap totals until another event arrived, when the zap ranking refreshed after the stats were published. (#258)
- Fixes
ncli bunkersometimes missing its identity’s profile name and NIP-05 when a relay sent the profile and EOSE together. (#260)
[0.8.0-rc.53]
Section titled “[0.8.0-rc.53]”Changed
Section titled “Changed”- Bumps
github.com/ohstr/nmilattov0.5.0-rc.54: a private-transport item whoseparamsis present but not an object (a literalnull, string, number or array) is now refused at serve and build time, closing a cross-implementationph-mismatch (nmilat NMILAT-0010). Also carries nmilat rc.50-rc.54.
[0.8.0-rc.52]
Section titled “[0.8.0-rc.52]”- Adds a warning, logged once per peer, when per-IP limits are set and a request carries
X-Forwarded-FororX-Real-IPfrom a peer not inlimits.trustedProxies: every client behind it shares one per-IP limit. (#251)
Changed
Section titled “Changed”- Changes NIP-86 to count against
limits.http: per IP, and per signer whenperPubkeyis set, but never the admins (relay key,nip86.admins), so a flood sharing their IP can’t lock them out. A replayed header spends only the IP’s budget, and a refusal is a 429 withRetry-After. (#250, #251) - Changes the shipped public configs and the recommended
limits:block to allow 300 reads a minute per IP (burst 600) instead of 60, and 120 HTTP requests a minute instead of 60. (#251) - Changes the release workflow to fail when GoReleaser finishes without pushing
ghcr.io/ohstr/ncli:<version>, which the release’s own pins name. (#251) - Changes the JSON every command prints to keep
<,>and&as written instead of\u003c,\u003eand\u0026, such asgroup:<kind>inrelay --check --json’s warnings. (#250) - Changes releases to ship pinned to themselves: the release workflow refuses to tag unless every relay image pin (chart, stacks, examples, rigs) names the version being released. Before, a release always pinned the one before it. (#249)
- Changes the public example relay configs and the public-search stack to ship with the recommended
limits:block, so they no longer start with “no rate limits configured”. (#249)
- Fixes the Helm chart (now 0.3.1) and Compose stacks running the rc.50 relay image, which lacks rc.51’s fixes and ignores its new keys (
limits,listen,membership.roles,groups.create). They now run 0.8.0-rc.52, and the chart’s notes say which image it runs. (#249) - Fixes the relay publishing each hosted group’s kind 39001 and 39003 under the default moderation policy at every start before applying
groups.rolesandgroups.roleDescriptions, which briefly dropped every non-admin role from the group’s admin list. Both are now in place before startup republishes them (nmilat v0.5.0-rc.52). (#251) - Fixes the NIP-86 IP block not covering the HTTP bridge for some requests; only NIP-86 itself, at
/, now stays reachable from a blocked IP. (#250) - Fixes a banned key joining calls when
huddle.requireMembershipis off; a ban now refuses joins either way. (#250) - Fixes
blossom list --allreportingunsupported(exit 8) when another server failed with a retryable network error, and failing when a server answered with no blobs. It now fails only if no server answered, asnetworkif any failure was retryable. (#250) - Fixes
blossom mirrorreporting a 404 whose reason says the source couldn’t be fetched asunsupported; it is nownot_found, while a bare 404, or one like “unknown URL path”, staysunsupported. (#250, #251) - Fixes NIP-86’s rate-limit (429) and failed-login (401) answers lacking the CORS headers of
nip86.allowedOrigins, which hid them from a browser app. (#251) - Fixes unknown config keys being reported lowercased (
pprofadr); they are now named as the file writes them. A role id with a dot gets its own error instead of an unknown key. (#250) - Fixes
nip11.limitation.min_pow_difficultyandnip11.supported_nipsfailing--checkwith no hint; the error now says to usepow.min, and that the relay computessupported_nips. (#250)
[0.8.0-rc.51]
Section titled “[0.8.0-rc.51]”- Adds roles that carry tasks (
membership.roles): each NIP-43 role lists what its members may do, such as NIP-86 methods (createclaim,banpubkey), Blossom uploads, joining calls or creating groups (groups.create), and NIP-86supportedmethodstells each caller its own set. Withoutmembership.rolesormembership.members, existing settings behave as before except for the changes listed under Changed. (#243) - Adds unknown-key reporting to the relay config:
ncli relay --checkfails (invalid_input) naming every key the relay doesn’t know, such as a typo, and a normal start logs a warning for each, on stderr and in the log file; a key left with no value counts too. (#236) - Adds
listen(host:port) to the relay config, to bind one address instead of every interface onport. When set it wins overport, the admin listener’s default port and the admin commands follow it, and--checkrejects a host that does not resolve;NCLI_LISTEN/NCLI_PORTnow reach the relay even with no such key in the file. (#237) - Adds opt-in rate limits to the relay (
limits): EVENT, REQ/COUNT, the HTTP bridge and Blossom per pubkey and per IP, plus connections per IP, with members optionally exempt and refusals counted inncli_relay_rate_limited_total. A limit left unset is no limit, and a public relay without any, or a per-pubkey limit that never applies, gets a warning, also listed inrelay --check --json’s"warnings". (#241) - Adds a warning, at startup and in
relay --check, whenlistenis on loopback with per-IP limits butlimits.trustedProxiesdoesn’t cover that address: behind a local reverse proxy every client would share one per-IP limit. (#245)
Changed
Section titled “Changed”- Changes the Helm chart (now 0.2.0) and Compose stacks to pin their images: MinIO by digest, and the relay to the release candidate
0.8.0-rc.50instead oflatest, which was the 0.6.0 release. The relay pin moves to each new release. (#235) - Lets a chart image take an optional
digest, and adds the pinned MinIO digest only to the default image: pin a mirror or another tag with an exacttagor its owndigest.helm upgrade --reuse-valueskeeps an older chart’s images, so use--reset-then-reuse-values. (#235) - Changes
membership.memberClaims, when unset, to follownip11.limitation.membership_required: on a relay withmembership_requiredand NIP-86 enabled, a member’screateclaimis now refused (401) and only admins mint invites. SetmemberClaims: trueto keep the old behaviour. (#234) - Changes a NIP-43 invite request (REQ kind 28935) to need
createclaim, as NIP-86createclaimdoes: it now gives a code only to admins, members whenmemberClaimsis on, and roles that list it. Before, any connection allowed to read got one. (#243) - Changes
huddle.requireMembershipto admit the relay’s admins (nip11.pubkey,nip86.admins) even when they are not members. (#243) - Changes a banned member to lose
createclaim(NIP-86 and invite requests) and joins to calls underhuddle.requireMembership. Before, the ban only stopped its events and Blossom uploads. (#243) - Changes NIP-43 role ids to be stored lowercase:
createrole,assignrole, enrolling and invites lowercase them, andunassignrole hostalso removesHost. (#243)
- Fixes the relay’s Blossom answering 404 for a blob at the root (
/<sha256>), where BUD-01 serves it;/media/<sha256>still works.ncli blossom downloadof a full URL now fetches that URL first, then asks servers by hash, and reports a URL serving other bytes asnot_found. (#244) - Fixes
ncli blossom list,upload --optimizeandmirrorreporting a server without that endpoint asnot_foundor a retryablenetworkerror; they now reportunsupported(exit 8), and the relay says those endpoints are not supported. A 3xx, 405 or 501 from any Blossom endpoint is nowunsupportedtoo, where it wasnetworkorinvalid_input. (#244) - Fixes
relay --check --jsonlisting"warnings": []while logging thatportis ignored becauselistenis set (or thatpow.stricthas nopow.min); it now lists every config warning, and startup logs each once. (#245) - Fixes the Blossom blob URLs the relay returns having no file extension, which BUD-02 requires: they now end in one for the blob’s type, or
.binwhen it is unknown (nmilat v0.5.0-rc.51). (#243) - Fixes
POST /eventsaccepting a non-member’s event into a private, closed or restricted NIP-29 group; it now refuses it (403) as the WebSocket does, and refuses group moderation kinds and requests (9000-9022) with a 400, since they only work over a WebSocket (nmilat v0.5.0-rc.51). (#246) - Fixes the relay’s Blossom serving a blob, with whatever type its uploader gave, as a page on the relay’s own origin: every blob now comes with
nosniffand a sandboxing CSP, an untyped blob isapplication/octet-stream, and anything but images, audio, video and plain text downloads as an attachment (nmilat v0.5.0-rc.51). (#246) - Fixes NIP-86
allowpubkeyon someone already a member, which re-enrolled them and dropped their roles: it now leaves the member unchanged. (#243)
[0.8.0-rc.50]
Section titled “[0.8.0-rc.50]”- Adds option details to
ncli form(NIP-PFdetailtags): a spec option’sdetail, or theform createprompt, says what choosing it does.form showandform respondprint it under the option, and--jsonincludes it. (#227)
- Fixes GO-2026-6888 (excessive memory use decompressing a crafted brotli stream) by moving to brotli v1.2.7. (#227)
[0.8.0-rc.49]
Section titled “[0.8.0-rc.49]”- Adds
POST /count(NIP-45) to the relay’s HTTP bridge (httpBridge.count.enabled), with the same rules asPOST /query. (#224) - Adds seat notices (
groups.membershipNotices): the relay tells a member, live, when they gain or lose a seat in a group. Only that member and relay admins can read one. (#224) - Adds presence (
presence.enabled):POST /queryfor kind 40902 answers whether each author is online. (#224) - Adds Blossom on the relay’s own origin (
blossom): members upload, anyone or only members download, and files live in a directory or MinIO. (#224)
Changed
Section titled “Changed”- Changes
build/relay/todeploy/: one Helm chart with optional Meilisearch and MinIO, and a ready-to-run stack per kind of relay (dev,personal,public-search,community). Secrets reach the relay asNCLI_*variables. (#224) - Changes the relay to serve gift wraps (kind 1059) only to a reader logged in (NIP-42) as their recipient, so a signer policy must allow kind 22242 for its key to read them.
recipientOnlyKinds: []restores the old behaviour. (#224)
- Fixes
ncli blossomsigning tokens with noservertag, which servers that check it refuse. (#224) - Fixes the Docker Compose stacks never turning on profile search: they set variables the relay doesn’t read. (#224)
[0.8.0-rc.48]
Section titled “[0.8.0-rc.48]”- Adds
dm reactanddm unreact: NIP-25 reactions and their NIP-09 retractions inside NIP-17 gift wraps, to the conversation’s participants and a copy to yourself.dm readshows them asreaction/deleteentries, and--foldapplies the deletions (each only to its own author’s events) and folds reactions into the messages they react to. (#209) - Adds the signer’s
nipoa_attestmethod andattestrule (subordinates, a requiredmax_until,kinds): an attestation is signed only when such a rule allows it, so existing policies refuse every one.signer check --method nipoa_attest --subordinate --conditionsdecides one offline. (#208) - Adds
ncli id attest, which signs a NIP-OA owner attestation with--identityor through--signerand prints theauthtag, verified. (#208) - Adds
ncli form create/list/show/respond/withdraw/result: NIP-PF forms (kinds 1069, 1019, 1070) – questions with the recommended option and why, notes required on some options, defaults, quorum and an end, answered in one response and closed by the author with a result (decided, default, cancelled). A form is private (--to: gift-wrapped to each responder and to you), in a NIP-29 group (--group --relay) or public;respondrefuses a response the form doesn’t accept before anything is sent. Every rule is nmilat’snippf. (#218) - Adds the
ncli-formsskill. (#218) - Adds labels to
dmandform: an event’sttags print as#label(printable ASCII, every other rune escaped) after the author and before the subject or title, anddm send --labelsets them. (#218) - Adds
--auth(andNCLI_AUTH_TAG) to every command that signs through--signer: a NIP-OAauthtag, checked against the signer’s key, added to every event it signs whose kind and time its conditions allow – on a DM’s or a private form’s rumor too, inside the seal; never on a seal, a gift wrap or a NIP-42 login event. (#218) - Adds the signer selector
tags_one: the event must carry exactly one tag of each named key, with a listed value. Unliketags, an event with a second same-named tag doesn’t match, so a NIP-42 login can be bound to one relay. The example policies use it forrelay. (#212) - Adds
ncli nip98 <url> <method>, which prints a NIP-98Authorizationheader signed with--identityor through--signer;--payload-filebinds the request body. (#211) - Adds NIP-OA attestations to
dm read,dm verify,groups read/feedand theformcommands: anauthtag is checked,--jsongivesattested_by,attest_validandattest_trusted, and text output shows[agent of <owner>]for an owner named in--trust-owners(word:--attest-label),[attested by <owner>, owner not trusted]or[invalid attestation], in the client’s column after the author. (#219)
Changed
Section titled “Changed”- Changes subjects, titles and message lines to print a non-ASCII letter that sits beside ASCII letters as an escape (look-alikes such as a Cyrillic
е), collapse padding, and cap titles at 200 runes. (#218)
- Fixes ncli’s own NIP-98 headers (relay admin, huddle) tagging their anti-replay value
nonce, which NIP-13 reads as a proof-of-work claim, so a socket signer’s client refused them. They tagsalt, as nmilat’snip98.Signdoes; verifiers never read it, so old and new headers interoperate. (#207) - Fixes the signer charging an
unwrap_fromrule’s rate before it knew the seal’s author, so gift wraps from anyone could use up a listed sender’s rate. The rate is charged only for a wrap the rule releases; refused wraps are remembered and refused again without decryption;dm readretries a wrap refused for rate instead of skipping it. (#214) - Fixes text output printing fields a relay or another author controls (message content and subject, reactions, group, space and profile fields, decoded NIP-19/token identifiers, relay hints and labels, identity relays, NIP-85 stat values, every relay publish result, and Blossom server responses and blob listings) raw: control, separator and format characters (bidi, zero-width, tags) and invalid UTF-8 now print as Go escapes, and multi-line content stays indented, so remote text can’t forge a line, move the cursor or reorder what the terminal shows.
--jsonis unchanged. (#213) - Fixes
find -fanddm read -flosing messages: a gift wrap that didn’t open (or was dated in the future) no longer moves the resume point, a saved resume point ahead of now is dropped, and a resubscription pages back through a relay’s stored events past its per-request cap, so a backdated wrap under a flood is still delivered. (#216)
[0.8.0-rc.47]
Section titled “[0.8.0-rc.47]”- Adds the proposed NIP-86
createclaimwithlimitsandgetclaimmethods, so a host’s app can mint an invite with an explicit per-code expiry or use-limit and read any code’s state back.ncli relay invites creategains--expires-atand--no-expiry, andncli relay invites get <code>shows a code’s claim, expiry, max-uses and uses, including expired or used-up ones. (#221) - Adds the
membership.inviteMaxTTL(default 30 days) andinviteAllowNoExpiry(default false) config keys, which cap how far an absolute expiry may be set and gate never-expiring codes. A requested limit outside policy is refused, never silently clamped. (#221) - Adds NIP-43 member claims: with
membership.memberClaims(default true), a plain member — not only an admin — may mint an invite viacreateclaim, scoped to justcreateclaimandsupportedmethods. Set it false to keep the Relay Management API admin-only. (#221)
- Fixes the vault password prompt failing with
inappropriate ioctl for devicewhen the event is piped into a signing command (e.g.ncli event new … | ncli publish -e - --signer <label>). The prompt now reads from the controlling terminal, like ssh/sudo, and falls back to a clear “set NCLI_VAULT_PASSWORD” error when no terminal is available instead of the cryptic ioctl one. (#206)
[0.8.0-rc.46]
Section titled “[0.8.0-rc.46]”- Fixes a NIP-46 consent flaw where approving a bunker
connectsilently granted every permission the app requested, permanently, even for an “Approve Once”. The approval now shows the requested scope, “Approve Once” remembers nothing, and sensitive kinds (0/3/5 – identity, contacts, deletion) always require per-request consent. (#204)
[0.8.0-rc.45]
Section titled “[0.8.0-rc.45]”Changed
Section titled “Changed”- Builds with nmilat v0.5.0-rc.47, which renames a circlehub1 connection’s
fields and refuses unsigned cash tokens and connections.
event validatechecks an AltZap receipt by rules 1-9 (ValidateAltZapReceiptForRelay), offline, as it does NIP-57’s receipts; rule 10 needs the LNURL server.
[0.8.0-rc.44]
Section titled “[0.8.0-rc.44]”- Adds the signer’s
nip44_message_keysmethod andunwrap_fromrule: one message’s keys for a proof, and opening a gift wrap only when it holds a seal from a listed sender. Both are denied unless a rule names them, so existing policies behave the same. (#199) - Adds
find -f/--follow, which keeps the subscription open on every relay and prints each new event once as a JSON line, reconnecting when a relay drops.--staterecords what was printed, so a restart resumes without gaps or repeats. (#199) - Adds
-Sas the short form of--sinceonfind,dumpandminer check. (#199) - Adds
ncli dm send/read/prove/verify: NIP-17 private messages sealed and opened through--signer, so the key can stay inncli signer serve.readopens only--fromsenders’ seals, andprovegives a third party one message to check withverify, with no key that opens any other. (#199) - Adds
event wrap, which seals and gift-wraps any event, and--signer/--fromonevent unwrap, which opens only the named senders’ seals. (#199) - Adds
event react,reply,post,repostanddelete, signed through--signer. A reply is threaded the way its target’s kind expects, and a reaction or reply to a group message carries the group’shtag. (#199) - Adds
groups send,groups readandgroups feed: post a chat message, read a group (--thread,-f/--follow,--state), or read what mentions you across your groups, as the same message shape asdm read. (#199) - Adds
--signerto everygroupscommand, so a group write or a private group’s read can go through a socket signer or bunker instead of a key held here. (#199) - Adds npub, nprofile, nip-05 and vault labels wherever a person is named:
find/dump --authors,--tag p=,groups members add/remove,groups list --member,relay members show/add/removeandsigner check;bunker sessionstakes an npub. Hex is unchanged, and a value that names no one is still sent as given or refused as before. (#199) - Adds the
ncli-messagingskill andexamples/signer/messaging-policy.yaml, a signer policy for an agent that messages people. (#199) - Adds
profile set,profile relays set,profile follow/unfollowandprofile mute/unmute. Each reads your current version and changes only what you name, and nothing is published unless every relay answers, or without--createwhen none has one. (#199)
Changed
Section titled “Changed”- Changes
event unwrapto refuse a message whose id doesn’t match its content. (#199) - Changes the signer to accept a kind 13 seal backdated by up to 2 days, as NIP-59 requires, where other kinds keep the policy’s age limit. (#199)
- Builds with nmilat v0.5.0-rc.43, which adds signer-based gift wraps, message keys and the NIP builders these commands use, and fixes a relay deadlock when a multi-tag query ran while a write grew the store. (#199)
[0.8.0-rc.43]
Section titled “[0.8.0-rc.43]”- Adds
cache.profiles.search.batchSize(default 10000, with each request capped at about 50 MB) andmaxInFlight(default 4). A rebuild and the live queue keep several requests enqueued so Meilisearch indexes them in one pass, and a large relay’s search keeps up. (#197) - Adds
cache.profiles.search.searchAbout(default true), which leaves profiles’ about text out of search when false. (#197) - Adds the last Meilisearch batch’s duration and slowest step to the dashboard’s search card, plus a warning when search’s queue has grown faster than profiles were applied for 30 minutes. (#197)
Changed
Section titled “Changed”- Changes the search index so
idandnpubare no longer searchable, filters are equality-only and facet search is off, and a hex, npub or nprofile query fetches that profile directly. Each write is much cheaper on a large index, which is rebuilt once after upgrading. (#197) - Changes the relay to rebuild search into a new index when its Meilisearch settings change, instead of changing the live index’s settings at startup. (#197)
- Changes a search rebuild to read only profiles, through the store’s kind index, and to report progress as profiles applied out of all stored profiles. (#197)
- Changes the dashboard to show a search rebuild as profiles applied out of the total, estimate time left from the recent pace, and label search’s backlog as events of any kind. (#197)
- Moves the relay’s ncli and nmilat versions from the dashboard’s top bar to its footer. (#197)
- Recommends Meilisearch 1.55 or later, and documents upgrading its database with
--upgrade-db. (#197) - Builds with nmilat v0.5.0-rc.42, which keeps several search batches in flight and reads profiles through the kind index. (#197)
[0.8.0-rc.42]
Section titled “[0.8.0-rc.42]”Changed
Section titled “Changed”- Changes a panic in an index job to fail that job, retried with the usual backoff, instead of stopping the relay. (#195)
- Changes the relay to park an index job that it died during 3 times in a row within an hour, instead of resuming it on every start;
relay index listand the dashboard say so, andrelay index rebuild(ordrop) starts it over. (#195) - Changes search’s own rebuild and rescore to wait while the zaps or stats index is rebuilt or caught up, since search scores read them. (#195)
- Builds with nmilat v0.5.0-rc.40, which fixes an index rebuild panicking (index out of range [-1]) and freeing old index data making no progress on a busy store. (#195)
[0.8.0-rc.41]
Section titled “[0.8.0-rc.41]”- Adds the relay’s own index upkeep: each index is caught up after its feature was off, rebuilt when it can’t be trusted, rescored when scoring changes and freed of old data, as jobs with a trigger, progress and a one-line summary kept across restarts. Readers keep the previous data meanwhile, and no index job holds writes up for more than 25 ms. (#193)
- Adds the
index_state,index_entries,index_behind,index_queuedandindex_txn_secondsmetrics, andkindandtriggerlabels onjob_runs_total. (#193) - Adds the relay’s ncli and nmilat versions to the dashboard header; through
ncli relay dashboardit warns when the CLI is another build. (#193)
Changed
Section titled “Changed”- Changes
relay index rebuildanddropto print the plan, live progress and what changed;--jsonreturns the job at once,--waitor--followwatch it, and--detachreturns in text mode. A job that ends unsuccessfully fails the command, and a no-op says so. (#193) - Changes
relay index listto show each index’s state, exact entries, how far behind it is and what happens next, andrelay jobsto show who started a job, why, and what it did. (#193) - Changes the dashboard’s Indexes panel to show state badges, live progress for the relay’s own jobs, and outcomes that stay on screen; a rebuild shows its plan first and a drop asks for the index name. (#193)
- Changes search to follow the store, so profiles stored while search was off, dropped from a full queue or deleted reach Meilisearch, each write counting once Meilisearch applied it. A replaced Meilisearch index or new scoring settings rebuild it on their own. (#193)
- Changes
relay index dropto take only an index whose feature is off; an index in use is rebuilt instead. (#193) - Removes
relay index rebuild --fresh, since every rebuild builds a new index and swaps it in, and search’sbatchSizeandqueueSize, which now fail startup. Also removes theverify_dropped_total,search_index_queue_depthandsearch_index_dropped_totalmetrics. (#193) - Builds with nmilat v0.5.0-rc.39. (#193)
- Fixes
relay index dropreporting success while the drop still ran, and index counts that didn’t change after a rebuild or drop. (#193) - Fixes a rebuild putting back a zap or follow deleted while it ran, and a contact list losing the follows it shares with an older one. (#193)
- Fixes a profile the relay rejected as older still reaching search. (#193)
[0.8.0-rc.40]
Section titled “[0.8.0-rc.40]”Changed
Section titled “Changed”- Changes the relay to keep its zap and stats indexes only while their feature is on (
cache.zaps; writablecache.profiles.searchorcache.profiles.stats), saving their write and rebuild work otherwise;sync,streamandinspectstores keep neither. Turning a feature on builds its index once in the background on the next start; turning it off keeps the data, with a startup warning, untilncli relay index drop zaps|statsremoves it. (#191) - Changes
relay index list,relay statusand the dashboard to show each index’sstate(disabled,stale,building,ready) andhas_data, and letsrelay index dropremove what a disabled zaps or stats index still holds. (#191) - Changes
relay verifyto reportstats: nullwhen profile stats and search are off, instead of zeros. (#191) - Builds with nmilat v0.5.0-rc.38. (#191)
- Fixes follower counts in profile stats doubling when a contact list and its replacement arrived together. (#191)
[0.8.0-rc.39]
Section titled “[0.8.0-rc.39]”Changed
Section titled “Changed”- Changes
maxReconcileRounds’ default forapplysync from 20 to 1000, since a large diff now takes many small rounds. Hitting the cap says the sync is partial. (#189) - Builds with nmilat v0.5.0-rc.37. (#189)
- Fixes
applysync dropping the connection mid-sync when the two sides differ by thousands of events, as against strfry relays like relay.nostr.net: each NIP-77 message now stays under 30 000 bytes. (#189) - Fixes
applysync skipping events whenpullBatchSizeis above the relay’smax_limit: what a batch didn’t return is asked for again, and events the relay never serves are counted in a warning. (#189)
[0.8.0-rc.38]
Section titled “[0.8.0-rc.38]”- Adds the relay’s own NIP-66 stats: with
cache.relay.stats.enabled(needsnip11.privkeyandnip11.url) the relay publishes a kind 30166 about itself with its NIP-11 document, supported NIPs, requirements, NIP-86 kind rules, andcounttags (events,authors, plusprofileswith search or stats on andzap-receiptswith zaps on), per-cointotalzap tags and the zap-ranking windows and coins. It republishes, at most everyinterval, only when something changed, so subscribers get each version live. (#187) - Adds
cache.zaps, the signedzap-rankingcache action:windows(first is the default,allallowed) andcoins(sats,loki) a client may ask for,limit/maxLimit, andrefresh. One coin per list, whole units, computed once per refresh for every window. (#187) - Adds per-coin NIP-85 amounts:
zap_amt_recd_loki/zap_amt_sent_lokibeside the satszap_amt_recd/zap_amt_sent. (#187)
Changed
Section titled “Changed”- Changes the relay’s
cacheblock, grouped by what depends on what:cache.profiles.search(its Meilisearch settings undermeilisearch,batchSize,queueSize),cache.profiles.stats,cache.profiles.checks,cache.profiles.scoring,cache.zapsandcache.relay.stats. The old keys (cache.topZapped,cache.search,cache.profileStats,cache.verification,cache.scoring,verificationWorkers,index_name,batch_size,max_ch_size) fail startup withusagenaming the new key. (#187) - Removes the
top-zappedcache action; usezap-ranking. Any unknown cache action is refused withCLOSED invalid:. (#187) - Changes the social score to count sats only. (#187)
- Changes NIP-45 COUNT to answer a kinds-only (or empty) filter exactly from the relay’s counters, past
max_limit, and to mark a count that hitmax_limit"approximate": true. (#187) - Changes the dashboard and
relay index listto read index estimates from the relay’s counters or a one-minute cache, instead of counting or calling Meilisearch on every poll. (#187) - Builds with nmilat v0.5.0-rc.36. (#187)
- Fixes the dashboard’s
statsindex showing a count on a relay with profile stats off: likesearchandzaps, it’s now unavailable unlesscache.profiles.searchorcache.profiles.statsis enabled, and says so. (#187) - Fixes zap amounts in sats and loki being added together in the zap ranking, NIP-85 amounts and profile scores. (#187)
- Fixes a ranking
windowlike7dfrom a client silently becoming 24h, and a bad configured window only logging a warning. (#187)
[0.8.0-rc.37]
Section titled “[0.8.0-rc.37]”Changed
Section titled “Changed”- Changes the dashboard header to name the signed-in admin by NIP-05 when the relay has verified one, else by npub, never by hex pubkey. (#186)
- Fixes the dashboard’s time range looking like it does nothing on a relay up less than the range: metrics live in memory and start over on restart, so the page now says “history since HH:MM” when the range reaches past them. (#186)
- Fixes the admin listener counting a request with no credentials (every dashboard load before sign-in) as a failed login, which locked an admin out with 429 after ten page loads in a minute. (#186)
[0.8.0-rc.36]
Section titled “[0.8.0-rc.36]”- Adds
ncli relay --config <file> --check, which validates the config the way startup does and exits without starting the relay. (#185)
Changed
Section titled “Changed”- Rejects a
cache.profileStats.maxTargetslarger thannip11.limitation.max_message_lengthallows (~67 bytes per#dpubkey) at startup. (#185) - Builds with nmilat v0.5.0-rc.35. (#185)
- Fixes
ncli relay index list,relay status,relay index rebuild --dry-runand the dashboard’s index panel failing with EOF on a relay withcache.searchenabled: listing indexes panicked on an uninitialized Meilisearch client. An unreachable Meilisearch now shows asunreachable. (#185) - Fixes
ncli relay statusfailing entirely when the index list fails; it shows the metrics and the index error. (#185) - Fixes a panic in an admin API handler dropping the connection; the relay logs it and answers a JSON 500, and the CLI no longer asks whether the relay is running when it’s up but failed or hung up. (#185)
- Fixes the relay’s profile checks crashing it on a panic, and client mistakes (malformed
authors, oversized messages, resets) and HTTP/2 client noise being logged at error or bypassing the relay log. (#185)
[0.8.0-rc.35]
Section titled “[0.8.0-rc.35]”- Adds NIP-85 profile stats to
ncli relay: withcache.profileStats.enabled, a REQ for kind 30382 with#dpubkeys gets relay-signed rank, followers, following and zaps received/sent.ncli profileshows a relay’s stats on its card. (#184) - Adds
ncli relay verify <pubkey|npub|nip-05...>, which shows a running relay’s stored NIP-05/lightning checks (status, next check, retries, last error), score and stats;--refreshre-checks now. (#184) - Adds
cache.verification(TTL, retry backoff, per-host spacing, workers) andcache.scoring(profile score weights) to the relay config, and astatsindex toncli relay index. (#184)
Changed
Section titled “Changed”- Changes the search score to count followers and zaps received, weighted by who sent them; an index rebuild now rescores from stored results and never re-fetches NIP-05 or lightning addresses.
--reverifyis removed in favour ofncli relay verify --refresh. (#184) - Deprecates the top-level
verificationWorkersrelay setting in favour ofcache.verification.workers. (#184) - Builds with nmilat v0.5.0-rc.34. (#184)
- Fixes relays marking working NIP-05 and lightning addresses as missing: long TLDs are checked, and a timeout, block or 5xx is retried instead of cached as “not verified” for two weeks. (#184)
- Fixes
ncli relay index listshowing stored profile counts as the search index’s entries; it now reports Meilisearch’s own document count. (#184) - Fixes top-zapped counting invalid or self-paid zaps and duplicate receipts. (#184)
- Fixes
ncli profile --no-verifyshowing the NIP-05 address as not matching the pubkey; it now says “not checked”, and--jsonsetsnip05.unchecked. (#184)
[0.8.0-rc.34]
Section titled “[0.8.0-rc.34]”Changed
Section titled “Changed”- Builds with nmilat v0.5.0-rc.33.
[0.8.0-rc.33]
Section titled “[0.8.0-rc.33]”Changed
Section titled “Changed”- The relay dashboard’s time range now goes up to 24h: the relay keeps a day of 1-minute rollups (mean, max for latency quantiles) behind its hour of 2s samples. Charts start where the data does, so a relay up for a few minutes fills the chart instead of its right edge. Kiosk mode is gone; old
?kiosklinks still open. (#181) - Builds with nmilat v0.5.0-rc.32 and Go 1.26.10, which fixes a
crypto/x509vulnerability (GO-2026-6809). (#181)
[0.8.0-rc.32]
Section titled “[0.8.0-rc.32]”Changed
Section titled “Changed”- Restyles the relay dashboard like a Grafana dashboard: dark and light palettes, a toolbar with time range (5m to 1h), live/paused, theme and kiosk, collapsible rows on a 24-column grid, and stat panels with sparklines and bar gauges. Charts share a crosshair, show a sorted tooltip and a Last/Max/Mean legend, open full screen or export CSV, and the view is kept in the URL. (#178)
- Fixes the zaps index showing as available, with Rebuild and Drop, when
cache.topZapped.enabledis off; it now reports why andrelay index rebuild|drop zapsexitsusage. Its estimate now counts zap receipts instead of every stored event, with the rebuild’s scan size reported separately asscan_estimate. (#180) - Fixes
bunker historylosing requests resolved at the same moment as an event log compaction, after a restart. (#177)
[0.8.0-rc.31]
Section titled “[0.8.0-rc.31]”- Adds
logs.levelandlogs.fileto the relay config. Per-connection lines now needdebug, andfile: falsestops writingnrelay.logwhen stderr is already kept. (#168)
Changed
Section titled “Changed”- Writes
nrelay.logas JSON lines, which costs less CPU per line and reads withjq. (#168) - Updates nmilat to v0.5.0-rc.31, which also escapes tags like content when computing event ids and tightens NIP-04, NIP-44, private key and NWC response checks. (#175)
- Fixes relay search (NIP-50) returning profiles newest first; results now come best match first, with
limitapplied after ranking. (#175) - Fixes the relay’s index job history (
<store>.jobs.json) being left stale or unreadable when two jobs finished at once, losingrelay jobs listhistory on restart. (#172) - Fixes the
applyfooter always showing Wrap/AutoScroll whatever panel is focused. It now shows the focused panel’s own keys (delete, column sort, view/save event), then Restart, Save and Quit. (#170) - Fixes
rin thepingTUI opening a Restart dialog that did nothing. (#170) - Fixes a
logs:block withoutfilenamewriting its log to a temp directory instead of<logdir>/nrelay.log. (#168)
[0.8.0-rc.30]
Section titled “[0.8.0-rc.30]”- Adds
nip11.bannerto the relay config, served in the NIP-11 document. (#166) - Adds the operator’s latest notes to the relay homepage. (#166)
Changed
Section titled “Changed”- The relay homepage hero is laid out like a Nostr profile: the banner on top with the icon over its edge. It uses the NIP-11 banner, or an ncli banner when there is none or it fails to load. (#166)
- The dashboard, relay homepage and docs site use the ohstr favicon in place
of the
n_tile, which is removed. (#166)
[0.8.0-rc.29]
Section titled “[0.8.0-rc.29]”- Fixes
nip11.iconin the relay config being dropped at startup, so the NIP-11 document had no icon unless one was set through NIP-86. (#165) - Fixes the relay homepage showing a broken image when the icon URL doesn’t load; it falls back to the operator’s picture, then the placeholder. (#165)
Changed
Section titled “Changed”- The relay homepage’s tab always shows the ncli favicon, no longer the relay’s icon. (#165)
[0.8.0-rc.28]
Section titled “[0.8.0-rc.28]”- Adds the ncli logo to the relay dashboard and homepage, with a favicon on both. The homepage’s tab switches to the relay’s own NIP-11 icon once it loads. (#164)
[0.8.0-rc.27]
Section titled “[0.8.0-rc.27]”- Adds “remember on this browser” to the dashboard’s secret-key sign-in: the
key is saved only as a password-encrypted NIP-49
ncryptsecand unlocked with the password on the next visit. Left off, sign-in stays temporary. (#162) - Adds session renewal: after a key sign-in the dashboard renews its session while the tab stays open. (#162)
- Fixes the dashboard staying on “reconnecting…” with failing panels when its session expired; it now returns to the sign-in screen. (#162)
[0.8.0-rc.26]
Section titled “[0.8.0-rc.26]”- Adds dashboard sign-in with a secret key, signed in the browser and never
sent or stored, or with a NIP-46 remote signer: a
bunker://URL or anostrconnect://QR code for apps such as Amber and nsec.app. (#160) - Adds
admin.pubkeys: personal keys that may sign in to the dashboard and use the admin API, so admins no longer need the relay’s own key. (#160) - Adds a homepage at the relay’s URL for browsers, built from its NIP-11, the
operator’s profile and its public groups;
homepage: falseturns it off. (#160)
- Fixes browsers on any site but localhost being refused (HTTP 403) when they
opened a WebSocket to
ncli relay, which locked out every web client. (#160)
[0.8.0-rc.25]
Section titled “[0.8.0-rc.25]”Relay monitoring: Prometheus metrics, a one-page dashboard, and index jobs
that replace relay stats/reindex/clear.
- Adds an admin listener to
ncli relay(admin:block,127.0.0.1:<port+1>by default) serving Prometheus metrics at/metricsto bearer tokens fromncli relay metrics token add. The relay refuses to start when it would be reachable off loopback without TLS, and collecting metrics adds no measurable latency. (#154) - Adds
ncli relay status,relay index list|rebuild|dropandrelay jobs list|show|cancel, which run index maintenance as jobs with progress,--followand cancel. Rebuilds swap the new index in atomically, so search and top-zapped answers never go empty mid-rebuild. (#155) - Adds a one-page relay dashboard embedded in
ncli: live traffic, latency, rejections, queues, access and process charts plus index jobs. The relay serves it withadmin.dashboard.enabled(sign in with a NIP-07 extension), orncli relay dashboardserves it locally and signs for you. (#156) - Adds
admin.hosts: the admin listener answers only to its own address and these names, so a NIP-98 signature an admin made for another site can’t be used against it. (#158)
Removed
Section titled “Removed”- Removes
ncli relay stats,relay reindexandrelay clear, and their routes on the public relay port; each now names its replacement (relay status,relay index rebuild,relay index drop). (#155)
- Fixes zap reindexing dropping every NIP-57 (kind 9735) receipt from the top-zapped index. (#154)
- Fixes search reindexing covering only the newest
max_limitprofiles; a rebuild now indexes every stored profile. (#155)
Changed
Section titled “Changed”- Updates nmilat to v0.5.0-rc.25, which reports relay activity for these metrics and keeps NIP-57 receipts when the zap index is rebuilt. (#158)
[0.8.0-rc.24]
Section titled “[0.8.0-rc.24]”Changed
Section titled “Changed”- Updates nmilat to v0.5.0-rc.24, whose NIP-CASH private transport listens for a reply on the relay it sent the request to; ncli’s behaviour is unchanged. (#152)
[0.8.0-rc.23]
Section titled “[0.8.0-rc.23]”- Fixes huddle video freezing for good after a lost packet on
ncli relay: a subscriber’s keyframe requests (PLI/FIR) now reach the publisher, throttled, and its NACKs are answered. The SFU also asks for a keyframe once a new subscriber is actually receiving, and when a publisher reconnects, so the first picture no longer waits for the encoder’s next natural keyframe. Before this, a 1:1 video call could lose one side’s picture while audio carried on.
[0.8.0-rc.22]
Section titled “[0.8.0-rc.22]”AltZap events move to kinds 9520/9521/9523.
Changed
Section titled “Changed”- Updates nmilat to v0.5.0-rc.20: AltZap events use kinds 9520/9521/9523, so
ncli event validateandncli relaycheck and index AltZap receipts under kind 9521. (#150)
[0.8.0-rc.21]
Section titled “[0.8.0-rc.21]”Relays hosting NIP-29 groups no longer keep a deleted subgroup in its parent.
- Fixes deleting a NIP-29 subgroup on
ncli relay: it now leaves its parent’schildlist, so the parent’s other subgroups stay readable, and an edit to the parent clears an id left behind by an earlier delete. (#149)
[0.8.0-rc.20]
Section titled “[0.8.0-rc.20]”ncli skills install needs --dir, so skills go wherever your agent reads them.
Changed
Section titled “Changed”- Makes
--dirrequired forncli skills install, which no longer defaults to~/.claude/skills; without it the command exits 2 and writes nothing. (#141)
[0.8.0-rc.19]
Section titled “[0.8.0-rc.19]”Relays configure the rest of NIP-29 group hosting from relay.yaml.
- Adds
groups.roleDescriptions,groups.admins,groups.moderationLogandgroups.pendingJoinsto relay.yaml: describe roles in kind 39003, let more keys moderate every group, keep a moderation log, and hold codeless joins to closed groups for an admin. (#148) - Adds the relay’s OK message to
publish --jsonresults (message), andgroups joinnow says when a request is pending an admin. (#148)
[0.8.0-rc.18]
Section titled “[0.8.0-rc.18]”ncli event verifies, fetches and inspects any event, whoever signed it, and
relays gain NIP-86 moderation and configurable NIP-29 group roles.
- Adds
ncli event verify, which checks any event’s id and signature plus what it claims (author, kind, PoW, expiration, delegation, zap) and, with--deleted/--cross-relays, its deletion and every relay’s copy. Events are looked up on the reference’s relay hints,--relaysor prefs, then the author’s NIP-65 outbox, and no identity is needed. (#144) - Adds
ncli event get,show,encode,seenandrebroadcastto print an event as served or as a readable card, spell it as nevent/naddr with relay hints, list which relays hold it, and copy it unchanged to other relays. (#144) - Adds
ncli event new,id,thread,diff,unwrapandvalidateto build unsigned events and compute ids, walk a NIP-10/NIP-22 thread, compare two events, decrypt NIP-59 gift wraps, and run nmilat’s per-kind rules before publishing. (#144) - Adds
groups.rolesto relay.yaml, which sets the moderation kinds each NIP-29 group role may send, so a role likemoderatorhas real power. Without it, onlyadminmoderates, as before. (#145) - Adds NIP-86 moderation to
ncli relay: ban pubkeys and events, allow or disallow kinds, block IPs, and change the relay’s name, description and icon, saved across restarts.nip86no longer requiresmembership; the membership methods are added when it is on. (#146) - Adds
-e -toncli id signandncli publish, and-o -toid sign, so an event can be built, signed and published in one pipe. (#144)
Changed
Section titled “Changed”- Updates nmilat to v0.5.0-rc.17: hosted NIP-29 groups enforce
restrictedandhidden, the relay’s own key can moderate every group, and each group advertises its roles (kind 39003). (#147)
[0.8.0-rc.17]
Section titled “[0.8.0-rc.17]”publish, find, dump and apply log in to relays that require NIP-42
through a signer, so a process with no private key can use them.
- Adds NIP-42 login through a signer (
bunker+unix://,bunker://or a key) topublish(--signer,--auth-signer),find/dump(--auth-identity, alias--signer) andapply(--auth-signer). Each connection signs one kind 22242 for the relay it dialed, and a failed login exits 7 withreasonlogin_required,signer_refusedorrelay_refused. (#139)
Changed
Section titled “Changed”- Names the matched rule in
ncli signer servedenials, e.g.rule "rest": denied by rule. (#139)
[0.8.0-rc.16]
Section titled “[0.8.0-rc.16]”ncli bunker works on relays that require NIP-42 AUTH.
- Fixes
ncli bunkerhearing nothing on relays that require NIP-42 AUTH; it now subscribes once AUTH settles and re-subscribes when a relay closes its subscription. (#137)
[0.8.0-rc.15]
Section titled “[0.8.0-rc.15]”A Go 1.26.9 build with nine standard-library security fixes, and clearer bunker refusals.
Security
Section titled “Security”- Builds with Go 1.26.9, which fixes nine standard-library vulnerabilities in
net/http,crypto/tlsandnet/textproto. (#134)
Changed
Section titled “Changed”- Starts refusals from
ncli bunkerwithdenied:orinvalid:, so an app can tell a refusal from a malformed request. (#135)
- Fixes
ncli bunkerhistory showing a quickly approved request as expired after a restart. (#135)
[0.8.0-rc.14]
Section titled “[0.8.0-rc.14]”A relay performance fix.
- Fixes
ncli relaystarving reads when many subscriptions are open; a REQ that can’t be served within 10s now getsCLOSEDerror: relay busy, try again later. (#133)
[0.8.0-rc.13]
Section titled “[0.8.0-rc.13]”A local policy signer, and id --save stops printing the private key.
- Adds
ncli signer serve, a local signer on a unix socket that signs only what its policy allows, withsigner statusandsigner check;id signandpublishuse it via--signer bunker+unix:///path.sock. (#128) - Adds the relay setting
pprofAddr, which serves Go’s profiler so a stuck relay can be inspected without stopping it. (#131)
Changed
Section titled “Changed”- Stops
ncli id --saveprinting the new private key;--revealprints it. This breaks scripts that readnsecorpriv_hexfrom its--json. (#130)
- Fixes
ncli relayleaving a valid event without an OK under heavy load; one queued over 10s getserror: relay busy, and a failing event no longer rejects others written with it. (#132)
[0.8.0-rc.12]
Section titled “[0.8.0-rc.12]”Agent skills ship inside the binary.
- Adds
ncli skills list|show|install, so an agent with onlyncligets guidance for its version;installwon’t overwrite a changed file without--force. (#126)
[0.8.0-rc.11]
Section titled “[0.8.0-rc.11]”Import, relabel and remove vault identities.
- Adds
ncli id import, which saves an nsec, hex key or ncryptsec to the vault from stdin,--fileor a prompt, never an argument. (#124) - Adds
ncli id relabel <identifier> <new-label>. (#124) - Adds
ncli id rm <identifier>, which asks first and needs--yeswith--jsonor no terminal. (#124)
[0.8.0-rc.10]
Section titled “[0.8.0-rc.10]”Relay examples organized by deployment scenario.
Changed
Section titled “Changed”- Moves the huddle packages under
huddle/(audio,client,rtp,sfu). This breaks code that imports them. (#113) - Reorganizes
examples/relay/by deployment scenario, from a personal relay to an agent swarm, replacing the feature-named files. (#114)
- Fixes
examples/relay/full.yamlshowingquery:at the top level, where it was silently ignored; it belongs underhttpBridge. (#114)
[0.8.0-rc.9]
Section titled “[0.8.0-rc.9]”Security fixes from a black-box command matrix, headless bunker and space commands, and consistent exit codes.
Security
Section titled “Security”- Fixes
blossom uploadtokens that allowed uploading any blob; each is now scoped to its file’s hash. (#117) - Fixes the relay’s admin API accepting a replayed request or one without a body hash, which could enroll a member or mint an invite. (#117)
- Accepts each NIP-98 event only once on the NIP-86 management API. (#117)
- Applies REQ’s private-group rules to
POST /query. (#117) - Fixes a deleted private group’s metadata and member lists staying readable by anyone. (#119)
- Starts
ncli bunkerin the background without a terminal, and addsbunker pending list|approve|rejectandbunker sessions set-grant. (#119) - Publishes the relay’s NIP-43 kind:13534 member list on every join and leave. (#119)
- Streams
space joinas JSON lines without a terminal, and addsspace chat send|list. (#119)
Changed
Section titled “Changed”- Moves the
id delegatewizard to Bubble Tea v2, so commands no longer wait up to 5s on a terminal that doesn’t answer a color query. (#117) - Changes
groups show --jsonadmin keys topubkeyandroles. (#117)
- Fixes
prefs relays clearwiping all ofprefs.yaml, including the vault key. (#117) - Fixes
id --savestarting a new vault when the vault key is missing; it now refuses withnot_found. (#117) - Applies a NIP-43 join to the member’s open connections, and refuses an
unauthenticated private read with
auth-required:. (#119) - Fixes an authenticated
groups listorfindsometimes missing private groups. (#117) - Exits
auth(7) when the relay refuses an anonymousfind,dumporgroups show, instead of printing an empty result. (#117) - Classifies a refused
groupswrite by the relay’s reason (conflict,auth,invalid_input) instead ofinternal, and adds the NIP-29previoustags private-group writes were missing. (#117) - Fixes exit codes across
apply,space,huddle,relay invites,relay reindex,relay context,miner,blossom, vault labels and barencli, which reported success orinternalfor usage, missing-item and unsupported cases. (#117, #119) - Makes every
--jsonempty result[]and everyncli relay --jsonlog line JSON. (#117, #119) - Fixes
id delegatetokens failing NIP-26 verification; re-issue older tokens. (#117) - Fixes the
ncli-huddleskill being skipped by installers over invalid frontmatter. (#117)
[0.8.0-rc.8]
Section titled “[0.8.0-rc.8]”Fixes for editing private groups.
- Fixes
groups editmaking a private group public and rejecting edits on a group with subgroups; it now reads the group as the editor. (#110) - Advertises
nip29.subgroupsinncli relay’s NIP-11 document. (#110)
[0.8.0-rc.7]
Section titled “[0.8.0-rc.7]”NIP-29 subgroups.
- Adds
groups create --parentandgroups edit --parentfor NIP-29 subgroups;editkeeps a group’s existing children. (#108) - Adds
ncli groups tree, and shows parent and children ingroups listandgroups show --json. (#108) - Exits 7 for
groups showof a group that doesn’t exist, the same as a private one you can’t read. (#108)
[0.8.0-rc.6]
Section titled “[0.8.0-rc.6]”Authenticated reads, and refusals reported as refusals.
- Adds
--auth-identitytoncli findandncli dump, which authenticate (NIP-42) against a relay that requires it. (#100) - Accepts
--identityingroups showandgroups list, so a member can read their own private group. (#103) - Exits
auth(7) fromfind,dump,groups showandgroups listwhen the relay refuses the read, instead of reporting nothing found. (#103) - Adds
--mineand--member <pubkey>togroups list, which list only the groups that pubkey belongs to. (#104)
Changed
Section titled “Changed”- Publishes a floating
ghcr.io/ohstr/ncli:rcimage tag that tracks the newest release candidate. (#98) - Updates nmilat past v0.5.0-rc.6 for authenticated reads and the private group fixes. (#100, #104)
[0.8.0-rc.5]
Section titled “[0.8.0-rc.5]”Meeting spaces and NIP-29 groups from the command line.
- Adds
ncli space create|list|show|joinfor NIP-53 meeting spaces;joinmoves here fromncli huddle. (#93) - Adds
ncli groupsfor NIP-29 groups, fromcreateandedittomembers,pinsanddelete-event;editkeeps every field you don’t change. (#94)
Changed
Section titled “Changed”- Updates nmilat to v0.5.0-rc.5, which hosts NIP-29 groups. (#96)
[0.8.0-rc.4]
Section titled “[0.8.0-rc.4]”Publish over HTTP.
- Adds
POST /eventstoncli relaybehindhttpBridge.events.enabled, which takes one signed event over HTTP. (#91)
Changed
Section titled “Changed”- Moves the
query:block underhttpBridge:. This breaks configs that setquery:at the top level. (#91) - Updates nmilat for the NIP-98 nonce fix and
POST /querypaging. (#92)
[0.8.0-rc.3]
Section titled “[0.8.0-rc.3]”Query over HTTP.
- Adds
POST /querytoncli relaybehindquery: enabled: true, a NIP-98-signed HTTP alternative to a WebSocket REQ. (#90)
[0.8.0-rc.2]
Section titled “[0.8.0-rc.2]”Find live huddles and spaces, and chat in a call.
- Adds
ncli huddle list, which shows a relay’s live rooms with their peer count. (#87) - Adds
ncli huddle spaces, which lists open NIP-53 spaces with a live session. (#87) - Accepts a space (naddr or coordinate) in
huddle join, which finds its relay and room. (#87) - Adds in-call chat beside the roster when joining a space, with replies,
quotes and backlog;
--no-chathides it. (#87)
- Fixes
ropening a “Restart?” dialog during a call. (#87)
[0.8.0-rc.1]
Section titled “[0.8.0-rc.1]”Relay management over HTTP, and nostrconnect:// pairing that works with
real apps.
- Adds NIP-86, the Relay Management API, to
ncli relaybehind anip86:block, including roles. (#85) - Adds
nip86.admins, so a relay can be administered from keys other than its own. (#85) - Adds
huddle.udpPortRange, so a relay in a container can publish the ports WebRTC media uses. (#82)
Changed
Section titled “Changed”- Ends a removed member’s live huddle calls. (#85)
- Binds an admin request’s body to its NIP-98 signature. (#85)
- Fixes WebRTC huddles failing to connect when ICE candidates arrive before the SDP. (#82)
- Fixes
ncli bunkerpairing with real apps overnostrconnect://, using every relay in the URI. (#84) - Applies the permissions an app requests as grants, and shows app names for
bunker://pairings. (#84) - Answers
switch_relaysandlogout. (#84) - Fits the “Paste nostrconnect:// URI” and “Set App Name” dialogs to their content. (#84)
[0.7.0-rc.1]
Section titled “[0.7.0-rc.1]”Group voice calls with video and screen share.
- Adds huddles to
ncli relaybehind ahuddle:block: voice for NIP-53 rooms over WebSocket, and voice, video and screen share for browsers over WebRTC, in the same rooms. (#66) - Adds
ncli huddle join <room>, a live roster of who’s present and speaking; it never captures a microphone. (#66) - Plays the call in
huddle joinwhen built with-tags huddleaudio; the default build shows “watching only”. (#76) - Adds
huddle.requireMembership,huddle.iceServersandhuddle.allowedOrigins, and an example config. (#66)
- Ends live huddles before
ncli relayshuts down, instead of severing them. (#66)
[0.6.0]
Section titled “[0.6.0]”Profiles, a network spinner, and clearer errors.
- Adds
ncli profile <identifier>, which shows an identity’s metadata, follows, relays, Blossom servers and lightning address from every relay. (#55) - Shows a spinner on stderr while a command waits on the network, except
under
--json,-q,NO_COLORor a non-terminal. (#55) - Adds the importable packages
client/vaultandclient/prefs, which pull 10 modules instead of 38. (#60)
Changed
Section titled “Changed”- Prints errors as
Error:(red on a terminal) and help only on stderr; exit codes and--jsonare unchanged. (#55) - Rewrites every command’s help to say what it does. (#61, #62)
- Updates nmilat to v0.4.0. (#58)
- Fixes an unknown flag being reported twice and exiting 1 instead of 2. (#55)
- Fixes
bunker sessions revoke-grantwithout--methodexiting asinternalinstead ofusage. (#55) - Prints a short error and the command’s help when
ncli relayfinds no config. (#61) - Fixes
ncli relayfreezing until restarted when a write had to grow its database file. (#58)
[0.5.0]
Section titled “[0.5.0]”Decode cash tokens, examples in every help page, and day-scale ages.
- Reads NIP-CASH cash tokens and NIP-CW
circlehub1…connections inncli decode, never showing their secret. (#49) - Adds an
Example:to every command’s help. (#51)
Changed
Section titled “Changed”- Defaults a local flow’s
ensuretocreate, so a missing store is created. (#50) - Shows the Age column in days and weeks (
2d4h,1w3d). (#53) - Shortens help text. (#51)
- Updates nmilat to v0.3.1. (#53)
- Fixes two
Example:commands that failed as written. (#51) - Fixes wallet transfers reusing a stale client, and NWC responses dropping circle fee fields, via nmilat v0.3.0. (#51)
[0.5.0-rc.1]
Section titled “[0.5.0-rc.1]”Decode cash tokens and examples in every help page.
- Reads NIP-CASH cash tokens and NIP-CW
circlehub1…connections inncli decode, never showing their secret. (#49) - Adds an
Example:to every command’s help. (#51)
Changed
Section titled “Changed”- Defaults a local flow’s
ensuretocreate, so a missing store is created. (#50) - Shortens help text and uses
satoshias the example label. (#51) - Updates nmilat to v0.3.0. (#51)
- Fixes two
Example:commands that failed as written. (#51)
[0.4.9]
Section titled “[0.4.9]”Reliable apply stream and sync.
- Fixes
apply streamsilently losing events while its destination reconnects. (#48) - Fixes an
apply streamdestination that could stop sending for good. (#48) - Fixes
apply syncignoring itstimeouts:block. (#48)
Changed
Section titled “Changed”- Renames the destination “Synced” column to “Duplicates”, which is what it counts. (#48)
[0.4.8]
Section titled “[0.4.8]”Paced publishing for apply stream.
- Caps unacknowledged events per remote destination with
writeConcurrency, so an initial sync no longer trips a relay’s rate limit. (#45) - Updates nmilat to v0.2.9, fixing stalled subscriptions and corrupted event JSON under load. (#45)
[0.4.7]
Section titled “[0.4.7]”A relay fairness fix.
- Fixes a burst on one kind starving the other kinds in a relay’s live subscription, via nmilat v0.2.8. (#41)
[0.4.6]
Section titled “[0.4.6]”More NIPs on ncli relay, and no more dropped PoW events.
- Advertises and validates NIP-47, 48, 88, 90, AZ, B0 and B7 in
ncli relay. (#39)
- Fixes a destination relay dropping an event whose PoW tag overclaims its difficulty, via nmilat v0.2.7. (#33)
- Advertises and validates NIP-57 and NIP-65, which
ncli relaylisted but never registered. (#38)
[0.4.5]
Section titled “[0.4.5]”List relay contexts.
- Adds
ncli relay context list. (#31)
[0.4.4]
Section titled “[0.4.4]”Run a relay by context name.
- Adds
ncli relay -c/--context <name>, which runs a saved context or creates one with a fresh identity. (#30)
Changed
Section titled “Changed”- Lets a selected relay context win over a local
relay.yaml. (#30)
- Says plainly when
ncli relayfinds no config at all. (#30)
[0.4.3]
Section titled “[0.4.3]”A vault error-code fix.
- Exits
conflictwhen saving a vault identity under a taken label. (#28)
[0.4.2]
Section titled “[0.4.2]”Error-code fixes from agent testing.
- Adds the
unsupportederror code (exit 8) for a server that lacks a capability. (#27)
- Exits
usagefor wrong argument counts, without a help dump under--json. (#27) - Classifies a missing or wrong vault password in
id --saveasusageorauth. (#27) - Fixes
blossom mirrorfailing on servers that require a hash-scoped token. (#27) - Records auto-approved requests in
bunker history. (#27) - Fixes
ncli relayleaking goroutines and hanging on shutdown. (#27)
[0.4.1]
Section titled “[0.4.1]”TUI polish.
Changed
Section titled “Changed”- Dims unfocused panel borders, and lets Left/Right move between bunker’s dialog buttons. (#23)
- Shows the bunker splash screen while the board loads. (#24)
- Shortens help text. (#22)
[0.4.0]
Section titled “[0.4.0]”A Blossom client.
- Adds
ncli blossomto upload, download, list, remove, mirror and report blobs, and manage servers. (#18)
Changed
Section titled “Changed”- Draws every TUI in fixed 24-bit colors, fixing black-on-black text. (#19)
[0.3.0]
Section titled “[0.3.0]”A NIP-46 remote signer.
- Adds
ncli bunker, which signs for other apps after approval in a TUI or by a remembered grant, pairing overbunker://ornostrconnect://. (#15)
[0.2.0]
Section titled “[0.2.0]”Sign events, and identity-based delegation.
- Adds
ncli id sign, which signs unsigned events with a vault or nsec identity. (1d9ebac)
Changed
Section titled “Changed”- Makes
ncli ping’s live board opt-in with--tui. (ae902a1) - Changes
id delegateto take--issuerand--delegateeas any identity form and print the token. This breaks scripts that use--issuer-keyor--relay-key. (#1)
[0.1.0]
Section titled “[0.1.0]”The first public release.
- Adds
ncli relay, a Nostr relay with NIP-11, auth, retention, search, a zap cache, NIP-43 membership and NIP-AA agent auth. (5f6724c) - Adds remote relay administration (
relay stats|reindex|clear|members|invites|roles) and relay contexts. (5f6724c) - Adds
ncli applyfor stream, sync and inspect workflows, with a live TUI. (5f6724c) - Adds
ping,publish,find,dump,miner,id,prefsandversion. (5f6724c) - Adds structured error codes and
--jsonon every command, and releases for Linux, macOS and Windows, Homebrew and Docker. (5f6724c)