@aztec/pxe 0.75.0-commit.c03ba01a2a4122e43e90d5133ba017e54b90e9d2 → 0.75.0

package/dest/database/note_dao.d.ts

@@ -0,0 +1,103 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { Note, TxHash } from '@aztec/circuit-types';
+import { AztecAddress, Fr, type PublicKey } from '@aztec/circuits.js';
+import { NoteSelector } from '@aztec/foundation/abi';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { type NoteData } from '@aztec/simulator/client';
+/**
+ * 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 kernel-provided nonce of the note, required to compute the uniqueNoteHash. */
+    nonce: Fr;
+    /**
+     * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note content 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 public key with which the note content was encrypted during delivery. */
+    addressPoint: PublicKey;
+    /** The note type identifier for the contract.
+     * TODO: remove
+     */
+    noteTypeId: NoteSelector;
+    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 kernel-provided nonce of the note, required to compute the uniqueNoteHash. */
+    nonce: Fr, 
+    /**
+     * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note content 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 public key with which the note content was encrypted during delivery. */
+    addressPoint: PublicKey, 
+    /** The note type identifier for the contract.
+     * TODO: remove
+     */
+    noteTypeId: NoteSelector);
+    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, nonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, addressPoint, noteTypeId, }?: Partial<NoteDao>): Promise<NoteDao>;
+}
+//# sourceMappingURL=note_dao.d.ts.map

package/dest/database/note_dao.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note_dao.d.ts","sourceRoot":"","sources":["../../src/database/note_dao.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAS,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IAIpC,kFAAkF;IAC3E,IAAI,EAAE,IAAI;IACjB,8GAA8G;IACvG,eAAe,EAAE,YAAY;IACpC;;;SAGK;IACE,WAAW,EAAE,EAAE;IACtB,qFAAqF;IAC9E,KAAK,EAAE,EAAE;IAGhB;;;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,gFAAgF;IACzE,YAAY,EAAE,SAAS;IAE9B;;OAEG;IACI,UAAU,EAAE,YAAY;;IA3C/B,kFAAkF;IAC3E,IAAI,EAAE,IAAI;IACjB,8GAA8G;IACvG,eAAe,EAAE,YAAY;IACpC;;;SAGK;IACE,WAAW,EAAE,EAAE;IACtB,qFAAqF;IAC9E,KAAK,EAAE,EAAE;IAGhB;;;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,gFAAgF;IACzE,YAAY,EAAE,SAAS;IAE9B;;OAEG;IACI,UAAU,EAAE,YAAY;IAGjC,QAAQ,IAAI,MAAM;IAiBlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAgC/C,QAAQ;IAIR,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAK7B;;;OAGG;IACI,OAAO;WAMD,MAAM,CAAC,EAClB,IAAoB,EACpB,eAA2B,EAC3B,WAAyB,EACzB,KAAmB,EACnB,QAAsB,EACtB,eAA6B,EAC7B,MAAuB,EACvB,aAAgD,EAChD,WAAoC,EACpC,KAA8B,EAC9B,YAAwB,EACxB,UAAkC,GACnC,GAAE,OAAO,CAAC,OAAO,CAAM;CAgBzB"}

package/dest/database/note_dao.js

