@aztec/archiver 0.0.1-commit.c2eed6949 → 0.0.1-commit.c52d6e7

package/dest/config.js

@@ -1,12 +1,11 @@
 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, pipelineConfigMappings } from '@aztec/stdlib/config';
+import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper, optionalNumberConfigHelper } from '@aztec/foundation/config';
+import { chainConfigMappings } from '@aztec/stdlib/config';
+import { DEFAULT_ORPHAN_PRUNE_NO_PROPOSAL_TOLERANCE } from '@aztec/stdlib/timetable';
 export const archiverConfigMappings = {
     ...blobClientConfigMapping,
-    ...pipelineConfigMappings,
     archiverPollingIntervalMS: {
         env: 'ARCHIVER_POLLING_INTERVAL_MS',
         description: 'The polling interval in ms for retrieving new L2 blocks and encrypted logs.',
@@ -17,20 +16,29 @@ export const archiverConfigMappings = {
         description: 'The number of L2 blocks the archiver will attempt to download at a time.',
         ...numberConfigHelper(100)
     },
-    maxLogs: {
-        env: 'ARCHIVER_MAX_LOGS',
-        description: 'The max number of logs that can be obtained in 1 "getPublicLogs" call.',
-        ...numberConfigHelper(1_000)
-    },
     archiverStoreMapSizeKb: {
         env: 'ARCHIVER_STORE_MAP_SIZE_KB',
-        parseEnv: (val)=>val ? +val : undefined,
+        ...optionalNumberConfigHelper(),
         description: 'The maximum possible size of the archiver DB in KB. Overwrites the general dataStoreMapSizeKb.'
     },
+    blockDurationMs: {
+        env: 'SEQ_BLOCK_DURATION_MS',
+        description: 'Duration per block in milliseconds when building multiple blocks per slot. Used to derive orphan proposed block pruning timing.',
+        ...optionalNumberConfigHelper()
+    },
+    checkpointProposalSyncGraceSeconds: {
+        env: 'CHECKPOINT_PROPOSAL_SYNC_GRACE_SECONDS',
+        description: 'Consensus grace in seconds for a received checkpoint proposal to materialize into local proposed state.',
+        ...optionalNumberConfigHelper()
+    },
     skipValidateCheckpointAttestations: {
         description: 'Skip validating checkpoint attestations (for testing purposes only)',
         ...booleanConfigHelper(false)
     },
+    skipPromoteProposedCheckpointDuringL1Sync: {
+        description: 'Skip promoting proposed checkpoints during L1 sync (for testing purposes only)',
+        ...booleanConfigHelper(false)
+    },
     maxAllowedEthClientDriftSeconds: {
         env: 'MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS',
         description: 'Maximum allowed drift in seconds between the Ethereum client and current time.',
@@ -41,6 +49,26 @@ export const archiverConfigMappings = {
         description: 'Whether to allow starting the archiver without debug/trace method support on Ethereum hosts',
         ...booleanConfigHelper(true)
     },
+    archiverSkipHistoricalLogsCheck: {
+        env: 'ARCHIVER_SKIP_HISTORICAL_LOGS_CHECK',
+        description: 'Skip the startup check that probes the L1 RPC for historical Rollup contract logs. ' + 'Set to true to bypass the check when the connected RPC node is known to prune old logs.',
+        ...booleanConfigHelper(false)
+    },
+    orphanPruneNoProposalTolerance: {
+        env: 'ARCHIVER_ORPHAN_PRUNE_NO_PROPOSAL_TOLERANCE',
+        description: 'Local tolerance in seconds before pruning an orphan block when no checkpoint proposal was received.',
+        ...numberConfigHelper(DEFAULT_ORPHAN_PRUNE_NO_PROPOSAL_TOLERANCE)
+    },
+    skipOrphanProposedBlockPruning: {
+        env: 'ARCHIVER_SKIP_ORPHAN_PROPOSED_BLOCK_PRUNING',
+        description: 'Skip pruning orphan proposed blocks that have no matching proposed checkpoint.',
+        ...booleanConfigHelper(false)
+    },
+    testPreloadStandardContracts: {
+        env: 'TEST_PRELOAD_STANDARD_CONTRACTS',
+        description: 'Preload the standard contracts (AuthRegistry, PublicChecks, HandshakeRegistry) into the contract store at ' + 'block 0. For test environments only, and only safe when genesis seeds the matching registration/deployment ' + 'nullifiers; otherwise a later on-chain publish would collide with the block-0 preload.',
+        ...booleanConfigHelper(false)
+    },
     ...chainConfigMappings,
     ...l1ReaderConfigMappings,
     viemPollingIntervalMS: {
@@ -48,11 +76,7 @@ export const archiverConfigMappings = {
         description: 'The polling interval viem uses in ms',
         ...numberConfigHelper(1000)
     },
-    ...l1ContractsConfigMappings,
-    l1Contracts: {
-        description: 'The deployed L1 contract addresses',
-        nested: l1ContractAddressesMapping
-    }
+    ...l1ContractsConfigMappings
 };
 /**
  * Returns the archiver configuration from the environment variables.
@@ -66,7 +90,11 @@ export const archiverConfigMappings = {
         pollingIntervalMs: config.archiverPollingIntervalMS,
         batchSize: config.archiverBatchSize,
         skipValidateCheckpointAttestations: config.skipValidateCheckpointAttestations,
+        skipPromoteProposedCheckpointDuringL1Sync: config.skipPromoteProposedCheckpointDuringL1Sync,
         maxAllowedEthClientDriftSeconds: config.maxAllowedEthClientDriftSeconds,
-        ethereumAllowNoDebugHosts: config.ethereumAllowNoDebugHosts
+        ethereumAllowNoDebugHosts: config.ethereumAllowNoDebugHosts,
+        skipHistoricalLogsCheck: config.archiverSkipHistoricalLogsCheck,
+        orphanPruneNoProposalTolerance: config.orphanPruneNoProposalTolerance,
+        skipOrphanProposedBlockPruning: config.skipOrphanProposedBlockPruning
     };
 }

package/dest/errors.d.ts

@@ -1,3 +1,4 @@
+import type { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
 import type { Fr } from '@aztec/foundation/schemas';
 export declare class NoBlobBodiesFoundError extends Error {
     constructor(l2BlockNum: number);
@@ -11,7 +12,13 @@ export declare class InitialCheckpointNumberNotSequentialError extends Error {
     constructor(newCheckpointNumber: number, previousCheckpointNumber: number | undefined);
 }
 export declare class CheckpointNumberNotSequentialError extends Error {
-    constructor(newCheckpointNumber: number, previous: number | undefined);
+    readonly newCheckpointNumber: CheckpointNumber;
+    readonly previousCheckpointNumber: CheckpointNumber | undefined;
+    constructor(newCheckpointNumber: CheckpointNumber, previousCheckpointNumber: CheckpointNumber | undefined, source?: 'proposed' | 'confirmed');
+}
+/** Thrown when a proposed block carries a checkpoint number that does not follow the latest one. */
+export declare class BlockCheckpointNumberNotSequentialError extends Error {
+    constructor(blockNumber: BlockNumber, blockCheckpointNumber: CheckpointNumber, previous: CheckpointNumber | undefined);
 }
 export declare class BlockIndexNotSequentialError extends Error {
     constructor(newBlockIndex: number, previousBlockIndex: number | undefined);
@@ -30,24 +37,51 @@ export declare class BlockAlreadyCheckpointedError extends Error {
     readonly blockNumber: number;
     constructor(blockNumber: number);
 }
-/** Thrown when logs are added for a tag whose last stored log has a higher block number than the new log. */
-export declare class OutOfOrderLogInsertionError extends Error {
-    readonly logType: 'private' | 'public';
-    readonly tag: string;
-    readonly lastBlockNumber: number;
-    readonly newBlockNumber: number;
-    constructor(logType: 'private' | 'public', tag: string, lastBlockNumber: number, newBlockNumber: number);
-}
 /** Thrown when L1 to L2 messages are requested for a checkpoint whose message tree hasn't been sealed yet. */
 export declare class L1ToL2MessagesNotReadyError extends Error {
     readonly checkpointNumber: number;
     readonly inboxTreeInProgress: bigint;
     constructor(checkpointNumber: number, inboxTreeInProgress: bigint);
 }
+/** Thrown when a proposed checkpoint number is stale (already processed). */
+export declare class ProposedCheckpointStaleError extends Error {
+    readonly proposedCheckpointNumber: number;
+    readonly currentProposedNumber: number;
+    constructor(proposedCheckpointNumber: number, currentProposedNumber: number);
+}
+/** Thrown when a proposed checkpoint number is not the expected latestTip + 1. */
+export declare class ProposedCheckpointNotSequentialError extends Error {
+    readonly proposedCheckpointNumber: number;
+    readonly latestTipNumber: number;
+    constructor(proposedCheckpointNumber: number, latestTipNumber: number);
+}
+/** Thrown when a proposed checkpoint or block L2 slot has already expired on L1. */
+export declare class BlockOrCheckpointSlotExpiredError extends Error {
+    readonly slot: number;
+    readonly nextSlotStart: bigint;
+    readonly l1TimestampSynced: bigint | undefined;
+    constructor(slot: number, nextSlotStart: bigint, l1TimestampSynced: bigint | undefined);
+}
+/** Thrown when attempting to promote a proposed checkpoint but no proposed checkpoint exists in the store. */
+export declare class NoProposedCheckpointToPromoteError extends Error {
+    constructor();
+}
+/** Thrown when the archive root of the proposed checkpoint does not match the expected one. */
+export declare class ProposedCheckpointArchiveRootMismatchError extends Error {
+    readonly expectedArchiveRoot: Fr;
+    readonly actualArchiveRoot: Fr;
+    constructor(expectedArchiveRoot: Fr, actualArchiveRoot: Fr);
+}
+/** Thrown when the proposed checkpoint does not directly follow the latest confirmed checkpoint. */
+export declare class ProposedCheckpointPromotionNotSequentialError extends Error {
+    readonly proposedCheckpointNumber: number;
+    readonly latestCheckpointNumber: number;
+    constructor(proposedCheckpointNumber: number, latestCheckpointNumber: number);
+}
 /** Thrown when a proposed block conflicts with an already checkpointed block (different content). */
 export declare class CannotOverwriteCheckpointedBlockError extends Error {
     readonly blockNumber: number;
     readonly lastCheckpointedBlock: number;
     constructor(blockNumber: number, lastCheckpointedBlock: number);
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBELHFCQUFhLHNCQUF1QixTQUFRLEtBQUs7SUFDL0MsWUFBWSxVQUFVLEVBQUUsTUFBTSxFQUU3QjtDQUNGO0FBRUQscUJBQWEsNkJBQThCLFNBQVEsS0FBSztJQUN0RCxZQUFZLGNBQWMsRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBRS9EO0NBQ0Y7QUFFRCxxQkFBYSx5Q0FBMEMsU0FBUSxLQUFLO2FBRWhELG1CQUFtQixFQUFFLE1BQU07YUFDM0Isd0JBQXdCLEVBQUUsTUFBTSxHQUFHLFNBQVM7SUFGOUQsWUFDa0IsbUJBQW1CLEVBQUUsTUFBTSxFQUMzQix3QkFBd0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQU83RDtDQUNGO0FBRUQscUJBQWEsa0NBQW1DLFNBQVEsS0FBSztJQUMzRCxZQUFZLG1CQUFtQixFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFJcEU7Q0FDRjtBQUVELHFCQUFhLDRCQUE2QixTQUFRLEtBQUs7SUFDckQsWUFBWSxhQUFhLEVBQUUsTUFBTSxFQUFFLGtCQUFrQixFQUFFLE1BQU0sR0FBRyxTQUFTLEVBSXhFO0NBQ0Y7QUFFRCxxQkFBYSw4QkFBK0IsU0FBUSxLQUFLO0lBQ3ZELFlBQ0UsY0FBYyxFQUFFLE1BQU0sRUFDdEIsbUJBQW1CLEVBQUUsTUFBTSxHQUFHLFNBQVMsRUFDdkMsZUFBZSxFQUFFLEVBQUUsRUFDbkIsb0JBQW9CLEVBQUUsRUFBRSxFQUt6QjtDQUNGO0FBRUQscUJBQWEsdUJBQXdCLFNBQVEsS0FBSztJQUNoRCxZQUFZLGdCQUFnQixFQUFFLE1BQU0sRUFFbkM7Q0FDRjtBQUVELHFCQUFhLGtCQUFtQixTQUFRLEtBQUs7SUFDM0MsWUFBWSxXQUFXLEVBQUUsTUFBTSxFQUU5QjtDQUNGO0FBRUQsdUhBQXVIO0FBQ3ZILHFCQUFhLDZCQUE4QixTQUFRLEtBQUs7YUFDMUIsV0FBVyxFQUFFLE1BQU07SUFBL0MsWUFBNEIsV0FBVyxFQUFFLE1BQU0sRUFHOUM7Q0FDRjtBQUVELDZHQUE2RztBQUM3RyxxQkFBYSwyQkFBNEIsU0FBUSxLQUFLO2FBRWxDLE9BQU8sRUFBRSxTQUFTLEdBQUcsUUFBUTthQUM3QixHQUFHLEVBQUUsTUFBTTthQUNYLGVBQWUsRUFBRSxNQUFNO2FBQ3ZCLGNBQWMsRUFBRSxNQUFNO0lBSnhDLFlBQ2tCLE9BQU8sRUFBRSxTQUFTLEdBQUcsUUFBUSxFQUM3QixHQUFHLEVBQUUsTUFBTSxFQUNYLGVBQWUsRUFBRSxNQUFNLEVBQ3ZCLGNBQWMsRUFBRSxNQUFNLEVBT3ZDO0NBQ0Y7QUFFRCw4R0FBOEc7QUFDOUcscUJBQWEsMkJBQTRCLFNBQVEsS0FBSzthQUVsQyxnQkFBZ0IsRUFBRSxNQUFNO2FBQ3hCLG1CQUFtQixFQUFFLE1BQU07SUFGN0MsWUFDa0IsZ0JBQWdCLEVBQUUsTUFBTSxFQUN4QixtQkFBbUIsRUFBRSxNQUFNLEVBTzVDO0NBQ0Y7QUFFRCxxR0FBcUc7QUFDckcscUJBQWEscUNBQXNDLFNBQVEsS0FBSzthQUU1QyxXQUFXLEVBQUUsTUFBTTthQUNuQixxQkFBcUIsRUFBRSxNQUFNO0lBRi9DLFlBQ2tCLFdBQVcsRUFBRSxNQUFNLEVBQ25CLHFCQUFxQixFQUFFLE1BQU0sRUFNOUM7Q0FDRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3JGLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRXBELHFCQUFhLHNCQUF1QixTQUFRLEtBQUs7SUFDL0MsWUFBWSxVQUFVLEVBQUUsTUFBTSxFQUc3QjtDQUNGO0FBRUQscUJBQWEsNkJBQThCLFNBQVEsS0FBSztJQUN0RCxZQUFZLGNBQWMsRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sR0FBRyxTQUFTLEVBRy9EO0NBQ0Y7QUFFRCxxQkFBYSx5Q0FBMEMsU0FBUSxLQUFLO2FBRWhELG1CQUFtQixFQUFFLE1BQU07YUFDM0Isd0JBQXdCLEVBQUUsTUFBTSxHQUFHLFNBQVM7SUFGOUQsWUFDa0IsbUJBQW1CLEVBQUUsTUFBTSxFQUMzQix3QkFBd0IsRUFBRSxNQUFNLEdBQUcsU0FBUyxFQVE3RDtDQUNGO0FBRUQscUJBQWEsa0NBQW1DLFNBQVEsS0FBSzthQUV6QyxtQkFBbUIsRUFBRSxnQkFBZ0I7YUFDckMsd0JBQXdCLEVBQUUsZ0JBQWdCLEdBQUcsU0FBUztJQUZ4RSxZQUNrQixtQkFBbUIsRUFBRSxnQkFBZ0IsRUFDckMsd0JBQXdCLEVBQUUsZ0JBQWdCLEdBQUcsU0FBUyxFQUN0RSxNQUFNLENBQUMsRUFBRSxVQUFVLEdBQUcsV0FBVyxFQU9sQztDQUNGO0FBRUQsb0dBQW9HO0FBQ3BHLHFCQUFhLHVDQUF3QyxTQUFRLEtBQUs7SUFDaEUsWUFDRSxXQUFXLEVBQUUsV0FBVyxFQUN4QixxQkFBcUIsRUFBRSxnQkFBZ0IsRUFDdkMsUUFBUSxFQUFFLGdCQUFnQixHQUFHLFNBQVMsRUFNdkM7Q0FDRjtBQUVELHFCQUFhLDRCQUE2QixTQUFRLEtBQUs7SUFDckQs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

package/dest/errors.d.ts.map

@@ -1 +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,6BAA8B,SAAQ,KAAK;IACtD,YAAY,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAE/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,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,uHAAuH;AACvH,qBAAa,6BAA8B,SAAQ,KAAK;aAC1B,WAAW,EAAE,MAAM;IAA/C,YAA4B,WAAW,EAAE,MAAM,EAG9C;CACF;AAED,6GAA6G;AAC7G,qBAAa,2BAA4B,SAAQ,KAAK;aAElC,OAAO,EAAE,SAAS,GAAG,QAAQ;aAC7B,GAAG,EAAE,MAAM;aACX,eAAe,EAAE,MAAM;aACvB,cAAc,EAAE,MAAM;IAJxC,YACkB,OAAO,EAAE,SAAS,GAAG,QAAQ,EAC7B,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EAOvC;CACF;AAED,8GAA8G;AAC9G,qBAAa,2BAA4B,SAAQ,KAAK;aAElC,gBAAgB,EAAE,MAAM;aACxB,mBAAmB,EAAE,MAAM;IAF7C,YACkB,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,EAO5C;CACF;AAED,qGAAqG;AACrG,qBAAa,qCAAsC,SAAQ,KAAK;aAE5C,WAAW,EAAE,MAAM;aACnB,qBAAqB,EAAE,MAAM;IAF/C,YACkB,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,MAAM,EAM9C;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dest/errors.js

@@ -1,11 +1,13 @@
 export class NoBlobBodiesFoundError extends Error {
     constructor(l2BlockNum){
         super(`No blob bodies found for block ${l2BlockNum}`);
+        this.name = 'NoBlobBodiesFoundError';
     }
 }
 export class BlockNumberNotSequentialError extends Error {
     constructor(newBlockNumber, previous){
         super(`Cannot insert new block ${newBlockNumber} given previous block number is ${previous ?? 'undefined'}`);
+        this.name = 'BlockNumberNotSequentialError';
     }
 }
 export class InitialCheckpointNumberNotSequentialError extends Error {
@@ -13,31 +15,46 @@ export class InitialCheckpointNumberNotSequentialError extends Error {
     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;
+        this.name = 'InitialCheckpointNumberNotSequentialError';
     }
 }
 export class CheckpointNumberNotSequentialError extends Error {
-    constructor(newCheckpointNumber, previous){
-        super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous checkpoint number in batch is ${previous ?? 'undefined'}`);
+    newCheckpointNumber;
+    previousCheckpointNumber;
+    constructor(newCheckpointNumber, previousCheckpointNumber, source){
+        const qualifier = source ? `${source} ` : '';
+        super(`Cannot insert new checkpoint ${newCheckpointNumber} given previous ${qualifier}checkpoint number is ${previousCheckpointNumber ?? 'undefined'}`), this.newCheckpointNumber = newCheckpointNumber, this.previousCheckpointNumber = previousCheckpointNumber;
+        this.name = 'CheckpointNumberNotSequentialError';
+    }
+}
+/** Thrown when a proposed block carries a checkpoint number that does not follow the latest one. */ export class BlockCheckpointNumberNotSequentialError extends Error {
+    constructor(blockNumber, blockCheckpointNumber, previous){
+        super(`Cannot insert new block ${blockNumber} for checkpoint ${blockCheckpointNumber} given previous checkpoint number is ${previous ?? 'undefined'}`);
+        this.name = 'BlockCheckpointNumberNotSequentialError';
     }
 }
 export class BlockIndexNotSequentialError extends Error {
     constructor(newBlockIndex, previousBlockIndex){
         super(`Cannot insert new block at checkpoint index ${newBlockIndex} given previous block index is ${previousBlockIndex ?? 'undefined'}`);
+        this.name = 'BlockIndexNotSequentialError';
     }
 }
 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'}`);
+        this.name = 'BlockArchiveNotConsistentError';
     }
 }
 export class CheckpointNotFoundError extends Error {
     constructor(checkpointNumber){
         super(`Failed to find expected checkpoint number ${checkpointNumber}`);
+        this.name = 'CheckpointNotFoundError';
     }
 }
 export class BlockNotFoundError extends Error {
     constructor(blockNumber){
         super(`Failed to find expected block number ${blockNumber}`);
+        this.name = 'BlockNotFoundError';
     }
 }
 /** Thrown when a proposed block matches a block that was already checkpointed. This is expected for late proposals. */ export class BlockAlreadyCheckpointedError extends Error {
@@ -47,16 +64,6 @@ export class BlockNotFoundError extends Error {
         this.name = 'BlockAlreadyCheckpointedError';
     }
 }
-/** Thrown when logs are added for a tag whose last stored log has a higher block number than the new log. */ export class OutOfOrderLogInsertionError extends Error {
-    logType;
-    tag;
-    lastBlockNumber;
-    newBlockNumber;
-    constructor(logType, tag, lastBlockNumber, newBlockNumber){
-        super(`Out-of-order ${logType} log insertion for tag ${tag}: ` + `last existing log is from block ${lastBlockNumber} but new log is from block ${newBlockNumber}`), this.logType = logType, this.tag = tag, this.lastBlockNumber = lastBlockNumber, this.newBlockNumber = newBlockNumber;
-        this.name = 'OutOfOrderLogInsertionError';
-    }
-}
 /** Thrown when L1 to L2 messages are requested for a checkpoint whose message tree hasn't been sealed yet. */ export class L1ToL2MessagesNotReadyError extends Error {
     checkpointNumber;
     inboxTreeInProgress;
@@ -65,6 +72,53 @@ export class BlockNotFoundError extends Error {
         this.name = 'L1ToL2MessagesNotReadyError';
     }
 }
+/** Thrown when a proposed checkpoint number is stale (already processed). */ export class ProposedCheckpointStaleError extends Error {
+    proposedCheckpointNumber;
+    currentProposedNumber;
+    constructor(proposedCheckpointNumber, currentProposedNumber){
+        super(`Stale proposed checkpoint ${proposedCheckpointNumber}: current proposed is ${currentProposedNumber}`), this.proposedCheckpointNumber = proposedCheckpointNumber, this.currentProposedNumber = currentProposedNumber;
+        this.name = 'ProposedCheckpointStaleError';
+    }
+}
+/** Thrown when a proposed checkpoint number is not the expected latestTip + 1. */ export class ProposedCheckpointNotSequentialError extends Error {
+    proposedCheckpointNumber;
+    latestTipNumber;
+    constructor(proposedCheckpointNumber, latestTipNumber){
+        super(`Proposed checkpoint ${proposedCheckpointNumber} is not sequential: expected ${latestTipNumber + 1} (latest tip + 1, where tip is highest of confirmed or pending)`), this.proposedCheckpointNumber = proposedCheckpointNumber, this.latestTipNumber = latestTipNumber;
+        this.name = 'ProposedCheckpointNotSequentialError';
+    }
+}
+/** Thrown when a proposed checkpoint or block L2 slot has already expired on L1. */ export class BlockOrCheckpointSlotExpiredError extends Error {
+    slot;
+    nextSlotStart;
+    l1TimestampSynced;
+    constructor(slot, nextSlotStart, l1TimestampSynced){
+        super(`Checkpoint or block for slot ${slot} is expired: L1 synced to ${l1TimestampSynced} which is past the next slot start ${nextSlotStart}. ` + `If the checkpoint still lands via a late L1 tx, the archiver will pick it up via normal L1-sync (not the pending-queue shortcut).`), this.slot = slot, this.nextSlotStart = nextSlotStart, this.l1TimestampSynced = l1TimestampSynced;
+        this.name = 'BlockOrCheckpointSlotExpiredError';
+    }
+}
+/** Thrown when attempting to promote a proposed checkpoint but no proposed checkpoint exists in the store. */ export class NoProposedCheckpointToPromoteError extends Error {
+    constructor(){
+        super('Cannot promote proposed checkpoint: no proposed checkpoint exists');
+        this.name = 'NoProposedCheckpointToPromoteError';
+    }
+}
+/** Thrown when the archive root of the proposed checkpoint does not match the expected one. */ export class ProposedCheckpointArchiveRootMismatchError extends Error {
+    expectedArchiveRoot;
+    actualArchiveRoot;
+    constructor(expectedArchiveRoot, actualArchiveRoot){
+        super(`Cannot promote proposed checkpoint: archive root mismatch (expected ${expectedArchiveRoot}, got ${actualArchiveRoot})`), this.expectedArchiveRoot = expectedArchiveRoot, this.actualArchiveRoot = actualArchiveRoot;
+        this.name = 'ProposedCheckpointArchiveRootMismatchError';
+    }
+}
+/** Thrown when the proposed checkpoint does not directly follow the latest confirmed checkpoint. */ export class ProposedCheckpointPromotionNotSequentialError extends Error {
+    proposedCheckpointNumber;
+    latestCheckpointNumber;
+    constructor(proposedCheckpointNumber, latestCheckpointNumber){
+        super(`Cannot promote proposed checkpoint: not sequential (latest ${latestCheckpointNumber}, proposed ${proposedCheckpointNumber})`), this.proposedCheckpointNumber = proposedCheckpointNumber, this.latestCheckpointNumber = latestCheckpointNumber;
+        this.name = 'ProposedCheckpointPromotionNotSequentialError';
+    }
+}
 /** Thrown when a proposed block conflicts with an already checkpointed block (different content). */ export class CannotOverwriteCheckpointedBlockError extends Error {
     blockNumber;
     lastCheckpointedBlock;

package/dest/factory.d.ts

@@ -1,20 +1,32 @@
+import type { BlockHash } from '@aztec/stdlib/block';
 import type { DataStoreConfig } from '@aztec/stdlib/kv-store';
+import type { BlockHeader } from '@aztec/stdlib/tx';
 import { Archiver, type ArchiverDeps } from './archiver.js';
 import { type ArchiverConfig } from './config.js';
-import { KVArchiverDataStore } from './store/kv_archiver_store.js';
+import { type ArchiverDataStores } from './store/data_stores.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'> & DataStoreConfig, genesisBlockHash: BlockHash): Promise<ArchiverDataStores>;
 /**
  * Creates a local archiver.
  * @param config - The archiver configuration.
  * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
  * @param opts - The options.
+ * @param initialHeader - The genesis block header from world-state, used to answer block-0 queries.
+ * @param initialBlockHash - Precomputed hash of `initialHeader`. Hoisted to the caller so the archiver
+ * can expose `getGenesisBlockHash()` synchronously.
  * @returns The local archiver.
  */
-export declare function createArchiver(config: ArchiverConfig & DataStoreConfig, deps: ArchiverDeps, opts?: {
+export declare function createArchiver(config: ArchiverConfig & DataStoreConfig, deps: ArchiverDeps, opts: {
     blockUntilSync: boolean;
-}): Promise<Archiver>;
+} | undefined, initialHeader: BlockHeader, initialBlockHash: BlockHash): Promise<Archiver>;
 /** Registers protocol contracts in the archiver store. Idempotent — skips contracts that already exist (e.g. on node restart). */
-export declare function registerProtocolContracts(store: KVArchiverDataStore): Promise<void>;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZ0JBLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBTTlELE9BQU8sRUFBRSxRQUFRLEVBQUUsS0FBSyxZQUFZLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDNUQsT0FBTyxFQUFFLEtBQUssY0FBYyxFQUFxQixNQUFNLGFBQWEsQ0FBQztBQUdyRSxPQUFPLEVBQXVCLG1CQUFtQixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFHeEYsZUFBTyxNQUFNLG1CQUFtQixhQUFhLENBQUM7QUFFOUMsaUNBQWlDO0FBQ2pDLHdCQUFzQixtQkFBbUIsQ0FDdkMsVUFBVSxFQUFFLElBQUksQ0FBQyxjQUFjLEVBQUUsd0JBQXdCLEdBQUcsU0FBUyxDQUFDLEdBQUcsZUFBZSxnQ0FRekY7QUFFRDs7Ozs7O0dBTUc7QUFDSCx3QkFBc0IsY0FBYyxDQUNsQyxNQUFNLEVBQUUsY0FBYyxHQUFHLGVBQWUsRUFDeEMsSUFBSSxFQUFFLFlBQVksRUFDbEIsSUFBSSxHQUFFO0lBQUUsY0FBYyxFQUFFLE9BQU8sQ0FBQTtDQUE2QixHQUMzRCxPQUFPLENBQUMsUUFBUSxDQUFDLENBdUhuQjtBQUVELG9JQUFrSTtBQUNsSSx3QkFBc0IseUJBQXlCLENBQUMsS0FBSyxFQUFFLG1CQUFtQixpQkF5QnpFIn0=
+export declare function registerProtocolContracts(stores: ArchiverDataStores): Promise<void>;
+/**
+ * Preloads the standard contracts (AuthRegistry, PublicChecks, HandshakeRegistry) into the archiver store at block 0,
+ * mirroring {@link registerProtocolContracts}. Only invoked for test environments (via `testPreloadStandardContracts`),
+ * which also seed the matching registration/deployment nullifiers into the genesis nullifier tree so the store and tree
+ * stay consistent. Idempotent — skips contracts that already exist (e.g. on node restart).
+ */
+export declare function registerStandardContracts(stores: ArchiverDataStores): Promise<void>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZ0JBLE9BQU8sS0FBSyxFQUFtQixTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUd0RSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUs5RCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQU1wRCxPQUFPLEVBQUUsUUFBUSxFQUFFLEtBQUssWUFBWSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQzVELE9BQU8sRUFBRSxLQUFLLGNBQWMsRUFBcUIsTUFBTSxhQUFhLENBQUM7QUFHckUsT0FBTyxFQUF1QixLQUFLLGtCQUFrQixFQUE0QixNQUFNLHdCQUF3QixDQUFDO0FBR2hILGVBQU8sTUFBTSxtQkFBbUIsYUFBYSxDQUFDO0FBRTlDLGlDQUFpQztBQUNqQyx3QkFBc0IsbUJBQW1CLENBQ3ZDLFVBQVUsRUFBRSxJQUFJLENBQUMsY0FBYyxFQUFFLHdCQUF3QixDQUFDLEdBQUcsZUFBZSxFQUM1RSxnQkFBZ0IsRUFBRSxTQUFTLEdBQzFCLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQU83QjtBQUVEOzs7Ozs7Ozs7R0FTRztBQUNILHdCQUFzQixjQUFjLENBQ2xDLE1BQU0sRUFBRSxjQUFjLEdBQUcsZUFBZSxFQUN4QyxJQUFJLEVBQUUsWUFBWSxFQUNsQixJQUFJOzthQUF3RCxFQUM1RCxhQUFhLEVBQUUsV0FBVyxFQUMxQixnQkFBZ0IsRUFBRSxTQUFTLEdBQzFCLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0F3SW5CO0FBRUQsb0lBQWtJO0FBQ2xJLHdCQUFzQix5QkFBeUIsQ0FBQyxNQUFNLEVBQUUsa0JBQWtCLGlCQXlCekU7QUFFRDs7Ozs7R0FLRztBQUNILHdCQUFzQix5QkFBeUIsQ0FBQyxNQUFNLEVBQUUsa0JBQWtCLGlCQXNCekUifQ==

package/dest/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,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;AAGxF,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;;;;;;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,CAuHnB;AAED,oIAAkI;AAClI,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,mBAAmB,iBAyBzE"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAuB,KAAK,kBAAkB,EAA4B,MAAM,wBAAwB,CAAC;AAGhH,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,iCAAiC;AACjC,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,wBAAwB,CAAC,GAAG,eAAe,EAC5E,gBAAgB,EAAE,SAAS,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,GAAG,eAAe,EACxC,IAAI,EAAE,YAAY,EAClB,IAAI;;aAAwD,EAC5D,aAAa,EAAE,WAAW,EAC1B,gBAAgB,EAAE,SAAS,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAwInB;AAED,oIAAkI;AAClI,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,iBAyBzE;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,iBAsBzE"}

package/dest/factory.js

@@ -1,7 +1,8 @@
 import { EpochCache } from '@aztec/epoch-cache';
 import { createEthereumChain } from '@aztec/ethereum/chain';
 import { makeL1HttpTransport } from '@aztec/ethereum/client';
-import { InboxContract, RollupContract } from '@aztec/ethereum/contracts';
+import { InboxContract, OutboxContract, RollupContract } from '@aztec/ethereum/contracts';
+import { pickL1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
 import { BlockNumber } from '@aztec/foundation/branded-types';
 import { Buffer32 } from '@aztec/foundation/buffer';
 import { merge } from '@aztec/foundation/collection';
@@ -10,8 +11,11 @@ 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 { getPublishableStandardContracts } from '@aztec/standard-contracts';
 import { FunctionType, decodeFunctionSignature } from '@aztec/stdlib/abi';
+import { DEFAULT_BLOCK_DURATION_MS } from '@aztec/stdlib/config';
 import { computePublicBytecodeCommitment } from '@aztec/stdlib/contract';
+import { DEFAULT_ORPHAN_PRUNE_NO_PROPOSAL_TOLERANCE, getDefaultCheckpointProposalSyncGrace } from '@aztec/stdlib/timetable';
 import { getTelemetryClient } from '@aztec/telemetry-client';
 import { EventEmitter } from 'events';
 import { createPublicClient } from 'viem';
@@ -19,28 +23,34 @@ 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';
+import { ARCHIVER_DB_VERSION, createArchiverDataStores } from './store/data_stores.js';
 import { L2TipsCache } from './store/l2_tips_cache.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, genesisBlockHash) {
     const config = {
         ...userConfig,
         dataStoreMapSizeKb: userConfig.archiverStoreMapSizeKb ?? userConfig.dataStoreMapSizeKb
     };
     const store = await createStore(ARCHIVER_STORE_NAME, ARCHIVER_DB_VERSION, config);
-    return new KVArchiverDataStore(store, config.maxLogs);
+    return createArchiverDataStores(store, genesisBlockHash);
 }
 /**
  * Creates a local archiver.
  * @param config - The archiver configuration.
  * @param deps - The archiver dependencies (blobClient, epochCache, dateProvider, telemetry).
  * @param opts - The options.
+ * @param initialHeader - The genesis block header from world-state, used to answer block-0 queries.
+ * @param initialBlockHash - Precomputed hash of `initialHeader`. Hoisted to the caller so the archiver
+ * can expose `getGenesisBlockHash()` synchronously.
  * @returns The local archiver.
  */ export async function createArchiver(config, deps, opts = {
     blockUntilSync: true
-}) {
-    const archiverStore = await createArchiverStore(config);
+}, initialHeader, initialBlockHash) {
+    const archiverStore = await createArchiverStore(config, initialBlockHash);
     await registerProtocolContracts(archiverStore);
+    if (config.testPreloadStandardContracts) {
+        await registerStandardContracts(archiverStore);
+    }
     // Create Ethereum clients
     const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
     const httpTimeout = config.l1HttpTimeoutMS;
@@ -61,8 +71,9 @@ export const ARCHIVER_STORE_NAME = 'archiver';
         pollingInterval: config.viemPollingIntervalMS
     });
     // Create L1 contract instances
-    const rollup = new RollupContract(publicClient, config.l1Contracts.rollupAddress);
-    const inbox = new InboxContract(publicClient, config.l1Contracts.inboxAddress);
+    const rollup = new RollupContract(publicClient, config.rollupAddress);
+    const inbox = new InboxContract(publicClient, config.inboxAddress);
+    const outbox = new OutboxContract(publicClient, config.outboxAddress);
     // Fetch L1 constants from rollup contract
     const [l1StartBlock, l1GenesisTime, proofSubmissionEpochs, genesisArchiveRoot, slashingProposerAddress, targetCommitteeSize, rollupManaLimit] = await Promise.all([
         rollup.getL1StartBlock(),
@@ -94,31 +105,65 @@ export const ARCHIVER_STORE_NAME = 'archiver';
         pollingIntervalMs: 10_000,
         batchSize: 100,
         maxAllowedEthClientDriftSeconds: 300,
-        ethereumAllowNoDebugHosts: false
+        ethereumAllowNoDebugHosts: false,
+        skipHistoricalLogsCheck: false,
+        checkpointProposalSyncGrace: config.checkpointProposalSyncGraceSeconds ?? getDefaultCheckpointProposalSyncGrace((config.blockDurationMs ?? DEFAULT_BLOCK_DURATION_MS) / 1000),
+        orphanPruneNoProposalTolerance: DEFAULT_ORPHAN_PRUNE_NO_PROPOSAL_TOLERANCE,
+        skipOrphanProposedBlockPruning: false,
+        blockDuration: (config.blockDurationMs ?? DEFAULT_BLOCK_DURATION_MS) / 1000
     }, mapArchiverConfig(config));
-    const epochCache = deps.epochCache ?? await EpochCache.create(config.l1Contracts.rollupAddress, config, deps);
+    const epochCache = deps.epochCache ?? await EpochCache.create(config.rollupAddress, config, deps);
     const telemetry = deps.telemetry ?? getTelemetryClient();
-    const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>archiverStore.estimateSize());
+    const instrumentation = await ArchiverInstrumentation.new(telemetry, ()=>archiverStore.db.estimateSize());
     // Create the event emitter that will be shared by archiver and synchronizer
     const events = new EventEmitter();
