@aztec/stdlib 0.0.0-test.1 → 0.0.1-commit.5476d83

package/dest/l1-contracts/slash_factory.js

@@ -0,0 +1,157 @@
+import { tryExtractEvent } from '@aztec/ethereum';
+import { maxBigint } from '@aztec/foundation/bigint';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { createLogger } from '@aztec/foundation/log';
+import { SlashFactoryAbi } from '@aztec/l1-artifacts/SlashFactoryAbi';
+import { encodeFunctionData, getContract } from 'viem';
+import { OffenseToBigInt, bigIntToOffense } from '../slashing/index.js';
+export class SlashFactoryContract {
+    client;
+    logger;
+    contract;
+    constructor(client, address){
+        this.client = client;
+        this.logger = createLogger('contracts:slash_factory');
+        this.contract = getContract({
+            address: typeof address === 'string' ? address : address.toString(),
+            abi: SlashFactoryAbi,
+            client
+        });
+    }
+    get address() {
+        return EthAddress.fromString(this.contract.address);
+    }
+    buildCreatePayloadRequest(slashes) {
+        const sorted = this.sortSlashes(slashes);
+        return {
+            to: this.contract.address,
+            data: encodeFunctionData({
+                abi: SlashFactoryAbi,
+                functionName: 'createSlashPayload',
+                args: [
+                    sorted.map((d)=>d.validator.toString()),
+                    sorted.map((d)=>d.amount),
+                    sorted.map((d)=>d.offenses.map(packValidatorSlashOffense))
+                ]
+            })
+        };
+    }
+    /** Tries to extract a SlashPayloadCreated event from the given logs. */ tryExtractSlashPayloadCreatedEvent(logs) {
+        return tryExtractEvent(logs, this.address.toString(), SlashFactoryAbi, 'SlashPayloadCreated');
+    }
+    async getSlashPayloadCreatedEvents() {
+        const events = await this.contract.getEvents.SlashPayloadCreated();
+        return Promise.all(events.map(async (event)=>{
+            const { validators, amounts, offenses } = event.args;
+            const slashes = validators.map((validator, i)=>({
+                    validator: EthAddress.fromString(validator),
+                    amount: amounts[i],
+                    offenses: offenses[i].map(unpackValidatorSlashOffense)
+                }));
+            const block = await this.client.getBlock({
+                blockNumber: event.blockNumber,
+                includeTransactions: false
+            });
+            return {
+                address: EthAddress.fromString(event.args.payloadAddress),
+                slashes,
+                timestamp: block.timestamp
+            };
+        }));
+    }
+    /**
+   * Searches for a slash payload in the events emitted by the contract.
+   * This method cannot query for historical payload events, it queries for payloads that have not yet expired.
+   * @param payloadAddress The address of the payload to search for.
+   * @param constants The L1 rollup constants needed for time calculations.
+   */ async getSlashPayloadFromEvents(payloadAddress, settings) {
+        // We query for the log where the payload was emitted walking backwards until we go past payload expiration time
+        // Note that all log queries require a block range, and RPC providers cap the max range (eg quicknode is 10k blocks).
+        const { slashingRoundSize, slashingPayloadLifetimeInRounds, slotDuration, ethereumSlotDuration } = settings;
+        const currentBlockNumber = await this.client.getBlockNumber({
+            cacheTime: 0
+        });
+        // Why the +1 below? Just for good measure. Better err on the safe side.
+        const earliestBlockNumber = maxBigint(0n, currentBlockNumber - (BigInt(slashingPayloadLifetimeInRounds) + 1n) * BigInt(slashingRoundSize) * BigInt(slotDuration) / BigInt(ethereumSlotDuration));
+        this.logger.trace(`Starting search for slash payload ${payloadAddress} from block ${currentBlockNumber} with earliest block ${earliestBlockNumber}`);
+        const batchSize = BigInt(settings.logsBatchSize ?? 10000);
+        let toBlock = currentBlockNumber;
+        do {
+            const fromBlock = maxBigint(earliestBlockNumber, toBlock - batchSize);
+            this.logger.trace(`Searching for slash payload ${payloadAddress} in blocks ${fromBlock} to ${toBlock}`);
+            const logs = await this.contract.getEvents.SlashPayloadCreated({
+                payloadAddress: payloadAddress.toString()
+            }, {
+                fromBlock,
+                toBlock,
+                strict: true
+            });
+            // We found the payload, return it
+            if (logs.length > 0) {
+                const log = logs[0];
+                const { validators, amounts, offenses } = log.args;
+                // Convert the data to our internal types
+                const slashes = validators.map((validator, i)=>({
+                        validator: EthAddress.fromString(validator),
+                        amount: amounts[i],
+                        offenses: offenses[i].map(unpackValidatorSlashOffense)
+                    }));
+                // Get the timestamp from the block
+                const block = await this.client.getBlock({
+                    blockNumber: log.blockNumber,
+                    includeTransactions: false
+                });
+                return {
+                    address: payloadAddress,
+                    slashes,
+                    timestamp: block.timestamp
+                };
+            }
+            // If not found, we go back one batch
+            toBlock -= batchSize;
+        }while (toBlock > earliestBlockNumber)
+        return undefined;
+    }
+    async getAddressAndIsDeployed(slashes) {
+        const sortedSlashes = this.sortSlashes(slashes);
+        const [address, salt, isDeployed] = await this.contract.read.getAddressAndIsDeployed([
+            sortedSlashes.map((s)=>s.validator.toString()),
+            sortedSlashes.map((s)=>s.amount),
+            sortedSlashes.map((s)=>s.offenses.map(packValidatorSlashOffense))
+        ]);
+        return {
+            address: EthAddress.fromString(address),
+            salt,
+            isDeployed
+        };
+    }
+    sortSlashes(slashes) {
+        const offenseSorter = (a, b)=>{
+            return a.epochOrSlot === b.epochOrSlot ? a.offenseType - b.offenseType : Number(a.epochOrSlot - b.epochOrSlot);
+        };
+        return [
+            ...slashes
+        ].map((slash)=>({
+                ...slash,
+                offenses: [
+                    ...slash.offenses
+                ].sort(offenseSorter)
+            })).sort((a, b)=>a.validator.toString().localeCompare(b.validator.toString()));
+    }
+}
+export function packValidatorSlashOffense(offense) {
+    const offenseId = OffenseToBigInt[offense.offenseType];
+    if (offenseId > (1 << 8) - 1) {
+        throw new Error(`Offense type ${offense.offenseType} cannot be packed into 8 bits`);
+    }
+    return (offenseId << 120n) + offense.epochOrSlot;
+}
+export function unpackValidatorSlashOffense(packed) {
+    const offenseId = packed >> 120n & 0xffn;
+    const epochOrSlot = packed & (1n << 120n) - 1n;
+    const offenseType = bigIntToOffense(offenseId);
+    return {
+        epochOrSlot,
+        offenseType
+    };
+}

