@aztec/stdlib 0.77.0-testnet-ignition.17

package/dest/logs/private_log.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, FieldReader, type Tuple } from '@aztec/foundation/serialize';
+import { inspect } from 'util';
+import { z } from 'zod';
+export declare class PrivateLog {
+    fields: Tuple<Fr, typeof PRIVATE_LOG_SIZE_IN_FIELDS>;
+    static SIZE_IN_BYTES: number;
+    constructor(fields: Tuple<Fr, typeof PRIVATE_LOG_SIZE_IN_FIELDS>);
+    toFields(): Fr[];
+    static fromFields(fields: Fr[] | FieldReader): PrivateLog;
+    isEmpty(): boolean;
+    static empty(): PrivateLog;
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer | BufferReader): PrivateLog;
+    static random(): PrivateLog;
+    static get schema(): z.ZodEffects<z.ZodObject<{
+        fields: z.ZodArray<z.ZodType<Fr, any, string>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fields: Fr[];
+    }, {
+        fields: string[];
+    }>, PrivateLog, {
+        fields: string[];
+    }>;
+    [inspect.custom](): string;
+}
+//# sourceMappingURL=private_log.d.ts.map

package/dest/logs/private_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private_log.d.ts","sourceRoot":"","sources":["../../src/logs/private_log.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,KAAK,EAAqB,MAAM,6BAA6B,CAAC;AAEvG,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,UAAU;IAGF,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,0BAA0B,CAAC;IAFvE,MAAM,CAAC,aAAa,SAAiD;gBAElD,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,0BAA0B,CAAC;IAEvE,QAAQ,IAAI,EAAE,EAAE;IAIhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW;IAK5C,OAAO;IAIP,MAAM,CAAC,KAAK;IAIZ,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK/C,MAAM,CAAC,MAAM;IAIb,MAAM,KAAK,MAAM;;;;;;;;OAMhB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAK3B"}

package/dest/logs/private_log.js

@@ -0,0 +1,47 @@
+import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/fields';
+import { schemas } from '@aztec/foundation/schemas';
+import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { inspect } from 'util';
+import { z } from 'zod';
+export class PrivateLog {
+    fields;
+    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * PRIVATE_LOG_SIZE_IN_FIELDS;
+    constructor(fields){
+        this.fields = fields;
+    }
+    toFields() {
+        return this.fields;
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new PrivateLog(reader.readFieldArray(PRIVATE_LOG_SIZE_IN_FIELDS));
+    }
+    isEmpty() {
+        return this.fields.every((f)=>f.isZero());
+    }
+    static empty() {
+        return new PrivateLog(makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.zero));
+    }
+    toBuffer() {
+        return serializeToBuffer(this.fields);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new PrivateLog(reader.readArray(PRIVATE_LOG_SIZE_IN_FIELDS, Fr));
+    }
+    static random() {
+        return new PrivateLog(makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.random));
+    }
+    static get schema() {
+        return z.object({
+            fields: z.array(schemas.Fr)
+        }).transform(({ fields })=>PrivateLog.fromFields(fields));
+    }
+    [inspect.custom]() {
+        return `PrivateLog {
+      fields: [${this.fields.map((x)=>inspect(x)).join(', ')}],
+    }`;
+    }
+}

package/dest/logs/public_log.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { PUBLIC_LOG_DATA_SIZE_IN_FIELDS } from '@aztec/constants';
+import { type FieldsOf } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/fields';
+import { type ZodFor } from '@aztec/foundation/schemas';
+import { BufferReader, FieldReader, type Tuple } from '@aztec/foundation/serialize';
+import { inspect } from 'util';
+import { AztecAddress } from '../aztec-address/index.js';
+export declare class PublicLog {
+    contractAddress: AztecAddress;
+    log: Tuple<Fr, typeof PUBLIC_LOG_DATA_SIZE_IN_FIELDS>;
+    static SIZE_IN_BYTES: number;
+    constructor(contractAddress: AztecAddress, log: Tuple<Fr, typeof PUBLIC_LOG_DATA_SIZE_IN_FIELDS>);
+    toFields(): Fr[];
+    static getFields(fields: FieldsOf<PublicLog>): readonly [AztecAddress, [Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr]];
+    static fromFields(fields: Fr[] | FieldReader): PublicLog;
+    isEmpty(): boolean;
+    static empty(): PublicLog;
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer | BufferReader): PublicLog;
+    static random(): Promise<PublicLog>;
+    equals(other: this): boolean;
+    toHumanReadable(): string;
+    static get schema(): ZodFor<PublicLog>;
+    [inspect.custom](): string;
+}
+//# sourceMappingURL=public_log.d.ts.map

