Skip to content

Commit 999fb1b

Browse files
committed
Update schema
1 parent ba3c1d8 commit 999fb1b

66 files changed

Lines changed: 1064 additions & 1054 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

schema/beacon_api_.md

Lines changed: 57 additions & 57 deletions
Large diffs are not rendered by default.

schema/canonical_beacon_.md

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -27,14 +27,14 @@ Events derived from the finalized beacon chain. This data is only derived by a s
2727
<!-- schema_start -->
2828
## canonical_beacon_block
2929

30-
Contains beacon block from a beacon node.
30+
Contains finalized beacon block data. Each row represents a canonical block. Partition: monthly by `slot_start_date_time`.
3131

3232
### Availability
3333
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
3434

35-
- **mainnet**: `2020-12-01` to `2026-01-31`
35+
- **mainnet**: `2020-12-01` to `2026-02-01`
3636
- **holesky**: `2023-09-23` to `2025-10-26`
37-
- **sepolia**: `2022-06-20` to `2026-01-31`
37+
- **sepolia**: `2022-06-20` to `2026-02-01`
3838

3939
### Examples
4040

@@ -46,7 +46,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
4646
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
4747
SELECT
4848
*
49-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block/2026/1/31.parquet', 'Parquet')
49+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block/2026/2/1.parquet', 'Parquet')
5050
LIMIT 10
5151
FORMAT Pretty
5252
"""
@@ -144,14 +144,14 @@ echo """
144144

145145
## canonical_beacon_committee
146146

147-
Contains canonical beacon API /eth/v1/beacon/committees data.
147+
Contains finalized beacon committee assignments. Each row represents a committee with its validator indices for a given slot. Partition: monthly by `slot_start_date_time`.
148148

149149
### Availability
150150
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
151151

152-
- **mainnet**: `2020-12-01` to `2026-01-31`
152+
- **mainnet**: `2020-12-01` to `2026-02-01`
153153
- **holesky**: `2023-09-23` to `2025-10-26`
154-
- **sepolia**: `2022-06-20` to `2026-01-31`
154+
- **sepolia**: `2022-06-20` to `2026-02-01`
155155

156156
### Examples
157157

@@ -163,7 +163,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
163163
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
164164
SELECT
165165
*
166-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_committee/2026/1/31.parquet', 'Parquet')
166+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_committee/2026/2/1.parquet', 'Parquet')
167167
LIMIT 10
168168
FORMAT Pretty
169169
"""
@@ -241,7 +241,7 @@ echo """
241241

242242
## canonical_beacon_block_attester_slashing
243243

244-
Contains attester slashing from a beacon block.
244+
Contains attester slashings from finalized beacon blocks. Each row represents two conflicting attestations from a slashed validator. Partition: monthly by `slot_start_date_time`.
245245

246246
### Availability
247247
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
@@ -470,7 +470,7 @@ Contains bls to execution change from a beacon block.
470470
### Availability
471471
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
472472

473-
- **mainnet**: `2023-04-12` to `2026-01-31`
473+
- **mainnet**: `2023-04-12` to `2026-02-01`
474474
- **holesky**: `2023-09-28` to `2025-05-09`
475475
- **sepolia**: `2022-06-22` to `2025-05-16`
476476

@@ -484,7 +484,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
484484
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
485485
SELECT
486486
*
487-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_bls_to_execution_change/2026/1/31.parquet', 'Parquet')
487+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_bls_to_execution_change/2026/2/1.parquet', 'Parquet')
488488
LIMIT 10
489489
FORMAT Pretty
490490
"""
@@ -566,14 +566,14 @@ echo """
566566

567567
## canonical_beacon_block_execution_transaction
568568

569-
Contains execution transaction from a beacon block.
569+
Contains execution layer transactions from finalized beacon blocks. Each row represents a transaction from the execution payload. Partition: monthly by `slot_start_date_time`.
570570

571571
### Availability
572572
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
573573