package/dest/logs/contract_class_log.d.ts

@@ -1,44 +1,98 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { Fr } from '@aztec/foundation/fields';
 import { BufferReader, FieldReader } from '@aztec/foundation/serialize';
+import type { FieldsOf } from '@aztec/foundation/types';
 import { inspect } from 'util';
 import { z } from 'zod';
 import { AztecAddress } from '../aztec-address/index.js';
+export declare class ContractClassLogFields {
+    fields: Fr[];
+    constructor(fields: Fr[]);
+    static get schema(): z.ZodEffects<z.ZodObject<{
+        fields: z.ZodEffects<z.ZodArray<z.ZodType<Fr, any, string>, "many">, Fr[], string[]>;
+    }, "strip", z.ZodTypeAny, {
+        fields: Fr[];
+    }, {
+        fields: string[];
+    }>, ContractClassLogFields, {
+        fields: string[];
+    }>;
+    /**
+     * 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: any): ContractClassLogFields;
+    toFields(): Fr[];
+    static fromFields(fields: Fr[] | FieldReader): ContractClassLogFields;
+    toBuffer(): Buffer<ArrayBufferLike>;
+    static fromBuffer(buffer: Buffer | BufferReader): ContractClassLogFields;
+    equals(other: ContractClassLogFields): boolean;
+    getEmittedFields(emittedLength: number): Fr[];
+    static fromEmittedFields(emittedFields: Fr[]): ContractClassLogFields;
+    isEmpty(): boolean;
+    static empty(): ContractClassLogFields;
+    static random(emittedLength?: number): ContractClassLogFields;
+    hash(): Promise<Fr>;
+    clone(): ContractClassLogFields;
+}
 export declare class ContractClassLog {
     contractAddress: AztecAddress;
-    fields: Fr[];
+    fields: ContractClassLogFields;
+    emittedLength: number;
     static SIZE_IN_BYTES: number;
-    unsiloedFirstField?: Fr | undefined;
-    constructor(contractAddress: AztecAddress, fields: Fr[]);
+    constructor(contractAddress: AztecAddress, fields: ContractClassLogFields, emittedLength: number);
+    static from(fields: FieldsOf<ContractClassLog>): ContractClassLog;
     toFields(): Fr[];
+    equals(other: ContractClassLog): boolean;
     static fromFields(fields: Fr[] | FieldReader): ContractClassLog;
+    getEmittedFields(): Fr[];
+    toBlobFields(): Fr[];
+    static fromBlobFields(emittedLength: number, fields: Fr[] | FieldReader): ContractClassLog;
     isEmpty(): boolean;
     static empty(): ContractClassLog;
     toBuffer(): Buffer;
     static fromBuffer(buffer: Buffer | BufferReader): ContractClassLog;
-    clone(): ContractClassLog;
     static random(): Promise<ContractClassLog>;
-    getEmittedLength(): number;
-    getEmittedFields(): Fr[];
-    setUnsiloedFirstField(field: Fr): void;
-    toUnsiloed(): ContractClassLog;
-    silo(): Promise<ContractClassLog>;
     hash(): Promise<Fr>;
     static get schema(): z.ZodEffects<z.ZodObject<{
         contractAddress: import("@aztec/foundation/schemas").ZodFor<AztecAddress>;
-        fields: z.ZodArray<z.ZodType<Fr, any, string>, "many">;
+        fields: z.ZodEffects<z.ZodObject<{
+            fields: z.ZodEffects<z.ZodArray<z.ZodType<Fr, any, string>, "many">, Fr[], string[]>;
+        }, "strip", z.ZodTypeAny, {
+            fields: Fr[];
+        }, {
+            fields: string[];
+        }>, ContractClassLogFields, {
+            fields: string[];
+        }>;
+        emittedLength: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        fields: Fr[];
         contractAddress: AztecAddress;
+        fields: ContractClassLogFields;
+        emittedLength: number;
     }, {
-        fields: string[];
         contractAddress?: any;
+        fields: {
+            fields: string[];
+        };
+        emittedLength: number;
     }>, ContractClassLog, {
-        fields: string[];
         contractAddress?: any;
+        fields: {
+            fields: string[];
+        };
+        emittedLength: number;
     }>;
+    /**
+     * 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: any): ContractClassLog;
     [inspect.custom](): string;
 }
-//# sourceMappingURL=contract_class_log.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3RfY2xhc3NfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9jb250cmFjdF9jbGFzc19sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRTlDLE9BQU8sRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUF3QyxNQUFNLDZCQUE2QixDQUFDO0FBQzlHLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBRXhELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFDL0IsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFFekQscUJBQWEsc0JBQXNCO0lBR2QsTUFBTSxFQUFFLEVBQUUsRUFBRTtJQUEvQixZQUFtQixNQUFNLEVBQUUsRUFBRSxFQUFFLEVBTTlCO0lBRUQsTUFBTSxLQUFLLE1BQU07Ozs7Ozs7O09BTWhCO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsTUFBTSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxHQUFHLHNCQUFzQixDQUt2RDtJQUVELFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FFZjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxHQUFHLFdBQVcsMEJBTzNDO0lBRUQsUUFBUSw0QkFFUDtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLDBCQU85QztJQUVELE1BQU0sQ0FBQyxLQUFLLEVBQUUsc0JBQXNCLFdBRW5DO0lBRUQsZ0JBQWdCLENBQUMsYUFBYSxFQUFFLE1BQU0sUUFFckM7SUFFRCxNQUFNLENBQUMsaUJBQWlCLENBQUMsYUFBYSxFQUFFLEVBQUUsRUFBRSwwQkFJM0M7SUFFRCxPQUFPLFlBRU47SUFFRCxNQUFNLENBQUMsS0FBSywyQkFFWDtJQUVELE1BQU0sQ0FBQyxNQUFNLENBQUMsYUFBYSxTQUFvQywwQkFNOUQ7SUFFSyxJQUFJLGdCQUVUO0lBRUQsS0FBSywyQkFFSjtDQUNGO0FBRUQscUJBQWEsZ0JBQWdCO0lBSWxCLGVBQWUsRUFBRSxZQUFZO0lBQzdCLE1BQU0sRUFBRSxzQkFBc0I7SUFDOUIsYUFBYSxFQUFFLE1BQU07SUFMOUIsTUFBTSxDQUFDLGFBQWEsU0FBZ0Q7SUFFcEUsWUFDUyxlQUFlLEVBQUUsWUFBWSxFQUM3QixNQUFNLEVBQUUsc0JBQXNCLEVBQzlCLGFBQWEsRUFBRSxNQUFNLEVBQzFCO0lBRUosTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsUUFBUSxDQUFDLGdCQUFnQixDQUFDLG9CQUU3QztJQUVELFFBQVEsSUFBSSxFQUFFLEVBQUUsQ0FFZjtJQUVELE1BQU0sQ0FBQyxLQUFLLEVBQUUsZ0JBQWdCLFdBTTdCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxFQUFFLEdBQUcsV0FBVyxvQkFPM0M7SUFFRCxnQkFBZ0IsU0FFZjtJQUVELFlBQVksSUFBSSxFQUFFLEVBQUUsQ0FFbkI7SUFFRCxNQUFNLENBQUMsY0FBYyxDQUFDLGFBQWEsRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxHQUFHLFdBQVcsb0JBU3RFO0lBRUQsT0FBTyxZQUVOO0lBRUQsTUFBTSxDQUFDLEtBQUsscUJBRVg7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLG9CQU05QztJQUVELE9BQWEsTUFBTSw4QkFRbEI7SUFFSyxJQUFJLGdCQUVUO0lBRUQsTUFBTSxLQUFLLE1BQU07Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FRaEI7SUFFRDs7Ozs7O09BTUc7SUFDSCxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEdBQUcsZ0JBQWdCLENBU2pEO0lBRUQsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLElBQUksTUFBTSxDQU16QjtDQUNGIn0=

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

@@ -1 +1 @@
-{"version":3,"file":"contract_class_log.d.ts","sourceRoot":"","sources":["../../src/logs/contract_class_log.ts"],"names":[],"mappings":";;;AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAqB,MAAM,6BAA6B,CAAC;AAE3F,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,gBAAgB;IAOR,eAAe,EAAE,YAAY;IAAS,MAAM,EAAE,EAAE,EAAE;IANrE,MAAM,CAAC,aAAa,SAAwD;IAErE,kBAAkB,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC;gBAIxB,eAAe,EAAE,YAAY,EAAS,MAAM,EAAE,EAAE,EAAE;IAQrE,QAAQ,IAAI,EAAE,EAAE;IAIhB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW;IAU5C,OAAO;IAIP,MAAM,CAAC,KAAK;IAIZ,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAW/C,KAAK;WAIQ,MAAM;IAWnB,gBAAgB;IAOhB,gBAAgB;IAKhB,qBAAqB,CAAC,KAAK,EAAE,EAAE;IAI/B,UAAU;IAQJ,IAAI;IAUJ,IAAI;IAIV,MAAM,KAAK,MAAM;;;;;;;;;;;;OAOhB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAK3B"}
+{"version":3,"file":"contract_class_log.d.ts","sourceRoot":"","sources":["../../src/logs/contract_class_log.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAwC,MAAM,6BAA6B,CAAC;AAC9G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,sBAAsB;IAGd,MAAM,EAAE,EAAE,EAAE;IAA/B,YAAmB,MAAM,EAAE,EAAE,EAAE,EAM9B;IAED,MAAM,KAAK,MAAM;;;;;;;;OAMhB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,sBAAsB,CAKvD;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,0BAO3C;IAED,QAAQ,4BAEP;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,0BAO9C;IAED,MAAM,CAAC,KAAK,EAAE,sBAAsB,WAEnC;IAED,gBAAgB,CAAC,aAAa,EAAE,MAAM,QAErC;IAED,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,EAAE,EAAE,0BAI3C;IAED,OAAO,YAEN;IAED,MAAM,CAAC,KAAK,2BAEX;IAED,MAAM,CAAC,MAAM,CAAC,aAAa,SAAoC,0BAM9D;IAEK,IAAI,gBAET;IAED,KAAK,2BAEJ;CACF;AAED,qBAAa,gBAAgB;IAIlB,eAAe,EAAE,YAAY;IAC7B,MAAM,EAAE,sBAAsB;IAC9B,aAAa,EAAE,MAAM;IAL9B,MAAM,CAAC,aAAa,SAAgD;IAEpE,YACS,eAAe,EAAE,YAAY,EAC7B,MAAM,EAAE,sBAAsB,EAC9B,aAAa,EAAE,MAAM,EAC1B;IAEJ,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,oBAE7C;IAED,QAAQ,IAAI,EAAE,EAAE,CAEf;IAED,MAAM,CAAC,KAAK,EAAE,gBAAgB,WAM7B;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,oBAO3C;IAED,gBAAgB,SAEf;IAED,YAAY,IAAI,EAAE,EAAE,CAEnB;IAED,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,oBAStE;IAED,OAAO,YAEN;IAED,MAAM,CAAC,KAAK,qBAEX;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,oBAM9C;IAED,OAAa,MAAM,8BAQlB;IAEK,IAAI,gBAET;IAED,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAQhB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CASjD;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAMzB;CACF"}

package/dest/logs/contract_class_log.js

@@ -1,125 +1,180 @@
-import { CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS, CONTRACT_CLASS_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
+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 { schemas } from '@aztec/foundation/schemas';
-import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
 import { inspect } from 'util';
 import { z } from 'zod';
 import { AztecAddress } from '../aztec-address/index.js';
-export class ContractClassLog {
-    contractAddress;
+export class ContractClassLogFields {
     fields;
-    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * CONTRACT_CLASS_LOG_SIZE_IN_FIELDS;
-    // Keeps original first field pre-siloing. Only set by silo().
-    unsiloedFirstField;
     // Below line gives error 'Type instantiation is excessively deep and possibly infinite. ts(2589)'
-    // public fields: Tuple<Fr, typeof CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS>
-    constructor(contractAddress, fields){
-        this.contractAddress = contractAddress;
+    // public fields: Tuple<Fr, typeof CONTRACT_CLASS_LOG_SIZE_IN_FIELDS>
+    constructor(fields){
         this.fields = fields;
-        if (fields.length !== CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS) {
-            throw new Error(`Invalid number of fields for ContractClassLog. Expected ${CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS}, got ${fields.length}`);
+        if (fields.length !== CONTRACT_CLASS_LOG_SIZE_IN_FIELDS) {
+            throw new Error(`Invalid number of fields for ContractClassLog. Expected ${CONTRACT_CLASS_LOG_SIZE_IN_FIELDS}, got ${fields.length}`);
+        }
+    }
+    static get schema() {
+        return z.object({
+            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.contractAddress.toField(),
-            ...this.fields
-        ];
+        return this.fields;
     }
     static fromFields(fields) {
         const reader = FieldReader.asReader(fields);
         // Below line gives error 'Type instantiation is excessively deep and possibly infinite. ts(2589)'
-        // return new ContractClassLog(reader.readFieldArray(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS));
-        return new ContractClassLog(reader.readObject(AztecAddress), Array.from({
-            length: CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS
+        // reader.readFieldArray(CONTRACT_CLASS_LOG_LENGTH);
+        return new ContractClassLogFields(Array.from({
+            length: CONTRACT_CLASS_LOG_SIZE_IN_FIELDS
         }, ()=>reader.readField()));
     }
+    toBuffer() {
+        return serializeToBuffer(this.fields);
+    }
+    static fromBuffer(buffer) {
+        const reader = BufferReader.asReader(buffer);
+        // Below line gives error 'Type instantiation is excessively deep and possibly infinite. ts(2589)'
+        // reader.readArray(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS, Fr)
+        return new ContractClassLogFields(Array.from({
+            length: CONTRACT_CLASS_LOG_SIZE_IN_FIELDS
+        }, ()=>reader.readObject(Fr)));
+    }
+    equals(other) {
+        return this.fields.every((f, i)=>f.equals(other.fields[i]));
+    }
+    getEmittedFields(emittedLength) {
+        return this.fields.slice(0, emittedLength);
+    }
+    static fromEmittedFields(emittedFields) {
+        return new ContractClassLogFields(emittedFields.concat(Array(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS - emittedFields.length).fill(Fr.ZERO)));
+    }
     isEmpty() {
         return this.fields.every((f)=>f.isZero());
     }
     static empty() {
-        return new ContractClassLog(AztecAddress.ZERO, new Array(CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS).fill(Fr.ZERO));
+        return new ContractClassLogFields(Array(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS).fill(Fr.ZERO));
+    }
+    static random(emittedLength = CONTRACT_CLASS_LOG_SIZE_IN_FIELDS) {
+        return new ContractClassLogFields(Array.from({
+            length: emittedLength
+        }, ()=>Fr.random()).concat(Array(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS - emittedLength).fill(Fr.ZERO)));
+    }
+    async hash() {
+        return await poseidon2Hash(this.fields);
+    }
+    clone() {
+        return ContractClassLogFields.fromBuffer(this.toBuffer());
+    }
+}
+export class ContractClassLog {
+    contractAddress;
+    fields;
+    emittedLength;
+    static SIZE_IN_BYTES = Fr.SIZE_IN_BYTES * CONTRACT_CLASS_LOG_LENGTH;
+    constructor(contractAddress, fields, emittedLength){
+        this.contractAddress = contractAddress;
+        this.fields = fields;
+        this.emittedLength = emittedLength;
+    }
+    static from(fields) {
+        return new ContractClassLog(fields.contractAddress, fields.fields, fields.emittedLength);
+    }
+    toFields() {
+        return serializeToFields([
+            this.contractAddress,
+            this.fields,
+            this.emittedLength
+        ]);
+    }
+    equals(other) {
+        return this.contractAddress.equals(other.contractAddress) && this.fields.equals(other.fields) && this.emittedLength === other.emittedLength;
+    }
+    static fromFields(fields) {
+        const reader = FieldReader.asReader(fields);
+        return new ContractClassLog(reader.readObject(AztecAddress), reader.readObject(ContractClassLogFields), reader.readU32());
+    }
+    getEmittedFields() {
+        return this.fields.getEmittedFields(this.emittedLength);
+    }
+    toBlobFields() {
+        return [
+            this.contractAddress.toField()
+        ].concat(this.getEmittedFields());
+    }
+    static fromBlobFields(emittedLength, fields) {
+        const reader = FieldReader.asReader(fields);
+        const contractAddress = reader.readObject(AztecAddress);
+        const emittedFields = reader.readFieldArray(emittedLength);
+        return new ContractClassLog(contractAddress, ContractClassLogFields.fromEmittedFields(emittedFields), emittedLength);
+    }
+    isEmpty() {
+        return this.contractAddress.isZero() && this.fields.isEmpty() && this.emittedLength === 0;
+    }
+    static empty() {
+        return new ContractClassLog(AztecAddress.ZERO, ContractClassLogFields.empty(), 0);
     }
     toBuffer() {
         return serializeToBuffer([
             this.contractAddress,
-            this.fields
+            this.fields,
+            this.emittedLength
         ]);
     }
     static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
-        // Below line gives error 'Type instantiation is excessively deep and possibly infinite. ts(2589)'
-        // reader.readArray(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS, Fr);
         const address = reader.readObject(AztecAddress);
-        const fields = Array.from({
-            length: CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS
-        }, ()=>reader.remainingBytes() == 0 ? Fr.ZERO : Fr.fromBuffer(reader));
-        return new ContractClassLog(address, fields);
-    }
-    clone() {
-        return ContractClassLog.fromBuffer(this.toBuffer());
+        const fields = ContractClassLogFields.fromBuffer(reader);
+        const emittedLength = reader.readNumber();
+        return new ContractClassLog(address, fields, emittedLength);
     }
     static async random() {
         // NB: Using half the maximum number of fields per log because max fields keeps overfilling blobs in tests.
-        // Below line gives error 'Type instantiation is excessively deep and possibly infinite. ts(2589)'
-        // makeTuple(CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS, Fr.random);
-        const fields = Array.from({
-            length: Math.ceil(CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS / 2)
-        }, ()=>Fr.random());
-        return new ContractClassLog(await AztecAddress.random(), fields.concat(Array.from({
-            length: Math.floor(CONTRACT_CLASS_LOG_DATA_SIZE_IN_FIELDS / 2)
-        }, ()=>Fr.ZERO)));
-    }
-    getEmittedLength() {
-        // This assumes that we cut trailing zeroes from the end of the log. In ts, these will always be added back.
-        // Does not include address or length prefix.
-        // Note: Unlike public logs, address is not included here because it is not included in the log itself.
-        return this.getEmittedFields().length;
-    }
-    getEmittedFields() {
-        const lastNonZeroIndex = this.fields.findLastIndex((f)=>!f.isZero());
-        return this.fields.slice(0, lastNonZeroIndex + 1);
-    }
-    setUnsiloedFirstField(field) {
-        this.unsiloedFirstField = field;
-    }
-    toUnsiloed() {
-        if (this.unsiloedFirstField) {
-            return new ContractClassLog(this.contractAddress, [
-                this.unsiloedFirstField
-            ].concat(this.fields.slice(1)));
-        } else {
-            return this;
-        }
-    }
-    async silo() {
-        const innerLog = this.clone();
-        if (innerLog.contractAddress.isZero()) {
-            return innerLog;
-        }
-        innerLog.setUnsiloedFirstField(innerLog.fields[0]);
-        innerLog.fields[0] = await poseidon2Hash([
-            innerLog.contractAddress,
-            innerLog.fields[0]
-        ]);
-        return innerLog;
+        const emittedLength = Math.ceil(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS / 2);
+        return new ContractClassLog(await AztecAddress.random(), ContractClassLogFields.random(emittedLength), emittedLength);
     }
     async hash() {
-        return await poseidon2Hash(this.fields);
+        return await this.fields.hash();
     }
     static get schema() {
         return z.object({
             contractAddress: AztecAddress.schema,
-            fields: z.array(schemas.Fr)
-        }).transform(({ contractAddress, fields })=>ContractClassLog.fromFields([
-                contractAddress.toField(),
-                ...fields
-            ]));
+            fields: ContractClassLogFields.schema,
+            emittedLength: z.number()
+        }).transform(ContractClassLog.from);
+    }
+    /**
+   * 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);
     }
     [inspect.custom]() {
         return `ContractClassLog {
-      fields: [${this.fields.map((x)=>inspect(x)).join(', ')}],
+      contractAddress: ${this.contractAddress.toString()},
+      emittedLength: ${this.emittedLength},
+      fields: [${this.fields.fields.map((x)=>inspect(x)).join(', ')}],
     }`;
     }
 }

package/dest/logs/debug_log.d.ts

@@ -0,0 +1,21 @@
+import { Fr } from '@aztec/foundation/fields';
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWdfbG9nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9kZWJ1Z19sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxLQUFLLFFBQVEsRUFBYSxNQUFNLHVCQUF1QixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBVyxNQUFNLDJCQUEyQixDQUFDO0FBSWpFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUt6RCxxQkFBYSxRQUFRO0lBRVYsZUFBZSxFQUFFLFlBQVk7SUFDN0IsS0FBSyxFQUFFLFFBQVE7SUFDZixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxFQUFFLEVBQUU7SUFKckIsWUFDUyxlQUFlLEVBQUUsWUFBWSxFQUM3QixLQUFLLEVBQUUsUUFBUSxFQUNmLE9BQU8sRUFBRSxNQUFNLEVBQ2YsTUFBTSxFQUFFLEVBQUUsRUFBRSxFQUNqQjtJQUVKLE1BQU0sS0FBSyxNQUFNLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQVdwQztJQUVEOzs7Ozs7T0FNRztJQUNILE1BQU0sQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLEdBQUcsR0FBRyxRQUFRLENBVXpDO0NBQ0YifQ==

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,0BAA0B,CAAC;AAC9C,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/fields';
+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/directional_app_tagging_secret.d.ts

@@ -0,0 +1,40 @@
+import { type Fq, Fr } from '@aztec/foundation/fields';
+import { z } from 'zod';
+import type { AztecAddress } from '../aztec-address/index.js';
+import type { CompleteAddress } from '../contract/complete_address.js';
+/**
+ * Directional application tagging secret used for log tagging.
+ *
+ * "Directional" because the derived secret is bound to the recipient
+ * address: A→B differs from B→A even with the same participants and app.
+ *
+ * Note: It's a bit unfortunate that this type resides in `stdlib` as the rest of the tagging functionality resides
+ * in `pxe/src/tagging`. We need to use this type in `PreTag` that in turn is used by other types
+ * in stdlib hence there doesn't seem to be a good way around this.
+ */
+export declare class DirectionalAppTaggingSecret {
+    readonly value: Fr;
+    private constructor();
+    /**
+     * Derives shared tagging secret and from that, the app address and recipient derives the directional app tagging
+     * secret.
+     *
+     * @param localAddress - The complete address of entity A in the shared tagging secret derivation scheme
+     * @param localIvsk - The incoming viewing secret key of entity A
+     * @param externalAddress - The address of entity B in the shared tagging secret derivation scheme
+     * @param app - Contract address to silo the secret to
+     * @param recipient - Recipient of the log. Defines the "direction of the secret".
+     * @returns The secret that can be used along with an index to compute a tag to be included in a log.
+     */
+    static compute(localAddress: CompleteAddress, localIvsk: Fq, externalAddress: AztecAddress, app: AztecAddress, recipient: AztecAddress): Promise<DirectionalAppTaggingSecret>;
+    toString(): string;
+    static fromString(str: string): DirectionalAppTaggingSecret;
+}
+export declare const DirectionalAppTaggingSecretSchema: z.ZodObject<{
+    value: z.ZodType<Fr, any, string>;
+}, "strip", z.ZodTypeAny, {
+    value: Fr;
+}, {
+    value: string;
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlyZWN0aW9uYWxfYXBwX3RhZ2dpbmdfc2VjcmV0LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9ncy9kaXJlY3Rpb25hbF9hcHBfdGFnZ2luZ19zZWNyZXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLEtBQUssRUFBRSxFQUFFLEVBQUUsRUFBYyxNQUFNLDBCQUEwQixDQUFDO0FBRW5FLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUQsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFHdkU7Ozs7Ozs7OztHQVNHO0FBQ0gscUJBQWEsMkJBQTJCO2FBQ0YsS0FBSyxFQUFFLEVBQUU7SUFBN0MsT0FBTyxlQUEwQztJQUVqRDs7Ozs7Ozs7OztPQVVHO0lBQ0gsT0FBYSxPQUFPLENBQ2xCLFlBQVksRUFBRSxlQUFlLEVBQzdCLFNBQVMsRUFBRSxFQUFFLEVBQ2IsZUFBZSxFQUFFLFlBQVksRUFDN0IsR0FBRyxFQUFFLFlBQVksRUFDakIsU0FBUyxFQUFFLFlBQVksR0FDdEIsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBTXRDO0lBRUQsUUFBUSxJQUFJLE1BQU0sQ0FFakI7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsMkJBQTJCLENBRTFEO0NBQ0Y7QUFvQkQsZUFBTyxNQUFNLGlDQUFpQzs7Ozs7O0VBRTVDLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"directional_app_tagging_secret.d.ts","sourceRoot":"","sources":["../../src/logs/directional_app_tagging_secret.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAc,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;;;;;;;;GASG;AACH,qBAAa,2BAA2B;aACF,KAAK,EAAE,EAAE;IAA7C,OAAO,eAA0C;IAEjD;;;;;;;;;;OAUG;IACH,OAAa,OAAO,CAClB,YAAY,EAAE,eAAe,EAC7B,SAAS,EAAE,EAAE,EACb,eAAe,EAAE,YAAY,EAC7B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,2BAA2B,CAAC,CAMtC;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAE1D;CACF;AAoBD,eAAO,MAAM,iCAAiC;;;;;;EAE5C,CAAC"}