@aztec/simulator 0.0.1-commit.3100065 → 0.0.1-commit.321f6a9

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