@aztec/simulator 0.0.1-commit.d3ec352c → 0.0.1-commit.d58ff9d0

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 (391) hide show
  1. package/README.md +6 -4
  2. package/dest/client.d.ts +1 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +0 -2
  5. package/dest/common/errors.d.ts +8 -2
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/private/acvm/acvm.d.ts +4 -2
  8. package/dest/private/acvm/acvm.d.ts.map +1 -1
  9. package/dest/private/acvm/acvm.js +4 -3
  10. package/dest/private/acvm/deserialize.d.ts +2 -2
  11. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  12. package/dest/private/acvm/deserialize.js +1 -1
  13. package/dest/private/acvm/serialize.d.ts +2 -2
  14. package/dest/private/acvm/serialize.d.ts.map +1 -1
  15. package/dest/private/acvm/serialize.js +1 -1
  16. package/dest/private/acvm_native.d.ts +5 -3
  17. package/dest/private/acvm_native.d.ts.map +1 -1
  18. package/dest/private/acvm_native.js +8 -6
  19. package/dest/private/acvm_wasm.d.ts +4 -3
  20. package/dest/private/acvm_wasm.d.ts.map +1 -1
  21. package/dest/private/acvm_wasm.js +7 -5
  22. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  23. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  24. package/dest/private/circuit_recording/circuit_recorder.js +71 -72
  25. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  26. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  27. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  28. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  29. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  30. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  31. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  32. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  33. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  34. package/dest/private/factory.d.ts +3 -3
  35. package/dest/private/factory.d.ts.map +1 -1
  36. package/dest/private/factory.js +7 -4
  37. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  38. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  39. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  40. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +3 -2
  41. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  42. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +19 -4
  43. package/dest/public/avm/testing/utils.d.ts +32 -0
  44. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  45. package/dest/public/avm/{fixtures → testing}/utils.js +5 -35
  46. package/dest/public/avm_simulator.d.ts +28 -0
  47. package/dest/public/avm_simulator.d.ts.map +1 -0
  48. package/dest/public/avm_simulator.js +4 -0
  49. package/dest/public/avm_simulator_pool.d.ts +45 -0
  50. package/dest/public/avm_simulator_pool.d.ts.map +1 -0
  51. package/dest/public/avm_simulator_pool.js +197 -0
  52. package/dest/public/cdb/generated/api_types.d.ts +171 -0
  53. package/dest/public/cdb/generated/api_types.d.ts.map +1 -0
  54. package/dest/public/cdb/generated/api_types.js +314 -0
  55. package/dest/public/cdb/generated/server.d.ts +26 -0
  56. package/dest/public/cdb/generated/server.d.ts.map +1 -0
  57. package/dest/public/cdb/generated/server.js +135 -0
  58. package/dest/public/cdb_ipc_server.d.ts +33 -0
  59. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  60. package/dest/public/cdb_ipc_server.js +153 -0
  61. package/dest/public/contracts_db_checkpoint.d.ts +3 -3
  62. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  63. package/dest/public/contracts_db_checkpoint.js +1 -1
  64. package/dest/public/db_interfaces.d.ts +2 -2
  65. package/dest/public/db_interfaces.d.ts.map +1 -1
  66. package/dest/public/executor_metrics.d.ts +1 -1
  67. package/dest/public/executor_metrics.d.ts.map +1 -1
  68. package/dest/public/executor_metrics.js +12 -33
  69. package/dest/public/fixtures/amm_test.js +6 -6
  70. package/dest/public/fixtures/bulk_test.d.ts +3 -3
  71. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  72. package/dest/public/fixtures/bulk_test.js +38 -75
  73. package/dest/public/fixtures/custom_bytecode_tester.d.ts +28 -6
  74. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  75. package/dest/public/fixtures/custom_bytecode_tester.js +36 -12
  76. package/dest/public/fixtures/index.d.ts +3 -3
  77. package/dest/public/fixtures/index.d.ts.map +1 -1
  78. package/dest/public/fixtures/index.js +2 -2
  79. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  80. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  81. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  82. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +24 -6
  83. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  84. package/dest/public/fixtures/public_tx_simulation_tester.js +66 -21
  85. package/dest/public/fixtures/simple_contract_data_source.d.ts +2 -2
  86. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -1
  87. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  88. package/dest/public/fixtures/token_test.js +4 -4
  89. package/dest/public/fixtures/utils.d.ts +3 -3
  90. package/dest/public/fixtures/utils.d.ts.map +1 -1
  91. package/dest/public/fixtures/utils.js +25 -23
  92. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +67 -0
  93. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -0
  94. package/dest/public/fuzzing/avm_fuzzer_simulator.js +185 -0
  95. package/dest/public/fuzzing/avm_simulator_bin.d.ts +2 -0
  96. package/dest/public/fuzzing/avm_simulator_bin.d.ts.map +1 -0
  97. package/dest/public/fuzzing/avm_simulator_bin.js +118 -0
  98. package/dest/public/index.d.ts +5 -2
  99. package/dest/public/index.d.ts.map +1 -1
  100. package/dest/public/index.js +2 -1
  101. package/dest/public/public_db_sources.d.ts +10 -6
  102. package/dest/public/public_db_sources.d.ts.map +1 -1
  103. package/dest/public/public_db_sources.js +21 -15
  104. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -6
  105. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  106. package/dest/public/public_processor/guarded_merkle_tree.js +12 -4
  107. package/dest/public/public_processor/public_processor.d.ts +17 -8
  108. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  109. package/dest/public/public_processor/public_processor.js +535 -100
  110. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  111. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  112. package/dest/public/public_processor/public_processor_metrics.js +36 -45
  113. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  114. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  115. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.js +39 -0
  116. package/dest/public/public_tx_simulator/factories.d.ts +14 -0
  117. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -0
  118. package/dest/public/public_tx_simulator/factories.js +28 -0
  119. package/dest/public/public_tx_simulator/index.d.ts +5 -5
  120. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  121. package/dest/public/public_tx_simulator/index.js +3 -3
  122. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +43 -70
  123. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  124. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -312
  125. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  126. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  127. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  128. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +24 -1
  129. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -1
  130. package/dest/public/test_executor_metrics.d.ts +3 -2
  131. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  132. package/dest/public/test_executor_metrics.js +2 -2
  133. package/package.json +23 -20
  134. package/src/client.ts +0 -2
  135. package/src/common/errors.ts +1 -1
  136. package/src/private/acvm/acvm.ts +4 -3
  137. package/src/private/acvm/deserialize.ts +1 -1
  138. package/src/private/acvm/serialize.ts +1 -1
  139. package/src/private/acvm_native.ts +11 -5
  140. package/src/private/acvm_wasm.ts +11 -4
  141. package/src/private/circuit_recording/circuit_recorder.ts +90 -81
  142. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  143. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  144. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  145. package/src/private/factory.ts +7 -4
  146. package/src/public/avm/testing/account_proof.json +553 -0
  147. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  148. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +24 -4
  149. package/src/public/avm/{fixtures → testing}/utils.ts +5 -41
  150. package/src/public/avm_simulator.ts +29 -0
  151. package/src/public/avm_simulator_pool.ts +226 -0
  152. package/src/public/cdb/generated/api_types.ts +457 -0
  153. package/src/public/cdb/generated/server.ts +109 -0
  154. package/src/public/cdb_ipc_server.ts +197 -0
  155. package/src/public/contracts_db_checkpoint.ts +2 -2
  156. package/src/public/db_interfaces.ts +1 -1
  157. package/src/public/executor_metrics.ts +9 -33
  158. package/src/public/fixtures/amm_test.ts +6 -6
  159. package/src/public/fixtures/bulk_test.ts +40 -15
  160. package/src/public/fixtures/custom_bytecode_tester.ts +53 -19
  161. package/src/public/fixtures/index.ts +6 -2
  162. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  163. package/src/public/fixtures/public_tx_simulation_tester.ts +82 -21
  164. package/src/public/fixtures/simple_contract_data_source.ts +2 -2
  165. package/src/public/fixtures/token_test.ts +4 -4
  166. package/src/public/fixtures/utils.ts +25 -27
  167. package/src/public/fuzzing/avm_fuzzer_simulator.ts +303 -0
  168. package/src/public/fuzzing/avm_simulator_bin.ts +173 -0
  169. package/src/public/index.ts +8 -2
  170. package/src/public/public_db_sources.ts +37 -20
  171. package/src/public/public_processor/guarded_merkle_tree.ts +14 -7
  172. package/src/public/public_processor/public_processor.ts +188 -102
  173. package/src/public/public_processor/public_processor_metrics.ts +28 -44
  174. package/src/public/public_tx_simulator/dumping_public_tx_simulator.ts +67 -0
  175. package/src/public/public_tx_simulator/factories.ts +61 -0
  176. package/src/public/public_tx_simulator/index.ts +7 -4
  177. package/src/public/public_tx_simulator/public_tx_simulator.ts +143 -458
  178. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  179. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +23 -0
  180. package/src/public/test_executor_metrics.ts +3 -3
  181. package/dest/public/avm/avm_context.d.ts +0 -41
  182. package/dest/public/avm/avm_context.d.ts.map +0 -1
  183. package/dest/public/avm/avm_context.js +0 -44
  184. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  185. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  186. package/dest/public/avm/avm_contract_call_result.js +0 -54
  187. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  188. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  189. package/dest/public/avm/avm_execution_environment.js +0 -33
  190. package/dest/public/avm/avm_gas.d.ts +0 -44
  191. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  192. package/dest/public/avm/avm_gas.js +0 -195
  193. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  194. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  195. package/dest/public/avm/avm_machine_state.js +0 -109
  196. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  197. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  198. package/dest/public/avm/avm_memory_types.js +0 -351
  199. package/dest/public/avm/avm_simulator.d.ts +0 -40
  200. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  201. package/dest/public/avm/avm_simulator.js +0 -191
  202. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  203. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  204. package/dest/public/avm/avm_simulator_interface.js +0 -3
  205. package/dest/public/avm/errors.d.ts +0 -104
  206. package/dest/public/avm/errors.d.ts.map +0 -1
  207. package/dest/public/avm/errors.js +0 -141
  208. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  209. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  210. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -83
  211. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  212. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  213. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  214. package/dest/public/avm/fixtures/initializers.js +0 -44
  215. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  216. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  217. package/dest/public/avm/index.d.ts +0 -2
  218. package/dest/public/avm/index.d.ts.map +0 -1
  219. package/dest/public/avm/index.js +0 -1
  220. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  221. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  222. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  223. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  224. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  225. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  226. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -47
  227. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  228. package/dest/public/avm/opcodes/arithmetic.js +0 -87
  229. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  230. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  231. package/dest/public/avm/opcodes/bitwise.js +0 -99
  232. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  233. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  234. package/dest/public/avm/opcodes/comparators.js +0 -43
  235. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  236. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  237. package/dest/public/avm/opcodes/contract.js +0 -65
  238. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  239. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  240. package/dest/public/avm/opcodes/control_flow.js +0 -107
  241. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  242. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  243. package/dest/public/avm/opcodes/conversion.js +0 -333
  244. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  245. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  246. package/dest/public/avm/opcodes/ec_add.js +0 -84
  247. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  248. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  249. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  250. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  251. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  252. package/dest/public/avm/opcodes/external_calls.js +0 -209
  253. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  254. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  255. package/dest/public/avm/opcodes/hashing.js +0 -114
  256. package/dest/public/avm/opcodes/index.d.ts +0 -16
  257. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  258. package/dest/public/avm/opcodes/index.js +0 -15
  259. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  260. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  261. package/dest/public/avm/opcodes/instruction.js +0 -95
  262. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  263. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  264. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  265. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  266. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  267. package/dest/public/avm/opcodes/memory.js +0 -257
  268. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  269. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  270. package/dest/public/avm/opcodes/misc.js +0 -73
  271. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  272. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  273. package/dest/public/avm/opcodes/storage.js +0 -68
  274. package/dest/public/avm/revert_reason.d.ts +0 -18
  275. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  276. package/dest/public/avm/revert_reason.js +0 -39
  277. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  278. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  279. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  280. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  281. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  282. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  283. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  284. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  285. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  286. package/dest/public/avm/test_utils.d.ts +0 -15
  287. package/dest/public/avm/test_utils.d.ts.map +0 -1
  288. package/dest/public/avm/test_utils.js +0 -44
  289. package/dest/public/debug_fn_name.d.ts +0 -18
  290. package/dest/public/debug_fn_name.d.ts.map +0 -1
  291. package/dest/public/debug_fn_name.js +0 -28
  292. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -9
  293. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  294. package/dest/public/fixtures/custom_bytecode_tests.js +0 -109
  295. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -9
  296. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  297. package/dest/public/fixtures/minimal_public_tx.js +0 -29
  298. package/dest/public/hinting_db_sources.d.ts +0 -79
  299. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  300. package/dest/public/hinting_db_sources.js +0 -350
  301. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +0 -30
  302. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +0 -1
  303. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +0 -133
  304. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -38
  305. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  306. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -93
  307. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  308. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  309. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  310. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  311. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  312. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -170
  313. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  314. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  315. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  316. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -130
  317. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  318. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  319. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  320. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  321. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -39
  322. package/dest/public/side_effect_trace.d.ts +0 -86
  323. package/dest/public/side_effect_trace.d.ts.map +0 -1
  324. package/dest/public/side_effect_trace.js +0 -199
  325. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  326. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  327. package/dest/public/side_effect_trace_interface.js +0 -1
  328. package/dest/public/state_manager/index.d.ts +0 -2
  329. package/dest/public/state_manager/index.d.ts.map +0 -1
  330. package/dest/public/state_manager/index.js +0 -1
  331. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  332. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  333. package/dest/public/state_manager/nullifiers.js +0 -92
  334. package/dest/public/state_manager/public_storage.d.ts +0 -66
  335. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  336. package/dest/public/state_manager/public_storage.js +0 -145
  337. package/dest/public/state_manager/state_manager.d.ts +0 -164
  338. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  339. package/dest/public/state_manager/state_manager.js +0 -395
  340. package/src/public/avm/avm_context.ts +0 -61
  341. package/src/public/avm/avm_contract_call_result.ts +0 -67
  342. package/src/public/avm/avm_execution_environment.ts +0 -46
  343. package/src/public/avm/avm_gas.ts +0 -183
  344. package/src/public/avm/avm_machine_state.ts +0 -169
  345. package/src/public/avm/avm_memory_types.ts +0 -436
  346. package/src/public/avm/avm_simulator.ts +0 -276
  347. package/src/public/avm/avm_simulator_interface.ts +0 -8
  348. package/src/public/avm/errors.ts +0 -177
  349. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -116
  350. package/src/public/avm/fixtures/initializers.ts +0 -102
  351. package/src/public/avm/index.ts +0 -1
  352. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  353. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  354. package/src/public/avm/opcodes/arithmetic.ts +0 -117
  355. package/src/public/avm/opcodes/bitwise.ts +0 -113
  356. package/src/public/avm/opcodes/comparators.ts +0 -55
  357. package/src/public/avm/opcodes/contract.ts +0 -75
  358. package/src/public/avm/opcodes/control_flow.ts +0 -123
  359. package/src/public/avm/opcodes/conversion.ts +0 -104
  360. package/src/public/avm/opcodes/ec_add.ts +0 -96
  361. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  362. package/src/public/avm/opcodes/external_calls.ts +0 -260
  363. package/src/public/avm/opcodes/hashing.ts +0 -145
  364. package/src/public/avm/opcodes/index.ts +0 -15
  365. package/src/public/avm/opcodes/instruction.ts +0 -136
  366. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  367. package/src/public/avm/opcodes/memory.ts +0 -293
  368. package/src/public/avm/opcodes/misc.ts +0 -102
  369. package/src/public/avm/opcodes/storage.ts +0 -87
  370. package/src/public/avm/revert_reason.ts +0 -58
  371. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  372. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  373. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  374. package/src/public/avm/test_utils.ts +0 -64
  375. package/src/public/debug_fn_name.ts +0 -43
  376. package/src/public/fixtures/custom_bytecode_tests.ts +0 -135
  377. package/src/public/fixtures/minimal_public_tx.ts +0 -35
  378. package/src/public/hinting_db_sources.ts +0 -603
  379. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +0 -162
  380. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -155
  381. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -132
  382. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -240
  383. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  384. package/src/public/public_tx_simulator/public_tx_context.ts +0 -477
  385. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  386. package/src/public/side_effect_trace.ts +0 -290
  387. package/src/public/side_effect_trace_interface.ts +0 -28
  388. package/src/public/state_manager/index.ts +0 -1
  389. package/src/public/state_manager/nullifiers.ts +0 -103
  390. package/src/public/state_manager/public_storage.ts +0 -174
  391. package/src/public/state_manager/state_manager.ts +0 -560
