Skip to main content
Schema: hyperevm.core Table: fact_transactions Type: Table

What

This table contains comprehensive transaction-level data for EVM blockchains. Each row represents a single transaction with its execution details, gas consumption, and value transfers. This is a high-level table for analyzing on-chain activity, user behavior, and protocol interactions.

Key Use Cases

  • Tracking wallet activity and transaction patterns
  • Analyzing gas fee trends and optimization opportunities
  • Monitoring smart contract interactions and usage
  • Calculating transaction volumes and network revenue
  • Detecting MEV, arbitrage, and trading patterns

Important Relationships

  • Join with fact_blocks: Use block_number for block-level context
  • Join with fact_traces: Use tx_hash for internal transactions
  • Join with fact_event_logs: Use tx_hash for emitted events
  • Join with ez_decoded_event_logs: Use tx_hash for human-readable events
  • Join with dim_contracts: Use to_address for contract metadata

Commonly-used Fields

  • tx_hash: Unique transaction identifier
  • from_address: Transaction sender
  • to_address: Transaction recipient
  • value: Native token amount transferred
  • gas_used: Actual gas consumed
  • gas_price: Price per gas unit
  • tx_fee: Total transaction fee in native tokens
  • block_timestamp: When transaction was included

Sample queries

-- Daily transaction statistics by type
SELECT
    DATE_TRUNC('day', block_timestamp) AS day,
    tx_type,
    COUNT(*) AS tx_count,
    COUNT(DISTINCT from_address) AS unique_senders,
    SUM(tx_fee) AS total_fees_native,
    AVG(gas_used) AS avg_gas_used,
    PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY gas_price) AS median_gas_price
FROM hyperevm.core.fact_transactions
WHERE block_timestamp >= CURRENT_DATE - 30
GROUP BY 1, 2
ORDER BY 1 DESC, 3 DESC;

-- High-value native token transfers
SELECT
    tx_hash,
    block_timestamp,
    from_address,
    to_address,
    value,
    tx_fee,
    gas_used * gas_price / 1e9 AS gas_cost_gwei
FROM hyperevm.core.fact_transactions
WHERE value > 0
    AND tx_succeeded
    AND block_timestamp >= CURRENT_DATE - 7
ORDER BY value DESC
LIMIT 100;

-- Smart contract interaction patterns
SELECT
    to_address,
    origin_function_signature,
    COUNT(*) AS interaction_count,
    COUNT(DISTINCT from_address) AS unique_users,
    SUM(tx_fee) AS total_fees_paid
FROM hyperevm.core.fact_transactions
WHERE to_address IN (SELECT address FROM dim_contracts)
    AND block_timestamp >= CURRENT_DATE - 1
GROUP BY 1, 2
ORDER BY 3 DESC
LIMIT 50;

Columns

Column NameData TypeDescription
BLOCK_NUMBERNUMBERSequential counter representing the position of a block in the blockchain since genesis (block 0).
BLOCK_TIMESTAMPTIMESTAMP_NTZUTC timestamp when the block was produced by validators/miners.
TX_HASHTEXTUnique 66-character identifier for the transaction.
FROM_ADDRESSTEXTThe externally-owned account (EOA) or contract address that initiated the transaction.
TO_ADDRESSTEXTThe destination address for the transaction - either an EOA or contract address.
ORIGIN_FUNCTION_SIGNATURETEXTFunction signature (first 4 bytes) of the called method.
VALUEFLOATAmount of native tokens transferred, in token units (not Wei).
VALUE_PRECISE_RAWTEXTString representation of numeric values preserving exact precision without any adjustments.
VALUE_PRECISETEXTString representation of numeric values adjusted for human readability while maintaining precision.
TX_FEEFLOATTotal fee paid for transaction execution in native token units.
TX_FEE_PRECISETEXTExact transaction fee as string to prevent floating-point precision loss.
TX_SUCCEEDEDBOOLEANBoolean indicator of transaction success.
TX_TYPENUMBERTransaction envelope type (EIP-2718).
NONCENUMBERSequential counter of transactions sent by the from_address.
TX_POSITIONNUMBERZero-indexed position of transaction within its block.
INPUT_DATATEXTEncoded data sent with the transaction, containing function calls and parameters.
GAS_PRICEFLOATPrice per gas unit in Gwei (1 Gwei = 1e-9 native token).
EFFECTIVE_GAS_PRICEFLOATActual price paid per gas unit for EIP-1559 transactions, in Gwei.
GAS_USEDNUMBERActual gas units consumed by transaction execution.
GAS_LIMITNUMBERMaximum gas units the sender is willing to consume for this transaction.
CUMULATIVE_GAS_USEDNUMBERRunning total of gas consumed by all transactions up to and including this transaction within the block.
MAX_FEE_PER_GASFLOATMaximum total fee per gas unit sender is willing to pay (EIP-1559), in Gwei.
MAX_PRIORITY_FEE_PER_GASFLOATMaximum tip per gas unit for validator (EIP-1559), in Gwei.
Y_PARITYNUMBERY coordinate parity for signature recovery (EIP-2098).
ACCESS_LISTVARIANTArray of addresses and storage keys for optimized gas costs (EIP-2930).
RTEXTR component of ECDSA signature (32 bytes).
STEXTS component of ECDSA signature (32 bytes).
VNUMBERRecovery identifier for ECDSA signature.
FACT_TRANSACTIONS_IDTEXTPrimary key - unique identifier for each row ensuring data integrity.
INSERTED_TIMESTAMPTIMESTAMP_NTZUTC timestamp when the record was first added to the Flipside database.
MODIFIED_TIMESTAMPTIMESTAMP_NTZUTC timestamp of the most recent update to this record.