@aztec/stdlib 0.82.2 → 0.82.3-nightly.20250403

package/src/validators/schemas.ts

@@ -0,0 +1,53 @@
+import { type ZodFor, schemas } from '@aztec/foundation/schemas';
+
+import { z } from 'zod';
+
+import type { ValidatorStats, ValidatorStatusHistory, ValidatorStatusInSlot, ValidatorsStats } from './types.js';
+
+export const ValidatorStatusInSlotSchema = z.enum([
+  'block-mined',
+  'block-proposed',
+  'block-missed',
+  'attestation-sent',
+  'attestation-missed',
+]) satisfies ZodFor<ValidatorStatusInSlot>;
+
+export const ValidatorStatusHistorySchema = z.array(
+  z.object({
+    slot: schemas.BigInt,
+    status: ValidatorStatusInSlotSchema,
+  }),
+) satisfies ZodFor<ValidatorStatusHistory>;
+
+export const ValidatorStatusHistorySchemaArray = z.array(ValidatorStatusHistorySchema);
+
+export const ValidatorStatusHistorySchemaMap = z.record(ValidatorStatusHistorySchemaArray);
+
+const ValidatorTimeStatSchema = z.object({
+  timestamp: schemas.BigInt,
+  slot: schemas.BigInt,
+  date: z.string(),
+});
+
+const ValidatorFilteredHistorySchema = z.object({
+  currentStreak: schemas.Integer,
+  rate: z.number(),
+  count: schemas.Integer,
+});
+
+export const ValidatorStatsSchema = z.object({
+  address: schemas.EthAddress,
+  lastProposal: ValidatorTimeStatSchema.optional(),
+  lastAttestation: ValidatorTimeStatSchema.optional(),
+  totalSlots: schemas.Integer,
+  missedProposals: ValidatorFilteredHistorySchema,
+  missedAttestations: ValidatorFilteredHistorySchema,
+  history: ValidatorStatusHistorySchema,
+}) satisfies ZodFor<ValidatorStats>;
+
+export const ValidatorsStatsSchema = z.object({
+  stats: z.record(ValidatorStatsSchema),
+  lastProcessedSlot: schemas.BigInt.optional(),
+  initialSlot: schemas.BigInt.optional(),
+  slotWindow: schemas.Integer,
+}) satisfies ZodFor<ValidatorsStats>;

package/src/validators/types.ts

@@ -0,0 +1,37 @@
+import type { EthAddress } from '@aztec/foundation/eth-address';
+
+export type ValidatorStatusType = 'block' | 'attestation';
+
+export type ValidatorStatusInSlot =
+  | 'block-mined'
+  | 'block-proposed'
+  | 'block-missed'
+  | 'attestation-sent'
+  | 'attestation-missed';
+
+export type ValidatorStatusHistory = { slot: bigint; status: ValidatorStatusInSlot }[];
+
+export type ValidatorStats = {
+  address: EthAddress;
+  lastProposal?: { timestamp: bigint; slot: bigint; date: string };
+  lastAttestation?: { timestamp: bigint; slot: bigint; date: string };
+  totalSlots: number;
+  missedProposals: {
+    currentStreak: number;
+    rate: number;
+    count: number;
+  };
+  missedAttestations: {
+    currentStreak: number;
+    rate: number;
+    count: number;
+  };
+  history: ValidatorStatusHistory;
+};
+
+export type ValidatorsStats = {
+  stats: Record<string, ValidatorStats>;
+  lastProcessedSlot?: bigint;
+  initialSlot?: bigint;
+  slotWindow: number;
+};

package/src/versioning/versioning.ts

@@ -16,7 +16,7 @@ export type ComponentsVersions = {
   // Note that we are using the rollup address as identifier in multiple places
   // such as the keystore, we need to change it so we can handle updates.
   l1RollupAddress: EthAddress;
-  l2ChainVersion: number;
+  rollupVersion: number;
   l2ProtocolContractsTreeRoot: string;
   l2CircuitsVkTreeRoot: string;
 };
