Open source

XRPL Lab learn by doing.

CLI training workbook for the XRP Ledger. 12 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.

355 tests

Deterministic test suite covers every module, action, and transport path. Strategy track included.

Web Dashboard

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

Modules

12 modules across three tracks.

Module

Track

What you prove

Receipt Literacy

Beginner

txid + verification report

Failure Literacy

Beginner

failed + fixed txid trail

Trust Lines 101

Beginner

trust line + token balance

Debugging Trust Lines

Beginner

error → fix txid trail

DEX Literacy

Intermediate

offer create + cancel txids

Reserves 101

Intermediate

before/after snapshot delta

Account Hygiene

Intermediate

cleanup verification report

Receipt Audit

Intermediate

audit pack (MD + CSV + JSON)

AMM Liquidity 101

Advanced

AMM lifecycle txids

DEX Market Making 101

Advanced

strategy txids + hygiene report

Inventory Guardrails

Advanced

inventory check + guarded txids

DEX vs AMM Risk Literacy

Advanced

comparison report + audit trail

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
# Open http://localhost:4321/xrpl-lab/app/

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.