@aztec/pxe 0.0.1-commit.b655e406 → 0.0.1-commit.c0b82b2

package/dest/storage/contract_data_provider/contract_data_provider.js

@@ -1,205 +0,0 @@
-import { toArray } from '@aztec/foundation/iterable';
-import { FunctionSelector, FunctionType, contractArtifactFromBuffer, contractArtifactToBuffer, getFunctionDebugMetadata } from '@aztec/stdlib/abi';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { SerializableContractInstance, getContractClassFromArtifact } from '@aztec/stdlib/contract';
-import { PrivateFunctionsTree } from './private_functions_tree.js';
-/**
- * ContractDataProvider serves as a data manager and retriever for Aztec.nr contracts.
- * It provides methods to obtain contract addresses, function ABI, bytecode, and membership witnesses
- * from a given contract address and function selector. The class maintains a cache of ContractTree instances
- * to efficiently serve the requested data. It interacts with the ContractDatabase and AztecNode to fetch
- * the required information and facilitate cryptographic proof generation.
- */ export class ContractDataProvider {
-    /** Map from contract class id to private function tree. */ // TODO: Update it to be LRU cache so that it doesn't keep all the data all the time.
-    #privateFunctionTrees = new Map();
-    /** Map from contract address to contract class id */ #contractClassIdMap = new Map();
-    #contractArtifacts;
-    #contractInstances;
-    constructor(store){
-        this.#contractArtifacts = store.openMap('contract_artifacts');
-        this.#contractInstances = store.openMap('contracts_instances');
-    }
-    // Setters
-    async addContractArtifact(id, contract) {
-        const privateFunctions = contract.functions.filter((functionArtifact)=>functionArtifact.functionType === FunctionType.PRIVATE);
-        const privateSelectors = await Promise.all(privateFunctions.map(async (privateFunctionArtifact)=>(await FunctionSelector.fromNameAndParameters(privateFunctionArtifact.name, privateFunctionArtifact.parameters)).toString()));
-        if (privateSelectors.length !== new Set(privateSelectors).size) {
-            throw new Error('Repeated function selectors of private functions');
-        }
-        await this.#contractArtifacts.set(id.toString(), contractArtifactToBuffer(contract));
-    }
-    async addContractInstance(contract) {
-        this.#contractClassIdMap.set(contract.address.toString(), contract.currentContractClassId);
-        await this.#contractInstances.set(contract.address.toString(), new SerializableContractInstance(contract).toBuffer());
-    }
-    // Private getters
-    async #getContractClassId(contractAddress) {
-        if (!this.#contractClassIdMap.has(contractAddress.toString())) {
-            const instance = await this.getContractInstance(contractAddress);
-            if (!instance) {
-                return;
-            }
-            this.#contractClassIdMap.set(contractAddress.toString(), instance.currentContractClassId);
-        }
-        return this.#contractClassIdMap.get(contractAddress.toString());
-    }
-    /**
-   * Retrieve or create a ContractTree instance based on the provided class id.
-   * If an existing tree with the same class id is found in the cache, it will be returned.
-   * Otherwise, a new ContractTree instance will be created using the contract data from the database
-   * and added to the cache before returning.
-   *
-   * @param classId - The class id of the contract for which the ContractTree is required.
-   * @returns A ContractTree instance associated with the specified contract address.
-   * @throws An Error if the contract is not found in the ContractDatabase.
-   */ async #getPrivateFunctionTreeForClassId(classId) {
-        if (!this.#privateFunctionTrees.has(classId.toString())) {
-            const artifact = await this.getContractArtifact(classId);
-            if (!artifact) {
-                return;
-            }
-            const tree = await PrivateFunctionsTree.create(artifact);
-            this.#privateFunctionTrees.set(classId.toString(), tree);
-        }
-        return this.#privateFunctionTrees.get(classId.toString());
-    }
-    async #getContractArtifactByAddress(contractAddress) {
-        const contractClassId = await this.#getContractClassId(contractAddress);
-        return contractClassId && this.getContractArtifact(contractClassId);
-    }
-    // Public getters
-    async getContractsAddresses() {
-        const keys = await toArray(this.#contractInstances.keysAsync());
-        return keys.map(AztecAddress.fromString);
-    }
-    /** Returns a contract instance for a given address. Throws if not found. */ async getContractInstance(contractAddress) {
-        const contract = await this.#contractInstances.getAsync(contractAddress.toString());
-        return contract && SerializableContractInstance.fromBuffer(contract).withAddress(contractAddress);
-    }
-    async getContractArtifact(contractClassId) {
-        const contract = await this.#contractArtifacts.getAsync(contractClassId.toString());
-        // TODO(@spalladino): AztecAsyncMap lies and returns Uint8Arrays instead of Buffers, hence the extra Buffer.from.
-        return contract && contractArtifactFromBuffer(Buffer.from(contract));
-    }
-    /** Returns a contract class for a given class id. Throws if not found. */ async getContractClass(contractClassId) {
-        const artifact = await this.getContractArtifact(contractClassId);
-        return artifact && getContractClassFromArtifact(artifact);
-    }
-    async getContract(address) {
-        const instance = await this.getContractInstance(address);
-        if (!instance) {
-            return;
-        }
-        const artifact = await this.getContractArtifact(instance.currentContractClassId);
-        if (!artifact) {
-            return;
-        }
-        return {
-            ...instance,
-            ...artifact
-        };
-    }
-    /**
-   * Retrieves the artifact of a specified function within a given contract.
-   * The function is identified by its selector, which is a unique code generated from the function's signature.
-   * Throws an error if the contract address or function selector are invalid or not found.
-   *
-   * @param contractAddress - The AztecAddress representing the contract containing the function.
-   * @param selector - The function selector.
-   * @returns The corresponding function's artifact as an object.
-   */ async getFunctionArtifact(contractAddress, selector) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        const fnArtifact = artifact && await this.#findFunctionArtifactBySelector(artifact, selector);
-        return fnArtifact && {
-            ...fnArtifact,
-            contractName: artifact.name
-        };
-    }
-    async getPublicFunctionArtifact(contractAddress) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        const fnArtifact = artifact && artifact.functions.find((fn)=>fn.functionType === FunctionType.PUBLIC);
-        return fnArtifact && {
-            ...fnArtifact,
-            contractName: artifact.name
-        };
-    }
-    /**
-   * Retrieves the artifact of a specified function within a given contract.
-   * The function is identified by its name, which is unique within a contract.
-   * Throws if the contract has not been added to the database.
-   *
-   * @param contractAddress - The AztecAddress representing the contract containing the function.
-   * @param functionName - The name of the function.
-   * @returns The corresponding function's artifact as an object
-   */ async getFunctionArtifactByName(contractAddress, functionName) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        return artifact?.functions.find((fn)=>fn.name === functionName);
-    }
-    async getFunctionAbi(contractAddress, selector) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        return artifact && await this.#findFunctionAbiBySelector(artifact, selector);
-    }
-    /**
-   * Retrieves the debug metadata of a specified function within a given contract.
-   * The function is identified by its selector, which is a unique code generated from the function's signature.
-   * Returns undefined if the debug metadata for the given function is not found.
-   * Throws if the contract has not been added to the database.
-   *
-   * @param contractAddress - The AztecAddress representing the contract containing the function.
-   * @param selector - The function selector.
-   * @returns The corresponding function's artifact as an object.
-   */ async getFunctionDebugMetadata(contractAddress, selector) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        const fnArtifact = artifact && await this.#findFunctionArtifactBySelector(artifact, selector);
-        return fnArtifact && getFunctionDebugMetadata(artifact, fnArtifact);
-    }
-    async getPublicFunctionDebugMetadata(contractAddress) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        const fnArtifact = artifact && artifact.functions.find((fn)=>fn.functionType === FunctionType.PUBLIC);
-        return fnArtifact && getFunctionDebugMetadata(artifact, fnArtifact);
-    }
-    /**
-   * Retrieve the function membership witness for the given contract class and function selector.
-   * The function membership witness represents a proof that the function belongs to the specified contract.
-   * Throws an error if the contract address or function selector is unknown.
-   *
-   * @param contractClassId - The id of the class.
-   * @param selector - The function selector.
-   * @returns A promise that resolves with the MembershipWitness instance for the specified contract's function.
-   */ async getFunctionMembershipWitness(contractClassId, selector) {
-        const tree = await this.#getPrivateFunctionTreeForClassId(contractClassId);
-        return tree?.getFunctionMembershipWitness(selector);
-    }
-    async getDebugContractName(contractAddress) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        return artifact?.name;
-    }
-    async getDebugFunctionName(contractAddress, selector) {
-        const artifact = await this.#getContractArtifactByAddress(contractAddress);
-        const fnArtifact = artifact && await this.#findFunctionAbiBySelector(artifact, selector);
-        return `${artifact?.name ?? contractAddress}:${fnArtifact?.name ?? selector}`;
-    }
-    async #findFunctionArtifactBySelector(artifact, selector) {
-        const functions = artifact.functions;
-        for(let i = 0; i < functions.length; i++){
-            const fn = functions[i];
-            const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
-            if (fnSelector.equals(selector)) {
-                return fn;
-            }
-        }
-    }
-    async #findFunctionAbiBySelector(artifact, selector) {
-        const functions = [
-            ...artifact.functions,
-            ...artifact.nonDispatchPublicFunctions ?? []
-        ];
-        for(let i = 0; i < functions.length; i++){
-            const fn = functions[i];
-            const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
-            if (fnSelector.equals(selector)) {
-                return fn;
-            }
-        }
-    }
-}

package/dest/storage/contract_data_provider/index.d.ts

@@ -1,2 +0,0 @@
-export { ContractDataProvider } from './contract_data_provider.js';
-//# sourceMappingURL=index.d.ts.map

package/dest/storage/contract_data_provider/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/contract_data_provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dest/storage/contract_data_provider/index.js

@@ -1 +0,0 @@
-export { ContractDataProvider } from './contract_data_provider.js';

package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"private_functions_tree.d.ts","sourceRoot":"","sources":["../../../src/storage/contract_data_provider/private_functions_tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAgB,MAAM,mBAAmB,CAAC;AAQ1F;;;;;GAKG;AACH,qBAAa,oBAAoB;IAGX,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAFrD,OAAO,CAAC,IAAI,CAAC,CAAa;IAE1B,OAAO;WAEM,MAAM,CAAC,QAAQ,EAAE,gBAAgB;IAS9C;;;;;;;;OAQG;IACU,4BAA4B,CACvC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,iBAAiB,CAAC,OAAO,oBAAoB,CAAC,CAAC;YAiB5C,OAAO;CAMtB"}

package/dest/storage/note_data_provider/index.d.ts

@@ -1,3 +0,0 @@
-export { NoteDao } from './note_dao.js';
-export { NoteDataProvider } from './note_data_provider.js';
-//# sourceMappingURL=index.d.ts.map

package/dest/storage/note_data_provider/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/note_data_provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dest/storage/note_data_provider/index.js

@@ -1,2 +0,0 @@
-export { NoteDao } from './note_dao.js';
-export { NoteDataProvider } from './note_data_provider.js';

package/dest/storage/note_data_provider/note_dao.d.ts

@@ -1,100 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import { BufferReader } from '@aztec/foundation/serialize';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { Note } from '@aztec/stdlib/note';
-import { TxHash } from '@aztec/stdlib/tx';
-import type { NoteData } from '../../contract_function_simulator/oracle/interfaces.js';
-/**
- * A Note Data Access Object, representing a note that was committed to the note hash tree, holding all of the
- * information required to use it during execution and manage its state.
- */
-export declare class NoteDao implements NoteData {
-    /** The packed content of the note, as will be returned in the getNotes oracle. */
-    note: Note;
-    /** The address of the contract that created the note (i.e. the address used by the kernel during siloing). */
-    contractAddress: AztecAddress;
-    /**
-     * The storage location of the note. This value is not used for anything in PXE, but we do index by storage slot
-     * since contracts typically make queries based on it.
-     */
-    storageSlot: Fr;
-    /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */
-    noteNonce: Fr;
-    /**
-     * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note is hashed. Can
-     * be used alongside contractAddress and nonce to compute the uniqueNoteHash and the siloedNoteHash.
-     */
-    noteHash: Fr;
-    /**
-     * The nullifier of the note, siloed by contract address.
-     * Note: Might be set as 0 if the note was added to PXE as nullified.
-     */
-    siloedNullifier: Fr;
-    /** The hash of the tx in which this note was created. Knowing the tx hash allows for efficient node queries e.g.
-     *  when searching for txEffects.
-     */
-    txHash: TxHash;
-    /** The L2 block number in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/
-    l2BlockNumber: number;
-    /** The L2 block hash in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/
-    l2BlockHash: string;
-    /** The index of the leaf in the global note hash tree the note is stored at */
-    index: bigint;
-    /**
-     * The address whose public key was used to encrypt the note log during delivery.
-     * (This is the x-coordinate of the public key.)
-     */
-    recipient: AztecAddress;
-    constructor(
-    /** The packed content of the note, as will be returned in the getNotes oracle. */
-    note: Note, 
-    /** The address of the contract that created the note (i.e. the address used by the kernel during siloing). */
-    contractAddress: AztecAddress, 
-    /**
-     * The storage location of the note. This value is not used for anything in PXE, but we do index by storage slot
-     * since contracts typically make queries based on it.
-     */
-    storageSlot: Fr, 
-    /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */
-    noteNonce: Fr, 
-    /**
-     * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note is hashed. Can
-     * be used alongside contractAddress and nonce to compute the uniqueNoteHash and the siloedNoteHash.
-     */
-    noteHash: Fr, 
-    /**
-     * The nullifier of the note, siloed by contract address.
-     * Note: Might be set as 0 if the note was added to PXE as nullified.
-     */
-    siloedNullifier: Fr, 
-    /** The hash of the tx in which this note was created. Knowing the tx hash allows for efficient node queries e.g.
-     *  when searching for txEffects.
-     */
-    txHash: TxHash, 
-    /** The L2 block number in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/
-    l2BlockNumber: number, 
-    /** The L2 block hash in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/
-    l2BlockHash: string, 
-    /** The index of the leaf in the global note hash tree the note is stored at */
-    index: bigint, 
-    /**
-     * The address whose public key was used to encrypt the note log during delivery.
-     * (This is the x-coordinate of the public key.)
-     */
-    recipient: AztecAddress);
-    toBuffer(): Buffer;
-    static fromBuffer(buffer: Buffer | BufferReader): NoteDao;
-    toString(): string;
-    static fromString(str: string): NoteDao;
-    /**
-     * Returns the size in bytes of the Note Dao.
-     * @returns - Its size in bytes.
-     */
-    getSize(): number;
-    static random({ note, contractAddress, storageSlot, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, recipient, }?: Partial<NoteDao>): Promise<NoteDao>;
-}
-//# sourceMappingURL=note_dao.d.ts.map

