@aztec/stdlib 0.77.0-testnet-ignition.17

package/src/kernel/private_circuit_public_inputs.ts

@@ -0,0 +1,322 @@
+import {
+  MAX_CONTRACT_CLASS_LOGS_PER_CALL,
+  MAX_ENQUEUED_CALLS_PER_CALL,
+  MAX_KEY_VALIDATION_REQUESTS_PER_CALL,
+  MAX_L2_TO_L1_MSGS_PER_CALL,
+  MAX_NOTE_HASHES_PER_CALL,
+  MAX_NOTE_HASH_READ_REQUESTS_PER_CALL,
+  MAX_NULLIFIERS_PER_CALL,
+  MAX_NULLIFIER_READ_REQUESTS_PER_CALL,
+  MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL,
+  MAX_PRIVATE_LOGS_PER_CALL,
+  PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH,
+} from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/fields';
+import { bufferSchemaFor } from '@aztec/foundation/schemas';
+import {
+  BufferReader,
+  FieldReader,
+  type Tuple,
+  serializeToBuffer,
+  serializeToFields,
+} from '@aztec/foundation/serialize';
+import type { FieldsOf } from '@aztec/foundation/types';
+
+import { KeyValidationRequestAndGenerator } from '../kernel/hints/key_validation_request_and_generator.js';
+import { LogHash } from '../kernel/log_hash.js';
+import { PrivateCallRequest } from '../kernel/private_call_request.js';
+import { PrivateLogData } from '../kernel/private_log_data.js';
+import { L2ToL1Message } from '../messaging/l2_to_l1_message.js';
+import { BlockHeader } from '../tx/block_header.js';
+import { CallContext } from '../tx/call_context.js';
+import { MaxBlockNumber } from '../tx/max_block_number.js';
+import { TxContext } from '../tx/tx_context.js';
+import { ReadRequest } from './hints/read_request.js';
+import { NoteHash } from './note_hash.js';
+import { Nullifier } from './nullifier.js';
+import { CountedPublicCallRequest, PublicCallRequest } from './public_call_request.js';
+import { isEmptyArray } from './utils/order_and_comparison.js';
+
+/**
+ * Public inputs to a private circuit.
+ */
+export class PrivateCircuitPublicInputs {
+  constructor(
+    /**
+     * Context of the call corresponding to this private circuit execution.
+     */
+    public callContext: CallContext,
+    /**
+     * Pedersen hash of function arguments.
+     */
+    public argsHash: Fr,
+    /**
+     * Pedersen hash of the return values of the corresponding function call.
+     */
+    public returnsHash: Fr,
+    /**
+     * The side-effect counter under which all side effects are non-revertible.
+     */
+    public minRevertibleSideEffectCounter: Fr,
+    /**
+     * Whether the caller of the function is the fee payer.
+     */
+    public isFeePayer: boolean,
+    /**
+     * The maximum block number in which this transaction can be included and be valid.
+     */
+    public maxBlockNumber: MaxBlockNumber,
+    /**
+     * Read requests created by the corresponding function call.
+     */
+    public noteHashReadRequests: Tuple<ReadRequest, typeof MAX_NOTE_HASH_READ_REQUESTS_PER_CALL>,
+    /**
+     * Nullifier read requests created by the corresponding function call.
+     */
+    public nullifierReadRequests: Tuple<ReadRequest, typeof MAX_NULLIFIER_READ_REQUESTS_PER_CALL>,
+    /**
+     * Key validation requests and generators created by the corresponding function call.
+     */
+    public keyValidationRequestsAndGenerators: Tuple<
+      KeyValidationRequestAndGenerator,
+      typeof MAX_KEY_VALIDATION_REQUESTS_PER_CALL
+    >,
+    /**
+     * New note hashes created by the corresponding function call.
+     */
+    public noteHashes: Tuple<NoteHash, typeof MAX_NOTE_HASHES_PER_CALL>,
+    /**
+     * New nullifiers created by the corresponding function call.
+     */
+    public nullifiers: Tuple<Nullifier, typeof MAX_NULLIFIERS_PER_CALL>,
+    /**
+     * Private call requests made within the current kernel iteration.
+     */
+    public privateCallRequests: Tuple<PrivateCallRequest, typeof MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL>,
+    /**
+     * Public call stack at the current kernel iteration.
+     */
+    public publicCallRequests: Tuple<CountedPublicCallRequest, typeof MAX_ENQUEUED_CALLS_PER_CALL>,
+    /**
+     * Hash of the public teardown function.
+     */
+    public publicTeardownCallRequest: PublicCallRequest,
+    /**
+     * New L2 to L1 messages created by the corresponding function call.
+     */
+    public l2ToL1Msgs: Tuple<L2ToL1Message, typeof MAX_L2_TO_L1_MSGS_PER_CALL>,
+    /**
+     * Logs emitted in this function call.
+     */
+    public privateLogs: Tuple<PrivateLogData, typeof MAX_PRIVATE_LOGS_PER_CALL>,
+    /**
+     * Hash of the contract class logs emitted in this function call.
+     */
+    public contractClassLogsHashes: Tuple<LogHash, typeof MAX_CONTRACT_CLASS_LOGS_PER_CALL>,
+    /**
+     * The side effect counter at the start of this call.
+     */
+    public startSideEffectCounter: Fr,
+    /**
+     * The end side effect counter for this call.
+     */
+    public endSideEffectCounter: Fr,
+    /**
+     * Header of a block whose state is used during private execution (not the block the transaction is included in).
+     */
+    public historicalHeader: BlockHeader,
+    /**
+     * Transaction context.
+     *
+     * Note: The chainId and version in the txContext are not redundant to the values in self.historical_header.global_variables because
+     * they can be different in case of a protocol upgrade. In such a situation we could be using header from a block
+     * before the upgrade took place but be using the updated protocol to execute and prove the transaction.
+     */
+    public txContext: TxContext,
+  ) {}
+
+  /**
+   * Create PrivateCircuitPublicInputs from a fields dictionary.
+   * @param fields - The dictionary.
+   * @returns A PrivateCircuitPublicInputs object.
+   */
+  static from(fields: FieldsOf<PrivateCircuitPublicInputs>): PrivateCircuitPublicInputs {
+    return new PrivateCircuitPublicInputs(...PrivateCircuitPublicInputs.getFields(fields));
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateCircuitPublicInputs {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateCircuitPublicInputs(
+      reader.readObject(CallContext),
+      reader.readObject(Fr),
+      reader.readObject(Fr),
+      reader.readObject(Fr),
+      reader.readBoolean(),
+      reader.readObject(MaxBlockNumber),
+      reader.readArray(MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, ReadRequest),
+      reader.readArray(MAX_NULLIFIER_READ_REQUESTS_PER_CALL, ReadRequest),
+      reader.readArray(MAX_KEY_VALIDATION_REQUESTS_PER_CALL, KeyValidationRequestAndGenerator),
+      reader.readArray(MAX_NOTE_HASHES_PER_CALL, NoteHash),
+      reader.readArray(MAX_NULLIFIERS_PER_CALL, Nullifier),
+      reader.readArray(MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL, PrivateCallRequest),
+      reader.readArray(MAX_ENQUEUED_CALLS_PER_CALL, CountedPublicCallRequest),
+      reader.readObject(PublicCallRequest),
+      reader.readArray(MAX_L2_TO_L1_MSGS_PER_CALL, L2ToL1Message),
+      reader.readArray(MAX_PRIVATE_LOGS_PER_CALL, PrivateLogData),
+      reader.readArray(MAX_CONTRACT_CLASS_LOGS_PER_CALL, LogHash),
+      reader.readObject(Fr),
+      reader.readObject(Fr),
+      reader.readObject(BlockHeader),
+      reader.readObject(TxContext),
+    );
+  }
+
+  static fromFields(fields: Fr[] | FieldReader): PrivateCircuitPublicInputs {
+    const reader = FieldReader.asReader(fields);
+    return new PrivateCircuitPublicInputs(
+      reader.readObject(CallContext),
+      reader.readField(),
+      reader.readField(),
+      reader.readField(),
+      reader.readBoolean(),
+      reader.readObject(MaxBlockNumber),
+      reader.readArray(MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, ReadRequest),
+      reader.readArray(MAX_NULLIFIER_READ_REQUESTS_PER_CALL, ReadRequest),
+      reader.readArray(MAX_KEY_VALIDATION_REQUESTS_PER_CALL, KeyValidationRequestAndGenerator),
+      reader.readArray(MAX_NOTE_HASHES_PER_CALL, NoteHash),
+      reader.readArray(MAX_NULLIFIERS_PER_CALL, Nullifier),
+      reader.readArray(MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL, PrivateCallRequest),
+      reader.readArray(MAX_ENQUEUED_CALLS_PER_CALL, CountedPublicCallRequest),
+      reader.readObject(PublicCallRequest),
+      reader.readArray(MAX_L2_TO_L1_MSGS_PER_CALL, L2ToL1Message),
+      reader.readArray(MAX_PRIVATE_LOGS_PER_CALL, PrivateLogData),
+      reader.readArray(MAX_CONTRACT_CLASS_LOGS_PER_CALL, LogHash),
+      reader.readField(),
+      reader.readField(),
+      reader.readObject(BlockHeader),
+      reader.readObject(TxContext),
+    );
+  }
+
+  /**
+   * Create an empty PrivateCircuitPublicInputs.
+   * @returns An empty PrivateCircuitPublicInputs object.
+   */
+  public static empty(): PrivateCircuitPublicInputs {
+    return new PrivateCircuitPublicInputs(
+      CallContext.empty(),
+      Fr.ZERO,
+      Fr.ZERO,
+      Fr.ZERO,
+      false,
+      MaxBlockNumber.empty(),
+      makeTuple(MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, ReadRequest.empty),
+      makeTuple(MAX_NULLIFIER_READ_REQUESTS_PER_CALL, ReadRequest.empty),
+      makeTuple(MAX_KEY_VALIDATION_REQUESTS_PER_CALL, KeyValidationRequestAndGenerator.empty),
+      makeTuple(MAX_NOTE_HASHES_PER_CALL, NoteHash.empty),
+      makeTuple(MAX_NULLIFIERS_PER_CALL, Nullifier.empty),
+      makeTuple(MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL, PrivateCallRequest.empty),
+      makeTuple(MAX_ENQUEUED_CALLS_PER_CALL, CountedPublicCallRequest.empty),
+      PublicCallRequest.empty(),
+      makeTuple(MAX_L2_TO_L1_MSGS_PER_CALL, L2ToL1Message.empty),
+      makeTuple(MAX_PRIVATE_LOGS_PER_CALL, PrivateLogData.empty),
+      makeTuple(MAX_CONTRACT_CLASS_LOGS_PER_CALL, LogHash.empty),
+      Fr.ZERO,
+      Fr.ZERO,
+      BlockHeader.empty(),
+      TxContext.empty(),
+    );
+  }
+
+  isEmpty() {
+    return (
+      this.callContext.isEmpty() &&
+      this.argsHash.isZero() &&
+      this.returnsHash.isZero() &&
+      this.minRevertibleSideEffectCounter.isZero() &&
+      !this.isFeePayer &&
+      this.maxBlockNumber.isEmpty() &&
+      isEmptyArray(this.noteHashReadRequests) &&
+      isEmptyArray(this.nullifierReadRequests) &&
+      isEmptyArray(this.keyValidationRequestsAndGenerators) &&
+      isEmptyArray(this.noteHashes) &&
+      isEmptyArray(this.nullifiers) &&
+      isEmptyArray(this.privateCallRequests) &&
+      isEmptyArray(this.publicCallRequests) &&
+      this.publicTeardownCallRequest.isEmpty() &&
+      isEmptyArray(this.l2ToL1Msgs) &&
+      isEmptyArray(this.privateLogs) &&
+      isEmptyArray(this.contractClassLogsHashes) &&
+      this.startSideEffectCounter.isZero() &&
+      this.endSideEffectCounter.isZero() &&
+      this.historicalHeader.isEmpty() &&
+      this.txContext.isEmpty()
+    );
+  }
+
+  /**
+   * Serialize into a field array. Low-level utility.
+   * @param fields - Object with fields.
+   * @returns The array.
+   */
+  static getFields(fields: FieldsOf<PrivateCircuitPublicInputs>) {
+    return [
+      fields.callContext,
+      fields.argsHash,
+      fields.returnsHash,
+      fields.minRevertibleSideEffectCounter,
+      fields.isFeePayer,
+      fields.maxBlockNumber,
+      fields.noteHashReadRequests,
+      fields.nullifierReadRequests,
+      fields.keyValidationRequestsAndGenerators,
+      fields.noteHashes,
+      fields.nullifiers,
+      fields.privateCallRequests,
+      fields.publicCallRequests,
+      fields.publicTeardownCallRequest,
+      fields.l2ToL1Msgs,
+      fields.privateLogs,
+      fields.contractClassLogsHashes,
+      fields.startSideEffectCounter,
+      fields.endSideEffectCounter,
+      fields.historicalHeader,
+      fields.txContext,
+    ] as const;
+  }
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer(): Buffer {
+    return serializeToBuffer(...PrivateCircuitPublicInputs.getFields(this));
+  }
+
+  /**
+   * Serialize this as a field array.
+   */
+  toFields(): Fr[] {
+    const fields = serializeToFields(...PrivateCircuitPublicInputs.getFields(this));
+    if (fields.length !== PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH) {
+      throw new Error(
+        `Invalid number of fields for PrivateCircuitPublicInputs. Expected ${PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH}, got ${fields.length}`,
+      );
+    }
+    return fields;
+  }
+
+  public toJSON() {
+    return this.toBuffer();
+  }
+
+  static get schema() {
+    return bufferSchemaFor(PrivateCircuitPublicInputs);
+  }
+}

package/src/kernel/private_context_inputs.ts

@@ -0,0 +1,23 @@
+import type { Fr } from '@aztec/foundation/fields';
+import { serializeToFields } from '@aztec/foundation/serialize';
+
+import { BlockHeader } from '../tx/block_header.js';
+import { CallContext } from '../tx/call_context.js';
+import { TxContext } from '../tx/tx_context.js';
+
+export class PrivateContextInputs {
+  constructor(
+    public callContext: CallContext,
+    public historicalHeader: BlockHeader,
+    public txContext: TxContext,
+    public startSideEffectCounter: number,
+  ) {}
+
+  public static empty(): PrivateContextInputs {
+    return new PrivateContextInputs(CallContext.empty(), BlockHeader.empty(), TxContext.empty(), 0);
+  }
+
+  public toFields(): Fr[] {
+    return serializeToFields([this.callContext, this.historicalHeader, this.txContext, this.startSideEffectCounter]);
+  }
+}

package/src/kernel/private_kernel_circuit_public_inputs.ts

@@ -0,0 +1,102 @@
+import { Fr } from '@aztec/foundation/fields';
+import { bufferSchemaFor } from '@aztec/foundation/schemas';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { AztecAddress } from '../aztec-address/index.js';
+import { TxConstantData } from '../tx/tx_constant_data.js';
+import { PrivateAccumulatedData } from './private_accumulated_data.js';
+import { PrivateValidationRequests } from './private_validation_requests.js';
+import { PublicCallRequest } from './public_call_request.js';
+
+/**
+ * Public inputs to the inner private kernel circuit
+ */
+export class PrivateKernelCircuitPublicInputs {
+  constructor(
+    /**
+     * Data which is not modified by the circuits.
+     */
+    public constants: TxConstantData,
+    /**
+     * The side effect counter that non-revertible side effects are all beneath.
+     */
+    public minRevertibleSideEffectCounter: Fr,
+    /**
+     * Validation requests accumulated from public functions.
+     */
+    public validationRequests: PrivateValidationRequests,
+    /**
+     * Data accumulated from both public and private circuits.
+     */
+    public end: PrivateAccumulatedData,
+    /**
+     * The call request for the public teardown function
+     */
+    public publicTeardownCallRequest: PublicCallRequest,
+    /**
+     * The address of the fee payer for the transaction
+     */
+    public feePayer: AztecAddress,
+    /**
+     * Wether this is a private only tx or not
+     */
+    public isPrivateOnly: boolean,
+    /**
+     * The nullifier that will be used for nonce generation
+     */
+    public claimedFirstNullifier: Fr,
+  ) {}
+
+  static get schema() {
+    return bufferSchemaFor(PrivateKernelCircuitPublicInputs);
+  }
+
+  toJSON() {
+    return this.toBuffer();
+  }
+
+  toBuffer() {
+    return serializeToBuffer(
+      this.constants,
+      this.minRevertibleSideEffectCounter,
+      this.validationRequests,
+      this.end,
+      this.publicTeardownCallRequest,
+      this.feePayer,
+      this.isPrivateOnly,
+      this.claimedFirstNullifier,
+    );
+  }
+
+  /**
+   * Deserializes from a buffer or reader, corresponding to a write in cpp.
+   * @param buffer - Buffer or reader to read from.
+   * @returns A new instance of PrivateKernelInnerCircuitPublicInputs.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateKernelCircuitPublicInputs {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateKernelCircuitPublicInputs(
+      reader.readObject(TxConstantData),
+      reader.readObject(Fr),
+      reader.readObject(PrivateValidationRequests),
+      reader.readObject(PrivateAccumulatedData),
+      reader.readObject(PublicCallRequest),
+      reader.readObject(AztecAddress),
+      reader.readBoolean(),
+      reader.readObject(Fr),
+    );
+  }
+
+  static empty() {
+    return new PrivateKernelCircuitPublicInputs(
+      TxConstantData.empty(),
+      Fr.zero(),
+      PrivateValidationRequests.empty(),
+      PrivateAccumulatedData.empty(),
+      PublicCallRequest.empty(),
+      AztecAddress.ZERO,
+      false,
+      Fr.zero(),
+    );
+  }
+}

package/src/kernel/private_kernel_data.ts

@@ -0,0 +1,61 @@
+import { CLIENT_IVC_VERIFICATION_KEY_LENGTH_IN_FIELDS, VK_TREE_HEIGHT } from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, type Tuple, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import type { UInt32 } from '../types/shared.js';
+import { VerificationKeyAsFields } from '../vks/verification_key.js';
+import { PrivateKernelCircuitPublicInputs } from './private_kernel_circuit_public_inputs.js';
+
+/**
+ * Data of the previous kernel iteration in the chain of kernels.
+ */
+export class PrivateKernelData {
+  // NOTE: as of move to honk and client IVC, previous private kernels no longer come with their proof
+  // as we do client IVC not recursive verification. We need to ensure the public inputs here is properly constrained, TODO(https://github.com/AztecProtocol/barretenberg/issues/1048)
+  constructor(
+    /**
+     * Public inputs of the previous kernel.
+     */
+    public publicInputs: PrivateKernelCircuitPublicInputs,
+    /**
+     * Verification key of the previous kernel.
+     */
+    public vk: VerificationKeyAsFields,
+    /**
+     * Index of the previous kernel's vk in a tree of vks.
+     */
+    public vkIndex: UInt32,
+    /**
+     * Sibling path of the previous kernel's vk in a tree of vks.
+     */
+    public vkPath: Tuple<Fr, typeof VK_TREE_HEIGHT>,
+  ) {}
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer() {
+    return serializeToBuffer(this.publicInputs, this.vk, this.vkIndex, this.vkPath);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateKernelData {
+    const reader = BufferReader.asReader(buffer);
+    return new this(
+      reader.readObject(PrivateKernelCircuitPublicInputs),
+      reader.readObject(VerificationKeyAsFields),
+      reader.readNumber(),
+      reader.readArray(VK_TREE_HEIGHT, Fr),
+    );
+  }
+
+  static empty(): PrivateKernelData {
+    return new PrivateKernelData(
+      PrivateKernelCircuitPublicInputs.empty(),
+      VerificationKeyAsFields.makeFake(CLIENT_IVC_VERIFICATION_KEY_LENGTH_IN_FIELDS),
+      0,
+      makeTuple(VK_TREE_HEIGHT, Fr.zero),
+    );
+  }
+}

package/src/kernel/private_kernel_init_circuit_private_inputs.ts

@@ -0,0 +1,68 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { TxRequest } from '../tx/tx_request.js';
+import { PrivateCallData } from './private_call_data.js';
+
+/**
+ * Input to the private kernel circuit - initial call.
+ */
+export class PrivateKernelInitCircuitPrivateInputs {
+  constructor(
+    /**
+     * The transaction request which led to the creation of these inputs.
+     */
+    public txRequest: TxRequest,
+    /**
+     * The root of the vk tree.
+     */
+    public vkTreeRoot: Fr,
+    /**
+     * The root of the protocol contract tree.
+     */
+    public protocolContractTreeRoot: Fr,
+    /**
+     * Private calldata corresponding to this iteration of the kernel.
+     */
+    public privateCall: PrivateCallData,
+    /**
+     * Wether this tx will make public calls or not.
+     */
+    public isPrivateOnly: boolean,
+    /**
+     * A hint to what will be the first nullifier of the transaction, used for nonce generation.
+     */
+    public firstNullifierHint: Fr,
+  ) {}
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer() {
+    return serializeToBuffer(
+      this.txRequest,
+      this.vkTreeRoot,
+      this.protocolContractTreeRoot,
+      this.privateCall,
+      this.firstNullifierHint,
+    );
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateKernelInitCircuitPrivateInputs {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateKernelInitCircuitPrivateInputs(
+      reader.readObject(TxRequest),
+      Fr.fromBuffer(reader),
+      Fr.fromBuffer(reader),
+      reader.readObject(PrivateCallData),
+      reader.readBoolean(),
+      Fr.fromBuffer(reader),
+    );
+  }
+}

package/src/kernel/private_kernel_inner_circuit_private_inputs.ts

@@ -0,0 +1,41 @@
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { PrivateCallData } from './private_call_data.js';
+import { PrivateKernelData } from './private_kernel_data.js';
+
+/**
+ * Input to the private kernel circuit - Inner call.
+ */
+export class PrivateKernelInnerCircuitPrivateInputs {
+  constructor(
+    /**
+     * The previous kernel data
+     */
+    public previousKernel: PrivateKernelData,
+    /**
+     * Private calldata corresponding to this iteration of the kernel.
+     */
+    public privateCall: PrivateCallData,
+  ) {}
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer() {
+    return serializeToBuffer(this.previousKernel, this.privateCall);
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateKernelInnerCircuitPrivateInputs {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateKernelInnerCircuitPrivateInputs(
+      reader.readObject(PrivateKernelData),
+      reader.readObject(PrivateCallData),
+    );
+  }
+}

package/src/kernel/private_kernel_prover_profile_result.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+
+export const PrivateKernelProverProfileResultSchema = z.object({
+  gateCounts: z.array(z.object({ circuitName: z.string(), gateCount: z.number() })),
+});
+
+export type PrivateKernelProverProfileResult = z.infer<typeof PrivateKernelProverProfileResultSchema>;