docs(protocol): propose private structured commerce messages#12
Draft
ericfj2140 wants to merge 1 commit into
Draft
docs(protocol): propose private structured commerce messages#12ericfj2140 wants to merge 1 commit into
ericfj2140 wants to merge 1 commit into
Conversation
This was referenced Jul 12, 2026
Draft
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
Proposes a collision-free private structured commerce message envelope using inner rumor kind
1327, versioned named message types, and explicit payment semantics.This PR is stacked on #1 and remains experimental. It does not rewrite the current compatibility snapshot.
Why
The inherited marketplace specification assigns kind
16to private order messages and kind17to payment receipts. Those values now conflict with NIP-18 Generic Repost and NIP-25 external content reactions.The inherited numeric message types also collapse distinct states. In particular, payment proof, merchant verification, fulfillment, cancellation, and refund outcomes need separate meanings.
What changed
1327as the versioned NIP-59 inner rumor envelope.payment_request,payment_proof,payment_confirmed,payment_rejected, refund, fulfillment, and shipping operations.14.16/17dual-read guidance.SPEC.md.Validation
git diff --checkSPEC.md, all pillar files, and all lane files are unchanged from Reorganize specification navigation #1.1327role with the structured-message and payment lifecycle definitions in NIP-XX: Orders #10.Runtime or visual evidence
Documentation-only proposal; no runtime or visual surface changes.
Risks and follow-ups
1327still requires upstream coordination and registration before normative adoption.1327payload to be a signed child event. If both proposals advance, NIP-XX: Orders #10 should consume this envelope and register distinct signed-child message types instead of defining an incompatible second1327format.16and17.mainafter Reorganize specification navigation #1 merges.