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

package/dest/logs/log_id.d.ts

@@ -1,14 +1,12 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
+import { BlockNumber } from '@aztec/foundation/branded-types';
 import { BufferReader } from '@aztec/foundation/serialize';
 import { z } from 'zod';
+import { L2BlockHash } from '../block/block_hash.js';
 /** A globally unique log id. */
 export declare class LogId {
-    /** The block number the log was emitted in. */
-    readonly blockNumber: number;
-    /** The index of a tx in a block the log was emitted in. */
+    readonly blockNumber: BlockNumber;
+    readonly blockHash: L2BlockHash;
     readonly txIndex: number;
-    /** The index of a log the tx was emitted in. */
     readonly logIndex: number;
     /**
      * Parses a log id from a string.
@@ -18,26 +16,34 @@ export declare class LogId {
      */
     constructor(
     /** The block number the log was emitted in. */
-    blockNumber: number, 
+    blockNumber: BlockNumber, 
+    /** The hash of the block the log was emitted in. */
+    blockHash: L2BlockHash, 
     /** The index of a tx in a block the log was emitted in. */
     txIndex: number, 
     /** The index of a log the tx was emitted in. */
     logIndex: number);
     static random(): LogId;
     static get schema(): z.ZodEffects<z.ZodObject<{
-        blockNumber: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
+        blockNumber: z.ZodEffects<z.ZodPipeline<z.ZodUnion<[z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodNumber>, BlockNumber, string | number | bigint>;
+        blockHash: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, Buffer<ArrayBuffer>, string>, L2BlockHash, string>;
         txIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
         logIndex: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        blockNumber: number;
+        blockNumber: number & {
+            _branding: "BlockNumber";
+        };
+        blockHash: L2BlockHash;
         txIndex: number;
         logIndex: number;
     }, {
         blockNumber: string | number | bigint;
+        blockHash: string;
         txIndex: string | number | bigint;
         logIndex: string | number | bigint;
     }>, LogId, {
         blockNumber: string | number | bigint;
+        blockHash: string;
         txIndex: string | number | bigint;
         logIndex: string | number | bigint;
     }>;
@@ -69,4 +75,4 @@ export declare class LogId {
      */
     toHumanReadable(): string;
 }
-//# sourceMappingURL=log_id.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX2lkLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9sb2dfaWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLFdBQVcsRUFBcUIsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFM0QsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFHckQsZ0NBQWdDO0FBQ2hDLHFCQUFhLEtBQUs7YUFTRSxXQUFXLEVBQUUsV0FBVzthQUV4QixTQUFTLEVBQUUsV0FBVzthQUV0QixPQUFPLEVBQUUsTUFBTTthQUVmLFFBQVEsRUFBRSxNQUFNO0lBZGxDOzs7OztPQUtHO0lBQ0g7SUFDRSwrQ0FBK0M7SUFDL0IsV0FBVyxFQUFFLFdBQVc7SUFDeEMsb0RBQW9EO0lBQ3BDLFNBQVMsRUFBRSxXQUFXO0lBQ3RDLDJEQUEyRDtJQUMzQyxPQUFPLEVBQUUsTUFBTTtJQUMvQixnREFBZ0Q7SUFDaEMsUUFBUSxFQUFFLE1BQU0sRUFXakM7SUFFRCxNQUFNLENBQUMsTUFBTSxVQU9aO0lBRUQsTUFBTSxLQUFLLE1BQU07Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FXaEI7SUFFRDs7O09BR0c7SUFDSSxRQUFRLElBQUksTUFBTSxDQU94QjtJQUVEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxHQUFHLEtBQUssQ0FTdEQ7SUFFRDs7O09BR0c7SUFDSSxRQUFRLElBQUksTUFBTSxDQUV4QjtJQUVEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLElBQUksRUFBRSxNQUFNLEdBQUcsS0FBSyxDQVFyQztJQUVEOzs7T0FHRztJQUNJLGVBQWUsSUFBSSxNQUFNLENBRS9CO0NBQ0YifQ==

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

@@ -1 +1 @@
-{"version":3,"file":"log_id.d.ts","sourceRoot":"","sources":["../../src/logs/log_id.ts"],"names":[],"mappings":";;AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gCAAgC;AAChC,qBAAa,KAAK;IAQd,+CAA+C;aAC/B,WAAW,EAAE,MAAM;IACnC,2DAA2D;aAC3C,OAAO,EAAE,MAAM;IAC/B,gDAAgD;aAChC,QAAQ,EAAE,MAAM;IAZlC;;;;;OAKG;;IAED,+CAA+C;IAC/B,WAAW,EAAE,MAAM;IACnC,2DAA2D;IAC3C,OAAO,EAAE,MAAM;IAC/B,gDAAgD;IAChC,QAAQ,EAAE,MAAM;IAalC,MAAM,CAAC,MAAM;IAQb,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;OAQhB;IAED;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAQzB;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK;IAUvD;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAStC;;;OAGG;IACI,eAAe,IAAI,MAAM;CAGjC"}
+{"version":3,"file":"log_id.d.ts","sourceRoot":"","sources":["../../src/logs/log_id.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAqB,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,gCAAgC;AAChC,qBAAa,KAAK;aASE,WAAW,EAAE,WAAW;aAExB,SAAS,EAAE,WAAW;aAEtB,OAAO,EAAE,MAAM;aAEf,QAAQ,EAAE,MAAM;IAdlC;;;;;OAKG;IACH;IACE,+CAA+C;IAC/B,WAAW,EAAE,WAAW;IACxC,oDAAoD;IACpC,SAAS,EAAE,WAAW;IACtC,2DAA2D;IAC3C,OAAO,EAAE,MAAM;IAC/B,gDAAgD;IAChC,QAAQ,EAAE,MAAM,EAWjC;IAED,MAAM,CAAC,MAAM,UAOZ;IAED,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;OAWhB;IAED;;;OAGG;IACI,QAAQ,IAAI,MAAM,CAOxB;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,CAStD;IAED;;;OAGG;IACI,QAAQ,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAQrC;IAED;;;OAGG;IACI,eAAe,IAAI,MAAM,CAE/B;CACF"}

package/dest/logs/log_id.js

@@ -1,10 +1,13 @@
 import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
 import { toBufferBE } from '@aztec/foundation/bigint-buffer';
+import { BlockNumber, BlockNumberSchema } from '@aztec/foundation/branded-types';
 import { BufferReader } from '@aztec/foundation/serialize';
 import { z } from 'zod';
+import { L2BlockHash } from '../block/block_hash.js';
 import { schemas } from '../schemas/index.js';
 /** A globally unique log id. */ export class LogId {
     blockNumber;
+    blockHash;
     txIndex;
     logIndex;
     /**
@@ -12,8 +15,9 @@ import { schemas } from '../schemas/index.js';
    * @param blockNumber - The block number.
    * @param txIndex - The transaction index.
    * @param logIndex - The log index.
-   */ constructor(/** The block number the log was emitted in. */ blockNumber, /** The index of a tx in a block the log was emitted in. */ txIndex, /** The index of a log the tx was emitted in. */ logIndex){
+   */ constructor(/** The block number the log was emitted in. */ blockNumber, /** The hash of the block the log was emitted in. */ blockHash, /** The index of a tx in a block the log was emitted in. */ txIndex, /** The index of a log the tx was emitted in. */ logIndex){
         this.blockNumber = blockNumber;
+        this.blockHash = blockHash;
         this.txIndex = txIndex;
         this.logIndex = logIndex;
         if (!Number.isInteger(blockNumber) || blockNumber < INITIAL_L2_BLOCK_NUM) {
@@ -27,14 +31,15 @@ import { schemas } from '../schemas/index.js';
         }
     }
     static random() {
-        return new LogId(Math.floor(Math.random() * 1000) + 1, Math.floor(Math.random() * 1000), Math.floor(Math.random() * 100));
+        return new LogId(BlockNumber(Math.floor(Math.random() * 1000) + 1), L2BlockHash.random(), Math.floor(Math.random() * 1000), Math.floor(Math.random() * 100));
     }
     static get schema() {
         return z.object({
-            blockNumber: schemas.Integer,
+            blockNumber: BlockNumberSchema,
+            blockHash: L2BlockHash.schema,
             txIndex: schemas.Integer,
             logIndex: schemas.Integer
-        }).transform(({ blockNumber, txIndex, logIndex })=>new LogId(blockNumber, txIndex, logIndex));
+        }).transform(({ blockNumber, blockHash, txIndex, logIndex })=>new LogId(blockNumber, blockHash, txIndex, logIndex));
     }
     /**
    * Serializes log id to a buffer.
@@ -42,6 +47,7 @@ import { schemas } from '../schemas/index.js';
    */ toBuffer() {
         return Buffer.concat([
             toBufferBE(BigInt(this.blockNumber), 4),
+            this.blockHash.toBuffer(),
             toBufferBE(BigInt(this.txIndex), 4),
             toBufferBE(BigInt(this.logIndex), 4)
         ]);
@@ -52,32 +58,34 @@ import { schemas } from '../schemas/index.js';
    * @returns A log id.
    */ static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
-        const blockNumber = reader.readNumber();
+        const blockNumber = BlockNumber(reader.readNumber());
+        const blockHash = reader.readObject(L2BlockHash);
         const txIndex = reader.readNumber();
         const logIndex = reader.readNumber();
-        return new LogId(blockNumber, txIndex, logIndex);
+        return new LogId(blockNumber, blockHash, txIndex, logIndex);
     }
     /**
    * Converts the LogId instance to a string.
    * @returns A string representation of the log id.
    */ toString() {
-        return `${this.blockNumber}-${this.txIndex}-${this.logIndex}`;
+        return `${this.blockNumber}-${this.txIndex}-${this.logIndex}-${this.blockHash.toString()}`;
     }
     /**
    * Creates a LogId from a string.
    * @param data - A string representation of a log id.
    * @returns A log id.
    */ static fromString(data) {
-        const [rawBlockNumber, rawTxIndex, rawLogIndex] = data.split('-');
-        const blockNumber = Number(rawBlockNumber);
+        const [rawBlockNumber, rawTxIndex, rawLogIndex, rawBlockHash] = data.split('-');
+        const blockNumber = BlockNumber(Number(rawBlockNumber));
+        const blockHash = L2BlockHash.fromString(rawBlockHash);
         const txIndex = Number(rawTxIndex);
         const logIndex = Number(rawLogIndex);
-        return new LogId(blockNumber, txIndex, logIndex);
+        return new LogId(blockNumber, blockHash, txIndex, logIndex);
     }
     /**
    * Serializes log id to a human readable string.
    * @returns A human readable representation of the log id.
    */ toHumanReadable() {
-        return `logId: (blockNumber: ${this.blockNumber}, txIndex: ${this.txIndex}, logIndex: ${this.logIndex})`;
+        return `logId: (blockNumber: ${this.blockNumber}, blockHash: ${this.blockHash.toString()}, txIndex: ${this.txIndex}, logIndex: ${this.logIndex})`;
     }
 }

package/dest/logs/log_with_tx_data.d.ts

@@ -1,11 +1,19 @@
-import { Fr } from '@aztec/foundation/fields';
-export declare class LogWithTxData {
-    logContent: Fr[];
-    txHash: Fr;
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { TxHash } from '@aztec/stdlib/tx';
+export declare class PublicLogWithTxData {
+    logPayload: Fr[];
+    txHash: TxHash;
     uniqueNoteHashesInTx: Fr[];
     firstNullifierInTx: Fr;
-    constructor(logContent: Fr[], txHash: Fr, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr);
+    constructor(logPayload: Fr[], txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr);
+}
+export declare class PrivateLogWithTxData {
+    logPayload: Fr[];
+    txHash: TxHash;
+    uniqueNoteHashesInTx: Fr[];
+    firstNullifierInTx: Fr;
+    constructor(logPayload: Fr[], txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr);
     toNoirSerialization(): (Fr | Fr[])[];
     static noirSerializationOfEmpty(): (Fr | Fr[])[];
 }
-//# sourceMappingURL=log_with_tx_data.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3dpdGhfdHhfZGF0YS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvbG9nX3dpdGhfdHhfZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRzFDLHFCQUFhLG1CQUFtQjtJQUVyQixVQUFVLEVBQUUsRUFBRSxFQUFFO0lBQ2hCLE1BQU0sRUFBRSxNQUFNO0lBQ2Qsb0JBQW9CLEVBQUUsRUFBRSxFQUFFO0lBQzFCLGtCQUFrQixFQUFFLEVBQUU7SUFKL0IsWUFDUyxVQUFVLEVBQUUsRUFBRSxFQUFFLEVBQ2hCLE1BQU0sRUFBRSxNQUFNLEVBQ2Qsb0JBQW9CLEVBQUUsRUFBRSxFQUFFLEVBQzFCLGtCQUFrQixFQUFFLEVBQUUsRUFDM0I7Q0FDTDtBQUdELHFCQUFhLG9CQUFvQjtJQUV0QixVQUFVLEVBQUUsRUFBRSxFQUFFO0lBQ2hCLE1BQU0sRUFBRSxNQUFNO0lBQ2Qsb0JBQW9CLEVBQUUsRUFBRSxFQUFFO0lBQzFCLGtCQUFrQixFQUFFLEVBQUU7SUFKL0IsWUFDUyxVQUFVLEVBQUUsRUFBRSxFQUFFLEVBQ2hCLE1BQU0sRUFBRSxNQUFNLEVBQ2Qsb0JBQW9CLEVBQUUsRUFBRSxFQUFFLEVBQzFCLGtCQUFrQixFQUFFLEVBQUUsRUFDM0I7SUFFSixtQkFBbUIsSUFBSSxDQUFDLEVBQUUsR0FBRyxFQUFFLEVBQUUsQ0FBQyxFQUFFLENBT25DO0lBRUQsTUFBTSxDQUFDLHdCQUF3QixJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsRUFBRSxDQUFDLEVBQUUsQ0FFL0M7Q0FDRiJ9

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

@@ -1 +1 @@
-{"version":3,"file":"log_with_tx_data.d.ts","sourceRoot":"","sources":["../../src/logs/log_with_tx_data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAI9C,qBAAa,aAAa;IAEf,UAAU,EAAE,EAAE,EAAE;IAChB,MAAM,EAAE,EAAE;IACV,oBAAoB,EAAE,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;gBAHtB,UAAU,EAAE,EAAE,EAAE,EAChB,MAAM,EAAE,EAAE,EACV,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE;IAG/B,mBAAmB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE;IASpC,MAAM,CAAC,wBAAwB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE;CAGjD"}
+{"version":3,"file":"log_with_tx_data.d.ts","sourceRoot":"","sources":["../../src/logs/log_with_tx_data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,qBAAa,mBAAmB;IAErB,UAAU,EAAE,EAAE,EAAE;IAChB,MAAM,EAAE,MAAM;IACd,oBAAoB,EAAE,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IAJ/B,YACS,UAAU,EAAE,EAAE,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE,EAC3B;CACL;AAGD,qBAAa,oBAAoB;IAEtB,UAAU,EAAE,EAAE,EAAE;IAChB,MAAM,EAAE,MAAM;IACd,oBAAoB,EAAE,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IAJ/B,YACS,UAAU,EAAE,EAAE,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE,EAC3B;IAEJ,mBAAmB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAOnC;IAED,MAAM,CAAC,wBAAwB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAE/C;CACF"}

package/dest/logs/log_with_tx_data.js

@@ -1,28 +1,41 @@
-import { MAX_NOTE_HASHES_PER_TX, PUBLIC_LOG_DATA_SIZE_IN_FIELDS } from '@aztec/constants';
-import { Fr } from '@aztec/foundation/fields';
-// TypeScript representation of the Noir aztec::oracle::note_discovery::LogWithTxData struct. This is used as a response
-// for PXE's custom getLogByTag oracle.
-export class LogWithTxData {
-    logContent;
+import { MAX_NOTE_HASHES_PER_TX, PRIVATE_LOG_CIPHERTEXT_LEN } from '@aztec/constants';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { TxHash } from '@aztec/stdlib/tx';
+// This is used as a response for PXE's custom getPublicLogByTag oracle.
+export class PublicLogWithTxData {
+    logPayload;
     txHash;
     uniqueNoteHashesInTx;
     firstNullifierInTx;
-    constructor(logContent, txHash, uniqueNoteHashesInTx, firstNullifierInTx){
-        this.logContent = logContent;
+    constructor(logPayload, txHash, uniqueNoteHashesInTx, firstNullifierInTx){
+        this.logPayload = logPayload;
+        this.txHash = txHash;
+        this.uniqueNoteHashesInTx = uniqueNoteHashesInTx;
+        this.firstNullifierInTx = firstNullifierInTx;
+    }
+}
+// This is used as a response for PXE's custom getPrivateLogByTag oracle.
+export class PrivateLogWithTxData {
+    logPayload;
+    txHash;
+    uniqueNoteHashesInTx;
+    firstNullifierInTx;
+    constructor(logPayload, txHash, uniqueNoteHashesInTx, firstNullifierInTx){
+        this.logPayload = logPayload;
         this.txHash = txHash;
         this.uniqueNoteHashesInTx = uniqueNoteHashesInTx;
         this.firstNullifierInTx = firstNullifierInTx;
     }
     toNoirSerialization() {
         return [
-            ...toBoundedVecSerialization(this.logContent, PUBLIC_LOG_DATA_SIZE_IN_FIELDS),
-            this.txHash,
+            ...toBoundedVecSerialization(this.logPayload, PRIVATE_LOG_CIPHERTEXT_LEN),
+            this.txHash.hash,
             ...toBoundedVecSerialization(this.uniqueNoteHashesInTx, MAX_NOTE_HASHES_PER_TX),
             this.firstNullifierInTx
         ];
     }
     static noirSerializationOfEmpty() {
-        return new LogWithTxData([], new Fr(0), [], new Fr(0)).toNoirSerialization();
+        return new PrivateLogWithTxData([], TxHash.zero(), [], new Fr(0)).toNoirSerialization();
     }
 }
 function toBoundedVecSerialization(array, maxLength) {

package/dest/logs/message_context.d.ts

@@ -0,0 +1,29 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { AztecAddress } from '../aztec-address/index.js';
+import type { TxEffect } from '../tx/tx_effect.js';
+import type { TxHash } from '../tx/tx_hash.js';
+/**
+ * Additional information needed to process a message.
+ *
+ * All messages exist in the context of a transaction, and information about that transaction is typically required
+ * in order to perform validation, store results, etc. For example, messages containing notes require knowledge of note
+ * hashes and the first nullifier in order to find the note's nonce.
+ *
+ * A TS version of `message_context.nr`.
+ */
+export declare class MessageContext {
+    txHash: TxHash;
+    uniqueNoteHashesInTx: Fr[];
+    firstNullifierInTx: Fr;
+    recipient: AztecAddress;
+    constructor(txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr, recipient: AztecAddress);
+    toFields(): Fr[];
+    toNoirStruct(): {
+        tx_hash: Fr;
+        unique_note_hashes_in_tx: Fr[];
+        first_nullifier_in_tx: Fr;
+        recipient: AztecAddress;
+    };
+    static fromTxEffectAndRecipient(txEffect: TxEffect, recipient: AztecAddress): MessageContext;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZV9jb250ZXh0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9tZXNzYWdlX2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ25ELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRS9DOzs7Ozs7OztHQVFHO0FBQ0gscUJBQWEsY0FBYztJQUVoQixNQUFNLEVBQUUsTUFBTTtJQUNkLG9CQUFvQixFQUFFLEVBQUUsRUFBRTtJQUMxQixrQkFBa0IsRUFBRSxFQUFFO0lBQ3RCLFNBQVMsRUFBRSxZQUFZO0lBSmhDLFlBQ1MsTUFBTSxFQUFFLE1BQU0sRUFDZCxvQkFBb0IsRUFBRSxFQUFFLEVBQUUsRUFDMUIsa0JBQWtCLEVBQUUsRUFBRSxFQUN0QixTQUFTLEVBQUUsWUFBWSxFQUM1QjtJQUVKLFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FPZjtJQUVELFlBQVk7Ozs7O01BU1g7SUFFRCxNQUFNLENBQUMsd0JBQXdCLENBQUMsUUFBUSxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsWUFBWSxHQUFHLGNBQWMsQ0FFM0Y7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"message_context.d.ts","sourceRoot":"","sources":["../../src/logs/message_context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAEhB,MAAM,EAAE,MAAM;IACd,oBAAoB,EAAE,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IACtB,SAAS,EAAE,YAAY;IAJhC,YACS,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE,EACtB,SAAS,EAAE,YAAY,EAC5B;IAEJ,QAAQ,IAAI,EAAE,EAAE,CAOf;IAED,YAAY;;;;;MASX;IAED,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,GAAG,cAAc,CAE3F;CACF"}

package/dest/logs/message_context.js

@@ -0,0 +1,56 @@
+import { MAX_NOTE_HASHES_PER_TX } from '@aztec/constants';
+import { Fr } from '@aztec/foundation/curves/bn254';
+/**
+ * Additional information needed to process a message.
+ *
+ * All messages exist in the context of a transaction, and information about that transaction is typically required
+ * in order to perform validation, store results, etc. For example, messages containing notes require knowledge of note
+ * hashes and the first nullifier in order to find the note's nonce.
+ *
+ * A TS version of `message_context.nr`.
+ */ export class MessageContext {
+    txHash;
+    uniqueNoteHashesInTx;
+    firstNullifierInTx;
+    recipient;
+    constructor(txHash, uniqueNoteHashesInTx, firstNullifierInTx, recipient){
+        this.txHash = txHash;
+        this.uniqueNoteHashesInTx = uniqueNoteHashesInTx;
+        this.firstNullifierInTx = firstNullifierInTx;
+        this.recipient = recipient;
+    }
+    toFields() {
+        return [
+            this.txHash.hash,
+            ...serializeBoundedVec(this.uniqueNoteHashesInTx, MAX_NOTE_HASHES_PER_TX),
+            this.firstNullifierInTx,
+            this.recipient.toField()
+        ];
+    }
+    toNoirStruct() {
+        /* eslint-disable camelcase */ return {
+            tx_hash: this.txHash.hash,
+            unique_note_hashes_in_tx: this.uniqueNoteHashesInTx,
+            first_nullifier_in_tx: this.firstNullifierInTx,
+            recipient: this.recipient
+        };
+    /* eslint-enable camelcase */ }
+    static fromTxEffectAndRecipient(txEffect, recipient) {
+        return new MessageContext(txEffect.txHash, txEffect.noteHashes, txEffect.nullifiers[0], recipient);
+    }
+}
+/**
+ * Helper function to serialize a bounded vector according to Noir's BoundedVec format
+ * @param values - The values to serialize
+ * @param maxLength - The maximum length of the bounded vector
+ * @returns The serialized bounded vector as Fr[]
+ * @dev Copied over from pending_tagged_log.ts.
+ */ function serializeBoundedVec(values, maxLength) {
+    const lengthDiff = maxLength - values.length;
+    const zeroPaddingArray = Array(lengthDiff).fill(Fr.ZERO);
+    const storage = values.concat(zeroPaddingArray);
+    return [
+        ...storage,
+        new Fr(values.length)
+    ];
+}

package/dest/logs/pending_tagged_log.d.ts

@@ -0,0 +1,14 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { AztecAddress } from '../aztec-address/index.js';
+import type { TxHash } from '../tx/tx_hash.js';
+/**
+ * Represents a pending tagged log as it is stored in the pending tagged log array to which the fetchTaggedLogs oracle
+ * inserts found private logs. A TS version of `pending_tagged_log.nr`.
+ */
+export declare class PendingTaggedLog {
+    log: Fr[];
+    private context;
+    constructor(log: Fr[], txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr, recipient: AztecAddress);
+    toFields(): Fr[];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVuZGluZ190YWdnZWRfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9wZW5kaW5nX3RhZ2dlZF9sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRy9DOzs7R0FHRztBQUNILHFCQUFhLGdCQUFnQjtJQUlsQixHQUFHLEVBQUUsRUFBRSxFQUFFO0lBSGxCLE9BQU8sQ0FBQyxPQUFPLENBQWlCO0lBRWhDLFlBQ1MsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUNoQixNQUFNLEVBQUUsTUFBTSxFQUNkLG9CQUFvQixFQUFFLEVBQUUsRUFBRSxFQUMxQixrQkFBa0IsRUFBRSxFQUFFLEVBQ3RCLFNBQVMsRUFBRSxZQUFZLEVBR3hCO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"pending_tagged_log.d.ts","sourceRoot":"","sources":["../../src/logs/pending_tagged_log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;GAGG;AACH,qBAAa,gBAAgB;IAIlB,GAAG,EAAE,EAAE,EAAE;IAHlB,OAAO,CAAC,OAAO,CAAiB;IAEhC,YACS,GAAG,EAAE,EAAE,EAAE,EAChB,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE,EACtB,SAAS,EAAE,YAAY,EAGxB;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;CACF"}

package/dest/logs/pending_tagged_log.js

@@ -0,0 +1,34 @@
+import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { MessageContext } from './message_context.js';
+/**
+ * Represents a pending tagged log as it is stored in the pending tagged log array to which the fetchTaggedLogs oracle
+ * inserts found private logs. A TS version of `pending_tagged_log.nr`.
+ */ export class PendingTaggedLog {
+    log;
+    context;
+    constructor(log, txHash, uniqueNoteHashesInTx, firstNullifierInTx, recipient){
+        this.log = log;
+        this.context = new MessageContext(txHash, uniqueNoteHashesInTx, firstNullifierInTx, recipient);
+    }
+    toFields() {
+        return [
+            ...serializeBoundedVec(this.log, PRIVATE_LOG_SIZE_IN_FIELDS),
+            ...this.context.toFields()
+        ];
+    }
+}
+/**
+ * Helper function to serialize a bounded vector according to Noir's BoundedVec format
+ * @param values - The values to serialize
+ * @param maxLength - The maximum length of the bounded vector
+ * @returns The serialized bounded vector as Fr[]
+ */ function serializeBoundedVec(values, maxLength) {
+    const lengthDiff = maxLength - values.length;
+    const zeroPaddingArray = Array(lengthDiff).fill(Fr.ZERO);
+    const storage = values.concat(zeroPaddingArray);
+    return [
+        ...storage,
+        new Fr(values.length)
+    ];
+}

package/dest/logs/pre_tag.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { type DirectionalAppTaggingSecret } from './directional_app_tagging_secret.js';
+/**
+ * Represents a preimage of a private log tag (see `Tag` in `pxe/src/tagging`).
+ *
+ * Note: It's a bit unfortunate that this type resides in `stdlib` as the rest of the tagging functionality resides
+ * in `pxe/src/tagging`. But this type is used by other types in stdlib hence there doesn't seem to be a good way
+ * around this.
+ */
+export type PreTag = {
+    secret: DirectionalAppTaggingSecret;
+    index: number;
+};
+export declare const PreTagSchema: z.ZodObject<{
+    secret: z.ZodObject<{
+        value: z.ZodType<import("@aztec/foundation/schemas").Fr, any, string>;
+    }, "strip", z.ZodTypeAny, {
+        value: import("@aztec/foundation/schemas").Fr;
+    }, {
+        value: string;
+    }>;
+    index: z.ZodPipeline<z.ZodUnion<[z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    secret: {
+        value: import("@aztec/foundation/schemas").Fr;
+    };
+    index: number;
+}, {
+    secret: {
+        value: string;
+    };
+    index: string | number | bigint;
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlX3RhZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvcHJlX3RhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFDTCxLQUFLLDJCQUEyQixFQUVqQyxNQUFNLHFDQUFxQyxDQUFDO0FBRTdDOzs7Ozs7R0FNRztBQUNILE1BQU0sTUFBTSxNQUFNLEdBQUc7SUFDbkIsTUFBTSxFQUFFLDJCQUEyQixDQUFDO0lBQ3BDLEtBQUssRUFBRSxNQUFNLENBQUM7Q0FDZixDQUFDO0FBRUYsZUFBTyxNQUFNLFlBQVk7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFHdkIsQ0FBQyJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"pre_tag.d.ts","sourceRoot":"","sources":["../../src/logs/pre_tag.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,qCAAqC,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;EAGvB,CAAC"}

package/dest/logs/pre_tag.js

@@ -0,0 +1,7 @@
+import { schemas } from '@aztec/foundation/schemas';
+import { z } from 'zod';
+import { DirectionalAppTaggingSecretSchema } from './directional_app_tagging_secret.js';
+export const PreTagSchema = z.object({
+    secret: DirectionalAppTaggingSecretSchema,
+    index: schemas.Integer
+});

package/dest/logs/private_log.d.ts

@@ -1,33 +1,49 @@
-/// <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 { type FieldsOf } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/curves/bn254';
 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>;
+    emittedLength: number;
     static SIZE_IN_BYTES: number;
-    constructor(fields: Tuple<Fr, typeof PRIVATE_LOG_SIZE_IN_FIELDS>);
+    constructor(fields: Tuple<Fr, typeof PRIVATE_LOG_SIZE_IN_FIELDS>, emittedLength: number);
+    static from(fields: FieldsOf<PrivateLog>): PrivateLog;
+    static getFields(fields: FieldsOf<PrivateLog>): readonly [[Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr, Fr], number];
     toFields(): Fr[];
     static fromFields(fields: Fr[] | FieldReader): PrivateLog;
+    getEmittedFields(): Fr[];
+    getEmittedFieldsWithoutTag(): Fr[];
+    toBlobFields(): Fr[];
+    static fromBlobFields(emittedLength: number, fields: Fr[] | FieldReader): PrivateLog;
     isEmpty(): boolean;
     static empty(): PrivateLog;
     toBuffer(): Buffer;
     static fromBuffer(buffer: Buffer | BufferReader): PrivateLog;
-    static random(): PrivateLog;
-    getEmittedLength(): number;
-    getEmittedFields(): Fr[];
+    static random(tag?: Fr): PrivateLog;
     static get schema(): z.ZodEffects<z.ZodObject<{
         fields: z.ZodArray<z.ZodType<Fr, any, string>, "many">;
-    }, "strip", z.ZodTypeAny, {
+        emittedLength: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
         fields: Fr[];
+        emittedLength: number;
     }, {
         fields: string[];
+        emittedLength: number;
     }>, PrivateLog, {
         fields: string[];
+        emittedLength: number;
     }>;
+    /**
+     * Creates a PrivateLog from a plain object without Zod validation.
+     * This method is optimized for performance and skips validation, making it suitable
+     * for deserializing trusted data (e.g., from C++ via MessagePack).
+     * @param obj - Plain object containing PrivateLog fields
+     * @returns A PrivateLog instance
+     */
+    static fromPlainObject(obj: any): PrivateLog;
+    equals(other: PrivateLog): boolean;
     [inspect.custom](): string;
 }
-//# sourceMappingURL=private_log.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJpdmF0ZV9sb2cuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2dzL3ByaXZhdGVfbG9nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBc0IsMEJBQTBCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNsRixPQUFPLEVBQUUsS0FBSyxRQUFRLEVBQWEsTUFBTSx5QkFBeUIsQ0FBQztBQUVuRSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFcEQsT0FBTyxFQUNMLFlBQVksRUFDWixXQUFXLEVBQ1gsS0FBSyxLQUFLLEVBR1gsTUFBTSw2QkFBNkIsQ0FBQztBQUVyQyxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBQy9CLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIscUJBQWEsVUFBVTtJQUlaLE1BQU0sRUFBRSxLQUFLLENBQUMsRUFBRSxFQUFFLE9BQU8sMEJBQTBCLENBQUM7SUFFcEQsYUFBYSxFQUFFLE1BQU07SUFMOUIsTUFBTSxDQUFDLGFBQWEsU0FBeUM7SUFFN0QsWUFDUyxNQUFNLEVBQUUsS0FBSyxDQUFDLEVBQUUsRUFBRSxPQUFPLDBCQUEwQixDQUFDLEVBRXBELGFBQWEsRUFBRSxNQUFNLEVBQzFCO0lBRUosTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsUUFBUSxDQUFDLFVBQVUsQ0FBQyxjQUV2QztJQUVELE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsQ0FBQyxVQUFVLENBQUMsK0ZBRTVDO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxjQUczQztJQUVELGdCQUFnQixTQUVmO0lBRUQsMEJBQTBCLFNBRXpCO0lBRUQsWUFBWSxJQUFJLEVBQUUsRUFBRSxDQUVuQjtJQUVELE1BQU0sQ0FBQyxjQUFjLENBQUMsYUFBYSxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxjQUl0RTtJQUVELE9BQU8sWUFHTjtJQUVELE1BQU0sQ0FBQyxLQUFLLGVBRVg7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLGNBRzlDO0lBRUQsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEtBQWMsY0FJOUI7SUFFRCxNQUFNLEtBQUssTUFBTTs7Ozs7Ozs7Ozs7O09BUWhCO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsTUFBTSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLFVBQVUsQ0FRM0M7SUFFRCxNQUFNLENBQUMsS0FBSyxFQUFFLFVBQVUsV0FFdkI7SUFFRCxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsSUFBSSxNQUFNLENBS3pCO0NBQ0YifQ==

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

@@ -1 +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,gBAAgB;IAMhB,gBAAgB;IAKhB,MAAM,KAAK,MAAM;;;;;;;;OAMhB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAK3B"}
+{"version":3,"file":"private_log.d.ts","sourceRoot":"","sources":["../../src/logs/private_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,yBAAyB,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,KAAK,EAGX,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,UAAU;IAIZ,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,0BAA0B,CAAC;IAEpD,aAAa,EAAE,MAAM;IAL9B,MAAM,CAAC,aAAa,SAAyC;IAE7D,YACS,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,0BAA0B,CAAC,EAEpD,aAAa,EAAE,MAAM,EAC1B;IAEJ,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,cAEvC;IAED,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,+FAE5C;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,cAG3C;IAED,gBAAgB,SAEf;IAED,0BAA0B,SAEzB;IAED,YAAY,IAAI,EAAE,EAAE,CAEnB;IAED,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,cAItE;IAED,OAAO,YAGN;IAED,MAAM,CAAC,KAAK,eAEX;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,cAG9C;IAED,MAAM,CAAC,MAAM,CAAC,GAAG,KAAc,cAI9B;IAED,MAAM,KAAK,MAAM;;;;;;;;;;;;OAQhB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAQ3C;IAED,MAAM,CAAC,KAAK,EAAE,UAAU,WAEvB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAKzB;CACF"}

package/dest/logs/private_log.js

@@ -1,56 +1,94 @@
-import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+import { PRIVATE_LOG_LENGTH, PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
 import { makeTuple } from '@aztec/foundation/array';
-import { Fr } from '@aztec/foundation/fields';
+import { padArrayEnd } from '@aztec/foundation/collection';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { schemas } from '@aztec/foundation/schemas';
-import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } 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){
+    emittedLength;
+    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * PRIVATE_LOG_LENGTH;
+    constructor(fields, // Named `emittedLength` instead of `length` to avoid being confused with fields.length.
+    emittedLength){
         this.fields = fields;
+        this.emittedLength = emittedLength;
+    }
+    static from(fields) {
+        return new PrivateLog(...PrivateLog.getFields(fields));
+    }
+    static getFields(fields) {
+        return [
+            fields.fields,
+            fields.emittedLength
+        ];
     }
     toFields() {
-        return this.fields;
+        return serializeToFields(...PrivateLog.getFields(this));
     }
     static fromFields(fields) {
         const reader = FieldReader.asReader(fields);
-        return new PrivateLog(reader.readFieldArray(PRIVATE_LOG_SIZE_IN_FIELDS));
+        return new PrivateLog(reader.readFieldArray(PRIVATE_LOG_SIZE_IN_FIELDS), reader.readU32());
+    }
+    getEmittedFields() {
+        return this.fields.slice(0, this.emittedLength);
+    }
+    getEmittedFieldsWithoutTag() {
+        return this.fields.slice(1, this.emittedLength);
+    }
+    toBlobFields() {
+        return this.getEmittedFields();
+    }
+    static fromBlobFields(emittedLength, fields) {
+        const reader = FieldReader.asReader(fields);
+        const emittedFields = reader.readFieldArray(emittedLength);
+        return new PrivateLog(padArrayEnd(emittedFields, Fr.ZERO, PRIVATE_LOG_SIZE_IN_FIELDS), emittedLength);
     }
     isEmpty() {
-        return this.fields.every((f)=>f.isZero());
+        // Faster to check emittedLength than compare all fields against zero
+        return this.emittedLength === 0;
     }
     static empty() {
-        return new PrivateLog(makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.zero));
+        return new PrivateLog(makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.zero), 0);
     }
     toBuffer() {
-        return serializeToBuffer(this.fields);
+        return serializeToBuffer(this.fields, this.emittedLength);
     }
     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));
-    }
-    getEmittedLength() {
-        // This assumes that we cut trailing zeroes from the end of the log. In ts, these will always be added back.
-        // Does not include length prefix.
-        return this.getEmittedFields().length;
+        return new PrivateLog(reader.readArray(PRIVATE_LOG_SIZE_IN_FIELDS, Fr), reader.readNumber());
     }
-    getEmittedFields() {
-        const lastNonZeroIndex = this.fields.findLastIndex((f)=>!f.isZero());
-        return this.fields.slice(0, lastNonZeroIndex + 1);
+    static random(tag = Fr.random()) {
+        const fields = makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.random);
+        fields[0] = tag;
+        return new PrivateLog(fields, PRIVATE_LOG_SIZE_IN_FIELDS);
     }
     static get schema() {
         return z.object({
-            fields: z.array(schemas.Fr)
-        }).transform(({ fields })=>PrivateLog.fromFields(fields));
+            fields: z.array(schemas.Fr),
+            emittedLength: z.number()
+        }).strict().transform(({ fields, emittedLength })=>PrivateLog.fromFields(fields.concat(new Fr(emittedLength))));
+    }
+    /**
+   * Creates a PrivateLog from a plain object without Zod validation.
+   * This method is optimized for performance and skips validation, making it suitable
+   * for deserializing trusted data (e.g., from C++ via MessagePack).
+   * @param obj - Plain object containing PrivateLog fields
+   * @returns A PrivateLog instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof PrivateLog) {
+            return obj;
+        }
+        return new PrivateLog(obj.fields.map((f)=>Fr.fromPlainObject(f)), obj.emittedLength);
+    }
+    equals(other) {
+        return this.fields.every((field, i)=>field.equals(other.fields[i])) && this.emittedLength === other.emittedLength;
     }
     [inspect.custom]() {
         return `PrivateLog {
       fields: [${this.fields.map((x)=>inspect(x)).join(', ')}],
+      emittedLength: ${this.emittedLength},
     }`;
     }
 }