@aztec/stdlib 0.0.0-test.1 → 0.0.1-commit.b655e406

package/dest/messaging/l2_to_l1_message.js

@@ -1,4 +1,3 @@
-import { L2_TO_L1_MESSAGE_LENGTH, SCOPED_L2_TO_L1_MESSAGE_LENGTH } from '@aztec/constants';
 import { EthAddress } from '@aztec/foundation/eth-address';
 import { Fr } from '@aztec/foundation/fields';
 import { schemas } from '@aztec/foundation/schemas';
@@ -8,51 +7,43 @@ import { AztecAddress } from '../aztec-address/index.js';
 export class L2ToL1Message {
     recipient;
     content;
-    counter;
-    constructor(recipient, content, counter){
+    constructor(recipient, content){
         this.recipient = recipient;
         this.content = content;
-        this.counter = counter;
     }
     static get schema() {
         return z.object({
             recipient: schemas.EthAddress,
-            content: schemas.Fr,
-            counter: z.number().int().nonnegative()
-        }).transform(({ recipient, content, counter })=>new L2ToL1Message(recipient, content, counter));
+            content: schemas.Fr
+        }).transform(({ recipient, content })=>new L2ToL1Message(recipient, content));
     }
     /**
    * Creates an empty L2ToL1Message with default values.
    * @returns An instance of L2ToL1Message with empty fields.
    */ static empty() {
-        return new L2ToL1Message(EthAddress.ZERO, Fr.zero(), 0);
+        return new L2ToL1Message(EthAddress.ZERO, Fr.zero());
     }
     /**
    * Checks if another L2ToL1Message is equal to this instance.
    * @param other Another L2ToL1Message instance to compare with.
    * @returns True if both recipient and content are equal.
    */ equals(other) {
-        return this.recipient.equals(other.recipient) && this.content.equals(other.content) && this.counter === other.counter;
+        return this.recipient.equals(other.recipient) && this.content.equals(other.content);
     }
     /**
    * Serialize this as a buffer.
    * @returns The buffer.
    */ toBuffer() {
-        return serializeToBuffer(this.recipient, this.content, this.counter);
+        return serializeToBuffer(this.recipient, this.content);
     }
     /**
    * Serializes the L2ToL1Message into an array of fields.
    * @returns An array of fields representing the serialized message.
    */ toFields() {
-        const fields = [
+        return [
             this.recipient.toField(),
-            this.content,
-            new Fr(this.counter)
+            this.content
         ];
-        if (fields.length !== L2_TO_L1_MESSAGE_LENGTH) {
-            throw new Error(`Invalid number of fields for L2ToL1Message. Expected ${L2_TO_L1_MESSAGE_LENGTH}, got ${fields.length}`);
-        }
-        return fields;
     }
     /**
    * Deserializes an array of fields into an L2ToL1Message instance.
@@ -60,7 +51,7 @@ export class L2ToL1Message {
    * @returns An instance of L2ToL1Message.
    */ static fromFields(fields) {
         const reader = FieldReader.asReader(fields);
-        return new L2ToL1Message(reader.readObject(EthAddress), reader.readField(), reader.readU32());
+        return new L2ToL1Message(reader.readObject(EthAddress), reader.readField());
     }
     /**
    * Deserializes from a buffer or reader.
@@ -68,18 +59,52 @@ export class L2ToL1Message {
    * @returns A new instance of L2ToL1Message.
    */ static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
-        return new L2ToL1Message(reader.readObject(EthAddress), reader.readObject(Fr), reader.readNumber());
+        return new L2ToL1Message(reader.readObject(EthAddress), reader.readObject(Fr));
     }
     /**
    * Convenience method to check if the message is empty.
    * @returns True if both recipient and content are zero.
    */ isEmpty() {
-        return this.recipient.isZero() && this.content.isZero() && !this.counter;
+        return this.recipient.isZero() && this.content.isZero();
     }
     scope(contractAddress) {
         return new ScopedL2ToL1Message(this, contractAddress);
     }
 }