574-
- **mainnet**: `2022-09-06` to `2026-01-31`
574+
- **mainnet**: `2022-09-06` to `2026-02-01`
575575
- **holesky**: `2023-09-23` to `2025-10-26`
576-
- **sepolia**: `2022-06-22` to `2026-01-31`
576+
- **sepolia**: `2022-06-22` to `2026-02-01`
577577

578578
### Examples
579579

@@ -585,7 +585,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
585585
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
586586
SELECT
587587
*
588-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_execution_transaction/2026/1/31.parquet', 'Parquet')
588+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_execution_transaction/2026/2/1.parquet', 'Parquet')
589589
LIMIT 10
590590
FORMAT Pretty
591591
"""
@@ -681,12 +681,12 @@ echo """
681681

682682
## canonical_beacon_block_voluntary_exit
683683

684-
Contains a voluntary exit from a beacon block.
684+
Contains voluntary exits from finalized beacon blocks. Each row represents a validator initiating an exit. Partition: monthly by `slot_start_date_time`.
685685

686686
### Availability
687687
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
688688

689-
- **mainnet**: `2020-12-01` to `2026-01-31`
689+
- **mainnet**: `2020-12-01` to `2026-02-01`
690690
- **holesky**: `2023-09-23` to `2025-08-06`
691691
- **sepolia**: `2022-06-22` to `2025-10-22`
692692

@@ -700,7 +700,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
700700
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
701701
SELECT
702702
*
703-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_voluntary_exit/2026/1/31.parquet', 'Parquet')
703+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_voluntary_exit/2026/2/1.parquet', 'Parquet')
704704
LIMIT 10
705705
FORMAT Pretty
706706
"""
@@ -883,14 +883,14 @@ echo """
883883

884884
## canonical_beacon_block_withdrawal
885885

886-
Contains a withdrawal from a beacon block.
886+
Contains withdrawals from finalized beacon blocks. Each row represents a validator withdrawal with recipient address and amount. Partition: monthly by `slot_start_date_time`.
887887

888888
### Availability
889889
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
890890

891-
- **mainnet**: `2023-04-12` to `2026-01-31`
891+
- **mainnet**: `2023-04-12` to `2026-02-01`
892892
- **holesky**: `2023-09-23` to `2025-10-26`
893-
- **sepolia**: `2023-02-28` to `2026-01-31`
893+
- **sepolia**: `2023-02-28` to `2026-02-01`
894894

895895
### Examples
896896

@@ -902,7 +902,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
902902
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
903903
SELECT
904904
*
905-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_withdrawal/2026/1/31.parquet', 'Parquet')
905+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_block_withdrawal/2026/2/1.parquet', 'Parquet')
906906
LIMIT 10
907907
FORMAT Pretty
908908
"""
@@ -984,14 +984,14 @@ echo """
984984

985985
## canonical_beacon_blob_sidecar
986986

987-
Contains blob sidecars from finalized beacon blocks. Each row represents a blob with its KZG commitment, proof, and versioned hash. Partition: monthly by `slot_start_date_time`.
987+
Contains a blob sidecar from a beacon block.
988988

989989
### Availability
990990
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
991991

992-
- **mainnet**: `2024-03-13` to `2026-01-31`
992+
- **mainnet**: `2024-03-13` to `2026-02-01`
993993
- **holesky**: `2024-02-07` to `2025-10-15`
994-
- **sepolia**: `2024-01-30` to `2026-01-31`
994+
- **sepolia**: `2024-01-30` to `2026-02-01`
995995

996996
### Examples
997997

@@ -1003,7 +1003,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
10031003
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
10041004
SELECT
10051005
*
1006-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_blob_sidecar/2026/1/31.parquet', 'Parquet')
1006+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_blob_sidecar/2026/2/1.parquet', 'Parquet')
10071007
LIMIT 10
10081008
FORMAT Pretty
10091009
"""
@@ -1088,14 +1088,14 @@ echo """
10881088

10891089
## canonical_beacon_proposer_duty
10901090

1091-
Contains a proposer duty from a beacon block.
1091+
Contains finalized proposer duty assignments. Each row represents which validator was scheduled to propose a block for a given slot. Partition: monthly by `slot_start_date_time`.
10921092