package/dest/logs/public_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_log.d.ts","sourceRoot":"","sources":["../../src/logs/public_log.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,8BAA8B,EAA6B,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,KAAK,EAGX,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,SAAS;IAGD,eAAe,EAAE,YAAY;IAAS,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,8BAA8B,CAAC;IAF9G,MAAM,CAAC,aAAa,SAAgD;gBAEjD,eAAe,EAAE,YAAY,EAAS,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,8BAA8B,CAAC;IAE9G,QAAQ,IAAI,EAAE,EAAE;IAIhB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;IAI5C,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW;IAK5C,OAAO;IAIP,MAAM,CAAC,KAAK;IAIZ,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;WAKlC,MAAM;IAInB,MAAM,CAAC,KAAK,EAAE,IAAI;IAOlB,eAAe,IAAI,MAAM;IAIzB,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAOrC;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAM3B"}

package/dest/logs/public_log.js

@@ -0,0 +1,67 @@
+import { PUBLIC_LOG_DATA_SIZE_IN_FIELDS, PUBLIC_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/fields';
+import { schemas } from '@aztec/foundation/schemas';
+import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
+import { inspect } from 'util';
+import { z } from 'zod';
+import { AztecAddress } from '../aztec-address/index.js';
+export class PublicLog {
+    contractAddress;
+    log;
+    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * PUBLIC_LOG_SIZE_IN_FIELDS;
+    constructor(contractAddress, log){
+        this.contractAddress = contractAddress;
+        this.log = log;
+    }
+    toFields() {
+        return serializeToFields(...PublicLog.getFields(this));
+    }
+    static getFields(fields) {
+        return [
+            fields.contractAddress,
+            fields.log
+        ];
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new PublicLog(reader.readObject(AztecAddress), reader.readFieldArray(PUBLIC_LOG_DATA_SIZE_IN_FIELDS));
+    }
+    isEmpty() {
+        return this.contractAddress.isZero() && this.log.every((f)=>f.isZero());
+    }
+    static empty() {
+        return new PublicLog(AztecAddress.ZERO, makeTuple(PUBLIC_LOG_DATA_SIZE_IN_FIELDS, Fr.zero));
+    }
+    toBuffer() {
+        return serializeToBuffer(...PublicLog.getFields(this));
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new PublicLog(reader.readObject(AztecAddress), reader.readArray(PUBLIC_LOG_DATA_SIZE_IN_FIELDS, Fr));
+    }
+    static async random() {
+        return new PublicLog(await AztecAddress.random(), makeTuple(PUBLIC_LOG_DATA_SIZE_IN_FIELDS, Fr.random));
+    }
+    equals(other) {
+        return this.contractAddress.equals(other.contractAddress) && this.log.reduce((acc, field, i)=>acc && field.equals(other.log[i]), true);
+    }
+    toHumanReadable() {
+        return `PublicLog: (contractAddress: ${this.contractAddress} log: ${this.log})`;
+    }
+    static get schema() {
+        return z.object({
+            contractAddress: AztecAddress.schema,
+            log: z.array(schemas.Fr)
+        }).transform(({ contractAddress, log })=>PublicLog.fromFields([
+                contractAddress.toField(),
+                ...log
+            ]));
+    }
+    [inspect.custom]() {
+        return `PublicLog {
+      contractAddress: ${inspect(this.contractAddress)},
+      log: [${this.log.map((x)=>inspect(x)).join(', ')}],
+    }`;
+    }
+}

package/dest/logs/tx_scoped_l2_log.d.ts

@@ -0,0 +1,60 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { z } from 'zod';
+import { TxHash } from '../tx/tx_hash.js';
+export declare class TxScopedL2Log {
+    txHash: TxHash;
+    dataStartIndexForTx: number;
+    blockNumber: number;
+    isFromPublic: boolean;
+    logData: Buffer;
+    constructor(txHash: TxHash, dataStartIndexForTx: number, blockNumber: number, isFromPublic: boolean, logData: Buffer);
+    static get schema(): z.ZodEffects<z.ZodObject<{
+        txHash: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, Buffer, string>, TxHash, string>;
+        dataStartIndexForTx: z.ZodNumber;
+        blockNumber: z.ZodNumber;
+        isFromPublic: z.ZodBoolean;
+        logData: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, Buffer, string>, z.ZodEffects<z.ZodObject<{
+            type: z.ZodLiteral<"Buffer">;
+            data: z.ZodArray<z.ZodNumber, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "Buffer";
+            data: number[];
+        }, {
+            type: "Buffer";
+            data: number[];
+        }>, Buffer, {
+            type: "Buffer";
+            data: number[];
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        blockNumber: number;
+        txHash: TxHash;
+        dataStartIndexForTx: number;
+        isFromPublic: boolean;
+        logData: Buffer;
+    }, {
+        blockNumber: number;
+        txHash: string;
+        dataStartIndexForTx: number;
+        isFromPublic: boolean;
+        logData: string | {
+            type: "Buffer";
+            data: number[];
+        };
+    }>, TxScopedL2Log, {
+        blockNumber: number;
+        txHash: string;
+        dataStartIndexForTx: number;
+        isFromPublic: boolean;
+        logData: string | {
+            type: "Buffer";
+            data: number[];
+        };
+    }>;
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer): TxScopedL2Log;
+    static random(): TxScopedL2Log;
+    equals(other: TxScopedL2Log): boolean;
+}
+//# sourceMappingURL=tx_scoped_l2_log.d.ts.map

package/dest/logs/tx_scoped_l2_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx_scoped_l2_log.d.ts","sourceRoot":"","sources":["../../src/logs/tx_scoped_l2_log.ts"],"names":[],"mappings":";;AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,qBAAa,aAAa;IAKf,MAAM,EAAE,MAAM;IAKd,mBAAmB,EAAE,MAAM;IAI3B,WAAW,EAAE,MAAM;IAInB,YAAY,EAAE,OAAO;IAIrB,OAAO,EAAE,MAAM;gBAjBf,MAAM,EAAE,MAAM,EAKd,mBAAmB,EAAE,MAAM,EAI3B,WAAW,EAAE,MAAM,EAInB,YAAY,EAAE,OAAO,EAIrB,OAAO,EAAE,MAAM;IAGxB,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAahB;IAED,QAAQ;IAUR,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM;IAWhC,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,KAAK,EAAE,aAAa;CAS5B"}

package/dest/logs/tx_scoped_l2_log.js

@@ -0,0 +1,58 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, boolToBuffer, numToUInt32BE } from '@aztec/foundation/serialize';
+import { z } from 'zod';
+import { schemas } from '../schemas/schemas.js';
+import { TxHash } from '../tx/tx_hash.js';
+export class TxScopedL2Log {
+    txHash;
+    dataStartIndexForTx;
+    blockNumber;
+    isFromPublic;
+    logData;
+    constructor(/*
+     * Hash of the tx where the log is included
+     */ txHash, /*
+     * The next available leaf index for the note hash tree for this transaction. It is stored
+     * with the log so the noteHashIndex can be reconstructed after decryption.
+     */ dataStartIndexForTx, /*
+     * The block this log is included in
+     */ blockNumber, /*
+     * Indicates if the log comes from the public logs stream (partial note)
+     */ isFromPublic, /*
+     * The log data
+     */ logData){
+        this.txHash = txHash;
+        this.dataStartIndexForTx = dataStartIndexForTx;
+        this.blockNumber = blockNumber;
+        this.isFromPublic = isFromPublic;
+        this.logData = logData;
+    }
+    static get schema() {
+        return z.object({
+            txHash: TxHash.schema,
+            dataStartIndexForTx: z.number(),
+            blockNumber: z.number(),
+            isFromPublic: z.boolean(),
+            logData: schemas.Buffer
+        }).transform(({ txHash, dataStartIndexForTx, blockNumber, isFromPublic, logData })=>new TxScopedL2Log(txHash, dataStartIndexForTx, blockNumber, isFromPublic, logData));
+    }
+    toBuffer() {
+        return Buffer.concat([
+            this.txHash.toBuffer(),
+            numToUInt32BE(this.dataStartIndexForTx),
+            numToUInt32BE(this.blockNumber),
+            boolToBuffer(this.isFromPublic),
+            this.logData
+        ]);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new TxScopedL2Log(reader.readObject(TxHash), reader.readNumber(), reader.readNumber(), reader.readBoolean(), reader.readToEnd());
+    }
+    static random() {
+        return new TxScopedL2Log(TxHash.random(), 1, 1, false, Fr.random().toBuffer());
+    }
+    equals(other) {
+        return this.txHash.equals(other.txHash) && this.dataStartIndexForTx === other.dataStartIndexForTx && this.blockNumber === other.blockNumber && this.isFromPublic === other.isFromPublic && this.logData.equals(other.logData);
+    }
+}