+export class CountedL2ToL1Message {
+    message;
+    counter;
+    constructor(message, counter){
+        this.message = message;
+        this.counter = counter;
+    }
+    static get schema() {
+        return z.object({
+            message: L2ToL1Message.schema,
+            counter: z.number().int().nonnegative()
+        }).transform(({ message, counter })=>new CountedL2ToL1Message(message, counter));
+    }
+    static empty() {
+        return new CountedL2ToL1Message(L2ToL1Message.empty(), 0);
+    }
+    isEmpty() {
+        return this.message.isEmpty() && !this.counter;
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new CountedL2ToL1Message(reader.readObject(L2ToL1Message), reader.readNumber());
+    }
+    toBuffer() {
+        return serializeToBuffer(this.message, this.counter);
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new CountedL2ToL1Message(reader.readObject(L2ToL1Message), reader.readU32());
+    }
+    toFields() {
+        return serializeToFields(this.message, this.counter);
+    }
+}
 export class ScopedL2ToL1Message {
     message;
     contractAddress;
@@ -93,37 +118,58 @@ export class ScopedL2ToL1Message {
             contractAddress: AztecAddress.schema
         }).transform(({ message, contractAddress })=>new ScopedL2ToL1Message(message, contractAddress));
     }
-    static getFields(fields) {
-        return [
-            fields.message,
-            fields.contractAddress
-        ];
-    }
     static empty() {
         return new ScopedL2ToL1Message(L2ToL1Message.empty(), AztecAddress.ZERO);
     }
-    equals(other) {
-        return this.message.equals(other.message) && this.contractAddress.equals(other.contractAddress);
-    }
-    toBuffer() {
-        return serializeToBuffer(this.message, this.contractAddress);
+    isEmpty() {
+        return this.message.isEmpty() && this.contractAddress.isZero();
     }
     static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
         return new ScopedL2ToL1Message(reader.readObject(L2ToL1Message), reader.readObject(AztecAddress));
     }
+    toBuffer() {
+        return serializeToBuffer(this.message, this.contractAddress);
+    }
     static fromFields(fields) {
         const reader = FieldReader.asReader(fields);
         return new ScopedL2ToL1Message(reader.readObject(L2ToL1Message), reader.readObject(AztecAddress));
     }
     toFields() {
-        const fields = serializeToFields(...ScopedL2ToL1Message.getFields(this));
-        if (fields.length !== SCOPED_L2_TO_L1_MESSAGE_LENGTH) {
-            throw new Error(`Invalid number of fields for ScopedL2ToL1Message. Expected ${SCOPED_L2_TO_L1_MESSAGE_LENGTH}, got ${fields.length}`);
-        }
-        return fields;
+        return serializeToFields(this.message, this.contractAddress);
+    }
+}
+export class ScopedCountedL2ToL1Message {
+    inner;
+    contractAddress;
+    constructor(inner, contractAddress){
+        this.inner = inner;
+        this.contractAddress = contractAddress;
+    }
+    static get schema() {
+        return z.object({
+            inner: CountedL2ToL1Message.schema,
+            contractAddress: AztecAddress.schema
+        }).transform(({ inner, contractAddress })=>new ScopedCountedL2ToL1Message(inner, contractAddress));
+    }
+    static empty() {
+        return new ScopedCountedL2ToL1Message(CountedL2ToL1Message.empty(), AztecAddress.ZERO);
     }
     isEmpty() {
-        return this.message.isEmpty() && this.contractAddress.isZero();
+        return this.inner.isEmpty() && this.contractAddress.isZero();
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new ScopedCountedL2ToL1Message(reader.readObject(CountedL2ToL1Message), reader.readObject(AztecAddress));
+    }
+    toBuffer() {
+        return serializeToBuffer(this.inner, this.contractAddress);
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new ScopedCountedL2ToL1Message(reader.readObject(CountedL2ToL1Message), reader.readObject(AztecAddress));
+    }
+    toFields() {
+        return serializeToFields(this.inner, this.contractAddress);
     }
 }

package/dest/noir/index.d.ts

