openclaw-nostr 2026.7.30

package/CHANGELOG.md

@@ -0,0 +1,183 @@
+# Changelog
+
+## Unreleased (Cascadia Fork)
+
+### Packaging
+- Split the scanner-clean `openclaw-nostr` runtime plugin from the optional `openclaw-nostr-bootstrap` legacy migration CLI. Normal installs now use `openclaw plugins install npm:openclaw-nostr`; bootstrap scripts and process-spawning imports are excluded from the plugin tarball.
+- Added a CI guard that stages the declared runtime package files and invokes OpenClaw's real hash-named install scanner, requiring zero critical findings when the internal scanner module is available.
+
+### Fixes — DM Delivery & Relay Connections
+- **Seen-list gating on delivery confirmation (ocn-zi7)**: an inbound DM is now durably marked seen only after the agent dispatch succeeds — including the relay OK on the reply send. Model timeouts and NIP-46 signer failures no longer blacklist a DM without a response; failed events are rolled back and retried via relay redelivery.
+- **Bounded redispatch retries (ocn-8kh)**: failure rollbacks are backoff-delayed (30s/2m/5m) and capped at 3 attempts per process lifetime; the give-up mark is in-memory only so a gateway restart retries the DM.
+- **Persistent relay connections (ocn-nu0)**: pinned nostr-tools to 2.23.3 — 2.23.x patch releases introduced a default 20s relay idle reaper plus a `<forced-ping>` accounting bug that tore down healthy DM subscriptions every ~78s ("relay connection closed by us" loop). Pools now also use the `ws` WebSocket implementation for real protocol-level ping/pong (no more dummy-REQ keepalive every 29s) and disable the idle reaper defensively. DM pool reverted to `enableReconnect: false` so reconnects always re-REQ from the jitter-safe `since` anchor (NIP-59 ±48h) instead of nostr-tools' `lastEmitted + 1`.
+
+### Features — NIP Implementations
+
+#### Tier 1: Agent-Essential
+- **NIP-05**: Identity resolution with 5-min TTL caching (500-entry LRU), domain search, validation
+- **NIP-11**: Relay information documents with 10-min TTL caching (100-entry LRU), capability summaries, NIP filtering
+- **NIP-42**: Relay authentication (`makeAuthEvent` re-export from nostr-tools)
+- **NIP-46**: Remote signing / Nostr Connect (`BunkerSigner`, `parseBunkerInput`, `createNostrConnectURI`)
+- **NIP-57**: Zap utilities (`makeZapRequest`, `validateZapRequest`, `getSatoshisAmountFromBolt11`)
+- **NIP-94**: File metadata — kind:1063 event builder, parser, and validator
+- **NIP-98**: HTTP authentication token generation and validation
+- **NIP-B7**: Blossom media server client re-export
+
+#### Tier 2: Social & Channel
+- **NIP-13**: Proof of Work (`minePow`, `getPow` re-exports)
+- **NIP-18**: Reposts — kind:6 for short text notes, kind:16 for generic events, with NIP-70 protected event handling
+- **NIP-27**: Content block parsing (text, URLs, nostr: references, media, hashtags, emoji)
+- **NIP-28**: Public channels — create (kind:40), message (kind:42), hide message (kind:43), mute user (kind:44)
+- **NIP-44**: Versioned encryption — conversation key derivation, encrypt/decrypt
+
+#### Tier 3: Niche (Namespace Re-exports)
+- **NIP-29**: Relay-based groups
+- **NIP-30**: Custom emoji matching
+- **NIP-39**: External identity verification
+- **NIP-47**: Nostr Wallet Connect
+- **NIP-49**: Private key encryption (ncryptsec)
+- **NIP-58**: Badges
+- **NIP-75**: Zap goals (fundraising)
+- **NIP-77**: Negentropy sync
+
+### Architecture
+- New `nostr-discovery.ts` module — NIP-05/NIP-11/NIP-27 with caching and agent-friendly interfaces
+- New `nostr-extras.ts` module — Tier 3 namespace re-exports
+- Extended `nostr-capabilities.ts` with 15 new builder functions and re-exports
+- Extended `nostr-bus.ts` with 17 new handle methods
+- Extended `channel.ts` with 10 new convenience functions
+- Extended `nostr-profile-http.ts` with 3 new HTTP endpoints (identity, search, relay-info)
+
+### Testing
+- `nostr-discovery.test.ts` — 40+ tests for NIP-05/NIP-11/NIP-27
+- `nostr-capabilities-extended.test.ts` — 28 tests for NIP-18/28/94/13/44/57/42/98
+- `nostr-extras.test.ts` — 9 smoke tests for Tier 3 re-export surface
+- Extended `nostr-profile-http.test.ts` with 7 new endpoint tests
+
+### Earlier Changes (this fork)
+- NIP-17 gift-wrapped DM support (kind:1059) with NIP-59 seals
+- Per-sender message serialization (race condition fix)
+- Provider lifecycle fix (stay resident until abort signal)
+- nostr-tools reconnect fix
+- Full SDK alignment with OpenClaw plugin interface
+
+## 2026.3.14
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.13
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.12
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.11
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.10
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.9
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.8-beta.1
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.8
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.7
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.3
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.2
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.3.1
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.2.26
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.2.25
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.2.24
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.2.22
+
+### Changes
+
+- Version alignment with core OpenClaw release numbers.
+
+## 2026.1.19-1
+
+Initial release.
+
+### Features
+
+- NIP-04 encrypted DM support (kind:4 events)
+- Key validation (hex and nsec formats)
+- Multi-relay support with sequential fallback
+- Event signature verification
+- TTL-based deduplication (24h)
+- Access control via dmPolicy (pairing, allowlist, open, disabled)
+- Pubkey normalization (hex/npub)
+
+### Protocol Support
+
+- NIP-01: Basic event structure
+- NIP-04: Encrypted direct messages
+
+### Planned for v2
+
+- NIP-17: Gift-wrapped DMs
+- NIP-44: Versioned encryption
+- Media attachments