package/dest/storage/note_data_provider/note_dao.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"note_dao.d.ts","sourceRoot":"","sources":["../../../src/storage/note_data_provider/note_dao.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAS,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wDAAwD,CAAC;AAEvF;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAIpC,kFAAkF;IAC3E,IAAI,EAAE,IAAI;IACjB,8GAA8G;IACvG,eAAe,EAAE,YAAY;IACpC;;;OAGG;IACI,WAAW,EAAE,EAAE;IACtB,gGAAgG;IACzF,SAAS,EAAE,EAAE;IAGpB;;;OAGG;IACI,QAAQ,EAAE,EAAE;IACnB;;;OAGG;IACI,eAAe,EAAE,EAAE;IAG1B;;OAEG;IACI,MAAM,EAAE,MAAM;IACrB;gBACY;IACL,aAAa,EAAE,MAAM;IAC5B;gBACY;IACL,WAAW,EAAE,MAAM;IAC1B,+EAA+E;IACxE,KAAK,EAAE,MAAM;IACpB;;;OAGG;IACI,SAAS,EAAE,YAAY;;IAzC9B,kFAAkF;IAC3E,IAAI,EAAE,IAAI;IACjB,8GAA8G;IACvG,eAAe,EAAE,YAAY;IACpC;;;OAGG;IACI,WAAW,EAAE,EAAE;IACtB,gGAAgG;IACzF,SAAS,EAAE,EAAE;IAGpB;;;OAGG;IACI,QAAQ,EAAE,EAAE;IACnB;;;OAGG;IACI,eAAe,EAAE,EAAE;IAG1B;;OAEG;IACI,MAAM,EAAE,MAAM;IACrB;gBACY;IACL,aAAa,EAAE,MAAM;IAC5B;gBACY;IACL,WAAW,EAAE,MAAM;IAC1B,+EAA+E;IACxE,KAAK,EAAE,MAAM;IACpB;;;OAGG;IACI,SAAS,EAAE,YAAY;IAGhC,QAAQ,IAAI,MAAM;IAgBlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IA8B/C,QAAQ;IAIR,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAK7B;;;OAGG;IACI,OAAO;WAMD,MAAM,CAAC,EAClB,IAAoB,EACpB,eAA2B,EAC3B,WAAyB,EACzB,SAAuB,EACvB,QAAsB,EACtB,eAA6B,EAC7B,MAAwB,EACxB,aAAgD,EAChD,WAAoC,EACpC,KAA8B,EAC9B,SAAqB,GACtB,GAAE,OAAO,CAAC,OAAO,CAAM;CAezB"}

