@aztec/stdlib 4.0.0-nightly.20250907 → 4.0.0-nightly.20260108

package/dest/block/l2_block_source.d.ts

@@ -1,15 +1,19 @@
+import { BlockNumber, CheckpointNumber, type EpochNumber, type SlotNumber } from '@aztec/foundation/branded-types';
+import type { Fr } from '@aztec/foundation/curves/bn254';
 import type { EthAddress } from '@aztec/foundation/eth-address';
-import { type ZodFor } from '@aztec/foundation/schemas';
 import type { TypedEventEmitter } from '@aztec/foundation/types';
 import { z } from 'zod';
+import type { Checkpoint } from '../checkpoint/checkpoint.js';
+import type { PublishedCheckpoint } from '../checkpoint/published_checkpoint.js';
 import type { L1RollupConstants } from '../epoch-helpers/index.js';
-import { BlockAttestation } from '../p2p/block_attestation.js';
 import type { BlockHeader } from '../tx/block_header.js';
 import type { IndexedTxEffect } from '../tx/indexed_tx_effect.js';
 import type { TxHash } from '../tx/tx_hash.js';
 import type { TxReceipt } from '../tx/tx_receipt.js';
+import { type CheckpointedL2Block, PublishedL2Block } from './checkpointed_l2_block.js';
 import type { L2Block } from './l2_block.js';
-import { PublishedL2Block } from './published_l2_block.js';
+import type { L2BlockNew } from './l2_block_new.js';
+import type { ValidateBlockNegativeResult, ValidateBlockResult } from './validate_block_result.js';
 /**
  * Interface of classes allowing for the retrieval of L2 blocks.
  */
