mcpField
X
xrpl-standards

xrpl-standards

github.com/peersystDevelopment371 installsUpdated 24w ago
Repository

About xrpl-standards

xrpl-standards is a reference skill for developers working with XRPL specifications. It organizes specification files by topic, with guidance for locating and refreshing them.

Key features

  1. 01Topic-organized XRPL specifications
  2. 02Field and transaction definitions
  3. 03Ledger objects and invariants
  4. 04Scripts to list and fetch specs

Use cases

  1. 01Look up transaction formats
  2. 02Check protocol failure conditions
  3. 03Review RPC changes by standard

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/peersyst/xrplskills --skill xrpl-standards

After installing, type/xrpl-standardsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

metadata.json
references/accounts/
xls-0007.md
xls-0023.md
xls-0039.md
xls-0049.md
xls-0064.md
xls-0068.md
xls-0071.md
xls-0074.md
xls-0075.md
xls-0077.md
xls-0080.md
xls-0086.md
references/core/
xls-0001.md
xls-0005.md
xls-0008.md
xls-0009.md
xls-0011.md
xls-0012.md
xls-0013.md
xls-0015.md
xls-0017.md
xls-0018.md
xls-0021.md
xls-0022.md
xls-0025.md
xls-0032.md
xls-0037.md
xls-0045.md
xls-0050.md

Details

From the project README

XRPL Standards

Raw specification files for all 75 XRPL Standards (XLS-1 through XLS-102), organized by topic. Read the relevant file to get the full spec — field definitions, transaction formats, ledger objects, failure conditions, invariants, and RPC changes.

How to Use

The path depends on your environment. Find this skill's install directory and read the spec file directly:

Read <skill-dir>/references/<topic>/<file>.md

Common locations:

  • claude.ai: /mnt/skills/user/xrpl-standards/
  • Claude Code (npx skills add): .claude/skills/xrpl-standards/ (relative to project root)

To auto-detect, search for the skill directory:

find /mnt/skills ~/.claude -name "INDEX.md" -path "*/xrpl-standards/references/*" 2>/dev/null | head -1 | sed 's|/references/INDEX.md||'

To list or fetch a spec not yet in refs:

bash <skill-dir>/scripts/list-xls.sh
bash <skill-dir>/scripts/fetch-xls.sh <number>

identity — DID, credentials, sign-in

XLSTitleStatusFile
40Decentralized Identity — DID obj, DIDSet, DIDDeleteFinalreferences/identity/xls-0040.md
63SignIn Transaction — off-chain auth, sfData fieldStagnantreferences/identity/xls-0063.md
70On-Chain Credentials — Credential obj, CredentialCreate/Accept/Delete, DepositPreauth extFinalreferences/identity/xls-0070.md

tokens — NFT, MPT, URIToken

XLSTitleStatusFile
20Non-Fungible Tokens — NFToken, NFTokenMint/Burn/CreateOffer/AcceptOffer/CancelOfferFinalreferences/tokens/xls-0020.md
33Multi-Purpose Tokens (MPT) — MPTokenIssuance, MPTokenIssuanceCreate/Destroy/Set, MPTokenAuthorizeFinalreferences/tokens/xls-0033.md
35URITokens — URIToken obj, URITokenMint/Burn/CreateOffer/BuyOffer/CancelOfferDraftreferences/tokens/xls-0035.md
46Dynamic NFTs — mutable metadata extension to NFTokenFinalreferences/tokens/xls-0046.md
51NFToken EscrowsStagnantreferences/tokens/xls-0051.md
52NFTokenMintOffer — combined mint + offer txFinalreferences/tokens/xls-0052.md
54NFTokenOffer Destination TagStagnantreferences/tokens/xls-0054.md
61Cross-Currency NFTokenAcceptOfferStagnantreferences/tokens/xls-0061.md
89MPT Metadata SchemaFinalreferences/tokens/xls-0089.md
94Dynamic MPT — mutable MPToken fieldsDraftreferences/tokens/xls-0094.md
96Confidential MPT — ConfidentialMPTConvert/Send/MergeInbox/ConvertBack/ClawbackDraftreferences/tokens/xls-0096.md
10Non-Transferable Token standardStagnantreferences/tokens/xls-0010.md
16NFT Metadata v1Stagnantreferences/tokens/xls-0016.md
24NFT Metadata v2Finalreferences/tokens/xls-0024.md
26IOU Token Metadata via xrp-ledger.tomlDraftreferences/tokens/xls-0026.md

defi — AMM, DEX, vault, lending, options

XLSTitleStatusFile
30Automated Market Maker — AMM obj, AMMCreate/Deposit/Withdraw/Vote/Bid/DeleteFinalreferences/defi/xls-0030.md
73AMM Clawback — AMMClawback txDraftreferences/defi/xls-0073.md
81Permissioned DEX — OfferCreate/Payment extensions, PermissionedDomain gatingFinalreferences/defi/xls-0081.md
65Single Asset Vault — Vault obj, VaultCreate/Set/Delete/Deposit/WithdrawDraftreferences/defi/xls-0065.md
66Lending Protocol — LoanBroker, Loan objs, 9 new transactionsDraftreferences/defi/xls-0066.md
62Options — option contract transactionsStagnantreferences/defi/xls-0062.md
60Default AutoBridgeStagnantreferences/defi/xls-0060.md

