diff --git a/models/curated_package/defi/bridge/defi__ez_bridge_activity.yml b/models/curated_package/defi/bridge/defi__ez_bridge_activity.yml index bff19c44..74094b66 100644 --- a/models/curated_package/defi/bridge/defi__ez_bridge_activity.yml +++ b/models/curated_package/defi/bridge/defi__ez_bridge_activity.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/dex/defi__ez_dex_swaps.yml b/models/curated_package/defi/dex/defi__ez_dex_swaps.yml index 6ca68d14..8c137ea1 100644 --- a/models/curated_package/defi/dex/defi__ez_dex_swaps.yml +++ b/models/curated_package/defi/dex/defi__ez_dex_swaps.yml @@ -13,7 +13,7 @@ models: - name: CONTRACT_ADDRESS description: '{{ doc("ez_dex_swaps_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: AMOUNT_IN description: '{{ doc("ez_dex_swaps_amount_in") }}' - name: AMOUNT_OUT @@ -45,7 +45,7 @@ models: - name: PROTOCOL_VERSION description: '{{ doc("ez_dex_swaps_protocol_version") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_borrows.yml b/models/curated_package/defi/lending/defi__ez_lending_borrows.yml index 110d36db..0983c8bf 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_borrows.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_borrows.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_deposits.yml b/models/curated_package/defi/lending/defi__ez_lending_deposits.yml index 6b6f2463..67243aed 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_deposits.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_deposits.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_flashloans.yml b/models/curated_package/defi/lending/defi__ez_lending_flashloans.yml index 86b6fb57..117a83e8 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_flashloans.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_flashloans.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_liquidations.yml b/models/curated_package/defi/lending/defi__ez_lending_liquidations.yml index 173d0f6e..271471d4 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_liquidations.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_liquidations.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_repayments.yml b/models/curated_package/defi/lending/defi__ez_lending_repayments.yml index 08cf9e9a..02ec4e8d 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_repayments.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_repayments.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/lending/defi__ez_lending_withdraws.yml b/models/curated_package/defi/lending/defi__ez_lending_withdraws.yml index 7d87587c..32a50118 100644 --- a/models/curated_package/defi/lending/defi__ez_lending_withdraws.yml +++ b/models/curated_package/defi/lending/defi__ez_lending_withdraws.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_deposits.yml b/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_deposits.yml index bb147219..d799cef9 100644 --- a/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_deposits.yml +++ b/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_deposits.yml @@ -17,11 +17,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: STAKER description: '{{ doc("ez_liquid_staking_staker") }}' - name: PLATFORM diff --git a/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_withdrawals.yml b/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_withdrawals.yml index 0e2b1656..66911745 100644 --- a/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_withdrawals.yml +++ b/models/curated_package/defi/liquid_staking/defi__ez_liquid_staking_withdrawals.yml @@ -17,11 +17,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: STAKER description: '{{ doc("ez_liquid_staking_staker") }}' - name: PLATFORM diff --git a/models/curated_package/nft/nft__ez_nft_sales.yml b/models/curated_package/nft/nft__ez_nft_sales.yml index d8a416ba..6f7f4b2b 100644 --- a/models/curated_package/nft/nft__ez_nft_sales.yml +++ b/models/curated_package/nft/nft__ez_nft_sales.yml @@ -11,7 +11,7 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: EVENT_TYPE description: '{{ doc("ez_nft_sales_event_type") }}' - name: PLATFORM_ADDRESS diff --git a/models/curated_package/protocols/vertex/gold/vertex__ez_clearing_house_events.yml b/models/curated_package/protocols/vertex/gold/vertex__ez_clearing_house_events.yml index 876c2cb1..75df197c 100644 --- a/models/curated_package/protocols/vertex/gold/vertex__ez_clearing_house_events.yml +++ b/models/curated_package/protocols/vertex/gold/vertex__ez_clearing_house_events.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/protocols/vertex/gold/vertex__ez_edge_trades.yml b/models/curated_package/protocols/vertex/gold/vertex__ez_edge_trades.yml index 72f9802a..53635a62 100644 --- a/models/curated_package/protocols/vertex/gold/vertex__ez_edge_trades.yml +++ b/models/curated_package/protocols/vertex/gold/vertex__ez_edge_trades.yml @@ -11,9 +11,9 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: EDGE_EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: USER_EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: EDGE_DIGEST description: '{{ doc("vertex_digest") }}' - name: USER_DIGEST diff --git a/models/curated_package/protocols/vertex/gold/vertex__ez_liquidations.yml b/models/curated_package/protocols/vertex/gold/vertex__ez_liquidations.yml index 3b2ee805..0c737bf0 100644 --- a/models/curated_package/protocols/vertex/gold/vertex__ez_liquidations.yml +++ b/models/curated_package/protocols/vertex/gold/vertex__ez_liquidations.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/protocols/vertex/gold/vertex__ez_perp_trades.yml b/models/curated_package/protocols/vertex/gold/vertex__ez_perp_trades.yml index 578ddcc2..ecd92c94 100644 --- a/models/curated_package/protocols/vertex/gold/vertex__ez_perp_trades.yml +++ b/models/curated_package/protocols/vertex/gold/vertex__ez_perp_trades.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/curated_package/protocols/vertex/gold/vertex__ez_spot_trades.yml b/models/curated_package/protocols/vertex/gold/vertex__ez_spot_trades.yml index c1760cc9..94ad62da 100644 --- a/models/curated_package/protocols/vertex/gold/vertex__ez_spot_trades.yml +++ b/models/curated_package/protocols/vertex/gold/vertex__ez_spot_trades.yml @@ -11,11 +11,11 @@ models: - name: TX_HASH description: '{{ doc("general_tx_hash") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: ORIGIN_FUNCTION_SIGNATURE description: '{{ doc("general_origin_function_signature") }}' - name: ORIGIN_FROM_ADDRESS diff --git a/models/decoder_package/decoded_logs/gold/core__ez_decoded_event_logs.yml b/models/decoder_package/decoded_logs/gold/core__ez_decoded_event_logs.yml index 11a53d7d..4849263d 100644 --- a/models/decoder_package/decoded_logs/gold/core__ez_decoded_event_logs.yml +++ b/models/decoder_package/decoded_logs/gold/core__ez_decoded_event_logs.yml @@ -13,9 +13,9 @@ models: - name: TX_POSITION description: '{{ doc("general_tx_position") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: TOPICS description: '{{ doc("fact_event_logs_topics") }}' - name: TOPIC_0 @@ -39,7 +39,7 @@ models: - name: TX_SUCCEEDED description: '{{ doc("general_tx_succeeded") }}' - name: EVENT_NAME - description: '{{ doc("ez_decoded_event_logs_event_name") }}' + description: '{{ doc("general_event_name") }}' - name: FULL_DECODED_LOG description: '{{ doc("ez_decoded_event_logs_full_decoded_log") }}' - name: DECODED_LOG diff --git a/models/doc_descriptions/general.md b/models/doc_descriptions/general.md index 91a25da8..deb64ab0 100644 --- a/models/doc_descriptions/general.md +++ b/models/doc_descriptions/general.md @@ -335,4 +335,65 @@ Boolean indicator of transaction success. - TRUE: Transaction executed successfully - FALSE: Transaction failed/reverted +{% enddocs %} + +{% docs general_event_index %} + +Zero-based sequential position of the event within a transaction's execution. + +**Key Facts**: +- Starts at 0 for first event +- Increments across all contracts in transaction +- Preserves execution order +- Essential for deterministic event ordering + +**Usage Example**: +```sql +-- Trace event execution flow +SELECT + event_index, + contract_address, + topic_0, + SUBSTRING(data, 1, 10) AS data_preview +FROM .core.fact_event_logs +WHERE tx_hash = '0xabc...' +ORDER BY event_index; +``` + +{% enddocs %} + +{% docs general_contract_address %} + +Smart contract address that emitted this event or received the transaction. + +**Key Points**: +- Always the immediate event emitter for logs +- May differ from transaction to_address +- Lowercase normalized format +- Never NULL for valid events + +{% enddocs %} + +{% docs general_event_name %} + +The event name as defined in the contract's ABI. + +**Format**: PascalCase event identifier +**Examples**: +- `Transfer` - Token transfers +- `Swap` - DEX trades +- `OwnershipTransferred` - Admin changes +- `Approval` - Token approvals + +**Usage Pattern**: + +```sql +-- Find all event types for a contract +SELECT DISTINCT event_name, COUNT(*) as occurrences +FROM ez_decoded_event_logs +WHERE contract_address = LOWER('0x...') +GROUP BY 1 +ORDER BY 2 DESC; +``` + {% enddocs %} \ No newline at end of file diff --git a/models/main_package/core/gold/core__ez_token_transfers.yml b/models/main_package/core/gold/core__ez_token_transfers.yml index 88d10bc7..3dd92fea 100644 --- a/models/main_package/core/gold/core__ez_token_transfers.yml +++ b/models/main_package/core/gold/core__ez_token_transfers.yml @@ -13,7 +13,7 @@ models: - name: TX_POSITION description: '{{ doc("general_tx_position") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: FROM_ADDRESS description: '{{ doc("ez_token_transfers_from_address") }}' - name: TO_ADDRESS diff --git a/models/main_package/core/gold/core__fact_event_logs.yml b/models/main_package/core/gold/core__fact_event_logs.yml index 70c55723..a49dea18 100644 --- a/models/main_package/core/gold/core__fact_event_logs.yml +++ b/models/main_package/core/gold/core__fact_event_logs.yml @@ -13,9 +13,9 @@ models: - name: TX_POSITION description: '{{ doc("general_tx_position") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: CONTRACT_ADDRESS - description: '{{ doc("fact_event_logs_contract_address") }}' + description: '{{ doc("general_contract_address") }}' - name: TOPICS description: '{{ doc("fact_event_logs_topics") }}' - name: TOPIC_0 diff --git a/models/main_package/core/nft/nft__ez_nft_transfers.yml b/models/main_package/core/nft/nft__ez_nft_transfers.yml index 9f117c56..5c20c491 100644 --- a/models/main_package/core/nft/nft__ez_nft_transfers.yml +++ b/models/main_package/core/nft/nft__ez_nft_transfers.yml @@ -13,7 +13,7 @@ models: - name: TX_POSITION description: '{{ doc("general_tx_position") }}' - name: EVENT_INDEX - description: '{{ doc("fact_event_logs_event_index") }}' + description: '{{ doc("general_event_index") }}' - name: INTRA_EVENT_INDEX description: '{{ doc("ez_nft_transfers_intra_event_index") }}' - name: TOKEN_TRANSFER_TYPE