@aztec/archiver 0.0.1-commit.d3ec352c → 0.0.1-commit.e3c1de76

package/dest/config.d.ts

@@ -0,0 +1,30 @@
+import { type BlobClientConfig } from '@aztec/blob-client/client/config';
+import { type L1ContractsConfig } from '@aztec/ethereum/config';
+import { type L1ReaderConfig } from '@aztec/ethereum/l1-reader';
+import { type ConfigMappingsType } from '@aztec/foundation/config';
+import { type ChainConfig } from '@aztec/stdlib/config';
+import type { ArchiverSpecificConfig } from '@aztec/stdlib/interfaces/server';
+/**
+ * The archiver configuration.
+ * There are 2 polling intervals used in this configuration. The first is the archiver polling interval, archiverPollingIntervalMS.
+ * This is the interval between successive calls to eth_blockNumber via viem.
+ * Results of calls to eth_blockNumber are cached by viem with this cache being updated periodically at the interval specified by viemPollingIntervalMS.
+ * As a result the maximum observed polling time for new blocks will be viemPollingIntervalMS + archiverPollingIntervalMS.
+ */
+export type ArchiverConfig = ArchiverSpecificConfig & L1ReaderConfig & L1ContractsConfig & BlobClientConfig & ChainConfig;
+export declare const archiverConfigMappings: ConfigMappingsType<ArchiverConfig>;
+/**
+ * Returns the archiver configuration from the environment variables.
+ * Note: If an environment variable is not set, the default value is used.
+ * @returns The archiver configuration.
+ */
+export declare function getArchiverConfigFromEnv(): ArchiverConfig;
+/** Extracts the archiver-specific configuration from the full ArchiverConfig */
+export declare function mapArchiverConfig(config: Partial<ArchiverConfig>): {
+    pollingIntervalMs: number | undefined;
+    batchSize: number | undefined;
+    skipValidateCheckpointAttestations: boolean | undefined;
+    maxAllowedEthClientDriftSeconds: number | undefined;
+    ethereumAllowNoDebugHosts: boolean | undefined;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUEyQixNQUFNLGtDQUFrQyxDQUFDO0FBQ2xHLE9BQU8sRUFBRSxLQUFLLGlCQUFpQixFQUE2QixNQUFNLHdCQUF3QixDQUFDO0FBRTNGLE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBMEIsTUFBTSwyQkFBMkIsQ0FBQztBQUN4RixPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFJeEIsTUFBTSwwQkFBMEIsQ0FBQztBQUNsQyxPQUFPLEVBQUUsS0FBSyxXQUFXLEVBQXVCLE1BQU0sc0JBQXNCLENBQUM7QUFDN0UsT0FBTyxLQUFLLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUU5RTs7Ozs7O0dBTUc7QUFDSCxNQUFNLE1BQU0sY0FBYyxHQUFHLHNCQUFzQixHQUNqRCxjQUFjLEdBQ2QsaUJBQWlCLEdBQ2pCLGdCQUFnQixHQUNoQixXQUFXLENBQUM7QUFFZCxlQUFPLE1BQU0sc0JBQXNCLEVBQUUsa0JBQWtCLENBQUMsY0FBYyxDQWdEckUsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCx3QkFBZ0Isd0JBQXdCLElBQUksY0FBYyxDQUV6RDtBQUVELGdGQUFnRjtBQUNoRix3QkFBZ0IsaUJBQWlCLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxjQUFjLENBQUM7Ozs7OztFQVFoRSJ9

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,KAAK,iBAAiB,EAA6B,MAAM,wBAAwB,CAAC;AAE3F,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,2BAA2B,CAAC;AACxF,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,GACjD,cAAc,GACd,iBAAiB,GACjB,gBAAgB,GAChB,WAAW,CAAC;AAEd,eAAO,MAAM,sBAAsB,EAAE,kBAAkB,CAAC,cAAc,CAgDrE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC;;;;;;EAQhE"}

package/dest/{archiver/config.js → config.js}

@@ -1,9 +1,11 @@
-import { blobSinkConfigMapping } from '@aztec/blob-sink/client';
-import { l1ContractAddressesMapping, l1ContractsConfigMappings, l1ReaderConfigMappings } from '@aztec/ethereum';
+import { blobClientConfigMapping } from '@aztec/blob-client/client/config';
+import { l1ContractsConfigMappings } from '@aztec/ethereum/config';
+import { l1ContractAddressesMapping } from '@aztec/ethereum/l1-contract-addresses';
+import { l1ReaderConfigMappings } from '@aztec/ethereum/l1-reader';
 import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
 import { chainConfigMappings } from '@aztec/stdlib/config';
 export const archiverConfigMappings = {
-    ...blobSinkConfigMapping,
+    ...blobClientConfigMapping,
     archiverPollingIntervalMS: {
         env: 'ARCHIVER_POLLING_INTERVAL_MS',
         description: 'The polling interval in ms for retrieving new L2 blocks and encrypted logs.',
@@ -24,8 +26,8 @@ export const archiverConfigMappings = {
         parseEnv: (val)=>val ? +val : undefined,
         description: 'The maximum possible size of the archiver DB in KB. Overwrites the general dataStoreMapSizeKb.'
     },
-    skipValidateBlockAttestations: {
-        description: 'Whether to skip validating block attestations (use only for testing).',
+    skipValidateCheckpointAttestations: {
+        description: 'Skip validating checkpoint attestations (for testing purposes only)',
         ...booleanConfigHelper(false)
     },
     maxAllowedEthClientDriftSeconds: {
@@ -33,6 +35,11 @@ export const archiverConfigMappings = {
         description: 'Maximum allowed drift in seconds between the Ethereum client and current time.',
         ...numberConfigHelper(300)
     },
+    ethereumAllowNoDebugHosts: {
+        env: 'ETHEREUM_ALLOW_NO_DEBUG_HOSTS',
+        description: 'Whether to allow starting the archiver without debug/trace method support on Ethereum hosts',
+        ...booleanConfigHelper(true)
+    },
     ...chainConfigMappings,
     ...l1ReaderConfigMappings,
     viemPollingIntervalMS: {
@@ -53,3 +60,12 @@ export const archiverConfigMappings = {
  */ export function getArchiverConfigFromEnv() {
     return getConfigFromMappings(archiverConfigMappings);
 }
+/** Extracts the archiver-specific configuration from the full ArchiverConfig */ export function mapArchiverConfig(config) {
+    return {
+        pollingIntervalMs: config.archiverPollingIntervalMS,
+        batchSize: config.archiverBatchSize,
+        skipValidateCheckpointAttestations: config.skipValidateCheckpointAttestations,
+        maxAllowedEthClientDriftSeconds: config.maxAllowedEthClientDriftSeconds,
+        ethereumAllowNoDebugHosts: config.ethereumAllowNoDebugHosts
+    };
+}

package/dest/errors.d.ts

@@ -0,0 +1,41 @@
+import type { Fr } from '@aztec/foundation/schemas';
+export declare class NoBlobBodiesFoundError extends Error {
+    constructor(l2BlockNum: number);
+}
+export declare class InitialBlockNumberNotSequentialError extends Error {
+    readonly newBlockNumber: number;
+    readonly previousBlockNumber: number | undefined;
+    constructor(newBlockNumber: number, previousBlockNumber: number | undefined);
+}
+export declare class BlockNumberNotSequentialError extends Error {
+    constructor(newBlockNumber: number, previous: number | undefined);
+}
+export declare class InitialCheckpointNumberNotSequentialError extends Error {
+    readonly newCheckpointNumber: number;
+    readonly previousCheckpointNumber: number | undefined;
+    constructor(newCheckpointNumber: number, previousCheckpointNumber: number | undefined);
+}
+export declare class CheckpointNumberNotSequentialError extends Error {
+    constructor(newCheckpointNumber: number, previous: number | undefined);
+}
+export declare class CheckpointNumberNotConsistentError extends Error {
+    constructor(newCheckpointNumber: number, previous: number | undefined);
+}
+export declare class BlockIndexNotSequentialError extends Error {
+    constructor(newBlockIndex: number, previousBlockIndex: number | undefined);
+}
+export declare class BlockArchiveNotConsistentError extends Error {
+    constructor(newBlockNumber: number, previousBlockNumber: number | undefined, newBlockArchive: Fr, previousBlockArchive: Fr);
+}
+export declare class CheckpointNotFoundError extends Error {
+    constructor(checkpointNumber: number);
+}
+export declare class BlockNotFoundError extends Error {
+    constructor(blockNumber: number);
+}
+export declare class CannotOverwriteCheckpointedBlockError extends Error {
+    readonly blockNumber: number;
+    readonly lastCheckpointedBlock: number;
+    constructor(blockNumber: number, lastCheckpointedBlock: number);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBELHFCQUFhLHNCQUF1QixTQUFRLEtBQUs7SUFDL0MsWUFBWSxVQUFVLEVBQUUsTUFBTSxFQUU3QjtDQUNGO0FBRUQscUJBQWEsb0NBQXFDLFNBQVEsS0FBSzthQUUzQyxjQUFjLEVBQUUsTUFBTTthQUN0QixtQkFBbUIsRUFBRSxNQUFNLEdBQUcsU0FBUztJQUZ6RCxZQUNrQixjQUFjLEVBQUUsTUFBTSxFQUN0QixtQkFBbUIsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQU94RDtDQUNGO0FBRUQscUJBQWEsNkJBQThCLFNBQVEsS0FBSztJQUN0RCxZQUFZLGNBQWMsRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBSS9EO0NBQ0Y7QUFFRCxxQkFBYSx5Q0FBMEMsU0FBUSxLQUFLO2FBRWhELG1CQUFtQixFQUFFLE1BQU07YUFDM0Isd0JBQXdCLEVBQUUsTUFBTSxHQUFHLFNBQVM7SUFGOUQsWUFDa0IsbUJBQW1CLEVBQUUsTUFBTSxFQUMzQix3QkFBd0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQU83RDtDQUNGO0FBRUQscUJBQWEsa0NBQW1DLFNBQVEsS0FBSztJQUMzRCxZQUFZLG1CQUFtQixFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFJcEU7Q0FDRjtBQUVELHFCQUFhLGtDQUFtQyxTQUFRLEtBQUs7SUFDM0QsWUFBWSxtQkFBbUIsRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBSXBFO0NBQ0Y7QUFFRCxxQkFBYSw0QkFBNkIsU0FBUSxLQUFLO0lBQ3JELFlBQVksYUFBYSxFQUFFLE1BQU0sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQUl4RTtDQUNGO0FBRUQscUJBQWEsOEJBQStCLFNBQVEsS0FBSztJQUN2RCxZQUNFLGNBQWMsRUFBRSxNQUFNLEVBQ3RCLG1CQUFtQixFQUFFLE1BQU0sR0FBRyxTQUFTLEVBQ3ZDLGVBQWUsRUFBRSxFQUFFLEVBQ25CLG9CQUFvQixFQUFFLEVBQUUsRUFLekI7Q0FDRjtBQUVELHFCQUFhLHVCQUF3QixTQUFRLEtBQUs7SUFDaEQsWUFBWSxnQkFBZ0IsRUFBRSxNQUFNLEVBRW5DO0NBQ0Y7QUFFRCxxQkFBYSxrQkFBbUIsU0FBUSxLQUFLO0lBQzNDLFlBQVksV0FBVyxFQUFFLE1BQU0sRUFFOUI7Q0FDRjtBQUVELHFCQUFhLHFDQUFzQyxTQUFRLEtBQUs7YUFFNUMsV0FBVyxFQUFFLE1BQU07YUFDbkIscUJBQXFCLEVBQUUsTUFBTTtJQUYvQyxZQUNrQixXQUFXLEVBQUUsTUFBTSxFQUNuQixxQkFBcUIsRUFBRSxNQUFNLEVBTTlDO0NBQ0YifQ==

package/dest/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AAEpD,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,UAAU,EAAE,MAAM,EAE7B;CACF;AAED,qBAAa,oCAAqC,SAAQ,KAAK;aAE3C,cAAc,EAAE,MAAM;aACtB,mBAAmB,EAAE,MAAM,GAAG,SAAS;IAFzD,YACkB,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,GAAG,SAAS,EAOxD;CACF;AAED,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,YAAY,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAI/D;CACF;AAED,qBAAa,yCAA0C,SAAQ,KAAK;aAEhD,mBAAmB,EAAE,MAAM;aAC3B,wBAAwB,EAAE,MAAM,GAAG,SAAS;IAF9D,YACkB,mBAAmB,EAAE,MAAM,EAC3B,wBAAwB,EAAE,MAAM,GAAG,SAAS,EAO7D;CACF;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,YAAY,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAIpE;CACF;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,YAAY,mBAAmB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAIpE;CACF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,aAAa,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,SAAS,EAIxE;CACF;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,YACE,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,eAAe,EAAE,EAAE,EACnB,oBAAoB,EAAE,EAAE,EAKzB;CACF;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,gBAAgB,EAAE,MAAM,EAEnC;CACF;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,WAAW,EAAE,MAAM,EAE9B;CACF;AAED,qBAAa,qCAAsC,SAAQ,KAAK;aAE5C,WAAW,EAAE,MAAM;aACnB,qBAAqB,EAAE,MAAM;IAF/C,YACkB,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,MAAM,EAM9C;CACF"}

package/dest/errors.js

@@ -0,0 +1,62 @@
+export class NoBlobBodiesFoundError extends Error {
+    constructor(l2BlockNum){
+        super(`No blob bodies found for block ${l2BlockNum}`);
+    }
+}
+export class InitialBlockNumberNotSequentialError extends Error {
+    newBlockNumber;
+    previousBlockNumber;
+    constructor(newBlockNumber, previousBlockNumber){
+        super(`Cannot insert new block ${newBlockNumber} given previous block number in store is ${previousBlockNumber ?? 'undefined'}`), this.newBlockNumber = newBlockNumber, this.previousBlockNumber = previousBlockNumber;
+    }
+}
+export class BlockNumberNotSequentialError extends Error {
+    constructor(newBlockNumber, previous){
+        super(`Cannot insert new block ${newBlockNumber} given previous block number in batch is ${previous ?? 'undefined'}`);
+    }
+}
+export class InitialCheckpointNumberNotSequentialError extends Error {
+    newCheckpointNumber;
+    previousCheckpointNumber;
+    constructor(newCheckpointNumber, previousCheckpointNumber){
+        super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in store is ${previousCheckpointNumber ?? 'undefined'}`), this.newCheckpointNumber = newCheckpointNumber, this.previousCheckpointNumber = previousCheckpointNumber;
+    }
+}
+export class CheckpointNumberNotSequentialError extends Error {
+    constructor(newCheckpointNumber, previous){
+        super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in batch is ${previous ?? 'undefined'}`);
+    }
+}
+export class CheckpointNumberNotConsistentError extends Error {
+    constructor(newCheckpointNumber, previous){
+        super(`Cannot insert block for new checkpoint ${newCheckpointNumber} given previous block was checkpoint ${previous ?? 'undefined'}`);
+    }
+}
+export class BlockIndexNotSequentialError extends Error {
+    constructor(newBlockIndex, previousBlockIndex){
+        super(`Cannot insert new block at checkpoint index ${newBlockIndex} given previous block index is ${previousBlockIndex ?? 'undefined'}`);
+    }
+}
+export class BlockArchiveNotConsistentError extends Error {
+    constructor(newBlockNumber, previousBlockNumber, newBlockArchive, previousBlockArchive){
+        super(`Cannot insert new block number ${newBlockNumber} with archive ${newBlockArchive.toString()} previous block number is ${previousBlockNumber ?? 'undefined'}, previous archive is ${previousBlockArchive?.toString() ?? 'undefined'}`);
+    }
+}
+export class CheckpointNotFoundError extends Error {
+    constructor(checkpointNumber){
+        super(`Failed to find expected checkpoint number ${checkpointNumber}`);
+    }
+}
+export class BlockNotFoundError extends Error {
+    constructor(blockNumber){
+        super(`Failed to find expected block number ${blockNumber}`);
+    }
+}
+export class CannotOverwriteCheckpointedBlockError extends Error {
+    blockNumber;
+    lastCheckpointedBlock;
+    constructor(blockNumber, lastCheckpointedBlock){
+        super(`Cannot add block ${blockNumber}: would overwrite checkpointed data (checkpointed up to block ${lastCheckpointedBlock})`), this.blockNumber = blockNumber, this.lastCheckpointedBlock = lastCheckpointedBlock;
+        this.name = 'CannotOverwriteCheckpointedBlockError';
+    }
+}

package/dest/factory.d.ts

@@ -1,19 +1,21 @@
 import type { DataStoreConfig } from '@aztec/kv-store/config';
-import { Archiver, type ArchiverDeps } from './archiver/archiver.js';
-import type { ArchiverConfig } from './archiver/config.js';
-import { KVArchiverDataStore } from './archiver/kv_archiver_store/kv_archiver_store.js';
+import type { L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
+import { Archiver, type ArchiverDeps } from './archiver.js';
+import { type ArchiverConfig } from './config.js';
+import { KVArchiverDataStore } from './store/kv_archiver_store.js';
 export declare const ARCHIVER_STORE_NAME = "archiver";
 /** Creates an archiver store. */
-export declare function createArchiverStore(userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb' | 'maxLogs'> & DataStoreConfig): Promise<KVArchiverDataStore>;
+export declare function createArchiverStore(userConfig: Pick<ArchiverConfig, 'archiverStoreMapSizeKb' | 'maxLogs'> & DataStoreConfig, l1Constants: Pick<L1RollupConstants, 'epochDuration'>): Promise<KVArchiverDataStore>;
 /**
  * Creates a local archiver.
  * @param config - The archiver configuration.
- * @param blobSinkClient - The blob sink client.
+ * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
  * @param opts - The options.
- * @param telemetry - The telemetry client.
  * @returns The local archiver.
  */
 export declare function createArchiver(config: ArchiverConfig & DataStoreConfig, deps: ArchiverDeps, opts?: {
     blockUntilSync: boolean;
 }): Promise<Archiver>;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFPOUQsT0FBTyxFQUFFLFFBQVEsRUFBRSxLQUFLLFlBQVksRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ3JFLE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQzNELE9BQU8sRUFBdUIsbUJBQW1CLEVBQUUsTUFBTSxtREFBbUQsQ0FBQztBQUU3RyxlQUFPLE1BQU0sbUJBQW1CLGFBQWEsQ0FBQztBQUU5QyxpQ0FBaUM7QUFDakMsd0JBQXNCLG1CQUFtQixDQUN2QyxVQUFVLEVBQUUsSUFBSSxDQUFDLGNBQWMsRUFBRSx3QkFBd0IsR0FBRyxTQUFTLENBQUMsR0FBRyxlQUFlLGdDQVF6RjtBQUVEOzs7Ozs7O0dBT0c7QUFDSCx3QkFBc0IsY0FBYyxDQUNsQyxNQUFNLEVBQUUsY0FBYyxHQUFHLGVBQWUsRUFDeEMsSUFBSSxFQUFFLFlBQVksRUFDbEIsSUFBSSxHQUFFO0lBQUUsY0FBYyxFQUFFLE9BQU8sQ0FBQTtDQUE2QixHQUMzRCxPQUFPLENBQUMsUUFBUSxDQUFDLENBSW5CIn0=
+/** Registers protocol contracts in the archiver store. */
+export declare function registerProtocolContracts(store: KVArchiverDataStore): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBU0EsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFPOUQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQU1yRSxPQUFPLEVBQUUsUUFBUSxFQUFFLEtBQUssWUFBWSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQzVELE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBcUIsTUFBTSxhQUFhLENBQUM7QUFHckUsT0FBTyxFQUF1QixtQkFBbUIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBRXhGLGVBQU8sTUFBTSxtQkFBbUIsYUFBYSxDQUFDO0FBRTlDLGlDQUFpQztBQUNqQyx3QkFBc0IsbUJBQW1CLENBQ3ZDLFVBQVUsRUFBRSxJQUFJLENBQUMsY0FBYyxFQUFFLHdCQUF3QixHQUFHLFNBQVMsQ0FBQyxHQUFHLGVBQWUsRUFDeEYsV0FBVyxFQUFFLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxlQUFlLENBQUMsZ0NBUXREO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLGNBQWMsQ0FDbEMsTUFBTSxFQUFFLGNBQWMsR0FBRyxlQUFlLEVBQ3hDLElBQUksRUFBRSxZQUFZLEVBQ2xCLElBQUksR0FBRTtJQUFFLGNBQWMsRUFBRSxPQUFPLENBQUE7Q0FBNkIsR0FDM0QsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQXNHbkI7QUFFRCwwREFBMEQ7QUFDMUQsd0JBQXNCLHlCQUF5QixDQUFDLEtBQUssRUFBRSxtQkFBbUIsaUJBb0J6RSJ9

package/dest/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAuB,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAE7G,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,iCAAiC;AACjC,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC,GAAG,eAAe,gCAQzF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA6B,GAC3D,OAAO,CAAC,QAAQ,CAAC,CAInB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAuB,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExF,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,iCAAiC;AACjC,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC,GAAG,eAAe,EACxF,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,gCAQtD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAA6B,GAC3D,OAAO,CAAC,QAAQ,CAAC,CAsGnB;AAED,0DAA0D;AAC1D,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,iBAoBzE"}

package/dest/factory.js

@@ -1,36 +1,114 @@
+import { EpochCache } from '@aztec/epoch-cache';
+import { createEthereumChain } from '@aztec/ethereum/chain';
+import { InboxContract, RollupContract } from '@aztec/ethereum/contracts';
 import { BlockNumber } from '@aztec/foundation/branded-types';
-import { createLogger } from '@aztec/foundation/log';
+import { Buffer32 } from '@aztec/foundation/buffer';
+import { merge } from '@aztec/foundation/collection';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { DateProvider } from '@aztec/foundation/timer';
 import { createStore } from '@aztec/kv-store/lmdb-v2';
 import { protocolContractNames } from '@aztec/protocol-contracts';
 import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
 import { FunctionType, decodeFunctionSignature } from '@aztec/stdlib/abi';
 import { computePublicBytecodeCommitment } from '@aztec/stdlib/contract';
-import { Archiver } from './archiver/archiver.js';
-import { ARCHIVER_DB_VERSION, KVArchiverDataStore } from './archiver/kv_archiver_store/kv_archiver_store.js';
+import { getTelemetryClient } from '@aztec/telemetry-client';
+import { EventEmitter } from 'events';
+import { createPublicClient, fallback, http } from 'viem';
+import { Archiver } from './archiver.js';
+import { mapArchiverConfig } from './config.js';
+import { ArchiverInstrumentation } from './modules/instrumentation.js';
+import { ArchiverL1Synchronizer } from './modules/l1_synchronizer.js';
+import { ARCHIVER_DB_VERSION, KVArchiverDataStore } from './store/kv_archiver_store.js';
 export const ARCHIVER_STORE_NAME = 'archiver';
-/** Creates an archiver store. */ export async function createArchiverStore(userConfig) {
+/** Creates an archiver store. */ export async function createArchiverStore(userConfig, l1Constants) {
     const config = {
         ...userConfig,
         dataStoreMapSizeKb: userConfig.archiverStoreMapSizeKb ?? userConfig.dataStoreMapSizeKb
     };
-    const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config, createLogger('archiver:lmdb'));
-    return new KVArchiverDataStore(store, config.maxLogs);
+    const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config);
+    return new KVArchiverDataStore(store, config.maxLogs, l1Constants);
 }
 /**
  * Creates a local archiver.
  * @param config - The archiver configuration.
- * @param blobSinkClient - The blob sink client.
+ * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
  * @param opts - The options.
- * @param telemetry - The telemetry client.
  * @returns The local archiver.
  */ export async function createArchiver(config, deps, opts = {
     blockUntilSync: true
 }) {
-    const archiverStore = await createArchiverStore(config);
+    const archiverStore = await createArchiverStore(config, {
+        epochDuration: config.aztecEpochDuration
+    });
     await registerProtocolContracts(archiverStore);
-    return Archiver.createAndSync(config, archiverStore, deps, opts.blockUntilSync);
+    // Create Ethereum clients
+    const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
+    const publicClient = createPublicClient({
+        chain: chain.chainInfo,
+        transport: fallback(config.l1RpcUrls.map((url)=>http(url, {
+                batch: false
+            }))),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+    // Create debug client using debug RPC URLs if available, otherwise fall back to regular RPC URLs
+    const debugRpcUrls = config.l1DebugRpcUrls.length > 0 ? config.l1DebugRpcUrls : config.l1RpcUrls;
+    const debugClient = createPublicClient({
+        chain: chain.chainInfo,
+        transport: fallback(debugRpcUrls.map((url)=>http(url, {
+                batch: false
+            }))),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+    // Create L1 contract instances
+    const rollup = new RollupContract(publicClient, config.l1Contracts.rollupAddress);
+    const inbox = new InboxContract(publicClient, config.l1Contracts.inboxAddress);
+    // Fetch L1 constants from rollup contract
+    const [l1StartBlock, l1GenesisTime, proofSubmissionEpochs, genesisArchiveRoot, slashingProposerAddress] = await Promise.all([
+        rollup.getL1StartBlock(),
+        rollup.getL1GenesisTime(),
+        rollup.getProofSubmissionEpochs(),
+        rollup.getGenesisArchiveTreeRoot(),
+        rollup.getSlashingProposerAddress()
+    ]);
+    const l1StartBlockHash = await publicClient.getBlock({
+        blockNumber: l1StartBlock,
+        includeTransactions: false
+    }).then((block)=>Buffer32.fromString(block.hash));
+    const { aztecEpochDuration: epochDuration, aztecSlotDuration: slotDuration, ethereumSlotDuration } = config;
+    const l1Constants = {
+        l1StartBlockHash,
+        l1StartBlock,
+        l1GenesisTime,
+        epochDuration,
+        slotDuration,
+        ethereumSlotDuration,
+        proofSubmissionEpochs: Number(proofSubmissionEpochs),
+        genesisArchiveRoot: Fr.fromString(genesisArchiveRoot.toString())
+    };
+    const archiverConfig = merge({
+        pollingIntervalMs: 10_000,
+        batchSize: 100,
+        maxAllowedEthClientDriftSeconds: 300,
+        ethereumAllowNoDebugHosts: false
+    }, mapArchiverConfig(config));
+    const epochCache = deps.epochCache ?? await EpochCache.create(config.l1Contracts.rollupAddress, config, deps);
+    const telemetry = deps.telemetry ?? getTelemetryClient();
+    const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>archiverStore.estimateSize());
+    // Create the event emitter that will be shared by archiver and synchronizer
+    const events = new EventEmitter();
+    // Create the L1 synchronizer
+    const synchronizer = new ArchiverL1Synchronizer(publicClient, debugClient, rollup, inbox, {
+        ...config.l1Contracts,
+        slashingProposerAddress
+    }, archiverStore, archiverConfig, deps.blobClient, epochCache, deps.dateProvider ?? new DateProvider(), instrumentation, l1Constants, events, instrumentation.tracer);
+    const archiver = new Archiver(publicClient, debugClient, rollup, {
+        ...config.l1Contracts,
+        slashingProposerAddress
+    }, archiverStore, archiverConfig, deps.blobClient, instrumentation, l1Constants, synchronizer, events);
+    await archiver.start(opts.blockUntilSync);
+    return archiver;
 }
-async function registerProtocolContracts(store) {
+/** Registers protocol contracts in the archiver store. */ export async function registerProtocolContracts(store) {
     const blockNumber = 0;
     for (const name of protocolContractNames){
         const provider = new BundledProtocolContractsProvider();

package/dest/index.d.ts

@@ -1,5 +1,11 @@
-export * from './archiver/index.js';
 export * from './factory.js';
-export * from './rpc/index.js';
-export { retrieveL2ProofVerifiedEvents } from './archiver/data_retrieval.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsZ0JBQWdCLENBQUM7QUFFL0IsT0FBTyxFQUFFLDZCQUE2QixFQUFFLE1BQU0sOEJBQThCLENBQUMifQ==
+export * from './interfaces.js';
+export * from './archiver.js';
+export * from './modules/data_source_base.js';
+export * from './modules/data_store_updater.js';
+export * from './config.js';
+export { type L1PublishedData } from './structs/published.js';
+export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
+export { ContractInstanceStore } from './store/contract_instance_store.js';
+export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLGFBQWEsQ0FBQztBQUU1QixPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUN4RixPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUUzRSxPQUFPLEVBQUUsNkJBQTZCLEVBQUUsNkJBQTZCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQyJ9

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC"}

package/dest/index.js

@@ -1,4 +1,9 @@
-export * from './archiver/index.js';
 export * from './factory.js';
-export * from './rpc/index.js';
-export { retrieveL2ProofVerifiedEvents } from './archiver/data_retrieval.js';
+export * from './interfaces.js';
+export * from './archiver.js';
+export * from './modules/data_source_base.js';
+export * from './modules/data_store_updater.js';
+export * from './config.js';
+export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
+export { ContractInstanceStore } from './store/contract_instance_store.js';
+export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';

package/dest/interfaces.d.ts

@@ -0,0 +1,9 @@
+import type { L2BlockSource } from '@aztec/stdlib/block';
+import type { ContractDataSource } from '@aztec/stdlib/contract';
+import type { L2LogsSource } from '@aztec/stdlib/interfaces/server';
+import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
+/**
+ * Helper interface to combine all sources this archiver implementation provides.
+ */
+export type ArchiverDataSource = L2BlockSource & L2LogsSource & ContractDataSource & L1ToL2MessageSource;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNqRSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNwRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRW5FOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGtCQUFrQixHQUFHLGFBQWEsR0FBRyxZQUFZLEdBQUcsa0JBQWtCLEdBQUcsbUJBQW1CLENBQUMifQ==

package/dest/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC"}

package/dest/interfaces.js

@@ -0,0 +1,3 @@
+/**
+ * Helper interface to combine all sources this archiver implementation provides.
+ */ export { };

package/dest/l1/bin/retrieve-calldata.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cmlldmUtY2FsbGRhdGEuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9sMS9iaW4vcmV0cmlldmUtY2FsbGRhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dest/l1/bin/retrieve-calldata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-calldata.d.ts","sourceRoot":"","sources":["../../../src/l1/bin/retrieve-calldata.ts"],"names":[],"mappings":""}

package/dest/l1/bin/retrieve-calldata.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { createLogger } from '@aztec/foundation/log';
+import { createPublicClient, http } from 'viem';
+import { mainnet } from 'viem/chains';
+import { CalldataRetriever } from '../calldata_retriever.js';
+const logger = createLogger('archiver:calldata-test');
+function parseArgs() {
+    const args = process.argv.slice(2);
+    if (args.length < 2) {
+        // eslint-disable-next-line no-console
+        console.error('Usage: node index.js <rollup-address> <tx-hash> [target-committee-size]');
+        // eslint-disable-next-line no-console
+        console.error('');
+        // eslint-disable-next-line no-console
+        console.error('Environment variables:');
+        // eslint-disable-next-line no-console
+        console.error('  ETHEREUM_HOST or RPC_URL - Ethereum RPC endpoint');
+        // eslint-disable-next-line no-console
+        console.error('');
+        // eslint-disable-next-line no-console
+        console.error('Example:');
+        // eslint-disable-next-line no-console
+        console.error('  RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY \\');
+        // eslint-disable-next-line no-console
+        console.error('  node index.js 0x1234... 0xabcd... 32');
+        process.exit(1);
+    }
+    const rollupAddress = EthAddress.fromString(args[0]);
+    const txHash = args[1];
+    const targetCommitteeSize = args[2] ? parseInt(args[2], 10) : 24;
+    const rpcUrl = process.env.ETHEREUM_HOST || process.env.RPC_URL;
+    if (!rpcUrl) {
+        // eslint-disable-next-line no-console
+        console.error('Error: ETHEREUM_HOST or RPC_URL environment variable must be set');
+        process.exit(1);
+    }
+    if (targetCommitteeSize <= 0 || targetCommitteeSize > 256) {
+        // eslint-disable-next-line no-console
+        console.error('Error: target-committee-size must be between 1 and 256');
+        process.exit(1);
+    }
+    return {
+        rollupAddress,
+        txHash,
+        rpcUrl,
+        targetCommitteeSize
+    };
+}
+async function main() {
+    const { rollupAddress, txHash, rpcUrl, targetCommitteeSize } = parseArgs();
+    logger.info('Calldata Retriever Test Script');
+    logger.info('===============================');
+    logger.info(`Rollup Address: ${rollupAddress.toString()}`);
+    logger.info(`Transaction Hash: ${txHash}`);
+    logger.info(`RPC URL: ${rpcUrl}`);
+    logger.info(`Target Committee Size: ${targetCommitteeSize}`);
+    logger.info('');
+    try {
+        // Create viem public client
+        const publicClient = createPublicClient({
+            chain: mainnet,
+            transport: http(rpcUrl, {
+                batch: false
+            })
+        });
+        logger.info('Fetching transaction...');
+        const tx = await publicClient.getTransaction({
+            hash: txHash
+        });
+        if (!tx) {
+            throw new Error(`Transaction ${txHash} not found`);
+        }
+        logger.info(`Transaction found in block ${tx.blockNumber}`);
+        // For simplicity, use zero addresses for optional contract addresses
+        // In production, these would be fetched from the rollup contract or configuration
+        const slashingProposerAddress = EthAddress.ZERO;
+        const governanceProposerAddress = EthAddress.ZERO;
+        const slashFactoryAddress = undefined;
+        logger.info('Using zero addresses for governance/slashing (can be configured if needed)');
+        // Create CalldataRetriever
+        const retriever = new CalldataRetriever(publicClient, publicClient, targetCommitteeSize, undefined, logger, {
+            rollupAddress,
+            governanceProposerAddress,
+            slashingProposerAddress,
+            slashFactoryAddress
+        });
+        // Extract L2 block number from transaction logs
+        logger.info('Decoding transaction to extract L2 block number...');
+        const receipt = await publicClient.getTransactionReceipt({
+            hash: txHash
+        });
+        const l2BlockProposedEvent = receipt.logs.find((log)=>{
+            try {
+                // Try to match the L2BlockProposed event
+                return log.address.toLowerCase() === rollupAddress.toString().toLowerCase() && log.topics[0] === '0x2f1d0e696fa5186494a2f2f89a0e0bcbb15d607f6c5eac4637e07e1e5e7d3c00' // L2BlockProposed event signature
+                ;
+            } catch  {
+                return false;
+            }
+        });
+        let l2BlockNumber;
+        if (l2BlockProposedEvent && l2BlockProposedEvent.topics[1]) {
+            // L2 block number is typically the first indexed parameter
+            l2BlockNumber = Number(BigInt(l2BlockProposedEvent.topics[1]));
+            logger.info(`L2 Block Number (from event): ${l2BlockNumber}`);
+        } else {
+            // Fallback: try to extract from transaction data or use a default
+            logger.warn('Could not extract L2 block number from event, using block number as fallback');
+            l2BlockNumber = Number(tx.blockNumber);
+        }
+        logger.info('');
+        logger.info('Retrieving block header from rollup transaction...');
+        logger.info('');
+        // For this script, we don't have blob hashes or expected hashes, so pass empty arrays/objects
+        const result = await retriever.getCheckpointFromRollupTx(txHash, [], CheckpointNumber.fromBlockNumber(BlockNumber(l2BlockNumber)), {});
+        logger.info(' Successfully retrieved block header!');
+        logger.info('');
+        logger.info('Block Header Details:');
+        logger.info('====================');
+        logger.info(`Checkpoint Number: ${result.checkpointNumber}`);
+        logger.info(`Block Hash: ${result.blockHash}`);
+        logger.info(`Archive Root: ${result.archiveRoot.toString()}`);
+        logger.info('');
+        logger.info('Header:');
+        logger.info(`  Slot Number: ${result.header.slotNumber.toString()}`);
+        logger.info(`  Timestamp: ${result.header.timestamp.toString()}`);
+        logger.info(`  Coinbase: ${result.header.coinbase.toString()}`);
+        logger.info(`  Fee Recipient: ${result.header.feeRecipient.toString()}`);
+        logger.info(`  Total Mana Used: ${result.header.totalManaUsed.toString()}`);
+        logger.info('');
+        logger.info('Attestations:');
+        logger.info(`  Count: ${result.attestations.length}`);
+        logger.info(`  Non-empty attestations: ${result.attestations.filter((a)=>!a.signature.isEmpty()).length}`);
+        process.exit(0);
+    } catch (error) {
+        logger.error('Error retrieving block header:');
+        logger.error(error instanceof Error ? error.message : String(error));
+        if (error instanceof Error && error.stack) {
+            logger.debug(error.stack);
+        }
+        process.exit(1);
+    }
+}
+// Only run if this is the main module
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void main();
+}