@aztec/stdlib 0.0.1-fake-ceab37513c → 0.0.1-private.5d121bfd

package/dest/logs/contract_class_log.js

@@ -1,8 +1,9 @@
+var _computedKey;
 import { CONTRACT_CLASS_LOG_LENGTH, CONTRACT_CLASS_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
-import { poseidon2Hash } from '@aztec/foundation/crypto';
-import { Fr } from '@aztec/foundation/fields';
+import { poseidon2Hash } from '@aztec/foundation/crypto/poseidon';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { schemas } from '@aztec/foundation/schemas';
-import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
+import { BufferReader, BufferSink, FieldReader, serializeToFields, serializeToSink } from '@aztec/foundation/serialize';
 import { inspect } from 'util';
 import { z } from 'zod';
 import { AztecAddress } from '../aztec-address/index.js';
@@ -21,6 +22,18 @@ export class ContractClassLogFields {
             fields: z.array(schemas.Fr).refine((arr)=>arr.length === CONTRACT_CLASS_LOG_SIZE_IN_FIELDS)
         }).transform(({ fields })=>new ContractClassLogFields(fields));
     }
+    /**
+   * Creates a ContractClassLogFields 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 ContractClassLogFields fields
+   * @returns A ContractClassLogFields instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof ContractClassLogFields) {
+            return obj;
+        }
+        return new ContractClassLogFields(obj.fields.map((f)=>Fr.fromPlainObject(f)));
+    }
     toFields() {
         return this.fields;
     }
@@ -32,8 +45,11 @@ export class ContractClassLogFields {
             length: CONTRACT_CLASS_LOG_SIZE_IN_FIELDS
         }, ()=>reader.readField()));
     }
-    toBuffer() {
-        return serializeToBuffer(this.fields);
+    toBuffer(sink) {
+        if (!sink) {
+            return BufferSink.serialize(this);
+        }
+        serializeToSink(sink, this.fields);
     }
     static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
@@ -70,6 +86,7 @@ export class ContractClassLogFields {
         return ContractClassLogFields.fromBuffer(this.toBuffer());
     }
 }
+_computedKey = inspect.custom;
 export class ContractClassLog {
     contractAddress;
     fields;
@@ -102,13 +119,11 @@ export class ContractClassLog {
     }
     toBlobFields() {
         return [
-            new Fr(this.emittedLength),
             this.contractAddress.toField()
         ].concat(this.getEmittedFields());
     }
-    static fromBlobFields(fields) {
+    static fromBlobFields(emittedLength, fields) {
         const reader = FieldReader.asReader(fields);
-        const emittedLength = reader.readU32();
         const contractAddress = reader.readObject(AztecAddress);
         const emittedFields = reader.readFieldArray(emittedLength);
         return new ContractClassLog(contractAddress, ContractClassLogFields.fromEmittedFields(emittedFields), emittedLength);
@@ -119,12 +134,11 @@ export class ContractClassLog {
     static empty() {
         return new ContractClassLog(AztecAddress.ZERO, ContractClassLogFields.empty(), 0);
     }
-    toBuffer() {
-        return serializeToBuffer([
-            this.contractAddress,
-            this.fields,
-            this.emittedLength
-        ]);
+    toBuffer(sink) {
+        if (!sink) {
+            return BufferSink.serialize(this);
+        }
+        serializeToSink(sink, this.contractAddress, this.fields, this.emittedLength);
     }
     static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
@@ -148,7 +162,19 @@ export class ContractClassLog {
             emittedLength: z.number()
         }).transform(ContractClassLog.from);
     }
-    [inspect.custom]() {
+    /**
+   * Creates a ContractClassLog 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 ContractClassLog fields
+   * @returns A ContractClassLog instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof ContractClassLog) {
+            return obj;
+        }
+        return new ContractClassLog(AztecAddress.fromPlainObject(obj.contractAddress), ContractClassLogFields.fromPlainObject(obj.fields), obj.emittedLength);
+    }
+    [_computedKey]() {
         return `ContractClassLog {
       contractAddress: ${this.contractAddress.toString()},
       emittedLength: ${this.emittedLength},

package/dest/logs/debug_log.d.ts

@@ -0,0 +1,21 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { type LogLevel } from '@aztec/foundation/log';
+import { type ZodFor } from '@aztec/foundation/schemas';
+import { AztecAddress } from '../aztec-address/index.js';
+export declare class DebugLog {
+    contractAddress: AztecAddress;
+    level: LogLevel;
+    message: string;
+    fields: Fr[];
+    constructor(contractAddress: AztecAddress, level: LogLevel, message: string, fields: Fr[]);
+    static get schema(): ZodFor<DebugLog>;
+    /**
+     * Creates a DebugLog 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 DebugLog fields
+     * @returns A DebugLog instance
+     */
+    static fromPlainObject(obj: any): DebugLog;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWdfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9kZWJ1Z19sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxLQUFLLFFBQVEsRUFBYSxNQUFNLHVCQUF1QixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBVyxNQUFNLDJCQUEyQixDQUFDO0FBSWpFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUt6RCxxQkFBYSxRQUFRO0lBRVYsZUFBZSxFQUFFLFlBQVk7SUFDN0IsS0FBSyxFQUFFLFFBQVE7SUFDZixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxFQUFFLEVBQUU7SUFKckIsWUFDUyxlQUFlLEVBQUUsWUFBWSxFQUM3QixLQUFLLEVBQUUsUUFBUSxFQUNmLE9BQU8sRUFBRSxNQUFNLEVBQ2YsTUFBTSxFQUFFLEVBQUUsRUFBRSxFQUNqQjtJQUVKLE1BQU0sS0FBSyxNQUFNLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQVdwQztJQUVEOzs7Ozs7T0FNRztJQUNILE1BQU0sQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLEdBQUcsR0FBRyxRQUFRLENBVXpDO0NBQ0YifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug_log.d.ts","sourceRoot":"","sources":["../../src/logs/debug_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,QAAQ,EAAa,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,2BAA2B,CAAC;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,qBAAa,QAAQ;IAEV,eAAe,EAAE,YAAY;IAC7B,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,EAAE,EAAE;IAJrB,YACS,eAAe,EAAE,YAAY,EAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,EAAE,EAAE,EACjB;IAEJ,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAWpC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAUzC;CACF"}

