Unified Event

Stellar-specific event type triggered when a smart contract emits an event on the Stellar network.

The unified_event is a Stellar-specific event type for smart contract (Soroban) events emitted on the Stellar network.

This event is triggered when:

A customer has a rule using the event_type as a variable type, with the variable set to event.
A Soroban smart contract emits an event on the Stellar blockchain.

Supported Protocols

stellar/mainnet
stellar/testnet

Schema

{
  "id": "string",
  "protocol": "string",
  "network": "string",
  "chain_id": "string",
  "event_type": "unified_event",
  "data": {
    "block_number": "integer",
    "block_timestamp": "string",
    "contract_id": "string",
    "event_id": "string",
    "topics": "array",
    "tx_hash": "string",
    "type": "string",
    "value": "object"
  }
}

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_event` for this event type.

`data` Object

Field	Type	Description
`block_number`	integer	The ledger sequence number where the event was emitted.
`block_timestamp`	string	The ISO 8601 timestamp of the ledger.
`contract_id`	string	The Stellar address of the Soroban smart contract that emitted the event.
`event_id`	string	A unique identifier for the event within the ledger.
`topics`	array	An array of topic objects describing the event. Topics contain typed values such as `symbol`, `address`, or `string`.
`tx_hash`	string	The hash of the transaction that triggered the event.
`type`	string	The event type on the Stellar network (e.g., `contract`).
`value`	object	The event value, represented as a typed object (e.g., `{ "i128": "20103" }`).

Example

{
    "id": "416e18e5-de52-5a29-8fe8-17ab9ebcccf5",
    "protocol": "stellar",
    "network": "mainnet",
    "chain_id": "stellar:pubnet",
    "event_type": "unified_event",
    "data": {
        "block_number": 61721036,
        "block_timestamp": "2026-03-19T09:08:17Z",
        "contract_id": "CDTKPWPLOURQA2SGTKTUQOWRCBZEORB4BWBOMJ3D3ZTQQSGE5F6JBQLV",
        "event_id": "0265089831095926784-0000000004",
        "topics": [
            {
                "symbol": "transfer"
            },
            {
                "address": "GCROB2O5QFBJ7DZZ6FMJNMGVCF7TGGJMUMY56G6LMTNTQ3FLCJ6XBDTR"
            },
            {
                "address": "LB3SUMIUGHUWZXTXZSWXJUI6ARIST3OVAIGRBPLY6VPK4TDGKPFE4BIP"
            },
            {
                "string": "EURC:GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2"
            }
        ],
        "tx_hash": "7f61b60f1fb1424f770fada07a9a259c605830cee2bfe1be05c1458643e6eca4",
        "type": "contract",
        "value": {
            "i128": "20103"
        }
    }
}

👋 Need Help?

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

Updated about 2 hours ago