Unified Trustline

Stellar-specific event type triggered when a trustline is created, updated, or removed on the Stellar network.

The unified_trustline is a Stellar-specific event type that tracks trustline changes on the Stellar network. A trustline is an explicit opt-in by a Stellar account to hold a particular asset issued by another account.

This event is triggered when:

A customer has a rule using the event_type as a variable type, with the variable set to trustline.
A trustline is created, updated, or removed on the Stellar blockchain.

Supported Protocols

stellar/mainnet
stellar/testnet

Schema

{
  "id": "string",
  "protocol": "string",
  "network": "string",
  "chain_id": "string",
  "event_type": "unified_trustline",
  "data": {
    "address": "string",
    "asset": "object",
    "balance": "integer",
    "flags": "integer",
    "limit": "string"
  }
}

The table below shows the schema breakdown:

Field	Type	Description
`id`	string	Unique identifier for the event message.
`protocol`	string	The blockchain protocol (e.g., `stellar`).
`network`	string	The network name (e.g., `mainnet`, `testnet`).
`chain_id`	string	The CAIP-2 chain identifier (e.g., `stellar:pubnet`).
`event_type`	string	Always `unified_trustline` for this event type.

`data` Object

Field	Type	Description
`address`	string	The Stellar account address that holds the trustline.
`asset`	object	The asset the trustline is for. Contains a key indicating the asset type (e.g., `credit_alphanum12`) with nested `asset_code` and `issuer` fields.
`balance`	integer	The current balance of the asset held by the account, represented in stroops (1 stroop = 0.0000001 XLM).
`flags`	integer	Trustline flags set by the asset issuer. See the Stellar trustline flags documentation for possible values.
`limit`	string	The maximum amount of the asset the account is willing to hold.

Example

{
    "id": "a1d36d63-0ccf-5656-9db7-7da7c9d5904a",
    "protocol": "stellar",
    "network": "mainnet",
    "chain_id": "stellar:pubnet",
    "event_type": "unified_trustline",
    "data": {
        "address": "GCROB2O5QFBJ7DZZ6FMJNMGVCF7TGGJMUMY56G6LMTNTQ3FLCJ6XBDTR",
        "asset": {
            "credit_alphanum12": {
                "asset_code": "R3FL3cT",
                "issuer": "GDKS7XTNEVCPGVUT2ZPPOU5CHHF3NH6NX7P3ROSFSDAO6NQDS3C74Y6C"
            }
        },
        "balance": 1777516540065984359,
        "flags": 1,
        "limit": "9223372036854775807"
    }
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.

Updated about 2 hours ago