@aztec/stdlib 0.77.0-testnet-ignition.17

package/src/kernel/log_hash.ts

@@ -0,0 +1,91 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { inspect } from 'util';
+
+import { AztecAddress } from '../aztec-address/index.js';
+import type { Ordered } from './utils/interfaces.js';
+
+export class LogHash implements Ordered {
+  constructor(public value: Fr, public counter: number, public length: number) {}
+
+  toFields(): Fr[] {
+    return [this.value, new Fr(this.counter), new Fr(this.length)];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new LogHash(reader.readField(), reader.readU32(), reader.readU32());
+  }
+
+  isEmpty() {
+    return this.value.isZero() && !this.length && !this.counter;
+  }
+
+  static empty() {
+    return new LogHash(Fr.zero(), 0, 0);
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.value, this.counter, this.length);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new LogHash(Fr.fromBuffer(reader), reader.readNumber(), reader.readNumber());
+  }
+
+  toString(): string {
+    return `value=${this.value} counter=${this.counter} length=${this.length}`;
+  }
+
+  scope(contractAddress: AztecAddress) {
+    return new ScopedLogHash(this, contractAddress);
+  }
+
+  [inspect.custom](): string {
+    return `LogHash { ${this.toString()} }`;
+  }
+}
+
+export class ScopedLogHash implements Ordered {
+  constructor(public logHash: LogHash, public contractAddress: AztecAddress) {}
+
+  get counter() {
+    return this.logHash.counter;
+  }
+
+  get value() {
+    return this.logHash.value;
+  }
+
+  toFields(): Fr[] {
+    return [...this.logHash.toFields(), this.contractAddress.toField()];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new ScopedLogHash(reader.readObject(LogHash), AztecAddress.fromField(reader.readField()));
+  }
+
+  isEmpty() {
+    return this.logHash.isEmpty() && this.contractAddress.isZero();
+  }
+
+  static empty() {
+    return new ScopedLogHash(LogHash.empty(), AztecAddress.ZERO);
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.logHash, this.contractAddress);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new ScopedLogHash(LogHash.fromBuffer(reader), AztecAddress.fromBuffer(reader));
+  }
+
+  toString(): string {
+    return `logHash=${this.logHash} contractAddress=${this.contractAddress}`;
+  }
+}

package/src/kernel/note_hash.ts

@@ -0,0 +1,85 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { AztecAddress } from '../aztec-address/index.js';
+import type { Ordered } from './utils/interfaces.js';
+
+export class NoteHash {
+  constructor(public value: Fr, public counter: number) {}
+
+  toFields(): Fr[] {
+    return [this.value, new Fr(this.counter)];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new NoteHash(reader.readField(), reader.readU32());
+  }
+
+  isEmpty() {
+    return this.value.isZero() && !this.counter;
+  }
+
+  static empty() {
+    return new NoteHash(Fr.zero(), 0);
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.value, this.counter);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new NoteHash(Fr.fromBuffer(reader), reader.readNumber());
+  }
+
+  toString(): string {
+    return `value=${this.value} counter=${this.counter}`;
+  }
+
+  scope(contractAddress: AztecAddress) {
+    return new ScopedNoteHash(this, contractAddress);
+  }
+}
+
+export class ScopedNoteHash implements Ordered {
+  constructor(public noteHash: NoteHash, public contractAddress: AztecAddress) {}
+
+  get counter() {
+    return this.noteHash.counter;
+  }
+
+  get value() {
+    return this.noteHash.value;
+  }
+
+  toFields(): Fr[] {
+    return [...this.noteHash.toFields(), this.contractAddress.toField()];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new ScopedNoteHash(reader.readObject(NoteHash), AztecAddress.fromField(reader.readField()));
+  }
+
+  isEmpty() {
+    return this.noteHash.isEmpty() && this.contractAddress.isZero();
+  }
+
+  static empty() {
+    return new ScopedNoteHash(NoteHash.empty(), AztecAddress.ZERO);
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.noteHash, this.contractAddress);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new ScopedNoteHash(NoteHash.fromBuffer(reader), AztecAddress.fromBuffer(reader));
+  }
+
+  toString(): string {
+    return `noteHash=${this.noteHash} contractAddress=${this.contractAddress}`;
+  }
+}

package/src/kernel/nullifier.ts

