docs: add Nip46Lab as a neutral reference client for NIP-46 triage#21
Merged
Conversation
Adds a "Reference test clients" section to docs/nip46-compatibility.md positioning Nip46Lab and Amber as complementary triage tools (Nip46Lab verifies the signer-side; Amber verifies the client-side). Updates Triage guide Step 1 with an optional Nip46Lab reproduction step, and extends the "Already triaged?" hint in the NIP-46 interop issue template with concrete examples of useful pre-filing narrowing. Validated bunker:// flow against Clave build 31 — connect (secret echo accepted), get_public_key, ping, sign_event, switch_relays all return spec-shaped responses. Validation log: troubleshooting/2026-04-30-nip46lab-validation.md in working notes. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Why
The triage guide's Step 1 currently routes everyone to "test against another signer" — which means installing Amber on Android. Nip46Lab is a single-page HTML testbench (no install) by greenart7c3 (also Amber's author), giving us the inverse direction: a neutral client in a browser tab. Closes a real diagnostic gap for incoming
nip46-compat-labeled issues.No matrix row added — Nip46Lab is a debug tool, not an end-user client to interop with.
Validation
Manually exercised the
bunker://flow end-to-end against Clave build 31 before adding the recommendation. Per-RPC results:connectto_ack()?parser trip-wire is not present in Nip46Lab)get_public_keypingpongsign_event(kind 1)switch_relays"null"per PR #7 (Coracle/welshman fix)Encrypt/decrypt RPCs were exercised with empty pubkey fields and Clave returned spec-shaped error messages (
"Invalid public key"/"Invalid base64") — validates input handling. Happy-path encrypt/decrypt not tested due to a Nip46Lab UX gap (recipient field doesn't default to user pubkey); the underlying transport is exercised by every other RPC anyway.Test plan
docs/nip46-compatibility.mdrenders correctly on github.com (markdown formatting matches surrounding sections)Notes
Nip46Lab itself is brand-new (created 2026-04-30, single commit). I observed two minor UI/state issues in Nip46Lab worth filing upstream separately:
get_public_keyresolves — would enable one-click self-roundtrip testingNeither affects this doc PR's recommendation since first-session bunker flow works correctly.
🤖 Generated with Claude Code