Skip to content
XCXRPL Camp
Open source

XRPL Camp learn the ledger in one sitting.

Six lessons on a real public ledger. Your payment brings an account into existence, your memo is permanent, and the record you keep can be checked against the ledger itself. No accounts, no real money, about ten minutes.

Install

pipx install xrpl-camp

Start

xrpl-camp start

Break it

xrpl-camp try

Features

Everything you need to understand the XRPL — nothing you don't.

Real transactions

Create a wallet, fund it, and send a payment that brings a second account into existence — on the actual Testnet, not a sandbox. The ledger metadata proves the account was created.

Failure as curriculum

xrpl-camp try breaks things on purpose against the live network. It signs nothing and costs nothing, then shows you which failures would have reached the ledger and charged you.

Proof you can check

The proof pack names real transactions. proof verify --online asks the ledger whether they happened — the part a hash cannot prove and nobody can fake.

Usage

Install

npx @mcptoolshop/xrpl-camp start
# or: pipx install xrpl-camp
# or: docker run --rm -it -v "$PWD:/work" \
#       ghcr.io/mcp-tool-shop-org/xrpl-camp start

Guided flow

xrpl-camp start

# 1. Mental Model      asked of the live network
# 2. Create Wallet     the seed stays on your machine
# 3. Fund Wallet       and why some of it is locked
# 4. Send Payment      this one creates an account
# 5. Verify            compare the ledger to what you typed
# 6. Certificate       a record you can prove

Afterwards

# your entries, read back off the ledger
xrpl-camp read

# what somebody else wrote — no key needed
xrpl-camp read rSomeoneElsesAddress

# ask the ledger whether your record is real
xrpl-camp proof verify xrpl_camp_proof_pack.json --online

Commands

Every networked command supports --dry-run.

CommandWhat it does
xrpl-camp startGuided flow through all 6 lessons
xrpl-camp readYour entries, read back off the ledger
xrpl-camp read <address>Somebody else's public history — no key, no login
xrpl-camp tryBreak it on purpose. Signs nothing, costs nothing
xrpl-camp status --detailFacilitator view: wallet, endpoint, state directory
xrpl-camp send --memo "hello"Send a memo payment to your mailbox
xrpl-camp verify --tx <hash>Verify a transaction you sent
xrpl-camp certificateGenerate certificate + proof pack
xrpl-camp proof verify <file>Check the pack's hash. Fully offline
xrpl-camp proof verify <file> --onlineAlso ask the ledger whether it happened
xrpl-camp self-checkDiagnose your environment and your connection
xrpl-camp resetWipe all state (typed confirmation)

Safety

Built for learning, not for losing.

Testnet, and enforced

The endpoint's network is checked before anything is signed, and a non-Testnet endpoint is refused unless you explicitly opt out. Test XRP has no real value.

Your seed stays yours

Stored locally, owner-only on POSIX, and never written into a certificate or proof pack — generation refuses the file if a seed is present. Your memo is scanned for secrets before it becomes permanent.

No telemetry

No analytics, no phone-home, no accounts. The only network calls go to the XRPL endpoint in use, and self-check tells you which one that is.