@aztec/stdlib 5.0.0-private.20260319 → 5.0.0-rc.1

package/dest/logs/contract_class_log.js

@@ -3,7 +3,7 @@ import { CONTRACT_CLASS_LOG_LENGTH, CONTRACT_CLASS_LOG_SIZE_IN_FIELDS } from '@a
 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';
@@ -45,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);
@@ -131,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);

package/dest/logs/index.d.ts

@@ -1,19 +1,19 @@
-export * from './extended_directional_app_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';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9sb2dzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsOENBQThDLENBQUM7QUFDN0QsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLGtDQUFrQyxDQUFDO0FBQ2pELGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsZ0JBQWdCLENBQUM7QUFDL0IsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLFVBQVUsQ0FBQztBQUN6QixjQUFjLGlCQUFpQixDQUFDIn0=
+//# 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,8CAA8C,CAAC;AAC7D,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,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;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,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,16 +1,16 @@
-export * from './extended_directional_app_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';

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 { PickIfFlag, 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 & PickIfFlag<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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nX3Jlc3VsdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvbG9nX3Jlc3VsdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFxQixNQUFNLGlDQUFpQyxDQUFDO0FBRWpGLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUVwRCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsUUFBUSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFcEUsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFbkQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzFDLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRWpELDhEQUE4RDtBQUM5RCxNQUFNLE1BQU0saUJBQWlCLEdBQUc7SUFDOUIsb0dBQW9HO0lBQ3BHLGNBQWMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUMxQixDQUFDO0FBRUYsZUFBTyxNQUFNLHVCQUF1QixFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsaUJBQWlCLENBRS9ELENBQUM7QUFFSCwrREFBK0Q7QUFDL0QsTUFBTSxNQUFNLGFBQWEsR0FBRztJQUMxQixxRUFBcUU7SUFDckUsT0FBTyxFQUFFLEVBQUUsRUFBRSxDQUFDO0lBQ2QseUNBQXlDO0lBQ3pDLFdBQVcsRUFBRSxXQUFXLENBQUM7SUFDekIscURBQXFEO0lBQ3JELFNBQVMsRUFBRSxTQUFTLENBQUM7SUFDckIsMERBQTBEO0lBQzFELGNBQWMsRUFBRSxNQUFNLENBQUM7SUFDdkIsa0RBQWtEO0lBQ2xELE1BQU0sRUFBRSxNQUFNLENBQUM7SUFDZiwyREFBMkQ7SUFDM0Qsa0JBQWtCLEVBQUUsTUFBTSxDQUFDO0lBQzNCLG9HQUFvRztJQUNwRyxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7Q0FDMUIsQ0FBQztBQUVGOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILE1BQU0sTUFBTSxTQUFTLENBQUMsSUFBSSxTQUFTLGlCQUFpQixHQUFHLGlCQUFpQixJQUFJLFFBQVEsQ0FDbEYsYUFBYSxHQUFHLFVBQVUsQ0FBQyxpQkFBaUIsRUFBRSxJQUFJLEVBQUUsZ0JBQWdCLEVBQUU7SUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFLENBQUM7SUFBQyxVQUFVLEVBQUUsRUFBRSxFQUFFLENBQUE7Q0FBRSxDQUFDLENBQzlHLENBQUM7QUFFRiw2RkFBNkY7QUFDN0YsZUFBTyxNQUFNLGVBQWUsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FVL0MsQ0FBQztBQUVILDJHQUEyRztBQUMzRyx3QkFBZ0IsZUFBZSxDQUFDLGNBQWMsVUFBUSxHQUFHLFNBQVMsQ0FjakU7QUFFRCwyRkFBMkY7QUFDM0Ysd0JBQWdCLHdCQUF3QixDQUFDLEdBQUcsRUFBRSxTQUFTLEdBQUcsTUFBTSxDQWMvRCJ9

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,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEpE,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,UAAU,CAAC,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAAC,UAAU,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC,CAC9G,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(' | ');
+}

package/dest/logs/logs_query.d.ts

