Latest
The XRPL Codex · Free

Learn the XRP Ledger
by building it, with an expert beside you

A free, hands-on apprenticeship that runs inside Claude Code. You build one real project, step by step, on a real XRP Ledger running on your own computer. Every step is explained in plain English, and you can ask anything, any time.

19Lessons + a bonus lab
49Mainnet transaction types, all covered
3.4.1xrpld, the version mainnet runs
$0To start
Start the XRPL Codex free → Watch it in action ↓

See it

Seventy seconds. Then try it yourself.

What the Codex is, and moments from a real session: the story, the explanations, a learner's question, a deliberate failure, and the passport. Prefer the whole thing? Watch the full unedited session (Lessons 00–02, about five minutes, sped up).


Why it's different

Not a course you watch. An apprenticeship you do.

◆
You build, it guides

Your AI agent writes and runs real code with you, on a private XRP Ledger on your machine, then on the public Testnet. One project grows lesson by lesson.

◇
Every step explained

Each idea comes with a plain-English analogy first, then the code, then what the ledger said back and why.

◎
Ask anything, at your pace

Stuck, curious or sceptical? Ask, from the very first step, and go as deep as you like. You get a straight answer from a patient expert who knows exactly where you are. Nothing moves until you say continue.

✓
Break it on purpose

Every lesson makes something fail on purpose, so real error messages make sense when you meet them later.

◈
A passport that proves it

Each finished lesson lights a stamp on your Codex Passport, with a public page anyone can check. Later lessons are checked against the ledger itself.

◉
Always current

Built on xrpld 3.4.1, the version mainnet runs, with the same 98 switched-on amendments. Every one of the 49 transaction types live on mainnet is in a tested lesson. Updated when the network changes.


Get started

Three steps. About two minutes.

1
Sign in
Google or email at dashboard.chainlore.dev.
2
Copy one command
Create your personal Codex token and paste the command it gives you into your terminal.
3
Say it
Open Claude Code and say “Start the XRPL Codex”. Your apprenticeship begins.

What you need: Claude Code (included with Claude Pro and Max plans, or with an API key), Node.js 22 or newer, and ideally Docker. No Docker? The few local-only steps become guided tours and everything else runs on the public Testnet. No blockchain experience needed. The Codex is free; the lessons run on your own Claude Code plan, and usage counts toward it like any other coding session.

Start free →

Curriculum

Nineteen lessons, one real product

You don't do isolated exercises. Pick a story (a coffee farm, an apartment building, an art collection or a music catalogue) and turn it into a real tokenized asset: accounts, a stablecoin market, compliance checks, escrowed sales, a price oracle, and finally a public demo you can show anyone.

00
Setup — your own private XRP Ledger in three minutes
Run your own private XRP Ledger on your computer and set up your project in minutes.
stamp: First Lightstart here
01
Consensus — how strangers agree without mining
How independent validators agree on one shared history every few seconds, with no mining.
stamp: The Quorumstart here
02
Your node — ledgers, amendments, and features waiting for a vote
Drive your own node: close ledgers by hand and see how new features get switched on by vote.
stamp: Node Keeperstart here
03
Accounts & keys — the cast of your asset
Create the accounts your project needs, and learn why a key pair alone is not an account.
stamp: Keyholder
04
Transactions — prepare, sign, submit, validate
Follow a transaction from draft to signed to final, and learn to read every result code.
stamp: The Courier
05
Trust lines & stablecoins — money that someone owes you
Issue a dollar-style token and learn how trust lines let people hold it safely.
stamp: Line of Trust
06
DEX & AMM — a built-in exchange and a liquidity pool
Trade on the ledger's built-in exchange and run your own liquidity pool.
stamp: Market Maker
07
Multi-Purpose Tokens — RWA goes on-ledger
Turn your real-world asset into a token with the newest token standard.
stamp: Tokensmith
08
DID & Credentials — on-ledger KYC without putting personal data on-ledger
Check investors with on-ledger credentials, without putting personal data on the ledger.
stamp: The Verifier
09
Permissioned Domains & the Permissioned DEX — a members-only market
Open a members-only market where only verified investors can trade.
stamp: Gatekeeper
10
Escrow & Token Escrow — money that waits for the right moment
Make money wait for the right moment: time-locked and conditional payments.
stamp: Timekeeper
11
Price Oracles — what is RWA worth?
Publish a trustworthy price for your asset with an on-ledger oracle.
stamp: The Oracle
12
Payments toolbox — pathfinding, checks and payment channels
Pay in one currency, deliver in another: pathfinding, checks and payment channels.
stamp: Pathfinder
13
Multi-signing & Permission Delegation — no single key rules everything
No single key rules everything: shared control and limited, delegated permissions.
stamp: The Council
14
Batch — atomic delivery-versus-payment
Settle a sale in one all-or-nothing step: the shares and the payment move together.
stamp: The Settler
15
NFTs & Dynamic NFTs — a certificate that updates itself
Issue certificates as NFTs, including ones that update themselves.
stamp: The Engraver
16
Ledger internals — proving nothing was tampered with
Prove that nothing in your project's history was ever changed.
stamp: The Auditor
17
Testnet → Mainnet — same rules, real value, real care
Move from practice networks to the real one, safely.
stamp: The Steward
18
Ship it — your asset, live, tested, and yours to show the world
Ship it: a tested, documented project on GitHub, and your Master of Lore stamp.
stamp: Master of Lore
19
Frontier Lab — try tomorrow's XRPL today (not live on mainnet)
Bonus: try features that are built but not yet live on mainnet, on your own ledger.
stamp: Frontier Scoutbonus

XRP Ledger Education Month

Learn how the ledger really decides

The XRP Ledger Foundation is running XRP Ledger Education Month (#XRPEducationMonth) to help more people understand how the network works and the upgrades coming to it. The XRPL Codex is our contribution: a free way to learn it by doing.

◆
How the network agrees

Lesson 01: validators, trusted lists and why the ledger pauses rather than forks.

◇
How upgrades switch on

Lesson 02: amendments, the 80% vote, and what happens when you use a feature before it's live.

◎
What's coming next

Lesson 19, the Frontier Lab: try features that are built but not yet live on mainnet, such as single-asset vaults, on your own private ledger, and see how the Lending Protocol and Confidential Transfers will work.

Chainlore is independent and not affiliated with or endorsed by the XRP Ledger Foundation.


For universities

Two skills in one course: the XRP Ledger and AI-assisted development

Students learn blockchain the way modern engineers work: alongside an AI agent, in a real terminal, on a real codebase. Every student gets their own project in their own Git repository and a public passport link instructors can check. It's free for every student, with no seats to request.

For instructors →

The lore is free.
Start building today.

Nineteen lessons and a bonus lab. One real project. An expert beside you the whole way.

Start the XRPL Codex →
Free · No credit card · Works in Claude Code
Coming next

More codexes are in the forge