XL XRPL Lab
npm / CLI

XRPL Lab, learn by doing, prove by artifact.

12 hands-on modules across Beginner, Intermediate, and Advanced tracks. Each module produces a verifiable artifact — transaction IDs, audit packs, and proof packs with SHA-256 integrity. No Python required.

Run

npx @mcptoolshop/xrpl-lab start

List

npx @mcptoolshop/xrpl-lab list

Audit

npx @mcptoolshop/xrpl-lab audit

Why XRPL Lab?

A training workbook that treats the ledger as your classroom.

No Python Required

Runs as a single binary via npm. No pip, no virtual environments, no dependencies to manage.

12 Modules, 3 Tracks

Beginner through Advanced. Each module teaches one skill and produces one verifiable artifact.

Verifiable Artifacts

Every module outputs transaction IDs, audit packs, or proof packs with SHA-256 integrity checks.

Offline Mode

Dry-run mode with simulated transactions. Learn the workflow without touching testnet.

Binary Integrity

SHA-256 checksum verification on every download. No telemetry. No network beyond initial fetch.

Cross-Platform

Linux x64, macOS ARM64, and Windows x64. First run downloads ~25 MB, then launches instantly from cache.

Quick Start

Run your first module

# Launch the guided workbook
npx @mcptoolshop/xrpl-lab start

# Or run offline (recommended for AMM modules)
npx @mcptoolshop/xrpl-lab start --dry-run

# List all 12 modules
npx @mcptoolshop/xrpl-lab list

Verify your work

# Check your progress across all tracks
npx @mcptoolshop/xrpl-lab status

# Batch verify all transactions
npx @mcptoolshop/xrpl-lab audit

# Show last run details
npx @mcptoolshop/xrpl-lab last-run

Modules

12 modules across three progressive tracks.

Track
Module
Skill
Beginner
Receipt Literacy
Read and interpret transaction receipts
Beginner
Failure Literacy
Understand why transactions fail
Beginner
Trust Lines 101
Create and manage trust lines
Beginner
Debugging Trust Lines
Diagnose trust line issues
Intermediate
DEX Literacy
Navigate the decentralized exchange
Intermediate
Reserves 101
Understand account reserves
Intermediate
Account Hygiene
Clean up and secure accounts
Intermediate
Receipt Audit
Batch verify transaction history
Advanced
AMM Liquidity 101
Automated market maker basics
Advanced
DEX Market Making 101
Place and manage DEX offers
Advanced
Inventory Guardrails
Protect against inventory risk
Advanced
DEX vs AMM Risk Literacy
Compare trading venue risks

Commands

Command
Description
npx @mcptoolshop/xrpl-lab start
Guided module launcher
npx @mcptoolshop/xrpl-lab list
Show all 12 modules
npx @mcptoolshop/xrpl-lab run <module>
Run a specific module
npx @mcptoolshop/xrpl-lab status
Check progress across tracks
npx @mcptoolshop/xrpl-lab doctor
Diagnose environment issues
npx @mcptoolshop/xrpl-lab audit
Batch verify all transactions
npx @mcptoolshop/xrpl-lab last-run
Show last run + audit command
npx @mcptoolshop/xrpl-lab --help
See all available commands

Troubleshooting

Command
When to use
npx @mcptoolshop/xrpl-lab self-check
Diagnose your environment
npx @mcptoolshop/xrpl-lab feedback
Generate issue-ready markdown
npx @mcptoolshop/xrpl-lab --print-cache-path
Find cached binary location
npx @mcptoolshop/xrpl-lab --clear-cache
Force fresh re-download
npx @mcptoolshop/xrpl-lab@1.0.0 start
Pin to a specific version