Teach the XRP Ledger
the way engineers now work
The XRPL Codex is a free, nineteen-lesson apprenticeship (plus a bonus lab) that runs inside Claude Code. Every student builds a complete, working project on a real XRP Ledger, guided by an AI partner that explains each step, answers their questions, and asks them to explain it back before moving on.
From knowing about a ledger to building on one
Real transactions from week one
Students run their own private XRP Ledger, submit real transactions, and meet real error codes. Theory arrives exactly when they need it to understand what just happened.
Working with an AI agent, critically
Students learn to direct an AI coding agent, question its output, and verify results against the ledger. That is how a growing share of professional software is now built, and it is rarely taught.
An expert beside every student
Each student gets patient, individual guidance at their own pace, at any hour, without adding teaching assistants. Instructors spend their time on discussion and design, not setup problems.
The same rigorous loop in every lesson
Every lesson follows one structure: context, an everyday analogy, doing it, reading what the ledger returned, breaking it on purpose, explaining it back, recalling earlier lessons, and a checkpoint.
Checkpoints ask students to explain the idea in their own words. The guide fills gaps before the student moves on.
Each lesson triggers a real error deliberately, so students learn to read and recover from what production systems actually say.
Short questions link each lesson back to earlier ones, so concepts compound instead of fading.
Students say whether they are new to blockchain or experienced developers, and the depth of explanation adjusts.
Students can stop and ask anything, including “why” questions about design trade-offs and governance, and get balanced answers.
Lessons track the XRP Ledger server version and the features switched on in mainnet, so students learn the network as it is today.
By the end, students can
How consensus reaches finality without mining, and how protocol upgrades are proposed and voted on.
Accounts and keys, transactions and result codes, issued tokens and Multi-Purpose Tokens, the built-in exchange and AMM.
On-ledger credentials, members-only markets, escrow, price oracles, multi-signing and atomic settlement.
Prove a ledger's history is untampered, move safely from test networks to mainnet, and ship a tested, documented project.
Three ways to use it
- Lessons 00–04 as a two-to-three week lab
- Fits fintech, distributed systems or blockchain courses
- Students keep going on their own afterwards
- All nineteen lessons, one project that grows each week, plus the bonus Frontier Lab
- Seminar time for the “why” questions
- Lesson 18 doubles as the final project
- The full path in three to four weeks
- Students end with a public project and passport
- Good preparation for ecosystem grants
Evidence of learning, not just completion
Each student builds in their own Git repository, with a commit per lesson you can review like any other coursework.
Each student has a Codex Passport page showing which lessons they have completed, at a link they can submit.
From Lesson 03 on, work is checked against the ledger itself. Accounts and transactions must be the student's own: the same account or transaction can't count for two students.
A class-level progress view is being built with our first pilot courses. Tell us what you need to see.
What students need
Free to use
The Codex has no licence fee. Lessons run in Claude Code, which students access through a Claude plan or API credits; institutional plans and credits work too.
A laptop and ten minutes
Claude Code, Node.js 22 or newer, and ideally Docker. Without Docker, local-only steps become guided tours and the rest runs on the public Testnet.
Practice networks only
No real money is needed at any point. Student code stays on the student's machine; we store sign-in identity, lesson progress and the public ledger addresses used in checks. See our privacy policy.
A hands-on lab for XRP Ledger education
Many universities already teach the XRP Ledger, including through programs such as Ripple's University Blockchain Research Initiative, and the XRP Ledger Foundation is running XRP Ledger Education Month (#XRPEducationMonth). The Codex gives these efforts a free, hands-on lab students can start today.
Chainlore is independent. Naming these programs does not imply partnership with or endorsement by them.
Plan a course with us
Tell us about your course. We'll help you plan the lessons around your syllabus, set up a pilot, and build the instructor view around what you need. Students don't need codes: they can start free today.
Give every student an expert beside them
Free for students and institutions. Try the first lessons yourself in ten minutes.
Plan a course →