@aztec-labs/stdlib 6.0.0-nightly.20260829

package/dest/tx/global_variables.d.ts

@@ -0,0 +1,138 @@
+import { BlockNumber, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { BufferReader, BufferSink, FieldReader } from '@aztec-labs/foundation/serialize';
+import type { FieldsOf } from '@aztec-labs/foundation/types';
+import { inspect } from 'util';
+import { z } from 'zod';
+import { AztecAddress } from '../aztec-address/index.js';
+import { GasFees } from '../gas/gas_fees.js';
+import type { UInt64 } from '../types/index.js';
+/**
+ * Global variables that are constant across the entire checkpoint (slot).
+ * Excludes blockNumber since that varies per block within a checkpoint.
+ */
+export type CheckpointGlobalVariables = Omit<FieldsOf<GlobalVariables>, 'blockNumber'>;
+/**
+ * Global variables of the L2 block.
+ */
+export declare class GlobalVariables {
+    /** ChainId for the L2 block. */
+    chainId: Fr;
+    /** Version for the L2 block. */
+    version: Fr;
+    /** Block number of the L2 block. */
+    blockNumber: BlockNumber;
+    /** Slot number of the L2 block */
+    slotNumber: SlotNumber;
+    /** Timestamp of the L2 block. */
+    timestamp: UInt64;
+    /** Recipient of block reward. */
+    coinbase: EthAddress;
+    /** Address to receive fees. */
+    feeRecipient: AztecAddress;
+    /** Global gas prices for this block. */
+    gasFees: GasFees;
+    constructor(
+    /** ChainId for the L2 block. */
+    chainId: Fr, 
+    /** Version for the L2 block. */
+    version: Fr, 
+    /** Block number of the L2 block. */
+    blockNumber: BlockNumber, 
+    /** Slot number of the L2 block */
+    slotNumber: SlotNumber, 
+    /** Timestamp of the L2 block. */
+    timestamp: UInt64, 
+    /** Recipient of block reward. */
+    coinbase: EthAddress, 
+    /** Address to receive fees. */
+    feeRecipient: AztecAddress, 
+    /** Global gas prices for this block. */
+    gasFees: GasFees);
+    static get schema(): z.ZodPipe<z.ZodObject<{
+        chainId: import("../schemas/index.js").ZodFor<Fr>;
+        version: import("../schemas/index.js").ZodFor<Fr>;
+        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>>;
+        slotNumber: import("../schemas/index.js").ZodFor<SlotNumber>;
+        timestamp: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+        coinbase: import("../schemas/index.js").ZodFor<EthAddress>;
+        feeRecipient: import("../schemas/index.js").ZodFor<AztecAddress>;
+        gasFees: z.ZodPipe<z.ZodObject<{
+            feePerDaGas: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+            feePerL2Gas: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+        }, z.core.$strip>, z.ZodTransform<GasFees, {
+            feePerDaGas: bigint;
+            feePerL2Gas: bigint;
+        }>>;
+    }, z.core.$strip>, z.ZodTransform<GlobalVariables, {
+        chainId: Fr;
+        version: Fr;
+        blockNumber: BlockNumber;
+        slotNumber: SlotNumber;
+        timestamp: bigint;
+        coinbase: EthAddress;
+        feeRecipient: AztecAddress;
+        gasFees: GasFees;
+    }>>;
+    getSize(): number;
+    static from(fields: FieldsOf<GlobalVariables>): GlobalVariables;
+    /**
+     * Creates a GlobalVariables instance 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 GlobalVariables fields
+     * @returns A GlobalVariables instance
+     */
+    static fromPlainObject(obj: any): GlobalVariables;
+    static empty(fields?: Partial<FieldsOf<GlobalVariables>>): GlobalVariables;
+    static fromBuffer(buffer: Buffer | BufferReader): GlobalVariables;
+    static fromFields(fields: Fr[] | FieldReader): GlobalVariables;
+    static getFields(fields: FieldsOf<GlobalVariables>): readonly [Fr, Fr, BlockNumber, SlotNumber, bigint, EthAddress, AztecAddress, GasFees];
+    toBuffer(): Buffer;
+    toBuffer(sink: BufferSink): void;
+    toFields(): Fr[];
+    /**
+     * A trimmed version of the JSON representation of the global variables,
+     * tailored for human consumption.
+     */
+    toFriendlyJSON(): {
+        blockNumber: BlockNumber;
+        slotNumber: SlotNumber;
+        timestamp: string;
+        coinbase: `0x${string}`;
+        gasFees: string;
+    };
+    /**
+     * Converts GlobalVariables to a plain object suitable for MessagePack serialization.
+     * This method ensures that slotNumber is serialized as a Fr (Field element) to match
+     * the C++ struct definition which expects slot_number as FF.
+     */
+    toJSON(): {
+        chainId: Fr;
+        version: Fr;
+        blockNumber: BlockNumber;
+        slotNumber: Fr;
+        timestamp: bigint;
+        coinbase: EthAddress;
+        feeRecipient: AztecAddress;
+        gasFees: GasFees;
+    };
+    clone(): GlobalVariables;
+    isEmpty(): boolean;
+    static random(overrides?: Partial<FieldsOf<GlobalVariables>>): GlobalVariables;
+    toInspect(): {
+        chainId: number;
+        version: number;
+        blockNumber: BlockNumber;
+        slotNumber: SlotNumber;
+        timestamp: bigint;
+        coinbase: `0x${string}`;
+        feeRecipient: `0x${string}`;
+        feePerDaGas: number;
+        feePerL2Gas: number;
+    };
+    [inspect.custom](): string;
+    equals(other: this): boolean;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2xvYmFsX3ZhcmlhYmxlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R4L2dsb2JhbF92YXJpYWJsZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLFdBQVcsRUFBcUIsVUFBVSxFQUFFLE1BQU0sc0NBQXNDLENBQUM7QUFFbEcsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQ3pELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUVoRSxPQUFPLEVBQ0wsWUFBWSxFQUNaLFVBQVUsRUFDVixXQUFXLEVBR1osTUFBTSxrQ0FBa0MsQ0FBQztBQUMxQyxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUM3RCxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBQy9CLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ3pELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUU3QyxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUVoRDs7O0dBR0c7QUFDSCxNQUFNLE1BQU0seUJBQXlCLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQyxlQUFlLENBQUMsRUFBRSxhQUFhLENBQUMsQ0FBQztBQUV2Rjs7R0FFRztBQUNILHFCQUFhLGVBQWU7SUFFeEIsZ0NBQWdDO0lBQ3pCLE9BQU8sRUFBRSxFQUFFO0lBQ2xCLGdDQUFnQztJQUN6QixPQUFPLEVBQUUsRUFBRTtJQUNsQixvQ0FBb0M7SUFDN0IsV0FBVyxFQUFFLFdBQVc7SUFDL0Isa0NBQWtDO0lBQzNCLFVBQVUsRUFBRSxVQUFVO0lBQzdCLGlDQUFpQztJQUMxQixTQUFTLEVBQUUsTUFBTTtJQUN4QixpQ0FBaUM7SUFDMUIsUUFBUSxFQUFFLFVBQVU7SUFDM0IsK0JBQStCO0lBQ3hCLFlBQVksRUFBRSxZQUFZO0lBQ2pDLHdDQUF3QztJQUNqQyxPQUFPLEVBQUUsT0FBTztJQWhCekI7SUFDRSxnQ0FBZ0M7SUFDekIsT0FBTyxFQUFFLEVBQUU7SUFDbEIsZ0NBQWdDO0lBQ3pCLE9BQU8sRUFBRSxFQUFFO0lBQ2xCLG9DQUFvQztJQUM3QixXQUFXLEVBQUUsV0FBVztJQUMvQixrQ0FBa0M7SUFDM0IsVUFBVSxFQUFFLFVBQVU7SUFDN0IsaUNBQWlDO0lBQzFCLFNBQVMsRUFBRSxNQUFNO0lBQ3hCLGlDQUFpQztJQUMxQixRQUFRLEVBQUUsVUFBVTtJQUMzQiwrQkFBK0I7SUFDeEIsWUFBWSxFQUFFLFlBQVk7SUFDakMsd0NBQXdDO0lBQ2pDLE9BQU8sRUFBRSxPQUFPLEVBQ3JCO0lBRUosTUFBTSxLQUFLLE1BQU07Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztRQWFoQjtJQUVELE9BQU8sSUFBSSxNQUFNLENBRWhCO0lBRUQsTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsUUFBUSxDQUFDLGVBQWUsQ0FBQyxHQUFHLGVBQWUsQ0FFOUQ7SUFFRDs7Ozs7O09BTUc7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEdBQUcsZUFBZSxDQVdoRDtJQUVELE1BQU0sQ0FBQyxLQUFLLENBQUMsTUFBTSxHQUFFLE9BQU8sQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLENBQU0sR0FBRyxlQUFlLENBWTdFO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxlQUFlLENBWWhFO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxHQUFHLGVBQWUsQ0FhN0Q7SUFFRCxNQUFNLENBQUMsU0FBUyxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsZUFBZSxDQUFDLHlGQVdqRDtJQUVELFFBQVEsSUFBSSxNQUFNLENBQUM7SUFDbkIsUUFBUSxDQUFDLElBQUksRUFBRSxVQUFVLEdBQUcsSUFBSSxDQUFDO0lBVWpDLFFBQVEsU0FRUDtJQUVEOzs7T0FHRztJQUNILGNBQWM7Ozs7OztNQVFiO0lBRUQ7Ozs7T0FJRztJQUNILE1BQU07Ozs7Ozs7OztNQVdMO0lBRUQsS0FBSyxJQUFJLGVBQWUsQ0FFdkI7SUFFRCxPQUFPLElBQUksT0FBTyxDQVdqQjtJQUVELE1BQU0sQ0FBQyxNQUFNLENBQUMsU0FBUyxHQUFFLE9BQU8sQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLENBQU0sR0FBRyxlQUFlLENBWWpGO0lBRUQsU0FBUzs7Ozs7Ozs7OztNQVlSO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLFdBRWY7SUFFTSxNQUFNLENBQUMsS0FBSyxFQUFFLElBQUksR0FBRyxPQUFPLENBV2xDO0NBQ0YifQ==

package/dest/tx/global_variables.d.ts.map

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

package/dest/tx/global_variables.js

@@ -0,0 +1,177 @@
+var _computedKey;
+import { GLOBAL_VARIABLES_LENGTH } from '@aztec-labs/constants';
+import { BlockNumber, BlockNumberSchema, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { randomInt } from '@aztec-labs/foundation/crypto/random';
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { jsonStringify } from '@aztec-labs/foundation/json-rpc';
+import { BufferReader, BufferSink, FieldReader, serializeToFields, serializeToSink } from '@aztec-labs/foundation/serialize';
+import { inspect } from 'util';
+import { z } from 'zod';
+import { AztecAddress } from '../aztec-address/index.js';
+import { GasFees } from '../gas/gas_fees.js';
+import { schemas } from '../schemas/index.js';
+_computedKey = inspect.custom;
+/**
+ * Global variables of the L2 block.
+ */ export class GlobalVariables {
+    chainId;
+    version;
+    blockNumber;
+    slotNumber;
+    timestamp;
+    coinbase;
+    feeRecipient;
+    gasFees;
+    constructor(/** ChainId for the L2 block. */ chainId, /** Version for the L2 block. */ version, /** Block number of the L2 block. */ blockNumber, /** Slot number of the L2 block */ slotNumber, /** Timestamp of the L2 block. */ timestamp, /** Recipient of block reward. */ coinbase, /** Address to receive fees. */ feeRecipient, /** Global gas prices for this block. */ gasFees){
+        this.chainId = chainId;
+        this.version = version;
+        this.blockNumber = blockNumber;
+        this.slotNumber = slotNumber;
+        this.timestamp = timestamp;
+        this.coinbase = coinbase;
+        this.feeRecipient = feeRecipient;
+        this.gasFees = gasFees;
+    }
+    static get schema() {
+        return z.object({
+            chainId: schemas.Fr,
+            version: schemas.Fr,
+            blockNumber: BlockNumberSchema,
+            slotNumber: schemas.SlotNumber,
+            timestamp: schemas.BigInt,
+            coinbase: schemas.EthAddress,
+            feeRecipient: schemas.AztecAddress,
+            gasFees: GasFees.schema
+        }).transform(GlobalVariables.from);
+    }
+    getSize() {
+        return this.toBuffer().length;
+    }
+    static from(fields) {
+        return new GlobalVariables(...GlobalVariables.getFields(fields));
+    }
+    /**
+   * Creates a GlobalVariables instance 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 GlobalVariables fields
+   * @returns A GlobalVariables instance
+   */ static fromPlainObject(obj) {
+        return new GlobalVariables(Fr.fromPlainObject(obj.chainId), Fr.fromPlainObject(obj.version), obj.blockNumber, SlotNumber(Fr.fromPlainObject(obj.slotNumber).toNumber()), typeof obj.timestamp === 'bigint' ? obj.timestamp : BigInt(obj.timestamp), EthAddress.fromPlainObject(obj.coinbase), AztecAddress.fromPlainObject(obj.feeRecipient), GasFees.fromPlainObject(obj.gasFees));
+    }
+    static empty(fields = {}) {
+        return GlobalVariables.from({
+            blockNumber: BlockNumber.ZERO,
+            slotNumber: SlotNumber.ZERO,
+            timestamp: 0n,
+            chainId: Fr.ZERO,
+            version: Fr.ZERO,
+            coinbase: EthAddress.ZERO,
+            feeRecipient: AztecAddress.ZERO,
+            gasFees: GasFees.empty(),
+            ...fields
+        });
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new GlobalVariables(Fr.fromBuffer(reader), Fr.fromBuffer(reader), BlockNumber(reader.readNumber()), SlotNumber(reader.readNumber()), reader.readUInt64(), reader.readObject(EthAddress), reader.readObject(AztecAddress), reader.readObject(GasFees));
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new GlobalVariables(reader.readField(), reader.readField(), BlockNumber(reader.readU32()), SlotNumber(reader.readU32()), reader.readField().toBigInt(), EthAddress.fromField(reader.readField()), AztecAddress.fromFieldUnsafe(reader.readField()), GasFees.fromFields(reader));
+    }
+    static getFields(fields) {
+        return [
+            fields.chainId,
+            fields.version,
+            fields.blockNumber,
+            fields.slotNumber,
+            fields.timestamp,
+            fields.coinbase,
+            fields.feeRecipient,
+            fields.gasFees
+        ];
+    }
+    toBuffer(sink) {
+        if (!sink) {
+            return BufferSink.serialize(this);
+        }
+        serializeToSink(sink, this.chainId, this.version, this.blockNumber, this.slotNumber);
+        sink.writeUInt64(this.timestamp);
+        serializeToSink(sink, this.coinbase, this.feeRecipient, this.gasFees);
+    }
+    toFields() {
+        const fields = serializeToFields(...GlobalVariables.getFields(this));
+        if (fields.length !== GLOBAL_VARIABLES_LENGTH) {
+            throw new Error(`Invalid number of fields for GlobalVariables. Expected ${GLOBAL_VARIABLES_LENGTH}, got ${fields.length}`);
+        }
+        return fields;
+    }
+    /**
+   * A trimmed version of the JSON representation of the global variables,
+   * tailored for human consumption.
+   */ toFriendlyJSON() {
+        return {
+            blockNumber: this.blockNumber,
+            slotNumber: this.slotNumber,
+            timestamp: this.timestamp.toString(),
+            coinbase: this.coinbase.toString(),
+            gasFees: jsonStringify(this.gasFees)
+        };
+    }
+    /**
+   * Converts GlobalVariables to a plain object suitable for MessagePack serialization.
+   * This method ensures that slotNumber is serialized as a Fr (Field element) to match
+   * the C++ struct definition which expects slot_number as FF.
+   */ toJSON() {
+        return {
+            chainId: this.chainId,
+            version: this.version,
+            blockNumber: this.blockNumber,
+            slotNumber: new Fr(this.slotNumber),
+            timestamp: this.timestamp,
+            coinbase: this.coinbase,
+            feeRecipient: this.feeRecipient,
+            gasFees: this.gasFees
+        };
+    }
+    clone() {
+        return GlobalVariables.fromBuffer(this.toBuffer());
+    }
+    isEmpty() {
+        return this.chainId.isZero() && this.version.isZero() && this.blockNumber === 0 && this.slotNumber === 0 && this.timestamp === 0n && this.coinbase.isZero() && this.feeRecipient.isZero() && this.gasFees.isEmpty();
+    }
+    static random(overrides = {}) {
+        return GlobalVariables.from({
+            chainId: new Fr(randomInt(100_000)),
+            version: new Fr(randomInt(100_000)),
+            blockNumber: BlockNumber(randomInt(100_000)),
+            slotNumber: SlotNumber(randomInt(100_000)),
+            coinbase: EthAddress.random(),
+            feeRecipient: AztecAddress.fromFieldUnsafe(Fr.random()),
+            gasFees: GasFees.random(),
+            timestamp: BigInt(randomInt(100_000_000)),
+            ...overrides
+        });
+    }
+    toInspect() {
+        return {
+            chainId: this.chainId.toNumber(),
+            version: this.version.toNumber(),
+            blockNumber: this.blockNumber,
+            slotNumber: this.slotNumber,
+            timestamp: this.timestamp,
+            coinbase: this.coinbase.toString(),
+            feeRecipient: this.feeRecipient.toString(),
+            feePerDaGas: Number(this.gasFees.feePerDaGas),
+            feePerL2Gas: Number(this.gasFees.feePerL2Gas)
+        };
+    }
+    [_computedKey]() {
+        return `GlobalVariables ${inspect(this.toInspect())}`;
+    }
+    equals(other) {
+        return this.chainId.equals(other.chainId) && this.version.equals(other.version) && this.blockNumber === other.blockNumber && this.slotNumber === other.slotNumber && this.timestamp === other.timestamp && this.coinbase.equals(other.coinbase) && this.feeRecipient.equals(other.feeRecipient) && this.gasFees.equals(other.gasFees);
+    }
+}

package/dest/tx/hashed_values.d.ts

@@ -0,0 +1,43 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader, BufferSink } from '@aztec-labs/foundation/serialize';
+import type { FieldsOf } from '@aztec-labs/foundation/types';
+import { type ZodFor } from '../schemas/schemas.js';
+/**
+ * A container for storing a list of values and their hash.
+ */
+export declare class HashedValues {
+    /**
+     *  Raw values.
+     */
+    readonly values: Fr[];
+    /**
+     * The hash of the raw values
+     */
+    readonly hash: Fr;
+    constructor(
+    /**
+     *  Raw values.
+     */
+    values: Fr[], 
+    /**
+     * The hash of the raw values
+     */
+    hash: Fr);
+    getSize(): number;
+    static get schema(): ZodFor<HashedValues>;
+    /**
+     * Returns a schema that additionally rejects more than `maxValues` values. The bound belongs to the caller
+     * rather than to this class: the same container carries public calldata, private call arguments and authwit
+     * arguments, and those have different limits.
+     */
+    static schemaFor(maxValues?: number): ZodFor<HashedValues>;
+    static from(fields: FieldsOf<HashedValues>): HashedValues;
+    static getFields(fields: FieldsOf<HashedValues>): readonly [Fr[], Fr];
+    static random(): HashedValues;
+    toBuffer(): Buffer;
+    toBuffer(sink: BufferSink): void;
+    static fromBuffer(buffer: Buffer | BufferReader): HashedValues;
+    static fromArgs(args: Fr[]): Promise<HashedValues>;
+    static fromCalldata(calldata: Fr[]): Promise<HashedValues>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGFzaGVkX3ZhbHVlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R4L2hhc2hlZF92YWx1ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQ3pELE9BQU8sRUFBRSxZQUFZLEVBQUUsVUFBVSxFQUFtQixNQUFNLGtDQUFrQyxDQUFDO0FBQzdGLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBSTdELE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBVyxNQUFNLHVCQUF1QixDQUFDO0FBRzdEOztHQUVHO0FBQ0gscUJBQWEsWUFBWTtJQUVyQjs7T0FFRzthQUNhLE1BQU0sRUFBRSxFQUFFLEVBQUU7SUFDNUI7O09BRUc7YUFDYSxJQUFJLEVBQUUsRUFBRTtJQVIxQjtJQUNFOztPQUVHO0lBQ2EsTUFBTSxFQUFFLEVBQUUsRUFBRTtJQUM1Qjs7T0FFRztJQUNhLElBQUksRUFBRSxFQUFFLEVBQ3RCO0lBRUosT0FBTyxXQUVOO0lBRUQsTUFBTSxLQUFLLE1BQU0sSUFBSSxNQUFNLENBQUMsWUFBWSxDQUFDLENBRXhDO0lBRUQ7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxTQUFTLENBQUMsU0FBUyxDQUFDLEVBQUUsTUFBTSxHQUFHLE1BQU0sQ0FBQyxZQUFZLENBQUMsQ0FHekQ7SUFFRCxNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsWUFBWSxDQUFDLEdBQUcsWUFBWSxDQUV4RDtJQUVELE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsQ0FBQyxZQUFZLENBQUMsdUJBRTlDO0lBRUQsTUFBTSxDQUFDLE1BQU0saUJBRVo7SUFFRCxRQUFRLElBQUksTUFBTSxDQUFDO0lBQ25CLFFBQVEsQ0FBQyxJQUFJLEVBQUUsVUFBVSxHQUFHLElBQUksQ0FBQztJQVFqQyxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxHQUFHLFlBQVksQ0FHN0Q7SUFHRCxPQUFhLFFBQVEsQ0FBQyxJQUFJLEVBQUUsRUFBRSxFQUFFLHlCQUUvQjtJQUdELE9BQWEsWUFBWSxDQUFDLFFBQVEsRUFBRSxFQUFFLEVBQUUseUJBRXZDO0NBQ0YifQ==

package/dest/tx/hashed_values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashed_values.d.ts","sourceRoot":"","sources":["../../src/tx/hashed_values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAmB,MAAM,kCAAkC,CAAC;AAC7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAI7D,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,uBAAuB,CAAC;AAG7D;;GAEG;AACH,qBAAa,YAAY;IAErB;;OAEG;aACa,MAAM,EAAE,EAAE,EAAE;IAC5B;;OAEG;aACa,IAAI,EAAE,EAAE;IAR1B;IACE;;OAEG;IACa,MAAM,EAAE,EAAE,EAAE;IAC5B;;OAEG;IACa,IAAI,EAAE,EAAE,EACtB;IAEJ,OAAO,WAEN;IAED,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,CAExC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAGzD;IAED,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY,CAExD;IAED,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,uBAE9C;IAED,MAAM,CAAC,MAAM,iBAEZ;IAED,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAQjC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAG7D;IAGD,OAAa,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,yBAE/B;IAGD,OAAa,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,yBAEvC;CACF"}

package/dest/tx/hashed_values.js

@@ -0,0 +1,70 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import { BufferReader, BufferSink, serializeToSink } from '@aztec-labs/foundation/serialize';
+import { z } from 'zod';
+import { computeCalldataHash, computeVarArgsHash } from '../hash/index.js';
+import { schemas } from '../schemas/schemas.js';
+import { Vector } from '../types/index.js';
+/**
+ * A container for storing a list of values and their hash.
+ */ export class HashedValues {
+    values;
+    hash;
+    constructor(/**
+     *  Raw values.
+     */ values, /**
+     * The hash of the raw values
+     */ hash){
+        this.values = values;
+        this.hash = hash;
+    }
+    getSize() {
+        return this.values.length + 1 /* hash */ ;
+    }
+    static get schema() {
+        return HashedValues.schemaFor();
+    }
+    /**
+   * Returns a schema that additionally rejects more than `maxValues` values. The bound belongs to the caller
+   * rather than to this class: the same container carries public calldata, private call arguments and authwit
+   * arguments, and those have different limits.
+   */ static schemaFor(maxValues) {
+        const values = maxValues === undefined ? z.array(schemas.Fr) : z.array(schemas.Fr).max(maxValues);
+        return z.object({
+            values,
+            hash: schemas.Fr
+        }).transform(HashedValues.from);
+    }
+    static from(fields) {
+        return new HashedValues(...HashedValues.getFields(fields));
+    }
+    static getFields(fields) {
+        return [
+            fields.values,
+            fields.hash
+        ];
+    }
+    static random() {
+        return new HashedValues([
+            Fr.random(),
+            Fr.random()
+        ], Fr.random());
+    }
+    toBuffer(sink) {
+        if (!sink) {
+            return BufferSink.serialize(this);
+        }
+        serializeToSink(sink, new Vector(this.values), this.hash);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        return new HashedValues(reader.readVector(Fr), Fr.fromBuffer(reader));
+    }
+    // Computes the hash of input arguments or return values for private functions, or for authwit creation.
+    static async fromArgs(args) {
+        return new HashedValues(args, await computeVarArgsHash(args));
+    }
+    // Computes the hash of calldata for public functions.
+    static async fromCalldata(calldata) {
+        return new HashedValues(calldata, await computeCalldataHash(calldata));
+    }
+}

package/dest/tx/in_tx.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { type InBlock } from '../block/in_block.js';
+import { TxHash } from './tx_hash.js';
+export type InTx = InBlock & {
+    txHash: TxHash;
+};
+export declare function randomInTx(): InTx;
+export declare function inTxSchema(): z.ZodIntersection<z.ZodObject<{
+    l2BlockNumber: 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<import("@aztec-labs/foundation/branded-types").BlockNumber, number>>;
+    l2BlockHash: import("@aztec-labs/foundation/schemas").ZodFor<import("../block/block_hash.js").BlockHash>;
+}, z.core.$strip>, z.ZodObject<{
+    txHash: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<Buffer<ArrayBuffer>, string>>, z.ZodTransform<TxHash, Buffer<ArrayBuffer>>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5fdHguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eC9pbl90eC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCLE9BQU8sRUFBRSxLQUFLLE9BQU8sRUFBZ0MsTUFBTSxzQkFBc0IsQ0FBQztBQUNsRixPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXRDLE1BQU0sTUFBTSxJQUFJLEdBQUcsT0FBTyxHQUFHO0lBQzNCLE1BQU0sRUFBRSxNQUFNLENBQUM7Q0FDaEIsQ0FBQztBQUVGLHdCQUFnQixVQUFVLElBQUksSUFBSSxDQUtqQztBQUVELHdCQUFnQixVQUFVOzs7OzttQkFPekIifQ==

package/dest/tx/in_tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in_tx.d.ts","sourceRoot":"","sources":["../../src/tx/in_tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,OAAO,EAAgC,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,UAAU,IAAI,IAAI,CAKjC;AAED,wBAAgB,UAAU;;;;;mBAOzB"}

package/dest/tx/in_tx.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { inBlockSchema, randomInBlock } from '../block/in_block.js';
+import { TxHash } from './tx_hash.js';
+export function randomInTx() {
+    return {
+        ...randomInBlock(),
+        txHash: TxHash.random()
+    };
+}
+export function inTxSchema() {
+    return z.intersection(inBlockSchema(), z.object({
+        txHash: TxHash.schema
+    }));
+}

package/dest/tx/index.d.ts

@@ -0,0 +1,35 @@
+export * from './block_header.js';
+export * from './call_context.js';
+export * from './global_variables.js';
+export * from './state_reference.js';
+export * from './partial_state_reference.js';
+export * from './function_data.js';
+export * from './tree_snapshots.js';
+export * from './private_tx_constant_data.js';
+export * from './tx_constant_data.js';
+export * from './tx_context.js';
+export * from './tx_request.js';
+export * from './private_execution_result.js';
+export * from './public_call_request_with_calldata.js';
+export * from './tx_hash.js';
+export * from './tx_receipt.js';
+export * from './tx.js';
+export * from './processed_tx.js';
+export * from './proven_tx.js';
+export * from './simulated_tx.js';
+export * from './tx_effect.js';
+export * from './public_simulation_output.js';
+export * from './tx_execution_request.js';
+export * from './validator/tx_validator.js';
+export * from './validator/error_texts.js';
+export * from './capsule.js';
+export * from './fee_provider.js';
+export * from './global_variable_builder.js';
+export * from './hashed_values.js';
+export * from './indexed_tx_effect.js';
+export * from './offchain_effect.js';
+export * from './profiling.js';
+export * from './protocol_contracts.js';
+export * from './execution_payload.js';
+export * from './in_tx.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsOEJBQThCLENBQUM7QUFDN0MsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLHdDQUF3QyxDQUFDO0FBQ3ZELGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxTQUFTLENBQUM7QUFDeEIsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLFlBQVksQ0FBQyJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tx/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wCAAwC,CAAC;AACvD,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC"}

package/dest/tx/index.js

@@ -0,0 +1,34 @@
+export * from './block_header.js';
+export * from './call_context.js';
+export * from './global_variables.js';
+export * from './state_reference.js';
+export * from './partial_state_reference.js';
+export * from './function_data.js';
+export * from './tree_snapshots.js';
+export * from './private_tx_constant_data.js';
+export * from './tx_constant_data.js';
+export * from './tx_context.js';
+export * from './tx_request.js';
+export * from './private_execution_result.js';
+export * from './public_call_request_with_calldata.js';
+export * from './tx_hash.js';
+export * from './tx_receipt.js';
+export * from './tx.js';
+export * from './processed_tx.js';
+export * from './proven_tx.js';
+export * from './simulated_tx.js';
+export * from './tx_effect.js';
+export * from './public_simulation_output.js';
+export * from './tx_execution_request.js';
+export * from './validator/tx_validator.js';
+export * from './validator/error_texts.js';
+export * from './capsule.js';
+export * from './fee_provider.js';
+export * from './global_variable_builder.js';
+export * from './hashed_values.js';
+export * from './indexed_tx_effect.js';
+export * from './offchain_effect.js';
+export * from './profiling.js';
+export * from './protocol_contracts.js';
+export * from './execution_payload.js';
+export * from './in_tx.js';

package/dest/tx/indexed_tx_effect.d.ts

@@ -0,0 +1,20 @@
+import { BlockNumber, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { BlockHash } from '../block/block_hash.js';
+import { type DataInBlock } from '../block/in_block.js';
+import { TxEffect } from './tx_effect.js';
+/** A tx effect together with its position in the block (`txIndexInBlock`) and the slot the block was built in. */
+export type IndexedTxEffect = DataInBlock<TxEffect> & {
+    txIndexInBlock: number;
+    slotNumber: SlotNumber;
+};
+export declare function indexedTxSchema(): import("zod").ZodObject<{
+    l2BlockNumber: import("zod").ZodPipe<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodPipe<import("zod").ZodBigInt, import("zod").ZodTransform<number, bigint>>, import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<number, string>>]>, import("zod").ZodTransform<BlockNumber, number>>;
+    l2BlockHash: import("@aztec-labs/foundation/schemas").ZodFor<BlockHash>;
+    data: import("@aztec-labs/foundation/schemas").ZodFor<TxEffect>;
+    txIndexInBlock: import("zod").ZodPipe<import("zod").ZodUnion<readonly [import("zod").ZodBigInt, import("zod").ZodNumber, import("zod").ZodString]>, import("zod").ZodCoercedNumber<string | number | bigint>>;
+    slotNumber: import("zod").ZodPipe<import("zod").ZodPipe<import("zod").ZodUnion<readonly [import("zod").ZodNumber, import("zod").ZodBigInt, import("zod").ZodString]>, import("zod").ZodCoercedNumber<string | number | bigint>>, import("zod").ZodTransform<SlotNumber, number>>;
+}, import("zod/v4/core").$strip>;
+export declare function randomIndexedTxEffect(): Promise<IndexedTxEffect>;
+export declare function serializeIndexedTxEffect(effect: IndexedTxEffect): Buffer;
+export declare function deserializeIndexedTxEffect(buffer: Buffer): IndexedTxEffect;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZF90eF9lZmZlY3QuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eC9pbmRleGVkX3R4X2VmZmVjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLFVBQVUsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBSS9FLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNuRCxPQUFPLEVBQUUsS0FBSyxXQUFXLEVBQTJDLE1BQU0sc0JBQXNCLENBQUM7QUFDakcsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRTFDLGtIQUFrSDtBQUNsSCxNQUFNLE1BQU0sZUFBZSxHQUFHLFdBQVcsQ0FBQyxRQUFRLENBQUMsR0FBRztJQUFFLGNBQWMsRUFBRSxNQUFNLENBQUM7SUFBQyxVQUFVLEVBQUUsVUFBVSxDQUFBO0NBQUUsQ0FBQztBQUV6Ryx3QkFBZ0IsZUFBZTs7Ozs7O2lDQUs5QjtBQUVELHdCQUFzQixxQkFBcUIsSUFBSSxPQUFPLENBQUMsZUFBZSxDQUFDLENBTXRFO0FBRUQsd0JBQWdCLHdCQUF3QixDQUFDLE1BQU0sRUFBRSxlQUFlLEdBQUcsTUFBTSxDQVF4RTtBQUVELHdCQUFnQiwwQkFBMEIsQ0FBQyxNQUFNLEVBQUUsTUFBTSxHQUFHLGVBQWUsQ0FnQjFFIn0=

package/dest/tx/indexed_tx_effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed_tx_effect.d.ts","sourceRoot":"","sources":["../../src/tx/indexed_tx_effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAI/E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,KAAK,WAAW,EAA2C,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,kHAAkH;AAClH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzG,wBAAgB,eAAe;;;;;;iCAK9B;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMtE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAQxE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAgB1E"}

package/dest/tx/indexed_tx_effect.js

@@ -0,0 +1,39 @@
+import { BlockNumber, SlotNumber } from '@aztec-labs/foundation/branded-types';
+import { schemas } from '@aztec-labs/foundation/schemas';
+import { BufferReader, serializeToBuffer } from '@aztec-labs/foundation/serialize';
+import { BlockHash } from '../block/block_hash.js';
+import { dataInBlockSchemaFor, randomDataInBlock } from '../block/in_block.js';
+import { TxEffect } from './tx_effect.js';
+export function indexedTxSchema() {
+    return dataInBlockSchemaFor(TxEffect.schema).extend({
+        txIndexInBlock: schemas.Integer,
+        slotNumber: schemas.SlotNumber
+    });
+}
+export async function randomIndexedTxEffect() {
+    return {
+        ...randomDataInBlock(await TxEffect.random({
+            numNullifiers: 1 + Math.floor(Math.random() * 64)
+        })),
+        txIndexInBlock: Math.floor(Math.random() * 1000),
+        slotNumber: SlotNumber(Math.floor(Math.random() * 1000))
+    };
+}
+export function serializeIndexedTxEffect(effect) {
+    return serializeToBuffer(effect.l2BlockHash, effect.l2BlockNumber, effect.txIndexInBlock, effect.slotNumber, effect.data);
+}
+export function deserializeIndexedTxEffect(buffer) {
+    const reader = BufferReader.asReader(buffer);
+    const l2BlockHash = BlockHash.fromBuffer(reader);
+    const l2BlockNumber = BlockNumber(reader.readNumber());
+    const txIndexInBlock = reader.readNumber();
+    const slotNumber = SlotNumber(reader.readNumber());
+    const data = reader.readObject(TxEffect);
+    return {
+        l2BlockHash,
+        l2BlockNumber,
+        txIndexInBlock,
+        slotNumber,
+        data
+    };
+}

package/dest/tx/offchain_effect.d.ts

@@ -0,0 +1,14 @@
+import { Fr } from '@aztec-labs/foundation/curves/bn254';
+import type { AztecAddress } from '../aztec-address/index.js';
+export declare const OFFCHAIN_MESSAGE_IDENTIFIER: Fr;
+/**
+ * Represents an offchain effect emitted via the `emit_offchain_effect` oracle (see the oracle documentation for
+ * more details).
+ */
+export type OffchainEffect = {
+    /** The emitted data */
+    data: Fr[];
+    /** The contract that emitted the data */
+    contractAddress: AztecAddress;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2ZmY2hhaW5fZWZmZWN0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHgvb2ZmY2hhaW5fZWZmZWN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUV6RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUk5RCxlQUFPLE1BQU0sMkJBQTJCLEVBQUUsRUFFekMsQ0FBQztBQUVGOzs7R0FHRztBQUNILE1BQU0sTUFBTSxjQUFjLEdBQUc7SUFDM0IsdUJBQXVCO0lBQ3ZCLElBQUksRUFBRSxFQUFFLEVBQUUsQ0FBQztJQUNYLHlDQUF5QztJQUN6QyxlQUFlLEVBQUUsWUFBWSxDQUFDO0NBQy9CLENBQUMifQ==

package/dest/tx/offchain_effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offchain_effect.d.ts","sourceRoot":"","sources":["../../src/tx/offchain_effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,eAAO,MAAM,2BAA2B,EAAE,EAEzC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,uBAAuB;IACvB,IAAI,EAAE,EAAE,EAAE,CAAC;IACX,yCAAyC;IACzC,eAAe,EAAE,YAAY,CAAC;CAC/B,CAAC"}