Skip to content

docs: NWC connection backup cross-platform parity contract#560

Closed
dmnyc wants to merge 1 commit into
barrydeen:mainfrom
dmnyc:docs/nwc-backup-parity
Closed

docs: NWC connection backup cross-platform parity contract#560
dmnyc wants to merge 1 commit into
barrydeen:mainfrom
dmnyc:docs/nwc-backup-parity

Conversation

@dmnyc

@dmnyc dmnyc commented May 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Companion to WALLET_PARITY.md and LIGHT_MODE_COLOR_PARITY.md. Captures the contract for backing up + restoring the NWC connection string via a NIP-78 application-specific data event so the same connection follows the user's nostr key across devices and platforms.

iOS landed this in barrydeen/wisp-ios#167 (feat/wallet-nwc-backup). This doc is the contract the Android port should mirror.

Locked values:

Field Value
kind 30078 (NIP-78)
d tag nwc-wallet-backup (flat — no namespacing, for cross-platform interop)
Encryption NIP-44 v2 self-to-self
Plaintext raw nostr+walletconnect://… URI (no JSON wrapper)
Publish trigger every successful NWC connect; reconnects replace via addressable-event semantics

Includes an iOS-side implementation reference table, an Android port checklist, and a cross-platform interop quick-test (publish from one client → restore from the other).

Test plan

  • Doc renders cleanly in GitHub.
  • Internal links to WALLET_PARITY.md resolve (it sits in the repo root next to this).
  • Android implementer can read this and produce a behaviour-matching port without ambiguity (verified by completing the §5 checklist).

Companion to WALLET_PARITY.md. Captures the contract for backing up
+ restoring the Nostr Wallet Connect (NWC) connection string via a
NIP-78 application-specific data event so the same connection
follows the user's nostr key across devices and platforms.

iOS landed this in barrydeen/wisp-ios PR barrydeen#167
(feat/wallet-nwc-backup). This doc is the contract the Android port
should mirror — kind 30078, flat d-tag `nwc-wallet-backup` (no
namespacing for cross-platform interop), NIP-44 v2 self-to-self
encryption, raw URI plaintext.

Includes: locked values for event shape + encryption, publish /
restore triggers, remote-signer gating rationale, an iOS-side
implementation reference table, an Android port checklist, and a
cross-platform interop quick-test (publish from one client →
restore from the other).
@dmnyc

dmnyc commented May 22, 2026

Copy link
Copy Markdown
Contributor Author

Superseded by #563, which lands the feature implementing this contract. Closing the docs-only PR — the parity contract is preserved verbatim in the new PR's description and (if needed) can be re-introduced as a tracked doc in a follow-up.

@dmnyc dmnyc closed this May 22, 2026
@dmnyc dmnyc deleted the docs/nwc-backup-parity branch May 23, 2026 00:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant