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

package/dest/store/contract_class_store.d.ts

@@ -0,0 +1,31 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { ContractClassPublic, ContractClassPublicWithCommitment } from '@aztec/stdlib/contract';
+/**
+ * LMDB-based contract class storage for the archiver.
+ */
+export declare class ContractClassStore {
+    #private;
+    private db;
+    constructor(db: AztecAsyncKVStore);
+    /**
+     * Adds multiple contract classes to the store.
+     * @param data - Contract classes (with bytecode commitments) to add.
+     * @param blockNumber - L2 block number where the classes were registered.
+     * @returns True if every insert succeeded.
+     */
+    addContractClasses(data: ContractClassPublicWithCommitment[], blockNumber: number): Promise<boolean>;
+    /**
+     * Removes multiple contract classes from the store, but only if they were registered at or after the given block.
+     * @param data - Contract classes to delete.
+     * @param blockNumber - Lower bound on the block number at which the classes were registered.
+     * @returns True if every delete succeeded.
+     */
+    deleteContractClasses(data: ContractClassPublic[], blockNumber: number): Promise<boolean>;
+    addContractClass(contractClass: ContractClassPublic, bytecodeCommitment: Fr, blockNumber: number): Promise<void>;
+    deleteContractClass(contractClass: ContractClassPublic, blockNumber: number): Promise<void>;
+    getContractClass(id: Fr): Promise<ContractClassPublic | undefined>;
+    getBytecodeCommitment(id: Fr): Promise<Fr | undefined>;
+    getContractClassIds(): Promise<Fr[]>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3Nfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZS9jb250cmFjdF9jbGFzc19zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFHcEQsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFFeEUsT0FBTyxLQUFLLEVBQ1YsbUJBQW1CLEVBRW5CLGlDQUFpQyxFQUNsQyxNQUFNLHdCQUF3QixDQUFDO0FBRWhDOztHQUVHO0FBQ0gscUJBQWEsa0JBQWtCOztJQUlqQixPQUFPLENBQUMsRUFBRTtJQUF0QixZQUFvQixFQUFFLEVBQUUsaUJBQWlCLEVBR3hDO0lBRUQ7Ozs7O09BS0c7SUFDRyxrQkFBa0IsQ0FBQyxJQUFJLEVBQUUsaUNBQWlDLEVBQUUsRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FJekc7SUFFRDs7Ozs7T0FLRztJQUNHLHFCQUFxQixDQUFDLElBQUksRUFBRSxtQkFBbUIsRUFBRSxFQUFFLFdBQVcsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUU5RjtJQUVLLGdCQUFnQixDQUNwQixhQUFhLEVBQUUsbUJBQW1CLEVBQ2xDLGtCQUFrQixFQUFFLEVBQUUsRUFDdEIsV0FBVyxFQUFFLE1BQU0sR0FDbEIsT0FBTyxDQUFDLElBQUksQ0FBQyxDQXdCZjtJQUVLLG1CQUFtQixDQUFDLGFBQWEsRUFBRSxtQkFBbUIsRUFBRSxXQUFXLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FhaEc7SUFFSyxnQkFBZ0IsQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxtQkFBbUIsR0FBRyxTQUFTLENBQUMsQ0FHdkU7SUFFSyxxQkFBcUIsQ0FBQyxFQUFFLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxFQUFFLEdBQUcsU0FBUyxDQUFDLENBRzNEO0lBRUssbUJBQW1CLElBQUksT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBRXpDO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract_class_store.d.ts","sourceRoot":"","sources":["../../src/store/contract_class_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAGpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AAExE,OAAO,KAAK,EACV,mBAAmB,EAEnB,iCAAiC,EAClC,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,qBAAa,kBAAkB;;IAIjB,OAAO,CAAC,EAAE;IAAtB,YAAoB,EAAE,EAAE,iBAAiB,EAGxC;IAED;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,iCAAiC,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIzG;IAED;;;;;OAKG;IACG,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9F;IAEK,gBAAgB,CACpB,aAAa,EAAE,mBAAmB,EAClC,kBAAkB,EAAE,EAAE,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAwBf;IAEK,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG;IAEK,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAGvE;IAEK,qBAAqB,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC,CAG3D;IAEK,mBAAmB,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,CAEzC;CACF"}

package/dest/store/contract_class_store.js

@@ -0,0 +1,98 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { toArray } from '@aztec/foundation/iterable';
+import { BufferReader, numToUInt8, serializeToBuffer } from '@aztec/foundation/serialize';
+import { isProtocolContractClass } from '@aztec/protocol-contracts';
+/**
+ * LMDB-based contract class storage for the archiver.
+ */ export class ContractClassStore {
+    db;
+    #contractClasses;
+    #bytecodeCommitments;
+    constructor(db){
+        this.db = db;
+        this.#contractClasses = db.openMap('archiver_contract_classes');
+        this.#bytecodeCommitments = db.openMap('archiver_bytecode_commitments');
+    }
+    /**
+   * Adds multiple contract classes to the store.
+   * @param data - Contract classes (with bytecode commitments) to add.
+   * @param blockNumber - L2 block number where the classes were registered.
+   * @returns True if every insert succeeded.
+   */ async addContractClasses(data, blockNumber) {
+        return (await Promise.all(data.map((c)=>this.addContractClass(c, c.publicBytecodeCommitment, blockNumber)))).every(Boolean);
+    }
+    /**
+   * Removes multiple contract classes from the store, but only if they were registered at or after the given block.
+   * @param data - Contract classes to delete.
+   * @param blockNumber - Lower bound on the block number at which the classes were registered.
+   * @returns True if every delete succeeded.
+   */ async deleteContractClasses(data, blockNumber) {
+        return (await Promise.all(data.map((c)=>this.deleteContractClass(c, blockNumber)))).every(Boolean);
+    }
+    async addContractClass(contractClass, bytecodeCommitment, blockNumber) {
+        await this.db.transactionAsync(async ()=>{
+            const key = contractClass.id.toString();
+            const existing = await this.#contractClasses.getAsync(key);
+            if (existing !== undefined) {
+                // Protocol contracts are preloaded at block 0, so a later on-chain (re-)publish of a bundled
+                // protocol class id is valid and must be a no-op. Keep the existing block-0 entry untouched
+                // (do not bump its block number) so it survives reorgs of the publishing block.
+                if (isProtocolContractClass(contractClass.id)) {
+                    return;
+                }
+                // An L1 reorg can re-present an already-stored checkpoint, replaying this class at the same
+                // block; treat that as a no-op. A duplicate at a different block still signals double-processing.
+                if (deserializeContractClassPublic(existing).l2BlockNumber === blockNumber) {
+                    return;
+                }
+                throw new Error(`Contract class ${key} already exists, cannot add again at block ${blockNumber}`);
+            }
+            await this.#contractClasses.set(key, serializeContractClassPublic({
+                ...contractClass,
+                l2BlockNumber: blockNumber
+            }));
+            await this.#bytecodeCommitments.set(key, bytecodeCommitment.toBuffer());
+        });
+    }
+    async deleteContractClass(contractClass, blockNumber) {
+        // Protocol contracts are preloaded at block 0 and must never be deleted, even when the block that
+        // (re-)published them on-chain is unwound by a reorg.
+        if (isProtocolContractClass(contractClass.id)) {
+            return;
+        }
+        const restoredContractClass = await this.#contractClasses.getAsync(contractClass.id.toString());
+        if (restoredContractClass && deserializeContractClassPublic(restoredContractClass).l2BlockNumber >= blockNumber) {
+            await this.db.transactionAsync(async ()=>{
+                await this.#contractClasses.delete(contractClass.id.toString());
+                await this.#bytecodeCommitments.delete(contractClass.id.toString());
+            });
+        }
+    }
+    async getContractClass(id) {
+        const contractClass = await this.#contractClasses.getAsync(id.toString());
+        return contractClass && {
+            ...deserializeContractClassPublic(contractClass),
+            id
+        };
+    }
+    async getBytecodeCommitment(id) {
+        const value = await this.#bytecodeCommitments.getAsync(id.toString());
+        return value === undefined ? undefined : Fr.fromBuffer(value);
+    }
+    async getContractClassIds() {
+        return (await toArray(this.#contractClasses.keysAsync())).map((key)=>Fr.fromHexString(key));
+    }
+}
+function serializeContractClassPublic(contractClass) {
+    return serializeToBuffer(contractClass.l2BlockNumber, numToUInt8(contractClass.version), contractClass.artifactHash, contractClass.packedBytecode.length, contractClass.packedBytecode, contractClass.privateFunctionsRoot);
+}
+function deserializeContractClassPublic(buffer) {
+    const reader = BufferReader.asReader(buffer);
+    return {
+        l2BlockNumber: reader.readNumber(),
+        version: reader.readUInt8(),
+        artifactHash: reader.readObject(Fr),
+        packedBytecode: reader.readBuffer(),
+        privateFunctionsRoot: reader.readObject(Fr)
+    };
+}

package/dest/store/contract_instance_store.d.ts

@@ -0,0 +1,51 @@
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import { type ContractInstanceUpdateWithAddress, type ContractInstanceWithAddress } from '@aztec/stdlib/contract';
+import type { UInt64 } from '@aztec/stdlib/types';
+type ContractInstanceUpdateKey = [string, string] | [string, string, number];
+/**
+ * LMDB-based contract instance storage for the archiver.
+ */
+export declare class ContractInstanceStore {
+    #private;
+    private db;
+    constructor(db: AztecAsyncKVStore);
+    /**
+     * Adds multiple contract instances to the store.
+     * @param data - Contract instances to add.
+     * @param blockNumber - L2 block number where the instances were deployed.
+     * @returns True if every insert succeeded.
+     */
+    addContractInstances(data: ContractInstanceWithAddress[], blockNumber: number): Promise<boolean>;
+    /**
+     * Removes multiple contract instances from the store.
+     * @param data - Contract instances to delete.
+     * @returns True if every delete succeeded.
+     */
+    deleteContractInstances(data: ContractInstanceWithAddress[]): Promise<boolean>;
+    /**
+     * Adds multiple contract instance updates to the store.
+     * @param data - Contract instance updates to add.
+     * @param timestamp - Timestamp at which the updates were scheduled.
+     * @returns True if every insert succeeded.
+     */
+    addContractInstanceUpdates(data: ContractInstanceUpdateWithAddress[], timestamp: UInt64): Promise<boolean>;
+    /**
+     * Removes multiple contract instance updates from the store.
+     * @param data - Contract instance updates to delete.
+     * @param timestamp - Timestamp at which the updates were scheduled.
+     * @returns True if every delete succeeded.
+     */
+    deleteContractInstanceUpdates(data: ContractInstanceUpdateWithAddress[], timestamp: UInt64): Promise<boolean>;
+    addContractInstance(contractInstance: ContractInstanceWithAddress, blockNumber: number): Promise<void>;
+    deleteContractInstance(contractInstance: ContractInstanceWithAddress): Promise<void>;
+    getUpdateKey(contractAddress: AztecAddress, timestamp: UInt64, logIndex?: number): ContractInstanceUpdateKey;
+    addContractInstanceUpdate(contractInstanceUpdate: ContractInstanceUpdateWithAddress, timestamp: UInt64, logIndex: number): Promise<void>;
+    deleteContractInstanceUpdate(contractInstanceUpdate: ContractInstanceUpdateWithAddress, timestamp: UInt64, logIndex: number): Promise<void>;
+    getCurrentContractInstanceClassId(address: AztecAddress, timestamp: UInt64, originalClassId: Fr): Promise<Fr>;
+    getContractInstance(address: AztecAddress, timestamp: UInt64): Promise<ContractInstanceWithAddress | undefined>;
+    getContractInstanceDeploymentBlockNumber(address: AztecAddress): Promise<number | undefined>;
+}
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfaW5zdGFuY2Vfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZS9jb250cmFjdF9pbnN0YW5jZV9zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQUV4RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEVBQ0wsS0FBSyxpQ0FBaUMsRUFDdEMsS0FBSywyQkFBMkIsRUFHakMsTUFBTSx3QkFBd0IsQ0FBQztBQUNoQyxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVsRCxLQUFLLHlCQUF5QixHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztBQUU3RTs7R0FFRztBQUNILHFCQUFhLHFCQUFxQjs7SUFLcEIsT0FBTyxDQUFDLEVBQUU7SUFBdEIsWUFBb0IsRUFBRSxFQUFFLGlCQUFpQixFQUl4QztJQUVEOzs7OztPQUtHO0lBQ0csb0JBQW9CLENBQUMsSUFBSSxFQUFFLDJCQUEyQixFQUFFLEVBQUUsV0FBVyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBRXJHO0lBRUQ7Ozs7T0FJRztJQUNHLHVCQUF1QixDQUFDLElBQUksRUFBRSwyQkFBMkIsRUFBRSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FFbkY7SUFFRDs7Ozs7T0FLRztJQUNHLDBCQUEwQixDQUFDLElBQUksRUFBRSxpQ0FBaUMsRUFBRSxFQUFFLFNBQVMsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUkvRztJQUVEOzs7OztPQUtHO0lBQ0csNkJBQTZCLENBQUMsSUFBSSxFQUFFLGlDQUFpQyxFQUFFLEVBQUUsU0FBUyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDLENBSWxIO0lBRUQsbUJBQW1CLENBQUMsZ0JBQWdCLEVBQUUsMkJBQTJCLEVBQUUsV0FBVyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBc0JyRztJQUVELHNCQUFzQixDQUFDLGdCQUFnQixFQUFFLDJCQUEyQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FVbkY7SUFFRCxZQUFZLENBQUMsZUFBZSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFFLFFBQVEsQ0FBQyxFQUFFLE1BQU0sR0FBRyx5QkFBeUIsQ0FNM0c7SUFFRCx5QkFBeUIsQ0FDdkIsc0JBQXNCLEVBQUUsaUNBQWlDLEVBQ3pELFNBQVMsRUFBRSxNQUFNLEVBQ2pCLFFBQVEsRUFBRSxNQUFNLEdBQ2YsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUtmO0lBRUQsNEJBQTRCLENBQzFCLHNCQUFzQixFQUFFLGlDQUFpQyxFQUN6RCxTQUFTLEVBQUUsTUFBTSxFQUNqQixRQUFRLEVBQUUsTUFBTSxHQUNmLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FFZjtJQUVLLGlDQUFpQyxDQUFDLE9BQU8sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxlQUFlLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FvQmxIO0lBRUssbUJBQW1CLENBQ3ZCLE9BQU8sRUFBRSxZQUFZLEVBQ3JCLFNBQVMsRUFBRSxNQUFNLEdBQ2hCLE9BQU8sQ0FBQywyQkFBMkIsR0FBRyxTQUFTLENBQUMsQ0FhbEQ7SUFFRCx3Q0FBd0MsQ0FBQyxPQUFPLEVBQUUsWUFBWSxHQUFHLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBRTNGO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract_instance_store.d.ts","sourceRoot":"","sources":["../../src/store/contract_instance_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAGjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,KAAK,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7E;;GAEG;AACH,qBAAa,qBAAqB;;IAKpB,OAAO,CAAC,EAAE;IAAtB,YAAoB,EAAE,EAAE,iBAAiB,EAIxC;IAED;;;;;OAKG;IACG,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErG;IAED;;;;OAIG;IACG,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnF;IAED;;;;;OAKG;IACG,0BAA0B,CAAC,IAAI,EAAE,iCAAiC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI/G;IAED;;;;;OAKG;IACG,6BAA6B,CAAC,IAAI,EAAE,iCAAiC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIlH;IAED,mBAAmB,CAAC,gBAAgB,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrG;IAED,sBAAsB,CAAC,gBAAgB,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnF;IAED,YAAY,CAAC,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAM3G;IAED,yBAAyB,CACvB,sBAAsB,EAAE,iCAAiC,EACzD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAKf;IAED,4BAA4B,CAC1B,sBAAsB,EAAE,iCAAiC,EACzD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;IAEK,iCAAiC,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAoBlH;IAEK,mBAAmB,CACvB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAalD;IAED,wCAAwC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE3F;CACF"}

package/dest/{archiver/kv_archiver_store → store}/contract_instance_store.js

@@ -1,6 +1,7 @@
+import { isProtocolContract } from '@aztec/protocol-contracts';
 import { SerializableContractInstance, SerializableContractInstanceUpdate } from '@aztec/stdlib/contract';
 /**
- * LMDB implementation of the ArchiverDataStore interface.
+ * LMDB-based contract instance storage for the archiver.
  */ export class ContractInstanceStore {
     db;
     #contractInstances;
@@ -12,13 +13,64 @@ import { SerializableContractInstance, SerializableContractInstanceUpdate } from
         this.#contractInstancePublishedAt = db.openMap('archiver_contract_instances_publication_block_number');
         this.#contractInstanceUpdates = db.openMap('archiver_contract_instance_updates');
     }
+    /**
+   * Adds multiple contract instances to the store.
+   * @param data - Contract instances to add.
+   * @param blockNumber - L2 block number where the instances were deployed.
+   * @returns True if every insert succeeded.
+   */ async addContractInstances(data, blockNumber) {
+        return (await Promise.all(data.map((c)=>this.addContractInstance(c, blockNumber)))).every(Boolean);
+    }
+    /**
+   * Removes multiple contract instances from the store.
+   * @param data - Contract instances to delete.
+   * @returns True if every delete succeeded.
+   */ async deleteContractInstances(data) {
+        return (await Promise.all(data.map((c)=>this.deleteContractInstance(c)))).every(Boolean);
+    }
+    /**
+   * Adds multiple contract instance updates to the store.
+   * @param data - Contract instance updates to add.
+   * @param timestamp - Timestamp at which the updates were scheduled.
+   * @returns True if every insert succeeded.
+   */ async addContractInstanceUpdates(data, timestamp) {
+        return (await Promise.all(data.map((update, logIndex)=>this.addContractInstanceUpdate(update, timestamp, logIndex)))).every(Boolean);
+    }
+    /**
+   * Removes multiple contract instance updates from the store.
+   * @param data - Contract instance updates to delete.
+   * @param timestamp - Timestamp at which the updates were scheduled.
+   * @returns True if every delete succeeded.
+   */ async deleteContractInstanceUpdates(data, timestamp) {
+        return (await Promise.all(data.map((update, logIndex)=>this.deleteContractInstanceUpdate(update, timestamp, logIndex)))).every(Boolean);
+    }
     addContractInstance(contractInstance, blockNumber) {
         return this.db.transactionAsync(async ()=>{
-            await this.#contractInstances.set(contractInstance.address.toString(), new SerializableContractInstance(contractInstance).toBuffer());
-            await this.#contractInstancePublishedAt.set(contractInstance.address.toString(), blockNumber);
+            const key = contractInstance.address.toString();
+            if (await this.#contractInstances.hasAsync(key)) {
+                // Protocol contracts are preloaded at block 0, so a later on-chain (re-)publish of a bundled
+                // protocol instance is valid and must be a no-op. Keep the existing block-0 entry untouched.
+                if (isProtocolContract(contractInstance.address)) {
+                    return;
+                }
+                const existingBlockNumber = await this.#contractInstancePublishedAt.getAsync(key);
+                // An L1 reorg can re-present an already-stored checkpoint, replaying this instance at the same
+                // block; treat that as a no-op. A duplicate at a different block still signals double-processing.
+                if (existingBlockNumber === blockNumber) {
+                    return;
+                }
+                throw new Error(`Contract instance at ${key} already exists (deployed at block ${existingBlockNumber}), cannot add again at block ${blockNumber}`);
+            }
+            await this.#contractInstances.set(key, new SerializableContractInstance(contractInstance).toBuffer());
+            await this.#contractInstancePublishedAt.set(key, blockNumber);
         });
     }
     deleteContractInstance(contractInstance) {
+        // Protocol contracts are preloaded at block 0 and must never be deleted, even when the block that
+        // (re-)published them on-chain is unwound by a reorg.
+        if (isProtocolContract(contractInstance.address)) {
+            return Promise.resolve();
+        }
         return this.db.transactionAsync(async ()=>{
             await this.#contractInstances.delete(contractInstance.address.toString());
             await this.#contractInstancePublishedAt.delete(contractInstance.address.toString());

package/dest/store/data_stores.d.ts

@@ -0,0 +1,68 @@
+import type { L1BlockId } from '@aztec/ethereum/l1-types';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { BlockHash } from '@aztec/stdlib/block';
+import type { ContractDataSource } from '@aztec/stdlib/contract';
+import { BlockStore } from './block_store.js';
+import { ContractClassStore } from './contract_class_store.js';
+import { ContractInstanceStore } from './contract_instance_store.js';
+import { FunctionNamesCache } from './function_names_cache.js';
+import { LogStore } from './log_store.js';
+import { MessageStore } from './message_store.js';
+export declare const ARCHIVER_DB_VERSION = 7;
+/**
+ * Represents the latest L1 block processed by the archiver for various objects in L2.
+ */
+export type ArchiverL1SynchPoint = {
+    /** Number of the last L1 block that added a new L2 checkpoint metadata.  */
+    blocksSynchedTo?: bigint;
+    /** Last L1 block checked for L1 to L2 messages. */
+    messagesSynchedTo?: L1BlockId;
+};
+/**
+ * Bundle of archiver-owned LMDB substores plus the in-memory caches that span them.
+ *
+ * Replaces the former `KVArchiverDataStore` pass-through wrapper. Callers reach into
+ * the relevant substore directly (e.g. `stores.blocks.getBlock`) and use
+ * {@link createArchiverDataStores} to wire them up against a shared KV store.
+ */
+export type ArchiverDataStores = {
+    /** The underlying key-value store. Use {@link AztecAsyncKVStore.transactionAsync} to compose updates atomically. */
+    db: AztecAsyncKVStore;
+    /** Blocks, checkpoints, tx effects, proven/finalized state. */
+    blocks: BlockStore;
+    /** Public, private and contract class logs. */
+    logs: LogStore;
+    /** L1 to L2 messages and message sync state. */
+    messages: MessageStore;
+    /** Contract classes (with bytecode commitments). */
+    contractClasses: ContractClassStore;
+    /** Contract instances and contract instance updates. */
+    contractInstances: ContractInstanceStore;
+    /** In-memory cache of public function selectors -> names. */
+    functionNames: FunctionNamesCache;
+};
+/**
+ * Wires up the archiver substores against a shared KV store and returns the
+ * {@link ArchiverDataStores} bundle.
+ *
+ * @param genesisBlockHash - Hash of the synthetic genesis block, forwarded to the {@link LogStore} so it
+ *   can resolve a genesis `referenceBlock` (used by the PXE during early sync) instead of treating it as a
+ *   reorg.
+ */
+export declare function createArchiverDataStores(db: AztecAsyncKVStore, genesisBlockHash: BlockHash): ArchiverDataStores;
+/**
+ * Returns the L1 sync point of the archiver, combining the block sync point from {@link BlockStore}
+ * and the message sync point from {@link MessageStore}.
+ */
+export declare function getArchiverSynchPoint(stores: ArchiverDataStores): Promise<ArchiverL1SynchPoint>;
+/**
+ * Backs up the underlying KV store to the given folder. Returns the path to the resulting db file.
+ */
+export declare function backupArchiverDataStores(stores: ArchiverDataStores, path: string, compress?: boolean): Promise<string>;
+/**
+ * Returns a {@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 function createContractDataSource(stores: ArchiverDataStores): ContractDataSource;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YV9zdG9yZXMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZS9kYXRhX3N0b3Jlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUMxRCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3JELE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFLakUsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQy9ELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ3JFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQy9ELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUMxQyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFbEQsZUFBTyxNQUFNLG1CQUFtQixJQUFJLENBQUM7QUFFckM7O0dBRUc7QUFDSCxNQUFNLE1BQU0sb0JBQW9CLEdBQUc7SUFDakMsNEVBQTRFO0lBQzVFLGVBQWUsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN6QixtREFBbUQ7SUFDbkQsaUJBQWlCLENBQUMsRUFBRSxTQUFTLENBQUM7Q0FDL0IsQ0FBQztBQUVGOzs7Ozs7R0FNRztBQUNILE1BQU0sTUFBTSxrQkFBa0IsR0FBRztJQUMvQixvSEFBb0g7SUFDcEgsRUFBRSxFQUFFLGlCQUFpQixDQUFDO0lBQ3RCLCtEQUErRDtJQUMvRCxNQUFNLEVBQUUsVUFBVSxDQUFDO0lBQ25CLCtDQUErQztJQUMvQyxJQUFJLEVBQUUsUUFBUSxDQUFDO0lBQ2YsZ0RBQWdEO0lBQ2hELFFBQVEsRUFBRSxZQUFZLENBQUM7SUFDdkIsb0RBQW9EO0lBQ3BELGVBQWUsRUFBRSxrQkFBa0IsQ0FBQztJQUNwQyx3REFBd0Q7SUFDeEQsaUJBQWlCLEVBQUUscUJBQXFCLENBQUM7SUFDekMsNkRBQTZEO0lBQzdELGFBQWEsRUFBRSxrQkFBa0IsQ0FBQztDQUNuQyxDQUFDO0FBRUY7Ozs7Ozs7R0FPRztBQUNILHdCQUFnQix3QkFBd0IsQ0FBQyxFQUFFLEVBQUUsaUJBQWlCLEVBQUUsZ0JBQWdCLEVBQUUsU0FBUyxHQUFHLGtCQUFrQixDQVcvRztBQUVEOzs7R0FHRztBQUNILHdCQUFzQixxQkFBcUIsQ0FBQyxNQUFNLEVBQUUsa0JBQWtCLEdBQUcsT0FBTyxDQUFDLG9CQUFvQixDQUFDLENBTXJHO0FBRUQ7O0dBRUc7QUFDSCx3QkFBc0Isd0JBQXdCLENBQzVDLE1BQU0sRUFBRSxrQkFBa0IsRUFDMUIsSUFBSSxFQUFFLE1BQU0sRUFDWixRQUFRLFVBQU8sR0FDZCxPQUFPLENBQUMsTUFBTSxDQUFDLENBR2pCO0FBRUQ7Ozs7R0FJRztBQUNILHdCQUFnQix3QkFBd0IsQ0FBQyxNQUFNLEVBQUUsa0JBQWtCLEdBQUcsa0JBQWtCLENBRXZGIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"data_stores.d.ts","sourceRoot":"","sources":["../../src/store/data_stores.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,SAAS,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oHAAoH;IACpH,EAAE,EAAE,iBAAiB,CAAC;IACtB,+DAA+D;IAC/D,MAAM,EAAE,UAAU,CAAC;IACnB,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB,oDAAoD;IACpD,eAAe,EAAE,kBAAkB,CAAC;IACpC,wDAAwD;IACxD,iBAAiB,EAAE,qBAAqB,CAAC;IACzC,6DAA6D;IAC7D,aAAa,EAAE,kBAAkB,CAAC;CACnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,GAAG,kBAAkB,CAW/G;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAMrG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,UAAO,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAEvF"}

package/dest/store/data_stores.js

@@ -0,0 +1,54 @@
+import { join } from 'path';
+import { ArchiverContractDataSourceAdapter } from '../modules/contract_data_source_adapter.js';
+import { BlockStore } from './block_store.js';
+import { ContractClassStore } from './contract_class_store.js';
+import { ContractInstanceStore } from './contract_instance_store.js';
+import { FunctionNamesCache } from './function_names_cache.js';
+import { LogStore } from './log_store.js';
+import { MessageStore } from './message_store.js';
+export const ARCHIVER_DB_VERSION = 7;
+/**
+ * Wires up the archiver substores against a shared KV store and returns the
+ * {@link ArchiverDataStores} bundle.
+ *
+ * @param genesisBlockHash - Hash of the synthetic genesis block, forwarded to the {@link LogStore} so it
+ *   can resolve a genesis `referenceBlock` (used by the PXE during early sync) instead of treating it as a
+ *   reorg.
+ */ export function createArchiverDataStores(db, genesisBlockHash) {
+    const blocks = new BlockStore(db);
+    return {
+        db,
+        blocks,
+        logs: new LogStore(db, blocks, genesisBlockHash),
+        messages: new MessageStore(db),
+        contractClasses: new ContractClassStore(db),
+        contractInstances: new ContractInstanceStore(db),
+        functionNames: new FunctionNamesCache()
+    };
+}
+/**
+ * Returns the L1 sync point of the archiver, combining the block sync point from {@link BlockStore}
+ * and the message sync point from {@link MessageStore}.
+ */ export async function getArchiverSynchPoint(stores) {
+    const [blocksSynchedTo, messagesSynchedTo] = await Promise.all([
+        stores.blocks.getSynchedL1BlockNumber(),
+        stores.messages.getSynchedL1Block()
+    ]);
+    return {
+        blocksSynchedTo,
+        messagesSynchedTo
+    };
+}
+/**
+ * Backs up the underlying KV store to the given folder. Returns the path to the resulting db file.
+ */ export async function backupArchiverDataStores(stores, path, compress = true) {
+    await stores.db.backupTo(path, compress);
+    return join(path, 'data.mdb');
+}
+/**
+ * Returns a {@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 function createContractDataSource(stores) {
+    return new ArchiverContractDataSourceAdapter(stores);
+}

package/dest/store/function_names_cache.d.ts

@@ -0,0 +1,17 @@
+import { FunctionSelector } from '@aztec/stdlib/abi';
+/**
+ * In-memory cache mapping public function selectors to function names.
+ *
+ * Populated opportunistically (e.g. by PXE registering signatures from artifacts) so the
+ * archiver can attach human-readable names to logs and traces. Bounded by
+ * {@link MAX_FUNCTION_SIGNATURES} to avoid unbounded growth from untrusted callers.
+ */
+export declare class FunctionNamesCache {
+    private readonly log;
+    private readonly names;
+    /** Adds the given public function signatures to the cache. */
+    register(signatures: string[]): Promise<void>;
+    /** Looks up a function name for the given selector, or returns undefined if not registered. */
+    get(selector: FunctionSelector): string | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25fbmFtZXNfY2FjaGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZS9mdW5jdGlvbl9uYW1lc19jYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUtyRDs7Ozs7O0dBTUc7QUFDSCxxQkFBYSxrQkFBa0I7SUFDN0IsT0FBTyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQXdDO0lBQzVELE9BQU8sQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFrQztJQUV4RCw4REFBOEQ7SUFDakQsUUFBUSxDQUFDLFVBQVUsRUFBRSxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBWXpEO0lBRUQsK0ZBQStGO0lBQ3hGLEdBQUcsQ0FBQyxRQUFRLEVBQUUsZ0JBQWdCLEdBQUcsTUFBTSxHQUFHLFNBQVMsQ0FFekQ7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"function_names_cache.d.ts","sourceRoot":"","sources":["../../src/store/function_names_cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKrD;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAExD,8DAA8D;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzD;IAED,+FAA+F;IACxF,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAEzD;CACF"}

package/dest/store/function_names_cache.js

@@ -0,0 +1,30 @@
+import { createLogger } from '@aztec/foundation/log';
+import { FunctionSelector } from '@aztec/stdlib/abi';
+const MAX_FUNCTION_SIGNATURES = 1000;
+const MAX_FUNCTION_NAME_LEN = 256;
+/**
+ * In-memory cache mapping public function selectors to function names.
+ *
+ * Populated opportunistically (e.g. by PXE registering signatures from artifacts) so the
+ * archiver can attach human-readable names to logs and traces. Bounded by
+ * {@link MAX_FUNCTION_SIGNATURES} to avoid unbounded growth from untrusted callers.
+ */ export class FunctionNamesCache {
+    log = createLogger('archiver:data-stores');
+    names = new Map();
+    /** Adds the given public function signatures to the cache. */ async register(signatures) {
+        for (const sig of signatures){
+            if (this.names.size > MAX_FUNCTION_SIGNATURES) {
+                return;
+            }
+            try {
+                const selector = await FunctionSelector.fromSignature(sig);
+                this.names.set(selector.toString(), sig.slice(0, sig.indexOf('(')).slice(0, MAX_FUNCTION_NAME_LEN));
+            } catch  {
+                this.log.warn(`Failed to parse signature: ${sig}. Ignoring`);
+            }
+        }
+    }
+    /** Looks up a function name for the given selector, or returns undefined if not registered. */ get(selector) {
+        return this.names.get(selector.toString());
+    }
+}

package/dest/store/l2_tips_cache.d.ts

@@ -0,0 +1,25 @@
+import type { BlockHash, 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 *after* the store transaction that mutates block data has committed,
+ * so the cache loads from committed state and is never replaced if the writer aborts.
+ */
+export declare class L2TipsCache {
+    #private;
+    private blockStore;
+    private readonly initialBlockHash;
+    /**
+     * The genesis block hash is dynamic — derived from the injected initial header, which depends on
+     * `genesisTimestamp` and any prefilled state — so it is supplied here rather than read from store.
+     * The genesis checkpoint hash, by contrast, is the static protocol constant and is resolved
+     * inside the block store.
+     */
+    constructor(blockStore: BlockStore, initialBlockHash: BlockHash);
+    /** 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 after the writer transaction has committed. */
+    refresh(): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19jYWNoZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3N0b3JlL2wyX3RpcHNfY2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRTdELE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRW5EOzs7OztHQUtHO0FBQ0gscUJBQWEsV0FBVzs7SUFVcEIsT0FBTyxDQUFDLFVBQVU7SUFDbEIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxnQkFBZ0I7SUFSbkM7Ozs7O09BS0c7SUFDSCxZQUNVLFVBQVUsRUFBRSxVQUFVLEVBQ2IsZ0JBQWdCLEVBQUUsU0FBUyxFQUMxQztJQUVKLDRFQUE0RTtJQUNyRSxTQUFTLElBQUksT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUVsQztJQUVELDZHQUE2RztJQUNoRyxPQUFPLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUdwQztDQUNGIn0=

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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,WAAW;;IAUpB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IARnC;;;;;OAKG;IACH,YACU,UAAU,EAAE,UAAU,EACb,gBAAgB,EAAE,SAAS,EAC1C;IAEJ,4EAA4E;IACrE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAElC;IAED,6GAA6G;IAChG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpC;CACF"}

package/dest/store/l2_tips_cache.js

@@ -0,0 +1,26 @@
+/**
+ * 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 *after* the store transaction that mutates block data has committed,
+ * so the cache loads from committed state and is never replaced if the writer aborts.
+ */ export class L2TipsCache {
+    blockStore;
+    initialBlockHash;
+    #tipsPromise;
+    /**
+   * The genesis block hash is dynamic — derived from the injected initial header, which depends on
+   * `genesisTimestamp` and any prefilled state — so it is supplied here rather than read from store.
+   * The genesis checkpoint hash, by contrast, is the static protocol constant and is resolved
+   * inside the block store.
+   */ constructor(blockStore, initialBlockHash){
+        this.blockStore = blockStore;
+        this.initialBlockHash = initialBlockHash;
+    }
+    /** Returns the cached L2 tips. Loads from the block store on first call. */ getL2Tips() {
+        return this.#tipsPromise ??= this.blockStore.getL2TipsData(this.initialBlockHash);
+    }
+    /** Reloads the L2 tips from the block store. Should be called after the writer transaction has committed. */ async refresh() {
+        this.#tipsPromise = this.blockStore.getL2TipsData(this.initialBlockHash);
+        await this.#tipsPromise;
+    }
+}

package/dest/store/log_store.d.ts

@@ -0,0 +1,59 @@
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import type { BlockHash, L2Block } from '@aztec/stdlib/block';
+import type { LogResult, PrivateLogsQuery, PublicLogsQuery } from '@aztec/stdlib/logs';
+import type { BlockStore } from './block_store.js';
+/**
+ * Indexes every emitted private and public log under a composite hex-string key
+ * `[contractAddress (public only)]-tag-blockNumber-txIndexWithinBlock-logIndexWithinTx`,
+ * where each numeric segment is zero-padded to 8 lowercase hex digits (4 bytes BE) and
+ * `contractAddress` / `tag` are the bare 64-hex-char field representations (no `0x` prefix). The
+ * fixed-width zero-padded hex segments sort lexicographically in the same order as the canonical
+ * `(contract, tag, blockNumber, txIndexWithinBlock, logIndexWithinTx)` tuple, so a single ordered
+ * range scan answers every {@link PrivateLogsQuery} / {@link PublicLogsQuery}.
+ *
+ * Per-block secondary indices (`#privateKeysByBlock`, `#publicKeysByBlock`) record the exact primary
+ * keys written for each block so {@link deleteLogs} can drop them on reorg without having to range
+ * scan by block (block isn't the leading key segment).
+ *
+ * Contract-class logs are no longer stored or served by the log store.
+ */
+export declare class LogStore {
+    #private;
+    private db;
+    private blockStore;
+    private readonly genesisBlockHash;
+    /**
+     * @param genesisBlockHash - Hash of the synthetic genesis block. During early sync the PXE anchors to
+     *   genesis and passes its hash as a query `referenceBlock`; since the archiver never indexes the
+     *   genesis block, the store recognizes this hash directly and resolves it to the genesis block number
+     *   rather than mistaking it for a reorg.
+     */
+    constructor(db: AztecAsyncKVStore, blockStore: BlockStore, genesisBlockHash: BlockHash);
+    /**
+     * Indexes every emitted private and public log from the given blocks. Wraps the write in a single
+     * `db.transactionAsync` so the primary entries and the per-block secondary indices stay consistent.
+     *
+     * A block is only ever added once; on reorg the archiver calls {@link deleteLogs} first, so we write
+     * the secondary index entries with a plain `set` (overwrite) rather than read-modify-append.
+     */
+    addLogs(blocks: L2Block[]): Promise<boolean>;
+    /**
+     * Deletes every log indexed under any of the given blocks. Secondary-index driven, so it doesn't
+     * have to range-scan the primary maps.
+     */
+    deleteLogs(blocks: L2Block[]): Promise<boolean>;
+    /** Returns one inner array per element of `query.tags`, in input order. */
+    getPrivateLogsByTags(query: PrivateLogsQuery): Promise<LogResult[][]>;
+    /** Returns one inner array per element of `query.tags`, in input order. */
+    getPublicLogsByTags(query: PublicLogsQuery): Promise<LogResult[][]>;
+    /**
+     * Reads back every private log indexed for the given block via the per-block secondary index. Order
+     * matches the canonical composite-key order (`tag`, `blockNumber`, `txIndexWithinBlock`,
+     * `logIndexWithinTx`). Used by the data-store-updater test suite to verify the indexed-vs-block-body
+     * counts without depending on the removed `getPublicLogs(LogFilter)` API.
+     */
+    getPrivateLogsForBlock(blockNumber: number): Promise<LogResult[]>;
+    /** {@inheritDoc LogStore.getPrivateLogsForBlock} */
+    getPublicLogsForBlock(blockNumber: number): Promise<LogResult[]>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3N0b3JlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3RvcmUvbG9nX3N0b3JlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFpQixNQUFNLGlCQUFpQixDQUFDO0FBQ3hFLE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxPQUFPLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUU5RCxPQUFPLEtBQUssRUFFVixTQUFTLEVBQ1QsZ0JBQWdCLEVBQ2hCLGVBQWUsRUFJaEIsTUFBTSxvQkFBb0IsQ0FBQztBQUc1QixPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQWNuRDs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILHFCQUFhLFFBQVE7O0lBbUJqQixPQUFPLENBQUMsRUFBRTtJQUNWLE9BQU8sQ0FBQyxVQUFVO0lBQ2xCLE9BQU8sQ0FBQyxRQUFRLENBQUMsZ0JBQWdCO0lBVG5DOzs7OztPQUtHO0lBQ0gsWUFDVSxFQUFFLEVBQUUsaUJBQWlCLEVBQ3JCLFVBQVUsRUFBRSxVQUFVLEVBQ2IsZ0JBQWdCLEVBQUUsU0FBUyxFQU03QztJQUVEOzs7Ozs7T0FNRztJQUNILE9BQU8sQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQXlFM0M7SUFFRDs7O09BR0c7SUFDSCxVQUFVLENBQUMsTUFBTSxFQUFFLE9BQU8sRUFBRSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0F5QjlDO0lBRUQsMkVBQTJFO0lBQzNFLG9CQUFvQixDQUFDLEtBQUssRUFBRSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsU0FBUyxFQUFFLEVBQUUsQ0FBQyxDQUdwRTtJQUVELDJFQUEyRTtJQUMzRSxtQkFBbUIsQ0FBQyxLQUFLLEVBQUUsZUFBZSxHQUFHLE9BQU8sQ0FBQyxTQUFTLEVBQUUsRUFBRSxDQUFDLENBR2xFO0lBMEhEOzs7OztPQUtHO0lBQ0gsc0JBQXNCLENBQUMsV0FBVyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FJaEU7SUFFRCxvREFBb0Q7SUFDcEQscUJBQXFCLENBQUMsV0FBVyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FFL0Q7Q0ErQkYifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"log_store.d.ts","sourceRoot":"","sources":["../../src/store/log_store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAEV,SAAS,EACT,gBAAgB,EAChB,eAAe,EAIhB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAQ;;IAmBjB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IATnC;;;;;OAKG;IACH,YACU,EAAE,EAAE,iBAAiB,EACrB,UAAU,EAAE,UAAU,EACb,gBAAgB,EAAE,SAAS,EAM7C;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAyE3C;IAED;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9C;IAED,2EAA2E;IAC3E,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAGpE;IAED,2EAA2E;IAC3E,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAGlE;IA0HD;;;;;OAKG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAIhE;IAED,oDAAoD;IACpD,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAE/D;CA+BF"}