@aztec/simulator 0.0.1-commit.fcb71a6 → 0.0.1-commit.fffb133c

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/README.md +2 -0
  2. package/dest/common/errors.d.ts +7 -1
  3. package/dest/common/errors.d.ts.map +1 -1
  4. package/dest/public/avm/avm_context.d.ts +3 -3
  5. package/dest/public/avm/avm_context.d.ts.map +1 -1
  6. package/dest/public/avm/avm_contract_call_result.d.ts +6 -6
  7. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  8. package/dest/public/avm/avm_contract_call_result.js +3 -3
  9. package/dest/public/avm/avm_execution_environment.d.ts +6 -5
  10. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  11. package/dest/public/avm/avm_machine_state.d.ts +6 -5
  12. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  13. package/dest/public/avm/avm_machine_state.js +3 -2
  14. package/dest/public/avm/avm_memory_types.d.ts +1 -1
  15. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  16. package/dest/public/avm/avm_memory_types.js +3 -0
  17. package/dest/public/avm/avm_simulator.d.ts +3 -2
  18. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  19. package/dest/public/avm/avm_simulator.js +5 -4
  20. package/dest/public/avm/calldata.d.ts +51 -0
  21. package/dest/public/avm/calldata.d.ts.map +1 -0
  22. package/dest/public/avm/calldata.js +63 -0
  23. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +1 -1
  24. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  25. package/dest/public/avm/fixtures/avm_simulation_tester.js +3 -2
  26. package/dest/public/avm/fixtures/initializers.d.ts +1 -1
  27. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -1
  28. package/dest/public/avm/fixtures/initializers.js +2 -1
  29. package/dest/public/avm/opcodes/accrued_substate.d.ts +15 -15
  30. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  31. package/dest/public/avm/opcodes/accrued_substate.js +33 -29
  32. package/dest/public/avm/opcodes/arithmetic.d.ts +8 -8
  33. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  34. package/dest/public/avm/opcodes/arithmetic.js +1 -1
  35. package/dest/public/avm/opcodes/bitwise.d.ts +7 -7
  36. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  37. package/dest/public/avm/opcodes/bitwise.js +5 -5
  38. package/dest/public/avm/opcodes/comparators.d.ts +4 -4
  39. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  40. package/dest/public/avm/opcodes/comparators.js +1 -1
  41. package/dest/public/avm/opcodes/contract.d.ts +3 -3
  42. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  43. package/dest/public/avm/opcodes/contract.js +8 -8
  44. package/dest/public/avm/opcodes/control_flow.d.ts +3 -3
  45. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  46. package/dest/public/avm/opcodes/control_flow.js +4 -4
  47. package/dest/public/avm/opcodes/conversion.d.ts +3 -3
  48. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  49. package/dest/public/avm/opcodes/conversion.js +4 -4
  50. package/dest/public/avm/opcodes/ec_add.d.ts +4 -4
  51. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  52. package/dest/public/avm/opcodes/ec_add.js +15 -6
  53. package/dest/public/avm/opcodes/environment_getters.d.ts +5 -5
  54. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  55. package/dest/public/avm/opcodes/environment_getters.js +6 -6
  56. package/dest/public/avm/opcodes/external_calls.d.ts +9 -9
  57. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  58. package/dest/public/avm/opcodes/external_calls.js +23 -22
  59. package/dest/public/avm/opcodes/hashing.d.ts +8 -8
  60. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  61. package/dest/public/avm/opcodes/hashing.js +12 -12
  62. package/dest/public/avm/opcodes/instruction_impl.d.ts +4 -4
  63. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +1 -1
  64. package/dest/public/avm/opcodes/instruction_impl.js +4 -4
  65. package/dest/public/avm/opcodes/memory.d.ts +14 -14
  66. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  67. package/dest/public/avm/opcodes/memory.js +25 -25
  68. package/dest/public/avm/opcodes/misc.d.ts +3 -3
  69. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  70. package/dest/public/avm/opcodes/misc.js +4 -4
  71. package/dest/public/avm/opcodes/storage.d.ts +16 -15
  72. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  73. package/dest/public/avm/opcodes/storage.js +34 -24
  74. package/dest/public/debug_fn_name.d.ts +4 -4
  75. package/dest/public/debug_fn_name.d.ts.map +1 -1
  76. package/dest/public/debug_fn_name.js +7 -5
  77. package/dest/public/executor_metrics.d.ts +1 -1
  78. package/dest/public/executor_metrics.d.ts.map +1 -1
  79. package/dest/public/executor_metrics.js +8 -34
  80. package/dest/public/fixtures/bulk_test.d.ts +3 -3
  81. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  82. package/dest/public/fixtures/bulk_test.js +1 -17
  83. package/dest/public/fixtures/custom_bytecode_tests.d.ts +11 -11
  84. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -1
  85. package/dest/public/fixtures/custom_bytecode_tests.js +18 -18
  86. package/dest/public/fixtures/minimal_public_tx.js +2 -2
  87. package/dest/public/fixtures/opcode_spammer.d.ts +1 -1
  88. package/dest/public/fixtures/opcode_spammer.d.ts.map +1 -1
  89. package/dest/public/fixtures/opcode_spammer.js +92 -80
  90. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +21 -7
  91. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -1
  92. package/dest/public/fuzzing/avm_fuzzer_simulator.js +42 -10
  93. package/dest/public/fuzzing/avm_simulator_bin.js +29 -11
  94. package/dest/public/hinting_db_sources.js +3 -1
  95. package/dest/public/public_processor/guarded_merkle_tree.js +3 -1
  96. package/dest/public/public_processor/public_processor.d.ts +2 -2
  97. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  98. package/dest/public/public_processor/public_processor.js +402 -21
  99. package/dest/public/public_processor/public_processor_metrics.d.ts +1 -1
  100. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  101. package/dest/public/public_processor/public_processor_metrics.js +12 -45
  102. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +1 -1
  103. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -1
  104. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +2 -1
  105. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +1 -1
  106. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +4 -3
  107. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  108. package/dest/public/public_tx_simulator/public_tx_simulator.js +9 -6
  109. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +395 -19
  110. package/dest/public/side_effect_trace.d.ts +2 -1
  111. package/dest/public/side_effect_trace.d.ts.map +1 -1
  112. package/dest/public/state_manager/state_manager.d.ts +1 -1
  113. package/dest/public/state_manager/state_manager.d.ts.map +1 -1
  114. package/dest/public/state_manager/state_manager.js +2 -2
  115. package/package.json +17 -17
  116. package/src/public/avm/avm_context.ts +2 -2
  117. package/src/public/avm/avm_contract_call_result.ts +8 -6
  118. package/src/public/avm/avm_execution_environment.ts +9 -4
  119. package/src/public/avm/avm_machine_state.ts +6 -5
  120. package/src/public/avm/avm_memory_types.ts +4 -0
  121. package/src/public/avm/avm_simulator.ts +8 -5
  122. package/src/public/avm/calldata.ts +100 -0
  123. package/src/public/avm/fixtures/avm_simulation_tester.ts +8 -2
  124. package/src/public/avm/fixtures/initializers.ts +2 -1
  125. package/src/public/avm/opcodes/accrued_substate.ts +21 -15
  126. package/src/public/avm/opcodes/arithmetic.ts +1 -1
  127. package/src/public/avm/opcodes/bitwise.ts +3 -3
  128. package/src/public/avm/opcodes/comparators.ts +1 -1
  129. package/src/public/avm/opcodes/contract.ts +4 -7
  130. package/src/public/avm/opcodes/control_flow.ts +2 -2
  131. package/src/public/avm/opcodes/conversion.ts +3 -3
  132. package/src/public/avm/opcodes/ec_add.ts +13 -4
  133. package/src/public/avm/opcodes/environment_getters.ts +7 -7
  134. package/src/public/avm/opcodes/external_calls.ts +17 -15
  135. package/src/public/avm/opcodes/hashing.ts +6 -6
  136. package/src/public/avm/opcodes/instruction_impl.ts +2 -2
  137. package/src/public/avm/opcodes/memory.ts +19 -19
  138. package/src/public/avm/opcodes/misc.ts +2 -2
  139. package/src/public/avm/opcodes/storage.ts +30 -22
  140. package/src/public/debug_fn_name.ts +10 -8
  141. package/src/public/executor_metrics.ts +7 -34
  142. package/src/public/fixtures/bulk_test.ts +2 -2
  143. package/src/public/fixtures/custom_bytecode_tests.ts +27 -18
  144. package/src/public/fixtures/minimal_public_tx.ts +2 -2
  145. package/src/public/fixtures/opcode_spammer.ts +197 -81
  146. package/src/public/fuzzing/avm_fuzzer_simulator.ts +60 -12
  147. package/src/public/fuzzing/avm_simulator_bin.ts +43 -8
  148. package/src/public/public_processor/public_processor.ts +3 -2
  149. package/src/public/public_processor/public_processor_metrics.ts +11 -45
  150. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +9 -1
  151. package/src/public/public_tx_simulator/public_tx_simulator.ts +12 -5
  152. package/src/public/state_manager/state_manager.ts +2 -16
