@aztec/simulator 0.0.1-commit.2eb6648a → 0.0.1-commit.2f68f620

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 (312) hide show
  1. package/README.md +4 -4
  2. package/dest/private/acvm_wasm.d.ts +1 -1
  3. package/dest/private/acvm_wasm.d.ts.map +1 -1
  4. package/dest/private/acvm_wasm.js +3 -1
  5. package/dest/private/circuit_recording/circuit_recorder.js +2 -2
  6. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  7. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  8. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  9. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +2 -1
  10. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  11. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +17 -2
  12. package/dest/public/avm/testing/utils.d.ts +32 -0
  13. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  14. package/dest/public/avm/{fixtures → testing}/utils.js +3 -33
  15. package/dest/public/contracts_db_checkpoint.d.ts +2 -2
  16. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  17. package/dest/public/contracts_db_checkpoint.js +1 -1
  18. package/dest/public/fixtures/amm_test.js +2 -2
  19. package/dest/public/fixtures/bulk_test.d.ts +1 -1
  20. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  21. package/dest/public/fixtures/bulk_test.js +31 -4
  22. package/dest/public/fixtures/index.d.ts +1 -4
  23. package/dest/public/fixtures/index.d.ts.map +1 -1
  24. package/dest/public/fixtures/index.js +0 -3
  25. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +8 -7
  26. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  27. package/dest/public/fixtures/public_tx_simulation_tester.js +16 -17
  28. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  29. package/dest/public/fixtures/utils.d.ts +2 -2
  30. package/dest/public/fixtures/utils.d.ts.map +1 -1
  31. package/dest/public/fixtures/utils.js +19 -20
  32. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +6 -4
  33. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -1
  34. package/dest/public/fuzzing/avm_fuzzer_simulator.js +12 -7
  35. package/dest/public/fuzzing/avm_simulator_bin.js +4 -4
  36. package/dest/public/index.d.ts +2 -2
  37. package/dest/public/index.d.ts.map +1 -1
  38. package/dest/public/index.js +1 -1
  39. package/dest/public/public_db_sources.d.ts +6 -3
  40. package/dest/public/public_db_sources.d.ts.map +1 -1
  41. package/dest/public/public_db_sources.js +16 -10
  42. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -7
  43. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  44. package/dest/public/public_processor/guarded_merkle_tree.js +8 -5
  45. package/dest/public/public_processor/public_processor.d.ts +8 -5
  46. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  47. package/dest/public/public_processor/public_processor.js +109 -74
  48. package/dest/public/public_processor/public_processor_metrics.d.ts +4 -1
  49. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  50. package/dest/public/public_processor/public_processor_metrics.js +8 -0
  51. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +1 -1
  52. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -1
  53. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +3 -2
  54. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +23 -0
  55. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  56. package/dest/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.js → dumping_public_tx_simulator.js} +2 -2
  57. package/dest/public/public_tx_simulator/factories.d.ts +6 -6
  58. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -1
  59. package/dest/public/public_tx_simulator/factories.js +8 -8
  60. package/dest/public/public_tx_simulator/index.d.ts +3 -5
  61. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  62. package/dest/public/public_tx_simulator/index.js +2 -4
  63. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +41 -70
  64. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  65. package/dest/public/public_tx_simulator/public_tx_simulator.js +98 -319
  66. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +22 -0
  67. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  68. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +28 -0
  69. package/package.json +17 -18
  70. package/src/private/acvm_wasm.ts +4 -1
  71. package/src/private/circuit_recording/circuit_recorder.ts +2 -2
  72. package/src/public/avm/testing/account_proof.json +553 -0
  73. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  74. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +22 -2
  75. package/src/public/avm/{fixtures → testing}/utils.ts +3 -39
  76. package/src/public/contracts_db_checkpoint.ts +1 -1
  77. package/src/public/fixtures/amm_test.ts +2 -2
  78. package/src/public/fixtures/bulk_test.ts +29 -4
  79. package/src/public/fixtures/index.ts +0 -3
  80. package/src/public/fixtures/public_tx_simulation_tester.ts +30 -15
  81. package/src/public/fixtures/simple_contract_data_source.ts +1 -1
  82. package/src/public/fixtures/utils.ts +26 -22
  83. package/src/public/fuzzing/avm_fuzzer_simulator.ts +16 -19
  84. package/src/public/fuzzing/avm_simulator_bin.ts +3 -5
  85. package/src/public/index.ts +3 -3
  86. package/src/public/public_db_sources.ts +21 -14
  87. package/src/public/public_processor/guarded_merkle_tree.ts +11 -8
  88. package/src/public/public_processor/public_processor.ts +142 -93
  89. package/src/public/public_processor/public_processor_metrics.ts +12 -0
  90. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +3 -2
  91. package/src/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.ts → dumping_public_tx_simulator.ts} +2 -2
  92. package/src/public/public_tx_simulator/factories.ts +8 -7
  93. package/src/public/public_tx_simulator/index.ts +2 -4
  94. package/src/public/public_tx_simulator/public_tx_simulator.ts +150 -476
  95. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +35 -0
  96. package/dest/public/avm/avm_context.d.ts +0 -41
  97. package/dest/public/avm/avm_context.d.ts.map +0 -1
  98. package/dest/public/avm/avm_context.js +0 -44
  99. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  100. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  101. package/dest/public/avm/avm_contract_call_result.js +0 -54
  102. package/dest/public/avm/avm_execution_environment.d.ts +0 -24
  103. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  104. package/dest/public/avm/avm_execution_environment.js +0 -33
  105. package/dest/public/avm/avm_gas.d.ts +0 -44
  106. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  107. package/dest/public/avm/avm_gas.js +0 -195
  108. package/dest/public/avm/avm_machine_state.d.ts +0 -98
  109. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  110. package/dest/public/avm/avm_machine_state.js +0 -110
  111. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  112. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  113. package/dest/public/avm/avm_memory_types.js +0 -354
  114. package/dest/public/avm/avm_simulator.d.ts +0 -41
  115. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  116. package/dest/public/avm/avm_simulator.js +0 -192
  117. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  118. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  119. package/dest/public/avm/avm_simulator_interface.js +0 -3
  120. package/dest/public/avm/calldata.d.ts +0 -51
  121. package/dest/public/avm/calldata.d.ts.map +0 -1
  122. package/dest/public/avm/calldata.js +0 -63
  123. package/dest/public/avm/errors.d.ts +0 -104
  124. package/dest/public/avm/errors.d.ts.map +0 -1
  125. package/dest/public/avm/errors.js +0 -141
  126. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  127. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  128. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -84
  129. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  130. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  131. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  132. package/dest/public/avm/fixtures/initializers.js +0 -45
  133. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  134. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  135. package/dest/public/avm/index.d.ts +0 -2
  136. package/dest/public/avm/index.d.ts.map +0 -1
  137. package/dest/public/avm/index.js +0 -1
  138. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -74
  139. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  140. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  141. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  142. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  143. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  144. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -49
  145. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  146. package/dest/public/avm/opcodes/arithmetic.js +0 -97
  147. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  148. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  149. package/dest/public/avm/opcodes/bitwise.js +0 -99
  150. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  151. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  152. package/dest/public/avm/opcodes/comparators.js +0 -43
  153. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  154. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  155. package/dest/public/avm/opcodes/contract.js +0 -65
  156. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  157. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  158. package/dest/public/avm/opcodes/control_flow.js +0 -107
  159. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  160. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  161. package/dest/public/avm/opcodes/conversion.js +0 -333
  162. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  163. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  164. package/dest/public/avm/opcodes/ec_add.js +0 -93
  165. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  166. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  167. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  168. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  169. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  170. package/dest/public/avm/opcodes/external_calls.js +0 -210
  171. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  172. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  173. package/dest/public/avm/opcodes/hashing.js +0 -119
  174. package/dest/public/avm/opcodes/index.d.ts +0 -16
  175. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  176. package/dest/public/avm/opcodes/index.js +0 -15
  177. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  178. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  179. package/dest/public/avm/opcodes/instruction.js +0 -95
  180. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  181. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  182. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  183. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  184. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  185. package/dest/public/avm/opcodes/memory.js +0 -257
  186. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  187. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  188. package/dest/public/avm/opcodes/misc.js +0 -73
  189. package/dest/public/avm/opcodes/storage.d.ts +0 -25
  190. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  191. package/dest/public/avm/opcodes/storage.js +0 -78
  192. package/dest/public/avm/revert_reason.d.ts +0 -18
  193. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  194. package/dest/public/avm/revert_reason.js +0 -39
  195. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  196. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  197. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  198. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  199. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  200. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  201. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  202. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  203. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  204. package/dest/public/avm/test_utils.d.ts +0 -15
  205. package/dest/public/avm/test_utils.d.ts.map +0 -1
  206. package/dest/public/avm/test_utils.js +0 -44
  207. package/dest/public/debug_fn_name.d.ts +0 -18
  208. package/dest/public/debug_fn_name.d.ts.map +0 -1
  209. package/dest/public/debug_fn_name.js +0 -37
  210. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -12
  211. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  212. package/dest/public/fixtures/custom_bytecode_tests.js +0 -174
  213. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -4
  214. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  215. package/dest/public/fixtures/minimal_public_tx.js +0 -19
  216. package/dest/public/fixtures/opcode_spammer.d.ts +0 -122
  217. package/dest/public/fixtures/opcode_spammer.d.ts.map +0 -1
  218. package/dest/public/fixtures/opcode_spammer.js +0 -1653
  219. package/dest/public/hinting_db_sources.d.ts +0 -80
  220. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  221. package/dest/public/hinting_db_sources.js +0 -355
  222. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -53
  223. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  224. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -132
  225. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  226. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  227. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  228. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  229. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  230. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -171
  231. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +0 -23
  232. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +0 -1
  233. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  234. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  235. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  236. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -131
  237. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  238. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  239. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  240. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  241. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -415
  242. package/dest/public/side_effect_trace.d.ts +0 -87
  243. package/dest/public/side_effect_trace.d.ts.map +0 -1
  244. package/dest/public/side_effect_trace.js +0 -199
  245. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  246. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  247. package/dest/public/side_effect_trace_interface.js +0 -1
  248. package/dest/public/state_manager/index.d.ts +0 -2
  249. package/dest/public/state_manager/index.d.ts.map +0 -1
  250. package/dest/public/state_manager/index.js +0 -1
  251. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  252. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  253. package/dest/public/state_manager/nullifiers.js +0 -92
  254. package/dest/public/state_manager/public_storage.d.ts +0 -66
  255. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  256. package/dest/public/state_manager/public_storage.js +0 -145
  257. package/dest/public/state_manager/state_manager.d.ts +0 -170
  258. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  259. package/dest/public/state_manager/state_manager.js +0 -402
  260. package/src/public/avm/avm_context.ts +0 -61
  261. package/src/public/avm/avm_contract_call_result.ts +0 -69
  262. package/src/public/avm/avm_execution_environment.ts +0 -51
  263. package/src/public/avm/avm_gas.ts +0 -183
  264. package/src/public/avm/avm_machine_state.ts +0 -170
  265. package/src/public/avm/avm_memory_types.ts +0 -440
  266. package/src/public/avm/avm_simulator.ts +0 -279
  267. package/src/public/avm/avm_simulator_interface.ts +0 -8
  268. package/src/public/avm/calldata.ts +0 -100
  269. package/src/public/avm/errors.ts +0 -177
  270. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -122
  271. package/src/public/avm/fixtures/initializers.ts +0 -103
  272. package/src/public/avm/index.ts +0 -1
  273. package/src/public/avm/opcodes/accrued_substate.ts +0 -286
  274. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  275. package/src/public/avm/opcodes/arithmetic.ts +0 -129
  276. package/src/public/avm/opcodes/bitwise.ts +0 -113
  277. package/src/public/avm/opcodes/comparators.ts +0 -55
  278. package/src/public/avm/opcodes/contract.ts +0 -72
  279. package/src/public/avm/opcodes/control_flow.ts +0 -123
  280. package/src/public/avm/opcodes/conversion.ts +0 -104
  281. package/src/public/avm/opcodes/ec_add.ts +0 -105
  282. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  283. package/src/public/avm/opcodes/external_calls.ts +0 -262
  284. package/src/public/avm/opcodes/hashing.ts +0 -151
  285. package/src/public/avm/opcodes/index.ts +0 -15
  286. package/src/public/avm/opcodes/instruction.ts +0 -136
  287. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  288. package/src/public/avm/opcodes/memory.ts +0 -293
  289. package/src/public/avm/opcodes/misc.ts +0 -102
  290. package/src/public/avm/opcodes/storage.ts +0 -95
  291. package/src/public/avm/revert_reason.ts +0 -58
  292. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  293. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  294. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  295. package/src/public/avm/test_utils.ts +0 -64
  296. package/src/public/debug_fn_name.ts +0 -52
  297. package/src/public/fixtures/custom_bytecode_tests.ts +0 -228
  298. package/src/public/fixtures/minimal_public_tx.ts +0 -26
  299. package/src/public/fixtures/opcode_spammer.ts +0 -1721
  300. package/src/public/hinting_db_sources.ts +0 -607
  301. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -211
  302. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -134
  303. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -239
  304. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  305. package/src/public/public_tx_simulator/public_tx_context.ts +0 -484
  306. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  307. package/src/public/side_effect_trace.ts +0 -293
  308. package/src/public/side_effect_trace_interface.ts +0 -28
  309. package/src/public/state_manager/index.ts +0 -1
  310. package/src/public/state_manager/nullifiers.ts +0 -103
  311. package/src/public/state_manager/public_storage.ts +0 -174
  312. package/src/public/state_manager/state_manager.ts +0 -569