@@ -1,505 +1,190 @@
1
- import { AVM_MAX_PROCESSABLE_L2_GAS } from '@aztec/constants';
2
- import { Fr } from '@aztec/foundation/fields';
3
- import { type Logger, createLogger } from '@aztec/foundation/log';
4
- import { ProtocolContractAddress, ProtocolContractsList } from '@aztec/protocol-contracts';
5
- import { computeFeePayerBalanceStorageSlot } from '@aztec/protocol-contracts/fee-juice';
6
- import { AvmExecutionHints, AvmTxHint, PublicSimulatorConfig, PublicTxResult } from '@aztec/stdlib/avm';
7
- import { SimulationError } from '@aztec/stdlib/errors';
8
- import { Gas } from '@aztec/stdlib/gas';
9
- import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
1
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
2
+ import { sleep } from '@aztec/foundation/sleep';
10
3
  import {
11
- type GlobalVariables,
12
- NestedProcessReturnValues,
13
- PublicCallRequestWithCalldata,
14
- Tx,
15
- TxExecutionPhase,
16
- } from '@aztec/stdlib/tx';
17
-
18
- import { strict as assert } from 'assert';
19
-
20
- import type { AvmFinalizedCallResult } from '../avm/avm_contract_call_result.js';
21
- import { AvmSimulator } from '../avm/index.js';
22
- import { getPublicFunctionDebugName } from '../debug_fn_name.js';
23
- import { HintingMerkleWriteOperations, HintingPublicContractsDB } from '../hinting_db_sources.js';
24
- import { type PublicContractsDB, PublicTreesDB } from '../public_db_sources.js';
25
- import {
26
- L2ToL1MessageLimitReachedError,
27
- NoteHashLimitReachedError,
28
- NullifierCollisionError,
29
- NullifierLimitReachedError,
30
- } from '../side_effect_errors.js';
31
- import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
32
- import { PublicTxContext } from './public_tx_context.js';
33
- import type { PublicTxSimulatorInterface } from './public_tx_simulator_interface.js';
34
-
35
- // The errors below are only thrown here in the public tx simulator,
36
- // and only during revertible phases (revertible insertions, app logic and teardown).
37
- // These are strictly "checked" errors (not exported and never propagated).
38
- // They are used internally for control flow to trigger rollbacks to the post-setup state.
39
-
40
- /**
41
- * Error thrown when public tx simulation reverts in a known/checked way during revertible insertions.
42
- */
43
- class TxSimRevertibleInsertionsRevert extends Error {
44
- constructor() {
45
- super('Public Tx Simulation reverted during Revertible Insertions');
46
- this.name = 'TxSimRevertibleInsertionsRevert';
47
- }
48
- }
4
+ AvmFastSimulationInputs,
5
+ AvmTxHint,
6
+ type PublicSimulatorConfig,
7
+ PublicTxResult,
8
+ deserializeFromMessagePack,
9
+ } from '@aztec/stdlib/avm';
10
+ import { SimulationError } from '@aztec/stdlib/errors';
11
+ import type { GlobalVariables, Tx } from '@aztec/stdlib/tx';
12
+ import { WorldStateRevision } from '@aztec/stdlib/world-state';
13
+ import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
14
+
15
+ import type { AvmContractsDBContext, AvmSimulator } from '../avm_simulator.js';
16
+ import { ExecutorMetrics } from '../executor_metrics.js';
17
+ import type { ExecutorMetricsInterface } from '../executor_metrics_interface.js';
18
+ import type { PublicContractsDB } from '../public_db_sources.js';
19
+ import { PublicTxSimulatorBase } from './public_tx_simulator_base.js';
20
+ import type {
21
+ MeasuredPublicTxSimulatorInterface,
22
+ PublicTxSimulatorInterface,
23
+ } from './public_tx_simulator_interface.js';
49
24
 