package/dest/logs/debug_log.js

@@ -0,0 +1,39 @@
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { LogLevels } from '@aztec/foundation/log';
+import { schemas } from '@aztec/foundation/schemas';
+import { z } from 'zod';
+import { AztecAddress } from '../aztec-address/index.js';
+/*
+ * Represents a debug log emitted by public bytecode.
+ */ export class DebugLog {
+    contractAddress;
+    level;
+    message;
+    fields;
+    constructor(contractAddress, level, message, fields){
+        this.contractAddress = contractAddress;
+        this.level = level;
+        this.message = message;
+        this.fields = fields;
+    }
+    static get schema() {
+        return z.object({
+            contractAddress: AztecAddress.schema,
+            level: z.enum(LogLevels),
+            message: z.string(),
+            fields: z.array(schemas.Fr)
+        }).transform(({ contractAddress, level, message, fields })=>new DebugLog(contractAddress, level, message, fields));
+    }
+    /**
+   * Creates a DebugLog 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 DebugLog fields
+   * @returns A DebugLog instance
+   */ static fromPlainObject(obj) {
+        if (obj instanceof DebugLog) {
+            return obj;
+        }
+        return new DebugLog(AztecAddress.fromPlainObject(obj.contractAddress), obj.level, obj.message, obj.fields.map((f)=>Fr.fromPlainObject(f)));
+    }
+}

package/dest/logs/debug_log_store.d.ts