@@ -6,38 +6,51 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
 /**
  * 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;
-    nonce;
-    noteHash;
-    siloedNullifier;
-    txHash;
-    l2BlockNumber;
-    l2BlockHash;
-    index;
-    addressPoint;
-    noteTypeId;
-    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, /**
+ */
+export class NoteDao {
+    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 kernel-provided nonce of the note, required to compute the uniqueNoteHash. */ nonce, // Computed values
+     * */
+    storageSlot, 
+    /** The kernel-provided nonce of the note, required to compute the uniqueNoteHash. */
+    nonce, 
+    // Computed values
     /**
      * The inner hash (non-unique, non-siloed) of the note. Each contract determines how the note content is hashed. Can
      * be used alongside contractAddress and nonce to compute the uniqueNoteHash and the siloedNoteHash.
-     */ noteHash, /**
+     */
+    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
+     */
+    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 public key with which the note content was encrypted during delivery. */ addressPoint, /** The note type identifier for the contract.
+     */
+    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 public key with which the note content was encrypted during delivery. */
+    addressPoint, 
+    /** The note type identifier for the contract.
      * TODO: remove
-     */ noteTypeId){
+     */
+    noteTypeId) {
         this.note = note;
         this.contractAddress = contractAddress;
         this.storageSlot = storageSlot;
@@ -64,7 +77,7 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
             Fr.fromHexString(this.l2BlockHash),
             this.index,
             this.addressPoint,
-            this.noteTypeId
+            this.noteTypeId,
         ]);
     }
     static fromBuffer(buffer) {
@@ -91,14 +104,16 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
         return NoteDao.fromBuffer(Buffer.from(hex, 'hex'));
     }
     /**
-   * Returns the size in bytes of the Note Dao.
-   * @returns - Its size in bytes.
-   */ getSize() {
+     * 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(), nonce = Fr.random(), noteHash = Fr.random(), siloedNullifier = Fr.random(), txHash = randomTxHash(), l2BlockNumber = Math.floor(Math.random() * 1000), l2BlockHash = Fr.random().toString(), index = Fr.random().toBigInt(), addressPoint = undefined, noteTypeId = NoteSelector.random() } = {}) {
-        return new NoteDao(note, contractAddress ?? await AztecAddress.random(), storageSlot, nonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, addressPoint ?? await Point.random(), noteTypeId);
+    static async random({ note = Note.random(), contractAddress = undefined, storageSlot = Fr.random(), nonce = Fr.random(), noteHash = Fr.random(), siloedNullifier = Fr.random(), txHash = randomTxHash(), l2BlockNumber = Math.floor(Math.random() * 1000), l2BlockHash = Fr.random().toString(), index = Fr.random().toBigInt(), addressPoint = undefined, noteTypeId = NoteSelector.random(), } = {}) {
+        return new NoteDao(note, contractAddress ?? (await AztecAddress.random()), storageSlot, nonce, noteHash, siloedNullifier, txHash, l2BlockNumber, l2BlockHash, index, addressPoint ?? (await Point.random()), noteTypeId);
     }
 }
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm90ZV9kYW8uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGF0YWJhc2Uvbm90ZV9kYW8udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsWUFBWSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFlBQVksRUFBRSxFQUFFLEVBQUUsS0FBSyxFQUFrQixNQUFNLG9CQUFvQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDN0QsT0FBTyxFQUFFLFlBQVksRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRzlFOzs7R0FHRztBQUNILE1BQU0sT0FBTyxPQUFPO0lBQ2xCO0lBQ0UsbUJBQW1CO0lBRW5CLGtGQUFrRjtJQUMzRSxJQUFVO0lBQ2pCLDhHQUE4RztJQUN2RyxlQUE2QjtJQUNwQzs7O1NBR0s7SUFDRSxXQUFlO0lBQ3RCLHFGQUFxRjtJQUM5RSxLQUFTO0lBRWhCLGtCQUFrQjtJQUNsQjs7O09BR0c7SUFDSSxRQUFZO0lBQ25COzs7T0FHRztJQUNJLGVBQW1CO0lBRTFCLFdBQVc7SUFDWDs7T0FFRztJQUNJLE1BQWM7SUFDckI7Z0JBQ1k7SUFDTCxhQUFxQjtJQUM1QjtnQkFDWTtJQUNMLFdBQW1CO0lBQzFCLCtFQUErRTtJQUN4RSxLQUFhO0lBQ3BCLGdGQUFnRjtJQUN6RSxZQUF1QjtJQUU5Qjs7T0FFRztJQUNJLFVBQXdCO1FBMUN4QixTQUFJLEdBQUosSUFBSSxDQUFNO1FBRVYsb0JBQWUsR0FBZixlQUFlLENBQWM7UUFLN0IsZ0JBQVcsR0FBWCxXQUFXLENBQUk7UUFFZixVQUFLLEdBQUwsS0FBSyxDQUFJO1FBT1QsYUFBUSxHQUFSLFFBQVEsQ0FBSTtRQUtaLG9CQUFlLEdBQWYsZUFBZSxDQUFJO1FB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