package/dest/messaging/inbox_leaf.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader } from '@aztec/foundation/serialize';
+export declare class InboxLeaf {
+    /** Index of the leaf in the whole tree. */
+    readonly index: bigint;
+    /** Leaf in the subtree/message hash. */
+    readonly leaf: Fr;
+    constructor(
+    /** Index of the leaf in the whole tree. */
+    index: bigint, 
+    /** Leaf in the subtree/message hash. */
+    leaf: Fr);
+    toBuffer(): Buffer;
+    fromBuffer(buffer: Buffer | BufferReader): InboxLeaf;
+    static smallestIndexFromL2Block(l2block: bigint): bigint;
+}
+//# sourceMappingURL=inbox_leaf.d.ts.map

package/dest/messaging/inbox_leaf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox_leaf.d.ts","sourceRoot":"","sources":["../../src/messaging/inbox_leaf.ts"],"names":[],"mappings":";;AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,qBAAa,SAAS;IAElB,2CAA2C;aAC3B,KAAK,EAAE,MAAM;IAC7B,wCAAwC;aACxB,IAAI,EAAE,EAAE;;IAHxB,2CAA2C;IAC3B,KAAK,EAAE,MAAM;IAC7B,wCAAwC;IACxB,IAAI,EAAE,EAAE;IAG1B,QAAQ,IAAI,MAAM;IAIlB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAOpD,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGzD"}

