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 five tracks.

Module

Track

What you prove

Receipt Literacy

foundations

txid + verification report

Failure Literacy

foundations

failed + fixed txid trail

Trust Lines 101

foundations

trust line + token balance

Debugging Trust Lines

foundations

error → fix txid trail

DEX Literacy

dex

offer create + cancel txids

Reserves 101

reserves

before/after snapshot delta

Account Hygiene

reserves

cleanup verification report

Receipt Audit

audit

audit pack (MD + CSV + JSON)

AMM Liquidity 101

amm

AMM lifecycle txids

DEX Market Making 101

dex

strategy txids + hygiene report

Inventory Guardrails

dex

inventory check + guarded txids

DEX vs AMM Risk Literacy

amm

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.