@aztec/archiver 0.0.1-commit.96bb3f7 → 0.0.1-commit.993d240

package/dest/{archiver/l1 → l1}/validate_trace.js

@@ -1,7 +1,6 @@
 import { createLogger } from '@aztec/foundation/log';
 import { callTraceSchema } from './debug_tx.js';
 import { traceTransactionResponseSchema } from './trace_tx.js';
-const logger = createLogger('aztec:archiver:validate_trace');
 /**
  * Helper function to test a trace method with validation
  *
@@ -10,8 +9,9 @@ const logger = createLogger('aztec:archiver:validate_trace');
  * @param schema - Zod schema to validate the response
  * @param method - Name of the RPC method ('debug_traceTransaction' or 'trace_transaction')
  * @param blockType - Type of block being tested ('recent' or 'old')
+ * @param logger - Logger instance
  * @returns true if the method works and validation passes, false otherwise
- */ async function testTraceMethod(client, txHash, schema, method, blockType) {
+ */ async function testTraceMethod(client, txHash, schema, method, blockType, logger) {
     try {
         // Make request with appropriate params based on method name
         const result = await client.request(method === 'debug_traceTransaction' ? {
@@ -40,8 +40,10 @@ const logger = createLogger('aztec:archiver:validate_trace');
  * Validates the availability of debug/trace methods on the Ethereum client.
  *
  * @param client - The Viem public debug client
+ * @param bindings - Optional logger bindings for context
  * @returns Object indicating which trace methods are available for recent and old blocks
- */ export async function validateTraceAvailability(client) {
+ */ export async function validateTraceAvailability(client, bindings) {
+    const logger = createLogger('archiver:validate_trace', bindings);
     const result = {
         debugTraceRecent: false,
         traceTransactionRecent: false,
@@ -68,9 +70,9 @@ const logger = createLogger('aztec:archiver:validate_trace');
         // Get a transaction from the found block
         const recentTxHash = latestBlock.transactions[0];
         // Test debug_traceTransaction with recent block
-        result.debugTraceRecent = await testTraceMethod(client, recentTxHash, callTraceSchema, 'debug_traceTransaction', 'recent');
+        result.debugTraceRecent = await testTraceMethod(client, recentTxHash, callTraceSchema, 'debug_traceTransaction', 'recent', logger);
         // Test trace_transaction with recent block
-        result.traceTransactionRecent = await testTraceMethod(client, recentTxHash, traceTransactionResponseSchema, 'trace_transaction', 'recent');
+        result.traceTransactionRecent = await testTraceMethod(client, recentTxHash, traceTransactionResponseSchema, 'trace_transaction', 'recent', logger);
         // Get a block from 512 blocks ago
         const oldBlockNumber = latestBlock.number ? latestBlock.number - 512n : null;
         if (!oldBlockNumber || oldBlockNumber < 0n) {
@@ -94,9 +96,9 @@ const logger = createLogger('aztec:archiver:validate_trace');
         }
         const oldTxHash = oldBlock.transactions[0];
         // Test debug_traceTransaction with old block
-        result.debugTraceOld = await testTraceMethod(client, oldTxHash, callTraceSchema, 'debug_traceTransaction', 'old');
+        result.debugTraceOld = await testTraceMethod(client, oldTxHash, callTraceSchema, 'debug_traceTransaction', 'old', logger);
         // Test trace_transaction with old block
-        result.traceTransactionOld = await testTraceMethod(client, oldTxHash, traceTransactionResponseSchema, 'trace_transaction', 'old');
+        result.traceTransactionOld = await testTraceMethod(client, oldTxHash, traceTransactionResponseSchema, 'trace_transaction', 'old', logger);
     } catch (error) {
         logger.warn(`Error validating debug_traceTransaction and trace_transaction availability: ${error}`);
     }
@@ -111,10 +113,12 @@ function hasTxs(block) {
  *
  * @param client - The Viem public debug client
  * @param ethereumAllowNoDebugHosts - If false, throws an error when no trace methods are available
+ * @param bindings - Optional logger bindings for context
  * @throws Error if ethereumAllowNoDebugHosts is false and no trace methods are available
- */ export async function validateAndLogTraceAvailability(client, ethereumAllowNoDebugHosts) {
+ */ export async function validateAndLogTraceAvailability(client, ethereumAllowNoDebugHosts, bindings) {
+    const logger = createLogger('archiver:validate_trace', bindings);
     logger.debug('Validating trace/debug method availability...');
-    const availability = await validateTraceAvailability(client);
+    const availability = await validateTraceAvailability(client, bindings);
     // Check if we have support for old blocks (either debug or trace)
     const hasOldBlockSupport = availability.debugTraceOld || availability.traceTransactionOld;
     if (hasOldBlockSupport) {

package/dest/modules/contract_data_source_adapter.d.ts

@@ -0,0 +1,25 @@
+import type { BlockNumber } from '@aztec/foundation/branded-types';
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import type { FunctionSelector } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { ContractClassPublic, ContractDataSource, ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { UInt64 } from '@aztec/stdlib/types';
+import type { ArchiverDataStores } from '../store/data_stores.js';
+/**
+ * Thin {@link ContractDataSource} adapter over {@link ArchiverDataStores}.
+ *
+ * Used by contexts (e.g. offline epoch re-prover tools) that need a ContractDataSource
+ * but do not need a full archiver instance.
+ */
+export declare class ArchiverContractDataSourceAdapter implements ContractDataSource {
+    private readonly stores;
+    constructor(stores: ArchiverDataStores);
+    getBlockNumber(): Promise<BlockNumber>;
+    getContractClass(id: Fr): Promise<ContractClassPublic | undefined>;
+    getBytecodeCommitment(id: Fr): Promise<Fr | undefined>;
+    getContract(address: AztecAddress, maybeTimestamp?: UInt64): Promise<ContractInstanceWithAddress | undefined>;
+    getContractClassIds(): Promise<Fr[]>;
+    getDebugFunctionName(_address: AztecAddress, selector: FunctionSelector): Promise<string | undefined>;
+    registerContractFunctionSignatures(signatures: string[]): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfZGF0YV9zb3VyY2VfYWRhcHRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL21vZHVsZXMvY29udHJhY3RfZGF0YV9zb3VyY2VfYWRhcHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNuRSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQzFELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ2hFLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLDJCQUEyQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDbkgsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEQsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUVsRTs7Ozs7R0FLRztBQUNILHFCQUFhLGlDQUFrQyxZQUFXLGtCQUFrQjtJQUM5RCxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU07SUFBbkMsWUFBNkIsTUFBTSxFQUFFLGtCQUFrQixFQUFJO0lBRXBELGNBQWMsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLENBRTVDO0lBRU0sZ0JBQWdCLENBQUMsRUFBRSxFQUFFLEVBQUUsR0FBRyxPQUFPLENBQUMsbUJBQW1CLEdBQUcsU0FBUyxDQUFDLENBRXhFO0lBRU0scUJBQXFCLENBQUMsRUFBRSxFQUFFLEVBQUUsR0FBRyxPQUFPLENBQUMsRUFBRSxHQUFHLFNBQVMsQ0FBQyxDQUU1RDtJQUVZLFdBQVcsQ0FDdEIsT0FBTyxFQUFFLFlBQVksRUFDckIsY0FBYyxDQUFDLEVBQUUsTUFBTSxHQUN0QixPQUFPLENBQUMsMkJBQTJCLEdBQUcsU0FBUyxDQUFDLENBUWxEO0lBRU0sbUJBQW1CLElBQUksT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBRTFDO0lBRU0sb0JBQW9CLENBQUMsUUFBUSxFQUFFLFlBQVksRUFBRSxRQUFRLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FFM0c7SUFFTSxrQ0FBa0MsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUU3RTtDQUNGIn0=

package/dest/modules/contract_data_source_adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract_data_source_adapter.d.ts","sourceRoot":"","sources":["../../src/modules/contract_data_source_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACnH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,iCAAkC,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,kBAAkB,EAAI;IAEpD,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAE5C;IAEM,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAExE;IAEM,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAE5D;IAEY,WAAW,CACtB,OAAO,EAAE,YAAY,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAQlD;IAEM,mBAAmB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAE1C;IAEM,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE3G;IAEM,kCAAkC,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;CACF"}

package/dest/modules/contract_data_source_adapter.js

@@ -0,0 +1,40 @@
+/**
+ * Thin {@link ContractDataSource} adapter over {@link ArchiverDataStores}.
+ *
+ * Used by contexts (e.g. offline epoch re-prover tools) that need a ContractDataSource
+ * but do not need a full archiver instance.
+ */ export class ArchiverContractDataSourceAdapter {
+    stores;
+    constructor(stores){
+        this.stores = stores;
+    }
+    getBlockNumber() {
+        return this.stores.blocks.getLatestL2BlockNumber();
+    }
+    getContractClass(id) {
+        return this.stores.contractClasses.getContractClass(id);
+    }
+    getBytecodeCommitment(id) {
+        return this.stores.contractClasses.getBytecodeCommitment(id);
+    }
+    async getContract(address, maybeTimestamp) {
+        let timestamp = maybeTimestamp;
+        if (timestamp === undefined) {
+            const latest = await this.stores.blocks.getLatestL2BlockNumber();
+            const blockData = latest > 0 ? await this.stores.blocks.getBlockData({
+                number: latest
+            }) : undefined;
+            timestamp = blockData ? blockData.header.globalVariables.timestamp : 0n;
+        }
+        return this.stores.contractInstances.getContractInstance(address, timestamp);
+    }
+    getContractClassIds() {
+        return this.stores.contractClasses.getContractClassIds();
+    }
+    getDebugFunctionName(_address, selector) {
+        return Promise.resolve(this.stores.functionNames.get(selector));
+    }
+    registerContractFunctionSignatures(signatures) {
+        return this.stores.functionNames.register(signatures);
+    }
+}

package/dest/modules/data_source_base.d.ts

@@ -0,0 +1,113 @@
+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 { FunctionSelector } from '@aztec/stdlib/abi';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import { type BlockData, type BlockHash, type BlockQuery, type BlocksQuery, type CheckpointQuery, type CheckpointsQuery, L2Block, type L2Tips, type ProposedCheckpointQuery } from '@aztec/stdlib/block';
+import { type CheckpointData, type ProposedCheckpointData, PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
+import type { ContractClassPublic, ContractDataSource, ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import { type L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
+import type { L2LogsSource } from '@aztec/stdlib/interfaces/server';
+import type { LogResult, PrivateLogsQuery, PublicLogsQuery } from '@aztec/stdlib/logs';
+import type { L1ToL2MessageSource } from '@aztec/stdlib/messaging';
+import type { BlockHeader, IndexedTxEffect, TxHash, TxReceipt } from '@aztec/stdlib/tx';
+import type { UInt64 } from '@aztec/stdlib/types';
+import type { ArchiverDataSource } from '../interfaces.js';
+import type { ArchiverDataStores } from '../store/data_stores.js';
+import type { ValidateCheckpointResult } from './validation.js';
+/**
+ * Abstract base class implementing ArchiverDataSource using a bundle of archiver substores.
+ * Provides implementations for all read-side methods and declares abstract methods for
+ * L1-dependent functionality that subclasses must implement.
+ */
+export declare abstract class ArchiverDataSourceBase implements ArchiverDataSource, L2LogsSource, ContractDataSource, L1ToL2MessageSource {
+    protected readonly stores: ArchiverDataStores;
+    protected readonly l1Constants: L1RollupConstants | undefined;
+    /** The injected genesis block header. */
+    protected readonly initialHeader: BlockHeader;
+    /** Precomputed hash of the initial header, exposed via {@link getGenesisBlockHash}. */
+    protected readonly initialBlockHash: BlockHash;
+    /** Archive root after block 0 was appended — read from L1 (`Rollup.getGenesisArchiveTreeRoot`). */
+    protected readonly genesisArchiveRoot: Fr;
+    /** Memoized synthetic genesis block — callers rely on referential identity for caching. */
+    private readonly genesisBlock;
+    /** Memoized synthetic genesis block data — kept consistent with {@link genesisBlock}. */
+    private readonly genesisBlockData;
+    constructor(stores: ArchiverDataStores, l1Constants: L1RollupConstants | undefined, initialHeader: BlockHeader, initialBlockHash: BlockHash, genesisArchiveRoot: Fr);
+    /** Returns the precomputed hash of the genesis block header. */
+    getGenesisBlockHash(): BlockHash;
+    /** Returns the synthetic genesis L2Block (memoized — same instance across calls). */
+    private getGenesisBlock;
+    /** Returns genesis block data (memoized — same instance across calls). */
+    private getGenesisBlockData;
+    /**
+     * Type guard distinguishing the genesis sentinel from a {@link ResolvedBlockQuery}.
+     * `resolveBlockQuery` already rewrites every genesis-matching shape to the sentinel,
+     * so callers only need this single sync check.
+     */
+    private isGenesisBlockQuery;
+    abstract getRollupAddress(): Promise<EthAddress>;
+    abstract getRegistryAddress(): Promise<EthAddress>;
+    abstract getL1Constants(): Promise<L1RollupConstants>;
+    abstract getGenesisValues(): Promise<{
+        genesisArchiveRoot: Fr;
+    }>;
+    abstract getL1Timestamp(): Promise<bigint | undefined>;
+    abstract getL2Tips(): Promise<L2Tips>;
+    abstract getSyncedL2SlotNumber(): Promise<SlotNumber | undefined>;
+    abstract getSyncedL2EpochNumber(): Promise<EpochNumber | undefined>;
+    abstract isEpochComplete(epochNumber: EpochNumber): Promise<boolean>;
+    abstract syncImmediate(): Promise<void>;
+    isPruneDueAtSlot(slot: SlotNumber): Promise<boolean>;
+    getCheckpointNumber(): Promise<CheckpointNumber>;
+    getProvenCheckpointNumber(): Promise<CheckpointNumber>;
+    getBlockNumber(): Promise<BlockNumber>;
+    getBlockNumber(query: BlockQuery): Promise<BlockNumber | undefined>;
+    /**
+     * Resolves a {@link CheckpointQuery} to a concrete `CheckpointNumber`, or undefined when the
+     * query refers to a position that has no checkpoint yet (e.g. `{ slot }` not found).
+     */
+    private resolveCheckpointQuery;
+    private resolveCheckpointsQuery;
+    getCheckpoint(query: CheckpointQuery): Promise<PublishedCheckpoint | undefined>;
+    getCheckpoints(query: CheckpointsQuery): Promise<PublishedCheckpoint[]>;
+    getCheckpointData(query: CheckpointQuery): Promise<CheckpointData | undefined>;
+    getCheckpointsData(query: CheckpointsQuery): Promise<CheckpointData[]>;
+    getProposedCheckpointData(query?: ProposedCheckpointQuery): Promise<ProposedCheckpointData | undefined>;
+    getTxEffect(txHash: TxHash): Promise<IndexedTxEffect | undefined>;
+    getSettledTxReceipt(txHash: TxHash): Promise<TxReceipt | undefined>;
+    isPendingChainInvalid(): Promise<boolean>;
+    getPendingChainValidationStatus(): Promise<ValidateCheckpointResult>;
+    getPrivateLogsByTags(query: PrivateLogsQuery): Promise<LogResult[][]>;
+    getPublicLogsByTags(query: PublicLogsQuery): Promise<LogResult[][]>;
+    getContractClass(id: Fr): Promise<ContractClassPublic | undefined>;
+    getBytecodeCommitment(id: Fr): Promise<Fr | undefined>;
+    getContract(address: AztecAddress, maybeTimestamp?: UInt64): Promise<ContractInstanceWithAddress | undefined>;
+    getContractClassIds(): Promise<Fr[]>;
+    /** Looks up a public function name given a selector. */
+    getDebugFunctionName(_address: AztecAddress, selector: FunctionSelector): Promise<string | undefined>;
+    /** Register public function signatures so they can be looked up by selector. */
+    registerContractFunctionSignatures(signatures: string[]): Promise<void>;
+    getL1ToL2Messages(checkpointNumber: CheckpointNumber): Promise<Fr[]>;
+    getL1ToL2MessageIndex(l1ToL2Message: Fr): Promise<bigint | undefined>;
+    private getPublishedCheckpointFromCheckpointData;
+    getBlocksForSlot(slotNumber: SlotNumber): Promise<L2Block[]>;
+    /** Returns just the checkpoint numbers for all checkpoints whose slot falls within the given epoch. */
+    private getCheckpointNumbersForEpoch;
+    getBlock(query: BlockQuery): Promise<L2Block | undefined>;
+    /**
+     * Range queries iterate physical blocks only; the genesis block is NOT prepended.
+     * `L2BlockStream` consumers (`world-state.handleL2Blocks`, etc.) emit `blocks-added` events for
+     * real blocks and would be surprised by a synthetic block 0. Use {@link getBlock} or
+     * {@link getBlockData} for genesis-aware single-block lookups.
+     */
+    getBlocks(query: BlocksQuery): Promise<L2Block[]>;
+    getBlockData(query: BlockQuery): Promise<BlockData | undefined>;
+    /** See {@link getBlocks} — range queries do not prepend the genesis block. */
+    getBlocksData(query: BlocksQuery): Promise<BlockData[]>;
+    private resolveBlockQuery;
+    /** Maps a {@link BlockTag} to the matching block number for the current chain state. */
+    private resolveBlockTag;
+    private resolveBlocksQuery;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YV9zb3VyY2VfYmFzZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL21vZHVsZXMvZGF0YV9zb3VyY2VfYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQ0wsV0FBVyxFQUNYLGdCQUFnQixFQUNoQixLQUFLLFdBQVcsRUFFaEIsS0FBSyxVQUFVLEVBQ2hCLE1BQU0saUNBQWlDLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDaEUsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEVBQ0wsS0FBSyxTQUFTLEVBQ2QsS0FBSyxTQUFTLEVBQ2QsS0FBSyxVQUFVLEVBRWYsS0FBSyxXQUFXLEVBRWhCLEtBQUssZUFBZSxFQUNwQixLQUFLLGdCQUFnQixFQUNyQixPQUFPLEVBQ1AsS0FBSyxNQUFNLEVBQ1gsS0FBSyx1QkFBdUIsRUFDN0IsTUFBTSxxQkFBcUIsQ0FBQztBQUM3QixPQUFPLEVBRUwsS0FBSyxjQUFjLEVBQ25CLEtBQUssc0JBQXNCLEVBQzNCLG1CQUFtQixFQUNwQixNQUFNLDBCQUEwQixDQUFDO0FBQ2xDLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLDJCQUEyQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDbkgsT0FBTyxFQUNMLEtBQUssaUJBQWlCLEVBTXZCLE1BQU0sNkJBQTZCLENBQUM7QUFDckMsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDcEUsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLGdCQUFnQixFQUFFLGVBQWUsRUFBRSxNQUFNLG9C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

package/dest/modules/data_source_base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_source_base.d.ts","sourceRoot":"","sources":["../../src/modules/data_source_base.ts"],"names":[],"mappings":"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"}

package/dest/modules/data_source_base.js

@@ -0,0 +1,351 @@
+import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
+import { BlockNumber, CheckpointNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
+import { Body, L2Block } from '@aztec/stdlib/block';
+import { Checkpoint, PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
+import { getEpochAtSlot, getEpochNumberAtTimestamp, getLastL1SlotTimestampForL2Slot, getProofSubmissionDeadlineEpoch, getSlotRangeForEpoch } from '@aztec/stdlib/epoch-helpers';
+import { AppendOnlyTreeSnapshot } from '@aztec/stdlib/trees';
+/**
+ * Abstract base class implementing ArchiverDataSource using a bundle of archiver substores.
+ * Provides implementations for all read-side methods and declares abstract methods for
+ * L1-dependent functionality that subclasses must implement.
+ */ export class ArchiverDataSourceBase {
+    stores;
+    l1Constants;
+    /** The injected genesis block header. */ initialHeader;
+    /** Precomputed hash of the initial header, exposed via {@link getGenesisBlockHash}. */ initialBlockHash;
+    /** Archive root after block 0 was appended — read from L1 (`Rollup.getGenesisArchiveTreeRoot`). */ genesisArchiveRoot;
+    /** Memoized synthetic genesis block — callers rely on referential identity for caching. */ genesisBlock;
+    /** Memoized synthetic genesis block data — kept consistent with {@link genesisBlock}. */ genesisBlockData;
+    constructor(stores, l1Constants, initialHeader, initialBlockHash, genesisArchiveRoot){
+        this.stores = stores;
+        this.l1Constants = l1Constants;
+        this.initialHeader = initialHeader;
+        this.initialBlockHash = initialBlockHash;
+        this.genesisArchiveRoot = genesisArchiveRoot;
+        const genesisArchive = new AppendOnlyTreeSnapshot(genesisArchiveRoot, 1);
+        this.genesisBlock = new L2Block(genesisArchive, initialHeader, Body.empty(), CheckpointNumber.ZERO, IndexWithinCheckpoint(0));
+        this.genesisBlockData = {
+            header: initialHeader,
+            archive: genesisArchive,
+            blockHash: initialBlockHash,
+            checkpointNumber: CheckpointNumber.ZERO,
+            indexWithinCheckpoint: IndexWithinCheckpoint(0)
+        };
+    }
+    /** Returns the precomputed hash of the genesis block header. */ getGenesisBlockHash() {
+        return this.initialBlockHash;
+    }
+    /** Returns the synthetic genesis L2Block (memoized — same instance across calls). */ getGenesisBlock() {
+        return this.genesisBlock;
+    }
+    /** Returns genesis block data (memoized — same instance across calls). */ getGenesisBlockData() {
+        return this.genesisBlockData;
+    }
+    /**
+   * Type guard distinguishing the genesis sentinel from a {@link ResolvedBlockQuery}.
+   * `resolveBlockQuery` already rewrites every genesis-matching shape to the sentinel,
+   * so callers only need this single sync check.
+   */ isGenesisBlockQuery(query) {
+        return 'genesis' in query;
+    }
+    async isPruneDueAtSlot(slot) {
+        if (!this.l1Constants) {
+            throw new Error('isPruneDueAtSlot requires l1Constants');
+        }
+        const tips = await this.getL2Tips();
+        const proven = tips.proven.checkpoint.number;
+        const pending = tips.checkpointed.checkpoint.number;
+        if (pending === proven) {
+            return false;
+        }
+        const oldestUnproven = await this.getCheckpointData({
+            number: CheckpointNumber(Number(proven) + 1)
+        });
+        if (!oldestUnproven) {
+            return false;
+        }
+        const slotTs = getLastL1SlotTimestampForL2Slot(slot, this.l1Constants);
+        const slotEpoch = getEpochNumberAtTimestamp(slotTs, this.l1Constants);
+        const oldestUnprovenEpoch = getEpochAtSlot(oldestUnproven.header.slotNumber, this.l1Constants);
+        const deadlineEpoch = getProofSubmissionDeadlineEpoch(oldestUnprovenEpoch, this.l1Constants);
+        return slotEpoch >= deadlineEpoch;
+    }
+    getCheckpointNumber() {
+        return this.stores.blocks.getLatestCheckpointNumber();
+    }
+    getProvenCheckpointNumber() {
+        return this.stores.blocks.getProvenCheckpointNumber();
+    }
+    async getBlockNumber(query) {
+        if (!query) {
+            return this.stores.blocks.getLatestL2BlockNumber();
+        }
+        const resolved = await this.resolveBlockQuery(query);
+        if (resolved === undefined) {
+            return undefined;
+        }
+        if (this.isGenesisBlockQuery(resolved)) {
+            return BlockNumber.ZERO;
+        }
+        return this.stores.blocks.getBlockNumber(resolved);
+    }
+    /**
+   * Resolves a {@link CheckpointQuery} to a concrete `CheckpointNumber`, or undefined when the
+   * query refers to a position that has no checkpoint yet (e.g. `{ slot }` not found).
+   */ resolveCheckpointQuery(query) {
+        if ('number' in query) {
+            return Promise.resolve(query.number);
+        }
+        if ('slot' in query) {
+            return this.stores.blocks.getCheckpointNumberBySlot(query.slot);
+        }
+        // tag variant
+        switch(query.tag){
+            case 'checkpointed':
+                return this.stores.blocks.getLatestCheckpointNumber();
+            case 'proven':
+                return this.stores.blocks.getProvenCheckpointNumber();
+            case 'finalized':
+                return this.stores.blocks.getFinalizedCheckpointNumber();
+        }
+    }
+    /**
+   * Resolves a {@link CheckpointsQuery} to a concrete `{from, limit}` pair used by BlockStore,
+   * or undefined when the epoch has no checkpoints.
+   */ async resolveCheckpointsQuery(query) {
+        if ('from' in query) {
+            return query;
+        }
+        const numbers = await this.getCheckpointNumbersForEpoch(query.epoch);
+        if (numbers.length === 0) {
+            return undefined;
+        }
+        return {
+            from: numbers[0],
+            limit: numbers.length
+        };
+    }
+    async getCheckpoint(query) {
+        const number = await this.resolveCheckpointQuery(query);
+        if (number === undefined || number === 0) {
+            return undefined;
+        }
+        const data = await this.stores.blocks.getCheckpointData(number);
+        if (!data) {
+            return undefined;
+        }
+        return this.getPublishedCheckpointFromCheckpointData(data);
+    }
+    async getCheckpoints(query) {
+        const resolved = await this.resolveCheckpointsQuery(query);
+        if (!resolved) {
+            return [];
+        }
+        const checkpoints = await this.stores.blocks.getRangeOfCheckpoints(resolved.from, resolved.limit);
+        return Promise.all(checkpoints.map((ch)=>this.getPublishedCheckpointFromCheckpointData(ch)));
+    }
+    async getCheckpointData(query) {
+        const number = await this.resolveCheckpointQuery(query);
+        if (number === undefined || number === 0) {
+            return undefined;
+        }
+        return this.stores.blocks.getCheckpointData(number);
+    }
+    async getCheckpointsData(query) {
+        const resolved = await this.resolveCheckpointsQuery(query);
+        if (!resolved) {
+            return [];
+        }
+        return this.stores.blocks.getRangeOfCheckpoints(resolved.from, resolved.limit);
+    }
+    getProposedCheckpointData(query) {
+        if (!query || 'tag' in query) {
+            return this.stores.blocks.getLastProposedCheckpoint();
+        }
+        if ('number' in query) {
+            return this.stores.blocks.getProposedCheckpointByNumber(query.number);
+        }
+        return this.stores.blocks.getProposedCheckpointBySlot(query.slot);
+    }
+    getTxEffect(txHash) {
+        return this.stores.blocks.getTxEffect(txHash);
+    }
+    getSettledTxReceipt(txHash) {
+        return this.stores.blocks.getSettledTxReceipt(txHash, this.l1Constants);
+    }
+    isPendingChainInvalid() {
+        return this.getPendingChainValidationStatus().then((status)=>!status.valid);
+    }
+    async getPendingChainValidationStatus() {
+        return await this.stores.blocks.getPendingChainValidationStatus() ?? {
+            valid: true
+        };
+    }
+    getPrivateLogsByTags(query) {
+        return this.stores.logs.getPrivateLogsByTags(query);
+    }
+    getPublicLogsByTags(query) {
+        return this.stores.logs.getPublicLogsByTags(query);
+    }
+    getContractClass(id) {
+        return this.stores.contractClasses.getContractClass(id);
+    }
+    getBytecodeCommitment(id) {
+        return this.stores.contractClasses.getBytecodeCommitment(id);
+    }
+    async getContract(address, maybeTimestamp) {
+        let timestamp;
+        if (maybeTimestamp === undefined) {
+            const latestBlockData = await this.getBlockData({
+                tag: 'proposed'
+            });
+            timestamp = latestBlockData ? latestBlockData.header.globalVariables.timestamp : 0n;
+        } else {
+            timestamp = maybeTimestamp;
+        }
+        return this.stores.contractInstances.getContractInstance(address, timestamp);
+    }
+    getContractClassIds() {
+        return this.stores.contractClasses.getContractClassIds();
+    }
+    /** Looks up a public function name given a selector. */ getDebugFunctionName(_address, selector) {
+        return Promise.resolve(this.stores.functionNames.get(selector));
+    }
+    /** Register public function signatures so they can be looked up by selector. */ registerContractFunctionSignatures(signatures) {
+        return this.stores.functionNames.register(signatures);
+    }
+    getL1ToL2Messages(checkpointNumber) {
+        return this.stores.messages.getL1ToL2Messages(checkpointNumber);
+    }
+    getL1ToL2MessageIndex(l1ToL2Message) {
+        return this.stores.messages.getL1ToL2MessageIndex(l1ToL2Message);
+    }
+    async getPublishedCheckpointFromCheckpointData(checkpoint) {
+        const blocksForCheckpoint = await this.stores.blocks.getBlocksForCheckpoint(checkpoint.checkpointNumber);
+        if (!blocksForCheckpoint) {
+            throw new Error(`Blocks for checkpoint ${checkpoint.checkpointNumber} not found`);
+        }
+        const fullCheckpoint = new Checkpoint(checkpoint.archive, checkpoint.header, blocksForCheckpoint, checkpoint.checkpointNumber, checkpoint.feeAssetPriceModifier);
+        return new PublishedCheckpoint(fullCheckpoint, checkpoint.l1, checkpoint.attestations);
+    }
+    getBlocksForSlot(slotNumber) {
+        return this.stores.blocks.getBlocksForSlot(slotNumber);
+    }
+    /** Returns just the checkpoint numbers for all checkpoints whose slot falls within the given epoch. */ getCheckpointNumbersForEpoch(epochNumber) {
+        if (!this.l1Constants) {
+            throw new Error('L1 constants not set');
+        }
+        const [start, end] = getSlotRangeForEpoch(epochNumber, this.l1Constants);
+        return this.stores.blocks.getCheckpointNumbersForSlotRange(start, end);
+    }
+    async getBlock(query) {
+        const resolved = await this.resolveBlockQuery(query);
+        if (resolved === undefined) {
+            return undefined;
+        }
+        if (this.isGenesisBlockQuery(resolved)) {
+            return this.getGenesisBlock();
+        }
+        return this.stores.blocks.getBlock(resolved);
+    }
+    /**
+   * Range queries iterate physical blocks only; the genesis block is NOT prepended.
+   * `L2BlockStream` consumers (`world-state.handleL2Blocks`, etc.) emit `blocks-added` events for
+   * real blocks and would be surprised by a synthetic block 0. Use {@link getBlock} or
+   * {@link getBlockData} for genesis-aware single-block lookups.
+   */ async getBlocks(query) {
+        const resolved = await this.resolveBlocksQuery(query);
+        return resolved ? this.stores.blocks.getBlocks(resolved) : [];
+    }
+    async getBlockData(query) {
+        const resolved = await this.resolveBlockQuery(query);
+        if (resolved === undefined) {
+            return undefined;
+        }
+        if (this.isGenesisBlockQuery(resolved)) {
+            return this.getGenesisBlockData();
+        }
+        return this.stores.blocks.getBlockData(resolved);
+    }
+    /** See {@link getBlocks} — range queries do not prepend the genesis block. */ async getBlocksData(query) {
+        const resolved = await this.resolveBlocksQuery(query);
+        return resolved ? this.stores.blocks.getBlocksData(resolved) : [];
+    }
+    /**
+   * Resolves a {@link BlockQuery} to either the genesis sentinel or a {@link ResolvedBlockQuery}
+   * understood by BlockStore. Detects every shape that points at block 0 — `{number:0}`,
+   * `{hash}` matching the initial header, `{archive}` matching the post-genesis archive root,
+   * and `{tag}` resolving to 0 — and rewrites them to the sentinel so callers branch once.
+   */ async resolveBlockQuery(query) {
+        if ('number' in query) {
+            return query.number === BlockNumber.ZERO ? {
+                genesis: true
+            } : query;
+        }
+        if ('hash' in query) {
+            return query.hash.equals(this.initialBlockHash) ? {
+                genesis: true
+            } : query;
+        }
+        if ('archive' in query) {
+            return query.archive.equals(this.genesisArchiveRoot) ? {
+                genesis: true
+            } : query;
+        }
+        const number = await this.resolveBlockTag(query.tag);
+        if (number === BlockNumber.ZERO) {
+            return {
+                genesis: true
+            };
+        }
+        return {
+            number
+        };
+    }
+    /** Maps a {@link BlockTag} to the matching block number for the current chain state. */ resolveBlockTag(tag) {
+        switch(tag){
+            case 'latest':
+            case 'proposed':
+                return this.stores.blocks.getLatestL2BlockNumber();
+            case 'checkpointed':
+                return this.stores.blocks.getCheckpointedL2BlockNumber();
+            case 'proven':
+                return this.stores.blocks.getProvenBlockNumber();
+            case 'finalized':
+                return this.stores.blocks.getFinalizedL2BlockNumber();
+        }
+    }
+    /**
+   * Converts an epoch-based BlocksQuery to a from/limit query using l1Constants.
+   * Returns undefined when the epoch has no checkpoints, so callers can return [] without
+   * entering BlockStore. Reads only the two endpoint checkpoints rather than the whole epoch.
+   */ async resolveBlocksQuery(query) {
+        if (!('epoch' in query)) {
+            if (query.from < INITIAL_L2_BLOCK_NUM) {
+                throw new Error(`getBlocks/getBlocksData: 'from' must be >= ${INITIAL_L2_BLOCK_NUM}, got ${query.from}. ` + `Use getBlock({number:0})/getBlockData({number:0}) for genesis-aware single-block lookups.`);
+            }
+            return query;
+        }
+        const checkpointNumbers = await this.getCheckpointNumbersForEpoch(query.epoch);
+        if (checkpointNumbers.length === 0) {
+            return undefined;
+        }
+        const firstNumber = checkpointNumbers[0];
+        const lastNumber = checkpointNumbers[checkpointNumbers.length - 1];
+        const first = await this.stores.blocks.getCheckpointData(firstNumber);
+        if (!first) {
+            return undefined;
+        }
+        const last = firstNumber === lastNumber ? first : await this.stores.blocks.getCheckpointData(lastNumber);
+        if (!last) {
+            return undefined;
+        }
+        const from = BlockNumber(first.startBlock);
+        const limit = last.startBlock + last.blockCount - first.startBlock;
+        return {
+            from,
+            limit,
+            onlyCheckpointed: true
+        };
+    }
+}