From 767de2d7c700b82a75a23cdb4497f4fdbff4f29d Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Wed, 13 Nov 2024 18:14:44 +0000 Subject: [PATCH] Update schema --- SCHEMA.all.md | 3683 +++++++++++++++++++++++++++++++- schema/beacon_api_.md | 70 +- schema/canonical_beacon_.md | 72 +- schema/canonical_execution_.md | 56 +- schema/libp2p_.md | 18 +- schema/mempool_.md | 6 +- schema/mev_relay_.md | 12 +- 7 files changed, 3765 insertions(+), 152 deletions(-) diff --git a/SCHEMA.all.md b/SCHEMA.all.md index d690e9a..6840694 100644 --- a/SCHEMA.all.md +++ b/SCHEMA.all.md @@ -56,9 +56,9 @@ Contains beacon API /eth/v1/beacon/states/{state_id}/committees data from each s ### Availability Data is partitioned **hourly** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-09-05` to `2024-11-11` -- **holesky**: `2023-12-25` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-09-05` to `2024-11-12` +- **holesky**: `2023-12-25` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -154,9 +154,9 @@ Contains beacon API eventstream "attestation" data from each sentry client attac ### Availability Data is partitioned **hourly** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-06-05` to `2024-11-11` -- **holesky**: `2023-09-29` to `2024-11-11` -- **sepolia**: `2023-09-01` to `2024-11-11` +- **mainnet**: `2023-06-05` to `2024-11-12` +- **holesky**: `2023-09-29` to `2024-11-12` +- **sepolia**: `2023-09-01` to `2024-11-12` ### Examples @@ -257,9 +257,9 @@ Contains beacon API eventstream "blob_sidecar" data from each sentry client atta ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-03-13` to `2024-11-11` -- **holesky**: `2024-02-07` to `2024-11-11` -- **sepolia**: `2024-01-30` to `2024-11-11` +- **mainnet**: `2024-03-13` to `2024-11-12` +- **holesky**: `2024-02-07` to `2024-11-12` +- **sepolia**: `2024-01-30` to `2024-11-12` ### Examples @@ -358,9 +358,9 @@ Contains beacon API eventstream "block" data from each sentry client attached to ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-02-28` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-02-28` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -457,9 +457,9 @@ Contains beacon API eventstream "chain reorg" data from each sentry client attac ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-03-01` to `2024-11-11` -- **holesky**: `2024-02-05` to `2024-11-11` -- **sepolia**: `2024-05-23` to `2024-11-11` +- **mainnet**: `2023-03-01` to `2024-11-12` +- **holesky**: `2024-02-05` to `2024-11-12` +- **sepolia**: `2024-05-23` to `2024-11-12` ### Examples @@ -560,9 +560,9 @@ Contains beacon API eventstream "contribution and proof" data from each sentry c ### Availability Data is partitioned **daily** on **contribution_slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-31` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-08-31` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -664,9 +664,9 @@ Contains beacon API eventstream "finalized checkpoint" data from each sentry cli ### Availability Data is partitioned **daily** on **epoch_start_date_time** for the following networks: -- **mainnet**: `2023-04-10` to `2024-11-11` -- **holesky**: `2023-03-26` to `2024-11-11` -- **sepolia**: `2023-03-26` to `2024-11-11` +- **mainnet**: `2023-04-10` to `2024-11-12` +- **holesky**: `2023-03-26` to `2024-11-12` +- **sepolia**: `2023-03-26` to `2024-11-12` ### Examples @@ -761,9 +761,9 @@ Contains beacon API eventstream "head" data from each sentry client attached to ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-30` to `2024-11-11` -- **holesky**: `2023-12-05` to `2024-11-11` -- **sepolia**: `2023-12-05` to `2024-11-11` +- **mainnet**: `2023-08-30` to `2024-11-12` +- **holesky**: `2023-12-05` to `2024-11-12` +- **sepolia**: `2023-12-05` to `2024-11-12` ### Examples @@ -863,8 +863,8 @@ Contains beacon API eventstream "voluntary exit" data from each sentry client at ### Availability Data is partitioned **daily** on **wallclock_epoch_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-10-01` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-10-01` to `2024-11-12` - **sepolia**: `2023-10-01` to `null` ### Examples @@ -963,9 +963,9 @@ Contains beacon API validator attestation data from each sentry client attached ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-31` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-08-31` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -1070,9 +1070,9 @@ Contains beacon API /eth/v2/beacon/blocks/{block_id} data from each sentry clien ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-11-14` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-11-14` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -1188,9 +1188,9 @@ Contains a proposer duty from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-04-03` to `2024-11-11` -- **holesky**: `2024-04-03` to `2024-11-11` -- **sepolia**: `2024-04-03` to `2024-11-11` +- **mainnet**: `2024-04-03` to `2024-11-12` +- **holesky**: `2024-04-03` to `2024-11-12` +- **sepolia**: `2024-04-03` to `2024-11-12` ### Examples @@ -1302,6 +1302,3619 @@ Each row represents a transaction that was seen in the mempool by a sentry clien ### Availability Data is partitioned **daily** on **event_date_time** for the following networks: +- **mainnet**: `2023-07-22` to `2024-11-12` +- **holesky**: `2024-01-08` to `2024-11-12` +- **sepolia**: `2024-01-08` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/mempool_transaction/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/mempool_transaction/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.mempool_transaction FINAL + WHERE + event_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.mempool_transaction FINAL + WHERE + event_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **event_date_time** | `DateTime64(3)` | *The time when the sentry saw the transaction in the mempool* | +| **hash** | `FixedString(66)` | *The hash of the transaction* | +| **from** | `FixedString(42)` | *The address of the account that sent the transaction* | +| **to** | `Nullable(FixedString(42))` | *The address of the account that is the transaction recipient* | +| **nonce** | `UInt64` | *The nonce of the sender account at the time of the transaction* | +| **gas_price** | `UInt128` | *The gas price of the transaction in wei* | +| **gas** | `UInt64` | *The maximum gas provided for the transaction execution* | +| **gas_tip_cap** | `Nullable(UInt128)` | *The priority fee (tip) the user has set for the transaction* | +| **gas_fee_cap** | `Nullable(UInt128)` | *The max fee the user has set for the transaction* | +| **value** | `UInt128` | *The value transferred with the transaction in wei* | +| **type** | `Nullable(UInt8)` | *The type of the transaction* | +| **size** | `UInt32` | *The size of the transaction data in bytes* | +| **call_data_size** | `UInt32` | *The size of the call data of the transaction in bytes* | +| **blob_gas** | `Nullable(UInt64)` | *The maximum gas provided for the blob transaction execution* | +| **blob_gas_fee_cap** | `Nullable(UInt128)` | *The max fee the user has set for the transaction* | +| **blob_hashes** | `Array(String)` | *The hashes of the blob commitments for blob transactions* | +| **blob_sidecars_size** | `Nullable(UInt32)` | *The total size of the sidecars for blob transactions in bytes* | +| **blob_sidecars_empty_size** | `Nullable(UInt32)` | *The total empty size of the sidecars for blob transactions in bytes* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_execution_fork_id_hash** | `LowCardinality(String)` | *The hash of the fork ID of the current Ethereum network* | +| **meta_execution_fork_id_next** | `LowCardinality(String)` | *The fork ID of the next planned Ethereum network upgrade* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + + +# canonical_beacon_ + +Events derived from the finalized beacon chain + +## Availability +- EthPandaOps Clickhouse +- Public Parquet Files + +## Tables + + +- [`canonical_beacon_block`](#canonical_beacon_block) +- [`canonical_beacon_committee`](#canonical_beacon_committee) +- [`canonical_beacon_block_attester_slashing`](#canonical_beacon_block_attester_slashing) +- [`canonical_beacon_block_proposer_slashing`](#canonical_beacon_block_proposer_slashing) +- [`canonical_beacon_block_bls_to_execution_change`](#canonical_beacon_block_bls_to_execution_change) +- [`canonical_beacon_block_execution_transaction`](#canonical_beacon_block_execution_transaction) +- [`canonical_beacon_block_voluntary_exit`](#canonical_beacon_block_voluntary_exit) +- [`canonical_beacon_block_deposit`](#canonical_beacon_block_deposit) +- [`canonical_beacon_block_withdrawal`](#canonical_beacon_block_withdrawal) +- [`canonical_beacon_blob_sidecar`](#canonical_beacon_blob_sidecar) +- [`canonical_beacon_proposer_duty`](#canonical_beacon_proposer_duty) +- [`canonical_beacon_elaborated_attestation`](#canonical_beacon_elaborated_attestation) +- [`canonical_beacon_validators`](#canonical_beacon_validators) + + + +## canonical_beacon_block + +Contains beacon block from a beacon node. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **block_total_bytes** | `Nullable(UInt32)` | *The total bytes of the beacon block payload* | +| **block_total_bytes_compressed** | `Nullable(UInt32)` | *The total bytes of the beacon block payload when compressed using snappy* | +| **parent_root** | `FixedString(66)` | *The root hash of the parent beacon block* | +| **state_root** | `FixedString(66)` | *The root hash of the beacon state at this block* | +| **proposer_index** | `UInt32` | *The index of the validator that proposed the beacon block* | +| **eth1_data_block_hash** | `FixedString(66)` | *The block hash of the associated execution block* | +| **eth1_data_deposit_root** | `FixedString(66)` | *The root of the deposit tree in the associated execution block* | +| **execution_payload_block_hash** | `Nullable(FixedString(66))` | *The block hash of the execution payload* | +| **execution_payload_block_number** | `Nullable(UInt32)` | *The block number of the execution payload* | +| **execution_payload_fee_recipient** | `Nullable(String)` | *The recipient of the fee for this execution payload* | +| **execution_payload_base_fee_per_gas** | `Nullable(UInt128)` | *Base fee per gas for execution payload* | +| **execution_payload_blob_gas_used** | `Nullable(UInt64)` | *Gas used for blobs in execution payload* | +| **execution_payload_excess_blob_gas** | `Nullable(UInt64)` | *Excess gas used for blobs in execution payload* | +| **execution_payload_gas_limit** | `Nullable(UInt64)` | *Gas limit for execution payload* | +| **execution_payload_gas_used** | `Nullable(UInt64)` | *Gas used for execution payload* | +| **execution_payload_state_root** | `Nullable(FixedString(66))` | *The state root of the execution payload* | +| **execution_payload_parent_hash** | `Nullable(FixedString(66))` | *The parent hash of the execution payload* | +| **execution_payload_transactions_count** | `Nullable(UInt32)` | *The transaction count of the execution payload* | +| **execution_payload_transactions_total_bytes** | `Nullable(UInt32)` | *The transaction total bytes of the execution payload* | +| **execution_payload_transactions_total_bytes_compressed** | `Nullable(UInt32)` | *The transaction total bytes of the execution payload when compressed using snappy* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_committee + +Contains canonical beacon API /eth/v1/beacon/committees data. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_committee/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_committee/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_committee FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_committee FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **slot** | `UInt32` | *Slot number in the beacon API committee payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **committee_index** | `LowCardinality(String)` | *The committee index in the beacon API committee payload* | +| **validators** | `Array(UInt32)` | *The validator indices in the beacon API committee payload* | +| **epoch** | `UInt32` | *The epoch number in the beacon API committee payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_attester_slashing + +Contains attester slashing from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `null` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_attester_slashing/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_attester_slashing/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_attester_slashing FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_attester_slashing FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **attestation_1_attesting_indices** | `Array(UInt32)` | *The attesting indices from the first attestation in the slashing payload* | +| **attestation_1_signature** | `String` | *The signature from the first attestation in the slashing payload* | +| **attestation_1_data_beacon_block_root** | `FixedString(66)` | *The beacon block root from the first attestation in the slashing payload* | +| **attestation_1_data_slot** | `UInt32` | *The slot number from the first attestation in the slashing payload* | +| **attestation_1_data_index** | `UInt32` | *The attestor index from the first attestation in the slashing payload* | +| **attestation_1_data_source_epoch** | `UInt32` | *The source epoch number from the first attestation in the slashing payload* | +| **attestation_1_data_source_root** | `FixedString(66)` | *The source root from the first attestation in the slashing payload* | +| **attestation_1_data_target_epoch** | `UInt32` | *The target epoch number from the first attestation in the slashing payload* | +| **attestation_1_data_target_root** | `FixedString(66)` | *The target root from the first attestation in the slashing payload* | +| **attestation_2_attesting_indices** | `Array(UInt32)` | *The attesting indices from the second attestation in the slashing payload* | +| **attestation_2_signature** | `String` | *The signature from the second attestation in the slashing payload* | +| **attestation_2_data_beacon_block_root** | `FixedString(66)` | *The beacon block root from the second attestation in the slashing payload* | +| **attestation_2_data_slot** | `UInt32` | *The slot number from the second attestation in the slashing payload* | +| **attestation_2_data_index** | `UInt32` | *The attestor index from the second attestation in the slashing payload* | +| **attestation_2_data_source_epoch** | `UInt32` | *The source epoch number from the second attestation in the slashing payload* | +| **attestation_2_data_source_root** | `FixedString(66)` | *The source root from the second attestation in the slashing payload* | +| **attestation_2_data_target_epoch** | `UInt32` | *The target epoch number from the second attestation in the slashing payload* | +| **attestation_2_data_target_root** | `FixedString(66)` | *The target root from the second attestation in the slashing payload* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_proposer_slashing + +Contains proposer slashing from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `null` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_proposer_slashing/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_proposer_slashing/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_proposer_slashing FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_proposer_slashing FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **signed_header_1_message_slot** | `UInt32` | *The slot number from the first signed header in the slashing payload* | +| **signed_header_1_message_proposer_index** | `UInt32` | *The proposer index from the first signed header in the slashing payload* | +| **signed_header_1_message_body_root** | `FixedString(66)` | *The body root from the first signed header in the slashing payload* | +| **signed_header_1_message_parent_root** | `FixedString(66)` | *The parent root from the first signed header in the slashing payload* | +| **signed_header_1_message_state_root** | `FixedString(66)` | *The state root from the first signed header in the slashing payload* | +| **signed_header_1_signature** | `String` | *The signature for the first signed header in the slashing payload* | +| **signed_header_2_message_slot** | `UInt32` | *The slot number from the second signed header in the slashing payload* | +| **signed_header_2_message_proposer_index** | `UInt32` | *The proposer index from the second signed header in the slashing payload* | +| **signed_header_2_message_body_root** | `FixedString(66)` | *The body root from the second signed header in the slashing payload* | +| **signed_header_2_message_parent_root** | `FixedString(66)` | *The parent root from the second signed header in the slashing payload* | +| **signed_header_2_message_state_root** | `FixedString(66)` | *The state root from the second signed header in the slashing payload* | +| **signed_header_2_signature** | `String` | *The signature for the second signed header in the slashing payload* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_bls_to_execution_change + +Contains bls to execution change from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2023-04-12` to `2024-11-12` +- **holesky**: `2023-09-28` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_bls_to_execution_change/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_bls_to_execution_change/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_bls_to_execution_change FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_bls_to_execution_change FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **exchanging_message_validator_index** | `UInt32` | *The validator index from the exchanging message* | +| **exchanging_message_from_bls_pubkey** | `String` | *The BLS public key from the exchanging message* | +| **exchanging_message_to_execution_address** | `FixedString(42)` | *The execution address from the exchanging message* | +| **exchanging_signature** | `String` | *The signature for the exchanging message* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_execution_transaction + +Contains execution transaction from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2022-09-06` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_execution_transaction/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_execution_transaction/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_execution_transaction FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_execution_transaction FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **position** | `UInt32` | *The position of the transaction in the beacon block* | +| **hash** | `FixedString(66)` | *The hash of the transaction* | +| **from** | `FixedString(42)` | *The address of the account that sent the transaction* | +| **to** | `Nullable(FixedString(42))` | *The address of the account that is the transaction recipient* | +| **nonce** | `UInt64` | *The nonce of the sender account at the time of the transaction* | +| **gas_price** | `UInt128` | *The gas price of the transaction in wei* | +| **gas** | `UInt64` | *The maximum gas provided for the transaction execution* | +| **gas_tip_cap** | `Nullable(UInt128)` | *The priority fee (tip) the user has set for the transaction* | +| **gas_fee_cap** | `Nullable(UInt128)` | *The max fee the user has set for the transaction* | +| **value** | `UInt128` | *The value transferred with the transaction in wei* | +| **type** | `UInt8` | *The type of the transaction* | +| **size** | `UInt32` | *The size of the transaction data in bytes* | +| **call_data_size** | `UInt32` | *The size of the call data of the transaction in bytes* | +| **blob_gas** | `Nullable(UInt64)` | *The maximum gas provided for the blob transaction execution* | +| **blob_gas_fee_cap** | `Nullable(UInt128)` | *The max fee the user has set for the transaction* | +| **blob_hashes** | `Array(String)` | *The hashes of the blob commitments for blob transactions* | +| **blob_sidecars_size** | `Nullable(UInt32)` | *The total size of the sidecars for blob transactions in bytes* | +| **blob_sidecars_empty_size** | `Nullable(UInt32)` | *The total empty size of the sidecars for blob transactions in bytes* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_voluntary_exit + +Contains a voluntary exit from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_voluntary_exit/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_voluntary_exit/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_voluntary_exit FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_voluntary_exit FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **voluntary_exit_message_epoch** | `UInt32` | *The epoch number from the exit message* | +| **voluntary_exit_message_validator_index** | `UInt32` | *The validator index from the exit message* | +| **voluntary_exit_signature** | `String` | *The signature of the exit message* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_deposit + +Contains a deposit from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_deposit/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_deposit/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_deposit FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_deposit FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **deposit_proof** | `Array(String)` | *The proof of the deposit data* | +| **deposit_data_pubkey** | `String` | *The BLS public key of the validator from the deposit data* | +| **deposit_data_withdrawal_credentials** | `FixedString(66)` | *The withdrawal credentials of the validator from the deposit data* | +| **deposit_data_amount** | `UInt128` | *The amount of the deposit from the deposit data* | +| **deposit_data_signature** | `String` | *The signature of the deposit data* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_block_withdrawal + +Contains a withdrawal from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2023-04-12` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2023-02-28` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_block_withdrawal/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_withdrawal/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_block_withdrawal FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_block_withdrawal FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_version** | `LowCardinality(String)` | *The version of the beacon block* | +| **withdrawal_index** | `UInt32` | *The index of the withdrawal* | +| **withdrawal_validator_index** | `UInt32` | *The validator index from the withdrawal data* | +| **withdrawal_address** | `FixedString(42)` | *The address of the account that is the withdrawal recipient* | +| **withdrawal_amount** | `UInt128` | *The amount of the withdrawal from the withdrawal data* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_blob_sidecar + +Contains a blob sidecar from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-03-13` to `2024-11-12` +- **holesky**: `2024-02-07` to `2024-11-12` +- **sepolia**: `2024-01-30` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_blob_sidecar/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_blob_sidecar/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_blob_sidecar FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_blob_sidecar FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number from beacon block payload* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **block_root** | `FixedString(66)` | *The root hash of the beacon block* | +| **block_parent_root** | `FixedString(66)` | *The root hash of the parent beacon block* | +| **versioned_hash** | `FixedString(66)` | *The versioned hash in the beacon API event stream payload* | +| **kzg_commitment** | `FixedString(98)` | *The KZG commitment in the blob sidecar payload* | +| **kzg_proof** | `FixedString(98)` | *The KZG proof in the blob sidecar payload* | +| **proposer_index** | `UInt32` | *The index of the validator that proposed the beacon block* | +| **blob_index** | `UInt64` | *The index of blob sidecar in the blob sidecar payload* | +| **blob_size** | `UInt32` | *The total bytes of the blob* | +| **blob_empty_size** | `Nullable(UInt32)` | *The total empty size of the blob in bytes* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_proposer_duty + +Contains a proposer duty from a beacon block. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_proposer_duty/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_proposer_duty/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_proposer_duty FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_proposer_duty FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **slot** | `UInt32` | *The slot number for which the proposer duty is assigned* | +| **slot_start_date_time** | `DateTime` | *The wall clock time when the slot started* | +| **epoch** | `UInt32` | *The epoch number containing the slot* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **proposer_validator_index** | `UInt32` | *The validator index of the proposer for the slot* | +| **proposer_pubkey** | `String` | *The public key of the validator proposer* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the even* | + +## canonical_beacon_elaborated_attestation + +Contains elaborated attestations from beacon blocks. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_elaborated_attestation/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_elaborated_attestation/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_elaborated_attestation FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_elaborated_attestation FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **block_slot** | `UInt32` | *The slot number of the block containing the attestation* | +| **block_slot_start_date_time** | `DateTime` | *The wall clock time when the block slot started* | +| **block_epoch** | `UInt32` | *The epoch number of the block containing the attestation* | +| **block_epoch_start_date_time** | `DateTime` | *The wall clock time when the block epoch started* | +| **position_in_block** | `UInt32` | *The position of the attestation in the block* | +| **block_root** | `FixedString(66)` | *The root of the block containing the attestation* | +| **validators** | `Array(UInt32)` | *Array of validator indices participating in the attestation* | +| **committee_index** | `LowCardinality(String)` | *The index of the committee making the attestation* | +| **beacon_block_root** | `FixedString(66)` | *The root of the beacon block being attested to* | +| **slot** | `UInt32` | *The slot number being attested to* | +| **slot_start_date_time** | `DateTime` | ** | +| **epoch** | `UInt32` | ** | +| **epoch_start_date_time** | `DateTime` | ** | +| **source_epoch** | `UInt32` | *The source epoch referenced in the attestation* | +| **source_epoch_start_date_time** | `DateTime` | *The wall clock time when the source epoch started* | +| **source_root** | `FixedString(66)` | *The root of the source checkpoint in the attestation* | +| **target_epoch** | `UInt32` | *The target epoch referenced in the attestation* | +| **target_epoch_start_date_time** | `DateTime` | *The wall clock time when the target epoch started* | +| **target_root** | `FixedString(66)` | *The root of the target checkpoint in the attestation* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## canonical_beacon_validators + +Contains a validator state for an epoch. + +### Availability +Data is partitioned **hourly** on **epoch_start_date_time** for the following networks: + +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-11` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_beacon_validators/YYYY/MM/DD/HH.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_validators/2024/11/6/0.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_beacon_validators FINAL + WHERE + epoch_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_beacon_validators FINAL + WHERE + epoch_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *When this row was last updated* | +| **epoch** | `UInt32` | *The epoch number from beacon block payload* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **index** | `UInt32` | *The index of the validator* | +| **balance** | `Nullable(UInt64)` | *The balance of the validator* | +| **status** | `LowCardinality(String)` | *The status of the validator* | +| **effective_balance** | `Nullable(UInt64)` | *The effective balance of the validator* | +| **slashed** | `Bool` | *Whether the validator is slashed* | +| **activation_epoch** | `Nullable(UInt64)` | *The epoch when the validator was activated* | +| **activation_eligibility_epoch** | `Nullable(UInt64)` | *The epoch when the validator was activated* | +| **exit_epoch** | `Nullable(UInt64)` | *The epoch when the validator exited* | +| **withdrawable_epoch** | `Nullable(UInt64)` | *The epoch when the validator can withdraw* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_consensus_version** | `LowCardinality(String)` | *Ethereum consensus client version that generated the event* | +| **meta_consensus_version_major** | `LowCardinality(String)` | *Ethereum consensus client major version that generated the event* | +| **meta_consensus_version_minor** | `LowCardinality(String)` | *Ethereum consensus client minor version that generated the event* | +| **meta_consensus_version_patch** | `LowCardinality(String)` | *Ethereum consensus client patch version that generated the event* | +| **meta_consensus_implementation** | `LowCardinality(String)` | *Ethereum consensus client implementation that generated the event* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + + +# canonical_execution_ + +Data extracted from the execution layer + +## Availability +- EthPandaOps Clickhouse +- Public Parquet Files + +## Tables + + +- [`canonical_execution_block`](#canonical_execution_block) +- [`canonical_execution_transaction`](#canonical_execution_transaction) +- [`canonical_execution_traces`](#canonical_execution_traces) +- [`canonical_execution_logs`](#canonical_execution_logs) +- [`canonical_execution_contracts`](#canonical_execution_contracts) +- [`canonical_execution_four_byte_counts`](#canonical_execution_four_byte_counts) +- [`canonical_execution_address_appearances`](#canonical_execution_address_appearances) +- [`canonical_execution_balance_diffs`](#canonical_execution_balance_diffs) +- [`canonical_execution_balance_reads`](#canonical_execution_balance_reads) +- [`canonical_execution_erc20_transfers`](#canonical_execution_erc20_transfers) +- [`canonical_execution_erc721_transfers`](#canonical_execution_erc721_transfers) +- [`canonical_execution_native_transfers`](#canonical_execution_native_transfers) +- [`canonical_execution_nonce_diffs`](#canonical_execution_nonce_diffs) +- [`canonical_execution_nonce_reads`](#canonical_execution_nonce_reads) +- [`canonical_execution_storage_diffs`](#canonical_execution_storage_diffs) +- [`canonical_execution_storage_reads`](#canonical_execution_storage_reads) + + + +## canonical_execution_block + +Contains canonical execution block data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_block/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_block/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_block/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_block/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_block/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_block FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_block FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_date_time** | `DateTime64(3)` | *The block timestamp* | +| **block_number** | `UInt64` | *The block number* | +| **block_hash** | `FixedString(66)` | *The block hash* | +| **author** | `Nullable(String)` | *The block author* | +| **gas_used** | `Nullable(UInt64)` | *The block gas used* | +| **extra_data** | `Nullable(String)` | *The block extra data in hex* | +| **extra_data_string** | `Nullable(String)` | *The block extra data in UTF-8 string* | +| **base_fee_per_gas** | `Nullable(UInt64)` | *The block base fee per gas* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_transaction + +Contains canonical execution transaction data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_transaction/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_transaction/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_transaction/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_transaction/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_transaction/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_transaction FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_transaction FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **nonce** | `UInt64` | *The transaction nonce* | +| **from_address** | `String` | *The transaction from address* | +| **to_address** | `Nullable(String)` | *The transaction to address* | +| **value** | `UInt256` | *The transaction value in float64* | +| **input** | `Nullable(String)` | *The transaction input in hex* | +| **gas_limit** | `UInt64` | *The transaction gas limit* | +| **gas_used** | `UInt64` | *The transaction gas used* | +| **gas_price** | `UInt64` | *The transaction gas price* | +| **transaction_type** | `UInt32` | *The transaction type* | +| **max_priority_fee_per_gas** | `UInt64` | *The transaction max priority fee per gas* | +| **max_fee_per_gas** | `UInt64` | *The transaction max fee per gas* | +| **success** | `Bool` | *The transaction success* | +| **n_input_bytes** | `UInt32` | *The transaction input bytes* | +| **n_input_zero_bytes** | `UInt32` | *The transaction input zero bytes* | +| **n_input_nonzero_bytes** | `UInt32` | *The transaction input nonzero bytes* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_traces + +Contains canonical execution traces data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_traces/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_traces/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_traces/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_traces/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_traces/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_traces FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_traces FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt32` | *The block number* | +| **transaction_index** | `UInt32` | *The transaction index* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **internal_index** | `UInt32` | *The internal index of the trace within the transaction* | +| **action_from** | `String` | *The from address of the action* | +| **action_to** | `Nullable(String)` | *The to address of the action* | +| **action_value** | `String` | *The value of the action* | +| **action_gas** | `UInt32` | *The gas provided for the action* | +| **action_input** | `Nullable(String)` | *The input data for the action* | +| **action_call_type** | `LowCardinality(String)` | *The call type of the action* | +| **action_init** | `Nullable(String)` | *The initialization code for the action* | +| **action_reward_type** | `String` | *The reward type for the action* | +| **action_type** | `LowCardinality(String)` | *The type of the action* | +| **result_gas_used** | `UInt32` | *The gas used in the result* | +| **result_output** | `Nullable(String)` | *The output of the result* | +| **result_code** | `Nullable(String)` | *The code returned in the result* | +| **result_address** | `Nullable(String)` | *The address returned in the result* | +| **trace_address** | `Nullable(String)` | *The trace address* | +| **subtraces** | `UInt32` | *The number of subtraces* | +| **error** | `Nullable(String)` | *The error, if any, in the trace* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_logs + +Contains canonical execution logs data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_logs/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_logs/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_logs/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_logs/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_logs/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_logs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_logs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt32` | *The block number* | +| **transaction_index** | `UInt32` | *The transaction index* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash associated with the log* | +| **internal_index** | `UInt32` | *The internal index of the log within the transaction* | +| **log_index** | `UInt32` | *The log index within the block* | +| **address** | `String` | *The address associated with the log* | +| **topic0** | `String` | *The first topic of the log* | +| **topic1** | `Nullable(String)` | *The second topic of the log* | +| **topic2** | `Nullable(String)` | *The third topic of the log* | +| **topic3** | `Nullable(String)` | *The fourth topic of the log* | +| **data** | `Nullable(String)` | *The data associated with the log* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_contracts + +Contains canonical execution contract data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_contracts/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_contracts/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_contracts/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_contracts/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_contracts/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_contracts FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_contracts FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt32` | *The block number* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that created the contract* | +| **internal_index** | `UInt32` | *The internal index of the contract creation within the transaction* | +| **create_index** | `UInt32` | *The create index* | +| **contract_address** | `String` | *The contract address* | +| **deployer** | `String` | *The address of the contract deployer* | +| **factory** | `String` | *The address of the factory that deployed the contract* | +| **init_code** | `String` | *The initialization code of the contract* | +| **code** | `Nullable(String)` | *The code of the contract* | +| **init_code_hash** | `String` | *The hash of the initialization code* | +| **n_init_code_bytes** | `UInt32` | *Number of bytes in the initialization code* | +| **n_code_bytes** | `UInt32` | *Number of bytes in the contract code* | +| **code_hash** | `String` | *The hash of the contract code* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_four_byte_counts + +Contains canonical execution four byte count data. + + +> Holesky is currently stuck at block `2402609`, waiting for reth release including the [fix](https://github.com/paradigmxyz/reth/issues/11272). + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21029000` +- **holesky**: `0` to `2401000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_four_byte_counts/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_four_byte_counts/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_four_byte_counts/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_four_byte_counts/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_four_byte_counts/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_four_byte_counts FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_four_byte_counts FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **signature** | `String` | *The signature of the four byte count* | +| **size** | `UInt64` | *The size of the four byte count* | +| **count** | `UInt64` | *The count of the four byte count* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_address_appearances + +Contains canonical execution address appearance data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_address_appearances/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_address_appearances/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_address_appearances/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_address_appearances/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_address_appearances/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_address_appearances FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_address_appearances FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that caused the address appearance* | +| **internal_index** | `UInt32` | *The internal index of the address appearance within the transaction* | +| **address** | `String` | *The address of the address appearance* | +| **relationship** | `LowCardinality(String)` | *The relationship of the address to the transaction* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_balance_diffs + +Contains canonical execution balance diff data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_balance_diffs/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_diffs/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_diffs/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_diffs/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_diffs/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_balance_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_balance_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that caused the balance diff* | +| **internal_index** | `UInt32` | *The internal index of the balance diff within the transaction* | +| **address** | `String` | *The address of the balance diff* | +| **from_value** | `UInt256` | *The from value of the balance diff* | +| **to_value** | `UInt256` | *The to value of the balance diff* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_balance_reads + +Contains canonical execution balance read data. + + +> Holesky is currently stuck at block `2402609`, waiting for reth release including the [fix](https://github.com/paradigmxyz/reth/issues/11272). + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21029000` +- **holesky**: `0` to `2401000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_balance_reads/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_reads/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_reads/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_reads/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_balance_reads/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_balance_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_balance_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that caused the balance read* | +| **internal_index** | `UInt32` | *The internal index of the balance read within the transaction* | +| **address** | `String` | *The address of the balance read* | +| **balance** | `UInt256` | *The balance that was read* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_erc20_transfers + +Contains canonical execution erc20 transfer data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_erc20_transfers/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc20_transfers/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc20_transfers/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc20_transfers/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc20_transfers/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_erc20_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_erc20_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **internal_index** | `UInt32` | *The internal index of the transfer within the transaction* | +| **log_index** | `UInt64` | *The log index in the block* | +| **erc20** | `String` | *The erc20 address* | +| **from_address** | `String` | *The from address* | +| **to_address** | `String` | *The to address* | +| **value** | `UInt256` | *The value of the transfer* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_erc721_transfers + +Contains canonical execution erc721 transfer data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_erc721_transfers/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc721_transfers/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc721_transfers/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc721_transfers/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_erc721_transfers/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_erc721_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_erc721_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **internal_index** | `UInt32` | *The internal index of the transfer within the transaction* | +| **log_index** | `UInt64` | *The log index in the block* | +| **erc20** | `String` | *The erc20 address* | +| **from_address** | `String` | *The from address* | +| **to_address** | `String` | *The to address* | +| **token** | `UInt256` | *The token id* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_native_transfers + +Contains canonical execution native transfer data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_native_transfers/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_native_transfers/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_native_transfers/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_native_transfers/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_native_transfers/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_native_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_native_transfers FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash* | +| **internal_index** | `UInt32` | *The internal index of the transfer within the transaction* | +| **transfer_index** | `UInt64` | *The transfer index* | +| **from_address** | `String` | *The from address* | +| **to_address** | `String` | *The to address* | +| **value** | `UInt256` | *The value of the approval* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_nonce_diffs + +Contains canonical execution nonce diff data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_nonce_diffs/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_diffs/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_diffs/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_diffs/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_diffs/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_nonce_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_nonce_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that caused the nonce diff* | +| **internal_index** | `UInt32` | *The internal index of the nonce diff within the transaction* | +| **address** | `String` | *The address of the nonce diff* | +| **from_value** | `UInt64` | *The from value of the nonce diff* | +| **to_value** | `UInt64` | *The to value of the nonce diff* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_nonce_reads + +Contains canonical execution nonce read data. + + +> Holesky is currently stuck at block `2402609`, waiting for reth release including the [fix](https://github.com/paradigmxyz/reth/issues/11272). + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21029000` +- **holesky**: `0` to `2401000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_nonce_reads/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_reads/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_reads/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_reads/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_nonce_reads/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_nonce_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_nonce_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt64` | *The block number* | +| **transaction_index** | `UInt64` | *The transaction index in the block* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash that caused the nonce read* | +| **internal_index** | `UInt32` | *The internal index of the nonce read within the transaction* | +| **address** | `String` | *The address of the nonce read* | +| **nonce** | `UInt64` | *The nonce that was read* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_storage_diffs + +Contains canonical execution storage diffs data. + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **mainnet**: `0` to `21174000` +- **holesky**: `0` to `2669000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_storage_diffs/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_diffs/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_diffs/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_diffs/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_diffs/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_storage_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_storage_diffs FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt32` | *The block number* | +| **transaction_index** | `UInt32` | *The transaction index* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash associated with the storage diff* | +| **internal_index** | `UInt32` | *The internal index of the storage diff within the transaction* | +| **address** | `String` | *The address associated with the storage diff* | +| **slot** | `String` | *The storage slot key* | +| **from_value** | `String` | *The original value before the storage diff* | +| **to_value** | `String` | *The new value after the storage diff* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + +## canonical_execution_storage_reads + +Contains canonical execution storage reads data. + + +> Mainnet is currently back-filling and not yet available publicly. Holesky is currently stuck at block `2402609`, waiting for reth release including the [fix](https://github.com/paradigmxyz/reth/issues/11272). + +### Availability +Data is partitioned in chunks of **1000** on **block_number** for the following networks: + +- **holesky**: `0` to `2401000` +- **sepolia**: `0` to `7064000` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/canonical_execution_storage_reads/1000/CHUNK_NUMBER.parquet + +To find the parquet file with the `block_number` you're looking for, you need the correct `CHUNK_NUMBER` which is in intervals of `1000`. Take the following examples; + +Contains `block_number` between `0` and `999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_reads/1000/0.parquet + +Contains `block_number` between `50000` and `50999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_reads/1000/50000.parquet + +Contains `block_number` between `1000000` and `1001999`: +> https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_reads/1000/{1000..1001}000.parquet + +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_execution_storage_reads/1000/{50..51}000.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.canonical_execution_storage_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.canonical_execution_storage_reads FINAL + WHERE + block_number BETWEEN 50000 AND 51000 + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **block_number** | `UInt32` | *The block number* | +| **transaction_index** | `UInt32` | *The transaction index* | +| **transaction_hash** | `FixedString(66)` | *The transaction hash associated with the storage read* | +| **internal_index** | `UInt32` | *The internal index of the storage read within the transaction* | +| **contract_address** | `String` | *The contract address associated with the storage read* | +| **slot** | `String` | *The storage slot key* | +| **value** | `String` | *The value read from the storage slot* | +| **meta_network_id** | `Int32` | *Ethereum network ID* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | + + +# libp2p_ + +Events from the consensus layer p2p network + +## Availability +- EthPandaOps Clickhouse +- Public Parquet Files + +## Tables + + +- [`libp2p_gossipsub_beacon_attestation`](#libp2p_gossipsub_beacon_attestation) +- [`libp2p_gossipsub_beacon_block`](#libp2p_gossipsub_beacon_block) +- [`libp2p_gossipsub_blob_sidecar`](#libp2p_gossipsub_blob_sidecar) + + + +## libp2p_gossipsub_beacon_attestation + +Table for libp2p gossipsub beacon attestation data. + +### Availability +Data is partitioned **hourly** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-05-01` to `2024-11-12` +- **holesky**: `2024-05-01` to `2024-11-12` +- **sepolia**: `2024-05-01` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/libp2p_gossipsub_beacon_attestation/YYYY/MM/DD/HH.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/libp2p_gossipsub_beacon_attestation/2024/11/6/0.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.libp2p_gossipsub_beacon_attestation FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.libp2p_gossipsub_beacon_attestation FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **version** | `UInt32` | *Version of this row, to help with de-duplication we want the latest updated_date_time but lowest propagation_slot_start_diff time* | +| **event_date_time** | `DateTime64(3)` | *Timestamp of the event with millisecond precision* | +| **slot** | `UInt32` | *Slot number associated with the event* | +| **slot_start_date_time** | `DateTime` | *Start date and time of the slot* | +| **epoch** | `UInt32` | *The epoch number in the attestation* | +| **epoch_start_date_time** | `DateTime` | *The wall clock time when the epoch started* | +| **committee_index** | `LowCardinality(String)` | *The committee index in the attestation* | +| **attesting_validator_index** | `Nullable(UInt32)` | *The index of the validator attesting to the event* | +| **attesting_validator_committee_index** | `LowCardinality(String)` | *The committee index of the attesting validator* | +| **wallclock_slot** | `UInt32` | *Slot number of the wall clock when the event was received* | +| **wallclock_slot_start_date_time** | `DateTime` | *Start date and time of the wall clock slot when the event was received* | +| **wallclock_epoch** | `UInt32` | *Epoch number of the wall clock when the event was received* | +| **wallclock_epoch_start_date_time** | `DateTime` | *Start date and time of the wall clock epoch when the event was received* | +| **propagation_slot_start_diff** | `UInt32` | *Difference in slot start time for propagation* | +| **peer_id_unique_key** | `Int64` | *Unique key associated with the identifier of the peer* | +| **message_id** | `String` | *Identifier of the message* | +| **message_size** | `UInt32` | *Size of the message in bytes* | +| **topic_layer** | `LowCardinality(String)` | *Layer of the topic in the gossipsub protocol* | +| **topic_fork_digest_value** | `LowCardinality(String)` | *Fork digest value of the topic* | +| **topic_name** | `LowCardinality(String)` | *Name of the topic* | +| **topic_encoding** | `LowCardinality(String)` | *Encoding used for the topic* | +| **aggregation_bits** | `String` | *The aggregation bits of the event in the attestation* | +| **beacon_block_root** | `FixedString(66)` | *The beacon block root hash in the attestation* | +| **source_epoch** | `UInt32` | *The source epoch number in the attestation* | +| **source_epoch_start_date_time** | `DateTime` | *The wall clock time when the source epoch started* | +| **source_root** | `FixedString(66)` | *The source beacon block root hash in the attestation* | +| **target_epoch** | `UInt32` | *The target epoch number in the attestation* | +| **target_epoch_start_date_time** | `DateTime` | *The wall clock time when the target epoch started* | +| **target_root** | `FixedString(66)` | *The target beacon block root hash in the attestation* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Network ID associated with the client* | +| **meta_network_name** | `LowCardinality(String)` | *Name of the network associated with the client* | + +## libp2p_gossipsub_beacon_block + +Table for libp2p gossipsub beacon block data. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-04-26` to `2024-11-12` +- **holesky**: `2024-04-26` to `2024-11-12` +- **sepolia**: `2024-04-26` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/libp2p_gossipsub_beacon_block/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/libp2p_gossipsub_beacon_block/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.libp2p_gossipsub_beacon_block FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.libp2p_gossipsub_beacon_block FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **version** | `UInt32` | *Version of this row, to help with de-duplication we want the latest updated_date_time but lowest propagation_slot_start_diff time* | +| **event_date_time** | `DateTime64(3)` | *Timestamp of the event with millisecond precision* | +| **slot** | `UInt32` | *Slot number associated with the event* | +| **slot_start_date_time** | `DateTime` | *Start date and time of the slot* | +| **epoch** | `UInt32` | *Epoch number associated with the event* | +| **epoch_start_date_time** | `DateTime` | *Start date and time of the epoch* | +| **wallclock_slot** | `UInt32` | *Slot number of the wall clock when the event was received* | +| **wallclock_slot_start_date_time** | `DateTime` | *Start date and time of the wall clock slot when the event was received* | +| **wallclock_epoch** | `UInt32` | *Epoch number of the wall clock when the event was received* | +| **wallclock_epoch_start_date_time** | `DateTime` | *Start date and time of the wall clock epoch when the event was received* | +| **propagation_slot_start_diff** | `UInt32` | *Difference in slot start time for propagation* | +| **block** | `FixedString(66)` | *The beacon block root hash* | +| **proposer_index** | `UInt32` | *The proposer index of the beacon block* | +| **peer_id_unique_key** | `Int64` | *Unique key associated with the identifier of the peer* | +| **message_id** | `String` | *Identifier of the message* | +| **message_size** | `UInt32` | *Size of the message in bytes* | +| **topic_layer** | `LowCardinality(String)` | *Layer of the topic in the gossipsub protocol* | +| **topic_fork_digest_value** | `LowCardinality(String)` | *Fork digest value of the topic* | +| **topic_name** | `LowCardinality(String)` | *Name of the topic* | +| **topic_encoding** | `LowCardinality(String)` | *Encoding used for the topic* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Network ID associated with the client* | +| **meta_network_name** | `LowCardinality(String)` | *Name of the network associated with the client* | + +## libp2p_gossipsub_blob_sidecar + +Table for libp2p gossipsub blob sidecar data + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-06-04` to `2024-11-12` +- **holesky**: `2024-06-04` to `2024-11-12` +- **sepolia**: `2024-06-04` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/libp2p_gossipsub_blob_sidecar/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/libp2p_gossipsub_blob_sidecar/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.libp2p_gossipsub_blob_sidecar FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.libp2p_gossipsub_blob_sidecar FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **version** | `UInt32` | *Version of this row, to help with de-duplication we want the latest updated_date_time but lowest propagation_slot_start_diff time* | +| **event_date_time** | `DateTime64(3)` | *Timestamp of the event with millisecond precision* | +| **slot** | `UInt32` | *Slot number associated with the event* | +| **slot_start_date_time** | `DateTime` | *Start date and time of the slot* | +| **epoch** | `UInt32` | *Epoch number associated with the event* | +| **epoch_start_date_time** | `DateTime` | *Start date and time of the epoch* | +| **wallclock_slot** | `UInt32` | *Slot number of the wall clock when the event was received* | +| **wallclock_slot_start_date_time** | `DateTime` | *Start date and time of the wall clock slot when the event was received* | +| **wallclock_epoch** | `UInt32` | *Epoch number of the wall clock when the event was received* | +| **wallclock_epoch_start_date_time** | `DateTime` | *Start date and time of the wall clock epoch when the event was received* | +| **propagation_slot_start_diff** | `UInt32` | *Difference in slot start time for propagation* | +| **proposer_index** | `UInt32` | *The proposer index of the beacon block* | +| **blob_index** | `UInt32` | *Blob index associated with the record* | +| **parent_root** | `FixedString(66)` | *Parent root of the beacon block* | +| **state_root** | `FixedString(66)` | *State root of the beacon block* | +| **peer_id_unique_key** | `Int64` | *Unique key associated with the identifier of the peer* | +| **message_id** | `String` | *Identifier of the message* | +| **message_size** | `UInt32` | *Size of the message in bytes* | +| **topic_layer** | `LowCardinality(String)` | *Layer of the topic in the gossipsub protocol* | +| **topic_fork_digest_value** | `LowCardinality(String)` | *Fork digest value of the topic* | +| **topic_name** | `LowCardinality(String)` | *Name of the topic* | +| **topic_encoding** | `LowCardinality(String)` | *Encoding used for the topic* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_id** | `Int32` | *Network ID associated with the client* | +| **meta_network_name** | `LowCardinality(String)` | *Name of the network associated with the client* | + + +# mev_relay_ + +Events derived from MEV relays + +## Availability +- Public Parquet Files +- EthPandaOps Clickhouse + +## Tables + + +- [`mev_relay_bid_trace`](#mev_relay_bid_trace) +- [`mev_relay_proposer_payload_delivered`](#mev_relay_proposer_payload_delivered) + + + +## mev_relay_bid_trace + +Contains MEV relay block bids data. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-09-16` to `2024-11-12` +- **holesky**: `2024-09-16` to `2024-11-12` +- **sepolia**: `2024-09-16` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/mev_relay_bid_trace/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/mev_relay_bid_trace/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.mev_relay_bid_trace FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.mev_relay_bid_trace FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **event_date_time** | `DateTime64(3)` | *When the bid was fetched* | +| **slot** | `UInt32` | *Slot number within the block bid* | +| **slot_start_date_time** | `DateTime` | *The start time for the slot that the bid is for* | +| **epoch** | `UInt32` | *Epoch number derived from the slot that the bid is for* | +| **epoch_start_date_time** | `DateTime` | *The start time for the epoch that the bid is for* | +| **wallclock_request_slot** | `UInt32` | *The wallclock slot when the request was sent* | +| **wallclock_request_slot_start_date_time** | `DateTime` | *The start time for the slot when the request was sent* | +| **wallclock_request_epoch** | `UInt32` | *The wallclock epoch when the request was sent* | +| **wallclock_request_epoch_start_date_time** | `DateTime` | *The start time for the wallclock epoch when the request was sent* | +| **requested_at_slot_time** | `UInt32` | *The time in the slot when the request was sent* | +| **response_at_slot_time** | `UInt32` | *The time in the slot when the response was received* | +| **relay_name** | `String` | *The relay that the bid was fetched from* | +| **parent_hash** | `FixedString(66)` | *The parent hash of the bid* | +| **block_number** | `UInt64` | *The block number of the bid* | +| **block_hash** | `FixedString(66)` | *The block hash of the bid* | +| **builder_pubkey** | `String` | *The builder pubkey of the bid* | +| **proposer_pubkey** | `String` | *The proposer pubkey of the bid* | +| **proposer_fee_recipient** | `FixedString(42)` | *The proposer fee recipient of the bid* | +| **gas_limit** | `UInt64` | *The gas limit of the bid* | +| **gas_used** | `UInt64` | *The gas used of the bid* | +| **value** | `UInt256` | *The transaction value in float64* | +| **num_tx** | `UInt32` | *The number of transactions in the bid* | +| **timestamp** | `Int64` | *The timestamp of the bid* | +| **timestamp_ms** | `Int64` | *The timestamp of the bid in milliseconds* | +| **optimistic_submission** | `Bool` | *Whether the bid was optimistic* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + +## mev_relay_proposer_payload_delivered + +Contains MEV relay proposer payload delivered data. + +### Availability +Data is partitioned **daily** on **slot_start_date_time** for the following networks: + +- **mainnet**: `2024-09-16` to `2024-11-12` +- **holesky**: `2024-09-16` to `2024-11-12` +- **sepolia**: `2024-09-16` to `2024-11-12` + +### Examples + +
+Parquet file + +> https://data.ethpandaops.io/xatu/NETWORK/databases/default/mev_relay_proposer_payload_delivered/YYYY/MM/DD.parquet +```bash +docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query=""" + SELECT + * + FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/mev_relay_proposer_payload_delivered/2024/11/6.parquet', 'Parquet') + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+Your Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +docker run --rm -it --net host clickhouse/clickhouse-server clickhouse client --query=""" + SELECT + * + FROM default.mev_relay_proposer_payload_delivered FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 10 + FORMAT Pretty +""" +``` +
+ +
+EthPandaOps Clickhouse + +> **Note:** [`FINAL`](https://clickhouse.com/docs/en/sql-reference/statements/select/from#final-modifier) should be used when querying this table + +```bash +echo """ + SELECT + * + FROM default.mev_relay_proposer_payload_delivered FINAL + WHERE + slot_start_date_time >= NOW() - INTERVAL '1 HOUR' + LIMIT 3 + FORMAT Pretty +""" | curl "https://clickhouse.xatu.ethpandaops.io" -u "$CLICKHOUSE_USER:$CLICKHOUSE_PASSWORD" --data-binary @- +``` +
+ +### Columns +| Name | Type | Description | +|--------|------|-------------| +| **updated_date_time** | `DateTime` | *Timestamp when the record was last updated* | +| **event_date_time** | `DateTime64(3)` | *When the payload was delivered* | +| **slot** | `UInt32` | *Slot number within the payload* | +| **slot_start_date_time** | `DateTime` | *The start time for the slot that the bid is for* | +| **epoch** | `UInt32` | *Epoch number derived from the slot that the bid is for* | +| **epoch_start_date_time** | `DateTime` | *The start time for the epoch that the bid is for* | +| **wallclock_slot** | `UInt32` | *The wallclock slot when the request was sent* | +| **wallclock_slot_start_date_time** | `DateTime` | *The start time for the slot when the request was sent* | +| **wallclock_epoch** | `UInt32` | *The wallclock epoch when the request was sent* | +| **wallclock_epoch_start_date_time** | `DateTime` | *The start time for the wallclock epoch when the request was sent* | +| **block_number** | `UInt64` | *The block number of the payload* | +| **relay_name** | `String` | *The relay that delivered the payload* | +| **block_hash** | `FixedString(66)` | *The block hash associated with the payload* | +| **proposer_pubkey** | `String` | *The proposer pubkey that received the payload* | +| **builder_pubkey** | `String` | *The builder pubkey that sent the payload* | +| **proposer_fee_recipient** | `FixedString(42)` | *The proposer fee recipient of the payload* | +| **gas_limit** | `UInt64` | *The gas limit of the payload* | +| **gas_used** | `UInt64` | *The gas used by the payload* | +| **num_tx** | `UInt32` | *The number of transactions in the payload* | +| **meta_client_name** | `LowCardinality(String)` | *Name of the client that generated the event* | +| **meta_client_id** | `String` | *Unique Session ID of the client that generated the event. This changes every time the client is restarted.* | +| **meta_client_version** | `LowCardinality(String)` | *Version of the client that generated the event* | +| **meta_client_implementation** | `LowCardinality(String)` | *Implementation of the client that generated the event* | +| **meta_client_os** | `LowCardinality(String)` | *Operating system of the client that generated the event* | +| **meta_client_ip** | `Nullable(IPv6)` | *IP address of the client that generated the event* | +| **meta_client_geo_city** | `LowCardinality(String)` | *City of the client that generated the event* | +| **meta_client_geo_country** | `LowCardinality(String)` | *Country of the client that generated the event* | +| **meta_client_geo_country_code** | `LowCardinality(String)` | *Country code of the client that generated the event* | +| **meta_client_geo_continent_code** | `LowCardinality(String)` | *Continent code of the client that generated the event* | +| **meta_client_geo_longitude** | `Nullable(Float64)` | *Longitude of the client that generated the event* | +| **meta_client_geo_latitude** | `Nullable(Float64)` | *Latitude of the client that generated the event* | +| **meta_client_geo_autonomous_system_number** | `Nullable(UInt32)` | *Autonomous system number of the client that generated the event* | +| **meta_client_geo_autonomous_system_organization** | `Nullable(String)` | *Autonomous system organization of the client that generated the event* | +| **meta_network_name** | `LowCardinality(String)` | *Ethereum network name* | +| **meta_labels** | `Map(String, String)` | *Labels associated with the event* | + + + +# mempool_ + +Events from the execution layer p2p network + +## Availability +- EthPandaOps Clickhouse +- Public Parquet Files + +## Tables + + +- [`mempool_transaction`](#mempool_transaction) + + + +## mempool_transaction + +Each row represents a transaction that was seen in the mempool by a sentry client. Sentries can report the same transaction multiple times if it has been long enough since the last report. + +### Availability +Data is partitioned **daily** on **event_date_time** for the following networks: + - **mainnet**: `2023-07-22` to `2024-11-11` - **holesky**: `2024-01-08` to `2024-11-11` - **sepolia**: `2024-01-08` to `2024-11-11` diff --git a/schema/beacon_api_.md b/schema/beacon_api_.md index 1719d7a..2a259a0 100644 --- a/schema/beacon_api_.md +++ b/schema/beacon_api_.md @@ -34,9 +34,9 @@ Contains beacon API /eth/v1/beacon/states/{state_id}/committees data from each s ### Availability Data is partitioned **hourly** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-09-05` to `2024-11-11` -- **holesky**: `2023-12-25` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-09-05` to `2024-11-12` +- **holesky**: `2023-12-25` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -132,9 +132,9 @@ Contains beacon API eventstream "attestation" data from each sentry client attac ### Availability Data is partitioned **hourly** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-06-05` to `2024-11-11` -- **holesky**: `2023-09-29` to `2024-11-11` -- **sepolia**: `2023-09-01` to `2024-11-11` +- **mainnet**: `2023-06-05` to `2024-11-12` +- **holesky**: `2023-09-29` to `2024-11-12` +- **sepolia**: `2023-09-01` to `2024-11-12` ### Examples @@ -235,9 +235,9 @@ Contains beacon API eventstream "blob_sidecar" data from each sentry client atta ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-03-13` to `2024-11-11` -- **holesky**: `2024-02-07` to `2024-11-11` -- **sepolia**: `2024-01-30` to `2024-11-11` +- **mainnet**: `2024-03-13` to `2024-11-12` +- **holesky**: `2024-02-07` to `2024-11-12` +- **sepolia**: `2024-01-30` to `2024-11-12` ### Examples @@ -336,9 +336,9 @@ Contains beacon API eventstream "block" data from each sentry client attached to ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-02-28` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-02-28` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -435,9 +435,9 @@ Contains beacon API eventstream "chain reorg" data from each sentry client attac ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-03-01` to `2024-11-11` -- **holesky**: `2024-02-05` to `2024-11-11` -- **sepolia**: `2024-05-23` to `2024-11-11` +- **mainnet**: `2023-03-01` to `2024-11-12` +- **holesky**: `2024-02-05` to `2024-11-12` +- **sepolia**: `2024-05-23` to `2024-11-12` ### Examples @@ -538,9 +538,9 @@ Contains beacon API eventstream "contribution and proof" data from each sentry c ### Availability Data is partitioned **daily** on **contribution_slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-31` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-08-31` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -642,9 +642,9 @@ Contains beacon API eventstream "finalized checkpoint" data from each sentry cli ### Availability Data is partitioned **daily** on **epoch_start_date_time** for the following networks: -- **mainnet**: `2023-04-10` to `2024-11-11` -- **holesky**: `2023-03-26` to `2024-11-11` -- **sepolia**: `2023-03-26` to `2024-11-11` +- **mainnet**: `2023-04-10` to `2024-11-12` +- **holesky**: `2023-03-26` to `2024-11-12` +- **sepolia**: `2023-03-26` to `2024-11-12` ### Examples @@ -739,9 +739,9 @@ Contains beacon API eventstream "head" data from each sentry client attached to ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-30` to `2024-11-11` -- **holesky**: `2023-12-05` to `2024-11-11` -- **sepolia**: `2023-12-05` to `2024-11-11` +- **mainnet**: `2023-08-30` to `2024-11-12` +- **holesky**: `2023-12-05` to `2024-11-12` +- **sepolia**: `2023-12-05` to `2024-11-12` ### Examples @@ -841,8 +841,8 @@ Contains beacon API eventstream "voluntary exit" data from each sentry client at ### Availability Data is partitioned **daily** on **wallclock_epoch_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-10-01` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-10-01` to `2024-11-12` - **sepolia**: `2023-10-01` to `null` ### Examples @@ -941,9 +941,9 @@ Contains beacon API validator attestation data from each sentry client attached ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-08-31` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-08-31` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -1048,9 +1048,9 @@ Contains beacon API /eth/v2/beacon/blocks/{block_id} data from each sentry clien ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-11-14` to `2024-11-11` -- **holesky**: `2023-12-24` to `2024-11-11` -- **sepolia**: `2023-12-24` to `2024-11-11` +- **mainnet**: `2023-11-14` to `2024-11-12` +- **holesky**: `2023-12-24` to `2024-11-12` +- **sepolia**: `2023-12-24` to `2024-11-12` ### Examples @@ -1166,9 +1166,9 @@ Contains a proposer duty from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-04-03` to `2024-11-11` -- **holesky**: `2024-04-03` to `2024-11-11` -- **sepolia**: `2024-04-03` to `2024-11-11` +- **mainnet**: `2024-04-03` to `2024-11-12` +- **holesky**: `2024-04-03` to `2024-11-12` +- **sepolia**: `2024-04-03` to `2024-11-12` ### Examples diff --git a/schema/canonical_beacon_.md b/schema/canonical_beacon_.md index d432697..7f618fb 100644 --- a/schema/canonical_beacon_.md +++ b/schema/canonical_beacon_.md @@ -32,9 +32,9 @@ Contains beacon block from a beacon node. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-20` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` ### Examples @@ -149,9 +149,9 @@ Contains canonical beacon API /eth/v1/beacon/committees data. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-20` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` ### Examples @@ -246,8 +246,8 @@ Contains attester slashing from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` - **sepolia**: `2022-06-22` to `null` ### Examples @@ -361,8 +361,8 @@ Contains proposer slashing from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` - **sepolia**: `2022-06-22` to `null` ### Examples @@ -470,9 +470,9 @@ Contains bls to execution change from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-04-12` to `2024-11-11` -- **holesky**: `2023-09-28` to `2024-11-11` -- **sepolia**: `2022-06-22` to `2024-11-11` +- **mainnet**: `2023-04-12` to `2024-11-12` +- **holesky**: `2023-09-28` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` ### Examples @@ -571,9 +571,9 @@ Contains execution transaction from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2022-09-06` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-22` to `2024-11-11` +- **mainnet**: `2022-09-06` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` ### Examples @@ -686,9 +686,9 @@ Contains a voluntary exit from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-22` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` ### Examples @@ -786,9 +786,9 @@ Contains a deposit from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-22` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` ### Examples @@ -888,9 +888,9 @@ Contains a withdrawal from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2023-04-12` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2023-02-28` to `2024-11-11` +- **mainnet**: `2023-04-12` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2023-02-28` to `2024-11-12` ### Examples @@ -989,9 +989,9 @@ Contains a blob sidecar from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-03-13` to `2024-11-11` -- **holesky**: `2024-02-07` to `2024-11-11` -- **sepolia**: `2024-01-30` to `2024-11-11` +- **mainnet**: `2024-03-13` to `2024-11-12` +- **holesky**: `2024-02-07` to `2024-11-12` +- **sepolia**: `2024-01-30` to `2024-11-12` ### Examples @@ -1093,9 +1093,9 @@ Contains a proposer duty from a beacon block. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-20` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-20` to `2024-11-12` ### Examples @@ -1190,9 +1190,9 @@ Contains elaborated attestations from beacon blocks. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` -- **sepolia**: `2022-06-22` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` +- **sepolia**: `2022-06-22` to `2024-11-12` ### Examples @@ -1300,8 +1300,8 @@ Contains a validator state for an epoch. ### Availability Data is partitioned **hourly** on **epoch_start_date_time** for the following networks: -- **mainnet**: `2020-12-01` to `2024-11-11` -- **holesky**: `2023-09-23` to `2024-11-11` +- **mainnet**: `2020-12-01` to `2024-11-12` +- **holesky**: `2023-09-23` to `2024-11-12` - **sepolia**: `2022-06-22` to `2024-11-11` ### Examples diff --git a/schema/canonical_execution_.md b/schema/canonical_execution_.md index e19829e..0215ec7 100644 --- a/schema/canonical_execution_.md +++ b/schema/canonical_execution_.md @@ -35,9 +35,9 @@ Contains canonical execution block data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -126,9 +126,9 @@ Contains canonical execution transaction data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -227,9 +227,9 @@ Contains canonical execution traces data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -330,9 +330,9 @@ Contains canonical execution logs data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -424,9 +424,9 @@ Contains canonical execution contract data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -525,7 +525,7 @@ Data is partitioned in chunks of **1000** on **block_number** for the following - **mainnet**: `0` to `21029000` - **holesky**: `0` to `2401000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -612,9 +612,9 @@ Contains canonical execution address appearance data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -700,9 +700,9 @@ Contains canonical execution balance diff data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -795,7 +795,7 @@ Data is partitioned in chunks of **1000** on **block_number** for the following - **mainnet**: `0` to `21029000` - **holesky**: `0` to `2401000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -882,9 +882,9 @@ Contains canonical execution erc20 transfer data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -974,9 +974,9 @@ Contains canonical execution erc721 transfer data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -1066,9 +1066,9 @@ Contains canonical execution native transfer data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -1157,9 +1157,9 @@ Contains canonical execution nonce diff data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -1252,7 +1252,7 @@ Data is partitioned in chunks of **1000** on **block_number** for the following - **mainnet**: `0` to `21029000` - **holesky**: `0` to `2401000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -1339,9 +1339,9 @@ Contains canonical execution storage diffs data. ### Availability Data is partitioned in chunks of **1000** on **block_number** for the following networks: -- **mainnet**: `0` to `21167000` +- **mainnet**: `0` to `21174000` - **holesky**: `0` to `2669000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples @@ -1434,7 +1434,7 @@ Contains canonical execution storage reads data. Data is partitioned in chunks of **1000** on **block_number** for the following networks: - **holesky**: `0` to `2401000` -- **sepolia**: `0` to `7058000` +- **sepolia**: `0` to `7064000` ### Examples diff --git a/schema/libp2p_.md b/schema/libp2p_.md index af5884d..deaaf43 100644 --- a/schema/libp2p_.md +++ b/schema/libp2p_.md @@ -22,9 +22,9 @@ Table for libp2p gossipsub beacon attestation data. ### Availability Data is partitioned **hourly** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-05-01` to `2024-11-11` -- **holesky**: `2024-05-01` to `2024-11-11` -- **sepolia**: `2024-05-01` to `2024-11-11` +- **mainnet**: `2024-05-01` to `2024-11-12` +- **holesky**: `2024-05-01` to `2024-11-12` +- **sepolia**: `2024-05-01` to `2024-11-12` ### Examples @@ -136,9 +136,9 @@ Table for libp2p gossipsub beacon block data. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-04-26` to `2024-11-11` -- **holesky**: `2024-04-26` to `2024-11-11` -- **sepolia**: `2024-04-26` to `2024-11-11` +- **mainnet**: `2024-04-26` to `2024-11-12` +- **holesky**: `2024-04-26` to `2024-11-12` +- **sepolia**: `2024-04-26` to `2024-11-12` ### Examples @@ -241,9 +241,9 @@ Table for libp2p gossipsub blob sidecar data ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-06-04` to `2024-11-11` -- **holesky**: `2024-06-04` to `2024-11-11` -- **sepolia**: `2024-06-04` to `2024-11-11` +- **mainnet**: `2024-06-04` to `2024-11-12` +- **holesky**: `2024-06-04` to `2024-11-12` +- **sepolia**: `2024-06-04` to `2024-11-12` ### Examples diff --git a/schema/mempool_.md b/schema/mempool_.md index d1f48c2..35d6881 100644 --- a/schema/mempool_.md +++ b/schema/mempool_.md @@ -20,9 +20,9 @@ Each row represents a transaction that was seen in the mempool by a sentry clien ### Availability Data is partitioned **daily** on **event_date_time** for the following networks: -- **mainnet**: `2023-07-22` to `2024-11-11` -- **holesky**: `2024-01-08` to `2024-11-11` -- **sepolia**: `2024-01-08` to `2024-11-11` +- **mainnet**: `2023-07-22` to `2024-11-12` +- **holesky**: `2024-01-08` to `2024-11-12` +- **sepolia**: `2024-01-08` to `2024-11-12` ### Examples diff --git a/schema/mev_relay_.md b/schema/mev_relay_.md index 9250419..a452cb2 100644 --- a/schema/mev_relay_.md +++ b/schema/mev_relay_.md @@ -21,9 +21,9 @@ Contains MEV relay block bids data. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-09-16` to `2024-11-11` -- **holesky**: `2024-09-16` to `2024-11-11` -- **sepolia**: `2024-09-16` to `2024-11-11` +- **mainnet**: `2024-09-16` to `2024-11-12` +- **holesky**: `2024-09-16` to `2024-11-12` +- **sepolia**: `2024-09-16` to `2024-11-12` ### Examples @@ -131,9 +131,9 @@ Contains MEV relay proposer payload delivered data. ### Availability Data is partitioned **daily** on **slot_start_date_time** for the following networks: -- **mainnet**: `2024-09-16` to `2024-11-11` -- **holesky**: `2024-09-16` to `2024-11-11` -- **sepolia**: `2024-09-16` to `2024-11-11` +- **mainnet**: `2024-09-16` to `2024-11-12` +- **holesky**: `2024-09-16` to `2024-11-12` +- **sepolia**: `2024-09-16` to `2024-11-12` ### Examples