Unified Event

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

This event is triggered when:

Supported Protocols

Schema

JSON

{
  "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

Stellar

{
    "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"
        }
    }
}