Skip to content

Conversation

@aristotle-satoshi
Copy link
Contributor

Add specification for the exact payment scheme on XRP Ledger, supporting both native XRP and IOU (issued currency) payments.

Description

This PR adds the exact payment scheme specification for the XRP Ledger (XRPL), following the pattern established by existing chain-specific specs (EVM, SVM, Sui, Aptos).

Key features:

  • Support for native XRP payments (amounts in drops)
  • Support for IOU (Issued Currency) payments with issuer validation
  • CAIP-2 network identifiers: xrpl:0 (Mainnet), xrpl:1 (Testnet), xrpl:2 (Devnet)
  • Invoice binding via Memos or InvoiceID field
  • Comprehensive facilitator verification rules
  • Security considerations for replay protection and partial payment prevention

Tests

This is a specification document only - no code changes.

  • Spec structure matches existing scheme specs (scheme_exact_evm.md, etc.)
  • Uses MUST/SHOULD/MAY language per specs/CONTRIBUTING.md guidelines
  • Includes JSON examples for PaymentRequirements and PaymentPayload
  • Documents Security Considerations section

Checklist

  • I have formatted and linted my code
  • All new and existing tests pass
  • My commits are signed (required for merge)

Add specification for the exact payment scheme on XRP Ledger, supporting
both native XRP and IOU (issued currency) payments.
@cb-heimdall
Copy link

cb-heimdall commented Jan 17, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@vercel
Copy link

vercel bot commented Jan 17, 2026

@aristotle-satoshi 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 the specs Spec changes or additions label Jan 17, 2026
@phdargen
Copy link
Contributor

Hi @aristotle-satoshi, thanks a lot for putting this together! However, we already have an ongoing PR for the exact XRPL scheme, see #777.

Closing yours to keep discussion about this topic in one place. Please review #777 and check how it differs from your proposal, your feedback would be much appreciated!

@phdargen phdargen closed this Jan 18, 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

Development

Successfully merging this pull request may close these issues.

3 participants