package/dest/messaging/inbox_leaf.js

@@ -0,0 +1,27 @@
+import { INITIAL_L2_BLOCK_NUM, NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP } from '@aztec/constants';
+import { toBigIntBE } from '@aztec/foundation/bigint-buffer';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+export class InboxLeaf {
+    index;
+    leaf;
+    constructor(/** Index of the leaf in the whole tree. */ index, /** Leaf in the subtree/message hash. */ leaf){
+        this.index = index;
+        this.leaf = leaf;
+    }
+    toBuffer() {
+        return serializeToBuffer([
+            this.index,
+            this.leaf
+        ]);
+    }
+    fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const index = toBigIntBE(reader.readBytes(32));
+        const leaf = reader.readObject(Fr);
+        return new InboxLeaf(index, leaf);
+    }
+    static smallestIndexFromL2Block(l2block) {
+        return (l2block - BigInt(INITIAL_L2_BLOCK_NUM)) * BigInt(NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP);
+    }
+}

package/dest/messaging/index.d.ts

@@ -0,0 +1,7 @@
+export * from './inbox_leaf.js';
+export * from './l1_to_l2_message.js';
+export * from './l1_to_l2_message_source.js';
+export * from './l1_actor.js';
+export * from './l2_actor.js';
+export * from './l2_to_l1_message.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}