-    // Create L2 tips cache shared by archiver and synchronizer
-    const l2TipsCache = new L2TipsCache(archiverStore.blockStore);
+    // Create L2 tips cache shared by archiver and synchronizer. The genesis block hash is dynamic —
+    // it depends on the injected initial header (genesisTimestamp + prefilled state). Hoisted to the
+    // caller so we can pass the same value to the archiver and expose it via `getGenesisBlockHash()`.
+    const l2TipsCache = new L2TipsCache(archiverStore.blocks, initialBlockHash);
     // Create the L1 synchronizer
     const synchronizer = new ArchiverL1Synchronizer(publicClient, debugClient, rollup, inbox, archiverStore, archiverConfig, deps.blobClient, epochCache, deps.dateProvider ?? new DateProvider(), instrumentation, l1Constants, events, instrumentation.tracer, l2TipsCache, undefined);
-    const archiver = new Archiver(publicClient, debugClient, rollup, {
-        ...config.l1Contracts,
+    const archiver = new Archiver(publicClient, debugClient, rollup, outbox, {
+        ...pickL1ContractAddresses(config),
         slashingProposerAddress
-    }, archiverStore, archiverConfig, deps.blobClient, instrumentation, l1Constants, synchronizer, events, l2TipsCache);
+    }, archiverStore, archiverConfig, deps.blobClient, instrumentation, l1Constants, synchronizer, events, initialHeader, initialBlockHash, l2TipsCache, deps.dateProvider ?? new DateProvider());
     await archiver.start(opts.blockUntilSync);
     return archiver;
 }