@@ -0,0 +1,82 @@
+import type { BlockNumber } from '@aztec/foundation/branded-types';
+import { z } from 'zod';
+import type { AztecAddress } from '../aztec-address/index.js';
+import { BlockHash } from '../block/block_hash.js';
+import { type ZodFor } from '../schemas/index.js';
+import { TxHash } from '../tx/tx_hash.js';
+import { LogCursor } from './log_cursor.js';
+import { SiloedTag } from './siloed_tag.js';
+import { Tag } from './tag.js';
+/**
+ * A tag to query in {@link PrivateLogsQuery} / {@link PublicLogsQuery}, optionally resuming strictly
+ * after a previously-seen log via `afterLog`. The bare `T` form means "from the beginning".
+ */
+export type TagQuery<T extends Tag | SiloedTag> = T | {
+    tag: T;
+    afterLog?: LogCursor;
+};
+/**
+ * Shared fields for {@link PrivateLogsQuery} and {@link PublicLogsQuery}.
+ */
+export type LogsQueryBase = {
+    /** Lower block bound, inclusive. */
+    fromBlock?: BlockNumber;
+    /** Upper block bound, exclusive. */
+    toBlock?: BlockNumber;
+    /**
+     * Restrict results to logs emitted in this transaction. Mutually exclusive with `fromBlock`/`toBlock`
+     * (a txHash already pins a block). `txHash` + `afterLog` is allowed and paginates within the tx's logs
+     * for that tag.
+     */
+    txHash?: TxHash;
+    /**
+     * Reorg-safety anchor: the latest block hash the caller has synced to. If set and the block is no
+     * longer present, the call throws. Distinct from `toBlock`, which is a filter, not a safety check.
+     */
+    referenceBlock?: BlockHash;
+    /** When set, each log also carries `noteHashes` and all `nullifiers` for note-nonce discovery. */
+    includeEffects?: boolean;
+    /**
+     * Maximum number of logs returned per tag. Capped at {@link MAX_LOGS_PER_TAG} (rejected if higher).
+     * Defaults to {@link MAX_LOGS_PER_TAG} when unset. Mainly useful for tests that need to force
+     * pagination at a small page size.
+     */
+    limitPerTag?: number;
+};
+/**
+ * Query for {@link L2LogsSource.getPrivateLogsByTags}. Returns one inner array per element of `tags`,
+ * in input order.
+ */
+export type PrivateLogsQuery = LogsQueryBase & {
+    /** Tags to query. Between 1 and {@link MAX_RPC_LEN} entries (inclusive). */
+    tags: TagQuery<SiloedTag>[];
+};
+/**
+ * Query for {@link L2LogsSource.getPublicLogsByTags}. Returns one inner array per element of `tags`,
+ * in input order.
+ */
+export type PublicLogsQuery = LogsQueryBase & {
+    /** Contract address that emitted the logs. Required for public queries. */
+    contractAddress: AztecAddress;
+    /** Tags to query. Between 1 and {@link MAX_RPC_LEN} entries (inclusive). */
+    tags: TagQuery<Tag>[];
+};
+/** Minimal shape required by {@link refineTxHashAndRange}. */
+type TxHashAndRangeFields = {
+    /** Tx hash filter. */
+    txHash?: TxHash;
+    /** Lower block bound. */
+    fromBlock?: BlockNumber;
+    /** Upper block bound (exclusive). */
+    toBlock?: BlockNumber;
+};
+/**
+ * Refinement: a `txHash` already pins a block, so combining it with a block range is contradictory.
+ * (`txHash` + `afterLog` is still allowed and is enforced per-tag inside `TagQuery`.) Exported so
+ * `aztec.js`'s wallet event-filter schemas can reuse the same rule.
+ */
+export declare function refineTxHashAndRange<T extends TxHashAndRangeFields>(schema: z.ZodType<T>): z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>;
+export declare const PrivateLogsQuerySchema: ZodFor<PrivateLogsQuery>;
+export declare const PublicLogsQuerySchema: ZodFor<PublicLogsQuery>;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nc19xdWVyeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2xvZ3MvbG9nc19xdWVyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUVuRSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzlELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUVuRCxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQW1CLE1BQU0scUJBQXFCLENBQUM7QUFDbkUsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzFDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUM1QyxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDNUMsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUUvQjs7O0dBR0c7QUFDSCxNQUFNLE1BQU0sUUFBUSxDQUFDLENBQUMsU0FBUyxHQUFHLEdBQUcsU0FBUyxJQUFJLENBQUMsR0FBRztJQUFFLEdBQUcsRUFBRSxDQUFDLENBQUM7SUFBQyxRQUFRLENBQUMsRUFBRSxTQUFTLENBQUE7Q0FBRSxDQUFDO0FBRXZGOztHQUVHO0FBQ0gsTUFBTSxNQUFNLGFBQWEsR0FBRztJQUMxQixvQ0FBb0M7SUFDcEMsU0FBUyxDQUFDLEVBQUUsV0FBVyxDQUFDO0lBQ3hCLG9DQUFvQztJQUNwQyxPQUFPLENBQUMsRUFBRSxXQUFXLENBQUM7SUFDdEI7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNoQjs7O09BR0c7SUFDSCxjQUFjLENBQUMsRUFBRSxTQUFTLENBQUM7SUFDM0Isa0dBQWtHO0lBQ2xHLGNBQWMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN6Qjs7OztPQUlHO0lBQ0gsV0FBVyxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ3RCLENBQUM7QUFFRjs7O0dBR0c7QUFDSCxNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsYUFBYSxHQUFHO0lBQzdDLDRFQUE0RTtJQUM1RSxJQUFJLEVBQUUsUUFBUSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUM7Q0FDN0IsQ0FBQztBQUVGOzs7R0FHRztBQUNILE1BQU0sTUFBTSxlQUFlLEdBQUcsYUFBYSxHQUFHO0lBQzVDLDJFQUEyRTtJQUMzRSxlQUFlLEVBQUUsWUFBWSxDQUFDO0lBQzlCLDRFQUE0RTtJQUM1RSxJQUFJLEVBQUUsUUFBUSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7Q0FDdkIsQ0FBQztBQTBCRiw4REFBOEQ7QUFDOUQsS0FBSyxvQkFBb0IsR0FBRztJQUMxQixzQkFBc0I7SUFDdEIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2hCLHlCQUF5QjtJQUN6QixTQUFTLENBQUMsRUFBRSxXQUFXLENBQUM7SUFDeEIscUNBQXFDO0lBQ3JDLE9BQU8sQ0FBQyxFQUFFLFdBQVcsQ0FBQztDQUN2QixDQUFDO0FBRUY7Ozs7R0FJRztBQUNILHdCQUFnQixvQkFBb0IsQ0FBQyxDQUFDLFNBQVMsb0JBQW9CLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLCtEQUl4RjtBQUVELGVBQU8sTUFBTSxzQkFBc0IsRUFBRSxNQUFNLENBQUMsZ0JBQWdCLENBVTNELENBQUM7QUFFRixlQUFPLE1BQU0scUJBQXFCLEVBQUUsTUFBTSxDQUFDLGVBQWUsQ0FXekQsQ0FBQyJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs_query.d.ts","sourceRoot":"","sources":["../../src/logs/logs_query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,GAAG,GAAG,SAAS,IAAI,CAAC,GAAG;IAAE,GAAG,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,oCAAoC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,kGAAkG;IAClG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,2EAA2E;IAC3E,eAAe,EAAE,YAAY,CAAC;IAC9B,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB,CAAC;AA0BF,8DAA8D;AAC9D,KAAK,oBAAoB,GAAG;IAC1B,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,+DAIxF;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,CAU3D,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,CAWzD,CAAC"}