@@ -1,4 +1,3 @@
1
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
1
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
2
 
4
3
  import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
@@ -6,6 +5,7 @@ import type { AvmExecutionEnvironment } from './avm_execution_environment.js';
6
5
  import { type Gas, gasToGasLeft } from './avm_gas.js';
7
6
  import { AvmMachineState } from './avm_machine_state.js';
8
7
  import type { AvmSimulatorInterface } from './avm_simulator_interface.js';
8
+ import type { CallData } from './calldata.js';
9
9
 
10
10
  /**
11
11
  * An execution context includes the information necessary to initiate AVM
@@ -45,7 +45,7 @@ export class AvmContext {
45
45
  */
46
46
  public async createNestedContractCallContext(
47
47
  address: AztecAddress,
48
- calldata: Fr[],
48
+ calldata: CallData,
49
49
  allocatedGas: Gas,
50
50
  callType: 'CALL' | 'STATICCALL',
51
51
  ): Promise<AvmContext> {
@@ -1,4 +1,3 @@
1
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
1
  import type { SimulationError } from '@aztec/stdlib/errors';
3
2
  import { Gas } from '@aztec/stdlib/gas';
4
3
 
@@ -6,6 +5,7 @@ import { inspect } from 'util';
6
5
 
7
6
  import { createSimulationError } from '../../common/errors.js';
8
7
  import type { Gas as AvmGas } from './avm_gas.js';
8
+ import type { ReturnData } from './calldata.js';
9
9
  import type { AvmRevertReason } from './errors.js';
10
10
 
11
11
  /**
@@ -14,14 +14,14 @@ import type { AvmRevertReason } from './errors.js';
14
14
  export class AvmContractCallResult {
15
15
  constructor(
16
16
  public reverted: boolean,
17
- public output: Fr[],
17
+ public output: ReturnData,
18
18
  public gasLeft: AvmGas,
19
19
  public revertReason?: AvmRevertReason,
20
20
  public totalInstructions: number = 0, // including nested calls
21
21
  ) {}
22
22
 
23
23
  toString(): string {
24
- let resultsStr = `reverted: ${this.reverted}, output: ${this.output}, gasLeft: ${inspect(
24
+ let resultsStr = `reverted: ${this.reverted}, output: ${this.output.bestEffortReadAll(10)}${this.output.length() > 10 ? ' ...' : ''}, gasLeft: ${inspect(
25
25
  this.gasLeft,
26
26
  )}, totalInstructions: ${this.totalInstructions}`;
27
27
  if (this.revertReason) {
@@ -31,7 +31,9 @@ export class AvmContractCallResult {
31
31
  }
32
32
 
33
33
  finalize(): AvmFinalizedCallResult {
34
- const revertReason = this.revertReason ? createSimulationError(this.revertReason, this.output) : undefined;
34
+ const revertReason = this.revertReason
35
+ ? createSimulationError(this.revertReason, this.output.bestEffortReadAll())
36
+ : undefined;
35
37
  return new AvmFinalizedCallResult(
36
38
  this.reverted,
37
39
  this.output,
@@ -49,14 +51,14 @@ export class AvmContractCallResult {
49
51
  export class AvmFinalizedCallResult {
50
52
  constructor(
51
53
  public reverted: boolean,
52
- public output: Fr[],
54
+ public output: ReturnData,
53
55
  public gasLeft: Gas,
54
56
  public revertReason?: SimulationError,
55
57
  public totalInstructions: number = 0, // including nested calls
56
58
  ) {}
57
59
 
58
60
  toString(): string {
59
- let resultsStr = `reverted: ${this.reverted}, output: ${this.output}, gasLeft: ${inspect(
61
+ let resultsStr = `reverted: ${this.reverted}, output: ${this.output.bestEffortReadAll(10)}${this.output.length() > 10 ? ' ...' : ''}, gasLeft: ${inspect(
60
62
  this.gasLeft,
61
63
  )}, totalInstructions: ${this.totalInstructions}`;
62
64
  if (this.revertReason) {
@@ -3,6 +3,8 @@ import type { PublicSimulatorConfig } from '@aztec/stdlib/avm';
3
3
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import type { GlobalVariables } from '@aztec/stdlib/tx';
5
5
 
6
+ import type { CallData } from './calldata.js';
7
+
6
8
  /**
7
9
  * Contains variables that remain constant during AVM execution
8
10
  * These variables are provided by the public kernel circuit
@@ -15,13 +17,13 @@ export class AvmExecutionEnvironment {
15
17
  public readonly transactionFee: Fr,
16
18
  public readonly globals: GlobalVariables,
17
19
  public readonly isStaticCall: boolean,
18
- public readonly calldata: Fr[],
20
+ public readonly calldata: CallData,
19
21
  public readonly config: PublicSimulatorConfig,
20
22
  ) {}
21
23
 
22
24
  private deriveEnvironmentForNestedCallInternal(
23
25
  targetAddress: AztecAddress,
24
- calldata: Fr[],
26
+ calldata: CallData,
25
27
  isStaticCall: boolean,
26
28
  ): AvmExecutionEnvironment {
27
29
  return new AvmExecutionEnvironment(
@@ -36,11 +38,14 @@ export class AvmExecutionEnvironment {
36
38
  );
37
39
  }
38
40
 
39
- public deriveEnvironmentForNestedCall(targetAddress: AztecAddress, calldata: Fr[]): AvmExecutionEnvironment {
41
+ public deriveEnvironmentForNestedCall(targetAddress: AztecAddress, calldata: CallData): AvmExecutionEnvironment {
40
42
  return this.deriveEnvironmentForNestedCallInternal(targetAddress, calldata, /*isStaticCall=*/ false);