package/dest/messaging/index.js

@@ -0,0 +1,6 @@
+export * from './inbox_leaf.js';
+export * from './l1_to_l2_message.js';
+export * from './l1_to_l2_message_source.js';
+export * from './l1_actor.js';
+export * from './l2_actor.js';
+export * from './l2_to_l1_message.js';

package/dest/messaging/l1_actor.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader } from '@aztec/foundation/serialize';
+/**
+ * The sender of an L1 to L2 message or recipient of an L2 to L1 message.
+ */
+export declare class L1Actor {
+    /**
+     * The sender of the message.
+     */
+    readonly sender: EthAddress;
+    /**
+     * The chain id on which the message was sent (L1 -> L2) or on which the message will be received (L2 -> L1).
+     */
+    readonly chainId: number;
+    constructor(
+    /**
+     * The sender of the message.
+     */
+    sender: EthAddress, 
+    /**
+     * The chain id on which the message was sent (L1 -> L2) or on which the message will be received (L2 -> L1).
+     */
+    chainId: number);
+    static empty(): L1Actor;
+    toFields(): Fr[];
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer | BufferReader): L1Actor;
+    static random(): L1Actor;
+}
+//# sourceMappingURL=l1_actor.d.ts.map

package/dest/messaging/l1_actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_actor.d.ts","sourceRoot":"","sources":["../../src/messaging/l1_actor.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E;;GAEG;AACH,qBAAa,OAAO;IAEhB;;OAEG;aACa,MAAM,EAAE,UAAU;IAClC;;OAEG;aACa,OAAO,EAAE,MAAM;;IAP/B;;OAEG;IACa,MAAM,EAAE,UAAU;IAClC;;OAEG;IACa,OAAO,EAAE,MAAM;IAGjC,MAAM,CAAC,KAAK;IAIZ,QAAQ,IAAI,EAAE,EAAE;IAIhB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO;IAOzD,MAAM,CAAC,MAAM,IAAI,OAAO;CAGzB"}

package/dest/messaging/l1_actor.js

@@ -0,0 +1,39 @@
+import { randomInt } from '@aztec/foundation/crypto';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+/**
+ * The sender of an L1 to L2 message or recipient of an L2 to L1 message.
+ */ export class L1Actor {
+    sender;
+    chainId;
+    constructor(/**
+     * The sender of the message.
+     */ sender, /**
+     * The chain id on which the message was sent (L1 -> L2) or on which the message will be received (L2 -> L1).
+     */ chainId){
+        this.sender = sender;
+        this.chainId = chainId;
+    }
+    static empty() {
+        return new L1Actor(EthAddress.ZERO, 0);
+    }
+    toFields() {
+        return [
+            this.sender.toField(),
+            new Fr(BigInt(this.chainId))
+        ];
+    }
+    toBuffer() {
+        return serializeToBuffer(this.sender, this.chainId);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const ethAddr = reader.readObject(EthAddress);
+        const chainId = reader.readNumber();
+        return new L1Actor(ethAddr, chainId);
+    }
+    static random() {
+        return new L1Actor(EthAddress.random(), randomInt(1000));
+    }
+}

package/dest/messaging/l1_to_l2_message.d.ts