package/dest/logs/logs_query.js

@@ -0,0 +1,50 @@
+import { BlockNumberSchema } from '@aztec/foundation/branded-types';
+import { z } from 'zod';
+import { BlockHash } from '../block/block_hash.js';
+import { MAX_LOGS_PER_TAG, MAX_RPC_LEN } from '../interfaces/api_limit.js';
+import { schemas, zodFor } from '../schemas/index.js';
+import { TxHash } from '../tx/tx_hash.js';
+import { LogCursor } from './log_cursor.js';
+import { SiloedTag } from './siloed_tag.js';
+import { Tag } from './tag.js';
+function tagQuerySchema(tagSchema) {
+    return z.union([
+        tagSchema,
+        z.object({
+            tag: tagSchema,
+            afterLog: LogCursor.schema.optional()
+        })
+    ]);
+}
+const logsQueryBaseShape = {
+    fromBlock: BlockNumberSchema.optional(),
+    toBlock: BlockNumberSchema.optional(),
+    txHash: TxHash.schema.optional(),
+    referenceBlock: BlockHash.schema.optional(),
+    includeEffects: z.boolean().optional(),
+    limitPerTag: z.number().int().positive().max(MAX_LOGS_PER_TAG, {
+        message: `limitPerTag must be <= ${MAX_LOGS_PER_TAG}`
+    }).optional()
+};
+/**
+ * Refinement: a `txHash` already pins a block, so combining it with a block range is contradictory.
+ * (`txHash` + `afterLog` is still allowed and is enforced per-tag inside `TagQuery`.) Exported so
+ * `aztec.js`'s wallet event-filter schemas can reuse the same rule.
+ */ export function refineTxHashAndRange(schema) {
+    return schema.refine((q)=>!(q.txHash !== undefined && (q.fromBlock !== undefined || q.toBlock !== undefined)), {
+        message: '`txHash` is mutually exclusive with `fromBlock`/`toBlock`'
+    });
+}
+export const PrivateLogsQuerySchema = refineTxHashAndRange(zodFor()(z.object({
+    ...logsQueryBaseShape,
+    tags: z.array(tagQuerySchema(SiloedTag.schema)).min(1).max(MAX_RPC_LEN, {
+        message: `tags must have at most ${MAX_RPC_LEN} entries`
+    })
+})));
+export const PublicLogsQuerySchema = refineTxHashAndRange(zodFor()(z.object({
+    ...logsQueryBaseShape,
+    contractAddress: schemas.AztecAddress,
+    tags: z.array(tagQuerySchema(Tag.schema)).min(1).max(MAX_RPC_LEN, {
+        message: `tags must have at most ${MAX_RPC_LEN} entries`
+    })
+})));