@@ -28,34 +32,55 @@ export interface L2BlockSource {
      * Gets the number of the latest L2 block processed by the block source implementation.
      * @returns The number of the latest L2 block processed by the block source implementation.
      */
-    getBlockNumber(): Promise<number>;
+    getBlockNumber(): Promise<BlockNumber>;
     /**
      * Gets the number of the latest L2 block proven seen by the block source implementation.
      * @returns The number of the latest L2 block proven seen by the block source implementation.
      */
-    getProvenBlockNumber(): Promise<number>;
-    /**
-     * Gets an l2 block. If a negative number is passed, the block returned is the most recent.
-     * @param number - The block number to return (inclusive).
-     * @returns The requested L2 block.
-     */
-    getBlock(number: number): Promise<L2Block | undefined>;
+    getProvenBlockNumber(): Promise<BlockNumber>;
     /**
      * Gets an l2 block header.
      * @param number - The block number to return or 'latest' for the most recent one.
      * @returns The requested L2 block header.
      */
-    getBlockHeader(number: number | 'latest'): Promise<BlockHeader | undefined>;
+    getBlockHeader(number: BlockNumber | 'latest'): Promise<BlockHeader | undefined>;
     /**
-     * Gets up to `limit` amount of L2 blocks starting from `from`.
-     * @param from - Number of the first block to return (inclusive).
-     * @param limit - The maximum number of blocks to return.
-     * @param proven - If true, only return blocks that have been proven.
-     * @returns The requested L2 blocks.
+     * Gets a checkpointed L2 block by block number.
+     * Returns undefined if the block doesn't exist or hasn't been checkpointed yet.
+     * @param number - The block number to retrieve.
+     * @returns The requested checkpointed L2 block (or undefined if not found or not checkpointed).
      */
-    getBlocks(from: number, limit: number, proven?: boolean): Promise<L2Block[]>;
-    /** Equivalent to getBlocks but includes publish data. */
-    getPublishedBlocks(from: number, limit: number, proven?: boolean): Promise<PublishedL2Block[]>;
+    getCheckpointedBlock(number: BlockNumber): Promise<CheckpointedL2Block | undefined>;
+    /**
+     * Retrieves a collection of published checkpoints
+     * @param checkpointNumber The first checkpoint to be retrieved
+     * @param limit The number of checkpoints to be retrieved
+     * @returns The collection of complete checkpoints
+     */
+    getPublishedCheckpoints(checkpointNumber: CheckpointNumber, limit: number): Promise<PublishedCheckpoint[]>;
+    /**
+     * Gets the checkpoints for a given epoch
+     * @param epochNumber - Epoch for which we want checkpoint data
+     */
+    getCheckpointsForEpoch(epochNumber: EpochNumber): Promise<Checkpoint[]>;
+    /**
+     * Gets a block header by its hash.
+     * @param blockHash - The block hash to retrieve.
+     * @returns The requested block header (or undefined if not found).
+     */
+    getBlockHeaderByHash(blockHash: Fr): Promise<BlockHeader | undefined>;
+    /**
+     * Gets a block header by its archive root.
+     * @param archive - The archive root to retrieve.
+     * @returns The requested block header (or undefined if not found).
+     */
+    getBlockHeaderByArchive(archive: Fr): Promise<BlockHeader | undefined>;
+    /**
+     * Gets an L2 block by block number.
+     * @param number - The block number to return.
+     * @returns The requested L2 block (or undefined if not found).
+     */
+    getL2BlockNew(number: BlockNumber): Promise<L2BlockNew | undefined>;
     /**
      * Gets a tx effect.
      * @param txHash - The hash of the tx corresponding to the tx effect.
@@ -69,30 +94,24 @@ export interface L2BlockSource {
      */
     getSettledTxReceipt(txHash: TxHash): Promise<TxReceipt | undefined>;
     /**
-     * Returns the current L2 slot number based on the current L1 timestamp.
-     */
-    getL2SlotNumber(): Promise<bigint>;
-    /**
-     * Returns the current L2 epoch number based on the current L1 timestamp.
+     * Returns the current L2 slot number based on the currently synced L1 timestamp.
      */
-    getL2EpochNumber(): Promise<bigint>;
+    getL2SlotNumber(): Promise<SlotNumber | undefined>;
     /**
-     * Returns all blocks for a given epoch.
-     * @dev Use this method only with recent epochs, since it walks the block list backwards.
-     * @param epochNumber - The epoch number to return blocks for.
+     * Returns the current L2 epoch number based on the currently synced L1 timestamp.
      */
-    getBlocksForEpoch(epochNumber: bigint): Promise<L2Block[]>;
+    getL2EpochNumber(): Promise<EpochNumber | undefined>;
     /**
      * Returns all block headers for a given epoch.
      * @dev Use this method only with recent epochs, since it walks the block list backwards.
      * @param epochNumber - The epoch number to return headers for.
      */
-    getBlockHeadersForEpoch(epochNumber: bigint): Promise<BlockHeader[]>;
+    getBlockHeadersForEpoch(epochNumber: EpochNumber): Promise<BlockHeader[]>;
     /**
      * Returns whether the given epoch is completed on L1, based on the current L1 and L2 block numbers.
      * @param epochNumber - The epoch number to check.
      */
-    isEpochComplete(epochNumber: bigint): Promise<boolean>;
+    isEpochComplete(epochNumber: EpochNumber): Promise<boolean>;
     /**
      * Returns the tips of the L2 chain.
      */
@@ -101,8 +120,12 @@ export interface L2BlockSource {
      * Returns the rollup constants for the current chain.
      */
     getL1Constants(): Promise<L1RollupConstants>;
+    /** Returns values for the genesis block */
+    getGenesisValues(): Promise<{
+        genesisArchiveRoot: Fr;
+    }>;
     /** Latest synced L1 timestamp. */
-    getL1Timestamp(): Promise<bigint>;
+    getL1Timestamp(): Promise<bigint | undefined>;
     /**
      * Returns whether the latest block in the pending chain on L1 is invalid (ie its attestations are incorrect).
      * Note that invalid blocks do not get synced, so the latest block returned by the block source is always a valid one.
@@ -115,433 +138,53 @@ export interface L2BlockSource {
     getPendingChainValidationStatus(): Promise<ValidateBlockResult>;
     /** Force a sync. */
     syncImmediate(): Promise<void>;
+    /**
+     * Gets an l2 block. If a negative number is passed, the block returned is the most recent.
+     * @param number - The block number to return (inclusive).
+     * @returns The requested L2 block.
+     * @deprecated Use getL2BlockNew instead.
+     */
+    getBlock(number: BlockNumber): Promise<L2Block | undefined>;
+    /**
+     * Returns all blocks for a given epoch.
+     * @dev Use this method only with recent epochs, since it walks the block list backwards.
+     * @param epochNumber - The epoch number to return blocks for.
+     */
+    getBlocksForEpoch(epochNumber: EpochNumber): Promise<L2Block[]>;
+    /**
+     * Gets a published block by its block hash.
+     * @param blockHash - The block hash to retrieve.
+     * @returns The requested block (or undefined if not found).
+     */
+    getPublishedBlockByHash(blockHash: Fr): Promise<PublishedL2Block | undefined>;
+    /**
+     * Gets a published block by its archive root.
+     * @param archive - The archive root to retrieve.
+     * @returns The requested block (or undefined if not found).
+     */
+    getPublishedBlockByArchive(archive: Fr): Promise<PublishedL2Block | undefined>;
+    /**
+     * Gets up to `limit` amount of L2 blocks starting from `from`.
+     * @param from - Number of the first block to return (inclusive).
+     * @param limit - The maximum number of blocks to return.
+     * @param proven - If true, only return blocks that have been proven.
+     * @returns The requested L2 blocks.
+     */
+    getBlocks(from: BlockNumber, limit: number, proven?: boolean): Promise<L2Block[]>;
+    /** Equivalent to getBlocks but includes publish data. */
+    getPublishedBlocks(from: BlockNumber, limit: number, proven?: boolean): Promise<PublishedL2Block[]>;
+}
+/**
+ * Interface for classes that can receive and store L2 blocks.
+ */
+export interface L2BlockSink {
+    /**
+     * Adds a block to the store.
+     * @param block - The L2 block to add.
+     * @throws If block number is not incremental (i.e., not exactly one more than the last stored block).
+     */
+    addBlock(block: L2BlockNew): Promise<void>;
 }
-/** Subtype for invalid block validation results */
-export type ValidateBlockNegativeResult = {
-    valid: false;
-    block: PublishedL2Block;
-    committee: EthAddress[];
-    epoch: bigint;
-    seed: bigint;
-    attestations: BlockAttestation[];
-    reason: 'insufficient-attestations';
-} | {
-    valid: false;
-    block: PublishedL2Block;
-    committee: EthAddress[];
-    epoch: bigint;
-    seed: bigint;
-    reason: 'invalid-attestation';
-    attestations: BlockAttestation[];
-    invalidIndex: number;
-};
-/** Result type for validating a block attestations */
-export type ValidateBlockResult = {
-    valid: true;
-} | ValidateBlockNegativeResult;
-export declare const ValidateBlockResultSchema: z.ZodUnion<[z.ZodObject<{
-    valid: z.ZodLiteral<true>;
-    block: z.ZodOptional<z.ZodObject<{
-        block: z.ZodEffects<z.ZodObject<{
-            archive: z.ZodEffects<z.ZodObject<{
-                root: z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>;
-                nextAvailableLeafIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                root: import("@aztec/foundation/schemas").Fr;
-                nextAvailableLeafIndex: number;
-            }, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>, import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>;
-            header: ZodFor<BlockHeader>;
-            body: ZodFor<import("./body.js").Body>;
-        }, "strip", z.ZodTypeAny, {
-            archive: import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot;
-            header: BlockHeader;
-            body: import("./body.js").Body;
-        }, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>, L2Block, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>;
-        l1: z.ZodObject<{
-            blockNumber: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            timestamp: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            blockHash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        }, {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        }>;
-        attestations: z.ZodArray<z.ZodEffects<z.ZodObject<{
-            address: z.ZodType<EthAddress, any, string>;
-            signature: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, `0x${string}`, string>, `0x${string}`, string>, import("./index.js").Signature, string>;
-        }, "strip", z.ZodTypeAny, {
-            address: EthAddress;
-            signature: import("./index.js").Signature;
-        }, {
-            address: string;
-            signature: string;
-        }>, import("./index.js").CommitteeAttestation, {
-            address: string;
-            signature: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    }, {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    valid: true;
-    block?: {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    } | undefined;
-}, {
-    valid: true;
-    block?: {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    } | undefined;
-}>, z.ZodObject<{
-    valid: z.ZodLiteral<false>;
-    block: z.ZodObject<{
-        block: z.ZodEffects<z.ZodObject<{
-            archive: z.ZodEffects<z.ZodObject<{
-                root: z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>;
-                nextAvailableLeafIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                root: import("@aztec/foundation/schemas").Fr;
-                nextAvailableLeafIndex: number;
-            }, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>, import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>;
-            header: ZodFor<BlockHeader>;
-            body: ZodFor<import("./body.js").Body>;
-        }, "strip", z.ZodTypeAny, {
-            archive: import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot;
-            header: BlockHeader;
-            body: import("./body.js").Body;
-        }, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>, L2Block, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>;
-        l1: z.ZodObject<{
-            blockNumber: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            timestamp: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            blockHash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        }, {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        }>;
-        attestations: z.ZodArray<z.ZodEffects<z.ZodObject<{
-            address: z.ZodType<EthAddress, any, string>;
-            signature: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, `0x${string}`, string>, `0x${string}`, string>, import("./index.js").Signature, string>;
-        }, "strip", z.ZodTypeAny, {
-            address: EthAddress;
-            signature: import("./index.js").Signature;
-        }, {
-            address: string;
-            signature: string;
-        }>, import("./index.js").CommitteeAttestation, {
-            address: string;
-            signature: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    }, {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    }>;
-    committee: z.ZodArray<z.ZodType<EthAddress, any, string>, "many">;
-    epoch: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-    seed: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-    attestations: z.ZodArray<ZodFor<BlockAttestation>, "many">;
-    reason: z.ZodLiteral<"insufficient-attestations">;
-}, "strip", z.ZodTypeAny, {
-    valid: false;
-    block: {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    };
-    attestations: BlockAttestation[];
-    committee: EthAddress[];
-    epoch: bigint;
-    seed: bigint;
-    reason: "insufficient-attestations";
-}, {
-    valid: false;
-    block: {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    };
-    attestations: any[];
-    committee: string[];
-    epoch: string | number | bigint;
-    seed: string | number | bigint;
-    reason: "insufficient-attestations";
-}>, z.ZodObject<{
-    valid: z.ZodLiteral<false>;
-    block: z.ZodObject<{
-        block: z.ZodEffects<z.ZodObject<{
-            archive: z.ZodEffects<z.ZodObject<{
-                root: z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>;
-                nextAvailableLeafIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
-            }, "strip", z.ZodTypeAny, {
-                root: import("@aztec/foundation/schemas").Fr;
-                nextAvailableLeafIndex: number;
-            }, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>, import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot, {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            }>;
-            header: ZodFor<BlockHeader>;
-            body: ZodFor<import("./body.js").Body>;
-        }, "strip", z.ZodTypeAny, {
-            archive: import("../trees/append_only_tree_snapshot.js").AppendOnlyTreeSnapshot;
-            header: BlockHeader;
-            body: import("./body.js").Body;
-        }, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>, L2Block, {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        }>;
-        l1: z.ZodObject<{
-            blockNumber: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            timestamp: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-            blockHash: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        }, {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        }>;
-        attestations: z.ZodArray<z.ZodEffects<z.ZodObject<{
-            address: z.ZodType<EthAddress, any, string>;
-            signature: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, `0x${string}`, string>, `0x${string}`, string>, import("./index.js").Signature, string>;
-        }, "strip", z.ZodTypeAny, {
-            address: EthAddress;
-            signature: import("./index.js").Signature;
-        }, {
-            address: string;
-            signature: string;
-        }>, import("./index.js").CommitteeAttestation, {
-            address: string;
-            signature: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    }, {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    }>;
-    committee: z.ZodArray<z.ZodType<EthAddress, any, string>, "many">;
-    epoch: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-    seed: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodBigInt>;
-    attestations: z.ZodArray<ZodFor<BlockAttestation>, "many">;
-    reason: z.ZodLiteral<"invalid-attestation">;
-    invalidIndex: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    valid: false;
-    block: {
-        block: L2Block;
-        l1: {
-            blockNumber: bigint;
-            timestamp: bigint;
-            blockHash: string;
-        };
-        attestations: import("./index.js").CommitteeAttestation[];
-    };
-    attestations: BlockAttestation[];
-    committee: EthAddress[];
-    epoch: bigint;
-    seed: bigint;
-    reason: "invalid-attestation";
-    invalidIndex: number;
-}, {
-    valid: false;
-    block: {
-        block: {
-            archive: {
-                root: string;
-                nextAvailableLeafIndex: string | number | bigint;
-            };
-            header?: any;
-            body?: any;
-        };
-        l1: {
-            blockNumber: string | number | bigint;
-            timestamp: string | number | bigint;
-            blockHash: string;
-        };
-        attestations: {
-            address: string;
-            signature: string;
-        }[];
-    };
-    attestations: any[];
-    committee: string[];
-    epoch: string | number | bigint;
-    seed: string | number | bigint;
-    reason: "invalid-attestation";
-    invalidIndex: number;
-}>]>;
 /**
  * L2BlockSource that emits events upon pending / proven chain changes.
  * see L2BlockSourceEvents for the events emitted.
@@ -563,128 +206,79 @@ export type L2BlockTag = 'latest' | 'proven' | 'finalized';
 /** Tips of the L2 chain. */
 export type L2Tips = Record<L2BlockTag, L2BlockId>;
 /** Identifies a block by number and hash. */
-export type L2BlockId = z.infer<typeof L2BlockIdSchema>;
-/** Creates an L2 block id */
-export declare function makeL2BlockId(number: number, hash?: string): L2BlockId;
-declare const L2BlockIdSchema: z.ZodUnion<[z.ZodObject<{
-    number: z.ZodLiteral<0>;
-    hash: z.ZodUndefined;
-}, "strip", z.ZodTypeAny, {
-    number: 0;
-    hash?: undefined;
-}, {
-    number: 0;
-    hash?: undefined;
-}>, z.ZodObject<{
-    number: z.ZodNumber;
-    hash: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    number: number;
-    hash: string;
-}, {
-    number: number;
+export type L2BlockId = {
+    number: BlockNumber;
     hash: string;
-}>]>;
+};
+/** Creates an L2 block id */
+export declare function makeL2BlockId(number: BlockNumber, hash?: string): L2BlockId;
 export declare const L2TipsSchema: z.ZodObject<{
-    latest: z.ZodUnion<[z.ZodObject<{
-        number: z.ZodLiteral<0>;
-        hash: z.ZodUndefined;
-    }, "strip", z.ZodTypeAny, {
-        number: 0;
-        hash?: undefined;
-    }, {
-        number: 0;
-        hash?: undefined;
-    }>, z.ZodObject<{
-        number: z.ZodNumber;
+    latest: z.ZodObject<{
+        number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
         hash: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     }, {
-        number: number;
+        number: string | number | bigint;
         hash: string;
-    }>]>;
-    proven: z.ZodUnion<[z.ZodObject<{
-        number: z.ZodLiteral<0>;
-        hash: z.ZodUndefined;
-    }, "strip", z.ZodTypeAny, {
-        number: 0;
-        hash?: undefined;
-    }, {
-        number: 0;
-        hash?: undefined;
-    }>, z.ZodObject<{
-        number: z.ZodNumber;
+    }>;
+    proven: z.ZodObject<{
+        number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
         hash: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     }, {
-        number: number;
+        number: string | number | bigint;
         hash: string;
-    }>]>;
-    finalized: z.ZodUnion<[z.ZodObject<{
-        number: z.ZodLiteral<0>;
-        hash: z.ZodUndefined;
-    }, "strip", z.ZodTypeAny, {
-        number: 0;
-        hash?: undefined;
-    }, {
-        number: 0;
-        hash?: undefined;
-    }>, z.ZodObject<{
-        number: z.ZodNumber;
+    }>;
+    finalized: z.ZodObject<{
+        number: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
         hash: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     }, {
-        number: number;
+        number: string | number | bigint;
         hash: string;
-    }>]>;
+    }>;
 }, "strip", z.ZodTypeAny, {
     latest: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     };
     proven: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     };
     finalized: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: number & {
+            _branding: "BlockNumber";
+        };
         hash: string;
     };
 }, {
     latest: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: string | number | bigint;
         hash: string;
     };
     proven: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: string | number | bigint;
         hash: string;
     };
     finalized: {
-        number: 0;
-        hash?: undefined;
-    } | {
-        number: number;
+        number: string | number | bigint;
         hash: string;
     };
 }>;