package/dest/database/outgoing_note_dao.d.ts

@@ -0,0 +1,73 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { Note, TxHash } from '@aztec/circuit-types';
+import { AztecAddress, Fr, type PublicKey } from '@aztec/circuits.js';
+import { NoteSelector } from '@aztec/foundation/abi';
+import { BufferReader } from '@aztec/foundation/serialize';
+/**
+ * A note with contextual data which was decrypted as outgoing.
+ */
+export declare class OutgoingNoteDao {
+    /** The note as emitted from the Noir contract. */
+    note: Note;
+    /** The contract address this note is created in. */
+    contractAddress: AztecAddress;
+    /** The specific storage location of the note on the contract. */
+    storageSlot: Fr;
+    /** The note type identifier for the contract. */
+    noteTypeId: NoteSelector;
+    /** The hash of the tx the note was created in. */
+    txHash: TxHash;
+    /** The L2 block number in which the tx with this note was included. */
+    l2BlockNumber: number;
+    /** The L2 block hash in which the tx with this note was included. */
+    l2BlockHash: string;
+    /** The nonce of the note. */
+    nonce: Fr;
+    /**
+     * A hash of the note. This is customizable by the app circuit.
+     * We can use this value to compute unique note hash and then siloed note hash.
+     */
+    noteHash: Fr;
+    /** The location of the relevant note in the note hash tree. */
+    index: bigint;
+    /** The public key with which the note was encrypted. */
+    ovpkM: PublicKey;
+    constructor(
+    /** The note as emitted from the Noir contract. */
+    note: Note, 
+    /** The contract address this note is created in. */
+    contractAddress: AztecAddress, 
+    /** The specific storage location of the note on the contract. */
+    storageSlot: Fr, 
+    /** The note type identifier for the contract. */
+    noteTypeId: NoteSelector, 
+    /** The hash of the tx the note was created in. */
+    txHash: TxHash, 
+    /** The L2 block number in which the tx with this note was included. */
+    l2BlockNumber: number, 
+    /** The L2 block hash in which the tx with this note was included. */
+    l2BlockHash: string, 
+    /** The nonce of the note. */
+    nonce: Fr, 
+    /**
+     * A hash of the note. This is customizable by the app circuit.
+     * We can use this value to compute unique note hash and then siloed note hash.
+     */
+    noteHash: Fr, 
+    /** The location of the relevant note in the note hash tree. */
+    index: bigint, 
+    /** The public key with which the note was encrypted. */
+    ovpkM: PublicKey);
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer | BufferReader): OutgoingNoteDao;
+    toString(): string;
+    static fromString(str: string): OutgoingNoteDao;
+    /**
+     * Returns the size in bytes of the Note Dao.
+     * @returns - Its size in bytes.
+     */
+    getSize(): number;
+    static random({ note, contractAddress, txHash, storageSlot, noteTypeId, nonce, l2BlockNumber, l2BlockHash, noteHash, index, ovpkM, }?: Partial<OutgoingNoteDao>): Promise<OutgoingNoteDao>;
+}
+//# sourceMappingURL=outgoing_note_dao.d.ts.map