package/dest/logs/message_context.d.ts

@@ -1,7 +1,5 @@
 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';
+import { TxHash } from '../tx/tx_hash.js';
 /**
  * Additional information needed to process a message.
  *
@@ -15,15 +13,15 @@ export declare class MessageContext {
     txHash: TxHash;
     uniqueNoteHashesInTx: Fr[];
     firstNullifierInTx: Fr;
-    recipient: AztecAddress;
-    constructor(txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr, recipient: AztecAddress);
+    constructor(txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr);
     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;
+    static empty(): MessageContext;
+    static toEmptyFields(): Fr[];
+    static toSerializedOption(response: MessageContext | null): Fr[];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZV9jb250ZXh0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9tZXNzYWdlX2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ25ELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRS9DOzs7Ozs7OztHQVFHO0FBQ0gscUJBQWEsY0FBYztJQUVoQixNQUFNLEVBQUUsTUFBTTtJQUNkLG9CQUFvQixFQUFFLEVBQUUsRUFBRTtJQUMxQixrQkFBa0IsRUFBRSxFQUFFO0lBQ3RCLFNBQVMsRUFBRSxZQUFZO0lBSmhDLFlBQ1MsTUFBTSxFQUFFLE1BQU0sRUFDZCxvQkFBb0IsRUFBRSxFQUFFLEVBQUUsRUFDMUIsa0JBQWtCLEVBQUUsRUFBRSxFQUN0QixTQUFTLEVBQUUsWUFBWSxFQUM1QjtJQUVKLFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FPZjtJQUVELFlBQVk7Ozs7O01BU1g7SUFFRCxNQUFNLENBQUMsd0JBQXdCLENBQUMsUUFBUSxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsWUFBWSxHQUFHLGNBQWMsQ0FFM0Y7Q0FDRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZV9jb250ZXh0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9tZXNzYWdlX2NvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUUxQzs7Ozs7Ozs7R0FRRztBQUNILHFCQUFhLGNBQWM7SUFFaEIsTUFBTSxFQUFFLE1BQU07SUFDZCxvQkFBb0IsRUFBRSxFQUFFLEVBQUU7SUFDMUIsa0JBQWtCLEVBQUUsRUFBRTtJQUgvQixZQUNTLE1BQU0sRUFBRSxNQUFNLEVBQ2Qsb0JBQW9CLEVBQUUsRUFBRSxFQUFFLEVBQzFCLGtCQUFrQixFQUFFLEVBQUUsRUFDM0I7SUFFSixRQUFRLElBQUksRUFBRSxFQUFFLENBTWY7SUFFRCxZQUFZOzs7O01BUVg7SUFFRCxNQUFNLENBQUMsS0FBSyxJQUFJLGNBQWMsQ0FFN0I7SUFFRCxNQUFNLENBQUMsYUFBYSxJQUFJLEVBQUUsRUFBRSxDQUkzQjtJQUVELE1BQU0sQ0FBQyxrQkFBa0IsQ0FBQyxRQUFRLEVBQUUsY0FBYyxHQUFHLElBQUksR0FBRyxFQUFFLEVBQUUsQ0FNL0Q7Q0FDRiJ9

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

@@ -1 +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"}
+{"version":3,"file":"message_context.d.ts","sourceRoot":"","sources":["../../src/logs/message_context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,cAAc;IAEhB,MAAM,EAAE,MAAM;IACd,oBAAoB,EAAE,EAAE,EAAE;IAC1B,kBAAkB,EAAE,EAAE;IAH/B,YACS,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,EAAE,EAAE,EAC1B,kBAAkB,EAAE,EAAE,EAC3B;IAEJ,QAAQ,IAAI,EAAE,EAAE,CAMf;IAED,YAAY;;;;MAQX;IAED,MAAM,CAAC,KAAK,IAAI,cAAc,CAE7B;IAED,MAAM,CAAC,aAAa,IAAI,EAAE,EAAE,CAI3B;IAED,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,EAAE,EAAE,CAM/D;CACF"}

package/dest/logs/message_context.js

@@ -1,5 +1,7 @@
 import { MAX_NOTE_HASHES_PER_TX } from '@aztec/constants';
+import { range } from '@aztec/foundation/array';
 import { Fr } from '@aztec/foundation/curves/bn254';
+import { TxHash } from '../tx/tx_hash.js';
 /**
  * Additional information needed to process a message.
  *
@@ -12,31 +14,44 @@ import { Fr } from '@aztec/foundation/curves/bn254';
     txHash;
     uniqueNoteHashesInTx;
     firstNullifierInTx;
-    recipient;
-    constructor(txHash, uniqueNoteHashesInTx, firstNullifierInTx, recipient){
+    constructor(txHash, uniqueNoteHashesInTx, firstNullifierInTx){
         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()
+            this.firstNullifierInTx
         ];
     }
     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
+            first_nullifier_in_tx: this.firstNullifierInTx
         };
     /* eslint-enable camelcase */ }
