Skip to content

feat(specs): add Radix exact scheme - #3112

Open
AVaunt-consulting wants to merge 1 commit into
x402-foundation:mainfrom
AVaunt-consulting:radix-exact-scheme
Open

AVaunt-consulting wants to merge 1 commit into
x402-foundation:mainfrom
AVaunt-consulting:radix-exact-scheme

Conversation

@AVaunt-consulting

Copy link
Copy Markdown

Description

Adds the exact scheme specification for Radix DLT (Babylon networks): specs/schemes/exact/scheme_exact_radix.md, plus the Radix entry in the Critical Validation Requirements summary in scheme_exact.md.

Per the spec-first process, this PR contains the spec only; the SDK implementation will follow once the spec is approved.

Highlights:

  • Two settlement modes: sponsored (recommended; the client signs a payment subintent, the facilitator wraps it in a root transaction and pays fees - clients need no XRD) and non-sponsored (the client signs a complete notarized transaction).
  • VERIFY_PARENT binding restricts which facilitator can consume a sponsored subintent, preventing front-running of the bearer payload.
  • Facilitator verification mandates strict instruction-sequence validation, fee-payer isolation, timestamp-based expiry mapped from maxTimeoutSeconds, replay protection, and preview (CommitSuccess with exact balance deltas) before submission.

CAIP alignment

Network identifiers use the CAIP-2 radix namespace (radix:mainnet, radix:stokenet). We have submitted the corresponding namespace registration - CAIP-2, CAIP-10, and CAIP-19 profiles for Radix - to the ChainAgnostic namespaces registry, currently in review: ChainAgnostic/namespaces#198

Tests

Docs-only change (no SDK code). Mermaid sequence diagrams were validated with mermaid-cli; example bech32m addresses are checksum-valid.

Checklist

  • I have formatted and linted my code
  • All new and existing tests pass (docs-only change)
  • My commits are signed (required for merge) -- you may need to rebase if you initially pushed unsigned commits
  • I added a changelog fragment for user-facing changes (docs-only changes can skip)

Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

@AVaunt-consulting is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions Bot added specs Spec changes or additions unverified Pull request contains unverified commits labels Aug 10, 2026
@github-actions

Copy link
Copy Markdown

Thanks for your contribution @AVaunt-consulting!
Note that we require commit signing, please rebase and verify your commits.

See here for instructions: https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification

The team will not review this PR before ALL commits have been verified and it will be closed after 1 week of inactivity.

Unverified commits:

  • 82b0c3a: unknown_key

@github-actions github-actions Bot removed the unverified Pull request contains unverified commits label Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

specs Spec changes or additions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant