@aztec/archiver 0.7.2 → 0.7.4

package/dest/archiver/archiver_store.d.ts

@@ -0,0 +1,267 @@
+import { Fr } from '@aztec/circuits.js';
+import { AztecAddress } from '@aztec/foundation/aztec-address';
+import { ContractData, ExtendedContractData, L1ToL2Message, L2Block, L2BlockL2Logs, L2Tx, LogType, TxHash } from '@aztec/types';
+/**
+ * Interface describing a data store to be used by the archiver to store all its relevant data
+ * (blocks, encrypted logs, aztec contract data extended contract data).
+ */
+export interface ArchiverDataStore {
+    /**
+     * Append new blocks to the store's list.
+     * @param blocks - The L2 blocks to be added to the store.
+     * @returns True if the operation is successful.
+     */
+    addL2Blocks(blocks: L2Block[]): Promise<boolean>;
+    /**
+     * Gets up to `limit` amount of L2 blocks starting from `from`.
+     * @param from - Number of the first block to return (inclusive).
+     * @param limit - The number of blocks to return.
+     * @returns The requested L2 blocks.
+     */
+    getL2Blocks(from: number, limit: number): Promise<L2Block[]>;
+    /**
+     * Gets an l2 tx.
+     * @param txHash - The txHash of the l2 tx.
+     * @returns The requested L2 tx.
+     */
+    getL2Tx(txHash: TxHash): Promise<L2Tx | undefined>;
+    /**
+     * Append new logs to the store's list.
+     * @param data - The logs to be added to the store.
+     * @param logType - The type of the logs to be added to the store.
+     * @returns True if the operation is successful.
+     */
+    addLogs(data: L2BlockL2Logs[], logType: LogType): Promise<boolean>;
+    /**
+     * Append new pending L1 to L2 messages to the store.
+     * @param messages - The L1 to L2 messages to be added to the store.
+     * @returns True if the operation is successful.
+     */
+    addPendingL1ToL2Messages(messages: L1ToL2Message[]): Promise<boolean>;
+    /**
+     * Remove pending L1 to L2 messages from the store (if they were cancelled).
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful.
+     */
+    cancelPendingL1ToL2Messages(messageKeys: Fr[]): Promise<boolean>;
+    /**
+     * Messages that have been published in an L2 block are confirmed.
+     * Add them to the confirmed store, also remove them from the pending store.
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful.
+     */
+    confirmL1ToL2Messages(messageKeys: Fr[]): Promise<boolean>;
+    /**
+     * Gets up to `limit` amount of pending L1 to L2 messages, sorted by fee
+     * @param limit - The number of messages to return (by default NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP).
+     * @returns The requested L1 to L2 message keys.
+     */
+    getPendingL1ToL2MessageKeys(limit: number): Promise<Fr[]>;
+    /**
+     * Gets the confirmed L1 to L2 message corresponding to the given message key.
+     * @param messageKey - The message key to look up.
+     * @returns The requested L1 to L2 message or throws if not found.
+     */
+    getConfirmedL1ToL2Message(messageKey: Fr): Promise<L1ToL2Message>;
+    /**
+     * Gets up to `limit` amount of logs starting from `from`.
+     * @param from - Number of the L2 block to which corresponds the first logs to be returned.
+     * @param limit - The number of logs to return.
+     * @param logType - Specifies whether to return encrypted or unencrypted logs.
+     * @returns The requested logs.
+     */
+    getLogs(from: number, limit: number, logType: LogType): Promise<L2BlockL2Logs[]>;
+    /**
+     * Add new extended contract data from an L2 block to the store's list.
+     * @param data - List of contracts' data to be added.
+     * @param blockNum - Number of the L2 block the contract data was deployed in.
+     * @returns True if the operation is successful.
+     */
+    addExtendedContractData(data: ExtendedContractData[], blockNum: number): Promise<boolean>;
+    /**
+     * Get the extended contract data for this contract.
+     * @param contractAddress - The contract data address.
+     * @returns The extended contract data or undefined if not found.
+     */
+    getExtendedContractData(contractAddress: AztecAddress): Promise<ExtendedContractData | undefined>;
+    /**
+     * Lookup all extended contract data in an L2 block.
+     * @param blockNum - The block number to get all contract data from.
+     * @returns All extended contract data in the block (if found).
+     */
+    getExtendedContractDataInBlock(blockNum: number): Promise<ExtendedContractData[]>;
+    /**
+     * Get basic info for an L2 contract.
+     * Contains contract address & the ethereum portal address.
+     * @param contractAddress - The contract data address.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractData(contractAddress: AztecAddress): Promise<ContractData | undefined>;
+    /**
+     * Get basic info for an all L2 contracts deployed in a block.
+     * Contains contract address & the ethereum portal address.
+     * @param l2BlockNum - Number of the L2 block where contracts were deployed.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractDataInBlock(l2BlockNum: number): Promise<ContractData[] | undefined>;
+    /**
+     * Gets the number of the latest L2 block processed.
+     * @returns The number of the latest L2 block processed.
+     */
+    getBlockNumber(): Promise<number>;
+    /**
+     * Gets the length of L2 blocks in store.
+     * @returns The length of L2 Blocks stored.
+     */
+    getBlocksLength(): number;
+}
+/**
+ * Simple, in-memory implementation of an archiver data store.
+ */
+export declare class MemoryArchiverStore implements ArchiverDataStore {
+    /**
+     * An array containing all the L2 blocks that have been fetched so far.
+     */
+    private l2Blocks;
+    /**
+     * An array containing all the L2 Txs in the L2 blocks that have been fetched so far.
+     */
+    private l2Txs;
+    /**
+     * An array containing all the encrypted logs that have been fetched so far.
+     * Note: Index in the "outer" array equals to (corresponding L2 block's number - INITIAL_L2_BLOCK_NUM).
+     */
+    private encryptedLogs;
+    /**
+     * An array containing all the unencrypted logs that have been fetched so far.
+     * Note: Index in the "outer" array equals to (corresponding L2 block's number - INITIAL_L2_BLOCK_NUM).
+     */
+    private unencryptedLogs;
+    /**
+     * A sparse array containing all the extended contract data that have been fetched so far.
+     */
+    private extendedContractDataByBlock;
+    /**
+     * A mapping of contract address to extended contract data.
+     */
+    private extendedContractData;
+    /**
+     * Contains all the confirmed L1 to L2 messages (i.e. messages that were consumed in an L2 block)
+     * It is a map of entryKey to the corresponding L1 to L2 message and the number of times it has appeared
+     */
+    private confirmedL1ToL2Messages;
+    /**
+     * Contains all the pending L1 to L2 messages (accounts for duplication of messages)
+     */
+    private pendingL1ToL2Messages;
+    constructor();
+    /**
+     * Append new blocks to the store's list.
+     * @param blocks - The L2 blocks to be added to the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addL2Blocks(blocks: L2Block[]): Promise<boolean>;
+    /**
+     * Append new logs to the store's list.
+     * @param data - The logs to be added to the store.
+     * @param logType - The type of the logs to be added to the store.
+     * @returns True if the operation is successful.
+     */
+    addLogs(data: L2BlockL2Logs[], logType: LogType): Promise<boolean>;
+    /**
+     * Append new pending L1 to L2 messages to the store.
+     * @param messages - The L1 to L2 messages to be added to the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addPendingL1ToL2Messages(messages: L1ToL2Message[]): Promise<boolean>;
+    /**
+     * Remove pending L1 to L2 messages from the store (if they were cancelled).
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    cancelPendingL1ToL2Messages(messageKeys: Fr[]): Promise<boolean>;
+    /**
+     * Messages that have been published in an L2 block are confirmed.
+     * Add them to the confirmed store, also remove them from the pending store.
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    confirmL1ToL2Messages(messageKeys: Fr[]): Promise<boolean>;
+    /**
+     * Store new extended contract data from an L2 block to the store's list.
+     * @param data - List of contracts' data to be added.
+     * @param blockNum - Number of the L2 block the contract data was deployed in.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addExtendedContractData(data: ExtendedContractData[], blockNum: number): Promise<boolean>;
+    /**
+     * Gets up to `limit` amount of L2 blocks starting from `from`.
+     * @param from - Number of the first block to return (inclusive).
+     * @param limit - The number of blocks to return.
+     * @returns The requested L2 blocks.
+     */
+    getL2Blocks(from: number, limit: number): Promise<L2Block[]>;
+    /**
+     * Gets an l2 tx.
+     * @param txHash - The txHash of the l2 tx.
+     * @returns The requested L2 tx.
+     */
+    getL2Tx(txHash: TxHash): Promise<L2Tx | undefined>;
+    /**
+     * Gets up to `limit` amount of pending L1 to L2 messages, sorted by fee
+     * @param limit - The number of messages to return (by default NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP).
+     * @returns The requested L1 to L2 message keys.
+     */
+    getPendingL1ToL2MessageKeys(limit?: number): Promise<Fr[]>;
+    /**
+     * Gets the confirmed L1 to L2 message corresponding to the given message key.
+     * @param messageKey - The message key to look up.
+     * @returns The requested L1 to L2 message or throws if not found.
+     */
+    getConfirmedL1ToL2Message(messageKey: Fr): Promise<L1ToL2Message>;
+    /**
+     * Gets up to `limit` amount of logs starting from `from`.
+     * @param from - Number of the L2 block to which corresponds the first logs to be returned.
+     * @param limit - The number of logs to return.
+     * @param logType - Specifies whether to return encrypted or unencrypted logs.
+     * @returns The requested logs.
+     */
+    getLogs(from: number, limit: number, logType: LogType): Promise<L2BlockL2Logs[]>;
+    /**
+     * Get the extended contract data for this contract.
+     * @param contractAddress - The contract data address.
+     * @returns The extended contract data or undefined if not found.
+     */
+    getExtendedContractData(contractAddress: AztecAddress): Promise<ExtendedContractData | undefined>;
+    /**
+     * Lookup all contract data in an L2 block.
+     * @param blockNum - The block number to get all contract data from.
+     * @returns All extended contract data in the block (if found).
+     */
+    getExtendedContractDataInBlock(blockNum: number): Promise<ExtendedContractData[]>;
+    /**
+     * Get basic info for an L2 contract.
+     * Contains contract address & the ethereum portal address.
+     * @param contractAddress - The contract data address.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractData(contractAddress: AztecAddress): Promise<ContractData | undefined>;
+    /**
+     * Get basic info for an all L2 contracts deployed in a block.
+     * Contains contract address & the ethereum portal address.
+     * @param l2BlockNum - Number of the L2 block where contracts were deployed.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractDataInBlock(l2BlockNum: number): Promise<ContractData[] | undefined>;
+    /**
+     * Gets the number of the latest L2 block processed.
+     * @returns The number of the latest L2 block processed.
+     */
+    getBlockNumber(): Promise<number>;
+    /**
+     * Gets the length of L2 blocks in store.
+     * @returns The length of L2 Blocks array.
+     */
+    getBlocksLength(): number;
+}
+//# sourceMappingURL=archiver_store.d.ts.map