@@ -30,7 +30,7 @@ export function getComponentsVersionsFromConfig(
   return {
     l1ChainId: config.l1ChainId,
     l1RollupAddress: config.l1Contracts?.rollupAddress, // This should not be undefined, but sometimes the config lies to us and it is...
-    l2ChainVersion: config.version,
+    rollupVersion: config.rollupVersion,
     l2ProtocolContractsTreeRoot: l2ProtocolContractsTreeRoot.toString(),
     l2CircuitsVkTreeRoot: l2CircuitsVkTreeRoot.toString(),
   };
@@ -50,7 +50,7 @@ export function compressComponentVersions(versions: ComponentsVersions): string
     '00',
     versions.l1ChainId,
     versions.l1RollupAddress.toString().slice(2, 10),
-    versions.l2ChainVersion,
+    versions.rollupVersion,
     versions.l2ProtocolContractsTreeRoot.toString().slice(2, 10),
     versions.l2CircuitsVkTreeRoot.toString().slice(2, 10),
   ].join('-');
@@ -65,14 +65,8 @@ export class ComponentsVersionsError extends Error {
 
 /** Checks if the compressed string matches against the expected versions. Throws on mismatch. */
 export function checkCompressedComponentVersion(compressed: string, expected: ComponentsVersions) {
-  const [
-    versionVersion,
-    l1ChainId,
-    l1RollupAddress,
-    l2ChainVersion,
-    l2ProtocolContractsTreeRoot,
-    l2CircuitsVkTreeRoot,
-  ] = compressed.split('-');
+  const [versionVersion, l1ChainId, l1RollupAddress, rollupVersion, l2ProtocolContractsTreeRoot, l2CircuitsVkTreeRoot] =
+    compressed.split('-');
   if (versionVersion !== '00') {
     throw new ComponentsVersionsError('version', '00', versionVersion);
   }
@@ -82,8 +76,8 @@ export function checkCompressedComponentVersion(compressed: string, expected: Co
   if (l1RollupAddress !== expected.l1RollupAddress.toString().slice(2, 10)) {
     throw new ComponentsVersionsError(`L1 address`, expected.l1RollupAddress.toString(), l1RollupAddress);
   }
-  if (l2ChainVersion !== expected.l2ChainVersion.toString()) {
-    throw new ComponentsVersionsError('L2 chain version', expected.l2ChainVersion.toString(), l2ChainVersion);
+  if (rollupVersion !== expected.rollupVersion.toString()) {
+    throw new ComponentsVersionsError('L2 chain version', expected.rollupVersion.toString(), rollupVersion);
   }
   if (l2ProtocolContractsTreeRoot !== expected.l2ProtocolContractsTreeRoot.toString().slice(2, 10)) {
     throw new ComponentsVersionsError(
@@ -111,7 +105,7 @@ export function validatePartialComponentVersionsMatch(
     'l2ProtocolContractsTreeRoot',
     'l2CircuitsVkTreeRoot',
     'l1ChainId',
-    'l2ChainVersion',
+    'rollupVersion',
   ] as const) {
     const actualValue = actual[key];
     const expectedValue = expected[key];

package/dest/event/event.d.ts

@@ -1,24 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { BufferReader } from '@aztec/foundation/serialize';
-import { Payload } from '../logs/l1_payload/payload.js';
-export declare class Event extends Payload {
-    static get schema(): import("zod").ZodEffects<import("zod").ZodUnion<[import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, Buffer, string>, import("zod").ZodEffects<import("zod").ZodObject<{
-        type: import("zod").ZodLiteral<"Buffer">;
-        data: import("zod").ZodArray<import("zod").ZodNumber, "many">;
-    }, "strip", import("zod").ZodTypeAny, {
-        type: "Buffer";
-        data: number[];
-    }, {
-        type: "Buffer";
-        data: number[];
-    }>, Buffer, {
-        type: "Buffer";
-        data: number[];
-    }>]>, Event, string | {
-        type: "Buffer";
-        data: number[];
-    }>;
-    static fromBuffer(buffer: Buffer | BufferReader): Event;
-}
-//# sourceMappingURL=event.d.ts.map

package/dest/event/event.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/event/event.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD,qBAAa,KAAM,SAAQ,OAAO;IAChC,WAAoB,MAAM;;;;;;;;;;;;;;;OAEzB;WAEe,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;CAIzD"}

package/dest/event/event.js

@@ -1,13 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import { BufferReader } from '@aztec/foundation/serialize';
-import { Payload } from '../logs/l1_payload/payload.js';
-import { schemas } from '../schemas/schemas.js';
-export class Event extends Payload {
-    static get schema() {
-        return schemas.Buffer.transform(Event.fromBuffer);
-    }
-    static fromBuffer(buffer) {
-        const reader = BufferReader.asReader(buffer);
-        return new Event(reader.readVector(Fr));
-    }
-}

package/dest/event/event_metadata.d.ts

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-import { type AbiType } from '../abi/abi.js';
-import type { EventSelector } from '../abi/event_selector.js';
-import type { PublicLog } from '../logs/public_log.js';
-import { L1EventPayload } from './l1_event_payload.js';
-/**
- * Represents metadata for an event decoder, including all information needed to reconstruct it.
- */
-export declare class EventMetadata<T> {
-    readonly decode: (payload: L1EventPayload | PublicLog) => T | undefined;
-    readonly eventSelector: EventSelector;
-    readonly abiType: AbiType;
-    readonly fieldNames: string[];
-    constructor(event: {
-        eventSelector: EventSelector;
-        abiType: AbiType;
-        fieldNames: string[];
-    });
-    static decodeEvent<T>(eventSelector: EventSelector, abiType: AbiType): (payload: L1EventPayload | PublicLog | undefined) => T | undefined;
-    static get schema(): z.ZodEffects<z.ZodObject<{
-        eventSelector: z.ZodType<EventSelector, any, string>;
-        abiType: z.ZodType<AbiType, z.ZodTypeDef, AbiType>;
-        fieldNames: z.ZodArray<z.ZodString, "many">;
-    }, "strip", z.ZodTypeAny, {
-        eventSelector: EventSelector;
-        abiType: AbiType;
-        fieldNames: string[];
-    }, {
-        eventSelector: string;
-        abiType: AbiType;
-        fieldNames: string[];
-    }>, EventMetadata<unknown>, {
-        eventSelector: string;
-        abiType: AbiType;
-        fieldNames: string[];
-    }>;
-}
-//# sourceMappingURL=event_metadata.d.ts.map

package/dest/event/event_metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event_metadata.d.ts","sourceRoot":"","sources":["../../src/event/event_metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC;IAC1B,SAAgB,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,CAAC;IAE/E,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,UAAU,EAAE,MAAM,EAAE,CAAC;gBAEzB,KAAK,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;WAO7E,WAAW,CAAC,CAAC,EACzB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,OAAO,GACf,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS;IAiBrE,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;OAQhB;CACF"}

package/dest/event/event_metadata.js

@@ -1,45 +0,0 @@
-import { z } from 'zod';
-import { AbiTypeSchema } from '../abi/abi.js';
-import { decodeFromAbi } from '../abi/decoder.js';
-import { schemas } from '../schemas/index.js';
-import { L1EventPayload } from './l1_event_payload.js';
-/**
- * Represents metadata for an event decoder, including all information needed to reconstruct it.
- */ export class EventMetadata {
-    decode;
-    eventSelector;
-    abiType;
-    fieldNames;
-    constructor(event){
-        this.eventSelector = event.eventSelector;
-        this.abiType = event.abiType;
-        this.fieldNames = event.fieldNames;
-        this.decode = EventMetadata.decodeEvent(event.eventSelector, event.abiType);
-    }
-    static decodeEvent(eventSelector, abiType) {
-        return (payload)=>{
-            if (payload === undefined) {
-                return undefined;
-            }
-            if (payload instanceof L1EventPayload) {
-                if (!eventSelector.equals(payload.eventTypeId)) {
-                    return undefined;
-                }
-                return decodeFromAbi([
-                    abiType
-                ], payload.event.items);
-            } else {
-                return decodeFromAbi([
-                    abiType
-                ], payload.log);
-            }
-        };
-    }
-    static get schema() {
-        return z.object({
-            eventSelector: schemas.EventSelector,
-            abiType: AbiTypeSchema,
-            fieldNames: z.array(z.string())
-        }).transform((obj)=>new EventMetadata(obj));
-    }
-}

package/dest/event/index.d.ts

@@ -1,4 +0,0 @@
-export * from './event.js';
-export * from './event_metadata.js';
-export * from './l1_event_payload.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dest/event/index.js

@@ -1,3 +0,0 @@
-export * from './event.js';
-export * from './event_metadata.js';
-export * from './l1_event_payload.js';

package/dest/event/l1_event_payload.d.ts

@@ -1,52 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { type Fq } from '@aztec/foundation/fields';
-import { EventSelector } from '../abi/event_selector.js';
-import { AztecAddress } from '../aztec-address/index.js';
-import type { PrivateLog } from '../logs/private_log.js';
-import { Event } from './event.js';
-/**
- * A class which wraps event data which is pushed on L1.
- */
-export declare class L1EventPayload {
-    #private;
-    /**
-     * A event as emitted from Noir contract. Can be used along with private key to compute nullifier.
-     */
-    event: Event;
-    /**
-     * Address of the contract this tx is interacting with.
-     */
-    contractAddress: AztecAddress;
-    /**
-     * Type identifier for the underlying event, required to determine how to compute its hash and nullifier.
-     */
-    eventTypeId: EventSelector;
-    constructor(
-    /**
-     * A event as emitted from Noir contract. Can be used along with private key to compute nullifier.
-     */
-    event: Event, 
-    /**
-     * Address of the contract this tx is interacting with.
-     */
-    contractAddress: AztecAddress, 
-    /**
-     * Type identifier for the underlying event, required to determine how to compute its hash and nullifier.
-     */
-    eventTypeId: EventSelector);
-    static decryptAsIncoming(log: PrivateLog, sk: Fq): Promise<L1EventPayload | undefined>;
-    /**
-     * Serializes the L1EventPayload object into a Buffer.
-     * @returns Buffer representation of the L1EventPayload object.
-     */
-    toIncomingBodyPlaintext(): Buffer;
-    /**
-     * Create a random L1EventPayload object (useful for testing purposes).
-     * @param contract - The address of a contract the event was emitted from.
-     * @returns A random L1EventPayload object.
-     */
-    static random(contract?: AztecAddress): Promise<L1EventPayload>;
-    equals(other: L1EventPayload): boolean;
-}
-//# sourceMappingURL=l1_event_payload.d.ts.map

package/dest/event/l1_event_payload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"l1_event_payload.d.ts","sourceRoot":"","sources":["../../src/event/l1_event_payload.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,KAAK,EAAE,EAAM,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;GAEG;AACH,qBAAa,cAAc;;IAEvB;;OAEG;IACI,KAAK,EAAE,KAAK;IACnB;;OAEG;IACI,eAAe,EAAE,YAAY;IACpC;;OAEG;IACI,WAAW,EAAE,aAAa;;IAXjC;;OAEG;IACI,KAAK,EAAE,KAAK;IACnB;;OAEG;IACI,eAAe,EAAE,YAAY;IACpC;;OAEG;IACI,WAAW,EAAE,aAAa;WAwBtB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAY5F;;;OAGG;IACH,uBAAuB;IAKvB;;;;OAIG;WACU,MAAM,CAAC,QAAQ,CAAC,EAAE,YAAY;IAIpC,MAAM,CAAC,KAAK,EAAE,cAAc;CAOpC"}

package/dest/event/l1_event_payload.js

@@ -1,64 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
-import { EventSelector } from '../abi/event_selector.js';
-import { AztecAddress } from '../aztec-address/index.js';
-import { EncryptedLogPayload } from '../logs/l1_payload/encrypted_log_payload.js';
-import { Event } from './event.js';
-/**
- * A class which wraps event data which is pushed on L1.
- */ export class L1EventPayload {
-    event;
-    contractAddress;
-    eventTypeId;
-    constructor(/**
-     * A event as emitted from Noir contract. Can be used along with private key to compute nullifier.
-     */ event, /**
-     * Address of the contract this tx is interacting with.
-     */ contractAddress, /**
-     * Type identifier for the underlying event, required to determine how to compute its hash and nullifier.
-     */ eventTypeId){
-        this.event = event;
-        this.contractAddress = contractAddress;
-        this.eventTypeId = eventTypeId;
-    }
-    static #fromIncomingBodyPlaintextAndContractAddress(plaintext, contractAddress) {
-        let payload;
-        try {
-            const reader = BufferReader.asReader(plaintext);
-            const fields = reader.readArray(plaintext.length / Fr.SIZE_IN_BYTES, Fr);
-            const eventTypeId = EventSelector.fromField(fields[0]);
-            const event = new Event(fields.slice(1));
-            payload = new L1EventPayload(event, contractAddress, eventTypeId);
-        } catch (e) {
-            return undefined;
-        }
-        return payload;
-    }
-    static async decryptAsIncoming(log, sk) {
-        const decryptedLog = await EncryptedLogPayload.decryptAsIncoming(log.fields, sk);
-        if (!decryptedLog) {
-            return undefined;
-        }
-        return this.#fromIncomingBodyPlaintextAndContractAddress(decryptedLog.incomingBodyPlaintext, decryptedLog.contractAddress);
-    }
-    /**
-   * Serializes the L1EventPayload object into a Buffer.
-   * @returns Buffer representation of the L1EventPayload object.
-   */ toIncomingBodyPlaintext() {
-        const fields = [
-            this.eventTypeId.toField(),
-            ...this.event.items
-        ];
-        return serializeToBuffer(fields);
-    }
-    /**
-   * Create a random L1EventPayload object (useful for testing purposes).
-   * @param contract - The address of a contract the event was emitted from.
-   * @returns A random L1EventPayload object.
-   */ static async random(contract) {
-        return new L1EventPayload(Event.random(), contract ?? await AztecAddress.random(), EventSelector.random());
-    }
-    equals(other) {
-        return this.event.equals(other.event) && this.contractAddress.equals(other.contractAddress) && this.eventTypeId.equals(other.eventTypeId);
-    }
-}

package/dest/logs/l1_payload/encrypted_log_payload.d.ts

@@ -1,50 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { Fr, type GrumpkinScalar } from '@aztec/foundation/fields';
-import { AztecAddress } from '../../aztec-address/index.js';
-import { PrivateLog } from '../private_log.js';
-/**
- * Encrypted log payload with a tag used for retrieval by clients.
- */
-export declare class EncryptedLogPayload {
-    /**
-     * Note discovery tag.
-     */
-    readonly tag: Fr;
-    /**
-     * Address of a contract that emitted the log.
-     */
-    readonly contractAddress: AztecAddress;
-    /**
-     * Decrypted incoming body.
-     */
-    readonly incomingBodyPlaintext: Buffer;
-    constructor(
-    /**
-     * Note discovery tag.
-     */
-    tag: Fr, 
-    /**
-     * Address of a contract that emitted the log.
-     */
-    contractAddress: AztecAddress, 
-    /**
-     * Decrypted incoming body.
-     */
-    incomingBodyPlaintext: Buffer);
-    generatePayload(ephSk: GrumpkinScalar, recipient: AztecAddress, rand?: (len: number) => Buffer): Promise<PrivateLog>;
-    /**
-     * Decrypts a ciphertext as an incoming log.
-     *
-     * This is executable by the recipient of the note, and uses the addressSecret to decrypt the payload.
-     *
-     * @param payload - The payload for the log
-     * @param addressSecret - The address secret, used to decrypt the logs
-     * @param ciphertextLength - Optionally supply the ciphertext length (see trimCiphertext())
-     * @returns The decrypted log payload
-     */
-    static decryptAsIncoming(payload: Fr[], addressSecret: GrumpkinScalar): Promise<EncryptedLogPayload | undefined>;
-    private static isAcceptableError;
-    toBuffer(): Buffer;
-}
-//# sourceMappingURL=encrypted_log_payload.d.ts.map

package/dest/logs/l1_payload/encrypted_log_payload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encrypted_log_payload.d.ts","sourceRoot":"","sources":["../../../src/logs/l1_payload/encrypted_log_payload.ts"],"names":[],"mappings":";;AAEA,OAAO,EAAE,EAAE,EAAE,KAAK,cAAc,EAA0B,MAAM,0BAA0B,CAAC;AAG3F,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuC/C;;GAEG;AACH,qBAAa,mBAAmB;IAE5B;;OAEG;aACa,GAAG,EAAE,EAAE;IACvB;;OAEG;aACa,eAAe,EAAE,YAAY;IAC7C;;OAEG;aACa,qBAAqB,EAAE,MAAM;;IAX7C;;OAEG;IACa,GAAG,EAAE,EAAE;IACvB;;OAEG;IACa,eAAe,EAAE,YAAY;IAC7C;;OAEG;IACa,qBAAqB,EAAE,MAAM;IAKlC,eAAe,CAC1B,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,YAAY,EACvB,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAoB,GAC1C,OAAO,CAAC,UAAU,CAAC;IAsDtB;;;;;;;;;OASG;WACiB,iBAAiB,CACnC,OAAO,EAAE,EAAE,EAAE,EACb,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAiD3C,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWzB,QAAQ;CAGhB"}

package/dest/logs/l1_payload/encrypted_log_payload.js

@@ -1,140 +0,0 @@
-import { PRIVATE_LOG_SIZE_IN_FIELDS } from '@aztec/constants';
-import { randomBytes } from '@aztec/foundation/crypto';
-import { Fr, NotOnCurveError, Point } from '@aztec/foundation/fields';
-import { BufferReader, numToUInt16BE, serializeToBuffer } from '@aztec/foundation/serialize';
-import { AztecAddress } from '../../aztec-address/index.js';
-import { derivePublicKeyFromSecretKey } from '../../keys/derivation.js';
-import { PrivateLog } from '../private_log.js';
-import { aes128Decrypt, aes128Encrypt, deriveAesSymmetricKeyAndIvFromEcdhSharedSecretUsingSha256 } from './encryption_util.js';
-import { deriveEcdhSharedSecret, deriveEcdhSharedSecretUsingAztecAddress } from './shared_secret_derivation.js';
-// Below constants should match the values defined in aztec-nr/aztec/src/encrypted_logs/log_assembly_strategies/default_aes128/note.nr.
-// Note: we will soon be 'abstracting' log processing: apps will process their own logs, instead of the PXE processing all apps' logs. Therefore, this file will imminently change considerably.
-const TAG_SIZE_IN_FIELDS = 1;
-const EPK_SIZE_IN_FIELDS = 1;
-const USABLE_PRIVATE_LOG_SIZE_IN_FIELDS = PRIVATE_LOG_SIZE_IN_FIELDS - TAG_SIZE_IN_FIELDS - EPK_SIZE_IN_FIELDS;
-const USABLE_PRIVATE_LOG_SIZE_IN_BYTES = USABLE_PRIVATE_LOG_SIZE_IN_FIELDS * 31 / 16 * 16;
-// The incoming header ciphertext is 48 bytes
-// 32 bytes for the address, and 16 bytes padding to follow PKCS#7
-const HEADER_CIPHERTEXT_SIZE_IN_BYTES = 48;
-const USABLE_PLAINTEXT_SIZE_IN_BYTES = USABLE_PRIVATE_LOG_SIZE_IN_BYTES - HEADER_CIPHERTEXT_SIZE_IN_BYTES;
-const CONTRACT_ADDRESS_SIZE_IN_BYTES = 32;
-const SIZE_OF_ENCODING_OF_CIPHERTEXT_SIZE_IN_BYTES = 2;
-function beBytes31ToFields(bytes) {
-    const fields = [];
-    const numFields = Math.ceil(bytes.length / 31);
-    for(let i = 0; i < numFields; i++){
-        fields.push(new Fr(bytes.subarray(i * 31, (i + 1) * 31)));
-    }
-    return fields;
-}
-function fieldsToBEBytes31(fields) {
-    return Buffer.concat(fields.map((f)=>f.toBuffer().subarray(1)));
-}
-/**
- * Encrypted log payload with a tag used for retrieval by clients.
- */ export class EncryptedLogPayload {
-    tag;
-    contractAddress;
-    incomingBodyPlaintext;
-    constructor(/**
-     * Note discovery tag.
-     */ tag, /**
-     * Address of a contract that emitted the log.
-     */ contractAddress, /**
-     * Decrypted incoming body.
-     */ incomingBodyPlaintext){
-        this.tag = tag;
-        this.contractAddress = contractAddress;
-        this.incomingBodyPlaintext = incomingBodyPlaintext;
-    }
-    // NB: Only appears to be used in tests
-    // See noir-projects/aztec-nr/aztec/src/encrypted_logs/log_assembly_strategies/default_aes128/note.nr
-    async generatePayload(ephSk, recipient, rand = randomBytes) {
-        const ephPk = await derivePublicKeyFromSecretKey(ephSk);
-        const [ephPkX, ephPkSignBool] = ephPk.toXAndSign();
-        const ephPkSignU8 = Buffer.from([
-            Number(ephPkSignBool)
-        ]);
-        const ciphertextSharedSecret = await deriveEcdhSharedSecretUsingAztecAddress(ephSk, recipient); // not to be confused with the tagging shared secret
-        const [symKey, iv] = deriveAesSymmetricKeyAndIvFromEcdhSharedSecretUsingSha256(ciphertextSharedSecret);
-        if (this.incomingBodyPlaintext.length > USABLE_PLAINTEXT_SIZE_IN_BYTES) {
-            throw new Error(`Incoming body plaintext cannot be more than ${USABLE_PLAINTEXT_SIZE_IN_BYTES} bytes.`);
-        }
-        const finalPlaintext = this.incomingBodyPlaintext;
-        const ciphertextBytes = await aes128Encrypt(finalPlaintext, iv, symKey);
-        const headerPlaintext = serializeToBuffer(this.contractAddress.toBuffer(), numToUInt16BE(ciphertextBytes.length));
-        // TODO: it is unsafe to re-use the same iv and symKey. We'll need to do something cleverer.
-        const headerCiphertextBytes = await aes128Encrypt(headerPlaintext, iv, symKey);
-        if (headerCiphertextBytes.length !== HEADER_CIPHERTEXT_SIZE_IN_BYTES) {
-            throw new Error(`Invalid header ciphertext size: ${headerCiphertextBytes.length}`);
-        }
-        const properLogBytesLength = 1 /* ephPkSignU8 */  + HEADER_CIPHERTEXT_SIZE_IN_BYTES + ciphertextBytes.length;
-        const logBytesPaddingToMult31 = rand(31 * Math.ceil(properLogBytesLength / 31) - properLogBytesLength);
-        const logBytes = serializeToBuffer(ephPkSignU8, headerCiphertextBytes, ciphertextBytes, logBytesPaddingToMult31);
-        if (logBytes.length % 31 !== 0) {
-            throw new Error(`logBytes.length should be divisible by 31, got: ${logBytes.length}`);
-        }
-        const fieldsPadding = Array.from({
-            length: USABLE_PRIVATE_LOG_SIZE_IN_FIELDS - logBytes.length / 31
-        }, ()=>Fr.fromBuffer(rand(32))); // we use the randomBytes function instead of `Fr.random()`, so that we can use deterministic randomness in tests, through the rand() function.
-        const logFields = [
-            this.tag,
-            ephPkX,
-            ...beBytes31ToFields(logBytes),
-            ...fieldsPadding
-        ];
-        if (logFields.length !== PRIVATE_LOG_SIZE_IN_FIELDS) {
-            throw new Error(`Expected private log payload to have ${PRIVATE_LOG_SIZE_IN_FIELDS} fields. Got ${logFields.length}.`);
-        }
-        return new PrivateLog(logFields);
-    }
-    /**
-   * Decrypts a ciphertext as an incoming log.
-   *
-   * This is executable by the recipient of the note, and uses the addressSecret to decrypt the payload.
-   *
-   * @param payload - The payload for the log
-   * @param addressSecret - The address secret, used to decrypt the logs
-   * @param ciphertextLength - Optionally supply the ciphertext length (see trimCiphertext())
-   * @returns The decrypted log payload
-   */ static async decryptAsIncoming(payload, addressSecret) {
-        try {
-            const logFields = payload;
-            const tag = logFields[0];
-            const ephPkX = logFields[1];
-            const reader = BufferReader.asReader(fieldsToBEBytes31(logFields.slice(TAG_SIZE_IN_FIELDS + EPK_SIZE_IN_FIELDS)));
-            const ephPkSigBuf = reader.readBytes(1);
-            const ephPkSignBool = !!ephPkSigBuf[0];
-            const ephPk = await Point.fromXAndSign(ephPkX, ephPkSignBool);
-            const headerCiphertextBytes = reader.readBytes(HEADER_CIPHERTEXT_SIZE_IN_BYTES);
-            let contractAddress = AztecAddress.ZERO;
-            if (!addressSecret) {
-                throw new Error('Cannot decrypt without an address secret.');
-            }
-            const ciphertextSharedSecret = await deriveEcdhSharedSecret(addressSecret, ephPk);
-            const [symKey, iv] = deriveAesSymmetricKeyAndIvFromEcdhSharedSecretUsingSha256(ciphertextSharedSecret);
-            const headerPlaintextBytes = await aes128Decrypt(headerCiphertextBytes, iv, symKey);
-            const headerReader = BufferReader.asReader(headerPlaintextBytes);
-            const contractAddressBuf = headerReader.readBytes(CONTRACT_ADDRESS_SIZE_IN_BYTES);
-            contractAddress = AztecAddress.fromBuffer(contractAddressBuf);
-            const ciphertextBytesLengthBuf = headerReader.readBytes(SIZE_OF_ENCODING_OF_CIPHERTEXT_SIZE_IN_BYTES);
-            const ciphertextBytesLength = (ciphertextBytesLengthBuf[0] << 8) + ciphertextBytesLengthBuf[1];
-            const ciphertextBytes = reader.readBytes(ciphertextBytesLength);
-            const plaintextBytes = await aes128Decrypt(ciphertextBytes, iv, symKey);
-            return new EncryptedLogPayload(tag, contractAddress, plaintextBytes);
-        } catch (e) {
-            // Following error messages are expected to occur when decryption fails
-            if (!this.isAcceptableError(e)) {
-                // If we encounter an unexpected error, we rethrow it
-                throw e;
-            }
-            return;
-        }
-    }
-    static isAcceptableError(e) {
-        return e instanceof NotOnCurveError || e.message.endsWith('is greater or equal to field modulus.') || e.message.startsWith('Invalid AztecAddress length') || e.message.startsWith('Selector must fit in') || e.message.startsWith('Attempted to read beyond buffer length') || e.message.startsWith('RangeError [ERR_BUFFER_OUT_OF_BOUNDS]:');
-    }
-    toBuffer() {
-        return serializeToBuffer(this.tag, this.contractAddress.toBuffer(), this.incomingBodyPlaintext);
-    }
-}

package/dest/logs/l1_payload/encryption_util.d.ts

@@ -1,24 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import type { Point } from '@aztec/foundation/fields';
-export declare function deriveAesSymmetricKeyAndIvFromEcdhSharedSecretUsingSha256(sharedSecret: Point): [Buffer, Buffer];
-/**
- * Encrypts the plaintext using the secret key and public key
- *
- * @param plaintext - The plaintext buffer
- * @param secret - The secret key used to derive the AES secret
- * @param publicKey - Public key used to derived the AES secret
- * @param deriveSecret - Function to derive the AES secret from the ephemeral secret key and public key
- * @returns The ciphertext
- */
-export declare function aes128Encrypt(plaintext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
-/**
- * Decrypts the ciphertext using the secret key and public key
- * @param ciphertext - The ciphertext buffer
- * @param secret - The secret key used to derive the AES secret
- * @param publicKey - The public key used to derive the AES secret
- * @param deriveSecret - Function to derive the AES secret from the ephemeral secret key and public key
- * @returns
- */
-export declare function aes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
-//# sourceMappingURL=encryption_util.d.ts.map

package/dest/logs/l1_payload/encryption_util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"encryption_util.d.ts","sourceRoot":"","sources":["../../../src/logs/l1_payload/encryption_util.ts"],"names":[],"mappings":";;AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAmBtD,wBAAgB,yDAAyD,CAAC,YAAY,EAAE,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAK/G;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7F"}