Skip to content

Commands

CommandDescription
xrpl-lab startGuided launcher — walks through wallet setup, funding, and first module
xrpl-lab listShow all modules with completion status in a formatted table
xrpl-lab run <module_id>Run a specific module (add --force to redo a completed module)
xrpl-lab statusShow progress, wallet info, env overrides, and recent transactions
xrpl-lab last-runShow details of the last module run + suggested audit command
xrpl-lab --versionPrint the installed version and exit
CommandDescription
xrpl-lab proof-packExport a shareable proof pack (JSON with SHA-256 integrity)
xrpl-lab certificateExport a slim completion certificate
xrpl-lab audit --txids <file>Batch verify transactions against expectations
FlagDescription
--txids <file>Required. File with one transaction ID per line
--expect <file>Optional expectations JSON file (type checks, memo prefix, etc.)
--csv <path>Write a CSV report to this path
--md <path>Write a Markdown report to this path
--dry-runUse the dry-run transport for verification
CommandDescription
xrpl-lab wallet createCreate a new testnet wallet (add --path <dir> for custom location)
xrpl-lab wallet showShow wallet info (no secrets displayed)
xrpl-lab fundFund wallet from the testnet faucet
xrpl-lab send --to <addr> --amount <xrp>Send a payment (optional --memo <text>)
xrpl-lab verify --tx <id>Verify a single transaction on-ledger
CommandDescription
xrpl-lab doctorRun diagnostic checks (wallet, state, workspace, env overrides, RPC, faucet, last error)
xrpl-lab self-checkAlias for doctor
xrpl-lab feedbackGenerate issue-ready markdown for bug reports
xrpl-lab resetWipe local state (requires typing RESET to confirm; add --keep-wallet to preserve wallet)
VariablePurpose
XRPL_LAB_RPC_URLOverride the default XRPL Testnet RPC endpoint
XRPL_LAB_FAUCET_URLOverride the default testnet faucet URL

Both overrides are reported by xrpl-lab status and xrpl-lab doctor when set.

All commands support --dry-run for offline mode where applicable. Dry-run mode simulates transactions without touching the network — useful for learning the workflow or working without an internet connection.