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 with the
addressvariable type, and the variable contains the address (data.topicJson[].address) as its value. - A Soroban smart contract emits an event on the Stellar blockchain.
Supported Protocols
stellar/mainnetstellar/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"
}
}| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the event message. |
protocol | string | The blockchain protocol (stellar). |
network | string | The network name (mainnet or 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
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" }). |
This schema applies to the UNIFIED_V1 and UNIFIED_V1_RAW templates. ALL_DATA returns Stellar's native Soroban event payload unmodified, with its own fields.
Example
Stellar
This example shows a Soroban `transfer` event: a contract-level EURC transfer between two Stellar accounts. Stellar calls a block a ledger, so block_number maps to ledger and block_timestamp maps to ledgerClosedAt. The raw topicJson array is renamed to topics and valueJson to value in the unified schema, keeping the same typed-object shape (e.g. symbol, address, string, i128).
{
"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 10 days ago