package/dest/database/outgoing_note_dao.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outgoing_note_dao.d.ts","sourceRoot":"","sources":["../../src/database/outgoing_note_dao.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAgB,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAS,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E;;GAEG;AACH,qBAAa,eAAe;IAExB,kDAAkD;IAC3C,IAAI,EAAE,IAAI;IACjB,oDAAoD;IAC7C,eAAe,EAAE,YAAY;IACpC,iEAAiE;IAC1D,WAAW,EAAE,EAAE;IACtB,iDAAiD;IAC1C,UAAU,EAAE,YAAY;IAC/B,kDAAkD;IAC3C,MAAM,EAAE,MAAM;IACrB,uEAAuE;IAChE,aAAa,EAAE,MAAM;IAC5B,qEAAqE;IAC9D,WAAW,EAAE,MAAM;IAC1B,6BAA6B;IACtB,KAAK,EAAE,EAAE;IAChB;;;OAGG;IACI,QAAQ,EAAE,EAAE;IACnB,+DAA+D;IACxD,KAAK,EAAE,MAAM;IACpB,wDAAwD;IACjD,KAAK,EAAE,SAAS;;IAxBvB,kDAAkD;IAC3C,IAAI,EAAE,IAAI;IACjB,oDAAoD;IAC7C,eAAe,EAAE,YAAY;IACpC,iEAAiE;IAC1D,WAAW,EAAE,EAAE;IACtB,iDAAiD;IAC1C,UAAU,EAAE,YAAY;IAC/B,kDAAkD;IAC3C,MAAM,EAAE,MAAM;IACrB,uEAAuE;IAChE,aAAa,EAAE,MAAM;IAC5B,qEAAqE;IAC9D,WAAW,EAAE,MAAM;IAC1B,6BAA6B;IACtB,KAAK,EAAE,EAAE;IAChB;;;OAGG;IACI,QAAQ,EAAE,EAAE;IACnB,+DAA+D;IACxD,KAAK,EAAE,MAAM;IACpB,wDAAwD;IACjD,KAAK,EAAE,SAAS;IAGzB,QAAQ,IAAI,MAAM;IAelB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IA8B/C,QAAQ;IAIR,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAK7B;;;OAGG;IACI,OAAO;WAKD,MAAM,CAAC,EAClB,IAAoB,EACpB,eAA2B,EAC3B,MAAuB,EACvB,WAAyB,EACzB,UAAkC,EAClC,KAAmB,EACnB,aAAgD,EAChD,WAAoC,EACpC,QAAsB,EACtB,KAA8B,EAC9B,KAAiB,GAClB,GAAE,OAAO,CAAC,eAAe,CAAM;CAejC"}

package/dest/database/outgoing_note_dao.js

