How to Add a Trust Line for a Token in Xaman Wallet

Understanding Trust Lines in XRP Ledger

1. A trust line is not a transfer or deposit—it is a permission grant issued by the wallet owner to allow holding a specific issued token on the XRP Ledger.

2. Without an active trust line, even if tokens are sent to your Xaman address, they will not appear in your balance or be usable.

3. Each trust line consumes 5 XRP as a reserve requirement—this amount is locked and non-refundable while the line remains open.

4. Trust lines are directional: you set them for tokens you wish to receive, not for tokens you issue.

5. The XRP Ledger enforces strict validation—any malformed trust line request fails silently unless all fields including counterparty address, currency code, and limit are correctly formatted.

Prerequisites Before Adding a Trust Line

1. You must hold at least 20 XRP in your Xaman wallet to cover base reserve, trust line reserve, and transaction fees.

2. Your wallet must be fully synced with the XRP Ledger—check the sync status icon in the top-right corner of the Xaman interface.

3. You need the exact issuer address (a valid XRP Ledger address starting with 'r') and the three-letter currency code (e.g., 'USD', 'EUR', 'BRL').

4. You must verify the authenticity of the issuer—cross-check against official project documentation or verified explorer entries on XRPL.org or Bithomp.

5. Xaman requires biometric or PIN confirmation before submitting any trust line operation—ensure your device security settings permit this.

Navigating the Trust Line Interface in Xaman

1. Tap the '+' icon in the asset list view, then select “Add Issued Token” from the dropdown menu.

2. Enter the currency code manually—Xaman does not auto-suggest codes; case sensitivity matters ('usd' ≠ 'USD').

3. Paste the full issuer address into the designated field—truncation or whitespace will cause rejection.

4. Input a numeric limit value in the “Limit” field—this defines the maximum amount of that token you’re willing to hold; zero means no limit.

5. Confirm the preview screen showing total XRP reserve impact and final issuer-currency pairing before tapping “Submit”.

Common Errors and Their Immediate Fixes

1. “Invalid issuer address”: Re-copy from a trusted source—verify it begins with 'r' and contains exactly 33–34 alphanumeric characters.

2. “Insufficient XRP balance”: Deposit additional XRP—remember the 5 XRP reserve per trust line plus 0.00001 XRP transaction cost.

3. “Currency code too long”: Only three uppercase Latin letters are permitted—no hyphens, numbers, or spaces.

4. “Ledger rejected: malformed transaction”: Disable any active browser extension that injects scripts—Xaman mobile does not support third-party script interference.

5. “Timeout during submission”: Switch from cellular to stable Wi-Fi—Xaman relies on direct WebSocket connections to rippled nodes.

Frequently Asked Questions

Q1. Can I delete a trust line after creating it?Yes. Open the token’s detail page in Xaman, tap “Remove Trust Line”, confirm with biometrics, and pay another 0.00001 XRP fee. The 5 XRP reserve is permanently forfeited.

Q2. Does adding a trust line expose my private key to the issuer?No. Trust line setup is a public ledger transaction signed exclusively by your wallet’s secret key—no data leaves your device.

Q3. Why does Xaman show “Pending” for over two minutes after submission?This indicates network congestion or misconfigured node connection—manually switch to a different rippled server under Settings > Network > Custom Node.

Q4. Can I set different limits for the same currency issued by multiple addresses?Yes. Each issuer is treated as a distinct counterparty—the XRP Ledger allows separate trust lines for identical currency codes from different issuers.