package/dest/storage/note_data_provider/note_dao.js

@@ -1,102 +0,0 @@
-import { toBigIntBE } from '@aztec/foundation/bigint-buffer';
-import { Fr, Point } from '@aztec/foundation/fields';
-import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { Note } from '@aztec/stdlib/note';
-import { TxHash } from '@aztec/stdlib/tx';
-/**
- * A Note Data Access Object, representing a note that was committed to the note hash tree, holding all of the
- * information required to use it during execution and manage its state.
- */ export class NoteDao {
-    note;
-    contractAddress;
-    storageSlot;
-    noteNonce;
-    noteHash;
-    siloedNullifier;
-    txHash;
-    l2BlockNumber;
-    l2BlockHash;
-    index;
-    recipient;
-    constructor(// Note information
-    /** The packed content of the note, as will be returned in the getNotes oracle. */ note, /** The address of the contract that created the note (i.e. the address used by the kernel during siloing). */ contractAddress, /**
-     * The storage location of the note. This value is not used for anything in PXE, but we do index by storage slot
-     * since contracts typically make queries based on it.
-     */ storageSlot, /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */ noteNonce, // Computed values
-    /**
-     * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note is hashed. Can
-     * be used alongside contractAddress and nonce to compute the uniqueNoteHash and the siloedNoteHash.
-     */ noteHash, /**
-     * The nullifier of the note, siloed by contract address.
-     * Note: Might be set as 0 if the note was added to PXE as nullified.
-     */ siloedNullifier, // Metadata
-    /** The hash of the tx in which this note was created. Knowing the tx hash allows for efficient node queries e.g.
-     *  when searching for txEffects.
-     */ txHash, /** The L2 block number in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/ l2BlockNumber, /** The L2 block hash in which the tx with this note was included. Used for note management while processing
-     * reorgs.*/ l2BlockHash, /** The index of the leaf in the global note hash tree the note is stored at */ index, /**
-     * The address whose public key was used to encrypt the note log during delivery.
-     * (This is the x-coordinate of the public key.)
-     */ recipient){
-        this.note = note;
-        this.contractAddress = contractAddress;
-        this.storageSlot = storageSlot;
-        this.noteNonce = noteNonce;
-        this.noteHash = noteHash;
-        this.siloedNullifier = siloedNullifier;
-        this.txHash = txHash;
-        this.l2BlockNumber = l2BlockNumber;
-        this.l2BlockHash = l2BlockHash;
-        this.index = index;
-        this.recipient = recipient;
-    }
-    toBuffer() {
-        return serializeToBuffer([
-            this.note,
-            this.contractAddress,
-            this.storageSlot,
-            this.noteNonce,
-            this.noteHash,
-            this.siloedNullifier,
-            this.txHash,
-            this.l2BlockNumber,
-            Fr.fromHexString(this.l2BlockHash),
-            this.index,
-            this.recipient
-        ]);
-    }
-    static fromBuffer(buffer) {
-        const reader = BufferReader.asReader(buffer);
-        const note = Note.fromBuffer(reader);
-        const contractAddress = AztecAddress.fromBuffer(reader);
-        const storageSlot = Fr.fromBuffer(reader);
-        const noteNonce = Fr.fromBuffer(reader);
-        const noteHash = Fr.fromBuffer(reader);
-        const siloedNullifier = Fr.fromBuffer(reader);
-        const txHash = reader.readObject(TxHash);
-        const l2BlockNumber = reader.readNumber();
-        const l2BlockHash = Fr.fromBuffer(reader).toString();
-        const index = toBigIntBE(reader.readBytes(32));
-        const recipient = AztecAddress.fromBuffer(reader);
-        return new NoteDao(note, contractAddress, storageSlot, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, recipient);
-    }
-    toString() {
-        return '0x' + this.toBuffer().toString('hex');
-    }
-    static fromString(str) {
-        const hex = str.replace(/^0x/, '');
-        return NoteDao.fromBuffer(Buffer.from(hex, 'hex'));
-    }
-    /**
-   * Returns the size in bytes of the Note Dao.
-   * @returns - Its size in bytes.
-   */ getSize() {
-        const indexSize = Math.ceil(Math.log2(Number(this.index)));
-        const noteSize = 4 + this.note.items.length * Fr.SIZE_IN_BYTES;
-        return noteSize + AztecAddress.SIZE_IN_BYTES + Fr.SIZE_IN_BYTES * 4 + TxHash.SIZE + Point.SIZE_IN_BYTES + indexSize;
-    }
-    static async random({ note = Note.random(), contractAddress = undefined, storageSlot = Fr.random(), noteNonce = Fr.random(), noteHash = Fr.random(), siloedNullifier = Fr.random(), txHash = TxHash.random(), l2BlockNumber = Math.floor(Math.random() * 1000), l2BlockHash = Fr.random().toString(), index = Fr.random().toBigInt(), recipient = undefined } = {}) {
-        return new NoteDao(note, contractAddress ?? await AztecAddress.random(), storageSlot, noteNonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, recipient ?? await AztecAddress.random());
-    }
-}

