spec: Add draft TXID payment payload specification#1004
Open
alftom wants to merge 2 commits intocoinbase:mainfrom
Open
spec: Add draft TXID payment payload specification#1004alftom wants to merge 2 commits intocoinbase:mainfrom
alftom wants to merge 2 commits intocoinbase:mainfrom
Conversation
🟡 Heimdall Review Status
|
|
@alftom is attempting to deploy a commit to the Coinbase Team on Vercel. A member of the Team first needs to authorize it. |
4 tasks
Adds a draft TXID payment payload (spec-only, for discussion) that validates payments via a payer-submitted on-chain transaction reference.
- Replace top-level settlement field with extra.assetTransferMethod: "txid" - Add design rationale section explaining nonce synchronization issue - Add self-hosted verification guidance (facilitator is optional) - Key replay protection on (network, txRef) instead of txRef alone - Retention window MUST be at least maxTimeoutSeconds - Update base v2 spec to clarify payload structure varies by asset transfer method
alftom
force-pushed
the
spec/payload-txid
branch
from
437975c to
d354ec1
Compare
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
3 participants
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.
Adds a draft TXID payment payload (spec-only, for discussion) that validates payments via a payer-submitted on-chain transaction reference.
Description
This PR adds a draft specification for a new x402 payment payload type, TXID. TXID is a transaction-reference–based payment payload in which the payer executes an on-chain transfer directly and submits a signed payload that references that transaction. This enables x402 payments for assets and networks that do not support authorization-based transfer mechanisms such as EIP-3009, including native assets like ETH.
This draft directly addresses the use case described in Issue #612.
This change is spec-only and intended for discussion.
Notes on structure and naming
This PR introduces a new
specs/payment-payloads/directory to define the structure and processing of different payment payloads. The directory name is not meant to be prescriptive, and alternative naming or placement is open for discussion.The draft specification also introduces an explicit
payload.typefield to identify the payload variant. While payload types could be inferred heuristically by inspecting payload structure, an explicit discriminator is for clarity and efficiency. This choice is not fundamental to the TXID mechanism itself and can be revisited independently.Tests
Not applicable. This PR introduces documentation/specification changes only and does not include any code or testable behavior.
Checklist