payments — escrow, channels, batch, remit

XLSTitleStatusFile
56Atomic/Batch Transactions — Batch tx, inner transaction handlingFinalreferences/payments/xls-0056.md
85Token-Enabled Escrows — escrow/channel support for IOU and MPTFinalreferences/payments/xls-0085.md
100Smart Escrows — programmable escrow conditionsDraftreferences/payments/xls-0100.md
55Remit — Remit tx for bundled transfersFinalreferences/payments/xls-0055.md
34Token Payment Channels & Escrow (Withdrawn, superseded by XLS-85)Withdrawnreferences/payments/xls-0034.md
67ChargeStagnantreferences/payments/xls-0067.md
76Min Incoming Amount (Deprecated)Deprecatedreferences/payments/xls-0076.md

accounts — permissions, freeze, signer lists, reserves

XLSTitleStatusFile
74Account Permissions — granular tx-level permission flagsFinalreferences/accounts/xls-0074.md
75Permission Delegation — Delegate obj, DelegateSet txFinalreferences/accounts/xls-0075.md
80Permissioned Domains — PermissionedDomain obj, PermissionedDomainSet/DeleteFinalreferences/accounts/xls-0080.md
86Firewall — account-level transaction filteringDraftreferences/accounts/xls-0086.md
77Deep Freeze — enhanced freeze for trust linesFinalreferences/accounts/xls-0077.md
39Clawback — issuer clawback of IOU balancesFinalreferences/accounts/xls-0039.md
68Sponsored Fees and Reserves — Sponsorship obj, fee/reserve delegationDraftreferences/accounts/xls-0068.md
49Multiple Signer ListsDraftreferences/accounts/xls-0049.md
64Pseudo-AccountDraftreferences/accounts/xls-0064.md
23Lite AccountsStagnantreferences/accounts/xls-0023.md
7Deletable AccountsFinalreferences/accounts/xls-0007.md
71Initial Owner Reserve ExemptionStagnantreferences/accounts/xls-0071.md

data — oracles, subscriptions

XLSTitleStatusFile
47Price Oracles — Oracle obj, OracleSet/Delete, price aggregation RPCFinalreferences/data/xls-0047.md
78Subscriptions — on-chain payment streamsDraftreferences/data/xls-0078.md

cross-chain — bridge, proof of payment

XLSTitleStatusFile
38Cross-Chain Bridge — Bridge obj, XChainCreateBridge, locking/claiming txsFinalreferences/cross-chain/xls-0038.md
41XPOP — proof-of-payment standard, off-chain verification formatFinalreferences/cross-chain/xls-0041.md

smart-contracts — plugins, WASM, contracts

XLSTitleStatusFile
101Smart Contracts — Contract/ContractSource/ContractData objs, ContractCreate/Call/Modify/DeleteDraftreferences/smart-contracts/xls-0101.md
102WASM VM — virtual machine specificationDraftreferences/smart-contracts/xls-0102.md
42Plugins — plugin ledger objectsStagnantreferences/smart-contracts/xls-0042.md

core — protocol fundamentals

XLSTitleStatusFile
13Tickets — Ticket obj, TicketCreate txFinalreferences/core/xls-0013.md
37CTID — Concise Transaction Identifier encodingFinalreferences/core/xls-0037.md
69Simulate — simulate RPC for dry-run executionFinalreferences/core/xls-0069.md
97Server Definitions — server_definitions RPC enhancementsFinalreferences/core/xls-0097.md
22API VersioningFinalreferences/core/xls-0022.md
45Prepublish Validator ListsFinalreferences/core/xls-0045.md
17XFL — developer-friendly balance representationFinalreferences/core/xls-0017.md
5Tagged AddressesFinalreferences/core/xls-0005.md
9Blinded TagsStagnantreferences/core/xls-0009.md
11Retiring AmendmentsFinalreferences/core/xls-0011.md
12Secret NumbersFinalreferences/core/xls-0012.md
18Bootstrapping XRPLD NetworksStagnantreferences/core/xls-0018.md
21Asset Code PrefixesStagnantreferences/core/xls-0021.md
25Enhanced Secret NumbersFinalreferences/core/xls-0025.md
50Validator TOML InfrastructureFinalreferences/core/xls-0050.md
95Rename rippled → xrpldDraftreferences/core/xls-0095.md
1XLS Process and GuidelinesLivingreferences/core/xls-0001.md

ecosystem — wallets, URIs, icons

XLSTitleStatusFile
2Destination InformationStagnantreferences/ecosystem/xls-0002.md
3Deeplink Signed TransactionsStagnantreferences/ecosystem/xls-0003.md
4Trustline Add URIStagnantreferences/ecosystem/xls-0004.md
6Visual Account IconsFinalreferences/ecosystem/xls-0006.md

Refreshing Refs

cd packages/skills-build
pnpm build:xrpl-standards

Comments

Markdown supported