← Lesson 4: XRP Wallets and Self-Custody

Education · 05

Trust Lines and Checks on the XRP Ledger

What if you could choose which tokens your account accepts, or write a payment someone can collect later? The XRP Ledger has a tool for each. Let's break it down with Bird.

Trust lines

Two tokens can have the same name and still be different. On the XRP Ledger, an issued token is identified by its currency code and issuer address. A trust line lets your account hold a token from a specific issuer. When you submit a TrustSet, you choose the issuer and set a limit for how much of that token you can hold. XRP is built into the ledger, so it doesn't need a trust line.

Remember Batch from Lesson 3? A wallet that supports BatchV1_1 can put trust line setup and a OfferCreate buy in one batch. If the batch uses All or Nothing (tfAllOrNothing) and the offer is set to Fill-or-Kill, both actions succeed or neither does. If the full order can't be filled, the new trust line won't be set up either.

Checks

Think of a Check like a paper cheque, but on the ledger.

With CheckCreate, you name who can collect the Check, set a maximum amount, and can add an expiry time. Only that person can collect it with CheckCash. Either person can cancel it with CheckCancel before it is cashed.

The XRP stays in your account until the recipient collects the Check. If you don't have enough XRP when they try, the payment can fail.

Checks and trust lines can work together too. The CheckCashMakesTrustLine amendment lets an eligible token Check set up the trust line needed to receive that token when it is cashed.

Why have these extra steps?

On Ethereum, for example, people can send tokens to your address without asking first. A scammer might send a token called “Claim Your Reward” and hope you visit a fake site or sign something that gives them access to your funds.

On the XRP Ledger, a stranger generally needs you to have a trust line for that exact token and issuer before they can send it as a direct payment. That gives you a chance to check who issued it first. An unexpected Check can also be left uncashed.

The ledger provides these protections, but it still matters what you choose to sign.

The takeaway?

A trust line lets you choose which issued tokens your account can hold. A Check lets the named recipient choose when to collect a payment.

Lesson 6: AMM Pools on the XRP Ledger →

Nothing Bird posts is financial advice. Beware of impersonators and scams. Always verify information through the official Bird account. Stay safe.