Skip to content

Stellar Trustlines

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.

Fordefi exposes a dedicated transaction type, stellar_change_trust, for creating a trustline.

Trustline limits

Stellar's ChangeTrust operation accepts a limit parameter that caps the maximum amount of the asset the account is willing to hold. Fordefi always creates trustlines with the protocol-maximum limit, which makes them effectively unlimited.

Create a trustline

Following is an example of the body of a Create Transaction request for creating a trustline.

{
  "signer_type": "api_signer",
  "type": "stellar_transaction",
  "details": {
    "type": "stellar_change_trust",
    "asset_identifier": {
      "type": "stellar",
      "details": {
        "type": "classic_asset",
        "code": "USDC",
        "issuer": {
          "chain": "stellar_mainnet",
          "base32_repr": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
        },
        "chain": "stellar_mainnet"
      }
    }
  },
  "note": "Establish a trustline for USDC",
  "vault_id": "your_stellar_vault_id"
}

Once the trustline is established, the vault can receive that asset directly using standard transfers — no claimable balance fallback is needed.

Stellar Claimable Balances