@@ -1,6 +1,7 @@
 import type { ABIParameter, ABIParameterVisibility, AbiErrorType, AbiType, AbiValue, DebugFileMap, DebugInfo } from '../abi/abi.js';
 export declare const AZTEC_PRIVATE_ATTRIBUTE = "private";
 export declare const AZTEC_PUBLIC_ATTRIBUTE = "public";
+export declare const AZTEC_UTILITY_ATTRIBUTE = "utility";
 export declare const AZTEC_INTERNAL_ATTRIBUTE = "internal";
 export declare const AZTEC_INITIALIZER_ATTRIBUTE = "initializer";
 export declare const AZTEC_VIEW_ATTRIBUTE = "view";
@@ -25,7 +26,7 @@ export interface NoirFunctionAbi {
 /**
  * The compilation result of an Aztec.nr function.
  */
-export interface NoirFunctionEntry {
+interface NoirFunctionEntry {
     /** The name of the function. */
     name: string;
     /** Whether the function is unconstrained. */
@@ -51,6 +52,8 @@ export interface NoirFunctionEntry {
 export interface NoirCompiledContract {
     /** The name of the contract. */
     name: string;
+    /** Is the contract's public bytecode transpiled? */
+    transpiled?: boolean;
     /** The functions of the contract. */
     functions: NoirFunctionEntry[];
     /** The events of the contract */
@@ -62,7 +65,7 @@ export interface NoirCompiledContract {
     file_map: DebugFileMap;
 }
 /**
- * The compilation result of an Aztec.nr contract.
+ * The compilation result of a protocol (non-contract) circuit.
  */
 export interface NoirCompiledCircuit {
     /** The hash of the circuit. */
@@ -73,11 +76,24 @@ export interface NoirCompiledCircuit {
     abi: NoirFunctionAbi;
     /** The bytecode of the circuit in base64. */
     bytecode: string;
+    /** The verification key of the circuit. */
+    verificationKey: {
+        /** hex-encoded binary */
+        bytes: string;
+        /** list of hex-encoded fields */
+        fields: string[];
+        /** The hex-encoded hash. */
+        hash: string;
+    };
     /** The debug information, compressed and base64 encoded. */
     debug_symbols: string;
     /** The map of file ID to the source code and path of the file. */
     file_map: DebugFileMap;
 }
+export interface NoirCompiledCircuitWithName extends NoirCompiledCircuit {
+    /** The name of the circuit. */
+    name: string;
+}
 /**
  * The debug metadata of an Aztec.nr contract.
  */
@@ -125,4 +141,5 @@ export declare function isNoirContractCompilationArtifacts(artifact: NoirCompila
  * Check if it has Contract unique property
  */
 export declare function isNoirProgramCompilationArtifacts(artifact: NoirCompilationResult): artifact is NoirProgramCompilationArtifacts;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dest/noir/index.d.ts.map

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

package/dest/noir/index.js

@@ -1,5 +1,6 @@
 export const AZTEC_PRIVATE_ATTRIBUTE = 'private';
 export const AZTEC_PUBLIC_ATTRIBUTE = 'public';
+export const AZTEC_UTILITY_ATTRIBUTE = 'utility';
 export const AZTEC_INTERNAL_ATTRIBUTE = 'internal';
 export const AZTEC_INITIALIZER_ATTRIBUTE = 'initializer';
 export const AZTEC_VIEW_ATTRIBUTE = 'view';

package/dest/note/index.d.ts

@@ -1,5 +1,5 @@
 export * from './comparator.js';
-export * from './extended_note.js';
+export * from './unique_note.js';
 export * from './notes_filter.js';
 export * from './note_status.js';
 export * from './note.js';

package/dest/note/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/note/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/note/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/dest/note/index.js

@@ -1,5 +1,5 @@
 export * from './comparator.js';
-export * from './extended_note.js';
+export * from './unique_note.js';
 export * from './notes_filter.js';
 export * from './note_status.js';
 export * from './note.js';

package/dest/note/note.d.ts

@@ -1,9 +1,13 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
+import { Fr } from '@aztec/foundation/fields';
 import { BufferReader } from '@aztec/foundation/serialize';
-import { Payload } from '../logs/l1_payload/payload.js';
-export declare class Note extends Payload {
-    static get schema(): import("zod").ZodEffects<import("zod").ZodUnion<[import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, Buffer, string>, import("zod").ZodEffects<import("zod").ZodObject<{
+import { Vector } from '../types/shared.js';
+/**
+ * The Note class represents a Note emitted from a Noir contract as a vector of Fr (finite field) elements.
+ * This data also represents a preimage to a note hash.
+ */
+export declare class Note extends Vector<Fr> {
+    toJSON(): Buffer<ArrayBufferLike>;
+    static get schema(): import("zod").ZodEffects<import("zod").ZodUnion<[import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, Buffer<ArrayBuffer>, string>, import("zod").ZodEffects<import("zod").ZodObject<{
         type: import("zod").ZodLiteral<"Buffer">;
         data: import("zod").ZodArray<import("zod").ZodNumber, "many">;
     }, "strip", import("zod").ZodTypeAny, {
@@ -12,13 +16,42 @@ export declare class Note extends Payload {
     }, {
         type: "Buffer";
         data: number[];
-    }>, Buffer, {
+    }>, Buffer<ArrayBuffer>, {
         type: "Buffer";
         data: number[];
     }>]>, Note, string | {
         type: "Buffer";
         data: number[];
     }>;
+    /**
+     * Create a Note instance from a Buffer or BufferReader.
+     * The input 'buffer' can be either a Buffer containing the serialized Fr elements or a BufferReader instance.
+     * This function reads the Fr elements in the buffer and constructs a Note with them.
+     *
+     * @param buffer - The Buffer or BufferReader containing the serialized Fr elements.
+     * @returns A Note instance containing the deserialized Fr elements.
+     */
     static fromBuffer(buffer: Buffer | BufferReader): Note;
+    /**
+     * Generates a random Note instance with a variable number of items.
+     * The number of items is determined by a random value between 1 and 10 (inclusive).
+     * Each item in the Note is generated using the Fr.random() method.
+     *
+     * @returns A randomly generated Note instance.
+     */
+    static random(): Note;
+    /**
+     * Returns a hex representation of the note.
+     * @returns A hex string with the vector length as first element.
+     */
+    toString(): `0x${string}`;
+    /**
+     * Creates a new Note instance from a hex string.
+     * @param str - Hex representation.
+     * @returns A Note instance.
+     */
+    static fromString(str: string): Note;
+    get length(): number;
+    equals(other: Note): boolean;
 }
 //# sourceMappingURL=note.d.ts.map

package/dest/note/note.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/note/note.ts"],"names":[],"mappings":";;AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,qBAAa,IAAK,SAAQ,OAAO;IAC/B,WAAoB,MAAM;;;;;;;;;;;;;;;OAEzB;WAEe,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;CAIzD"}
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/note/note.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;GAGG;AACH,qBAAa,IAAK,SAAQ,MAAM,CAAC,EAAE,CAAC;IAClC,MAAM;IAIN,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;OAEhB;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK/C;;;;;;OAMG;IACH,MAAM,CAAC,MAAM;IAMb;;;OAGG;IACM,QAAQ;IAIjB;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAI7B,IAAI,MAAM,WAET;IAED,MAAM,CAAC,KAAK,EAAE,IAAI;CAGnB"}

package/dest/note/note.js

@@ -1,13 +1,60 @@
+import { randomInt } from '@aztec/foundation/crypto';
 import { Fr } from '@aztec/foundation/fields';
-import { schemas } from '@aztec/foundation/schemas';
 import { BufferReader } from '@aztec/foundation/serialize';
-import { Payload } from '../logs/l1_payload/payload.js';
-export class Note extends Payload {
+import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
+import { schemas } from '../schemas/index.js';
+import { Vector } from '../types/shared.js';
+/**
+ * The Note class represents a Note emitted from a Noir contract as a vector of Fr (finite field) elements.
+ * This data also represents a preimage to a note hash.
+ */ export class Note extends Vector {
+    toJSON() {
+        return this.toBuffer();
+    }
     static get schema() {
         return schemas.Buffer.transform(Note.fromBuffer);
     }
-    static fromBuffer(buffer) {
+    /**
+   * Create a Note instance from a Buffer or BufferReader.
+   * The input 'buffer' can be either a Buffer containing the serialized Fr elements or a BufferReader instance.
+   * This function reads the Fr elements in the buffer and constructs a Note with them.
+   *
+   * @param buffer - The Buffer or BufferReader containing the serialized Fr elements.
+   * @returns A Note instance containing the deserialized Fr elements.
+   */ static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
         return new Note(reader.readVector(Fr));
     }
+    /**
+   * Generates a random Note instance with a variable number of items.
+   * The number of items is determined by a random value between 1 and 10 (inclusive).
+   * Each item in the Note is generated using the Fr.random() method.
+   *
+   * @returns A randomly generated Note instance.
+   */ static random() {
+        const numItems = randomInt(10) + 1;
+        const items = Array.from({
+            length: numItems
+        }, ()=>Fr.random());
+        return new Note(items);
+    }
+    /**
+   * Returns a hex representation of the note.
+   * @returns A hex string with the vector length as first element.
+   */ toString() {
+        return bufferToHex(this.toBuffer());
+    }
+    /**
+   * Creates a new Note instance from a hex string.
+   * @param str - Hex representation.
+   * @returns A Note instance.
+   */ static fromString(str) {
+        return Note.fromBuffer(hexToBuffer(str));
+    }
+    get length() {
+        return this.items.length;
+    }
+    equals(other) {
+        return this.items.every((item, index)=>item.equals(other.items[index]));
+    }
 }

package/dest/note/notes_filter.d.ts

@@ -1,21 +1,19 @@
 import type { Fr } from '@aztec/foundation/fields';
 import type { AztecAddress } from '../aztec-address/index.js';
 import { type ZodFor } from '../schemas/index.js';
-import { TxHash } from '../tx/tx_hash.js';
 import { NoteStatus } from './note_status.js';
 /**
  * A filter used to fetch notes.
  * @remarks This filter is applied as an intersection of all its params.
  */
 export type NotesFilter = {
-    /** Hash of a transaction from which to fetch the notes. */
-    txHash?: TxHash;
-    /** The contract address the note belongs to. */
-    contractAddress?: AztecAddress;
+    /**
+     * The contract address the note belongs to.
+     * @remarks Providing a contract address is required as we need that information to trigger private state sync.
+     */
+    contractAddress: AztecAddress;
     /** The specific storage location of the note on the contract. */
     storageSlot?: Fr;
-    /** The owner of the note (whose public key was used to encrypt the note). */
-    owner?: AztecAddress;
     /** The status of the note. Defaults to 'ACTIVE'. */
     status?: NoteStatus;
     /** The siloed nullifier for the note. */

package/dest/note/notes_filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notes_filter.d.ts","sourceRoot":"","sources":["../../src/note/notes_filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,iEAAiE;IACjE,WAAW,CAAC,EAAE,EAAE,CAAC;IACjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oDAAoD;IACpD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yCAAyC;IACzC,eAAe,CAAC,EAAE,EAAE,CAAC;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAQhD,CAAC"}
+{"version":3,"file":"notes_filter.d.ts","sourceRoot":"","sources":["../../src/note/notes_filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAInD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,eAAe,EAAE,YAAY,CAAC;IAC9B,iEAAiE;IACjE,WAAW,CAAC,EAAE,EAAE,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,yCAAyC;IACzC,eAAe,CAAC,EAAE,EAAE,CAAC;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAMhD,CAAC"}

package/dest/note/notes_filter.js

@@ -1,12 +1,9 @@
 import { z } from 'zod';
 import { schemas } from '../schemas/index.js';
-import { TxHash } from '../tx/tx_hash.js';
 import { NoteStatus } from './note_status.js';
 export const NotesFilterSchema = z.object({
-    txHash: TxHash.schema.optional(),
-    contractAddress: schemas.AztecAddress.optional(),
+    contractAddress: schemas.AztecAddress,
     storageSlot: schemas.Fr.optional(),
-    owner: schemas.AztecAddress.optional(),
     status: z.nativeEnum(NoteStatus).optional(),
     siloedNullifier: schemas.Fr.optional(),
     scopes: z.array(schemas.AztecAddress).optional()

package/dest/note/unique_note.d.ts

@@ -0,0 +1,43 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { AztecAddress } from '../aztec-address/index.js';
+import { type ZodFor } from '../schemas/index.js';
+import { TxHash } from '../tx/tx_hash.js';
+import { Note } from './note.js';
+/**
+ * A note with contextual data and a nonce that makes it unique.
+ */
+export declare class UniqueNote {
+    /** The note as emitted from the Noir contract. */
+    note: Note;
+    /** The recipient whose public key was used to encrypt the note. */
+    recipient: AztecAddress;
+    /** The contract address this note is created in. */
+    contractAddress: AztecAddress;
+    /** The specific storage location of the note on the contract. */
+    storageSlot: Fr;
+    /** The hash of the tx the note was created in. */
+    txHash: TxHash;
+    /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */
+    noteNonce: Fr;
+    constructor(
+    /** The note as emitted from the Noir contract. */
+    note: Note, 
+    /** The recipient whose public key was used to encrypt the note. */
+    recipient: AztecAddress, 
+    /** The contract address this note is created in. */
+    contractAddress: AztecAddress, 
+    /** The specific storage location of the note on the contract. */
+    storageSlot: Fr, 
+    /** The hash of the tx the note was created in. */
+    txHash: TxHash, 
+    /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */
+    noteNonce: Fr);
+    static get schema(): ZodFor<UniqueNote>;
+    toBuffer(): Buffer;
+    static random(): Promise<UniqueNote>;
+    static fromBuffer(buffer: Buffer | BufferReader): UniqueNote;
+    static fromString(str: string): UniqueNote;
+    toString(): `0x${string}`;
+}
+//# sourceMappingURL=unique_note.d.ts.map

package/dest/note/unique_note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique_note.d.ts","sourceRoot":"","sources":["../../src/note/unique_note.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAK9E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,qBAAa,UAAU;IAEnB,kDAAkD;IAC3C,IAAI,EAAE,IAAI;IACjB,mEAAmE;IAC5D,SAAS,EAAE,YAAY;IAC9B,oDAAoD;IAC7C,eAAe,EAAE,YAAY;IACpC,iEAAiE;IAC1D,WAAW,EAAE,EAAE;IACtB,kDAAkD;IAC3C,MAAM,EAAE,MAAM;IACrB,gGAAgG;IACzF,SAAS,EAAE,EAAE;;IAXpB,kDAAkD;IAC3C,IAAI,EAAE,IAAI;IACjB,mEAAmE;IAC5D,SAAS,EAAE,YAAY;IAC9B,oDAAoD;IAC7C,eAAe,EAAE,YAAY;IACpC,iEAAiE;IAC1D,WAAW,EAAE,EAAE;IACtB,kDAAkD;IAC3C,MAAM,EAAE,MAAM;IACrB,gGAAgG;IACzF,SAAS,EAAE,EAAE;IAGtB,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,CAatC;IAED,QAAQ,IAAI,MAAM;WAWL,MAAM;IAWnB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAa/C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAI7B,QAAQ;CAGT"}

package/dest/note/unique_note.js

@@ -0,0 +1,67 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
+import { z } from 'zod';
+import { AztecAddress } from '../aztec-address/index.js';
+import { schemas } from '../schemas/index.js';
+import { TxHash } from '../tx/tx_hash.js';
+import { Note } from './note.js';
+/**
+ * A note with contextual data and a nonce that makes it unique.
+ */ export class UniqueNote {
+    note;
+    recipient;
+    contractAddress;
+    storageSlot;
+    txHash;
+    noteNonce;
+    constructor(/** The note as emitted from the Noir contract. */ note, /** The recipient whose public key was used to encrypt the note. */ recipient, /** The contract address this note is created in. */ contractAddress, /** The specific storage location of the note on the contract. */ storageSlot, /** The hash of the tx the note was created in. */ txHash, /** The nonce that was injected into the note hash preimage in order to guarantee uniqueness. */ noteNonce){
+        this.note = note;
+        this.recipient = recipient;
+        this.contractAddress = contractAddress;
+        this.storageSlot = storageSlot;
+        this.txHash = txHash;
+        this.noteNonce = noteNonce;
+    }
+    static get schema() {
+        return z.object({
+            note: Note.schema,
+            recipient: schemas.AztecAddress,
+            contractAddress: schemas.AztecAddress,
+            storageSlot: schemas.Fr,
+            txHash: TxHash.schema,
+            noteNonce: schemas.Fr
+        }).transform(({ note, recipient, contractAddress, storageSlot, txHash, noteNonce })=>{
+            return new UniqueNote(note, recipient, contractAddress, storageSlot, txHash, noteNonce);
+        });
+    }
+    toBuffer() {
+        return serializeToBuffer([
+            this.note,
+            this.recipient,
+            this.contractAddress,
+            this.storageSlot,
+            this.txHash,
+            this.noteNonce
+        ]);
+    }
+    static async random() {
+        return new UniqueNote(Note.random(), await AztecAddress.random(), await AztecAddress.random(), Fr.random(), TxHash.random(), Fr.random());
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const note = reader.readObject(Note);
+        const recipient = reader.readObject(AztecAddress);
+        const contractAddress = reader.readObject(AztecAddress);
+        const storageSlot = reader.readObject(Fr);
+        const txHash = reader.readObject(TxHash);
+        const noteNonce = reader.readObject(Fr);
+        return new UniqueNote(note, recipient, contractAddress, storageSlot, txHash, noteNonce);
+    }
+    static fromString(str) {
+        return UniqueNote.fromBuffer(hexToBuffer(str));
+    }
+    toString() {
+        return bufferToHex(this.toBuffer());
+    }
+}

package/dest/p2p/attestation_utils.d.ts

@@ -0,0 +1,10 @@
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import { CommitteeAttestation } from '../block/index.js';
+import type { BlockAttestation } from './block_attestation.js';
+/**
+ * Returns attestation signatures in the order of a series of provided ethereum addresses
+ * The rollup smart contract expects attestations to appear in the order of the committee
+ * @todo: perform this logic within the memory attestation store instead?
+ */
+export declare function orderAttestations(attestations: BlockAttestation[], orderAddresses: EthAddress[]): CommitteeAttestation[];
+//# sourceMappingURL=attestation_utils.d.ts.map

package/dest/p2p/attestation_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation_utils.d.ts","sourceRoot":"","sources":["../../src/p2p/attestation_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,UAAU,EAAE,GAC3B,oBAAoB,EAAE,CAqBxB"}

package/dest/p2p/attestation_utils.js

@@ -0,0 +1,21 @@
+import { CommitteeAttestation } from '../block/index.js';
+/**
+ * Returns attestation signatures in the order of a series of provided ethereum addresses
+ * The rollup smart contract expects attestations to appear in the order of the committee
+ * @todo: perform this logic within the memory attestation store instead?
+ */ export function orderAttestations(attestations, orderAddresses) {
+    // Create a map of sender addresses to BlockAttestations
+    const attestationMap = new Map();
+    for (const attestation of attestations){
+        const sender = attestation.getSender();
+        if (sender) {
+            attestationMap.set(sender.toString(), CommitteeAttestation.fromAddressAndSignature(sender, attestation.signature));
+        }
+    }
+    // Create the ordered array based on the orderAddresses, else return an empty attestation
+    const orderedAttestations = orderAddresses.map((address)=>{
+        const addressString = address.toString();
+        return attestationMap.get(addressString) || CommitteeAttestation.fromAddress(address);
+    });
+    return orderedAttestations;
+}