10931093
### Availability
10941094
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
10951095

1096-
- **mainnet**: `2020-12-01` to `2026-01-31`
1096+
- **mainnet**: `2020-12-01` to `2026-02-01`
10971097
- **holesky**: `2023-09-23` to `2025-10-26`
1098-
- **sepolia**: `2022-06-20` to `2026-01-31`
1098+
- **sepolia**: `2022-06-20` to `2026-02-01`
10991099

11001100
### Examples
11011101

@@ -1107,7 +1107,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
11071107
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
11081108
SELECT
11091109
*
1110-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_proposer_duty/2026/1/31.parquet', 'Parquet')
1110+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_proposer_duty/2026/2/1.parquet', 'Parquet')
11111111
LIMIT 10
11121112
FORMAT Pretty
11131113
"""
@@ -1185,14 +1185,14 @@ echo """
11851185

11861186
## canonical_beacon_elaborated_attestation
11871187

1188-
Contains elaborated attestations from beacon blocks.
1188+
Contains elaborated attestations from finalized beacon blocks. Aggregation bits are expanded to actual validator indices. Each row represents an attestation with its participating validators, source/target checkpoints, and position in the block. Partition: monthly by `slot_start_date_time`.
11891189

11901190
### Availability
11911191
Data is partitioned **daily** on **slot_start_date_time** for the following networks:
11921192

1193-
- **mainnet**: `2020-12-01` to `2026-01-31`
1193+
- **mainnet**: `2020-12-01` to `2026-02-01`
11941194
- **holesky**: `2023-09-23` to `2025-10-26`
1195-
- **sepolia**: `2022-06-20` to `2026-01-31`
1195+
- **sepolia**: `2022-06-20` to `2026-02-01`
11961196

11971197
### Examples
11981198

@@ -1204,7 +1204,7 @@ Data is partitioned **daily** on **slot_start_date_time** for the following netw
12041204
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
12051205
SELECT
12061206
*
1207-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_elaborated_attestation/2026/1/31.parquet', 'Parquet')
1207+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_elaborated_attestation/2026/2/1.parquet', 'Parquet')
12081208
LIMIT 10
12091209
FORMAT Pretty
12101210
"""
@@ -1300,7 +1300,7 @@ Contains finalized validator state snapshots. Each row represents a validator\'s
13001300
### Availability
13011301
Data is partitioned **hourly** on **epoch_start_date_time** for the following networks:
13021302

1303-
- **mainnet**: `2020-12-01` to `2026-01-31`
1303+
- **mainnet**: `2020-12-01` to `2026-02-01`
13041304
- **holesky**: `2023-09-23` to `2025-10-26`
13051305
- **sepolia**: `2022-06-20` to `2026-01-31`
13061306

@@ -1314,7 +1314,7 @@ Data is partitioned **hourly** on **epoch_start_date_time** for the following ne
13141314
docker run --rm -it clickhouse/clickhouse-server clickhouse local --query --query="""
13151315
SELECT
13161316
*
1317-
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_validators/2026/1/31/0.parquet', 'Parquet')
1317+
FROM url('https://data.ethpandaops.io/xatu/mainnet/databases/default/canonical_beacon_validators/2026/2/1/0.parquet', 'Parquet')
13181318
LIMIT 10
13191319
FORMAT Pretty
13201320
"""
@@ -1397,15 +1397,15 @@ echo """
13971397

13981398
## canonical_beacon_validators_pubkeys
13991399

1400-
1400+
Contains a validator state for an epoch.
14011401

14021402

14031403
> A new parquet file is only created once there is 50 new validator index's assigned and finalized. Also available in chunks of 10,000.
14041404
14051405
### Availability
14061406
Data is partitioned in chunks of **50** on **index** for the following networks:
14071407

1408-
- **mainnet**: `0` to `2202000`
1408+
- **mainnet**: `0` to `2202250`
14091409
- **holesky**: `0` to `1923800`
14101410
- **sepolia**: `0` to `1900`
14111411

0 commit comments

Comments
 (0)