{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Developers","type":"markdown"},"seo":{"title":"XRP Ledger Trust Lines"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"xrp-ledger-trust-lines","__idx":0},"children":["XRP Ledger Trust Lines"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A trust line is an XRP Ledger account-level setting that authorizes the"," ","account to hold a specific Trust Line Asset (also called an Issued Token, and"," ","historically, an IOU) from a given issuer. Without a trust line, an account"," ","cannot receive that asset."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fordefi exposes a dedicated transaction type for creating a trust line, built"," ","on the XRP Ledger's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TrustSet"]}," transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"trust-line-limits","__idx":1},"children":["Trust line limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The XRP Ledger's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TrustSet"]}," transaction accepts a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LimitAmount"]}," parameter that"," ","caps the maximum amount of the asset the account is willing to hold. Fordefi"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["always creates trust lines with the protocol-maximum limit"]},", which makes"," ","them effectively unlimited."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"no-rippling-by-default","__idx":2},"children":["No rippling by default"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every account Fordefi creates leaves the account-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DefaultRipple"]}," setting"," ","off (the protocol default), so every trust line the account opens"," ","automatically has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NoRipple"]}," set. This is configured once, at account"," ","creation. There is no per-trust-line setting to manage, and no option to"," ","change this behavior."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-trust-line","__idx":3},"children":["Create a trust line"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Following is an illustrative example of the body of a"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.fordefi.com/api/openapi/transactions/create_transaction_api_v1_transactions_post"},"children":["Create Transaction"]}," ","request for creating a trust line."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"signer_type\": \"api_signer\",\n  \"type\": \"ripple_transaction\",\n  \"details\": {\n    \"type\": \"ripple_create_trustline\",\n    \"asset_identifier\": {\n      \"type\": \"ripple\",\n      \"details\": {\n        \"type\": \"trust_line_asset\",\n        \"currency\": \"USD\",\n        \"issuer\": {\n          \"chain\": \"ripple_mainnet\",\n          \"base58_repr\": \"rEXAMPLE1111111111111111111111111\"\n        }\n      }\n    }\n  },\n  \"note\": \"Establish a trust line for USD\",\n  \"vault_id\": \"your_xrp_vault_id\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the trust line is established, the vault can receive that asset directly"," ","using standard transfers. No claimable balance fallback is needed."]}]},"headings":[{"value":"XRP Ledger Trust Lines","id":"xrp-ledger-trust-lines","depth":1},{"value":"Trust line limits","id":"trust-line-limits","depth":2},{"value":"No rippling by default","id":"no-rippling-by-default","depth":2},{"value":"Create a trust line","id":"create-a-trust-line","depth":2}],"frontmatter":{"seo":{"title":"XRP Ledger Trust Lines"}},"lastModified":"2026-08-16T10:49:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/transaction-types/xrp-trustlines","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}