-    static fromTxEffectAndRecipient(txEffect, recipient) {
-        return new MessageContext(txEffect.txHash, txEffect.noteHashes, txEffect.nullifiers[0], recipient);
+    static empty() {
+        return new MessageContext(TxHash.zero(), [], Fr.ZERO);
+    }
+    static toEmptyFields() {
+        const serializationLen = 1 /* txHash */  + MAX_NOTE_HASHES_PER_TX + 1 /* uniqueNoteHashesInTx BVec */  + 1; /* firstNullifierInTx */ 
+        return range(serializationLen).map((_)=>Fr.zero());
+    }
+    static toSerializedOption(response) {
+        if (response) {
+            return [
+                new Fr(1),
+                ...response.toFields()
+            ];
+        } else {
+            return [
+                new Fr(0),
+                ...MessageContext.toEmptyFields()
+            ];
+        }
     }
 }
 /**
@@ -46,6 +61,9 @@ import { Fr } from '@aztec/foundation/curves/bn254';
  * @returns The serialized bounded vector as Fr[]
  * @dev Copied over from pending_tagged_log.ts.
  */ function serializeBoundedVec(values, maxLength) {
+    if (values.length > maxLength) {
+        throw new Error(`Attempted to serialize ${values} values into a BoundedVec with max length ${maxLength}`);
+    }
     const lengthDiff = maxLength - values.length;
     const zeroPaddingArray = Array(lengthDiff).fill(Fr.ZERO);
     const storage = values.concat(zeroPaddingArray);

package/dest/logs/pending_tagged_log.d.ts

@@ -1,5 +1,4 @@
 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
@@ -8,7 +7,7 @@ import type { TxHash } from '../tx/tx_hash.js';
 export declare class PendingTaggedLog {
     log: Fr[];
     private context;
-    constructor(log: Fr[], txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr, recipient: AztecAddress);
+    constructor(log: Fr[], txHash: TxHash, uniqueNoteHashesInTx: Fr[], firstNullifierInTx: Fr);
     toFields(): Fr[];
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVuZGluZ190YWdnZWRfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9wZW5kaW5nX3RhZ2dlZF9sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzlELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRy9DOzs7R0FHRztBQUNILHFCQUFhLGdCQUFnQjtJQUlsQixHQUFHLEVBQUUsRUFBRSxFQUFFO0lBSGxCLE9BQU8sQ0FBQyxPQUFPLENBQWlCO0lBRWhDLFlBQ1MsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUNoQixNQUFNLEVBQUUsTUFBTSxFQUNkLG9CQUFvQixFQUFFLEVBQUUsRUFBRSxFQUMxQixrQkFBa0IsRUFBRSxFQUFFLEVBQ3RCLFNBQVMsRUFBRSxZQUFZLEVBR3hCO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0NBQ0YifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVuZGluZ190YWdnZWRfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9wZW5kaW5nX3RhZ2dlZF9sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBRXBELE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRy9DOzs7R0FHRztBQUNILHFCQUFhLGdCQUFnQjtJQUlsQixHQUFHLEVBQUUsRUFBRSxFQUFFO0lBSGxCLE9BQU8sQ0FBQyxPQUFPLENBQWlCO0lBRWhDLFlBQ1MsR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUNoQixNQUFNLEVBQUUsTUFBTSxFQUNkLG9CQUFvQixFQUFFLEVBQUUsRUFBRSxFQUMxQixrQkFBa0IsRUFBRSxFQUFFLEVBR3ZCO0lBRUQsUUFBUSxJQUFJLEVBQUUsRUFBRSxDQUVmO0NBQ0YifQ==