hyperevm.core Table: fact_event_logs Type: Table
What
This table contains raw event logs emitted by smart contracts during transaction execution. Each row represents a single event with its topics and data. Events are the primary mechanism for smart contracts to communicate state changes and must be explicitly emitted in contract code.Key Use Cases
- Tracking raw blockchain events before decoding
- Filtering events by signature (topic_0) for specific event types
- Analyzing contract activity patterns and event frequencies
- Building custom event decoders for unsupported contracts
- Monitoring specific addresses via indexed parameters
Important Relationships
- Join with ez_decoded_event_logs: Use
tx_hashandevent_indexfor simplified decoded data - Join with fact_transactions: Use
tx_hashfor transaction context - Join with dim_contracts: Use
contract_addressfor contract metadata
Commonly-used Fields
topic_0: Event signature hash for filtering event typescontract_address: Smart contract that emitted the eventtopics: Array of indexed parameters (max 4)data: Hex-encoded non-indexed parametersevent_index: Sequential position within transactiontx_hash: Transaction containing this event
Sample queries
Columns
| Column Name | Data Type | Description |
|---|---|---|
| BLOCK_NUMBER | NUMBER | Sequential counter representing the position of a block in the blockchain since genesis (block 0). |
| BLOCK_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp when the block was produced by validators/miners. |
| TX_HASH | TEXT | Unique 66-character identifier for the transaction. |
| TX_POSITION | NUMBER | Zero-indexed position of transaction within its block. |
| EVENT_INDEX | NUMBER | Zero-based sequential position of the event within a transaction’s execution. |
| CONTRACT_ADDRESS | TEXT | Smart contract address that emitted this event or received the transaction. |
| TOPICS | VARIANT | Array containing all indexed parameters of the event. |
| TOPIC_0 | TEXT | Event signature hash - keccak256 of the event declaration. |
| TOPIC_1 | TEXT | First indexed parameter of the event (if exists). |
| TOPIC_2 | TEXT | Second indexed parameter of the event (if exists). |
| TOPIC_3 | TEXT | Third indexed parameter of the event (if exists). |
| DATA | TEXT | Hex-encoded non-indexed event parameters. |
| EVENT_REMOVED | BOOLEAN | Boolean flag indicating if the event was removed due to chain reorganization. |
| ORIGIN_FROM_ADDRESS | TEXT | The externally-owned account (EOA) or contract address that initiated the transaction. |
| ORIGIN_TO_ADDRESS | TEXT | The destination address for the transaction - either an EOA or contract address. |
| ORIGIN_FUNCTION_SIGNATURE | TEXT | Function signature (first 4 bytes) of the called method. |
| TX_SUCCEEDED | BOOLEAN | Boolean indicator of transaction success. |
| FACT_EVENT_LOGS_ID | TEXT | Primary key - unique identifier for each row ensuring data integrity. |
| INSERTED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp when the record was first added to the Flipside database. |
| MODIFIED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp of the most recent update to this record. |