XL XRPL Lab
GitHub
Open source

XRPL Lab learn by doing.

CLI training workbook for the XRP Ledger. 32 hands-on modules — each one teaches a skill and produces a verifiable artifact. No accounts, no fluff.

Get started Read the Handbook

Install

pipx install xrpl-lab

Start

xrpl-lab start

Offline

xrpl-lab start --dry-run

Why XRPL Lab

Real skills, real receipts.

Artifact-driven

Every module produces a verifiable artifact — transaction IDs, audit packs, proof packs with SHA-256 integrity.

Offline-first

Full dry-run mode with simulated transactions. Learn the workflow without touching the network.

Thoroughly tested

A comprehensive, deterministic test suite covers every module, action, and transport path — including NFT, token, escrow, and DID flows.

Web Dashboard

Interactive browser UI with real-time module runner, artifact viewer, and health diagnostics. Run xrpl-lab serve to start.

Modules

32 modules across ten tracks.

Module
Track
Produces
Receipt Literacy
foundations
txid, report
Failure Literacy
foundations
txid, report
Trust Lines 101: Issued Currencies as Relationships
foundations
txid, report
Debugging Trust Lines
foundations
txid, report
Multisig Treasury (SignerListSet): N-of-M Control of the Studio Wallet
foundations
txid, report
NFT Minting 101: Your First Game Asset
nfts
txid, report
NFT Marketplace 101: Trading Assets with Enforced Royalties
nfts
txid, report
Dynamic NFTs 101: A Game Item That Levels Up
nfts
txid, report
MPT Issuance 101: A Game Currency in One Transaction
tokens
txid, report
MPT Distribution 101: Getting the Currency to Players
tokens
txid, report
Token Freeze 101: The Issuer's Pause Button
tokens
txid, report
Clawback 101: The Issuer Recall Lever
tokens
txid, report
Escrow 101: Time-Locked XRP
payments
txid, report
Escrow Finish 101: Releasing Locked XRP
payments
txid, report
Token Escrow (XLS-85): Locking IOUs, Not Just XRP
payments
txid, report
Checks 101: Deferred Pull-Payments (CheckCreate / CheckCash / CheckCancel)
payments
txid, report
Payment Channels 101: Sign Many, Settle Once
payments
txid, report
Delivered Amount: The Partial-Payment Exploit
payments
txid, report
Custodial Player Crediting: One Pooled Wallet, Many Players (Destination Tags)
payments
txid, report
DID 101: On-Ledger Identity
identity
txid, report
Credentials 101 (XLS-70): On-Ledger KYC & Age Attestations
identity
txid, report
Permissioned Domains & Gated DEX (XLS-80/81): Compliant, Credential-Gated Trading
identity
txid, report
Deposit Gate (DepositAuth + DepositPreauth): Credential-Gated Treasury Deposits
identity
txid, report
DEX Literacy: Offers, Order Books, and Cancellations
dex
txid, report
DEX Market Making 101: Earning Spread on the Order Book
dex
txid, report
DEX Inventory Guardrails: Don't Get Lopsided
dex
txid, report
Reserves 101: Where Your XRP 'Went'
reserves
txid, report
Account Hygiene: Freeing Reserves and Cleaning Up Objects
reserves
txid, report
Audit Mode: Verify Receipts at Scale
audit
report, audit_pack
AMM Liquidity 101: Providing Liquidity and Earning Fees
amm
txid, report
DEX vs AMM Risk Literacy: Comparing Trading Strategies
amm
txid, report
Capstone: Stand Up a Minimal Game Economy on XRPL
capstone
txid, report, audit_pack

Usage

Install

pipx install xrpl-lab

Start learning

xrpl-lab start
# or offline:
xrpl-lab start --dry-run

Run a module

xrpl-lab run receipt_literacy

Verify your work

xrpl-lab audit --txids .xrpl-lab/last_run_txids.txt \
  --expect presets/strategy_mm101.json

Web UI

xrpl-lab serve
# then open the dashboard URL it prints

Artifacts

What you walk away with.

Proof packs

Shareable JSON with completed modules, transaction IDs, and explorer links. SHA-256 integrity hash. No secrets.

Audit packs

Batch verification results in Markdown, CSV, and JSON. Expectation configs for type, memo, and result code checks.

Certificates

Slim completion records. Soft-linked to XRPL Camp for ecosystem integration.