@aztec/simulator 0.0.1-commit.b655e406 → 0.0.1-commit.b9865e97

package/src/public/avm/avm_memory_types.ts

@@ -1,436 +0,0 @@
-import {
-  MEM_TAG_FF,
-  MEM_TAG_U1,
-  MEM_TAG_U8,
-  MEM_TAG_U16,
-  MEM_TAG_U32,
-  MEM_TAG_U64,
-  MEM_TAG_U128,
-} from '@aztec/constants';
-import { toBufferBE } from '@aztec/foundation/bigint-buffer';
-import { Fr } from '@aztec/foundation/fields';
-import { type Logger, createLogger } from '@aztec/foundation/log';
-import type { FunctionsOf } from '@aztec/foundation/types';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-
-import { strict as assert } from 'assert';
-
-import { InvalidTagValueError, MemorySliceOutOfRangeError, TagCheckError } from './errors.js';
-
-/** MemoryValue gathers the common operations for all memory types. */
-export abstract class MemoryValue {
-  public abstract add(rhs: MemoryValue): MemoryValue;
-  public abstract sub(rhs: MemoryValue): MemoryValue;
-  public abstract mul(rhs: MemoryValue): MemoryValue;
-  public abstract div(rhs: MemoryValue): MemoryValue;
-
-  public abstract equals(rhs: MemoryValue): boolean;
-  public abstract lt(rhs: MemoryValue): boolean;
-
-  // We need this to be able to build an instance of the subclasses.
-  public abstract build(n: bigint): MemoryValue;
-
-  // Use sparingly.
-  public abstract toBigInt(): bigint;
-  public getTag(): TypeTag {
-    return TaggedMemory.getTag(this);
-  }
-
-  // To Buffer
-  public abstract toBuffer(): Buffer;
-
-  // To field
-  public toFr(): Fr {
-    return new Fr(this.toBigInt());
-  }
-
-  public toAztecAddress(): AztecAddress {
-    return new AztecAddress(this.toFr());
-  }
-
-  // To number. Throws if exceeds max safe int.
-  public toNumber(): number {
-    return this.toFr().toNumber();
-  }
-
-  public toString(): string {
-    return `${this.constructor.name}(0x${this.toBigInt().toString(16)})`;
-  }
-}
-
-/** IntegralValue gathers the common operations for all integral memory types. */
-export abstract class IntegralValue extends MemoryValue {
-  public abstract shl(rhs: IntegralValue): IntegralValue;
-  public abstract shr(rhs: IntegralValue): IntegralValue;
-  public abstract and(rhs: IntegralValue): IntegralValue;
-  public abstract or(rhs: IntegralValue): IntegralValue;
-  public abstract xor(rhs: IntegralValue): IntegralValue;
-  public abstract not(): IntegralValue;
-}
-
-/**
- * This function creates a class for unsigned integers of a given number of bits.
- * In TypeScript terms, it's a class mixin.
- **/
-function UnsignedIntegerClassFactory(bits: number) {
-  return class NewUintClass extends IntegralValue {
-    static readonly bits: number = bits;
-    static readonly mod: bigint = 1n << BigInt(bits);
-    static readonly bitmask: bigint = this.mod - 1n;
-    public readonly n: bigint; // Cannot be private due to TS limitations.
-
-    public constructor(n: bigint | number) {
-      super();
-      this.n = BigInt(n);
-      assert(n >= 0n, `${this.constructor.name} cannot handle negative values: ${n}.`);
-      assert(n < NewUintClass.mod, `Value ${n} is too large for ${this.constructor.name}.`);
-    }
-
-    public build(n: bigint): NewUintClass {
-      return new this.constructor.prototype.constructor(n);
-    }
-
-    public add(rhs: NewUintClass): NewUintClass {
-      return this.build((this.n + rhs.n) & NewUintClass.bitmask);
-    }
-
-    public sub(rhs: NewUintClass): NewUintClass {
-      const res: bigint = this.n - rhs.n;
-      return this.build(res >= 0 ? res : res + NewUintClass.mod);
-    }
-
-    public mul(rhs: NewUintClass): NewUintClass {
-      return this.build((this.n * rhs.n) & NewUintClass.bitmask);
-    }
-
-    public div(rhs: NewUintClass): NewUintClass {
-      return this.build(this.n / rhs.n);
-    }
-
-    // No sign extension.
-    public shr(rhs: NewUintClass): NewUintClass {
-      // Note that this.n is >= 0 by class invariant.
-      return this.build(this.n >> rhs.n);
-    }
-
-    public shl(rhs: NewUintClass): NewUintClass {
-      const shiftAmount = rhs.n;
-      const bitSize = BigInt(NewUintClass.bits);
-
-      // Shifting by more than the bit size always results in 0
-      if (shiftAmount >= bitSize) {
-        return this.build(0n);
-      }
-
-      return this.build((this.n << shiftAmount) & NewUintClass.bitmask);
-    }
-
-    public and(rhs: NewUintClass): NewUintClass {
-      return this.build(this.n & rhs.n);
-    }
-
-    public or(rhs: NewUintClass): NewUintClass {
-      return this.build(this.n | rhs.n);
-    }
-
-    public xor(rhs: NewUintClass): NewUintClass {
-      return this.build(this.n ^ rhs.n);
-    }
-
-    public not(): NewUintClass {
-      return this.build(~this.n & NewUintClass.bitmask);
-    }
-
-    public equals(rhs: NewUintClass): boolean {
-      return this.n === rhs.n;
-    }
-
-    public lt(rhs: NewUintClass): boolean {
-      return this.n < rhs.n;
-    }
-
-    public toBigInt(): bigint {
-      return this.n;
-    }
-
-    public toBuffer(): Buffer {
-      if (bits < 8) {
-        return toBufferBE(this.n, 1);
-      }
-      return toBufferBE(this.n, bits / 8);
-    }
-  };
-}
-
-// Now we can create the classes for each unsigned integer type.
-// We extend instead of just assigning so that the class has the right name.
-// Otherwise they are all called "NewUintClass".
-export class Uint1 extends UnsignedIntegerClassFactory(1) {}
-export class Uint8 extends UnsignedIntegerClassFactory(8) {}
-export class Uint16 extends UnsignedIntegerClassFactory(16) {}
-export class Uint32 extends UnsignedIntegerClassFactory(32) {}
-export class Uint64 extends UnsignedIntegerClassFactory(64) {}
-export class Uint128 extends UnsignedIntegerClassFactory(128) {}
-
-export class Field extends MemoryValue {
-  public static readonly MODULUS: bigint = Fr.MODULUS;
-  private readonly rep: Fr;
-
-  constructor(v: number | bigint | Fr | Buffer) {
-    super();
-    this.rep = new Fr(v);
-  }
-
-  public build(n: bigint): Field {
-    return new Field(n);
-  }
-
-  public add(rhs: Field): Field {
-    return new Field(this.rep.add(rhs.rep));
-  }
-
-  public sub(rhs: Field): Field {
-    return new Field(this.rep.sub(rhs.rep));
-  }
-
-  public mul(rhs: Field): Field {
-    return new Field(this.rep.mul(rhs.rep));
-  }
-
-  // Euclidean division.
-  public div(rhs: Field): Field {
-    return new Field(this.rep.ediv(rhs.rep));
-  }
-
-  // Field division.
-  public fdiv(rhs: Field): Field {
-    return new Field(this.rep.div(rhs.rep));
-  }
-
-  public equals(rhs: Field): boolean {
-    return this.rep.equals(rhs.rep);
-  }
-
-  public lt(rhs: Field): boolean {
-    return this.rep.lt(rhs.rep);
-  }
-
-  public toBigInt(): bigint {
-    return this.rep.toBigInt();
-  }
-
-  public toBuffer(): Buffer {
-    return this.rep.toBuffer();
-  }
-}
-
-export enum TypeTag {
-  FIELD = MEM_TAG_FF,
-  UINT1 = MEM_TAG_U1,
-  UINT8 = MEM_TAG_U8,
-  UINT16 = MEM_TAG_U16,
-  UINT32 = MEM_TAG_U32,
-  UINT64 = MEM_TAG_U64,
-  UINT128 = MEM_TAG_U128,
-  INVALID = MEM_TAG_U128 + 1,
-}
-
-// Lazy interface definition for tagged memory
-export type TaggedMemoryInterface = FunctionsOf<TaggedMemory>;
-
-export class TaggedMemory implements TaggedMemoryInterface {
-  static readonly log: Logger = createLogger('simulator:avm:memory');
-
-  // Whether to track and validate memory accesses for each instruction.
-  static readonly TRACK_MEMORY_ACCESSES = process.env.NODE_ENV === 'test';
-
-  // Memory is modelled by a map with key type being number.
-  // We however restrict the keys to be non-negative integers smaller than
-  // MAX_MEMORY_SIZE.
-  static readonly MAX_MEMORY_SIZE = Number(1n << 32n);
-  private _mem: Map<number, MemoryValue>;
-
-  constructor() {
-    this._mem = new Map<number, MemoryValue>();
-  }
-
-  public getMaxMemorySize(): number {
-    return TaggedMemory.MAX_MEMORY_SIZE;
-  }
-
-  public get(offset: number): MemoryValue {
-    return this.getAs<MemoryValue>(offset);
-  }
-
-  public getAs<T>(offset: number): T {
-    assert(Number.isInteger(offset) && offset < TaggedMemory.MAX_MEMORY_SIZE);
-    const word = this._mem.get(offset);
-    //TaggedMemory.log.trace(`Memory read: ${offset} -> ${word}`);
-    if (word === undefined) {
-      TaggedMemory.log.debug(`WARNING: Memory at offset ${offset} is undefined!`);
-      return new Field(0) as T;
-    }
-    return word as T;
-  }
-
-  public getSlice(offset: number, size: number): MemoryValue[] {
-    assert(Number.isInteger(offset) && Number.isInteger(size));
-
-    if (offset + size > TaggedMemory.MAX_MEMORY_SIZE) {
-      throw new MemorySliceOutOfRangeError(offset, size);
-    }
-
-    const slice = new Array<MemoryValue>(size);
-
-    for (let i = 0; i < size; i++) {
-      slice[i] = this._mem.get(offset + i) ?? new Field(0);
-    }
-
-    TaggedMemory.log.trace(`getSlice(${offset}, ${size}) = ${slice}`);
-    return slice;
-  }
-
-  public getSliceAs<T>(offset: number, size: number): T[] {
-    return this.getSlice(offset, size) as T[];
-  }
-
-  public getSliceTags(offset: number, size: number): TypeTag[] {
-    return this.getSlice(offset, size).map(TaggedMemory.getTag);
-  }
-
-  public set(offset: number, v: MemoryValue) {
-    assert(Number.isInteger(offset) && offset < TaggedMemory.MAX_MEMORY_SIZE);
-    this._mem.set(offset, v);
-    //TaggedMemory.log.trace(`Memory write: ${offset} <- ${v}`);
-  }
-
-  public setSlice(offset: number, slice: MemoryValue[]) {
-    assert(Number.isInteger(offset));
-
-    if (offset + slice.length > TaggedMemory.MAX_MEMORY_SIZE) {
-      throw new MemorySliceOutOfRangeError(offset, slice.length);
-    }
-
-    slice.forEach((element, idx) => {
-      this._mem.set(offset + idx, element);
-    });
-    TaggedMemory.log.trace(`setSlice(${offset}, ${slice})`);
-  }
-
-  public getTag(offset: number): TypeTag {
-    assert(Number.isInteger(offset) && offset < TaggedMemory.MAX_MEMORY_SIZE);
-    return TaggedMemory.getTag(this._mem.get(offset));
-  }
-
-  /**
-   * Check that the memory at the given offset matches the specified tag.
-   */
-  public checkTag(tag: TypeTag, offset: number) {
-    const gotTag = this.getTag(offset);
-    if (gotTag !== tag) {
-      throw TagCheckError.forOffset(offset, TypeTag[gotTag], TypeTag[tag]);
-    }
-  }
-
-  public static isValidMemoryAddressTag(tag: TypeTag) {
-    return tag === TypeTag.UINT32;
-  }
-
-  public static checkIsIntegralTag(tag: TypeTag) {
-    if (!INTEGRAL_TAGS.has(tag)) {
-      throw TagCheckError.forTag(TypeTag[tag], 'integral');
-    }
-  }
-
-  public static checkIsValidTag(tagNumber: number) {
-    if (!VALID_TAGS.has(tagNumber)) {
-      throw new InvalidTagValueError(tagNumber);
-    }
-  }
-
-  /**
-   * Check tags for memory at all of the specified offsets.
-   */
-  public checkTags(tag: TypeTag, ...offsets: number[]) {
-    for (const offset of offsets) {
-      this.checkTag(tag, offset);
-    }
-  }
-
-  /**
-   * Check that all tags at the given offsets are the same.
-   */
-  public checkTagsAreSame(offset0: number, offset1: number) {
-    const tag0 = this.getTag(offset0);
-    this.checkTag(tag0, offset1);
-  }
-
-  /**
-   * Check tags for all memory in the specified range.
-   */
-  public checkTagsRange(tag: TypeTag, startOffset: number, size: number) {
-    for (let offset = startOffset; offset < startOffset + size; offset++) {
-      this.checkTag(tag, offset);
-    }
-  }
-
-  public static getTag(v: MemoryValue | undefined): TypeTag {
-    if (v === undefined) {
-      return TypeTag.FIELD; // uninitialized memory is Field(0)
-    } else {
-      return TAG_FOR_MEM_VAL.get(v.constructor.name) ?? TypeTag.INVALID;
-    }
-  }
-
-  // Truncates the value to fit the type.
-  public static buildFromTagTruncating(v: bigint | number, tag: TypeTag): MemoryValue {
-    v = BigInt(v);
-    switch (tag) {
-      case TypeTag.FIELD:
-        return new Field(v);
-      case TypeTag.UINT1:
-        return new Uint1(v & 1n);
-      case TypeTag.UINT8:
-        return new Uint8(v & ((1n << 8n) - 1n));
-      case TypeTag.UINT16:
-        return new Uint16(v & ((1n << 16n) - 1n));
-      case TypeTag.UINT32:
-        return new Uint32(v & ((1n << 32n) - 1n));
-      case TypeTag.UINT64:
-        return new Uint64(v & ((1n << 64n) - 1n));
-      case TypeTag.UINT128:
-        return new Uint128(v & ((1n << 128n) - 1n));
-      default:
-        throw new InvalidTagValueError(tag);
-    }
-  }
-}
-
-const TAG_FOR_MEM_VAL = new Map<string, TypeTag>([
-  ['Field', TypeTag.FIELD],
-  ['Uint1', TypeTag.UINT1],
-  ['Uint8', TypeTag.UINT8],
-  ['Uint16', TypeTag.UINT16],
-  ['Uint32', TypeTag.UINT32],
-  ['Uint64', TypeTag.UINT64],
-  ['Uint128', TypeTag.UINT128],
-]);
-
-const VALID_TAGS = new Set([
-  TypeTag.FIELD,
-  TypeTag.UINT1,
-  TypeTag.UINT8,
-  TypeTag.UINT16,
-  TypeTag.UINT32,
-  TypeTag.UINT64,
-  TypeTag.UINT128,
-]);
-
-const INTEGRAL_TAGS = new Set([
-  TypeTag.UINT1,
-  TypeTag.UINT8,
-  TypeTag.UINT16,
-  TypeTag.UINT32,
-  TypeTag.UINT64,
-  TypeTag.UINT128,
-]);