50
25
  /**
51
- * Error thrown when public tx simulation reverts during app logic.
26
+ * Simulates a transaction's public portion by running its public calls through an {@link AvmSimulator}.
27
+ * `forkId` selects the fork whose contract data the simulation reads.
52
28
  */
53
- class TxSimAppLogicRevert extends Error {
54
- constructor() {
55
- super('Public Tx Simulation reverted during App Logic');
56
- this.name = 'TxSimAppLogicRevert';
57
- }
58
- }
59
-
60
- /**
61
- * Error thrown when public tx simulation reverts during teardown.
62
- */
63
- class TxSimTeardownRevert extends Error {
64
- constructor() {
65
- super('Public Tx Simulation reverted during Teardown');
66
- this.name = 'TxSimTeardownRevert';
67
- }
68
- }
69
-
70
- /** Only used internally. */
71
- type ProcessedPhase = {
72
- phase: TxExecutionPhase;
73
- durationMs?: number;
74
- returnValues: NestedProcessReturnValues[];
75
- reverted: boolean;
76
- revertReason?: SimulationError;
77
- };
78
-
79
- export class PublicTxSimulator implements PublicTxSimulatorInterface {
80
- protected log: Logger;
81
- protected readonly config: PublicSimulatorConfig;
29
+ export class PublicTxSimulator extends PublicTxSimulatorBase implements PublicTxSimulatorInterface {
30
+ protected override log: Logger;
31
+ /** Aborts the in-flight simulation. */
32
+ private abortController?: AbortController;
33
+ /** Current simulation promise, used to wait for completion after cancellation. */
34
+ private simulationPromise?: Promise<PublicTxResult>;
82
35
 
83
36
  constructor(
84
- protected merkleTree: MerkleTreeWriteOperations,
85
- protected contractsDB: PublicContractsDB,
86
- protected globalVariables: GlobalVariables,
37
+ avmSimulator: AvmSimulator,
38
+ globalVariables: GlobalVariables,
39
+ contractsDB: PublicContractsDB,
40
+ forkId: number,
87
41
  config?: Partial<PublicSimulatorConfig>,
42
+ bindings?: LoggerBindings,
88
43
  ) {
89
- this.config = PublicSimulatorConfig.from(config ?? {});
90
- this.log = createLogger(`simulator:public_tx_simulator`);
44
+ super(avmSimulator, globalVariables, contractsDB, forkId, config, undefined, bindings);
45
+ this.log = createLogger(`simulator:public_tx_simulator`, bindings);
91
46
  }
92
47
 
93
48
  /**
94
- * Simulate a transaction's public portion including all of its phases.
49
+ * Simulate a transaction's public portion.
50
+ *
95
51
  * @param tx - The transaction to simulate.
96
52
  * @returns The result of the transaction's public execution.
97
53
  */
98
54
  public async simulate(tx: Tx): Promise<PublicTxResult> {
99
- const txHash = this.computeTxHash(tx);
100
- this.log.debug(`Simulating ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, { txHash });
55
+ this.abortController = new AbortController();
56
+ this.simulationPromise = this.doSimulate(tx, this.abortController.signal);
57
+ try {
58
+ return await this.simulationPromise;
59
+ } finally {
60
+ this.abortController = undefined;
61
+ this.simulationPromise = undefined;
62
+ }
63
+ }
101
64
 
102
- // Create hinting DBs.
103
- const hints = new AvmExecutionHints(
104
- this.globalVariables,
105
- AvmTxHint.fromTx(tx, this.globalVariables.gasFees),
106
- ProtocolContractsList, // imported from file
65
+ protected async doSimulate(tx: Tx, signal: AbortSignal): Promise<PublicTxResult> {
66
+ const txHash = this.computeTxHash(tx);
67
+ this.log.debug(
68
+ `Simulating ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}, forkId=${this.forkId}`,
69
+ { txHash },
107
70
  );
108
- const hintingMerkleTree = await HintingMerkleWriteOperations.create(this.merkleTree, hints);
109
- const hintingTreesDB = new PublicTreesDB(hintingMerkleTree);
110
- const hintingContractsDB = new HintingPublicContractsDB(this.contractsDB, hints);
111
71
 
112
- const context = await PublicTxContext.create(
113
- hintingTreesDB,
114
- hintingContractsDB,
115
- tx,
72
+ // Create the fast simulation inputs.
73
+ const txHint = AvmTxHint.fromTx(tx, this.globalVariables.gasFees);
74
+ const fastSimInputs = new AvmFastSimulationInputs(
75
+ // blockNumber: WorldStateRevision.LATEST sentinel so the WSDB walks the fork's current
76
+ // uncommitted state. Using 0 here makes WSDB treat this as a historical query against
77
+ // the empty genesis tree and miss any in-fork uncommitted leaves (deployed contracts,
78
+ // etc.) from earlier txs in the same block.
79
+ { forkId: this.forkId, blockNumber: WorldStateRevision.LATEST, includeUncommitted: true },
80
+ this.config,
81
+ txHint,
116
82
  this.globalVariables,
117
- ProtocolContractsList, // imported from file
118
- this.config.proverId,
83
+ this.protocolContracts,
119
84
  );
120
85
 
121
- // This will throw if there is a nullifier collision.
122
- // In that case the transaction will be thrown out.
123
- await this.insertNonRevertiblesFromPrivate(context);
124
-
125
- const processedPhases: ProcessedPhase[] = [];
126
- if (context.hasPhase(TxExecutionPhase.SETUP)) {
127
- // This will throw if the setup phase reverts.
128
- // In that case the transaction will be thrown out.
129
- const setupResult = await this.simulatePhase(TxExecutionPhase.SETUP, context);
130
- if (setupResult.reverted) {
131
- throw new Error(
132
- `[SETUP] UNRECOVERABLE ERROR! The transaction will be thrown out. ${setupResult.revertReason?.message}`,
133
- );
134
- }
135
- processedPhases.push(setupResult);
136
- }
137
-
138
- // The checkpoint we should go back to if anything from now on reverts.
139
- await context.state.fork();
140
- hintingContractsDB.createCheckpoint();
141
-
142
- try {
143
- // This will throw if there is a nullifier collision or other insertion error (limit reached).
144
- await this.insertRevertiblesFromPrivate(context);
145
-
146
- // Only proceed with app logic if there was no revert during revertible insertion.
147
- if (context.hasPhase(TxExecutionPhase.APP_LOGIC)) {
148
- const appLogicResult = await this.simulatePhase(TxExecutionPhase.APP_LOGIC, context);
149
- processedPhases.push(appLogicResult);
150
- if (appLogicResult.reverted) {
151
- throw new TxSimAppLogicRevert();
152
- }
153
- }
154
- } catch (e: any) {
155
- if (e instanceof TxSimRevertibleInsertionsRevert || e instanceof TxSimAppLogicRevert) {
156
- // We revert to the post-setup state.
157
- await context.state.discardForkedState();
158
- hintingContractsDB.revertCheckpoint();
159
- // But we also create a new fork so that the teardown phase can transparently
160
- // commit or rollback at the end of teardown.
161
- await context.state.fork();
162
- hintingContractsDB.createCheckpoint();
163
- } else {
164
- // Unchecked/unknown error - re-throw as-is
165
- throw e;
166
- }
167
- }
86
+ this.log.trace(`Serializing fast simulation inputs to msgpack...`);
87
+ const inputBuffer = fastSimInputs.serializeWithMessagePack();
168
88
 
89
+ this.log.debug(`Running AVM simulation for tx ${txHash}`);
90
+ const context: AvmContractsDBContext = {
91
+ contractsDB: this.contractsDB,
92
+ forkId: this.forkId,
93
+ timestamp: this.globalVariables.timestamp,
94
+ };
95
+ let resultBuffer: Uint8Array;
169
96
  try {
170
- if (context.hasPhase(TxExecutionPhase.TEARDOWN)) {
171
- const teardownResult = await this.simulatePhase(TxExecutionPhase.TEARDOWN, context);
172
- processedPhases.push(teardownResult);
173
- if (teardownResult.reverted) {
174
- throw new TxSimTeardownRevert();
175
- }
176
- }
177
- // We commit the forked state and we are done.
178
- await context.state.mergeForkedState();
179
- hintingContractsDB.commitCheckpoint();
180
- } catch (e: any) {
181
- if (e instanceof TxSimTeardownRevert) {
182
- // We revert to the post-setup state and we are done.
183
- await context.state.discardForkedState();
184
- hintingContractsDB.revertCheckpoint();
185
- } else {
186
- // Unchecked/unknown error - re-throw as-is
187
- throw e;
97
+ resultBuffer = await this.avmSimulator.simulate(inputBuffer, context, signal);
98
+ } catch (error: any) {
99
+ if (error.message?.includes('cancelled')) {
100
+ throw new SimulationError(`AVM simulation cancelled`, []);
188
101
  }
102
+ throw new SimulationError(`AVM simulation failed: ${error.message}`, []);
189
103
  }
190
104
 
191
- context.halt();
192
-
193
- // Such transactions should be filtered by GasTxValidator.
194
- assert(
195
- context.getActualGasUsed().l2Gas <= AVM_MAX_PROCESSABLE_L2_GAS,
196
- `Transaction consumes ${context.getActualGasUsed().l2Gas} L2 gas, which exceeds the AVM maximum processable gas of ${AVM_MAX_PROCESSABLE_L2_GAS}`,
197
- );
198
- await this.payFee(context);
199
-
200
- const publicInputs = await context.generateAvmCircuitPublicInputs();
201
- const revertCode = context.getFinalRevertCode();
202
-
203
- // We only return the app logic phase information, and only 1 per phase.
204
- const appLogicReturnValues: NestedProcessReturnValues[] =
205
- processedPhases.find(({ phase }) => phase === TxExecutionPhase.APP_LOGIC)?.returnValues ?? [];
206
-
207
- // TODO(fcarreiro): This is a temporary backwards compatibility layer until we migrate to the C++ simulator.
208
- if (context.revertReason !== undefined) {
209
- (appLogicReturnValues as any).revertReason = context.revertReason;
210
- }
211
-
212
- return new PublicTxResult(
213
- /*gasUsed=*/ {
214
- totalGas: context.getActualGasUsed(),
215
- teardownGas: context.teardownGasUsed,
216
- publicGas: context.getActualPublicGasUsed(),
217
- billedGas: context.getTotalGasUsed(),
218
- },
219
- /*revertCode=*/ revertCode,
220
- /*callStackMetadata=*/ appLogicReturnValues,
221
- /*logs=*/ context.state.getActiveStateManager().getLogs(),
222
- /*hints=*/ hints,
223
- /*publicInputs=*/ publicInputs,
224
- );
225
- }
226
-
227
- protected computeTxHash(tx: Tx) {
228
- return tx.getTxHash();
229
- }
230
-
231
- /**
232
- * Simulate the setup phase of a transaction's public execution.
233
- * @param context - WILL BE MUTATED. The context of the currently executing public transaction portion
234
- * @returns The phase result.
235
- */
236
- protected async simulatePhase(phase: TxExecutionPhase, context: PublicTxContext): Promise<ProcessedPhase> {
237
- const callRequests = context.getCallRequestsForPhase(phase);
105
+ this.log.trace(`Deserializing simulation result from buffer (size: ${resultBuffer.length})...`);
106
+ const resultJSON: object = deserializeFromMessagePack(Buffer.from(resultBuffer));
107
+ const result = PublicTxResult.fromPlainObject(resultJSON);
238
108
 
239
- this.log.debug(`Processing phase ${TxExecutionPhase[phase]} for tx ${context.txHash}`, {
240
- txHash: context.txHash.toString(),
241
- phase: TxExecutionPhase[phase],
242
- callRequests: callRequests.length,
109
+ this.log.trace(`AVM simulation completed for tx ${txHash}`, {
110
+ txHash,
111
+ reverted: !result.revertCode.isOK(),
112
+ l2GasUsed: result.gasUsed.totalGas.l2Gas,
243
113
  });
244
114
 
245
- const returnValues: NestedProcessReturnValues[] = [];
246
- let reverted = false;
247
- let revertReason: SimulationError | undefined;
248
- for (let i = 0; i < callRequests.length; i++) {
249
- if (reverted) {
250
- break;
251
- }
252
-
253
- const callRequest = callRequests[i];
254
-
255
- const enqueuedCallResult = await this.simulateEnqueuedCall(phase, context, callRequest);
256
-
257
- returnValues.push(new NestedProcessReturnValues(enqueuedCallResult.output));
258
-
259
- if (enqueuedCallResult.reverted) {
260
- reverted = true;
261
- revertReason = enqueuedCallResult.revertReason;
262
- }
263
- }
264
-
265
- return {
266
- phase,
267
- returnValues,
268
- reverted,
269
- revertReason,
270
- };
271
- }
272
-
273
- /**
274
- * Simulate an enqueued public call.
275
- * @param phase - The current phase of public execution
276
- * @param context - WILL BE MUTATED. The context of the currently executing public transaction portion
277
- * @param callRequest - The public function call request, including the calldata.
278
- * @returns The result of execution.
279
- */
280
- protected async simulateEnqueuedCall(
281
- phase: TxExecutionPhase,
282
- context: PublicTxContext,
283
- callRequest: PublicCallRequestWithCalldata,
284
- ): Promise<AvmFinalizedCallResult> {
285
- const stateManager = context.state.getActiveStateManager();
286
- const contractAddress = callRequest.request.contractAddress;
287
- const fnName = await getPublicFunctionDebugName(this.contractsDB, contractAddress, callRequest.calldata);
288
-
289
- const allocatedGas = context.getGasLeftAtPhase(phase);
290
-
291
- const result = await this.simulateEnqueuedCallInternal(
292
- stateManager,
293
- callRequest,
294
- allocatedGas,
295
- /*transactionFee=*/ context.getTransactionFee(phase),
296
- fnName,
297
- );
298
-
299
- const gasUsed = allocatedGas.sub(result.gasLeft); // by enqueued call
300
- context.consumeGas(phase, gasUsed);
301
- this.log.debug(
302
- `Simulated enqueued public call (${fnName}) consumed ${gasUsed.l2Gas} L2 gas ending with ${result.gasLeft.l2Gas} L2 gas left.`,
303
- );
304
-
305
- if (result.reverted) {
306
- const culprit = `${contractAddress}:${callRequest.functionSelector}`;
307
- context.revert(phase, result.revertReason, culprit);
308
- }
309
-
310
115
  return result;
311
116
  }
312
117
 
313
118
  /**
314
- * Simulate an enqueued public call, without modifying the context (PublicTxContext).
315
- * Resulting modifications to the context can be applied by the caller.
119
+ * Cancel the current simulation if one is in progress.
120
+ * This signals the underlying simulator to stop at the next safe point (between opcodes, before a
121
+ * world-state write). Safe to call even if no simulation is in progress.
316
122
  *
317
- * This function can be mocked for testing to skip actual AVM simulation
318
- * while still simulating phases and generating a proving request.
319
- *
320
- * @param stateManager - The state manager for AvmSimulation
321
- * @param callRequest - The public function call request, including the calldata.
322
- * @param allocatedGas - The gas allocated to the enqueued call
323
- * @param fnName - The name of the function
324
- * @returns The result of execution.
325
- */
326
- protected async simulateEnqueuedCallInternal(
327
- stateManager: PublicPersistableStateManager,
328
- { request, calldata }: PublicCallRequestWithCalldata,
329
- allocatedGas: Gas,
330
- transactionFee: Fr,
331
- fnName: string,
332
- ): Promise<AvmFinalizedCallResult> {
333
- const address = request.contractAddress;
334
- const sender = request.msgSender;
335
-
336
- this.log.debug(
337
- `Executing enqueued public call to external function ${fnName}@${address} with ${allocatedGas.l2Gas} allocated L2 gas.`,
338
- );
339
-
340
- const simulator = await AvmSimulator.create(
341
- stateManager,
342
- address,
343
- sender,
344
- transactionFee,
345
- this.globalVariables,
346
- request.isStaticCall,
347
- calldata,
348
- allocatedGas,
349
- this.config,
350
- );
351
- const avmCallResult = await simulator.execute();
352
- return avmCallResult.finalize();
353
- }
354
-
355
- /**
356
- * Insert the non-revertible accumulated data from private into the public state.
123
+ * @param waitTimeoutMs - If provided, wait up to this many ms for the simulation to actually stop.
124
+ * Cancellation is cooperative: the simulator may be mid slow-operation and
125
+ * won't observe the cancellation until it completes.
126
+ * Default timeout of 100ms after cancellation.
357
127
  */
358
- protected async insertNonRevertiblesFromPrivate(context: PublicTxContext) {
359
- const stateManager = context.state.getActiveStateManager();
360
-
361
- for (const siloedNullifier of context.nonRevertibleAccumulatedDataFromPrivate.nullifiers.filter(
362
- n => !n.isEmpty(),
363
- )) {
364
- await stateManager.writeSiloedNullifier(siloedNullifier);
365
- }
366
- for (const noteHash of context.nonRevertibleAccumulatedDataFromPrivate.noteHashes) {
367
- if (!noteHash.isEmpty()) {
368
- await stateManager.writeUniqueNoteHash(noteHash);
369
- }
370
- }
371
- for (const l2ToL1Message of context.nonRevertibleAccumulatedDataFromPrivate.l2ToL1Msgs) {
372
- if (!l2ToL1Message.isEmpty()) {
373
- stateManager.writeScopedL2ToL1Message(l2ToL1Message);
374
- }
128
+ public async cancel(waitTimeoutMs: number = 100): Promise<void> {
129
+ if (this.abortController) {
130
+ this.log.debug('Cancelling AVM simulation');
131
+ this.abortController.abort();
375
132
  }
376
133
 
377
- // add new contracts to the contracts db so that their code may be found and called
378
- // FIXME(fcarreiro): this should conceptually use the hinting contracts db.
379
- // However, things work as expected because later calls to getters on the hintingContractsDB
380
- // will pick up the new contracts and will generate the necessary hints.
381
- // So, a consumer of the hints will always see the new contracts.
382
- await this.contractsDB.addContracts(context.nonRevertibleContractDeploymentData);
383
- }
384
-
385
- /**
386
- * Insert the revertible accumulated data from private into the public state.
387
- * Throws TxSimRevertibleInsertionsRevert if there is some checked error during revertible insertions.
388
- * This function checks for the following errors:
389
- * - NullifierLimitReachedError
390
- * - NullifierCollisionError
391
- * - NoteHashLimitReachedError
392
- * - L2ToL1MessageLimitReachedError
393
- */
394
- protected async insertRevertiblesFromPrivate(context: PublicTxContext) {
395
- const stateManager = context.state.getActiveStateManager();
396
-
397
- try {
398
- for (const siloedNullifier of context.revertibleAccumulatedDataFromPrivate.nullifiers.filter(n => !n.isEmpty())) {
399
- await stateManager.writeSiloedNullifier(siloedNullifier);
400
- }
401
- } catch (e: any) {
402
- if (e instanceof NullifierLimitReachedError || e instanceof NullifierCollisionError) {
403
- context.revert(
404
- TxExecutionPhase.APP_LOGIC,
405
- new SimulationError(
406
- `Error encountered when inserting revertible nullifiers from private.\nDetails: ${e.message}`,
407
- [],
408
- ),
409
- );
410
- throw new TxSimRevertibleInsertionsRevert();
411
- } else {
412
- // Unchecked/unknown error - re-throw as-is
413
- throw e;
414
- }
134
+ if (this.simulationPromise) {
135
+ this.log.debug(`Waiting up to ${waitTimeoutMs}ms for AVM simulation to stop`);
136
+ await Promise.race([
137
+ this.simulationPromise.catch(() => {}), // Ignore rejection, just wait for completion
138
+ sleep(waitTimeoutMs),
139
+ ]);
140
+ this.log.debug('AVM simulation stopped or wait timed out');
415
141
  }
142
+ }
143
+ }
416
144
 
417
- try {
418
- for (const noteHash of context.revertibleAccumulatedDataFromPrivate.noteHashes) {
419
- if (!noteHash.isEmpty()) {
420
- // Revertible note hashes from private are not hashed with nonce, since private can't know their final position, only we can.
421
- await stateManager.writeSiloedNoteHash(noteHash);
422
- }
423
- }
424
- } catch (e: any) {
425
- if (e instanceof NoteHashLimitReachedError) {
426
- context.revert(
427
- TxExecutionPhase.APP_LOGIC,
428
- new SimulationError(
429
- `Error encountered when inserting revertible note hashes from private.\nDetails: ${e.message}`,
430
- [],
431
- ),
432
- );
433
- throw new TxSimRevertibleInsertionsRevert();
434
- } else {
435
- // Unchecked/unknown error - re-throw as-is
436
- throw e;
437
- }
438
- }
145
+ export class MeasuredPublicTxSimulator extends PublicTxSimulator implements MeasuredPublicTxSimulatorInterface {
146
+ constructor(
147
+ avmSimulator: AvmSimulator,
148
+ globalVariables: GlobalVariables,
149
+ contractsDB: PublicContractsDB,
150
+ forkId: number,
151
+ protected readonly metrics: ExecutorMetricsInterface,
152
+ config?: Partial<PublicSimulatorConfig>,
153
+ bindings?: LoggerBindings,
154
+ ) {
155
+ super(avmSimulator, globalVariables, contractsDB, forkId, config, bindings);
156
+ }
439
157
 
158
+ public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
159
+ this.metrics.startRecordingTxSimulation(txLabel);
160
+ let result: PublicTxResult | undefined;
440
161
  try {
441
- for (const l2ToL1Message of context.revertibleAccumulatedDataFromPrivate.l2ToL1Msgs) {
442
- if (!l2ToL1Message.isEmpty()) {
443
- stateManager.writeScopedL2ToL1Message(l2ToL1Message);
444
- }
445
- }
446
- } catch (e: any) {
447
- if (e instanceof L2ToL1MessageLimitReachedError) {
448
- context.revert(
449
- TxExecutionPhase.APP_LOGIC,
450
- new SimulationError(
451
- `Error encountered when inserting revertible L2-to-L1 messages from private.\nDetails: ${e.message}`,
452
- [],
453
- ),
454
- );
455
- throw new TxSimRevertibleInsertionsRevert();
456
- } else {
457
- // Unchecked/unknown error - re-throw as-is
458
- throw e;
459
- }
162
+ result = await super.simulate(tx);
163
+ } finally {
164
+ this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
460
165
  }
461
-
462
- // add new contracts to the contracts db so that their functions may be found and called
463
- // FIXME(fcarreiro): this should conceptually use the hinting contracts db.
464
- // However, things work as expected because later calls to getters on the hintingContractsDB
465
- // will pick up the new contracts and will generate the necessary hints.
466
- // So, a consumer of the hints will always see the new contracts.
467
- await this.contractsDB.addContracts(context.revertibleContractDeploymentData);
166
+ return result;
468
167
  }
168
+ }
469
169
 
470
- private async payFee(context: PublicTxContext) {
471
- const txFee = context.getTransactionFee(TxExecutionPhase.TEARDOWN);
472
-
473
- if (context.feePayer.isZero()) {
474
- // Real transactions are enforced by private kernel to have nonzero fee payer.
475
- // Real transactions cannot skip fee enforcement (skipping fee enforcement makes them unprovable).
476
- assert(this.config.skipFeeEnforcement, 'Fee payer cannot be 0 unless skipping fee enforcement for simulation');
477
- this.log.debug(`Fee payer is 0. Skipping fee enforcement. No one is paying the fee of ${txFee.toBigInt()}`);
478
- return;
479
- }
480
-
481
- const feeJuiceAddress = ProtocolContractAddress.FeeJuice;
482
- const balanceSlot = await computeFeePayerBalanceStorageSlot(context.feePayer);
483
-
484
- this.log.debug(`Deducting ${txFee.toBigInt()} balance in Fee Juice for ${context.feePayer}`);
485
- const stateManager = context.state.getActiveStateManager();
486
-
487
- let currentBalance = await stateManager.readStorage(feeJuiceAddress, balanceSlot);
488
- // We allow to fake the balance of the fee payer to allow fee estimation
489
- // When mocking the balance of the fee payer, the circuit should not be able to prove the simulation
490
-
491
- if (currentBalance.lt(txFee)) {
492
- // Without "skipFeeEnforcement", such transactions should be filtered by GasTxValidator.
493
- assert(
494
- this.config.skipFeeEnforcement,
495
- `Not enough balance for fee payer to pay for transaction (got ${currentBalance.toBigInt()} needs ${txFee.toBigInt()})`,
496
- );
497
- this.log.debug(`Fee payer balance insufficient, but we're skipping fee enforcement`);
498
- // We still proceed and perform the storage write to minimize deviation from normal execution.
499
- currentBalance = txFee;
500
- }
170
+ /**
171
+ * A public tx simulator that tracks runtime/production metrics with telemetry.
172
+ */
173
+ export class TelemetryPublicTxSimulator extends MeasuredPublicTxSimulator {
174
+ /* tracer needed by trackSpans */
175
+ public readonly tracer: Tracer;
501
176
 
502
- const updatedBalance = currentBalance.sub(txFee);
503
- await stateManager.writeStorage(feeJuiceAddress, balanceSlot, updatedBalance, true);
177
+ constructor(
178
+ avmSimulator: AvmSimulator,
179
+ globalVariables: GlobalVariables,
180
+ contractsDB: PublicContractsDB,
181
+ forkId: number,
182
+ telemetryClient: TelemetryClient = getTelemetryClient(),
183
+ config?: Partial<PublicSimulatorConfig>,
184
+ bindings?: LoggerBindings,
185
+ ) {
186
+ const metrics = new ExecutorMetrics(telemetryClient, 'PublicTxSimulator');
187
+ super(avmSimulator, globalVariables, contractsDB, forkId, metrics, config, bindings);
188
+ this.tracer = metrics.tracer;
504
189
  }
505
190
  }