{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Developers","type":"markdown"},"seo":{"title":"Stellar Trustlines","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"stellar-trustlines","__idx":0},"children":["Stellar Trustlines"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A trustline is a Stellar account-level setting that authorizes the account to hold a specific classic asset. Without a trustline, an account cannot receive that asset."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fordefi exposes a dedicated transaction type, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stellar_change_trust"]},", for creating a trustline."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"_","__idx":1},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Trustline limits"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stellar's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ChangeTrust"]}," operation accepts a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," parameter that caps the maximum amount of the asset the account is willing to hold. Fordefi ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["always creates trustlines with the protocol-maximum limit"]},", which makes them effectively unlimited."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"_-1","__idx":2},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a trustline"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Following is an 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 trustline."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"signer_type\": \"api_signer\",\n  \"type\": \"stellar_transaction\",\n  \"details\": {\n    \"type\": \"stellar_change_trust\",\n    \"asset_identifier\": {\n      \"type\": \"stellar\",\n      \"details\": {\n        \"type\": \"classic_asset\",\n        \"code\": \"USDC\",\n        \"issuer\": {\n          \"chain\": \"stellar_mainnet\",\n          \"base32_repr\": \"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN\"\n        },\n        \"chain\": \"stellar_mainnet\"\n      }\n    }\n  },\n  \"note\": \"Establish a trustline for USDC\",\n  \"vault_id\": \"your_stellar_vault_id\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the trustline is established, the vault can receive that asset directly using standard transfers — no claimable balance fallback is needed."]}]},"headings":[{"value":"Stellar Trustlines","id":"stellar-trustlines","depth":1},{"value":"","id":"_","depth":2},{"value":"","id":"_-1","depth":2}],"frontmatter":{"seo":{"title":"Stellar Trustlines"}},"lastModified":"2026-05-03T10:41:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/transaction-types/stellar-trustlines","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}