package/src/public/avm/avm_simulator.ts

@@ -1,274 +0,0 @@
-import { Fr } from '@aztec/foundation/fields';
-import { type Logger, createLogger } from '@aztec/foundation/log';
-import { Timer } from '@aztec/foundation/timer';
-import type { AztecAddress } from '@aztec/stdlib/aztec-address';
-import type { GlobalVariables } from '@aztec/stdlib/tx';
-
-import { strict as assert } from 'assert';
-
-import { CheckedPublicExecutionError } from '../public_errors.js';
-import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
-import { AvmContext } from './avm_context.js';
-import { AvmContractCallResult } from './avm_contract_call_result.js';
-import { AvmExecutionEnvironment } from './avm_execution_environment.js';
-import type { Gas } from './avm_gas.js';
-import { AvmMachineState } from './avm_machine_state.js';
-import type { AvmSimulatorInterface } from './avm_simulator_interface.js';
-import { AvmRevertReason, InvalidProgramCounterError } from './errors.js';
-import type { Instruction } from './opcodes/instruction.js';
-import { revertReasonFromExceptionalHalt, revertReasonFromExplicitRevert } from './revert_reason.js';
-import {
-  INSTRUCTION_SET,
-  type InstructionSet,
-  decodeInstructionFromBytecode,
-} from './serialization/bytecode_serialization.js';
-
-type OpcodeTally = {
-  count: number;
-  gas: Gas;
-};
-
-export class AvmSimulator implements AvmSimulatorInterface {
-  private log: Logger;
-  private bytecode: Buffer | undefined;
-  private opcodeTallies: Map<string, OpcodeTally> = new Map();
-  // maps pc to [instr, bytesRead]
-  private deserializedInstructionsCache: Map<number, [Instruction, number]> = new Map();
-
-  private tallyPrintFunction = () => {};
-  private tallyInstructionFunction = (_b: string, _c: Gas) => {};
-
-  // Test Purposes only: Logger will not have the proper function name. Use this constructor for testing purposes
-  // only. Otherwise, use build() below.
-  constructor(
-    private context: AvmContext,
-    private instructionSet: InstructionSet = INSTRUCTION_SET,
-    enableTallying = false,
-  ) {
-    // This will be used by the CALL opcode to create a new simulator. It is required to
-    // avoid a dependency cycle.
-    context.provideSimulator = AvmSimulator.build;
-    this.log = createLogger(`simulator:avm(calldata[0]: ${context.environment.calldata[0]})`);
-    // Turn on tallying if explicitly enabled or if trace logging
-    if (enableTallying || this.log.isLevelEnabled('trace')) {
-      this.tallyPrintFunction = this.printOpcodeTallies;
-      this.tallyInstructionFunction = this.tallyInstruction;
-    }
-  }
-
-  // Factory to have a proper function name in the logger. Retrieving the name is asynchronous and
-  // cannot be done as part of the constructor.
-  public static async build(context: AvmContext): Promise<AvmSimulator> {
-    const simulator = new AvmSimulator(context);
-    const fnName = await context.persistableState.getPublicFunctionDebugName(context.environment);
-    simulator.log = createLogger(`simulator:avm(f:${fnName})`);
-
-    return simulator;
-  }
-
-  public static async create(
-    stateManager: PublicPersistableStateManager,
-    address: AztecAddress,
-    sender: AztecAddress,
-    transactionFee: Fr,
-    globals: GlobalVariables,
-    isStaticCall: boolean,
-    calldata: Fr[],
-    allocatedGas: Gas,
-    clientInitiatedSimulation: boolean = false,
-    maxDebugLogMemoryReads?: number,
-  ) {
-    const avmExecutionEnv = new AvmExecutionEnvironment(
-      address,
-      sender,
-      /*contractCallDepth=*/ Fr.zero(),
-      transactionFee,
-      globals,
-      isStaticCall,
-      calldata,
-      clientInitiatedSimulation,
-      maxDebugLogMemoryReads,
-    );
-
-    const avmMachineState = new AvmMachineState(allocatedGas);
-    const avmContext = new AvmContext(stateManager, avmExecutionEnv, avmMachineState);
-    return await AvmSimulator.build(avmContext);
-  }
-
-  /**
-   * Fetch the bytecode and execute it in the current context.
-   */
-  public async execute(): Promise<AvmContractCallResult> {
-    const bytecode = await this.context.persistableState.getBytecode(this.context.environment.address);
-    // getBytecode returns undefined if bytecode is not found or if the limit of contract calls to unique class IDs is reached.
-    // If it throws an error that reaches this point, it is a bug.
-
-    if (!bytecode) {
-      return await this.handleFailureToRetrieveBytecode(
-        `No bytecode found, or limit encountered for max calls to unique contract class IDs. Contract address: ${this.context.environment.address}. Reverting...`,
-      );
-    }
-
-    return await this.executeBytecode(bytecode);
-  }
-
-  /**
-   * Return the bytecode used for execution, if any.
-   */
-  public getBytecode(): Buffer | undefined {
-    return this.bytecode;
-  }
-
-  /**
-   * Executes the provided bytecode in the current context.
-   * This method is useful for testing and debugging.
-   */
-  public async executeBytecode(bytecode: Buffer): Promise<AvmContractCallResult> {
-    const timer = new Timer();
-    assert(bytecode.length > 0, "AVM simulator can't execute empty bytecode");
-
-    this.bytecode = bytecode;
-    let instructionName = 'NONE'; // This is used for logging purposes
-
-    const { machineState } = this.context;
-    const callStartGas = machineState.gasLeft; // Save gas before executing instruction (for profiling)
-    try {
-      // Execute instruction pointed to by the current program counter
-      // continuing until the machine state signifies a halt
-      while (!machineState.getHalted()) {
-        // Get the instruction from cache, or deserialize for the first time
-        let cachedInstruction = this.deserializedInstructionsCache.get(machineState.pc);
-
-        if (cachedInstruction === undefined) {
-          cachedInstruction = decodeInstructionFromBytecode(bytecode, machineState.pc, this.instructionSet);
-          this.deserializedInstructionsCache.set(machineState.pc, cachedInstruction);
-        }
-        const [instruction, bytesRead] = cachedInstruction;
-
-        const instrStartGas = machineState.gasLeft; // Save gas before executing instruction (for profiling)
-
-        if (this.log.isLevelEnabled('trace')) {
-          // Skip this entirely to avoid toStringing etc if trace is not enabled
-          this.log.trace(
-            `[PC:${machineState.pc}] [IC:${machineState.instrCounter}] ${instruction.toString()} (gasLeft l2=${
-              machineState.l2GasLeft
-            } da=${machineState.daGasLeft})`,
-          );
-        }
-        machineState.nextPc = machineState.pc + bytesRead;
-
-        instructionName = instruction.constructor.name;
-        // Execute the instruction.
-        // Normal returns and reverts will return normally here.
-        // "Exceptional halts" will throw.
-        await instruction.execute(this.context);
-        if (!instruction.handlesPC()) {
-          // Increment PC if the instruction doesn't handle it itself
-          machineState.pc += bytesRead;
-        }
-
-        machineState.instrCounter++;
-
-        // gas used by this instruction - used for profiling/tallying
-        const gasUsed: Gas = {
-          l2Gas: instrStartGas.l2Gas - machineState.l2GasLeft,
-          daGas: instrStartGas.daGas - machineState.daGasLeft,
-        };
-        this.tallyInstructionFunction(instruction.constructor.name, gasUsed);
-
-        if (machineState.pc >= bytecode.length) {
-          this.log.warn('Passed end of program');
-          throw new InvalidProgramCounterError(machineState.pc, /*max=*/ bytecode.length);
-        }
-      }
-
-      const output = machineState.getOutput();
-      const reverted = machineState.getReverted();
-      const revertReason = reverted ? await revertReasonFromExplicitRevert(output, this.context) : undefined;
-      const results = new AvmContractCallResult(
-        reverted,
-        output,
-        machineState.gasLeft,
-        revertReason,
-        machineState.instrCounter,
-      );
-      this.log.debug(`Context execution results: ${results.toString()}`);
-      const totalGasUsed: Gas = {
-        l2Gas: callStartGas.l2Gas - machineState.l2GasLeft,
-        daGas: callStartGas.daGas - machineState.daGasLeft,
-      };
-      this.log.debug(`Executed ${machineState.instrCounter} instructions and consumed ${totalGasUsed.l2Gas} L2 Gas`);
-
-      this.tallyPrintFunction();
-
-      this.log.debug(`Core AVM simulation took ${timer.ms()}ms`);
-
-      // Return results for processing by calling context
-      return results;
-    } catch (err: any) {
-      this.log.info(
-        `Exceptional halt (revert by something other than REVERT opcode) for instruction
-         ${instructionName} at pc ${machineState.pc} and instruction counter ${machineState.instrCounter}`,
-      );
-      if (!(err instanceof CheckedPublicExecutionError)) {
-        this.log.error(`Unchecked/unknown error thrown by AVM. This is a bug. Error: ${err}`);
-        throw err;
-      }
-
-      const revertReason = await revertReasonFromExceptionalHalt(err, this.context);
-      // Exceptional halts consume all allocated gas
-      const noGasLeft = { l2Gas: 0, daGas: 0 };
-      // Note: "exceptional halts" cannot return data, hence [].
-      const results = new AvmContractCallResult(
-        /*reverted=*/ true,
-        /*output=*/ [],
-        noGasLeft,
-        revertReason,
-        machineState.instrCounter,
-      );
-      this.log.debug(`Context execution results: ${results.toString()}`);
-
-      this.tallyPrintFunction();
-      // Return results for processing by calling context
-      return results;
-    }
-  }
-
-  private async handleFailureToRetrieveBytecode(message: string): Promise<AvmContractCallResult> {
-    // revert, consuming all gas
-    const fnName = await this.context.persistableState.getPublicFunctionDebugName(this.context.environment);
-    const revertReason = new AvmRevertReason(
-      message,
-      /*failingFunction=*/ {
-        contractAddress: this.context.environment.address,
-        functionName: fnName,
-      },
-      /*noirCallStack=*/ [],
-    );
-    this.log.warn(message);
-    return new AvmContractCallResult(
-      /*reverted=*/ true,
-      /*output=*/ [],
-      /*gasLeft=*/ { l2Gas: 0, daGas: 0 }, // consumes all allocated gas
-      revertReason,
-    );
-  }
-
-  private tallyInstruction(opcode: string, gasUsed: Gas) {
-    const opcodeTally = this.opcodeTallies.get(opcode) || ({ count: 0, gas: { l2Gas: 0, daGas: 0 } } as OpcodeTally);
-    opcodeTally.count++;
-    opcodeTally.gas.l2Gas += gasUsed.l2Gas;
-    opcodeTally.gas.daGas += gasUsed.daGas;
-    this.opcodeTallies.set(opcode, opcodeTally);
-  }
-
-  private printOpcodeTallies() {
-    this.log.debug(`Printing tallies per opcode sorted by gas...`);
-    // sort descending by L2 gas consumed
-    const sortedOpcodes = Array.from(this.opcodeTallies.entries()).sort((a, b) => b[1].gas.l2Gas - a[1].gas.l2Gas);
-    for (const [opcode, tally] of sortedOpcodes) {
-      // NOTE: don't care to clutter the logs with DA gas for now
-      this.log.debug(`${opcode} executed ${tally.count} times consuming a total of ${tally.gas.l2Gas} L2 gas`);
-    }
-  }
-}