@@ -0,0 +1,89 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize';
+
+import { AztecAddress } from '../aztec-address/index.js';
+import type { Ordered } from './utils/interfaces.js';
+
+export class Nullifier implements Ordered {
+  constructor(public value: Fr, public counter: number, public noteHash: Fr) {}
+
+  toFields(): Fr[] {
+    return [this.value, new Fr(this.counter), this.noteHash];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new Nullifier(reader.readField(), reader.readU32(), reader.readField());
+  }
+
+  isEmpty() {
+    return this.value.isZero() && !this.counter && this.noteHash.isZero();
+  }
+
+  static empty() {
+    return new Nullifier(Fr.zero(), 0, Fr.zero());
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.value, this.counter, this.noteHash);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new Nullifier(Fr.fromBuffer(reader), reader.readNumber(), Fr.fromBuffer(reader));
+  }
+
+  toString(): string {
+    return `value=${this.value} counter=${this.counter} noteHash=${this.noteHash}`;
+  }
+
+  scope(contractAddress: AztecAddress) {
+    return new ScopedNullifier(this, contractAddress);
+  }
+}
+
+export class ScopedNullifier implements Ordered {
+  constructor(public nullifier: Nullifier, public contractAddress: AztecAddress) {}
+
+  get counter() {
+    return this.nullifier.counter;
+  }
+
+  get value() {
+    return this.nullifier.value;
+  }
+
+  get nullifiedNoteHash() {
+    return this.nullifier.noteHash;
+  }
+
+  toFields(): Fr[] {
+    return [...this.nullifier.toFields(), this.contractAddress.toField()];
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new ScopedNullifier(reader.readObject(Nullifier), AztecAddress.fromField(reader.readField()));
+  }
+
+  isEmpty() {
+    return this.nullifier.isEmpty() && this.contractAddress.isZero();
+  }
+
+  static empty() {
+    return new ScopedNullifier(Nullifier.empty(), AztecAddress.ZERO);
+  }
+
+  toBuffer(): Buffer {
+    return serializeToBuffer(this.nullifier, this.contractAddress);
+  }
+
+  static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new ScopedNullifier(Nullifier.fromBuffer(reader), AztecAddress.fromBuffer(reader));
+  }
+
+  toString(): string {
+    return `nullifier=${this.nullifier} contractAddress=${this.contractAddress}`;
+  }
+}

package/src/kernel/private_accumulated_data.ts

@@ -0,0 +1,113 @@
+import {
+  MAX_CONTRACT_CLASS_LOGS_PER_TX,
+  MAX_ENQUEUED_CALLS_PER_TX,
+  MAX_L2_TO_L1_MSGS_PER_TX,
+  MAX_NOTE_HASHES_PER_TX,
+  MAX_NULLIFIERS_PER_TX,
+  MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX,
+  MAX_PRIVATE_LOGS_PER_TX,
+} from '@aztec/constants';
+import { makeTuple } from '@aztec/foundation/array';
+import { BufferReader, type Tuple, serializeToBuffer } from '@aztec/foundation/serialize';
+import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
+
+import { ScopedL2ToL1Message } from '../messaging/l2_to_l1_message.js';
+import { ScopedLogHash } from './log_hash.js';
+import { ScopedNoteHash } from './note_hash.js';
+import { ScopedNullifier } from './nullifier.js';
+import { PrivateCallRequest } from './private_call_request.js';
+import { ScopedPrivateLogData } from './private_log_data.js';
+import { CountedPublicCallRequest } from './public_call_request.js';
+
+/**
+ * Specific accumulated data structure for the final ordering private kernel circuit. It is included
+ *  in the final public inputs of private kernel circuit.
+ */
+export class PrivateAccumulatedData {
+  constructor(
+    /**
+     * The new note hashes made in this transaction.
+     */
+    public noteHashes: Tuple<ScopedNoteHash, typeof MAX_NOTE_HASHES_PER_TX>,
+    /**
+     * The new nullifiers made in this transaction.
+     */
+    public nullifiers: Tuple<ScopedNullifier, typeof MAX_NULLIFIERS_PER_TX>,
+    /**
+     * All the new L2 to L1 messages created in this transaction.
+     */
+    public l2ToL1Msgs: Tuple<ScopedL2ToL1Message, typeof MAX_L2_TO_L1_MSGS_PER_TX>,
+    /**
+     * Accumulated logs from all the previous kernel iterations.
+     */
+    public privateLogs: Tuple<ScopedPrivateLogData, typeof MAX_PRIVATE_LOGS_PER_TX>,
+    /**
+     * Accumulated contract class logs from all the previous kernel iterations.
+     * Note: Truncated to 31 bytes to fit in Fr.
+     */
+    public contractClassLogsHashes: Tuple<ScopedLogHash, typeof MAX_CONTRACT_CLASS_LOGS_PER_TX>,
+    /**
+     * Accumulated public call requests from all the previous kernel iterations.
+     */
+    public publicCallRequests: Tuple<CountedPublicCallRequest, typeof MAX_ENQUEUED_CALLS_PER_TX>,
+    /**
+     * Current private call stack.
+     */
+    public privateCallStack: Tuple<PrivateCallRequest, typeof MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX>,
+  ) {}
+
+  toBuffer() {
+    return serializeToBuffer(
+      this.noteHashes,
+      this.nullifiers,
+      this.l2ToL1Msgs,
+      this.privateLogs,
+      this.contractClassLogsHashes,
+      this.publicCallRequests,
+      this.privateCallStack,
+    );
+  }
+
+  toString() {
+    return bufferToHex(this.toBuffer());
+  }
+
+  /**
+   * Deserializes from a buffer or reader, corresponding to a write in cpp.
+   * @param buffer - Buffer or reader to read from.
+   * @returns Deserialized object.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateAccumulatedData {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateAccumulatedData(
+      reader.readArray(MAX_NOTE_HASHES_PER_TX, ScopedNoteHash),
+      reader.readArray(MAX_NULLIFIERS_PER_TX, ScopedNullifier),
+      reader.readArray(MAX_L2_TO_L1_MSGS_PER_TX, ScopedL2ToL1Message),
+      reader.readArray(MAX_PRIVATE_LOGS_PER_TX, ScopedPrivateLogData),
+      reader.readArray(MAX_CONTRACT_CLASS_LOGS_PER_TX, ScopedLogHash),
+      reader.readArray(MAX_ENQUEUED_CALLS_PER_TX, CountedPublicCallRequest),
+      reader.readArray(MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, PrivateCallRequest),
+    );
+  }
+
+  /**
+   * Deserializes from a string, corresponding to a write in cpp.
+   * @param str - String to read from.
+   * @returns Deserialized object.
+   */
+  static fromString(str: string) {
+    return PrivateAccumulatedData.fromBuffer(hexToBuffer(str));
+  }
+
+  static empty() {
+    return new PrivateAccumulatedData(
+      makeTuple(MAX_NOTE_HASHES_PER_TX, ScopedNoteHash.empty),
+      makeTuple(MAX_NULLIFIERS_PER_TX, ScopedNullifier.empty),
+      makeTuple(MAX_L2_TO_L1_MSGS_PER_TX, ScopedL2ToL1Message.empty),
+      makeTuple(MAX_PRIVATE_LOGS_PER_TX, ScopedPrivateLogData.empty),
+      makeTuple(MAX_CONTRACT_CLASS_LOGS_PER_TX, ScopedLogHash.empty),
+      makeTuple(MAX_ENQUEUED_CALLS_PER_TX, CountedPublicCallRequest.empty),
+      makeTuple(MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, PrivateCallRequest.empty),
+    );
+  }
+}

package/src/kernel/private_call_data.ts