41
43
  }
42
44
 
43
- public deriveEnvironmentForNestedStaticCall(targetAddress: AztecAddress, calldata: Fr[]): AvmExecutionEnvironment {
45
+ public deriveEnvironmentForNestedStaticCall(
46
+ targetAddress: AztecAddress,
47
+ calldata: CallData,
48
+ ): AvmExecutionEnvironment {
44
49
  return this.deriveEnvironmentForNestedCallInternal(targetAddress, calldata, /*isStaticCall=*/ true);
45
50
  }
46
51
  }
@@ -2,6 +2,7 @@ import type { Fr } from '@aztec/foundation/curves/bn254';
2
2
 
3
3
  import type { Gas } from './avm_gas.js';
4
4
  import { TaggedMemory } from './avm_memory_types.js';
5
+ import { type ReturnData, ReturnDataArray } from './calldata.js';
5
6
  import { type AvmRevertReason, OutOfGasError } from './errors.js';
6
7
 
7
8
  /**
@@ -39,7 +40,7 @@ export class AvmMachineState {
39
40
  /** program counter of the next instruction, byte based */
40
41
  public nextPc: number = 0;
41
42
  /** return/revertdata of the last nested call. */
42
- public nestedReturndata: Fr[] = [];
43
+ public nestedReturndata: ReturnData = new ReturnDataArray([]);
43
44
  /** Tracks whether the last external call was successful */