package/dest/archiver/archiver_store.d.ts.map

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

package/dest/archiver/archiver_store.js

@@ -0,0 +1,256 @@
+import { NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP } from '@aztec/circuits.js';
+import { INITIAL_L2_BLOCK_NUM, LogType, } from '@aztec/types';
+import { L1ToL2MessageStore, PendingL1ToL2MessageStore } from './l1_to_l2_message_store.js';
+/**
+ * Simple, in-memory implementation of an archiver data store.
+ */
+export class MemoryArchiverStore {
+    constructor() {
+        /**
+         * An array containing all the L2 blocks that have been fetched so far.
+         */
+        this.l2Blocks = [];
+        /**
+         * An array containing all the L2 Txs in the L2 blocks that have been fetched so far.
+         */
+        this.l2Txs = [];
+        /**
+         * An array containing all the encrypted logs that have been fetched so far.
+         * Note: Index in the "outer" array equals to (corresponding L2 block's number - INITIAL_L2_BLOCK_NUM).
+         */
+        this.encryptedLogs = [];
+        /**
+         * An array containing all the unencrypted logs that have been fetched so far.
+         * Note: Index in the "outer" array equals to (corresponding L2 block's number - INITIAL_L2_BLOCK_NUM).
+         */
+        this.unencryptedLogs = [];
+        /**
+         * A sparse array containing all the extended contract data that have been fetched so far.
+         */
+        this.extendedContractDataByBlock = [];
+        /**
+         * A mapping of contract address to extended contract data.
+         */
+        this.extendedContractData = new Map();
+        /**
+         * Contains all the confirmed L1 to L2 messages (i.e. messages that were consumed in an L2 block)
+         * It is a map of entryKey to the corresponding L1 to L2 message and the number of times it has appeared
+         */
+        this.confirmedL1ToL2Messages = new L1ToL2MessageStore();
+        /**
+         * Contains all the pending L1 to L2 messages (accounts for duplication of messages)
+         */
+        this.pendingL1ToL2Messages = new PendingL1ToL2MessageStore();
+    }
+    /**
+     * Append new blocks to the store's list.
+     * @param blocks - The L2 blocks to be added to the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addL2Blocks(blocks) {
+        this.l2Blocks.push(...blocks);
+        this.l2Txs.push(...blocks.flatMap(b => b.getTxs()));
+        return Promise.resolve(true);
+    }
+    /**
+     * Append new logs to the store's list.
+     * @param data - The logs to be added to the store.
+     * @param logType - The type of the logs to be added to the store.
+     * @returns True if the operation is successful.
+     */
+    addLogs(data, logType) {
+        logType === LogType.ENCRYPTED ? this.encryptedLogs.push(...data) : this.unencryptedLogs.push(...data);
+        return Promise.resolve(true);
+    }
+    /**
+     * Append new pending L1 to L2 messages to the store.
+     * @param messages - The L1 to L2 messages to be added to the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addPendingL1ToL2Messages(messages) {
+        for (const msg of messages) {
+            this.pendingL1ToL2Messages.addMessage(msg.entryKey, msg);
+        }
+        return Promise.resolve(true);
+    }
+    /**
+     * Remove pending L1 to L2 messages from the store (if they were cancelled).
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    cancelPendingL1ToL2Messages(messageKeys) {
+        messageKeys.forEach(messageKey => {
+            this.pendingL1ToL2Messages.removeMessage(messageKey);
+        });
+        return Promise.resolve(true);
+    }
+    /**
+     * Messages that have been published in an L2 block are confirmed.
+     * Add them to the confirmed store, also remove them from the pending store.
+     * @param messageKeys - The message keys to be removed from the store.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    confirmL1ToL2Messages(messageKeys) {
+        messageKeys.forEach(messageKey => {
+            this.confirmedL1ToL2Messages.addMessage(messageKey, this.pendingL1ToL2Messages.getMessage(messageKey));
+            this.pendingL1ToL2Messages.removeMessage(messageKey);
+        });
+        return Promise.resolve(true);
+    }
+    /**
+     * Store new extended contract data from an L2 block to the store's list.
+     * @param data - List of contracts' data to be added.
+     * @param blockNum - Number of the L2 block the contract data was deployed in.
+     * @returns True if the operation is successful (always in this implementation).
+     */
+    addExtendedContractData(data, blockNum) {
+        // Add to the contracts mapping
+        for (const contractData of data) {
+            const key = contractData.contractData.contractAddress.toString();
+            this.extendedContractData.set(key, contractData);
+        }
+        // Add the index per block
+        if (this.extendedContractDataByBlock[blockNum]?.length) {
+            this.extendedContractDataByBlock[blockNum]?.push(...data);
+        }
+        else {
+            this.extendedContractDataByBlock[blockNum] = [...data];
+        }
+        return Promise.resolve(true);
+    }
+    /**
+     * Gets up to `limit` amount of L2 blocks starting from `from`.
+     * @param from - Number of the first block to return (inclusive).
+     * @param limit - The number of blocks to return.
+     * @returns The requested L2 blocks.
+     */
+    getL2Blocks(from, limit) {
+        // Return an empty array if we are outside of range
+        if (limit < 1) {
+            throw new Error(`Invalid block range from: ${from}, limit: ${limit}`);
+        }
+        if (from < INITIAL_L2_BLOCK_NUM || from > this.l2Blocks.length) {
+            return Promise.resolve([]);
+        }
+        const startIndex = from - INITIAL_L2_BLOCK_NUM;
+        const endIndex = startIndex + limit;
+        return Promise.resolve(this.l2Blocks.slice(startIndex, endIndex));
+    }
+    /**
+     * Gets an l2 tx.
+     * @param txHash - The txHash of the l2 tx.
+     * @returns The requested L2 tx.
+     */
+    getL2Tx(txHash) {
+        const l2Tx = this.l2Txs.find(tx => tx.txHash.equals(txHash));
+        return Promise.resolve(l2Tx);
+    }
+    /**
+     * Gets up to `limit` amount of pending L1 to L2 messages, sorted by fee
+     * @param limit - The number of messages to return (by default NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP).
+     * @returns The requested L1 to L2 message keys.
+     */
+    getPendingL1ToL2MessageKeys(limit = NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP) {
+        return Promise.resolve(this.pendingL1ToL2Messages.getMessageKeys(limit));
+    }
+    /**
+     * Gets the confirmed L1 to L2 message corresponding to the given message key.
+     * @param messageKey - The message key to look up.
+     * @returns The requested L1 to L2 message or throws if not found.
+     */
+    getConfirmedL1ToL2Message(messageKey) {
+        const message = this.confirmedL1ToL2Messages.getMessage(messageKey);
+        if (!message) {
+            throw new Error(`L1 to L2 Message with key ${messageKey.toString()} not found in the confirmed messages store`);
+        }
+        return Promise.resolve(message);
+    }
+    /**
+     * Gets up to `limit` amount of logs starting from `from`.
+     * @param from - Number of the L2 block to which corresponds the first logs to be returned.
+     * @param limit - The number of logs to return.
+     * @param logType - Specifies whether to return encrypted or unencrypted logs.
+     * @returns The requested logs.
+     */
+    getLogs(from, limit, logType) {
+        if (from < INITIAL_L2_BLOCK_NUM || limit < 1) {
+            throw new Error(`Invalid block range from: ${from}, limit: ${limit}`);
+        }
+        const logs = logType === LogType.ENCRYPTED ? this.encryptedLogs : this.unencryptedLogs;
+        if (from > logs.length) {
+            return Promise.resolve([]);
+        }
+        const startIndex = from - INITIAL_L2_BLOCK_NUM;
+        const endIndex = startIndex + limit;
+        return Promise.resolve(logs.slice(startIndex, endIndex));
+    }
+    /**
+     * Get the extended contract data for this contract.
+     * @param contractAddress - The contract data address.
+     * @returns The extended contract data or undefined if not found.
+     */
+    getExtendedContractData(contractAddress) {
+        const result = this.extendedContractData.get(contractAddress.toString());
+        return Promise.resolve(result);
+    }
+    /**
+     * Lookup all contract data in an L2 block.
+     * @param blockNum - The block number to get all contract data from.
+     * @returns All extended contract data in the block (if found).
+     */
+    getExtendedContractDataInBlock(blockNum) {
+        if (blockNum > this.l2Blocks.length) {
+            return Promise.resolve([]);
+        }
+        return Promise.resolve(this.extendedContractDataByBlock[blockNum] || []);
+    }
+    /**
+     * Get basic info for an L2 contract.
+     * Contains contract address & the ethereum portal address.
+     * @param contractAddress - The contract data address.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractData(contractAddress) {
+        if (contractAddress.isZero()) {
+            return Promise.resolve(undefined);
+        }
+        for (const block of this.l2Blocks) {
+            for (const contractData of block.newContractData) {
+                if (contractData.contractAddress.equals(contractAddress)) {
+                    return Promise.resolve(contractData);
+                }
+            }
+        }
+        return Promise.resolve(undefined);
+    }
+    /**
+     * Get basic info for an all L2 contracts deployed in a block.
+     * Contains contract address & the ethereum portal address.
+     * @param l2BlockNum - Number of the L2 block where contracts were deployed.
+     * @returns ContractData with the portal address (if we didn't throw an error).
+     */
+    getContractDataInBlock(l2BlockNum) {
+        if (l2BlockNum > this.l2Blocks.length) {
+            return Promise.resolve([]);
+        }
+        const block = this.l2Blocks[l2BlockNum];
+        return Promise.resolve(block.newContractData);
+    }
+    /**
+     * Gets the number of the latest L2 block processed.
+     * @returns The number of the latest L2 block processed.
+     */
+    getBlockNumber() {
+        if (this.l2Blocks.length === 0)
+            return Promise.resolve(INITIAL_L2_BLOCK_NUM - 1);
+        return Promise.resolve(this.l2Blocks[this.l2Blocks.length - 1].number);
+    }
+    /**
+     * Gets the length of L2 blocks in store.
+     * @returns The length of L2 Blocks array.
+     */
+    getBlocksLength() {
+        return this.l2Blocks.length;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJjaGl2ZXJfc3RvcmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXJjaGl2ZXIvYXJjaGl2ZXJfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFNLG1DQUFtQyxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFN0UsT0FBTyxFQUdMLG9CQUFvQixFQUtwQixPQUFPLEdBRVIsTUFBTSxjQUFjLENBQUM7QUFFdEIsT0FBTyxFQUFFLGtCQUFrQixFQUFFLHlCQUF5QixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFxSTVGOztHQUVHO0FBQ0gsTUFBTSxPQUFPLG1CQUFtQjtJQTRDOUI7UUEzQ0E7O1dBRUc7UUFDSyxhQUFRLEdBQWMsRUFBRSxDQUFDO1FBRWpDOztXQUVHO1FBQ0ssVUFBSyxHQUFXLEVBQUUsQ0FBQztRQUUzQjs7O1dBR0c7UUFDSyxrQkFBYSxHQUFvQixFQUFFLENBQUM7UUFFNUM7OztXQUdHO1FBQ0ssb0JBQWUsR0FBb0IsRUFBRSxDQUFDO1FBRTlDOztXQUVHO1FBQ0ssZ0NBQTJCLEdBQTJDLEVBQUUsQ0FBQztRQUVqRjs7V0FFRztRQUNLLHlCQUFvQixHQUFzQyxJQUFJLEdBQUcsRUFBRSxDQUFDO1FBRTVFOzs7V0FHRztRQUNLLDRCQUF1QixHQUF1QixJQUFJLGtCQUFrQixFQUFFLENBQUM7UUFFL0U7O1dBRUc7UUFDSywwQkFBcUIsR0FBOEIsSUFBSSx5QkFBeUIsRUFBRSxDQUFDO0lBRTVFLENBQUM7SUFFaEI7Ozs7T0FJRztJQUNJLFdBQVcsQ0FBQyxNQUFpQjtRQUNsQyxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxHQUFHLE1BQU0sQ0FBQyxDQUFDO1FBQzlCLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUM7UUFDcEQs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

package/dest/archiver/archiver_store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=archiver_store.test.d.ts.map

package/dest/archiver/archiver_store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver_store.test.d.ts","sourceRoot":"","sources":["../../src/archiver/archiver_store.test.ts"],"names":[],"mappings":""}

package/dest/archiver/archiver_store.test.js

@@ -0,0 +1,61 @@
+import { INITIAL_L2_BLOCK_NUM, L2Block, L2BlockL2Logs, LogType } from '@aztec/types';
+import { MemoryArchiverStore } from './archiver_store.js';
+describe('Archiver Memory Store', () => {
+    let archiverStore;
+    beforeEach(() => {
+        archiverStore = new MemoryArchiverStore();
+    });
+    it('can store and retrieve blocks', async () => {
+        const blocks = Array(10)
+            .fill(0)
+            .map((_, index) => L2Block.random(index));
+        await archiverStore.addL2Blocks(blocks);
+        // Offset indices by INTIAL_L2_BLOCK_NUM to ensure we are correctly aligned
+        for (const [from, limit] of [
+            [0 + INITIAL_L2_BLOCK_NUM, 10],
+            [3 + INITIAL_L2_BLOCK_NUM, 3],
+            [1 + INITIAL_L2_BLOCK_NUM, 7],
+            [5 + INITIAL_L2_BLOCK_NUM, 8],
+            [10 + INITIAL_L2_BLOCK_NUM, 1],
+            [11 + INITIAL_L2_BLOCK_NUM, 1],
+        ]) {
+            const expected = blocks.slice(from - INITIAL_L2_BLOCK_NUM, from - INITIAL_L2_BLOCK_NUM + limit);
+            const actual = await archiverStore.getL2Blocks(from, limit);
+            expect(expected).toEqual(actual);
+        }
+    });
+    test.each([LogType.ENCRYPTED, LogType.UNENCRYPTED])('can store and retrieve logs', async (logType) => {
+        const logs = Array(10)
+            .fill(0)
+            .map(_ => L2BlockL2Logs.random(6, 3, 2));
+        await archiverStore.addLogs(logs, logType);
+        // Offset indices by INTIAL_L2_BLOCK_NUM to ensure we are correctly aligned
+        for (const [from, limit] of [
+            [0 + INITIAL_L2_BLOCK_NUM, 10],
+            [3 + INITIAL_L2_BLOCK_NUM, 3],
+            [1 + INITIAL_L2_BLOCK_NUM, 7],
+            [5 + INITIAL_L2_BLOCK_NUM, 8],
+            [10 + INITIAL_L2_BLOCK_NUM, 1],
+            [11 + INITIAL_L2_BLOCK_NUM, 1],
+        ]) {
+            const expected = logs.slice(from - INITIAL_L2_BLOCK_NUM, from - INITIAL_L2_BLOCK_NUM + limit);
+            const actual = await archiverStore.getLogs(from, limit, logType);
+            expect(expected).toEqual(actual);
+        }
+    });
+    it('throws if we try and request less than 1 block', async () => {
+        const blocks = Array(10)
+            .fill(0)
+            .map((_, index) => L2Block.random(index));
+        await archiverStore.addL2Blocks(blocks);
+        await expect(async () => await archiverStore.getL2Blocks(1, 0)).rejects.toThrow(`Invalid block range from: 1, limit: 0`);
+    });
+    test.each([LogType.ENCRYPTED, LogType.UNENCRYPTED])('throws if we try and request less than 1 log', async (logType) => {
+        const logs = Array(10)
+            .fill(0)
+            .map(_ => L2BlockL2Logs.random(6, 3, 2));
+        await archiverStore.addLogs(logs, logType);
+        await expect(async () => await archiverStore.getLogs(1, 0, logType)).rejects.toThrow(`Invalid block range from: 1, limit: 0`);
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXJjaGl2ZXJfc3RvcmUudGVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hcmNoaXZlci9hcmNoaXZlcl9zdG9yZS50ZXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxPQUFPLEVBQUUsYUFBYSxFQUFFLE9BQU8sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUVyRixPQUFPLEVBQXFCLG1CQUFtQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFN0UsUUFBUSxDQUFDLHVCQUF1QixFQUFFLEdBQUcsRUFBRTtJQUNyQyxJQUFJLGFBQWdDLENBQUM7SUFFckMsVUFBVSxDQUFDLEdBQUcsRUFBRTtRQUNkLGFBQWEsR0FBRyxJQUFJLG1CQUFtQixFQUFFLENBQUM7SUFDNUMsQ0FBQyxDQUFDLENBQUM7SUFFSCxFQUFFLENBQUMsK0JBQStCLEVBQUUsS0FBSyxJQUFJLEVBQUU7UUFDN0MsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLEVBQUUsQ0FBQzthQUNyQixJQUFJLENBQUMsQ0FBQyxDQUFDO2FBQ1AsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQzVDLE1BQU0sYUFBYSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUN4QywyRUFBMkU7UUFDM0UsS0FBSyxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssQ0FBQyxJQUFJO1lBQzFCLENBQUMsQ0FBQyxHQUFHLG9CQUFvQixFQUFFLEVBQUUsQ0FBQztZQUM5QixDQUFDLENBQUMsR0FBRyxvQkFBb0IsRUFBRSxDQUFDLENBQUM7WUFDN0IsQ0FBQyxDQUFDLEdBQUcsb0JBQW9CLEVBQUUsQ0FBQyxDQUFDO1lBQzdCLENBQUMsQ0FBQyxHQUFHLG9CQUFvQixFQUFFLENBQUMsQ0FBQztZQUM3QixDQUFDLEVBQUUsR0FBRyxv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

package/dest/archiver/config.d.ts

@@ -0,0 +1,39 @@
+import { L1Addresses } from '@aztec/types';
+/**
+ * There are 2 polling intervals used in this configuration. The first is the archiver polling interval, archiverPollingIntervalMS.
+ * This is the interval between successive calls to eth_blockNumber via viem.
+ * Results of calls to eth_blockNumber are cached by viem with this cache being updated periodically at the interval specified by viemPollingIntervalMS.
+ * As a result the maximum observed polling time for new blocks will be viemPollingIntervalMS + archiverPollingIntervalMS.
+ */
+/**
+ * The archiver configuration.
+ */
+export interface ArchiverConfig extends L1Addresses {
+    /**
+     * The url of the Ethereum RPC node.
+     */
+    rpcUrl: string;
+    /**
+     * The key for the ethereum node.
+     */
+    apiKey?: string;
+    /**
+     * The polling interval in ms for retrieving new L2 blocks and encrypted logs.
+     */
+    archiverPollingIntervalMS?: number;
+    /**
+     * The polling interval viem uses in ms
+     */
+    viemPollingIntervalMS?: number;
+    /**
+     * Eth block from which we start scanning for L2Blocks.
+     */
+    searchStartBlock: number;
+}
+/**
+ * Returns the archiver configuration from the environment variables.
+ * Note: If an environment variable is not set, the default value is used.
+ * @returns The archiver configuration.
+ */
+export declare function getConfigEnvVars(): ArchiverConfig;
+//# sourceMappingURL=config.d.ts.map

package/dest/archiver/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/archiver/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAuBjD"}