@@ -0,0 +1,207 @@
+import {
+  FUNCTION_TREE_HEIGHT,
+  PROTOCOL_CONTRACT_TREE_HEIGHT,
+  PUBLIC_DATA_TREE_HEIGHT,
+  UPDATES_VALUE_SIZE,
+} from '@aztec/constants';
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { MembershipWitness } from '@aztec/foundation/trees';
+import type { FieldsOf } from '@aztec/foundation/types';
+
+import { PublicKeys } from '../keys/public_keys.js';
+import { SharedMutableValues } from '../shared_mutable/shared_mutable_values.js';
+import { ProtocolContractLeafPreimage, PublicDataTreeLeafPreimage } from '../trees/index.js';
+import { VerificationKeyAsFields } from '../vks/verification_key.js';
+import { PrivateCircuitPublicInputs } from './private_circuit_public_inputs.js';
+
+/**
+ * Private call data.
+ */
+export class PrivateCallData {
+  constructor(
+    /**
+     * Public inputs of the private function circuit.
+     */
+    public publicInputs: PrivateCircuitPublicInputs,
+
+    /**
+     * The verification key for the function being invoked.
+     */
+    public vk: VerificationKeyAsFields,
+
+    /**
+     * Hints for the validation of the vk
+     */
+    public verificationKeyHints: PrivateVerificationKeyHints,
+  ) {}
+
+  /**
+   * Serialize into a field array. Low-level utility.
+   * @param fields - Object with fields.
+   * @returns The array.
+   */
+  static getFields(fields: FieldsOf<PrivateCallData>) {
+    return [fields.publicInputs, fields.vk, fields.verificationKeyHints] as const;
+  }
+
+  static from(fields: FieldsOf<PrivateCallData>): PrivateCallData {
+    return new PrivateCallData(...PrivateCallData.getFields(fields));
+  }
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer(): Buffer {
+    return serializeToBuffer(...PrivateCallData.getFields(this));
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateCallData {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateCallData(
+      reader.readObject(PrivateCircuitPublicInputs),
+      reader.readObject(VerificationKeyAsFields),
+      reader.readObject(PrivateVerificationKeyHints),
+    );
+  }
+}
+
+export class PrivateVerificationKeyHints {
+  constructor(
+    /**
+     * Artifact hash of the contract class for this private call.
+     */
+    public contractClassArtifactHash: Fr,
+    /**
+     * Public bytecode commitment for the contract class for this private call.
+     */
+    public contractClassPublicBytecodeCommitment: Fr,
+    /**
+     * Public keys hash of the contract instance.
+     */
+    public publicKeys: PublicKeys,
+    /**
+     * Salted initialization hash of the contract instance.
+     */
+    public saltedInitializationHash: Fr,
+    /**
+     * The membership witness for the function leaf corresponding to the function being invoked.
+     */
+    public functionLeafMembershipWitness: MembershipWitness<typeof FUNCTION_TREE_HEIGHT>,
+    /**
+     * The membership witness for the protocolContractLeaf.
+     */
+    public protocolContractMembershipWitness: MembershipWitness<typeof PROTOCOL_CONTRACT_TREE_HEIGHT>,
+    /**
+     * The leaf of the protocol contract tree, of either:
+     *  The protocol contract being called.
+     *  The low leaf showing that the address of the contract being called is not in the tree.
+     */
+    public protocolContractLeaf: ProtocolContractLeafPreimage,
+    /**
+     * The hash of the ACIR of the function being invoked.
+     */
+    public acirHash: Fr,
+
+    public updatedClassIdHints: UpdatedClassIdHints,
+  ) {}
+
+  /**
+   * Serialize into a field array. Low-level utility.
+   * @param fields - Object with fields.
+   * @returns The array.
+   */
+  static getFields(fields: FieldsOf<PrivateVerificationKeyHints>) {
+    return [
+      fields.contractClassArtifactHash,
+      fields.contractClassPublicBytecodeCommitment,
+      fields.publicKeys,
+      fields.saltedInitializationHash,
+      fields.functionLeafMembershipWitness,
+      fields.protocolContractMembershipWitness,
+      fields.protocolContractLeaf,
+      fields.acirHash,
+      fields.updatedClassIdHints,
+    ] as const;
+  }
+
+  static from(fields: FieldsOf<PrivateVerificationKeyHints>): PrivateVerificationKeyHints {
+    return new PrivateVerificationKeyHints(...PrivateVerificationKeyHints.getFields(fields));
+  }
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer(): Buffer {
+    return serializeToBuffer(...PrivateVerificationKeyHints.getFields(this));
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): PrivateVerificationKeyHints {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateVerificationKeyHints(
+      reader.readObject(Fr),
+      reader.readObject(Fr),
+      reader.readObject(PublicKeys),
+      reader.readObject(Fr),
+      reader.readObject(MembershipWitness.deserializer(FUNCTION_TREE_HEIGHT)),
+      reader.readObject(MembershipWitness.deserializer(PROTOCOL_CONTRACT_TREE_HEIGHT)),
+      reader.readObject(ProtocolContractLeafPreimage),
+      reader.readObject(Fr),
+      reader.readObject(UpdatedClassIdHints),
+    );
+  }
+}
+
+export class UpdatedClassIdHints {
+  constructor(
+    public updatedClassIdWitness: MembershipWitness<typeof PUBLIC_DATA_TREE_HEIGHT>,
+    public updatedClassIdLeaf: PublicDataTreeLeafPreimage,
+    public updatedClassIdValues: SharedMutableValues,
+  ) {}
+
+  static getFields(fields: FieldsOf<UpdatedClassIdHints>) {
+    return [fields.updatedClassIdWitness, fields.updatedClassIdLeaf, fields.updatedClassIdValues] as const;
+  }
+
+  static from(fields: FieldsOf<UpdatedClassIdHints>): UpdatedClassIdHints {
+    return new UpdatedClassIdHints(...UpdatedClassIdHints.getFields(fields));
+  }
+
+  /**
+   * Serialize this as a buffer.
+   * @returns The buffer.
+   */
+  toBuffer(): Buffer {
+    return serializeToBuffer(...UpdatedClassIdHints.getFields(this));
+  }
+
+  /**
+   * Deserializes from a buffer or reader.
+   * @param buffer - Buffer or reader to read from.
+   * @returns The deserialized instance.
+   */
+  static fromBuffer(buffer: Buffer | BufferReader): UpdatedClassIdHints {
+    const reader = BufferReader.asReader(buffer);
+    return new UpdatedClassIdHints(
+      reader.readObject(MembershipWitness.deserializer(PUBLIC_DATA_TREE_HEIGHT)),
+      reader.readObject(PublicDataTreeLeafPreimage),
+      reader.readObject({
+        fromBuffer(reader) {
+          return SharedMutableValues.fromBuffer(reader, UPDATES_VALUE_SIZE);
+        },
+      }),
+    );
+  }
+}

package/src/kernel/private_call_request.ts

@@ -0,0 +1,99 @@
+import { Fr } from '@aztec/foundation/fields';
+import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize';
+
+import { CallContext } from '../tx/call_context.js';
+
+export class PrivateCallRequest {
+  constructor(
+    /**
+     * The call context of the call.
+     */
+    public callContext: CallContext,
+    /**
+     * The hash of the arguments of the call.
+     */
+    public argsHash: Fr,
+    /**
+     * The hash of the return values of the call.
+     */
+    public returnsHash: Fr,
+    /**
+     * The start counter of the call.
+     */
+    public startSideEffectCounter: number,
+    /**
+     * The end counter of the call.
+     */
+    public endSideEffectCounter: number,
+  ) {}
+
+  toFields(): Fr[] {
+    return serializeToFields([
+      this.callContext,
+      this.argsHash,
+      this.returnsHash,
+      this.startSideEffectCounter,
+      this.endSideEffectCounter,
+    ]);
+  }
+
+  static fromFields(fields: Fr[] | FieldReader) {
+    const reader = FieldReader.asReader(fields);
+    return new PrivateCallRequest(
+      reader.readObject(CallContext),
+      reader.readField(),
+      reader.readField(),
+      reader.readU32(),
+      reader.readU32(),
+    );
+  }
+
+  toBuffer() {
+    return serializeToBuffer(
+      this.callContext,
+      this.argsHash,
+      this.returnsHash,
+      this.startSideEffectCounter,
+      this.endSideEffectCounter,
+    );
+  }
+
+  public static fromBuffer(buffer: Buffer | BufferReader) {
+    const reader = BufferReader.asReader(buffer);
+    return new PrivateCallRequest(
+      reader.readObject(CallContext),
+      Fr.fromBuffer(reader),
+      Fr.fromBuffer(reader),
+      reader.readNumber(),
+      reader.readNumber(),
+    );
+  }
+
+  isEmpty() {
+    return (
+      this.callContext.isEmpty() &&
+      this.argsHash.isZero() &&
+      this.returnsHash.isZero() &&
+      this.startSideEffectCounter === 0 &&
+      this.endSideEffectCounter === 0
+    );
+  }
+
+  public static empty() {
+    return new PrivateCallRequest(CallContext.empty(), Fr.ZERO, Fr.ZERO, 0, 0);
+  }
+
+  equals(callRequest: PrivateCallRequest) {
+    return (
+      callRequest.callContext.equals(this.callContext) &&
+      callRequest.argsHash.equals(this.argsHash) &&
+      callRequest.returnsHash.equals(this.returnsHash) &&
+      callRequest.startSideEffectCounter === this.startSideEffectCounter &&
+      callRequest.endSideEffectCounter === this.endSideEffectCounter
+    );
+  }
+
+  toString() {
+    return `PrivateCallRequest(callContext: ${this.callContext}, argsHash: ${this.argsHash}, returnsHash: ${this.returnsHash}, startSideEffectCounter: ${this.startSideEffectCounter}, endSideEffectCounter: ${this.endSideEffectCounter})`;
+  }
+}