44
45
  public nestedCallSuccess: boolean = false;
45
46
  /**
@@ -66,7 +67,7 @@ export class AvmMachineState {
66
67
  /** Signals that execution has reverted normally (this does not cover exceptional halts) */
67
68
  private reverted: boolean = false;
68
69
  /** Output data must NOT be modified once it is set */
69
- private output: Fr[] = [];
70
+ private output: ReturnData = new ReturnDataArray([]);
70
71
 
71
72
  // Metrics only - not needed for execution
72
73
  /** instruction counter, including nested calls */
@@ -129,7 +130,7 @@ export class AvmMachineState {
129
130
  * Output data must NOT be modified once it is set
130
131
  * @param output
131
132
  */
132
- public return(output: Fr[]) {
133
+ public return(output: ReturnData) {
133
134
  this.halted = true;
134
135
  this.output = output;
135
136
  }
@@ -139,7 +140,7 @@ export class AvmMachineState {
139
140
  * Output data must NOT be modified once it is set
140
141
  * @param output
141
142
  */
142
- public revert(output: Fr[]) {
143
+ public revert(output: ReturnData) {
143
144
  this.halted = true;
144
145
  this.reverted = true;
145
146
  this.output = output;
@@ -153,7 +154,7 @@ export class AvmMachineState {
153
154
  return this.reverted;
154
155
  }
155
156
 
156
- public getOutput(): Fr[] {
157
+ public getOutput(): ReturnData {
157
158
  return this.output;
158
159
  }
159
160
 
@@ -369,6 +369,10 @@ export class TaggedMemory implements TaggedMemoryInterface {
369
369
  * Check tags for all memory in the specified range.
370
370
  */
371
371
  public checkTagsRange(tag: TypeTag, startOffset: number, size: number) {
372
+ if (startOffset + size > TaggedMemory.MAX_MEMORY_SIZE) {
373
+ throw new MemorySliceOutOfRangeError(startOffset, size);
374
+ }
375
+
372
376
  for (let offset = startOffset; offset < startOffset + size; offset++) {
373
377
  this.checkTag(tag, offset);
374
378
  }
@@ -15,6 +15,7 @@ import { AvmExecutionEnvironment } from './avm_execution_environment.js';
15
15
  import type { Gas } from './avm_gas.js';
16
16
  import { AvmMachineState } from './avm_machine_state.js';
17
17
  import type { AvmSimulatorInterface } from './avm_simulator_interface.js';
18
+ import { type CallData, ReturnDataArray } from './calldata.js';
18
19
  import { AvmRevertReason, InvalidProgramCounterError } from './errors.js';
19
20
  import type { Instruction } from './opcodes/instruction.js';
20
21
  import { revertReasonFromExceptionalHalt, revertReasonFromExplicitRevert } from './revert_reason.js';
@@ -49,7 +50,7 @@ export class AvmSimulator implements AvmSimulatorInterface {
49
50
  // This will be used by the CALL opcode to create a new simulator. It is required to
50
51
  // avoid a dependency cycle.
51
52
  context.provideSimulator = AvmSimulator.build;
52
- this.log = createLogger(`simulator:avm(calldata[0]: ${context.environment.calldata[0]})`);
53
+ this.log = createLogger(`simulator:avm(calldata[0]: ${context.environment.calldata.read(0)})`);
53
54
  // Turn on tallying if explicitly enabled or if trace logging
54
55
  if (enableTallying || this.log.isLevelEnabled('trace')) {
55
56
  this.tallyPrintFunction = this.printOpcodeTallies;
@@ -74,7 +75,7 @@ export class AvmSimulator implements AvmSimulatorInterface {
74
75
  transactionFee: Fr,
75
76
  globals: GlobalVariables,
76
77
  isStaticCall: boolean,
77
- calldata: Fr[],
78
+ calldata: CallData,
78
79
  allocatedGas: Gas,
79
80
  config: PublicSimulatorConfig,
80
81
  ) {
@@ -183,7 +184,9 @@ export class AvmSimulator implements AvmSimulatorInterface {
183
184
 
184
185
  const output = machineState.getOutput();
185
186
  const reverted = machineState.getReverted();
186
- const revertReason = reverted ? await revertReasonFromExplicitRevert(output, this.context) : undefined;
187
+ const revertReason = reverted
188
+ ? await revertReasonFromExplicitRevert(output.bestEffortReadAll(), this.context)
189
+ : undefined;
187
190
  const results = new AvmContractCallResult(
188
191
  reverted,
189
192
  output,
@@ -220,7 +223,7 @@ export class AvmSimulator implements AvmSimulatorInterface {
220
223
  // Note: "exceptional halts" cannot return data, hence [].
221
224
  const results = new AvmContractCallResult(
222
225
  /*reverted=*/ true,
223
- /*output=*/ [],
226
+ /*output=*/ new ReturnDataArray([]),
224
227
  noGasLeft,
225
228
  revertReason,
226
229
  machineState.instrCounter,
@@ -250,7 +253,7 @@ export class AvmSimulator implements AvmSimulatorInterface {
250
253
  this.log.warn(message);
251
254
  return new AvmContractCallResult(
252
255
  /*reverted=*/ true,
253
- /*output=*/ [],
256
+ /*output=*/ new ReturnDataArray([]),
254
257
  /*gasLeft=*/ { l2Gas: 0, daGas: 0 }, // consumes all allocated gas
255
258
  revertReason,
256
259
  );
@@ -0,0 +1,100 @@
1
+ import type { Fr } from '@aztec/foundation/schemas';
2
+
3
+ import { TaggedMemory } from './avm_memory_types.js';
4
+
5
+ // Allow reading up to 300 kB of return data when unspecified.
6
+ const DEFAULT_BEST_EFFORT_READ_CAP = 10000;
7
+
8
+ export interface LazyReader {
9
+ bestEffortReadAll(readCap?: number): Fr[];
10
+ readAll(): Fr[];
11
+ read(idx: number): Fr | undefined;
12
+ slice(start: number, end: number): Fr[];
13
+ length(): number;
14
+ }
15
+
16
+ export class LazyReaderMemory implements LazyReader {
17
+ constructor(
18
+ private memory: TaggedMemory,
19
+ private offset: number,
20
+ private size: number,
21
+ ) {}
22
+
23
+ public bestEffortReadAll(readCap = DEFAULT_BEST_EFFORT_READ_CAP): Fr[] {
24
+ const size = Math.min(this.size, readCap, TaggedMemory.MAX_MEMORY_SIZE - this.offset);
25
+ return this.memory.getSlice(this.offset, size).map(word => word.toFr());
26
+ }
27
+
28
+ public read(idx: number): Fr | undefined {
29
+ if (idx >= this.size) {
30
+ return undefined;
31
+ }
32
+ return this.memory.get(this.offset + idx).toFr();
33
+ }
34
+
35
+ public slice(start: number, end: number): Fr[] {
36
+ const clampedEnd = Math.min(end, this.size);
37
+ const length = Math.max(0, clampedEnd - start);
38
+ return this.memory.getSlice(this.offset + start, length).map(word => word.toFr());
39
+ }
40
+
41
+ public readAll(): Fr[] {
42
+ return this.memory.getSlice(this.offset, this.size).map(word => word.toFr());
43
+ }
44
+
45
+ public length(): number {
46
+ return this.size;
47
+ }
48
+ }
49
+
50
+ export class LazyReaderArray implements LazyReader {
51
+ constructor(private array: Fr[]) {}
52
+
53
+ public bestEffortReadAll(readCap = DEFAULT_BEST_EFFORT_READ_CAP): Fr[] {
54
+ return this.array.slice(0, readCap);
55
+ }
56
+
57
+ public read(idx: number): Fr | undefined {
58
+ return this.array[idx];
59
+ }
60
+
61
+ public slice(start: number, end: number): Fr[] {
62
+ return this.array.slice(start, end);
63
+ }
64
+
65
+ public readAll(): Fr[] {
66
+ return this.array;
67
+ }
68
+
69
+ public length(): number {
70
+ return this.array.length;
71
+ }
72
+ }
73
+
74
+ // Compile time branding to avoid swapping CallData and ReturnData by accident.
75
+ declare const CallDataBrand: unique symbol;
76
+ declare const ReturnDataBrand: unique symbol;
77
+
78
+ export type CallData = LazyReader & {
79
+ readonly [CallDataBrand]: true;
80
+ };
81
+
82
+ export type ReturnData = LazyReader & {
83
+ readonly [ReturnDataBrand]: true;
84
+ };
85
+
86
+ export class CallDataArray extends LazyReaderArray implements CallData {
87
+ declare readonly [CallDataBrand]: true;
88
+ }
89
+
90
+ export class CallDataMemory extends LazyReaderMemory implements CallData {
91
+ declare readonly [CallDataBrand]: true;
92
+ }
93
+
94
+ export class ReturnDataArray extends LazyReaderArray implements ReturnData {
95
+ declare readonly [ReturnDataBrand]: true;
96
+ }
97
+
98
+ export class ReturnDataMemory extends LazyReaderMemory implements ReturnData {
99
+ declare readonly [ReturnDataBrand]: true;
100
+ }
@@ -13,6 +13,7 @@ import { SimpleContractDataSource } from '../../fixtures/simple_contract_data_so
13
13
  import { PublicContractsDB, PublicTreesDB } from '../../public_db_sources.js';
14
14
  import { PublicPersistableStateManager } from '../../state_manager/state_manager.js';
15
15
  import { AvmSimulator } from '../avm_simulator.js';
16
+ import { CallDataArray } from '../calldata.js';
16
17
  import { BaseAvmSimulationTester } from './base_avm_simulation_tester.js';
17
18
  import { initContext, initExecutionEnvironment } from './initializers.js';
18
19
  import {
@@ -89,7 +90,7 @@ export class AvmSimulationTester extends BaseAvmSimulationTester {
89
90
  collectCallMetadata: true,
90
91
  });
91
92
  const environment = initExecutionEnvironment({
92
- calldata,
93
+ calldata: new CallDataArray(calldata),
93
94
  globals,
94
95
  address,
95
96
  sender,
@@ -105,7 +106,12 @@ export class AvmSimulationTester extends BaseAvmSimulationTester {
105
106
  if (result.reverted) {
106
107
  this.logger.error(`Error in ${fnName}:`);
107
108
  this.logger.error(
108
- resolveContractAssertionMessage(fnName, result.revertReason!, result.output, contractArtifact)!,
109
+ resolveContractAssertionMessage(
110
+ fnName,
111
+ result.revertReason!,
112
+ result.output.bestEffortReadAll(),
113
+ contractArtifact,
114
+ )!,
109
115
  );
110
116
  } else {
111
117
  this.logger.info(`Simulation of function ${fnName} succeeded!`);
@@ -19,6 +19,7 @@ import { AvmContext } from '../avm_context.js';
19
19
  import { AvmExecutionEnvironment } from '../avm_execution_environment.js';
20
20
  import { AvmMachineState } from '../avm_machine_state.js';
21
21
  import { AvmSimulator } from '../avm_simulator.js';
22
+ import { CallDataArray } from '../calldata.js';
22
23
  import { DEFAULT_TIMESTAMP } from './utils.js';
23
24
 
24
25
  /**
@@ -70,7 +71,7 @@ export function initExecutionEnvironment(overrides?: Partial<AvmExecutionEnviron
70
71
  overrides?.transactionFee ?? Fr.zero(),
71
72
  overrides?.globals ?? GlobalVariables.empty(),
72
73
  overrides?.isStaticCall ?? false,
73
- overrides?.calldata ?? [],
74
+ overrides?.calldata ?? new CallDataArray([]),
74
75
  overrides?.config ?? PublicSimulatorConfig.empty(),
75
76
  );
76
77
  }
@@ -1,3 +1,5 @@
1
+ import { MAX_ETH_ADDRESS_VALUE } from '@aztec/constants';
2
+
1
3
  import { NullifierCollisionError } from '../../side_effect_errors.js';
2
4
  import type { AvmContext } from '../avm_context.js';
3
5
  import { TypeTag, Uint1 } from '../avm_memory_types.js';
@@ -19,7 +21,7 @@ export class NoteHashExists extends Instruction {
19
21
  ];
20
22
 
21
23
  constructor(
22
- private indirect: number,
24
+ private addressingMode: number,
23
25
  private noteHashOffset: number,
24
26
  private leafIndexOffset: number,
25
27
  private existsOffset: number,
@@ -29,7 +31,7 @@ export class NoteHashExists extends Instruction {
29
31
 
30
32
  public async execute(context: AvmContext): Promise<void> {
31
33
  const memory = context.machineState.memory;
32
- const addressing = Addressing.fromWire(this.indirect);
34
+ const addressing = Addressing.fromWire(this.addressingMode);
33
35
 
34
36
  context.machineState.consumeGas(
35
37
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -55,7 +57,7 @@ export class EmitNoteHash extends Instruction {
55
57
  static readonly wireFormat = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16];
56
58
 
57
59
  constructor(
58
- private indirect: number,
60
+ private addressingMode: number,
59
61
  private noteHashOffset: number,
60
62
  ) {
61
63
  super();
@@ -63,7 +65,7 @@ export class EmitNoteHash extends Instruction {
63
65
 
64
66
  public async execute(context: AvmContext): Promise<void> {
65
67
  const memory = context.machineState.memory;
66
- const addressing = Addressing.fromWire(this.indirect);
68
+ const addressing = Addressing.fromWire(this.addressingMode);
67
69
 
68
70
  context.machineState.consumeGas(
69
71
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -95,7 +97,7 @@ export class NullifierExists extends Instruction {
95
97
  ];
96
98
 
97
99
  constructor(
98
- private indirect: number,
100
+ private addressingMode: number,
99
101
  private nullifierOffset: number,
100
102
  private addressOffset: number,
101
103
  private existsOffset: number,
@@ -105,7 +107,7 @@ export class NullifierExists extends Instruction {
105
107
 
106
108
  public async execute(context: AvmContext): Promise<void> {
107
109
  const memory = context.machineState.memory;
108
- const addressing = Addressing.fromWire(this.indirect);
110
+ const addressing = Addressing.fromWire(this.addressingMode);
109
111
 
110
112
  context.machineState.consumeGas(
111
113
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -130,7 +132,7 @@ export class EmitNullifier extends Instruction {
130
132
  static readonly wireFormat = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16];
131
133
 
132
134
  constructor(
133
- private indirect: number,
135
+ private addressingMode: number,
134
136
  private nullifierOffset: number,
135
137
  ) {
136
138
  super();
@@ -142,7 +144,7 @@ export class EmitNullifier extends Instruction {
142
144
  }
143
145
 
144
146
  const memory = context.machineState.memory;
145
- const addressing = Addressing.fromWire(this.indirect);
147
+ const addressing = Addressing.fromWire(this.addressingMode);
146
148
 
147
149
  context.machineState.consumeGas(
148
150
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -181,7 +183,7 @@ export class L1ToL2MessageExists extends Instruction {
181
183
  ];
182
184
 
183
185
  constructor(
184
- private indirect: number,
186
+ private addressingMode: number,
185
187
  private msgHashOffset: number,
186
188
  private msgLeafIndexOffset: number,
187
189
  private existsOffset: number,
@@ -191,7 +193,7 @@ export class L1ToL2MessageExists extends Instruction {
191
193
 
192
194
  public async execute(context: AvmContext): Promise<void> {
193
195
  const memory = context.machineState.memory;
194
- const addressing = Addressing.fromWire(this.indirect);
196
+ const addressing = Addressing.fromWire(this.addressingMode);
195
197
 
196
198
  context.machineState.consumeGas(
197
199
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -218,7 +220,7 @@ export class EmitUnencryptedLog extends Instruction {
218
220
  static readonly wireFormat = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16, OperandType.UINT16];
219
221
 
220
222
  constructor(
221
- private indirect: number,
223
+ private addressingMode: number,
222
224
  private logSizeOffset: number,
223
225
  private logOffset: number,
224
226
  ) {
@@ -231,7 +233,7 @@ export class EmitUnencryptedLog extends Instruction {
231
233
  }
232
234
 
233
235
  const memory = context.machineState.memory;
234
- const addressing = Addressing.fromWire(this.indirect);
236
+ const addressing = Addressing.fromWire(this.addressingMode);
235
237
 
236
238
  context.machineState.consumeGas(
237
239
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -241,11 +243,11 @@ export class EmitUnencryptedLog extends Instruction {
241
243
  const [logSizeOffset, logOffset] = addressing.resolve(operands, memory);
242
244
  memory.checkTag(TypeTag.UINT32, logSizeOffset);
243
245
  const logSize = memory.get(logSizeOffset).toNumber();
244
- memory.checkTagsRange(TypeTag.FIELD, logOffset, logSize);
245
246
 
246
247
  const contractAddress = context.environment.address;
247
248
 
248
249
  context.machineState.consumeGas(this.dynamicGasCost(logSize));
250
+ memory.checkTagsRange(TypeTag.FIELD, logOffset, logSize);
249
251
  const log = memory.getSlice(logOffset, logSize).map(f => f.toFr());
250
252
  context.persistableState.writePublicLog(contractAddress, log);
251
253
  }
@@ -258,7 +260,7 @@ export class SendL2ToL1Message extends Instruction {
258
260
  static readonly wireFormat = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16, OperandType.UINT16];
259
261
 
260
262
  constructor(
261
- private indirect: number,
263
+ private addressingMode: number,
262
264
  private recipientOffset: number,
263
265
  private contentOffset: number,
264
266
  ) {
@@ -271,7 +273,7 @@ export class SendL2ToL1Message extends Instruction {
271
273
  }
272
274
 
273
275
  const memory = context.machineState.memory;
274
- const addressing = Addressing.fromWire(this.indirect);
276
+ const addressing = Addressing.fromWire(this.addressingMode);
275
277
 
276
278
  context.machineState.consumeGas(
277
279
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -282,6 +284,10 @@ export class SendL2ToL1Message extends Instruction {
282
284
  memory.checkTags(TypeTag.FIELD, recipientOffset, contentOffset);
283
285
 
284
286
  const recipient = memory.get(recipientOffset).toFr();
287
+
288
+ if (recipient.toBigInt() > MAX_ETH_ADDRESS_VALUE) {
289
+ throw new InstructionExecutionError(`SENDL2TOL1MSG: Recipient address is too large`);
290
+ }
285
291
  const content = memory.get(contentOffset).toFr();
286
292
  context.persistableState.writeL2ToL1Message(context.environment.address, recipient, content);
287
293
  }
@@ -15,7 +15,7 @@ import { ThreeOperandInstruction } from './instruction_impl.js';
15
15
  export abstract class ThreeOperandArithmeticInstruction extends ThreeOperandInstruction {
16
16
  public async execute(context: AvmContext): Promise<void> {
17
17
  const memory = context.machineState.memory;
18
- const addressing = Addressing.fromWire(this.indirect);
18
+ const addressing = Addressing.fromWire(this.addressingMode);
19
19
 
20
20
  context.machineState.consumeGas(
21
21
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -9,7 +9,7 @@ import { ThreeOperandInstruction } from './instruction_impl.js';
9
9
  abstract class ThreeOperandBitwiseInstruction extends ThreeOperandInstruction {
10
10
  public async execute(context: AvmContext): Promise<void> {
11
11
  const memory = context.machineState.memory;
12
- const addressing = Addressing.fromWire(this.indirect);
12
+ const addressing = Addressing.fromWire(this.addressingMode);
13
13
 
14
14
  context.machineState.consumeGas(
15
15
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -87,7 +87,7 @@ export class Not extends Instruction {
87
87
  static readonly wireFormat16 = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16, OperandType.UINT16];
88
88
 
89
89
  constructor(
90
- private indirect: number,
90
+ private addressingMode: number,
91
91
  private srcOffset: number,
92
92
  private dstOffset: number,
93
93
  ) {
@@ -96,7 +96,7 @@ export class Not extends Instruction {
96
96
 
97
97
  public async execute(context: AvmContext): Promise<void> {
98
98
  const memory = context.machineState.memory;
99
- const addressing = Addressing.fromWire(this.indirect);
99
+ const addressing = Addressing.fromWire(this.addressingMode);
100
100
 
101
101
  context.machineState.consumeGas(
102
102
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -7,7 +7,7 @@ import { ThreeOperandInstruction } from './instruction_impl.js';
7
7
  abstract class ComparatorInstruction extends ThreeOperandInstruction {
8
8
  public async execute(context: AvmContext): Promise<void> {
9
9
  const memory = context.machineState.memory;
10
- const addressing = Addressing.fromWire(this.indirect);
10
+ const addressing = Addressing.fromWire(this.addressingMode);
11
11
 
12
12
  context.machineState.consumeGas(
13
13
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -17,14 +17,14 @@ export class GetContractInstance extends Instruction {
17
17
  // Informs (de)serialization. See Instruction.deserialize.
18
18
  static readonly wireFormat: OperandType[] = [
19
19
  OperandType.UINT8, // opcode
20
- OperandType.UINT8, // indirect bits
20
+ OperandType.UINT8, // addressing_mode bits
21
21
  OperandType.UINT16, // addressOffset
22
22
  OperandType.UINT16, // dstOffset
23
23
  OperandType.UINT8, // member enum (immediate)
24
24
  ];
25
25
 
26
26
  constructor(
27
- private indirect: number,
27
+ private addressingMode: number,
28
28
  private addressOffset: number,
29
29
  private dstOffset: number,
30
30
  private memberEnum: number,
@@ -34,7 +34,7 @@ export class GetContractInstance extends Instruction {
34
34
 
35
35
  async execute(context: AvmContext): Promise<void> {
36
36
  const memory = context.machineState.memory;
37
- const addressing = Addressing.fromWire(this.indirect);
37
+ const addressing = Addressing.fromWire(this.addressingMode);
38
38
 
39
39
  context.machineState.consumeGas(
40
40
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -67,9 +67,6 @@ export class GetContractInstance extends Instruction {
67
67
  }
68
68
  }
69
69
 
70
- const existsOffset = dstOffset;
71
- const memberValueOffset = dstOffset + 1;
72
- memory.set(existsOffset, new Uint1(exists ? 1 : 0));
73
- memory.set(memberValueOffset, memberValue);
70
+ memory.setSlice(dstOffset, [new Uint1(exists ? 1 : 0), memberValue]);
74
71
  }
75
72
  }
@@ -39,7 +39,7 @@ export class JumpI extends Instruction {
39
39
  ];
40
40
 
41
41
  constructor(
42
- private indirect: number,
42
+ private addressingMode: number,
43
43
  private condOffset: number,
44
44
  private loc: number,
45
45
  ) {
@@ -48,7 +48,7 @@ export class JumpI extends Instruction {
48
48
 
49
49
  public async execute(context: AvmContext): Promise<void> {
50
50
  const memory = context.machineState.memory;
51
- const addressing = Addressing.fromWire(this.indirect);
51
+ const addressing = Addressing.fromWire(this.addressingMode);
52
52
 
53
53
  context.machineState.consumeGas(
54
54
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
@@ -12,7 +12,7 @@ export class ToRadixBE extends Instruction {
12
12
  // Informs (de)serialization. See Instruction.deserialize.
13
13
  static readonly wireFormat: OperandType[] = [
14
14
  OperandType.UINT8, // Opcode
15
- OperandType.UINT16, // Indirect
15
+ OperandType.UINT16, // addressing_mode
16
16
  OperandType.UINT16, // src memory address
17
17
  OperandType.UINT16, // radix memory address
18
18
  OperandType.UINT16, // number of limbs address
@@ -21,7 +21,7 @@ export class ToRadixBE extends Instruction {
21
21
  ];
22
22
 
23
23
  constructor(
24
- private indirect: number,
24
+ private addressingMode: number,
25
25
  private srcOffset: number,
26
26
  private radixOffset: number,
27
27
  private numLimbsOffset: number,
@@ -33,7 +33,7 @@ export class ToRadixBE extends Instruction {
33
33
 
34
34
  public async execute(context: AvmContext): Promise<void> {
35
35
  const memory = context.machineState.memory;
36
- const addressing = Addressing.fromWire(this.indirect);
36
+ const addressing = Addressing.fromWire(this.addressingMode);
37
37
 
38
38
  context.machineState.consumeGas(
39
39
  this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),