@@ -5,22 +5,34 @@ import { toBigIntBE } from '@aztec/foundation/bigint-buffer';
 import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
 /**
  * A note with contextual data which was decrypted as outgoing.
- */ export class OutgoingNoteDao {
-    note;
-    contractAddress;
-    storageSlot;
-    noteTypeId;
-    txHash;
-    l2BlockNumber;
-    l2BlockHash;
-    nonce;
-    noteHash;
-    index;
-    ovpkM;
-    constructor(/** The note as emitted from the Noir contract. */ note, /** The contract address this note is created in. */ contractAddress, /** The specific storage location of the note on the contract. */ storageSlot, /** The note type identifier for the contract. */ noteTypeId, /** The hash of the tx the note was created in. */ txHash, /** The L2 block number in which the tx with this note was included. */ l2BlockNumber, /** The L2 block hash in which the tx with this note was included. */ l2BlockHash, /** The nonce of the note. */ nonce, /**
+ */
+export class OutgoingNoteDao {
+    constructor(
+    /** The note as emitted from the Noir contract. */
+    note, 
+    /** The contract address this note is created in. */
+    contractAddress, 
+    /** The specific storage location of the note on the contract. */
+    storageSlot, 
+    /** The note type identifier for the contract. */
+    noteTypeId, 
+    /** The hash of the tx the note was created in. */
+    txHash, 
+    /** The L2 block number in which the tx with this note was included. */
+    l2BlockNumber, 
+    /** The L2 block hash in which the tx with this note was included. */
+    l2BlockHash, 
+    /** The nonce of the note. */
+    nonce, 
+    /**
      * A hash of the note. This is customizable by the app circuit.
      * We can use this value to compute unique note hash and then siloed note hash.
-     */ noteHash, /** The location of the relevant note in the note hash tree. */ index, /** The public key with which the note was encrypted. */ ovpkM){
+     */
+    noteHash, 
+    /** The location of the relevant note in the note hash tree. */
+    index, 
+    /** The public key with which the note was encrypted. */
+    ovpkM) {
         this.note = note;
         this.contractAddress = contractAddress;
         this.storageSlot = storageSlot;
@@ -45,7 +57,7 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
             this.nonce,
             this.noteHash,
             this.index,
-            this.ovpkM
+            this.ovpkM,
         ]);
     }
     static fromBuffer(buffer) {
@@ -71,13 +83,15 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
         return OutgoingNoteDao.fromBuffer(Buffer.from(hex, 'hex'));
     }
     /**
-   * Returns the size in bytes of the Note Dao.
-   * @returns - Its size in bytes.
-   */ getSize() {
+     * Returns the size in bytes of the Note Dao.
+     * @returns - Its size in bytes.
+     */
+    getSize() {
         const noteSize = 4 + this.note.items.length * Fr.SIZE_IN_BYTES;
         return noteSize + AztecAddress.SIZE_IN_BYTES + Fr.SIZE_IN_BYTES * 2 + TxHash.SIZE + Point.SIZE_IN_BYTES;
     }
-    static async random({ note = Note.random(), contractAddress = undefined, txHash = randomTxHash(), storageSlot = Fr.random(), noteTypeId = NoteSelector.random(), nonce = Fr.random(), l2BlockNumber = Math.floor(Math.random() * 1000), l2BlockHash = Fr.random().toString(), noteHash = Fr.random(), index = Fr.random().toBigInt(), ovpkM = undefined } = {}) {
-        return new OutgoingNoteDao(note, contractAddress ?? await AztecAddress.random(), storageSlot, noteTypeId, txHash, l2BlockNumber, l2BlockHash, nonce, noteHash, index, ovpkM ?? await Point.random());
+    static async random({ note = Note.random(), contractAddress = undefined, txHash = randomTxHash(), storageSlot = Fr.random(), noteTypeId = NoteSelector.random(), nonce = Fr.random(), l2BlockNumber = Math.floor(Math.random() * 1000), l2BlockHash = Fr.random().toString(), noteHash = Fr.random(), index = Fr.random().toBigInt(), ovpkM = undefined, } = {}) {
+        return new OutgoingNoteDao(note, contractAddress ?? (await AztecAddress.random()), storageSlot, noteTypeId, txHash, l2BlockNumber, l2BlockHash, nonce, noteHash, index, ovpkM ?? (await Point.random()));
     }
 }
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3V0Z29pbmdfbm90ZV9kYW8uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGF0YWJhc2Uvb3V0Z29pbmdfbm90ZV9kYW8udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsWUFBWSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDbEUsT0FBTyxFQUFFLFlBQVksRUFBRSxFQUFFLEVBQUUsS0FBSyxFQUFrQixNQUFNLG9CQUFvQixDQUFDO0FBQzdFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDN0QsT0FBTyxFQUFFLFlBQVksRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRTlFOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGVBQWU7SUFDMUI7SUFDRSxrREFBa0Q7SUFDM0MsSUFBVTtJQUNqQixvREFBb0Q7SUFDN0MsZUFBNkI7SUFDcEMsaUVBQWlFO0lBQzFELFdBQWU7SUFDdEIsaURBQWlEO0lBQzFDLFVBQXdCO0lBQy9CLGtEQUFrRDtJQUMzQyxNQUFjO0lBQ3JCLHVFQUF1RTtJQUNoRSxhQUFxQjtJQUM1QixxRUFBcUU7SUFDOUQsV0FBbUI7SUFDMUIsNkJBQTZCO0lBQ3RCLEtBQVM7SUFDaEI7OztPQUdHO0lBQ0ksUUFBWTtJQUNuQiwrREFBK0Q7SUFDeEQsS0FBYTtJQUNwQix3REFBd0Q7SUFDakQsS0FBZ0I7UUF2QmhCLFNBQUksR0FBSixJQUFJLENBQU07UUFFVixvQkFBZSxHQUFmLGVBQWUsQ0FBYztRQUU3QixnQkFBVyxHQUFYLFdBQVcsQ0FBSTtRQUVmLGVBQVUsR0FBVixVQUFVLENBQWM7UUFFeEIsV0FBTSxHQUFOLE1BQU0sQ0FBUTtRQUVkLGtCQUFhLEdBQWIsYUFBYSxDQUFRO1FBRXJCLGdCQUFXLEdBQVgsV0FBVyxDQUFRO1FBRW5CLFVB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

package/dest/database/pxe_database.d.ts

@@ -0,0 +1,216 @@
+import { type InBlock, type NotesFilter } from '@aztec/circuit-types';
+import { type BlockHeader, type CompleteAddress, type ContractInstanceWithAddress, type IndexedTaggingSecret, type PublicKey } from '@aztec/circuits.js';
+import { type ContractArtifact } from '@aztec/foundation/abi';
+import { type AztecAddress } from '@aztec/foundation/aztec-address';
+import { type Fr } from '@aztec/foundation/fields';
+import { type ContractArtifactDatabase } from './contracts/contract_artifact_db.js';
+import { type ContractInstanceDatabase } from './contracts/contract_instance_db.js';
+import { type NoteDao } from './note_dao.js';
+/**
+ * A database interface that provides methods for retrieving, adding, and removing transactional data related to Aztec
+ * addresses, storage slots, and nullifiers.
+ */
+export interface PxeDatabase extends ContractArtifactDatabase, ContractInstanceDatabase {
+    getContract(address: AztecAddress): Promise<(ContractInstanceWithAddress & ContractArtifact) | undefined>;
+    /**
+     * Add a auth witness to the database.
+     * @param messageHash - The message hash.
+     * @param witness - An array of field elements representing the auth witness.
+     */
+    addAuthWitness(messageHash: Fr, witness: Fr[]): Promise<void>;
+    /**
+     * Fetching the auth witness for a given message hash.
+     * @param messageHash - The message hash.
+     * @returns A Promise that resolves to an array of field elements representing the auth witness.
+     */
+    getAuthWitness(messageHash: Fr): Promise<Fr[] | undefined>;
+    /**
+     * Adding a capsule to the capsule dispenser.
+     * @remarks A capsule is a "blob" of data that is passed to the contract through an oracle.
+     * @param capsule - An array of field elements representing the capsule.
+     */
+    addCapsule(capsule: Fr[]): Promise<void>;
+    /**
+     * Get the next capsule from the capsule dispenser.
+     * @remarks A capsule is a "blob" of data that is passed to the contract through an oracle.
+     * @returns A promise that resolves to an array of field elements representing the capsule.
+     */
+    popCapsule(): Promise<Fr[] | undefined>;
+    /**
+     * Gets notes based on the provided filter.
+     * @param filter - The filter to apply to the notes.
+     * @returns The requested notes.
+     */
+    getNotes(filter: NotesFilter): Promise<NoteDao[]>;
+    /**
+     * Adds a note to DB.
+     * @param note - The note to add.
+     * @param scope - The scope to add the note under. Currently optional.
+     * @remark - Will create a database for the scope if it does not already exist.
+     */
+    addNote(note: NoteDao, scope?: AztecAddress): Promise<void>;
+    /**
+     * Adds a nullified note to DB.
+     * @param note - The note to add.
+     */
+    addNullifiedNote(note: NoteDao): Promise<void>;
+    /**
+     * Adds an array of notes to DB.
+     * This function is used to insert multiple notes to the database at once,
+     * which can improve performance when dealing with large numbers of transactions.
+     *
+     * @param notes - An array of notes.
+     * @param scope - The scope to add the notes under. Currently optional.
+     * @remark - Will create a database for the scope if it does not already exist.
+     */
+    addNotes(notes: NoteDao[], scope?: AztecAddress): Promise<void>;
+    /**
+     * Remove nullified notes associated with the given account and nullifiers.
+     *
+     * @param nullifiers - An array of Fr instances representing nullifiers to be matched.
+     * @param account - A PublicKey instance representing the account for which the records are being removed.
+     * @returns Removed notes.
+     */
+    removeNullifiedNotes(nullifiers: InBlock<Fr>[], account: PublicKey): Promise<NoteDao[]>;
+    /**
+     * Gets the most recently processed block number.
+     * @returns The most recently processed block number or undefined if never synched.
+     */
+    getBlockNumber(): Promise<number | undefined>;
+    /**
+     * Retrieve the stored Block Header from the database.
+     * The function returns a Promise that resolves to the Block Header.
+     * This data is required to reproduce block attestations.
+     * Throws an error if the block header is not available within the database.
+     *
+     * note: this data is a combination of the tree roots and the global variables hash.
+     *
+     * @returns The Block Header.
+     * @throws If no block have been processed yet.
+     */
+    getBlockHeader(): Promise<BlockHeader>;
+    /**
+     * Set the latest Block Header.
+     * Note that this will overwrite any existing hash or roots in the database.
+     *
+     * @param header - An object containing the most recent block header.
+     * @returns A Promise that resolves when the hash has been successfully updated in the database.
+     */
+    setHeader(header: BlockHeader): Promise<void>;
+    /**
+     * Adds sender address to the database.
+     * @param address - The address to add to the address book.
+     * @returns A promise resolving to true if the address was added, false if it already exists.
+     */
+    addSenderAddress(address: AztecAddress): Promise<boolean>;
+    /**
+     * Retrieves the list of sender addresses in the address book.
+     * @returns An array of Aztec addresses.
+     */
+    getSenderAddresses(): Promise<AztecAddress[]>;
+    /**
+     * Removes a sender address from the database.
+     * @param address - The address to remove from the address book.
+     * @returns A promise resolving to true if the address was removed, false if it does not exist.
+     */
+    removeSenderAddress(address: AztecAddress): Promise<boolean>;
+    /**
+     * Adds complete address to the database.
+     * @param address - The complete address to add.
+     * @returns A promise resolving to true if the address was added, false if it already exists.
+     * @throws If we try to add a CompleteAddress with the same AztecAddress but different public key or partial
+     * address.
+     */
+    addCompleteAddress(address: CompleteAddress): Promise<boolean>;
+    /**
+     * Retrieve the complete address associated to a given address.
+     * @param account - The account address.
+     * @returns A promise that resolves to a CompleteAddress instance if found, or undefined if not found.
+     */
+    getCompleteAddress(account: AztecAddress): Promise<CompleteAddress | undefined>;
+    /**
+     * Retrieves the list of complete addresses added to this database
+     * @returns A promise that resolves to an array of AztecAddress instances.
+     */
+    getCompleteAddresses(): Promise<CompleteAddress[]>;
+    /**
+     * Returns the estimated size in bytes of this db.
+     * @returns The estimated size in bytes of this db.
+     */
+    estimateSize(): Promise<number>;
+    /**
+     * Returns the last seen indexes for the provided app siloed tagging secrets or 0 if they've never been seen.
+     * @param appTaggingSecrets - The app siloed tagging secrets.
+     * @returns The indexes for the provided secrets, 0 if they've never been seen.
+     */
+    getTaggingSecretsIndexesAsRecipient(appTaggingSecrets: Fr[]): Promise<number[]>;
+    /**
+     * Returns the last seen indexes for the provided app siloed tagging secrets or 0 if they've never been used
+     * @param appTaggingSecrets - The app siloed tagging secrets.
+     * @returns The indexes for the provided secrets, 0 if they've never been seen.
+     */
+    getTaggingSecretsIndexesAsSender(appTaggingSecrets: Fr[]): Promise<number[]>;
+    /**
+     * Sets the index for the provided app siloed tagging secrets
+     * To be used when the generated tags have been "seen" as a sender
+     * @param appTaggingSecrets - The app siloed tagging secrets.
+     */
+    setTaggingSecretsIndexesAsSender(indexedTaggingSecrets: IndexedTaggingSecret[]): Promise<void>;
+    /**
+     * Sets the index for the provided app siloed tagging secrets
+     * To be used when the generated tags have been "seen" as a recipient
+     * @param appTaggingSecrets - The app siloed tagging secrets.
+     */
+    setTaggingSecretsIndexesAsRecipient(indexedTaggingSecrets: IndexedTaggingSecret[]): Promise<void>;
+    /**
+     * Deletes all notes synched after this block number.
+     * @param blockNumber - All notes strictly after this block number are removed.
+     */
+    removeNotesAfter(blockNumber: number): Promise<void>;
+    /**
+     * Restores notes nullified after the given block.
+     * @param blockNumber - All nullifiers strictly after this block are removed.
+     */
+    unnullifyNotesAfter(blockNumber: number): Promise<void>;
+    /**
+     * Resets the indexes used to sync notes to 0 for every sender and recipient, causing the next sync process to
+     * start from scratch, taking longer than usual.
+     * This can help fix desynchronization issues, including finding logs that had previously been overlooked, and
+     * is also required to deal with chain reorgs.
+     */
+    resetNoteSyncData(): Promise<void>;
+    /**
+     * Stores arbitrary information in a per-contract non-volatile database, which can later be retrieved with `dbLoad`.
+     * If data was already stored at this slot, it is overwrriten.
+     * @param contractAddress - The contract address to scope the data under.
+     * @param slot - The slot in the database in which to store the value. Slots need not be contiguous.
+     * @param values - The data to store.
+     */
+    dbStore(contractAddress: AztecAddress, slot: Fr, values: Fr[]): Promise<void>;
+    /**
+     * Returns data previously stored via `dbStore` in the per-contract non-volatile database.
+     * @param contractAddress - The contract address under which the data is scoped.
+     * @param slot - The slot in the database to read.
+     * @returns The stored data or `null` if no data is stored under the slot.
+     */
+    dbLoad(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null>;
+    /**
+     * Deletes data in the per-contract non-volatile database. Does nothing if no data was present.
+     * @param contractAddress - The contract address under which the data is scoped.
+     * @param slot - The slot in the database to delete.
+     */
+    dbDelete(contractAddress: AztecAddress, slot: Fr): Promise<void>;
+    /**
+     * Copies a number of contiguous entries in the per-contract non-volatile database. This allows for efficient data
+     * structures by avoiding repeated calls to `dbLoad` and `dbStore`.
+     * Supports overlapping source and destination regions (which will result in the overlapped source values being
+     * overwritten). All copied slots must exist in the database (i.e. have been stored and not deleted)
+     *
+     * @param contractAddress - The contract address under which the data is scoped.
+     * @param srcSlot - The first slot to copy from.
+     * @param dstSlot - The first slot to copy to.
+     * @param numEntries - The number of entries to copy.
+     */
+    dbCopy(contractAddress: AztecAddress, srcSlot: Fr, dstSlot: Fr, numEntries: number): Promise<void>;
+}
+//# sourceMappingURL=pxe_database.d.ts.map

package/dest/database/pxe_database.d.ts.map

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

package/dest/database/pxe_database.js

@@ -1,4 +1,2 @@
-/**
- * A database interface that provides methods for retrieving, adding, and removing transactional data related to Aztec
- * addresses, storage slots, and nullifiers.
- */ export { };
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHhlX2RhdGFiYXNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RhdGFiYXNlL3B4ZV9kYXRhYmFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dest/database/pxe_database_test_suite.d.ts

@@ -0,0 +1,7 @@
+import { type PxeDatabase } from './pxe_database.js';
+/**
+ * A common test suite for a PXE database.
+ * @param getDatabase - A function that returns a database instance.
+ */
+export declare function describePxeDatabase(getDatabase: () => PxeDatabase): void;
+//# sourceMappingURL=pxe_database_test_suite.d.ts.map

package/dest/database/pxe_database_test_suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pxe_database_test_suite.d.ts","sourceRoot":"","sources":["../../src/database/pxe_database_test_suite.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,WAAW,QA8iBjE"}