@@ -0,0 +1,30 @@
+import type { TxReceipt } from '../tx/tx_receipt.js';
+import type { DebugLog } from './debug_log.js';
+/**
+ * Store for debug logs emitted by public functions during transaction execution.
+ *
+ * Uses the Null Object pattern: production code uses NullDebugLogStore (no-op), while test mode uses
+ * InMemoryDebugLogStore (stores and serves logs).
+ */
+export interface DebugLogStore {
+    /** Store debug logs for a processed transaction. */
+    storeLogs(txHash: string, logs: DebugLog[]): void;
+    /** Decorate a TxReceipt with any stored debug logs for the given tx. */
+    decorateReceiptWithLogs(txHash: string, receipt: TxReceipt): void;
+    /** Whether debug log collection is enabled. */
+    readonly isEnabled: boolean;
+}
+/** No-op implementation for production mode. */
+export declare class NullDebugLogStore implements DebugLogStore {
+    storeLogs(_txHash: string, _logs: DebugLog[]): void;
+    decorateReceiptWithLogs(_txHash: string, _receipt: TxReceipt): void;
+    get isEnabled(): boolean;
+}
+/** In-memory implementation for test mode that stores and serves debug logs. */
+export declare class InMemoryDebugLogStore implements DebugLogStore {
+    private map;
+    storeLogs(txHash: string, logs: DebugLog[]): void;
+    decorateReceiptWithLogs(txHash: string, receipt: TxReceipt): void;
+    get isEnabled(): boolean;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWdfbG9nX3N0b3JlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9kZWJ1Z19sb2dfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFL0M7Ozs7O0dBS0c7QUFDSCxNQUFNLFdBQVcsYUFBYTtJQUM1QixvREFBb0Q7SUFDcEQsU0FBUyxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxHQUFHLElBQUksQ0FBQztJQUNsRCx3RUFBd0U7SUFDeEUsdUJBQXVCLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsU0FBUyxHQUFHLElBQUksQ0FBQztJQUNsRSwrQ0FBK0M7SUFDL0MsUUFBUSxDQUFDLFNBQVMsRUFBRSxPQUFPLENBQUM7Q0FDN0I7QUFFRCxnREFBZ0Q7QUFDaEQscUJBQWEsaUJBQWtCLFlBQVcsYUFBYTtJQUNyRCxTQUFTLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFLEdBQUcsSUFBSSxDQUVsRDtJQUNELHVCQUF1QixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLFNBQVMsR0FBRyxJQUFJLENBRWxFO0lBQ0QsSUFBSSxTQUFTLElBQUksT0FBTyxDQUV2QjtDQUNGO0FBRUQsZ0ZBQWdGO0FBQ2hGLHFCQUFhLHFCQUFzQixZQUFXLGFBQWE7SUFDekQsT0FBTyxDQUFDLEdBQUcsQ0FBaUM7SUFFNUMsU0FBUyxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxHQUFHLElBQUksQ0FJaEQ7SUFFRCx1QkFBdUIsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxTQUFTLEdBQUcsSUFBSSxDQU9oRTtJQUVELElBQUksU0FBUyxJQUFJLE9BQU8sQ0FFdkI7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug_log_store.d.ts","sourceRoot":"","sources":["../../src/logs/debug_log_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAClD,wEAAwE;IACxE,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAClE,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,gDAAgD;AAChD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAElD;IACD,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,CAElE;IACD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED,gFAAgF;AAChF,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,GAAG,CAAiC;IAE5C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAIhD;IAED,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAOhE;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dest/logs/debug_log_store.js

@@ -0,0 +1,30 @@
+/** No-op implementation for production mode. */ export class NullDebugLogStore {
+    storeLogs(_txHash, _logs) {
+        return;
+    }
+    decorateReceiptWithLogs(_txHash, _receipt) {
+        return;
+    }
+    get isEnabled() {
+        return false;
+    }
+}
+/** In-memory implementation for test mode that stores and serves debug logs. */ export class InMemoryDebugLogStore {
+    map = new Map();
+    storeLogs(txHash, logs) {
+        if (logs.length > 0) {
+            this.map.set(txHash, logs);
+        }
+    }
+    decorateReceiptWithLogs(txHash, receipt) {
+        if (receipt.isMined()) {
+            const debugLogs = this.map.get(txHash);
+            if (debugLogs) {
+                receipt.debugLogs = debugLogs;
+            }
+        }
+    }
+    get isEnabled() {
+        return true;
+    }
+}

package/dest/logs/index.d.ts

@@ -1,14 +1,19 @@
-export * from './log_with_tx_data.js';
-export * from './indexed_tagging_secret.js';
+export * from './app_tagging_secret_kind.js';
+export * from './app_tagging_secret.js';
+export * from './pre_tag.js';
+export * from './tagging_index_range.js';
 export * from './contract_class_log.js';
 export * from './public_log.js';
 export * from './private_log.js';
 export * from './pending_tagged_log.js';
-export * from './log_id.js';
-export * from './log_filter.js';
-export * from './extended_public_log.js';
-export * from './extended_contract_class_log.js';
+export * from './log_result.js';
+export * from './log_cursor.js';
+export * from './logs_query.js';
+export * from './query_all_logs_by_tags.js';
 export * from './shared_secret_derivation.js';
-export * from './tx_scoped_l2_log.js';
 export * from './message_context.js';
-//# sourceMappingURL=index.d.ts.map
+export * from './debug_log.js';
+export * from './debug_log_store.js';
+export * from './tag.js';
+export * from './siloed_tag.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsVUFBVSxDQUFDO0FBQ3pCLGNBQWMsaUJBQWlCLENBQUMifQ==

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logs/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logs/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}