@@ -1,279 +0,0 @@
1
- import { Fr } from '@aztec/foundation/curves/bn254';
2
- import { type Logger, createLogger } from '@aztec/foundation/log';
3
- import { Timer } from '@aztec/foundation/timer';
4
- import type { PublicSimulatorConfig } from '@aztec/stdlib/avm';
5
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
6
- import type { GlobalVariables } from '@aztec/stdlib/tx';
7
-
8
- import { strict as assert } from 'assert';
9
-
10
- import { CheckedPublicExecutionError } from '../public_errors.js';
11
- import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
12
- import { AvmContext } from './avm_context.js';
13
- import { AvmContractCallResult } from './avm_contract_call_result.js';
14
- import { AvmExecutionEnvironment } from './avm_execution_environment.js';
15
- import type { Gas } from './avm_gas.js';
16
- import { AvmMachineState } from './avm_machine_state.js';
17
- import type { AvmSimulatorInterface } from './avm_simulator_interface.js';
18
- import { type CallData, ReturnDataArray } from './calldata.js';
19
- import { AvmRevertReason, InvalidProgramCounterError } from './errors.js';
20
- import type { Instruction } from './opcodes/instruction.js';
21
- import { revertReasonFromExceptionalHalt, revertReasonFromExplicitRevert } from './revert_reason.js';
22
- import {
23
- INSTRUCTION_SET,
24
- type InstructionSet,
25
- decodeInstructionFromBytecode,
26
- } from './serialization/bytecode_serialization.js';
27
-
28
- type OpcodeTally = {
29
- count: number;
30
- gas: Gas;
31
- };
32
-
33
- export class AvmSimulator implements AvmSimulatorInterface {
34
- private log: Logger;
35
- private bytecode: Buffer | undefined;
36
- private opcodeTallies: Map<string, OpcodeTally> = new Map();
37
- // maps pc to [instr, bytesRead]
38
- private deserializedInstructionsCache: Map<number, [Instruction, number]> = new Map();
39
-
40
- private tallyPrintFunction = () => {};
41
- private tallyInstructionFunction = (_b: string, _c: Gas) => {};
42
-
43
- // Test Purposes only: Logger will not have the proper function name. Use this constructor for testing purposes
44
- // only. Otherwise, use build() below.
45
- constructor(
46
- private context: AvmContext,
47
- private instructionSet: InstructionSet = INSTRUCTION_SET,
48
- enableTallying = false,
49
- ) {
50
- // This will be used by the CALL opcode to create a new simulator. It is required to
51
- // avoid a dependency cycle.
52
- context.provideSimulator = AvmSimulator.build;
53
- this.log = createLogger(`simulator:avm(calldata[0]: ${context.environment.calldata.read(0)})`);
54
- // Turn on tallying if explicitly enabled or if trace logging
55
- if (enableTallying || this.log.isLevelEnabled('trace')) {
56
- this.tallyPrintFunction = this.printOpcodeTallies;
57
- this.tallyInstructionFunction = this.tallyInstruction;
58
- }
59
- }
60
-
61
- // Factory to have a proper function name in the logger. Retrieving the name is asynchronous and
62
- // cannot be done as part of the constructor.
63
- public static async build(context: AvmContext): Promise<AvmSimulator> {
64
- const simulator = new AvmSimulator(context);
65
- const fnName = await context.persistableState.getPublicFunctionDebugName(context.environment);
66
- simulator.log = createLogger(`simulator:avm(f:${fnName})`);
67
-
68
- return simulator;
69
- }
70
-
71
- public static async create(
72
- stateManager: PublicPersistableStateManager,
73
- address: AztecAddress,
74
- sender: AztecAddress,
75
- transactionFee: Fr,
76
- globals: GlobalVariables,
77
- isStaticCall: boolean,
78
- calldata: CallData,
79
- allocatedGas: Gas,
80
- config: PublicSimulatorConfig,
81
- ) {
82
- const avmExecutionEnv = new AvmExecutionEnvironment(
83
- address,
84
- sender,
85
- /*contractCallDepth=*/ Fr.zero(),
86
- transactionFee,
87
- globals,
88
- isStaticCall,
89
- calldata,
90
- config,
91
- );
92
-
93
- const avmMachineState = new AvmMachineState(allocatedGas);
94
- const avmContext = new AvmContext(stateManager, avmExecutionEnv, avmMachineState);
95
- return await AvmSimulator.build(avmContext);
96
- }
97
-
98
- /**
99
- * Fetch the bytecode and execute it in the current context.
100
- */
101
- public async execute(): Promise<AvmContractCallResult> {
102
- const bytecode = await this.context.persistableState.getBytecode(this.context.environment.address);
103
- // getBytecode returns undefined if bytecode is not found or if the limit of contract calls to unique class IDs is reached.
104
- // If it throws an error that reaches this point, it is a bug.
105
-
106
- if (!bytecode) {
107
- return await this.handleFailureToRetrieveBytecode(
108
- `No bytecode found. Contract is not deployed, or limit encountered for max calls to unique contract class IDs. Contract address: ${this.context.environment.address}. Reverting...`,
109
- );
110
- }
111
-
112
- return await this.executeBytecode(bytecode);
113
- }
114
-
115
- /**
116
- * Return the bytecode used for execution, if any.
117
- */
118
- public getBytecode(): Buffer | undefined {
119
- return this.bytecode;
120
- }
121
-
122
- /**
123
- * Executes the provided bytecode in the current context.
124
- * This method is useful for testing and debugging.
125
- */
126
- public async executeBytecode(bytecode: Buffer): Promise<AvmContractCallResult> {
127
- const timer = new Timer();
128
- assert(bytecode.length > 0, "AVM simulator can't execute empty bytecode");
129
-
130
- this.bytecode = bytecode;
131
- let instructionName = 'NONE'; // This is used for logging purposes
132
-
133
- const { machineState } = this.context;
134
- const callStartGas = machineState.gasLeft; // Save gas before executing instruction (for profiling)
135
- try {
136
- // Execute instruction pointed to by the current program counter
137
- // continuing until the machine state signifies a halt
138
- while (!machineState.getHalted()) {
139
- // Get the instruction from cache, or deserialize for the first time
140
- let cachedInstruction = this.deserializedInstructionsCache.get(machineState.pc);
141
-
142
- if (cachedInstruction === undefined) {
143
- cachedInstruction = decodeInstructionFromBytecode(bytecode, machineState.pc, this.instructionSet);
144
- this.deserializedInstructionsCache.set(machineState.pc, cachedInstruction);
145
- }
146
- const [instruction, bytesRead] = cachedInstruction;
147
-
148
- const instrStartGas = machineState.gasLeft; // Save gas before executing instruction (for profiling)
149
-
150
- if (this.log.isLevelEnabled('trace')) {
151
- // Skip this entirely to avoid toStringing etc if trace is not enabled
152
- this.log.trace(
153
- `[PC:${machineState.pc}] [IC:${machineState.instrCounter}] ${instruction.toString()} (gasLeft l2=${
154
- machineState.l2GasLeft
155
- } da=${machineState.daGasLeft})`,
156
- );
157
- }
158
- machineState.nextPc = machineState.pc + bytesRead;
159
-
160
- instructionName = instruction.constructor.name;
161
- // Execute the instruction.
162
- // Normal returns and reverts will return normally here.
163
- // "Exceptional halts" will throw.
164
- await instruction.execute(this.context);
165
- if (!instruction.handlesPC()) {
166
- // Increment PC if the instruction doesn't handle it itself
167
- machineState.pc += bytesRead;
168
- }
169
-
170
- machineState.instrCounter++;
171
-
172
- // gas used by this instruction - used for profiling/tallying
173
- const gasUsed: Gas = {
174
- l2Gas: instrStartGas.l2Gas - machineState.l2GasLeft,
175
- daGas: instrStartGas.daGas - machineState.daGasLeft,
176
- };
177
- this.tallyInstructionFunction(instruction.constructor.name, gasUsed);
178
-
179
- if (machineState.pc >= bytecode.length) {
180
- this.log.warn('Passed end of program');
181
- throw new InvalidProgramCounterError(machineState.pc, /*max=*/ bytecode.length - 1);
182
- }
183
- }
184
-
185
- const output = machineState.getOutput();
186
- const reverted = machineState.getReverted();
187
- const revertReason = reverted
188
- ? await revertReasonFromExplicitRevert(output.bestEffortReadAll(), this.context)
189
- : undefined;
190
- const results = new AvmContractCallResult(
191
- reverted,
192
- output,
193
- machineState.gasLeft,
194
- revertReason,
195
- machineState.instrCounter,
196
- );
197
- this.log.debug(`Context execution results: ${results.toString()}`);
198
- const totalGasUsed: Gas = {
199
- l2Gas: callStartGas.l2Gas - machineState.l2GasLeft,
200
- daGas: callStartGas.daGas - machineState.daGasLeft,
201
- };
202
- this.log.debug(`Executed ${machineState.instrCounter} instructions and consumed ${totalGasUsed.l2Gas} L2 Gas`);
203
-
204
- this.tallyPrintFunction();
205
-
206
- this.log.debug(`Core AVM simulation took ${timer.ms()}ms`);
207
-
208
- // Return results for processing by calling context
209
- return results;
210
- } catch (err: any) {
211
- this.log.info(
212
- `Exceptional halt (revert by something other than REVERT opcode) for instruction
213
- ${instructionName} at pc ${machineState.pc} and instruction counter ${machineState.instrCounter}`,
214
- );
215
- if (!(err instanceof CheckedPublicExecutionError)) {
216
- this.log.error(`Unchecked/unknown error thrown by AVM. This is a bug. Error: ${err}`);
217
- throw err;
218
- }
219
-
220
- const revertReason = await revertReasonFromExceptionalHalt(err, this.context);
221
- // Exceptional halts consume all allocated gas
222
- const noGasLeft = { l2Gas: 0, daGas: 0 };
223
- // Note: "exceptional halts" cannot return data, hence [].
224
- const results = new AvmContractCallResult(
225
- /*reverted=*/ true,
226
- /*output=*/ new ReturnDataArray([]),
227
- noGasLeft,
228
- revertReason,
229
- machineState.instrCounter,
230
- );
231
- this.log.debug(`Context execution results: ${results.toString()}`);
232
-
233
- this.tallyPrintFunction();
234
- // Return results for processing by calling context
235
- return results;
236
- }
237
- }
238
-
239
- private async handleFailureToRetrieveBytecode(message: string): Promise<AvmContractCallResult> {
240
- // revert, consuming all gas
241
- const { functionSelector, functionName } = await this.context.persistableState.getPublicFunctionSelectorAndName(
242
- this.context.environment,
243
- );
244
- const revertReason = new AvmRevertReason(
245
- message,
246
- /*failingFunction=*/ {
247
- contractAddress: this.context.environment.address,
248
- functionSelector,
249
- functionName,
250
- },
251
- /*noirCallStack=*/ [],
252
- );
253
- this.log.warn(message);
254
- return new AvmContractCallResult(
255
- /*reverted=*/ true,
256
- /*output=*/ new ReturnDataArray([]),
257
- /*gasLeft=*/ { l2Gas: 0, daGas: 0 }, // consumes all allocated gas
258
- revertReason,
259
- );
260
- }
261
-
262
- private tallyInstruction(opcode: string, gasUsed: Gas) {
263
- const opcodeTally = this.opcodeTallies.get(opcode) || ({ count: 0, gas: { l2Gas: 0, daGas: 0 } } as OpcodeTally);
264
- opcodeTally.count++;
265
- opcodeTally.gas.l2Gas += gasUsed.l2Gas;
266
- opcodeTally.gas.daGas += gasUsed.daGas;
267
- this.opcodeTallies.set(opcode, opcodeTally);
268
- }
269
-
270
- private printOpcodeTallies() {
271
- this.log.debug(`Printing tallies per opcode sorted by gas...`);
272
- // sort descending by L2 gas consumed
273
- const sortedOpcodes = Array.from(this.opcodeTallies.entries()).sort((a, b) => b[1].gas.l2Gas - a[1].gas.l2Gas);
274
- for (const [opcode, tally] of sortedOpcodes) {
275
- // NOTE: don't care to clutter the logs with DA gas for now
276
- this.log.debug(`${opcode} executed ${tally.count} times consuming a total of ${tally.gas.l2Gas} L2 gas`);
277
- }
278
- }
279
- }
@@ -1,8 +0,0 @@
1
- /**
2
- * Interface for AvmSimulator to break the circular dependency between avm_context.ts and avm_simulator.ts
3
- */
4
- export interface AvmSimulatorInterface {
5
- execute(): Promise<any>; // Using any here to avoid importing AvmContractCallResult
6
- executeBytecode(bytecode: Buffer): Promise<any>;
7
- getBytecode(): Buffer | undefined;
8
- }
@@ -1,100 +0,0 @@
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
- }
@@ -1,177 +0,0 @@
1
- import type { Point } from '@aztec/foundation/curves/grumpkin';
2
- import type { FailingFunction, NoirCallStack } from '@aztec/stdlib/errors';
3
-
4
- import { ExecutionError } from '../../common/errors.js';
5
- import { CheckedPublicExecutionError } from '../public_errors.js';
6
-
7
- /**
8
- * Avm-specific errors should derive from this
9
- */
10
- export abstract class AvmExecutionError extends CheckedPublicExecutionError {
11
- constructor(message: string) {
12
- super(message);
13
- this.name = 'AvmExecutionError';
14
- }
15
- }
16
-
17
- export class ArithmeticError extends AvmExecutionError {
18
- constructor(message: string) {
19
- super(message);
20
- this.name = 'ArithmeticError';
21
- }
22
- }
23
-
24
- /**
25
- * Error is thrown when the program counter goes to an invalid location.
26
- * There is no instruction at the provided pc
27
- */
28
- export class InvalidProgramCounterError extends AvmExecutionError {
29
- constructor(pc: number, max: number) {
30
- super(`Invalid program counter ${pc}, max is ${max}`);
31
- this.name = 'InvalidProgramCounterError';
32
- }
33
- }
34
-
35
- /**
36
- * Error is thrown when the program counter points to a byte
37
- * of an invalid opcode.
38
- */
39
- export class InvalidOpcodeError extends AvmExecutionError {
40
- constructor(str: string) {
41
- super(str);
42
- this.name = 'InvalidOpcodeError';
43
- }
44
- }
45
-
46
- /**
47
- * Error is thrown during parsing.
48
- */
49
- export class AvmParsingError extends AvmExecutionError {
50
- constructor(str: string) {
51
- super(str);
52
- this.name = 'AvmParsingError';
53
- }
54
- }
55
-
56
- /**
57
- * Error is thrown when the tag has an invalid value.
58
- */
59
- export class InvalidTagValueError extends AvmExecutionError {
60
- constructor(tagValue: number) {
61
- super(`Tag check failed: Tag value ${tagValue} is invalid.`);
62
- this.name = 'InvalidTagValueError';
63
- }
64
- }
65
-
66
- /**
67
- * Error thrown during an instruction's execution (during its execute()).
68
- */
69
- export class InstructionExecutionError extends AvmExecutionError {
70
- constructor(message: string) {
71
- super(message);
72
- this.name = 'InstructionExecutionError';
73
- }
74
- }
75
-
76
- /**
77
- * Error thrown on failed AVM memory tag check.
78
- */
79
- export class TagCheckError extends AvmExecutionError {
80
- public static forBaseAddress(gotTag: string): TagCheckError {
81
- return new TagCheckError(`Base address (mem[0]) is not a valid address (has tag ${gotTag})`);
82
- }
83
- public static forIndirectAddress(address: number, gotTag: string): TagCheckError {
84
- return new TagCheckError(`Address after indirection is not a valid address (address ${address} has tag ${gotTag})`);
85
- }
86
- public static forOffset(offset: number, gotTag: string, expectedTag: string): TagCheckError {
87
- return new TagCheckError(`Tag mismatch at offset ${offset}, got ${gotTag}, expected ${expectedTag}`);
88
- }
89
-
90
- public static forTag(gotTag: string, expectedTag: string): TagCheckError {
91
- return new TagCheckError(`Tag mismatch, got ${gotTag}, expected ${expectedTag}`);
92
- }
93
-
94
- constructor(message: string) {
95
- super(message);
96
- this.name = 'TagCheckError';
97
- }
98
- }
99
-
100
- /**
101
- * Error is thrown when a relative memory address resolved to an offset which
102
- * is out of range, i.e, greater than maxUint32.
103
- */
104
- export class RelativeAddressOutOfRangeError extends AvmExecutionError {
105
- constructor(baseAddr: number, relOffset: number) {
106
- super(`Relative address out of range. Base address ${baseAddr}, relative offset ${relOffset}`);
107
- this.name = 'RelativeAddressOutOfRangeError';
108
- }
109
- }
110
-
111
- /**
112
- * Error is thrown when a memory slice contains addresses which are
113
- * out of range, i.e, greater than maxUint32.
114
- */
115
- export class MemorySliceOutOfRangeError extends AvmExecutionError {
116
- constructor(baseAddr: number, size: number) {
117
- super(`Memory slice is out of range. Base address ${baseAddr}, size ${size}`);
118
- this.name = 'MemorySliceOutOfRangeError';
119
- }
120
- }
121
-
122
- /** Error thrown when out of gas. */
123
- export class OutOfGasError extends AvmExecutionError {
124
- constructor(dimensions: string[]) {
125
- super(`Not enough ${dimensions.map(d => d.toUpperCase()).join(', ')} gas left`);
126
- this.name = 'OutOfGasError';
127
- }
128
- }
129
-
130
- /**
131
- * Error is thrown when one of the supplied points does not lie on the Grumpkin curve. Specific for ECADD opcode.
132
- */
133
- export class EcAddPointNotOnCurveError extends AvmExecutionError {
134
- constructor(pointIndex: number, point: Point) {
135
- super(`EcAdd point${pointIndex} (${point.toString()}) is not on the curve.`);
136
- this.name = 'EcAddPointNotOnCurveError';
137
- }
138
- }
139
-
140
- /**
141
- * Error is thrown when some inputs of ToRadixBE are not valid.
142
- */
143
- export class InvalidToRadixInputsError extends AvmExecutionError {
144
- constructor(errorString: string) {
145
- super(errorString);
146
- this.name = 'InvalidToRadixInputsError';
147
- }
148
- }
149
-
150
- /**
151
- * Error is thrown when a static call attempts to alter some state
152
- */
153
- export class StaticCallAlterationError extends InstructionExecutionError {
154
- constructor() {
155
- super('Static call cannot update the state, emit L2->L1 messages or generate logs');
156
- this.name = 'StaticCallAlterationError';
157
- }
158
- }
159
-
160
- /**
161
- * Meaningfully named alias for ExecutionError when used in the context of the AVM.
162
- * Maintains a recursive structure reflecting the AVM's external callstack/errorstack, where
163
- * options.cause is the error that caused this error (if this is not the root-cause itself).
164
- */
165
- export class AvmRevertReason extends ExecutionError {
166
- constructor(message: string, failingFunction: FailingFunction, noirCallStack: NoirCallStack, options?: ErrorOptions) {
167
- super(message, failingFunction, noirCallStack, options);
168
- }
169
- }
170
-
171
- /**
172
- * Helper to annotate errors occurring during instruction fetching.
173
- */
174
- export function duringInstrFetch(error: Error, pc: number) {
175
- error.message = `Instruction fetching error at pc ${pc}: ${error.message}`;
176
- return error;
177
- }
@@ -1,122 +0,0 @@
1
- import { Fr } from '@aztec/foundation/curves/bn254';
2
- import { encodeArguments } from '@aztec/stdlib/abi';
3
- import { PublicSimulatorConfig } from '@aztec/stdlib/avm';
4
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
5
- import { GasFees } from '@aztec/stdlib/gas';
6
- import type { MerkleTreeWriteOperations } from '@aztec/stdlib/interfaces/server';
7
- import { GlobalVariables } from '@aztec/stdlib/tx';
8
- import { NativeWorldStateService } from '@aztec/world-state';
9
-
10
- import { SideEffectTrace } from '../../../public/side_effect_trace.js';
11
- import type { AvmContractCallResult } from '../../avm/avm_contract_call_result.js';
12
- import { SimpleContractDataSource } from '../../fixtures/simple_contract_data_source.js';
13
- import { PublicContractsDB, PublicTreesDB } from '../../public_db_sources.js';
14
- import { PublicPersistableStateManager } from '../../state_manager/state_manager.js';
15
- import { AvmSimulator } from '../avm_simulator.js';
16
- import { CallDataArray } from '../calldata.js';
17
- import { BaseAvmSimulationTester } from './base_avm_simulation_tester.js';
18
- import { initContext, initExecutionEnvironment } from './initializers.js';
19
- import {
20
- DEFAULT_TIMESTAMP,
21
- getContractFunctionAbi,
22
- getFunctionSelector,
23
- resolveContractAssertionMessage,
24
- } from './utils.js';
25
-
26
- const DEFAULT_GAS_FEES = new GasFees(2, 3);
27
-
28
- /**
29
- * A test class that extends the BaseAvmSimulationTester to enable real-app testing of the core AvmSimulator.
30
- * It provides an interface for simulating one top-level call at a time and maintains state between
31
- * subsequent top-level calls.
32
- */
33
- export class AvmSimulationTester extends BaseAvmSimulationTester {
34
- constructor(
35
- contractDataSource: SimpleContractDataSource,
36
- merkleTrees: MerkleTreeWriteOperations,
37
- private stateManager: PublicPersistableStateManager,
38
- ) {
39
- super(contractDataSource, merkleTrees);
40
- }
41
-
42
- static async create(
43
- worldStateService: NativeWorldStateService, // make sure to close this later
44
- ): Promise<AvmSimulationTester> {
45
- const contractDataSource = new SimpleContractDataSource();
46
- const merkleTrees = await worldStateService.fork();
47
- const treesDB = new PublicTreesDB(merkleTrees);
48
- const contractsDB = new PublicContractsDB(contractDataSource);
49
- const trace = new SideEffectTrace();
50
- const firstNullifier = new Fr(420000);
51
-
52
- const stateManager = PublicPersistableStateManager.create(
53
- treesDB,
54
- contractsDB,
55
- trace,
56
- firstNullifier,
57
- DEFAULT_TIMESTAMP,
58
- );
59
- return new AvmSimulationTester(contractDataSource, merkleTrees, stateManager);
60
- }
61
-
62
- /**
63
- * Simulate a top-level contract call.
64
- */
65
- async simulateCall(
66
- sender: AztecAddress,
67
- address: AztecAddress,
68
- fnName: string,
69
- args: any[],
70
- isStaticCall = false,
71
- ): Promise<AvmContractCallResult> {
72
- const contractArtifact = await this.contractDataSource.getContractArtifact(address);
73
- if (!contractArtifact) {
74
- throw new Error(`Contract not found at address: ${address}`);
75
- }
76
- const fnSelector = await getFunctionSelector(fnName, contractArtifact);
77
- const fnAbi = getContractFunctionAbi(fnName, contractArtifact);
78
- const encodedArgs = encodeArguments(fnAbi!, args);
79
- const calldata = [fnSelector.toField(), ...encodedArgs];
80
-
81
- const globals = GlobalVariables.empty();
82
- globals.timestamp = DEFAULT_TIMESTAMP;
83
- globals.gasFees = DEFAULT_GAS_FEES;
84
-
85
- const config = PublicSimulatorConfig.from({
86
- skipFeeEnforcement: false,
87
- collectDebugLogs: true,
88
- collectHints: false,
89
- collectStatistics: false,
90
- collectCallMetadata: true,
91
- });
92
- const environment = initExecutionEnvironment({
93
- calldata: new CallDataArray(calldata),
94
- globals,
95
- address,
96
- sender,
97
- isStaticCall,
98
- config,
99
- });
100
- const persistableState = await this.stateManager.fork();
101
- const context = initContext({ env: environment, persistableState });
102
-
103
- // First we simulate (though it's not needed in this simple case).
104
- const simulator = new AvmSimulator(context);
105
- const result = await simulator.execute();
106
- if (result.reverted) {
107
- this.logger.error(`Error in ${fnName}:`);
108
- this.logger.error(
109
- resolveContractAssertionMessage(
110
- fnName,
111
- result.revertReason!,
112
- result.output.bestEffortReadAll(),
113
- contractArtifact,
114
- )!,
115
- );
116
- } else {
117
- this.logger.info(`Simulation of function ${fnName} succeeded!`);
118
- await this.stateManager.merge(persistableState);
119
- }
120
- return result;
121
- }
122
- }