package/dest/storage/note_data_provider/note_data_provider.d.ts

@@ -1,83 +0,0 @@
-import type { Fr } from '@aztec/foundation/fields';
-import type { AztecAsyncKVStore } from '@aztec/kv-store';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import type { InBlock } from '@aztec/stdlib/block';
-import { type NotesFilter } from '@aztec/stdlib/note';
-import { NoteDao } from './note_dao.js';
-/**
- * NoteDataProvider manages the storage and retrieval of notes.
- *
- * Notes can be active or nullified. This class processes new notes, nullifications,
- * and performs rollback handling in the case of a reorg.
- **/
-export declare class NoteDataProvider {
-    #private;
-    private constructor();
-    /**
-     * Creates and initializes a new NoteDataProvider instance.
-     *
-     * This factory method creates a NoteDataProvider and restores any existing
-     * scope-specific indexes from the database.
-     *
-     * @param store - The key-value store to use for persistence
-     * @returns Promise resolving to a fully initialized NoteDataProvider instance
-     */
-    static create(store: AztecAsyncKVStore): Promise<NoteDataProvider>;
-    /**
-     * Adds a new scope to the note data provider.
-     *
-     * Scopes provide privacy isolation by creating separate indexes for each user.
-     * Each scope gets its own set of indexes for efficient note retrieval by various criteria.
-     *
-     * @param scope - The AztecAddress representing the scope/user to add
-     * @returns Promise resolving to true if scope was added, false if it already existed
-     */
-    addScope(scope: AztecAddress): Promise<boolean>;
-    /**
-     * Adds multiple notes to the data provider under the specified scope.
-     *
-     * Notes are stored using their index from the notes hash tree as the key, which provides
-     * uniqueness and maintains creation order. Each note is indexed by multiple criteria
-     * for efficient retrieval.
-     *
-     * @param notes - Notes to store
-     * @param scope - The scope (user/account) under which to store the notes
-     */
-    addNotes(notes: NoteDao[], scope: AztecAddress): Promise<void>;
-    /**
-     * Synchronizes notes and nullifiers to a specific block number.
-     *
-     * This method ensures that the state of notes and nullifiers is consistent with the
-     * specified block number. It restores any notes that were nullified after the given block
-     * and deletes any active notes created after that block.
-     *
-     * @param blockNumber - The new chain tip after a reorg
-     * @param synchedBlockNumber - The block number up to which PXE managed to sync before the reorg happened.
-     */
-    rollbackNotesAndNullifiers(blockNumber: number, synchedBlockNumber: number): Promise<void>;
-    /**
-     * Retrieves notes based on the provided filter criteria.
-     *
-     * This method queries both active and optionally nullified notes based on the filter
-     * parameters.
-     *
-     * @param filter - Filter criteria including contractAddress (required), and optional
-     *                 storageSlot, status, scopes and siloedNullifier.
-     * @returns Promise resolving to array of NoteDao objects matching the filter
-     * @throws If filtering by an empty scopes array. Scopes have to be set to undefined or to a non-empty array.
-     */
-    getNotes(filter: NotesFilter): Promise<NoteDao[]>;
-    /**
-     * Transitions notes from "active" to "nullified" state.
-     *
-     * This operation processes a batch of nullifiers to mark the corresponding notes
-     * as spent/nullified.  The operation is atomic - if any nullifier is not found,
-     * the entire operation fails and no notes are modified.
-     *
-     * @param nullifiers - Array of nullifiers with their block numbers to process
-     * @returns Promise resolving to array of nullified NoteDao objects
-     * @throws Error if any nullifier is not found in the active notes
-     */
-    applyNullifiers(nullifiers: InBlock<Fr>[]): Promise<NoteDao[]>;
-}
-//# sourceMappingURL=note_data_provider.d.ts.map

package/dest/storage/note_data_provider/note_data_provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"note_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/note_data_provider/note_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;;;IAKI;AACJ,qBAAa,gBAAgB;;IAiB3B,OAAO;IAkBP;;;;;;;;OAQG;WACiB,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS/E;;;;;;;;OAQG;IACU,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAc5D;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D;;;;;;;;;OASG;IACU,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwFvG;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8FvD;;;;;;;;;;OAUG;IACH,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CA0D/D"}