@@ -695,18 +289,17 @@ export declare enum L2BlockSourceEvents {
 }
 export type L2BlockProvenEvent = {
     type: 'l2BlockProven';
-    blockNumber: bigint;
-    slotNumber: bigint;
-    epochNumber: bigint;
+    blockNumber: BlockNumber;
+    slotNumber: SlotNumber;
+    epochNumber: EpochNumber;
 };
 export type L2BlockPruneEvent = {
     type: 'l2PruneDetected';
-    epochNumber: bigint;
+    epochNumber: EpochNumber;
     blocks: L2Block[];
 };
 export type InvalidBlockDetectedEvent = {
     type: 'invalidBlockDetected';
     validationResult: ValidateBlockNegativeResult;
 };
-export {};
-//# sourceMappingURL=l2_block_source.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfYmxvY2tfc291cmNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc291cmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxXQUFXLEVBRVgsZ0JBQWdCLEVBQ2hCLEtBQUssV0FBVyxFQUNoQixLQUFLLFVBQVUsRUFDaEIsTUFBTSxpQ0FBaUMsQ0FBQztBQUN6QyxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRWpFLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDOUQsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUNqRixPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ25FLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ2xFLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQy9DLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3JELE9BQU8sRUFBRSxLQUFLLG1CQUFtQixFQUFFLGdCQUFnQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDeEYsT0FBTyxLQUFLLEVBQUUsT0FBTyxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQzdDLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLG1CQUFtQixDQUFD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