XRPL Trust Lines Explained: Tokens, Limits, Reserves, and Wallet Safety
An XRPL trust line is the ledger relationship that lets an account hold a specific token issued by a specific address. It records a balance, a limit, and settings such as rippling or freeze status. It does not make the issuer trustworthy, endorse the token, or guarantee that anyone will redeem it.
That distinction is the foundation of safe XRPL token use. A currency code such as USD, EUR, or GOLD is not globally unique. On the XRP Ledger, the asset identity includes both the code and the issuer address. Two tokens displaying the same ticker but issued by different accounts are different assets with different redemption promises, controls, and risks.
What a Trust Line Actually Contains
The official XRPL trust line documentation describes each line as a shared RippleState ledger object between two accounts for one currency. From a holder's perspective, the useful fields are the issuer, currency, current balance, holding limit, and line settings. A wallet normally creates or changes this relationship with a TrustSet transaction.
A trust line is bilateral in its data model, but it is not a conventional deposit contract. The balance is an obligation denominated in the issuer's token. If you hold 100 units, that does not mean the ledger has locked 100 XRP or 100 dollars behind them. Redemption depends on the issuer's terms, reserves, operations, and willingness or legal obligation to honor the token.
Why XRP Needs No Trust Line
XRP is the native asset of the XRP Ledger. It exists as the XRP balance on an account, not as an obligation issued over a trust line. You can receive XRP without approving an issuer because there is no issuer. XRP also pays transaction costs and supports account reserve requirements.
This difference has an important security consequence. The issuer controls discussed below apply to issued trust line tokens, not XRP. Official guidance on freezing tokens is explicit that no one can freeze native XRP at ledger level. A custodial platform can restrict access to XRP it controls, but that is a service level restriction, not an XRPL token freeze.
What the Trust Line Limit Means
The limit is the maximum token balance that other accounts' ordinary actions can cause you to hold. Setting a 1,000 unit limit means you are willing to accept up to 1,000 units of that exact currency from that exact issuer. It is not a spending allowance, price ceiling, credit score, market capitalization, or cap on what the issuer can create globally.
The limit is also not absolute in every execution path. XRPL documents three ways a balance can exceed it: buying more through trading, lowering the limit below an existing balance, or acquiring more by cashing an eligible Check. The Offers documentation explains why: an Offer is your explicit instruction to acquire the asset, so an executed Offer can go beyond the passive receiving limit.
Wallet rule: use the smallest practical limit. A huge limit does not grant the issuer access to your XRP, but it weakens a useful guard against receiving more of that issued asset through ordinary payments.
Reserves: What a Trust Line Costs Your Account
A trust line consumes shared ledger space and can count toward the account's owner reserve. At the time of publication, the official reserve page lists a 1 XRP Mainnet base reserve and a 0.2 XRP owner reserve per owned item. These values can change through validator fee voting, so wallets should read current network values instead of hardcoding them.
Usually, the holder who creates a nondefault trust line carries the owner reserve and the issuer does not. Either or both sides can count it if their settings or balance make them owners of the shared object. XRPL also has a special first two trust lines mechanism. Under qualifying account conditions, their owner reserve can be treated as zero. This is a protocol exception, not a promise that every wallet interface will display two lines as permanently free.
Rippling and the Default Ripple Setting
Rippling is the indirect balance movement used when trust line tokens pass through connected accounts. It can also exchange tokens that share a currency code but have different issuers. Issuing accounts generally need rippling enabled so holders can transfer their token to one another. Ordinary holders and liquidity providers generally should use No Ripple unless they deliberately operate a community credit or exchange path.
Default Ripple is an account setting that determines the default on new incoming trust lines. It is off by default. Changing it does not retroactively rewrite old trust lines. No Ripple is set per line, and blocking rippling through an account generally requires No Ripple on both trust lines involved in a potential path. Review actual line settings, not only the account default.
Authorization, Freeze, and Deep Freeze
Some issuers use Authorized Trust Lines. If Require Auth was enabled before the issuer began operating, users cannot hold that issuer's token until the issuer authorizes the relevant line. Authorization is per currency and, once granted on an existing line, cannot simply be switched off. It can reset if the line is automatically deleted in an otherwise default state.
| Control | Practical effect |
|---|---|
| Authorization | Issuer approval is required before the holder can hold the issued token |
| Individual Freeze | Holder generally cannot spend the token except directly back to the issuer, but can still receive it |
| Deep Freeze | Holder generally cannot spend or receive the frozen issued token |
| Global Freeze | Issuer restricts all tokens it issued across counterparties |
| No Freeze | Issuer permanently gives up specific freeze powers described by the protocol |
These features can support regulated asset operations, but they also create issuer dependency. Before holding a token, ask whether the issuer can freeze, globally freeze, claw back, charge transfer fees, or require authorization. The relevant risks are not visible from the ticker alone.
How Trust Lines Relate to the DEX and AMMs
The XRPL decentralized exchange can match order book Offers, AMM liquidity, or both in one transaction. You still need a trust line to hold an issued asset received from a trade. An executed Offer can create a required line with default settings and a zero limit if the account has enough XRP for any applicable reserve. This is why wallet users should review trust lines after trading rather than assuming every line was manually added.
XRPL AMMs pool two assets, at most one of which can be XRP. Liquidity providers receive LP tokens, which are also issued assets represented through trust lines. Token issuer controls can affect whether an asset is suitable for a pool. Pool liquidity does not authenticate an issuer, guarantee redemption, remove freeze risk, or protect a liquidity provider from price divergence and trading losses.
Deleting a Trust Line Correctly
A trust line disappears automatically when its balance is zero and both sides are otherwise in their default states. For a typical holder, deletion means selling or sending away a positive token balance, then submitting TrustSet to restore the limit and holder settings to defaults. Sending a token back to its issuer can burn it, depending on the token and transaction path.
If your balance is negative, meaning you issued value, or the counterparty still has nondefault settings, you may not be able to make the shared object disappear. You can still restore your side to defaults so it no longer counts toward your owner reserve where protocol rules permit. Never assume hiding a token in a wallet interface deleted the on ledger line. Check with an explorer or the account_lines method.
Fake Tokens and Trust Line Scams
Anyone can issue a token with a familiar looking currency code. A scam token can copy a ticker, logo, or project name while using a different issuer address. A malicious site may ask you to add a trust line as a supposed claim step, then prompt unrelated transactions or request your seed phrase. The trust line alone cannot take your XRP, but the broader signing flow can expose you to harmful Offers, Payments, account settings, or key theft.
Unsolicited tokens and worthless balances can also be marketing spam. A displayed balance does not prove liquidity. An apparent DEX price may come from a tiny, manipulated market that cannot absorb a real sale. Verify the exact issuer address through the project's official channels, inspect issuer flags and history, and test actual executable liquidity before assigning value.
Trust Line Safety Checklist
- Verify code plus issuer. Treat both fields together as the asset identity.
- Confirm the official issuer address. Use a primary project source, not a reply, advertisement, direct message, or copied search result.
- Read every signing screen. Confirm the transaction type is
TrustSet, the issuer and currency are correct, and no unexpected transaction is bundled into the flow. - Set a practical limit. Do not use an unlimited looking value merely because a site recommends it.
- Inspect issuer controls. Check authorization, freeze, deep freeze, global freeze, clawback, and transfer fee policies where relevant.
- Review reserves. Leave enough XRP for the base reserve, owner items, and transaction costs.
- Disable unintended rippling. Ordinary holders should normally keep No Ripple enabled on their lines.
- Never share keys. Creating or deleting a trust line never requires giving a website your secret numbers, seed phrase, or private key.
- Delete cleanly. Empty the balance, restore defaults, and verify the line is gone on ledger.
Frequently Asked Questions
Does XRP need a trust line?
No. XRP is native to the ledger and sits directly in the account's XRP balance. Trust lines apply to issued trust line tokens, not XRP.
Does opening a trust line mean I trust or endorse the issuer?
No. The name is technical. A trust line enables a specific ledger relationship; it does not verify identity, backing, solvency, redemption, legality, or value.
How much XRP does a trust line reserve?
Current Mainnet settings use a 1 XRP base reserve and 0.2 XRP owner reserve per item. A trust line can count as an owner item. A special waiver can apply to an account's first two trust lines under qualifying conditions. Always check current network settings.
Can I delete a trust line?
Yes, when the balance reaches zero and both sides are otherwise at their defaults, the ledger deletes it automatically. A holder normally disposes of the balance and resets the line settings with TrustSet.
Can an issuer freeze XRP through a trust line?
No. Freeze controls apply to issued tokens. Trust lines do not hold native XRP.
Do trust line limits restrict DEX purchases?
Not always. Offers can acquire more than the configured limit because they express an active intention to buy. The account still needs a trust line and enough XRP for any applicable reserve.
Sources checked
Related reading
Put Your XRP to Work
xora.finance is where to put your XRP to work and earn up to 22% instead of leaving it idle on an exchange. XORA describes this carefully as up to 22% APY value (15% native subsidised + XORA reward value). It is not guaranteed, and custody, platform, token value, and liquidity risks remain.