Representing physical assets on the XRP Ledger: RWA concepts, tokenization processes, the MPT standard, custody, and compliance.
What you'll learn
A token on a ledger is easy. A token that means something in the real world is the hard, interesting part. Real-world-asset (RWA) tokenization is the practice of issuing an on-ledger token that represents a claim on something off-ledger — a treasury bill, a gold bar in a vault, a square meter of a building, a share of a fund. The token moves at internet speed; the asset sits where it always sat. Your whole job is keeping those two things honestly tied together.
This module is conceptual, but concrete. You won't write a contract here — you'll learn how to design a tokenization: what goes on-chain, what stays off-chain, which token standard fits, and which ledger controls satisfy which compliance requirement. By the end you'll be able to look at any real asset and sketch a credible plan to put it on the XRP Ledger without hand-waving the parts that matter.
A useful mental model: the token is a receipt, not the asset. The value doesn't come from the bytes on-chain — it comes from a legal promise that the receipt is redeemable for the real thing. Most failures in this space are failures of that promise, not of the blockchain. Keep that front of mind and the technical decisions get much clearer.
The first design move is splitting the asset into two layers.
The off-chain layer is the asset itself plus the legal scaffolding around it: who holds custody of the gold, which SPV (special-purpose vehicle) owns the building, what the prospectus says, and — crucially — the legal commitment that one token equals a defined claim. This is where the real value and the real risk live.
The on-chain layer is the token: a transferable, divisible, auditable representation of that claim. The ledger gives you settlement, transparency, and programmable controls. It does not give you legal enforceability — that has to come from the off-chain wrapper.
So when someone says "we tokenized real estate," translate it: an SPV legally owns the property, a custodian and an administrator maintain that structure, and the on-chain token is a claim on the SPV. The blockchain is the registry and the settlement rail. The trust comes from the legal layer. Good designs make that linkage explicit; weak ones blur it and hope nobody asks.
It helps to think of tokenization as a lifecycle rather than a single mint event:
Notice that "issue" — the only purely technical step — is a small slice of the whole. Most of the work, and most of the compliance surface, is in distribution and servicing. Design for the full loop from day one; retrofitting redemption onto a token that wasn't built for it is painful.
The XRP Ledger gives you two native ways to issue a fungible token. Choosing well is the central technical decision of an RWA project.
Trust-line tokens (IOUs) are the original standard. A holder must first create a trust line to the issuer for a given currency code — a bilateral on-chain relationship that says "I'm willing to hold this issuer's token." IOUs are battle-tested and support a rich feature set, but they carry historical baggage: a bidirectional trust model, floating-point balances, and rippling, where tokens with the same currency code but different issuers can flow through connected trust lines to settle multi-party payments. Rippling is powerful for currency-like assets and dangerous if you misconfigure it for an RWA, where you usually want strictly controlled, issuer-to-holder flows.
Multi-Purpose Tokens (MPTs) are the newer standard, designed from the lessons of trust lines and enabled by the MPTokensV1 amendment. They deliberately simplify the model for exactly the RWA use case:
rwa, and RWA subclasses like stablecoin, commodity, real_estate, equity, or treasury, plus URIs for the prospectus or docs.For a brand-new regulated RWA, MPTs are usually the better default: the constrained model removes whole categories of footguns and bakes the asset's identity and disclosure links into the ledger. Reach for IOUs when you specifically need their maturity, their DEX integration, or currency-like rippling behavior. Either way, state the choice and the reason in your design — "we picked MPTs because the asset needs allow-listing and no rippling" is the kind of sentence a reviewer wants to see.
This is where XRPL earns its place for RWAs. Regulated assets come with real requirements — you can only sell to approved investors, you may need to recover assets from a sanctioned holder, you might have to freeze trading during a corporate event. The ledger exposes native controls that map cleanly onto those obligations, on both standards:
RequireAuth on trust lines; require-auth on MPTs). This is your on-chain KYC gate: no approval, no holding. It's the single most important control for a regulated RWA.The design skill is matching the control to the obligation, not switching everything on. A money-market fund token probably wants authorization plus clawback for sanctions compliance. A community-issued token redeemable for event tickets might want authorization and nothing else. Turning on clawback you'll never use just makes your token less trustworthy to holders. Pick the minimum set that satisfies the legal requirements and say why each one is there.
Two threads decide whether a tokenization is real or theater: custody and redemption.
Custody answers "where is the actual asset, and who can prove it's still there?" For a stablecoin it's reserves at a bank with attestations; for tokenized gold it's a vault with audited bar lists; for real estate it's the SPV's title and an administrator. The custody model determines how much a holder must trust the issuer, and it's the part regulators scrutinize hardest. On-chain you can reference custody — link the attestation or report in the token metadata — but you can't replace it. Be explicit about who the custodian is and how often they prove the backing.
Redemption answers "how do I turn the token back into the asset (or its cash value)?" A clean design specifies the redemption path: holder requests redemption, identity is verified, the issuer pays out off-chain and burns the returned tokens so supply always tracks backing. If supply can drift away from what's actually held in custody, the whole receipt model breaks. The redemption path is what makes the token worth its face value rather than just hopeful — design it before you mint, not after.
Hold those two together with the legal wrapper and you have the chain of trust that makes a token mean something: asset → custodian → SPV/legal claim → on-chain token → holder, with redemption closing the loop and ledger controls enforcing the rules along the way.
You've completed this module when you can take a real-world asset of your choice and write a short tokenization design that names: (1) what one token represents and the total supply, (2) the token standard — IOU or MPT — and the reason, (3) the specific ledger compliance controls (authorization, freeze, clawback, transfer fee) and which obligation each one satisfies, (4) the custody model and who proves the backing, and (5) the redemption path that keeps supply tied to the asset. Submit it as a one-to-two page doc and self-verify it against this list — if any of the five is missing or hand-waved, it isn't done yet.
Assignments
0 of 1 complete