-/** Registers protocol contracts in the archiver store. Idempotent — skips contracts that already exist (e.g. on node restart). */ export async function registerProtocolContracts(store) {
+/** Registers protocol contracts in the archiver store. Idempotent — skips contracts that already exist (e.g. on node restart). */ export async function registerProtocolContracts(stores) {
     const blockNumber = 0;
     for (const name of protocolContractNames){
         const provider = new BundledProtocolContractsProvider();
         const contract = await provider.getProtocolContractArtifact(name);
         // Skip if already registered (happens on node restart with a persisted store).
-        if (await store.getContractClass(contract.contractClass.id)) {
+        if (await stores.contractClasses.getContractClass(contract.contractClass.id)) {
+            continue;
+        }
+        const publicBytecodeCommitment = await computePublicBytecodeCommitment(contract.contractClass.packedBytecode);
+        const contractClassPublic = {
+            ...contract.contractClass,
+            publicBytecodeCommitment
+        };
+        const publicFunctionSignatures = contract.artifact.functions.filter((fn)=>fn.functionType === FunctionType.PUBLIC).map((fn)=>decodeFunctionSignature(fn.name, fn.parameters));
+        await stores.functionNames.register(publicFunctionSignatures);
+        await stores.contractClasses.addContractClasses([
+            contractClassPublic
+        ], BlockNumber(blockNumber));
+        await stores.contractInstances.addContractInstances([
+            contract.instance
+        ], BlockNumber(blockNumber));
+    }
+}
+/**
+ * Preloads the standard contracts (AuthRegistry, PublicChecks, HandshakeRegistry) into the archiver store at block 0,
+ * mirroring {@link registerProtocolContracts}. Only invoked for test environments (via `testPreloadStandardContracts`),
+ * which also seed the matching registration/deployment nullifiers into the genesis nullifier tree so the store and tree
+ * stay consistent. Idempotent — skips contracts that already exist (e.g. on node restart).
+ */ export async function registerStandardContracts(stores) {
+    const blockNumber = 0;
+    for (const contract of (await getPublishableStandardContracts())){
+        // Skip if already registered (happens on node restart with a persisted store).
+        if (await stores.contractClasses.getContractClass(contract.contractClass.id)) {
             continue;
         }
         const publicBytecodeCommitment = await computePublicBytecodeCommitment(contract.contractClass.packedBytecode);
@@ -127,11 +172,11 @@ export const ARCHIVER_STORE_NAME = 'archiver';
             publicBytecodeCommitment
         };
         const publicFunctionSignatures = contract.artifact.functions.filter((fn)=>fn.functionType === FunctionType.PUBLIC).map((fn)=>decodeFunctionSignature(fn.name, fn.parameters));
-        await store.registerContractFunctionSignatures(publicFunctionSignatures);
-        await store.addContractClasses([
+        await stores.functionNames.register(publicFunctionSignatures);
+        await stores.contractClasses.addContractClasses([
             contractClassPublic
         ], BlockNumber(blockNumber));
-        await store.addContractInstances([
+        await stores.contractInstances.addContractInstances([
             contract.instance
         ], BlockNumber(blockNumber));
     }

package/dest/index.d.ts

@@ -4,9 +4,17 @@ export * from './archiver.js';
 export * from './modules/data_source_base.js';
 export * from './modules/data_store_updater.js';
 export * from './config.js';
+export * from './errors.js';
 export { type L1PublishedData } from './structs/published.js';
-export { KVArchiverDataStore, ARCHIVER_DB_VERSION } from './store/kv_archiver_store.js';
+export { ARCHIVER_DB_VERSION, type ArchiverDataStores, type ArchiverL1SynchPoint, backupArchiverDataStores, createArchiverDataStores, createContractDataSource, getArchiverSynchPoint, } from './store/data_stores.js';
+export { FunctionNamesCache } from './store/function_names_cache.js';
+export { ArchiverContractDataSourceAdapter } from './modules/contract_data_source_adapter.js';
+export { BlockStore } from './store/block_store.js';
+export { LogStore } from './store/log_store.js';
+export { MessageStore } from './store/message_store.js';
+export { ContractClassStore } from './store/contract_class_store.js';
 export { ContractInstanceStore } from './store/contract_instance_store.js';
 export { L2TipsCache } from './store/l2_tips_cache.js';
-export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLGFBQWEsQ0FBQztBQUU1QixPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUN4RixPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUMzRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFdkQsT0FBTyxFQUFFLDZCQUE2QixFQUFFLDZCQUE2QixFQUFFLE1BQU0sd0JBQXdCLENBQUMifQ==
+export { retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
+export { CalldataRetriever } from './l1/calldata_retriever.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLGFBQWEsQ0FBQztBQUU1QixPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEVBQ0wsbUJBQW1CLEVBQ25CLEtBQUssa0JBQWtCLEVBQ3ZCLEtBQUssb0JBQW9CLEVBQ3pCLHdCQUF3QixFQUN4Qix3QkFBd0IsRUFDeEIsd0JBQXdCLEVBQ3hCLHFCQUFxQixHQUN0QixNQUFNLHdCQUF3QixDQUFDO0FBQ2hDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3JFLE9BQU8sRUFBRSxpQ0FBaUMsRUFBRSxNQUFNLDJDQUEyQyxDQUFDO0FBQzlGLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNwRCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDaEQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3hELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3JFLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLG9DQUFvQyxDQUFDO0FBQzNFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUV2RCxPQUFPLEVBQUUsNkJBQTZCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN2RSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQyJ9

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"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;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,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;AAC5B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dest/index.js

@@ -4,7 +4,15 @@ 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 * from './errors.js';
+export { ARCHIVER_DB_VERSION, backupArchiverDataStores, createArchiverDataStores, createContractDataSource, getArchiverSynchPoint } from './store/data_stores.js';
+export { FunctionNamesCache } from './store/function_names_cache.js';
+export { ArchiverContractDataSourceAdapter } from './modules/contract_data_source_adapter.js';
+export { BlockStore } from './store/block_store.js';
+export { LogStore } from './store/log_store.js';
+export { MessageStore } from './store/message_store.js';
+export { ContractClassStore } from './store/contract_class_store.js';
 export { ContractInstanceStore } from './store/contract_instance_store.js';
 export { L2TipsCache } from './store/l2_tips_cache.js';
-export { retrieveCheckpointsFromRollup, retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
+export { retrieveL2ProofVerifiedEvents } from './l1/data_retrieval.js';
+export { CalldataRetriever } from './l1/calldata_retriever.js';