@aztec/archiver 0.0.1-commit.d431d1c → 0.0.1-commit.d939eb5aa

package/dest/store/kv_archiver_store.js

@@ -1,14 +1,13 @@
 import { toArray } from '@aztec/foundation/iterable';
 import { createLogger } from '@aztec/foundation/log';
 import { FunctionSelector } from '@aztec/stdlib/abi';
-import { L2BlockHash } from '@aztec/stdlib/block';
 import { join } from 'path';
 import { BlockStore } from './block_store.js';
 import { ContractClassStore } from './contract_class_store.js';
 import { ContractInstanceStore } from './contract_instance_store.js';
 import { LogStore } from './log_store.js';
 import { MessageStore } from './message_store.js';
-export const ARCHIVER_DB_VERSION = 5;
+export const ARCHIVER_DB_VERSION = 6;
 export const MAX_FUNCTION_SIGNATURES = 1000;
 export const MAX_FUNCTION_NAME_LEN = 256;
 /**
@@ -34,6 +33,9 @@ export const MAX_FUNCTION_NAME_LEN = 256;
         this.#contractClassStore = new ContractClassStore(db);
         this.#contractInstanceStore = new ContractInstanceStore(db);
     }
+    /** Returns the underlying block store. Used by L2TipsCache. */ get blockStore() {
+        return this.#blockStore;
+    }
     /** Opens a new transaction to the underlying store and runs all operations within it. */ transactionAsync(callback) {
         return this.db.transactionAsync(callback);
     }
@@ -52,6 +54,9 @@ export const MAX_FUNCTION_NAME_LEN = 256;
     /** Closes the underlying data store. */ close() {
         return this.db.close();
     }
+    /** Computes the finalized block number based on the proven block number. */ getFinalizedL2BlockNumber() {
+        return this.#blockStore.getFinalizedL2BlockNumber();
+    }
     /** Looks up a public function name given a selector. */ getDebugFunctionName(_address, selector) {
         return Promise.resolve(this.functionNames.get(selector.toString()));
     }