package/dest/logs/index.js

@@ -1,13 +1,18 @@
-export * from './log_with_tx_data.js';
-export * from './indexed_tagging_secret.js';
+export * from './app_tagging_secret_kind.js';
+export * from './app_tagging_secret.js';
+export * from './pre_tag.js';
+export * from './tagging_index_range.js';
 export * from './contract_class_log.js';
 export * from './public_log.js';
 export * from './private_log.js';
 export * from './pending_tagged_log.js';
-export * from './log_id.js';
-export * from './log_filter.js';
-export * from './extended_public_log.js';
-export * from './extended_contract_class_log.js';
+export * from './log_result.js';
+export * from './log_cursor.js';
+export * from './logs_query.js';
+export * from './query_all_logs_by_tags.js';
 export * from './shared_secret_derivation.js';
-export * from './tx_scoped_l2_log.js';
 export * from './message_context.js';
+export * from './debug_log.js';
+export * from './debug_log_store.js';
+export * from './tag.js';
+export * from './siloed_tag.js';

package/dest/logs/log_cursor.d.ts

@@ -0,0 +1,51 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { z } from 'zod';
+import type { LogResultBase } from './log_result.js';
+/**
+ * Cursor identifying a position in a tag's ordered log stream. Used as `afterLog` on `TagQuery` to resume
+ * pagination strictly after a previously-seen log.
+ *
+ * `(blockNumber, txIndexWithinBlock, logIndexWithinTx)` is sufficient to uniquely identify a position
+ * and matches the composite-key ordering of the archiver's log index, so the cursor maps directly to a
+ * key without a tx-hash lookup. All three fields are always present on {@link LogResult}, so a cursor is
+ * constructible from any returned log.
+ */
+export declare class LogCursor {
+    /** The block the cursor points to. */
+    readonly blockNumber: BlockNumber;
+    /** The tx index within the block the cursor points to. */
+    readonly txIndexWithinBlock: number;
+    /** The log index within the tx the cursor points to. */
+    readonly logIndexWithinTx: number;
+    constructor(
+    /** The block the cursor points to. */
+    blockNumber: BlockNumber, 
+    /** The tx index within the block the cursor points to. */
+    txIndexWithinBlock: number, 
+    /** The log index within the tx the cursor points to. */
+    logIndexWithinTx: number);
+    static get schema(): z.ZodPipe<z.ZodObject<{
+        blockNumber: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodBigInt, z.ZodTransform<number, bigint>>, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodTransform<BlockNumber, number>>;
+        txIndexWithinBlock: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>;
+        logIndexWithinTx: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>;
+    }, z.core.$strip>, z.ZodTransform<LogCursor, {
+        blockNumber: BlockNumber;
+        txIndexWithinBlock: number;
+        logIndexWithinTx: number;
+    }>>;
+    /** Builds a cursor that points at the given log. Pagination resumes strictly after this position. */
+    static fromLog(log: Pick<LogResultBase, 'blockNumber' | 'txIndexWithinBlock' | 'logIndexWithinTx'>): LogCursor;
+    static random(): LogCursor;
+    toBuffer(): Buffer;
+    static fromBuffer(buffer: Buffer | BufferReader): LogCursor;
+    equals(other: LogCursor): boolean;
+    toString(): string;
+    /**
+     * Parses a `<blockNumber>-<txIndexWithinBlock>-<logIndexWithinTx>` triple into a {@link LogCursor}.
+     * Throws on malformed input. Returns `undefined` for an empty / missing value so callers can use
+     * this directly as an optional CLI option parser.
+     */
+    static parseOptional(value: string): LogCursor | undefined;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX2N1cnNvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvbG9nX2N1cnNvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFxQixNQUFNLGlDQUFpQyxDQUFDO0FBQ2pGLE9BQU8sRUFBRSxZQUFZLEVBQWlCLE1BQU0sNkJBQTZCLENBQUM7QUFFMUUsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUd4QixPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUVyRDs7Ozs7Ozs7R0FRRztBQUNILHFCQUFhLFNBQVM7SUFFbEIsc0NBQXNDO2FBQ3RCLFdBQVcsRUFBRSxXQUFXO0lBQ3hDLDBEQUEwRDthQUMxQyxrQkFBa0IsRUFBRSxNQUFNO0lBQzFDLHdEQUF3RDthQUN4QyxnQkFBZ0IsRUFBRSxNQUFNO0lBTjFDO0lBQ0Usc0NBQXNDO0lBQ3RCLFdBQVcsRUFBRSxXQUFXO0lBQ3hDLDBEQUEwRDtJQUMxQyxrQkFBa0IsRUFBRSxNQUFNO0lBQzFDLHdEQUF3RDtJQUN4QyxnQkFBZ0IsRUFBRSxNQUFNLEVBQ3RDO0lBRUosTUFBTSxLQUFLLE1BQU07Ozs7Ozs7O1FBV2hCO0lBRUQscUdBQXFHO0lBQ3JHLE1BQU0sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxhQUFhLEVBQUUsYUFBYSxHQUFHLG9CQUFvQixHQUFHLGtCQUFrQixDQUFDLEdBQUcsU0FBUyxDQUU3RztJQUVELE1BQU0sQ0FBQyxNQUFNLElBQUksU0FBUyxDQU16QjtJQUVELFFBQVEsSUFBSSxNQUFNLENBTWpCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxTQUFTLENBTTFEO0lBRUQsTUFBTSxDQUFDLEtBQUssRUFBRSxTQUFTLEdBQUcsT0FBTyxDQU1oQztJQUVELFFBQVEsSUFBSSxNQUFNLENBRWpCO0lBRUQ7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxhQUFhLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxTQUFTLEdBQUcsU0FBUyxDQXNCekQ7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"log_cursor.d.ts","sourceRoot":"","sources":["../../src/logs/log_cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAiB,MAAM,6BAA6B,CAAC;AAE1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,SAAS;IAElB,sCAAsC;aACtB,WAAW,EAAE,WAAW;IACxC,0DAA0D;aAC1C,kBAAkB,EAAE,MAAM;IAC1C,wDAAwD;aACxC,gBAAgB,EAAE,MAAM;IAN1C;IACE,sCAAsC;IACtB,WAAW,EAAE,WAAW;IACxC,0DAA0D;IAC1C,kBAAkB,EAAE,MAAM;IAC1C,wDAAwD;IACxC,gBAAgB,EAAE,MAAM,EACtC;IAEJ,MAAM,KAAK,MAAM;;;;;;;;QAWhB;IAED,qGAAqG;IACrG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,oBAAoB,GAAG,kBAAkB,CAAC,GAAG,SAAS,CAE7G;IAED,MAAM,CAAC,MAAM,IAAI,SAAS,CAMzB;IAED,QAAQ,IAAI,MAAM,CAMjB;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAM1D;IAED,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAMhC;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAsBzD;CACF"}

package/dest/logs/log_cursor.js

@@ -0,0 +1,82 @@
+import { BlockNumber, BlockNumberSchema } from '@aztec/foundation/branded-types';
+import { BufferReader, numToUInt32BE } from '@aztec/foundation/serialize';
+import { z } from 'zod';
+import { schemas } from '../schemas/schemas.js';
+/**
+ * Cursor identifying a position in a tag's ordered log stream. Used as `afterLog` on `TagQuery` to resume
+ * pagination strictly after a previously-seen log.
+ *
+ * `(blockNumber, txIndexWithinBlock, logIndexWithinTx)` is sufficient to uniquely identify a position
+ * and matches the composite-key ordering of the archiver's log index, so the cursor maps directly to a
+ * key without a tx-hash lookup. All three fields are always present on {@link LogResult}, so a cursor is
+ * constructible from any returned log.
+ */ export class LogCursor {
+    blockNumber;
+    txIndexWithinBlock;
+    logIndexWithinTx;
+    constructor(/** The block the cursor points to. */ blockNumber, /** The tx index within the block the cursor points to. */ txIndexWithinBlock, /** The log index within the tx the cursor points to. */ logIndexWithinTx){
+        this.blockNumber = blockNumber;
+        this.txIndexWithinBlock = txIndexWithinBlock;
+        this.logIndexWithinTx = logIndexWithinTx;
+    }
+    static get schema() {
+        return z.object({
+            blockNumber: BlockNumberSchema,
+            txIndexWithinBlock: schemas.Integer,
+            logIndexWithinTx: schemas.Integer
+        }).transform(({ blockNumber, txIndexWithinBlock, logIndexWithinTx })=>new LogCursor(blockNumber, txIndexWithinBlock, logIndexWithinTx));
+    }
+    /** Builds a cursor that points at the given log. Pagination resumes strictly after this position. */ static fromLog(log) {
+        return new LogCursor(log.blockNumber, log.txIndexWithinBlock, log.logIndexWithinTx);
+    }
+    static random() {
+        return new LogCursor(BlockNumber(Math.floor(Math.random() * 100000) + 1), Math.floor(Math.random() * 100), Math.floor(Math.random() * 100));
+    }
+    toBuffer() {
+        return Buffer.concat([
+            numToUInt32BE(this.blockNumber),
+            numToUInt32BE(this.txIndexWithinBlock),
+            numToUInt32BE(this.logIndexWithinTx)
+        ]);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        const blockNumber = BlockNumber(reader.readNumber());
+        const txIndexWithinBlock = reader.readNumber();
+        const logIndexWithinTx = reader.readNumber();
+        return new LogCursor(blockNumber, txIndexWithinBlock, logIndexWithinTx);
+    }
+    equals(other) {
+        return this.blockNumber === other.blockNumber && this.txIndexWithinBlock === other.txIndexWithinBlock && this.logIndexWithinTx === other.logIndexWithinTx;
+    }
+    toString() {
+        return `${this.blockNumber}-${this.txIndexWithinBlock}-${this.logIndexWithinTx}`;
+    }
+    /**
+   * Parses a `<blockNumber>-<txIndexWithinBlock>-<logIndexWithinTx>` triple into a {@link LogCursor}.
+   * Throws on malformed input. Returns `undefined` for an empty / missing value so callers can use
+   * this directly as an optional CLI option parser.
+   */ static parseOptional(value) {
+        if (!value) {
+            return undefined;
+        }
+        const parts = value.split('-');
+        if (parts.length !== 3) {
+            throw new Error(`Invalid log cursor "${value}". Expected <blockNumber>-<txIndexWithinBlock>-<logIndexWithinTx>.`);
+        }
+        const [blockNumberStr, txIndexStr, logIndexStr] = parts;
+        const blockNumber = Number(blockNumberStr);
+        const txIndexWithinBlock = Number(txIndexStr);
+        const logIndexWithinTx = Number(logIndexStr);
+        if (!Number.isInteger(blockNumber) || blockNumber < 1) {
+            throw new Error(`Invalid log cursor block number: ${blockNumberStr}`);
+        }
+        if (!Number.isInteger(txIndexWithinBlock) || txIndexWithinBlock < 0) {
+            throw new Error(`Invalid log cursor tx index: ${txIndexStr}`);
+        }
+        if (!Number.isInteger(logIndexWithinTx) || logIndexWithinTx < 0) {
+            throw new Error(`Invalid log cursor log index: ${logIndexStr}`);
+        }
+        return new LogCursor(BlockNumber(blockNumber), txIndexWithinBlock, logIndexWithinTx);
+    }
+}

package/dest/logs/log_result.d.ts

@@ -0,0 +1,54 @@
+import { BlockNumber } from '@aztec/foundation/branded-types';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { IfFlag, Prettify } from '@aztec/foundation/types';
+import { z } from 'zod';
+import { BlockHash } from '../block/block_hash.js';
+import { TxHash } from '../tx/tx_hash.js';
+import type { UInt64 } from '../types/shared.js';
+/** Options for narrowing the shape of a {@link LogResult}. */
+export type LogIncludeOptions = {
+    /** When set, the log carries `noteHashes` + all `nullifiers` from its tx effect. Off by default. */
+    includeEffects?: boolean;
+};
+export declare const LogIncludeOptionsSchema: z.ZodType<LogIncludeOptions>;
+/** Required metadata always present on a {@link LogResult}. */
+export type LogResultBase = {
+    /** The data contents of the log, with the tag as the first field. */
+    logData: Fr[];
+    /** The block this log was emitted in. */
+    blockNumber: BlockNumber;
+    /** The hash of the block this log was emitted in. */
+    blockHash: BlockHash;
+    /** The timestamp of the block this log was emitted in. */
+    blockTimestamp: UInt64;
+    /** The hash of the tx this log was emitted in. */
+    txHash: TxHash;
+    /** The 0-based index of this log's tx within its block. */
+    txIndexWithinBlock: number;
+    /** The 0-based index of this log within its tx (across both private and public logs for the tx). */
+    logIndexWithinTx: number;
+};
+/**
+ * A single log returned from {@link L2LogsSource.getPrivateLogsByTags} or {@link L2LogsSource.getPublicLogsByTags}.
+ *
+ * Generic over the include-options so that flagged fields become required when the caller passes a
+ * literal `true`. The default type argument ({@link LogIncludeOptions}) yields the widest shape
+ * (all include-fields optional) — this is what the JSON-RPC wire layer validates against.
+ *
+ * `logData` is the raw field-element payload, with the tag in field 0 (consumers slice it off).
+ *
+ * @example
+ * const l: LogResult<{ includeEffects: true }> = (await node.getPrivateLogsByTags({ tags, includeEffects: true }))[0][0];
+ * l.nullifiers; // required, not optional
+ */
+export type LogResult<Opts extends LogIncludeOptions = LogIncludeOptions> = Prettify<LogResultBase & IfFlag<LogIncludeOptions, Opts, 'includeEffects', {
+    noteHashes: Fr[];
+    nullifiers: Fr[];
+}>>;
+/** Zod schema for the widest {@link LogResult} shape (all include-gated fields optional). */
+export declare const LogResultSchema: z.ZodType<LogResult>;
+/** Builds a random {@link LogResult} for tests. `includeEffects` populates `noteHashes` + `nullifiers`. */
+export declare function randomLogResult(includeEffects?: boolean): LogResult;
+/** Human-readable single-line representation, primarily for the CLI `get-logs` command. */
+export declare function logResultToHumanReadable(log: LogResult): string;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3Jlc3VsdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvbG9nX3Jlc3VsdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFxQixNQUFNLGlDQUFpQyxDQUFDO0FBRWpGLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUVwRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFaEUsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFbkQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzFDLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRWpELDhEQUE4RDtBQUM5RCxNQUFNLE1BQU0saUJBQWlCLEdBQUc7SUFDOUIsb0dBQW9HO0lBQ3BHLGNBQWMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUMxQixDQUFDO0FBRUYsZUFBTyxNQUFNLHVCQUF1QixFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsaUJBQWlCLENBRS9ELENBQUM7QUFFSCwrREFBK0Q7QUFDL0QsTUFBTSxNQUFNLGFBQWEsR0FBRztJQUMxQixxRUFBcUU7SUFDckUsT0FBTyxFQUFFLEVBQUUsRUFBRSxDQUFDO0lBQ2QseUNBQXlDO0lBQ3pDLFdBQVcsRUFBRSxXQUFXLENBQUM7SUFDekIscURBQXFEO0lBQ3JELFNBQVMsRUFBRSxTQUFTLENBQUM7SUFDckIsMERBQTBEO0lBQzFELGNBQWMsRUFBRSxNQUFNLENBQUM7SUFDdkIsa0RBQWtEO0lBQ2xELE1BQU0sRUFBRSxNQUFNLENBQUM7SUFDZiwyREFBMkQ7SUFDM0Qsa0JBQWtCLEVBQUUsTUFBTSxDQUFDO0lBQzNCLG9HQUFvRztJQUNwRyxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7Q0FDMUIsQ0FBQztBQUVGOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILE1BQU0sTUFBTSxTQUFTLENBQUMsSUFBSSxTQUFTLGlCQUFpQixHQUFHLGlCQUFpQixJQUFJLFFBQVEsQ0FDbEYsYUFBYSxHQUFHLE1BQU0sQ0FBQyxpQkFBaUIsRUFBRSxJQUFJLEVBQUUsZ0JBQWdCLEVBQUU7SUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFLENBQUM7SUFBQyxVQUFVLEVBQUUsRUFBRSxFQUFFLENBQUE7Q0FBRSxDQUFDLENBQzFHLENBQUM7QUFFRiw2RkFBNkY7QUFDN0YsZUFBTyxNQUFNLGVBQWUsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FVL0MsQ0FBQztBQUVILDJHQUEyRztBQUMzRyx3QkFBZ0IsZUFBZSxDQUFDLGNBQWMsVUFBUSxHQUFHLFNBQVMsQ0FjakU7QUFFRCwyRkFBMkY7QUFDM0Ysd0JBQWdCLHdCQUF3QixDQUFDLEdBQUcsRUFBRSxTQUFTLEdBQUcsTUFBTSxDQWMvRCJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"log_result.d.ts","sourceRoot":"","sources":["../../src/logs/log_result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,iCAAiC,CAAC;AAEjF,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oGAAoG;IACpG,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAE/D,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,OAAO,EAAE,EAAE,EAAE,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oGAAoG;IACpG,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,QAAQ,CAClF,aAAa,GAAG,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC,CAC1G,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAU/C,CAAC;AAEH,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,cAAc,UAAQ,GAAG,SAAS,CAcjE;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAc/D"}

package/dest/logs/log_result.js

@@ -0,0 +1,56 @@
+import { BlockNumber, BlockNumberSchema } from '@aztec/foundation/branded-types';
+import { times } from '@aztec/foundation/collection';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { schemas as foundationSchemas } from '@aztec/foundation/schemas';
+import { z } from 'zod';
+import { BlockHash } from '../block/block_hash.js';
+import { schemas } from '../schemas/schemas.js';
+import { TxHash } from '../tx/tx_hash.js';
+export const LogIncludeOptionsSchema = z.object({
+    includeEffects: z.boolean().optional()
+});
+/** Zod schema for the widest {@link LogResult} shape (all include-gated fields optional). */ export const LogResultSchema = z.object({
+    logData: z.array(foundationSchemas.Fr),
+    blockNumber: BlockNumberSchema,
+    blockHash: BlockHash.schema,
+    blockTimestamp: schemas.UInt64,
+    txHash: TxHash.schema,
+    txIndexWithinBlock: schemas.Integer,
+    logIndexWithinTx: schemas.Integer,
+    noteHashes: z.array(foundationSchemas.Fr).optional(),
+    nullifiers: z.array(foundationSchemas.Fr).optional()
+});
+/** Builds a random {@link LogResult} for tests. `includeEffects` populates `noteHashes` + `nullifiers`. */ export function randomLogResult(includeEffects = false) {
+    const base = {
+        logData: times(3, Fr.random),
+        blockNumber: BlockNumber(Math.floor(Math.random() * 100000) + 1),
+        blockHash: BlockHash.random(),
+        blockTimestamp: BigInt(Math.floor(Date.now() / 1000)),
+        txHash: TxHash.random(),
+        txIndexWithinBlock: Math.floor(Math.random() * 100),
+        logIndexWithinTx: Math.floor(Math.random() * 100)
+    };
+    if (includeEffects) {
+        return {
+            ...base,
+            noteHashes: times(3, Fr.random),
+            nullifiers: times(3, Fr.random)
+        };
+    }
+    return base;
+}
+/** Human-readable single-line representation, primarily for the CLI `get-logs` command. */ export function logResultToHumanReadable(log) {
+    const head = `block ${log.blockNumber} (${log.blockHash.toString()}) ` + `tx ${log.txHash.toString()} txIndex ${log.txIndexWithinBlock} logIndex ${log.logIndexWithinTx} ` + `ts ${log.blockTimestamp}`;
+    const data = `data [${log.logData.map((f)=>f.toString()).join(', ')}]`;
+    const parts = [
+        head,
+        data
+    ];
+    if (log.noteHashes !== undefined) {
+        parts.push(`noteHashes [${log.noteHashes.map((f)=>f.toString()).join(', ')}]`);
+    }
+    if (log.nullifiers !== undefined) {
+        parts.push(`nullifiers [${log.nullifiers.map((f)=>f.toString()).join(', ')}]`);
+    }
+    return parts.join(' | ');
+}