@@ -0,0 +1,50 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import type { L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/constants';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { SiblingPath } from '@aztec/foundation/trees';
+import type { AztecAddress } from '../aztec-address/index.js';
+import type { AztecNode } from '../interfaces/aztec-node.js';
+import { L1Actor } from './l1_actor.js';
+import { L2Actor } from './l2_actor.js';
+/**
+ * The format of an L1 to L2 Message.
+ */
+export declare class L1ToL2Message {
+    /** The sender of the message on L1. */
+    readonly sender: L1Actor;
+    /** The recipient of the message on L2. */
+    readonly recipient: L2Actor;
+    /** The message content. */
+    readonly content: Fr;
+    /** The hash of the spending secret. */
+    readonly secretHash: Fr;
+    /** Global index of this message on the tree. */
+    readonly index: Fr;
+    constructor(
+    /** The sender of the message on L1. */
+    sender: L1Actor, 
+    /** The recipient of the message on L2. */
+    recipient: L2Actor, 
+    /** The message content. */
+    content: Fr, 
+    /** The hash of the spending secret. */
+    secretHash: Fr, 
+    /** Global index of this message on the tree. */
+    index: Fr);
+    /**
+     * Returns each element within its own field so that it can be consumed by an acvm oracle call.
+     * @returns The message as an array of fields (in order).
+     */
+    toFields(): Fr[];
+    toBuffer(): Buffer;
+    hash(): Fr;
+    static fromBuffer(buffer: Buffer | BufferReader): L1ToL2Message;
+    toString(): string;
+    static fromString(data: string): L1ToL2Message;
+    static empty(): L1ToL2Message;
+    static random(): Promise<L1ToL2Message>;
+}
+export declare function getNonNullifiedL1ToL2MessageWitness(node: AztecNode, contractAddress: AztecAddress, messageHash: Fr, secret: Fr): Promise<[bigint, SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>]>;
+//# sourceMappingURL=l1_to_l2_message.d.ts.map

package/dest/messaging/l1_to_l2_message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_to_l2_message.d.ts","sourceRoot":"","sources":["../../src/messaging/l1_to_l2_message.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,qBAAa,aAAa;IAEtB,uCAAuC;aACvB,MAAM,EAAE,OAAO;IAC/B,0CAA0C;aAC1B,SAAS,EAAE,OAAO;IAClC,2BAA2B;aACX,OAAO,EAAE,EAAE;IAC3B,uCAAuC;aACvB,UAAU,EAAE,EAAE;IAC9B,gDAAgD;aAChC,KAAK,EAAE,EAAE;;IATzB,uCAAuC;IACvB,MAAM,EAAE,OAAO;IAC/B,0CAA0C;IAC1B,SAAS,EAAE,OAAO;IAClC,2BAA2B;IACX,OAAO,EAAE,EAAE;IAC3B,uCAAuC;IACvB,UAAU,EAAE,EAAE;IAC9B,gDAAgD;IAChC,KAAK,EAAE,EAAE;IAG3B;;;OAGG;IACH,QAAQ,IAAI,EAAE,EAAE;IAIhB,QAAQ,IAAI,MAAM;IAIlB,IAAI,IAAI,EAAE;IAIV,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa;IAU/D,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAK9C,MAAM,CAAC,KAAK,IAAI,aAAa;WAIhB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;CAG9C;AAGD,wBAAsB,mCAAmC,CACvD,IAAI,EAAE,SAAS,EACf,eAAe,EAAE,YAAY,EAC7B,WAAW,EAAE,EAAE,EACf,MAAM,EAAE,EAAE,GACT,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAejE"}

package/dest/messaging/l1_to_l2_message.js

@@ -0,0 +1,83 @@
+import { sha256ToField } from '@aztec/foundation/crypto';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { bufferToHex } from '@aztec/foundation/string';
+import { computeL1ToL2MessageNullifier } from '../hash/hash.js';
+import { MerkleTreeId } from '../trees/merkle_tree_id.js';
+import { L1Actor } from './l1_actor.js';
+import { L2Actor } from './l2_actor.js';
+/**
+ * The format of an L1 to L2 Message.
+ */ export class L1ToL2Message {
+    sender;
+    recipient;
+    content;
+    secretHash;
+    index;
+    constructor(/** The sender of the message on L1. */ sender, /** The recipient of the message on L2. */ recipient, /** The message content. */ content, /** The hash of the spending secret. */ secretHash, /** Global index of this message on the tree. */ index){
+        this.sender = sender;
+        this.recipient = recipient;
+        this.content = content;
+        this.secretHash = secretHash;
+        this.index = index;
+    }
+    /**
+   * Returns each element within its own field so that it can be consumed by an acvm oracle call.
+   * @returns The message as an array of fields (in order).
+   */ toFields() {
+        return [
+            ...this.sender.toFields(),
+            ...this.recipient.toFields(),
+            this.content,
+            this.secretHash,
+            this.index
+        ];
+    }
+    toBuffer() {
+        return serializeToBuffer(this.sender, this.recipient, this.content, this.secretHash, this.index);
+    }
+    hash() {
+        return sha256ToField(this.toFields());
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const sender = reader.readObject(L1Actor);
+        const recipient = reader.readObject(L2Actor);
+        const content = Fr.fromBuffer(reader);
+        const secretHash = Fr.fromBuffer(reader);
+        const index = Fr.fromBuffer(reader);
+        return new L1ToL2Message(sender, recipient, content, secretHash, index);
+    }
+    toString() {
+        return bufferToHex(this.toBuffer());
+    }
+    static fromString(data) {
+        const buffer = Buffer.from(data, 'hex');
+        return L1ToL2Message.fromBuffer(buffer);
+    }
+    static empty() {
+        return new L1ToL2Message(L1Actor.empty(), L2Actor.empty(), Fr.ZERO, Fr.ZERO, Fr.ZERO);
+    }
+    static async random() {
+        return new L1ToL2Message(L1Actor.random(), await L2Actor.random(), Fr.random(), Fr.random(), Fr.random());
+    }
+}
+// This functionality is not on the node because we do not want to pass the node the secret, and give the node the ability to derive a valid nullifer for an L1 to L2 message.
+export async function getNonNullifiedL1ToL2MessageWitness(node, contractAddress, messageHash, secret) {
+    const response = await node.getL1ToL2MessageMembershipWitness('latest', messageHash);
+    if (!response) {
+        throw new Error(`No L1 to L2 message found for message hash ${messageHash.toString()}`);
+    }
+    const [messageIndex, siblingPath] = response;
+    const messageNullifier = await computeL1ToL2MessageNullifier(contractAddress, messageHash, secret);
+    const [nullifierIndex] = await node.findLeavesIndexes('latest', MerkleTreeId.NULLIFIER_TREE, [
+        messageNullifier
+    ]);
+    if (nullifierIndex !== undefined) {
+        throw new Error(`No non-nullified L1 to L2 message found for message hash ${messageHash.toString()}`);
+    }
+    return [
+        messageIndex,
+        siblingPath
+    ];
+}

package/dest/messaging/l1_to_l2_message_source.d.ts

@@ -0,0 +1,24 @@
+import type { Fr } from '@aztec/foundation/fields';
+/**
+ * Interface of classes allowing for the retrieval of L1 to L2 messages.
+ */
+export interface L1ToL2MessageSource {
+    /**
+     * Gets new L1 to L2 message (to be) included in a given block.
+     * @param blockNumber - L2 block number to get messages for.
+     * @returns The L1 to L2 messages/leaves of the messages subtree (throws if not found).
+     */
+    getL1ToL2Messages(blockNumber: bigint): Promise<Fr[]>;
+    /**
+     * Gets the L1 to L2 message index in the L1 to L2 message tree.
+     * @param l1ToL2Message - The L1 to L2 message.
+     * @returns The index of the L1 to L2 message in the L1 to L2 message tree (undefined if not found).
+     */
+    getL1ToL2MessageIndex(l1ToL2Message: Fr): Promise<bigint | undefined>;
+    /**
+     * Gets the number of the latest L2 block processed by the implementation.
+     * @returns The number of the latest L2 block processed by the implementation.
+     */
+    getBlockNumber(): Promise<number>;
+}
+//# sourceMappingURL=l1_to_l2_message_source.d.ts.map

package/dest/messaging/l1_to_l2_message_source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_to_l2_message_source.d.ts","sourceRoot":"","sources":["../../src/messaging/l1_to_l2_message_source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtD;;;;OAIG;IACH,qBAAqB,CAAC,aAAa,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAEtE;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACnC"}

package/dest/messaging/l1_to_l2_message_source.js

@@ -0,0 +1,3 @@
+/**
+ * Interface of classes allowing for the retrieval of L1 to L2 messages.
+ */ export { };