@@ -90,12 +95,11 @@ export const MAX_FUNCTION_NAME_LEN = 256;
     }
     /**
    * Add new contract classes from an L2 block to the store's list.
-   * @param data - List of contract classes to be added.
-   * @param bytecodeCommitments - Bytecode commitments for the contract classes.
+   * @param data - List of contract classes (with bytecode commitments) to be added.
    * @param blockNumber - Number of the L2 block the contracts were registered in.
    * @returns True if the operation is successful.
-   */ async addContractClasses(data, bytecodeCommitments, blockNumber) {
-        return (await Promise.all(data.map((c, i)=>this.#contractClassStore.addContractClass(c, bytecodeCommitments[i], blockNumber)))).every(Boolean);
+   */ async addContractClasses(data, blockNumber) {
+        return (await Promise.all(data.map((c)=>this.#contractClassStore.addContractClass(c, c.publicBytecodeCommitment, blockNumber)))).every(Boolean);
     }
     async deleteContractClasses(data, blockNumber) {
         return (await Promise.all(data.map((c)=>this.#contractClassStore.deleteContractClasses(c, blockNumber)))).every(Boolean);
@@ -103,9 +107,6 @@ export const MAX_FUNCTION_NAME_LEN = 256;
     getBytecodeCommitment(contractClassId) {
         return this.#contractClassStore.getBytecodeCommitment(contractClassId);
     }
-    /** Adds private functions to a contract class. */ addFunctions(contractClassId, privateFunctions, utilityFunctions) {
-        return this.#contractClassStore.addFunctions(contractClassId, privateFunctions, utilityFunctions);
-    }
     /**
    * Add new contract instances from an L2 block to the store's list.
    * @param data - List of contract instances to be added.
@@ -129,11 +130,13 @@ export const MAX_FUNCTION_NAME_LEN = 256;
         return (await Promise.all(data.map((update, logIndex)=>this.#contractInstanceStore.deleteContractInstanceUpdate(update, timestamp, logIndex)))).every(Boolean);
     }
     /**
-   * Append new blocks to the store's list.
-   * @param blocks - The L2 blocks to be added to the store and the last processed L1 block.
+   * Append a new proposed block to the store.
+   * This is an uncheckpointed block that has been proposed by the sequencer but not yet included in a checkpoint on L1.
+   * For checkpointed blocks (already published to L1), use addCheckpoints() instead.
+   * @param block - The proposed L2 block to be added to the store.
    * @returns True if the operation is successful.
-   */ addBlocks(blocks, opts = {}) {
-        return this.#blockStore.addBlocks(blocks, opts);
+   */ addProposedBlock(block, opts = {}) {
+        return this.#blockStore.addProposedBlock(block, opts);
     }
     /**
    * Returns an array of checkpoint objects
@@ -147,16 +150,14 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * Returns the number of the latest block
    * @returns The number of the latest block
    */ getLatestBlockNumber() {
-        return this.#blockStore.getLatestBlockNumber();
+        return this.#blockStore.getLatestL2BlockNumber();
     }
     /**
-   * Unwinds checkpoints from the database
-   * @param from -  The tip of the chain, passed for verification purposes,
-   *                ensuring that we don't end up deleting something we did not intend
-   * @param checkpointsToUnwind - The number of checkpoints we are to unwind
-   * @returns True if the operation is successful
-   */ unwindCheckpoints(from, checkpointsToUnwind) {
-        return this.#blockStore.unwindCheckpoints(from, checkpointsToUnwind);
+   * Removes all checkpoints with checkpoint number > checkpointNumber.
+   * Also removes ALL blocks (both checkpointed and uncheckpointed) after the last block of the given checkpoint.
+   * @param checkpointNumber - Remove all checkpoints strictly after this one.
+   */ removeCheckpointsAfter(checkpointNumber) {
+        return this.#blockStore.removeCheckpointsAfter(checkpointNumber);
     }
     /**
    * Appends new checkpoints, and their blocks to the store's collection
@@ -193,7 +194,7 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * Returns the block for the given hash, or undefined if not exists.
    * @param blockHash - The block hash to return.
    */ getBlockByHash(blockHash) {
-        return this.#blockStore.getBlockByHash(L2BlockHash.fromField(blockHash));
+        return this.#blockStore.getBlockByHash(blockHash);
     }
     /**
    * Returns the block for the given archive root, or undefined if not exists.
@@ -229,7 +230,7 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * Returns the block header for the given hash, or undefined if not exists.
    * @param blockHash - The block hash to return.
    */ getBlockHeaderByHash(blockHash) {
-        return this.#blockStore.getBlockHeaderByHash(L2BlockHash.fromField(blockHash));
+        return this.#blockStore.getBlockHeaderByHash(blockHash);
     }
     /**
    * Returns the block header for the given archive root, or undefined if not exists.
@@ -238,6 +239,18 @@ export const MAX_FUNCTION_NAME_LEN = 256;
         return this.#blockStore.getBlockHeaderByArchive(archive);
     }
     /**
+   * Gets block metadata (without tx data) by block number.
+   * @param blockNumber - The block number to return.
+   */ getBlockData(blockNumber) {
+        return this.#blockStore.getBlockData(blockNumber);
+    }
+    /**
+   * Gets block metadata (without tx data) by archive root.
+   * @param archive - The archive root to return.
+   */ getBlockDataByArchive(archive) {
+        return this.#blockStore.getBlockDataByArchive(archive);
+    }
+    /**
    * Gets a tx effect.
    * @param txHash - The hash of the tx corresponding to the tx effect.
    * @returns The requested tx effect with block info (or undefined if not found).
@@ -248,8 +261,8 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * Gets a receipt of a settled tx.
    * @param txHash - The hash of a tx we try to get the receipt for.
    * @returns The requested tx receipt (or undefined if not found).
-   */ getSettledTxReceipt(txHash) {
-        return this.#blockStore.getSettledTxReceipt(txHash);
+   */ getSettledTxReceipt(txHash, l1Constants) {
+        return this.#blockStore.getSettledTxReceipt(txHash, l1Constants);
     }
     /**
    * Append new logs to the store's list.
@@ -296,9 +309,10 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * array implies no logs match that tag.
    * @param tags - The tags to search for.
    * @param page - The page number (0-indexed) for pagination. Returns at most 10 logs per tag per page.
-   */ getPrivateLogsByTags(tags, page) {
+   * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
+   */ getPrivateLogsByTags(tags, page, upToBlockNumber) {
         try {
-            return this.#logStore.getPrivateLogsByTags(tags, page);
+            return this.#logStore.getPrivateLogsByTags(tags, page, upToBlockNumber);
         } catch (err) {
             return Promise.reject(err);
         }
@@ -309,9 +323,10 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    * @param contractAddress - The contract address to search logs for.
    * @param tags - The tags to search for.
    * @param page - The page number (0-indexed) for pagination. Returns at most 10 logs per tag per page.
-   */ getPublicLogsByTagsFromContract(contractAddress, tags, page) {
+   * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
+   */ getPublicLogsByTagsFromContract(contractAddress, tags, page, upToBlockNumber) {
         try {
-            return this.#logStore.getPublicLogsByTagsFromContract(contractAddress, tags, page);
+            return this.#logStore.getPublicLogsByTagsFromContract(contractAddress, tags, page, upToBlockNumber);
         } catch (err) {
             return Promise.reject(err);
         }
@@ -350,13 +365,20 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    */ async setProvenCheckpointNumber(checkpointNumber) {
         await this.#blockStore.setProvenCheckpointNumber(checkpointNumber);
     }
-    async setBlockSynchedL1BlockNumber(l1BlockNumber) {
-        await this.#blockStore.setSynchedL1BlockNumber(l1BlockNumber);
+    /**
+   * Gets the number of the latest finalized checkpoint processed.
+   * @returns The number of the latest finalized checkpoint processed.
+   */ getFinalizedCheckpointNumber() {
+        return this.#blockStore.getFinalizedCheckpointNumber();
     }
     /**
-   * Stores the l1 block that messages have been synched until
-   */ async setMessageSynchedL1Block(l1Block) {
-        await this.#messageStore.setSynchedL1Block(l1Block);
+   * Stores the number of the latest finalized checkpoint processed.
+   * @param checkpointNumber - The number of the latest finalized checkpoint processed.
+   */ async setFinalizedCheckpointNumber(checkpointNumber) {
+        await this.#blockStore.setFinalizedCheckpointNumber(checkpointNumber);
+    }
+    async setBlockSynchedL1BlockNumber(l1BlockNumber) {
+        await this.#blockStore.setSynchedL1BlockNumber(l1BlockNumber);
     }
     /**
    * Returns the number of the most recent proven block
@@ -382,6 +404,9 @@ export const MAX_FUNCTION_NAME_LEN = 256;
     /** Deletes all L1 to L2 messages up until (excluding) the target checkpoint number. */ rollbackL1ToL2MessagesToCheckpoint(targetCheckpointNumber) {
         return this.#messageStore.rollbackL1ToL2MessagesToCheckpoint(targetCheckpointNumber);
     }
+    /** Atomically updates the message sync state: the L1 sync point and the inbox tree-in-progress marker. */ setMessageSyncState(l1Block, treeInProgress) {
+        return this.#messageStore.setMessageSyncState(l1Block, treeInProgress);
+    }
     /** Returns an async iterator to all L1 to L2 messages on the range. */ iterateL1ToL2Messages(range = {}) {
         return this.#messageStore.iterateL1ToL2Messages(range);
     }
@@ -395,6 +420,28 @@ export const MAX_FUNCTION_NAME_LEN = 256;
         return this.#blockStore.setPendingChainValidationStatus(status);
     }
     /**
+   * Gets the L2 block number of the proposed checkpoint.
+   * @returns The block number of the proposed checkpoint, or the checkpointed block number if none.
+   */ getProposedCheckpointL2BlockNumber() {
+        return this.#blockStore.getProposedCheckpointL2BlockNumber();
+    }
+    /** Returns the checkpoint data at the proposed tip */ getProposedCheckpoint() {
+        return this.#blockStore.getProposedCheckpoint();
+    }
+    /** Returns the proposed checkpoint data, or undefined if no proposed checkpoint exists. No fallback to confirmed. */ getProposedCheckpointOnly() {
+        return this.#blockStore.getProposedCheckpointOnly();
+    }
+    /**
+   * Set proposed checkpoint
+   * @param proposedCheckpoint
+   * @returns
+   */ setProposedCheckpoint(proposedCheckpoint) {
+        return this.#blockStore.setProposedCheckpoint(proposedCheckpoint);
+    }
+    /** Deletes the proposed checkpoint from storage. */ deleteProposedCheckpoint() {
+        return this.#blockStore.deleteProposedCheckpoint();
+    }
+    /**
    * Gets the number of the latest L2 block processed.
    * @returns The number of the latest L2 block processed.
    */ getCheckpointedL2BlockNumber() {
@@ -426,6 +473,9 @@ export const MAX_FUNCTION_NAME_LEN = 256;
    */ getCheckpointData(checkpointNumber) {
         return this.#blockStore.getCheckpointData(checkpointNumber);
     }
+    /** Returns checkpoint data for all checkpoints whose slot falls within the given range (inclusive). */ getCheckpointDataForSlotRange(startSlot, endSlot) {
+        return this.#blockStore.getCheckpointDataForSlotRange(startSlot, endSlot);
+    }
     /**
    * Gets all blocks that have the given slot number.
    * @param slotNumber - The slot number to search for.
@@ -435,9 +485,10 @@ export const MAX_FUNCTION_NAME_LEN = 256;
     }
     /**
    * Removes all blocks with block number > blockNumber.
+   * Does not remove any associated checkpoints.
    * @param blockNumber - The block number to remove after.
    * @returns The removed blocks (for event emission).
    */ removeBlocksAfter(blockNumber) {
-        return this.#blockStore.unwindBlocksAfter(blockNumber);
+        return this.#blockStore.removeBlocksAfter(blockNumber);
     }
 }

package/dest/store/l2_tips_cache.d.ts

@@ -0,0 +1,20 @@
+import { type L2Tips } from '@aztec/stdlib/block';
+import type { BlockStore } from './block_store.js';
+/**
+ * In-memory cache for L2 chain tips (proposed, checkpointed, proven, finalized).
+ * Populated from the BlockStore on first access, then kept up-to-date by the ArchiverDataStoreUpdater.
+ * Refresh calls should happen within the store transaction that mutates block data to ensure consistency.
+ */
+export declare class L2TipsCache {
+    #private;
+    private blockStore;
+    constructor(blockStore: BlockStore);
+    /** Returns the cached L2 tips. Loads from the block store on first call. */
+    getL2Tips(): Promise<L2Tips>;
+    /** Reloads the L2 tips from the block store. Should be called within the store transaction that mutates data. */
+    refresh(): Promise<void>;
+    private loadFromStore;
+    private getCheckpointIdForProposedCheckpoint;
+    private getCheckpointIdForBlock;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19jYWNoZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3N0b3JlL2wyX3RpcHNfY2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUtMLEtBQUssTUFBTSxFQUNaLE1BQU0scUJBQXFCLENBQUM7QUFFN0IsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFbkQ7Ozs7R0FJRztBQUNILHFCQUFhLFdBQVc7O0lBR1YsT0FBTyxDQUFDLFVBQVU7SUFBOUIsWUFBb0IsVUFBVSxFQUFFLFVBQVUsRUFBSTtJQUU5Qyw0RUFBNEU7SUFDckUsU0FBUyxJQUFJLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FFbEM7SUFFRCxpSEFBaUg7SUFDcEcsT0FBTyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FHcEM7WUFFYSxhQUFhO1lBMEViLG9DQUFvQztZQWFwQyx1QkFBdUI7Q0FhdEMifQ==

package/dest/store/l2_tips_cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2_tips_cache.d.ts","sourceRoot":"","sources":["../../src/store/l2_tips_cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,WAAW;;IAGV,OAAO,CAAC,UAAU;IAA9B,YAAoB,UAAU,EAAE,UAAU,EAAI;IAE9C,4EAA4E;IACrE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAElC;IAED,iHAAiH;IACpG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpC;YAEa,aAAa;YA0Eb,oCAAoC;YAapC,uBAAuB;CAatC"}

package/dest/store/l2_tips_cache.js

@@ -0,0 +1,109 @@
+import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
+import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
+import { GENESIS_BLOCK_HEADER_HASH, GENESIS_CHECKPOINT_HEADER_HASH } from '@aztec/stdlib/block';
+/**
+ * In-memory cache for L2 chain tips (proposed, checkpointed, proven, finalized).
+ * Populated from the BlockStore on first access, then kept up-to-date by the ArchiverDataStoreUpdater.
+ * Refresh calls should happen within the store transaction that mutates block data to ensure consistency.
+ */ export class L2TipsCache {
+    blockStore;
+    #tipsPromise;
+    constructor(blockStore){
+        this.blockStore = blockStore;
+    }
+    /** Returns the cached L2 tips. Loads from the block store on first call. */ getL2Tips() {
+        return this.#tipsPromise ??= this.loadFromStore();
+    }
+    /** Reloads the L2 tips from the block store. Should be called within the store transaction that mutates data. */ async refresh() {
+        this.#tipsPromise = this.loadFromStore();
+        await this.#tipsPromise;
+    }
+    async loadFromStore() {
+        const [latestBlockNumber, provenBlockNumber, proposedCheckpointBlockNumber, checkpointedBlockNumber, finalizedBlockNumber] = await Promise.all([
+            this.blockStore.getLatestL2BlockNumber(),
+            this.blockStore.getProvenBlockNumber(),
+            this.blockStore.getProposedCheckpointL2BlockNumber(),
+            this.blockStore.getCheckpointedL2BlockNumber(),
+            this.blockStore.getFinalizedL2BlockNumber()
+        ]);
+        const genesisBlockHeader = {
+            blockHash: GENESIS_BLOCK_HEADER_HASH,
+            checkpointNumber: CheckpointNumber.ZERO
+        };
+        const beforeInitialBlockNumber = BlockNumber(INITIAL_L2_BLOCK_NUM - 1);
+        const getBlockData = (blockNumber)=>blockNumber > beforeInitialBlockNumber ? this.blockStore.getBlockData(blockNumber) : genesisBlockHeader;
+        const [latestBlockData, provenBlockData, proposedCheckpointBlockData, checkpointedBlockData, finalizedBlockData] = await Promise.all([
+            latestBlockNumber,
+            provenBlockNumber,
+            proposedCheckpointBlockNumber,
+            checkpointedBlockNumber,
+            finalizedBlockNumber
+        ].map(getBlockData));
+        if (!latestBlockData || !provenBlockData || !finalizedBlockData || !checkpointedBlockData || !proposedCheckpointBlockData) {
+            throw new Error('Failed to load block data for L2 tips');
+        }
+        const [provenCheckpointId, finalizedCheckpointId, proposedCheckpointId, checkpointedCheckpointId] = await Promise.all([
+            this.getCheckpointIdForBlock(provenBlockData),
+            this.getCheckpointIdForBlock(finalizedBlockData),
+            this.getCheckpointIdForProposedCheckpoint(checkpointedBlockData),
+            this.getCheckpointIdForBlock(checkpointedBlockData)
+        ]);
+        return {
+            proposed: {
+                number: latestBlockNumber,
+                hash: latestBlockData.blockHash.toString()
+            },
+            proven: {
+                block: {
+                    number: provenBlockNumber,
+                    hash: provenBlockData.blockHash.toString()
+                },
+                checkpoint: provenCheckpointId
+            },
+            proposedCheckpoint: {
+                block: {
+                    number: proposedCheckpointBlockNumber,
+                    hash: proposedCheckpointBlockData.blockHash.toString()
+                },
+                checkpoint: proposedCheckpointId
+            },
+            finalized: {
+                block: {
+                    number: finalizedBlockNumber,
+                    hash: finalizedBlockData.blockHash.toString()
+                },
+                checkpoint: finalizedCheckpointId
+            },
+            checkpointed: {
+                block: {
+                    number: checkpointedBlockNumber,
+                    hash: checkpointedBlockData.blockHash.toString()
+                },
+                checkpoint: checkpointedCheckpointId
+            }
+        };
+    }
+    async getCheckpointIdForProposedCheckpoint(checkpointedBlockData) {
+        const checkpointData = await this.blockStore.getProposedCheckpointOnly();
+        if (!checkpointData) {
+            return this.getCheckpointIdForBlock(checkpointedBlockData);
+        }
+        return {
+            number: checkpointData.checkpointNumber,
+            hash: checkpointData.header.hash().toString()
+        };
+    }
+    async getCheckpointIdForBlock(blockData) {
+        const checkpointData = await this.blockStore.getCheckpointData(blockData.checkpointNumber);
+        if (!checkpointData) {
+            return {
+                number: CheckpointNumber.ZERO,
+                hash: GENESIS_CHECKPOINT_HEADER_HASH.toString()
+            };
+        }
+        return {
+            number: checkpointData.checkpointNumber,
+            hash: checkpointData.header.hash().toString()
+        };
+    }
+}

package/dest/store/log_store.d.ts

@@ -1,6 +1,7 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
 import type { AztecAsyncKVStore } from '@aztec/kv-store';
 import type { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { L2BlockNew } from '@aztec/stdlib/block';
+import { L2Block } from '@aztec/stdlib/block';
 import type { GetContractClassLogsResponse, GetPublicLogsResponse } from '@aztec/stdlib/interfaces/client';
 import { type LogFilter, type SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
 import type { BlockStore } from './block_store.js';
@@ -17,27 +18,29 @@ export declare class LogStore {
      * @param blocks - The blocks for which to add the logs.
      * @returns True if the operation is successful.
      */
-    addLogs(blocks: L2BlockNew[]): Promise<boolean>;
-    deleteLogs(blocks: L2BlockNew[]): Promise<boolean>;
+    addLogs(blocks: L2Block[]): Promise<boolean>;
+    deleteLogs(blocks: L2Block[]): Promise<boolean>;
     /**
      * Gets private logs that match any of the `tags`. For each tag, an array of matching logs is returned. An empty
      * array implies no logs match that tag.
      * @param tags - The tags to search for.
      * @param page - The page number (0-indexed) for pagination.
+     * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
      * @returns An array of log arrays, one per tag. Returns at most MAX_LOGS_PER_TAG logs per tag per page. If
      * MAX_LOGS_PER_TAG logs are returned for a tag, the caller should fetch the next page to check for more logs.
      */
-    getPrivateLogsByTags(tags: SiloedTag[], page?: number): Promise<TxScopedL2Log[][]>;
+    getPrivateLogsByTags(tags: SiloedTag[], page?: number, upToBlockNumber?: BlockNumber): Promise<TxScopedL2Log[][]>;
     /**
      * Gets public logs that match any of the `tags` from the specified contract. For each tag, an array of matching
      * logs is returned. An empty array implies no logs match that tag.
      * @param contractAddress - The contract address to search logs for.
      * @param tags - The tags to search for.
      * @param page - The page number (0-indexed) for pagination.
+     * @param upToBlockNumber - If set, only return logs from blocks up to and including this block number.
      * @returns An array of log arrays, one per tag. Returns at most MAX_LOGS_PER_TAG logs per tag per page. If
      * MAX_LOGS_PER_TAG logs are returned for a tag, the caller should fetch the next page to check for more logs.
      */
-    getPublicLogsByTagsFromContract(contractAddress: AztecAddress, tags: Tag[], page?: number): Promise<TxScopedL2Log[][]>;
+    getPublicLogsByTagsFromContract(contractAddress: AztecAddress, tags: Tag[], page?: number, upToBlockNumber?: BlockNumber): Promise<TxScopedL2Log[][]>;
     /**
      * Gets public logs based on the provided filter.
      * @param filter - The filter to apply to the logs.
@@ -51,4 +54,4 @@ export declare class LogStore {
      */
     getContractClassLogs(filter: LogFilter): Promise<GetContractClassLogsResponse>;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3N0b3JlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3RvcmUvbG9nX3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQU1BLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFpQixNQUFNLGlCQUFpQixDQUFDO0FBQ3hFLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ2hFLE9BQU8sRUFBZSxVQUFVLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUU5RCxPQUFPLEtBQUssRUFBRSw0QkFBNEIsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzNHLE9BQU8sRUFJTCxLQUFLLFNBQVMsRUFHZCxLQUFLLFNBQVMsRUFDZCxHQUFHLEVBQ0gsYUFBYSxFQUNkLE1BQU0sb0JBQW9CLENBQUM7QUFFNUIsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFbkQ7O0dBRUc7QUFDSCxxQkFBYSxRQUFROztJQWFqQixPQUFPLENBQUMsRUFBRTtJQUNWLE9BQU8sQ0FBQyxVQUFVO0lBRnBCLFlBQ1UsRUFBRSxFQUFFLGlCQUFpQixFQUNyQixVQUFVLEVBQUUsVUFBVSxFQUM5QixlQUFlLEdBQUUsTUFBYSxFQVUvQjtJQTRNRDs7OztPQUlHO0lBQ0gsT0FBTyxDQUFDLE1BQU0sRUFBRSxVQUFVLEVBQUUsR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBUzlDO0lBZ0JELFVBQVUsQ0FBQyxNQUFNLEVBQUUsVUFBVSxFQUFFLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQTJCakQ7SUFFRDs7Ozs7OztPQU9HO0lBQ0csb0JBQW9CLENBQUMsSUFBSSxFQUFFLFNBQVMsRUFBRSxFQUFFLElBQUksR0FBRSxNQUFVLEdBQUcsT0FBTyxDQUFDLGFBQWEsRUFBRSxFQUFFLENBQUMsQ0FRMUY7SUFFRDs7Ozs7Ozs7T0FRRztJQUNHLCtCQUErQixDQUNuQyxlQUFlLEVBQUUsWUFBWSxFQUM3QixJQUFJLEVBQUUsR0FBRyxFQUFFLEVBQ1gsSUFBSSxHQUFFLE1BQVUsR0FDZixPQUFPLENBQUMsYUFBYSxFQUFFLEVBQUUsQ0FBQyxDQWE1QjtJQUVEOzs7O09BSUc7SUFDSCxhQUFhLENBQUMsTUFBTSxFQUFFLFNBQVMsR0FBRyxPQUFPLENBQUMscUJBQXFCLENBQUMsQ0FRL0Q7SUE2RUQ7Ozs7T0FJRztJQUNILG9CQUFvQixDQUFDLE1BQU0sRUFBRSxTQUFTLEdBQUcsT0FBTyxDQUFDLDRCQUE0QixDQUFDLENBUTdFO0NBNkdGIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3N0b3JlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3RvcmUvbG9nX3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUk5RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUN4RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEVBQWEsT0FBTyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFekQsT0FBTyxLQUFLLEVBQUUsNEJBQTRCLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMzRyxPQUFPLEVBSUwsS0FBSyxTQUFTLEVBR2QsS0FBSyxTQUFTLEVBQ2QsR0FBRyxFQUNILGFBQWEsRUFDZCxNQUFNLG9CQUFvQixDQUFDO0FBSTVCLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRW5EOztHQUVHO0FBQ0gscUJBQWEsUUFBUTs7SUFhakIsT0FBTyxDQUFDLEVBQUU7SUFDVixPQUFPLENBQUMsVUFBVTtJQUZwQixZQUNVLEVBQUUsRUFBRSxpQkFBaUIsRUFDckIsVUFBVSxFQUFFLFVBQVUsRUFDOUIsZUFBZSxHQUFFLE1BQWEsRUFVL0I7SUFvT0Q7Ozs7T0FJRztJQUNILE9BQU8sQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVMzQztJQWNELFVBQVUsQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQTBEOUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNHLG9CQUFvQixDQUN4QixJQUFJLEVBQUUsU0FBUyxFQUFFLEVBQ2pCLElBQUksR0FBRSxNQUFVLEVBQ2hCLGVBQWUsQ0FBQyxFQUFFLFdBQVcsR0FDNUIsT0FBTyxDQUFDLGFBQWEsRUFBRSxFQUFFLENBQUMsQ0FnQjVCO0lBRUQ7Ozs7Ozs7OztPQVNHO0lBQ0csK0JBQStCLENBQ25DLGVBQWUsRUFBRSxZQUFZLEVBQzdCLElBQUksRUFBRSxHQUFHLEVBQUUsRUFDWCxJQUFJLEdBQUUsTUFBVSxFQUNoQixlQUFlLENBQUMsRUFBRSxXQUFXLEdBQzVCLE9BQU8sQ0FBQyxhQUFhLEVBQUUsRUFBRSxDQUFDLENBb0I1QjtJQUVEOzs7O09BSUc7SUFDSCxhQUFhLENBQUMsTUFBTSxFQUFFLFNBQVMsR0FBRyxPQUFPLENBQUMscUJBQXFCLENBQUMsQ0FRL0Q7SUErRkQ7Ozs7T0FJRztJQUNILG9CQUFvQixDQUFDLE1BQU0sRUFBRSxTQUFTLEdBQUcsT0FBTyxDQUFDLDRCQUE0QixDQUFDLENBUTdFO0NBNktGIn0=

package/dest/store/log_store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log_store.d.ts","sourceRoot":"","sources":["../../src/store/log_store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAe,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC3G,OAAO,EAIL,KAAK,SAAS,EAGd,KAAK,SAAS,EACd,GAAG,EACH,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,qBAAa,QAAQ;;IAajB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAFpB,YACU,EAAE,EAAE,iBAAiB,EACrB,UAAU,EAAE,UAAU,EAC9B,eAAe,GAAE,MAAa,EAU/B;IA4MD;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAS9C;IAgBD,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BjD;IAED;;;;;;;OAOG;IACG,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAQ1F;IAED;;;;;;;;OAQG;IACG,+BAA+B,CACnC,eAAe,EAAE,YAAY,EAC7B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAa5B;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ/D;IA6ED;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAQ7E;CA6GF"}
+{"version":3,"file":"log_store.d.ts","sourceRoot":"","sources":["../../src/store/log_store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAI9D,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAa,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC3G,OAAO,EAIL,KAAK,SAAS,EAGd,KAAK,SAAS,EACd,GAAG,EACH,aAAa,EACd,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,qBAAa,QAAQ;;IAajB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAFpB,YACU,EAAE,EAAE,iBAAiB,EACrB,UAAU,EAAE,UAAU,EAC9B,eAAe,GAAE,MAAa,EAU/B;IAoOD;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3C;IAcD,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA0D9C;IAED;;;;;;;;OAQG;IACG,oBAAoB,CACxB,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,GAAE,MAAU,EAChB,eAAe,CAAC,EAAE,WAAW,GAC5B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAgB5B;IAED;;;;;;;;;OASG;IACG,+BAA+B,CACnC,eAAe,EAAE,YAAY,EAC7B,IAAI,EAAE,GAAG,EAAE,EACX,IAAI,GAAE,MAAU,EAChB,eAAe,CAAC,EAAE,WAAW,GAC5B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAoB5B;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQ/D;IA+FD;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAQ7E;CA6KF"}