@aztec/simulator 0.0.1-commit.3100065 → 0.0.1-commit.330febf

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 (311) 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_ipc_server.d.ts +40 -0
  15. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  16. package/dest/public/cdb_ipc_server.js +153 -0
  17. package/dest/public/fixtures/index.d.ts +2 -4
  18. package/dest/public/fixtures/index.d.ts.map +1 -1
  19. package/dest/public/fixtures/index.js +1 -3
  20. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  21. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  22. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  23. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +11 -7
  24. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  25. package/dest/public/fixtures/public_tx_simulation_tester.js +29 -41
  26. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  27. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +11 -4
  28. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -1
  29. package/dest/public/fuzzing/avm_fuzzer_simulator.js +24 -10
  30. package/dest/public/fuzzing/avm_simulator_bin.js +4 -4
  31. package/dest/public/index.d.ts +5 -2
  32. package/dest/public/index.d.ts.map +1 -1
  33. package/dest/public/index.js +2 -1
  34. package/dest/public/public_db_sources.d.ts +2 -2
  35. package/dest/public/public_db_sources.d.ts.map +1 -1
  36. package/dest/public/public_db_sources.js +1 -1
  37. package/dest/public/public_processor/guarded_merkle_tree.d.ts +4 -3
  38. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  39. package/dest/public/public_processor/guarded_merkle_tree.js +3 -0
  40. package/dest/public/public_processor/public_processor.d.ts +8 -4
  41. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  42. package/dest/public/public_processor/public_processor.js +19 -34
  43. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  44. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  45. package/dest/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.js → dumping_public_tx_simulator.js} +10 -23
  46. package/dest/public/public_tx_simulator/factories.d.ts +8 -8
  47. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -1
  48. package/dest/public/public_tx_simulator/factories.js +8 -8
  49. package/dest/public/public_tx_simulator/index.d.ts +4 -6
  50. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  51. package/dest/public/public_tx_simulator/index.js +2 -4
  52. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +42 -75
  53. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  54. package/dest/public/public_tx_simulator/public_tx_simulator.js +98 -323
  55. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  56. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  57. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  58. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +5 -5
  59. package/dest/public/test_executor_metrics.d.ts +1 -6
  60. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  61. package/dest/public/test_executor_metrics.js +0 -22
  62. package/package.json +20 -18
  63. package/src/public/avm/{fixtures → testing}/utils.ts +0 -39
  64. package/src/public/avm_simulator.ts +29 -0
  65. package/src/public/avm_simulator_pool.ts +226 -0
  66. package/src/public/cdb_ipc_server.ts +198 -0
  67. package/src/public/fixtures/index.ts +1 -3
  68. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  69. package/src/public/fixtures/public_tx_simulation_tester.ts +37 -50
  70. package/src/public/fixtures/simple_contract_data_source.ts +1 -1
  71. package/src/public/fuzzing/avm_fuzzer_simulator.ts +25 -10
  72. package/src/public/fuzzing/avm_simulator_bin.ts +3 -5
  73. package/src/public/index.ts +7 -3
  74. package/src/public/public_db_sources.ts +1 -1
  75. package/src/public/public_processor/guarded_merkle_tree.ts +5 -2
  76. package/src/public/public_processor/public_processor.ts +25 -39
  77. package/src/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.ts → dumping_public_tx_simulator.ts} +15 -31
  78. package/src/public/public_tx_simulator/factories.ts +27 -10
  79. package/src/public/public_tx_simulator/index.ts +6 -5
  80. package/src/public/public_tx_simulator/public_tx_simulator.ts +139 -480
  81. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  82. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +5 -5
  83. package/src/public/test_executor_metrics.ts +0 -24
  84. package/dest/public/avm/avm_context.d.ts +0 -41
  85. package/dest/public/avm/avm_context.d.ts.map +0 -1
  86. package/dest/public/avm/avm_context.js +0 -44
  87. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  88. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  89. package/dest/public/avm/avm_contract_call_result.js +0 -54
  90. package/dest/public/avm/avm_execution_environment.d.ts +0 -24
  91. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  92. package/dest/public/avm/avm_execution_environment.js +0 -33
  93. package/dest/public/avm/avm_gas.d.ts +0 -44
  94. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  95. package/dest/public/avm/avm_gas.js +0 -195
  96. package/dest/public/avm/avm_machine_state.d.ts +0 -98
  97. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  98. package/dest/public/avm/avm_machine_state.js +0 -110
  99. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  100. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  101. package/dest/public/avm/avm_memory_types.js +0 -354
  102. package/dest/public/avm/avm_simulator.d.ts +0 -41
  103. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  104. package/dest/public/avm/avm_simulator.js +0 -192
  105. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  106. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  107. package/dest/public/avm/avm_simulator_interface.js +0 -3
  108. package/dest/public/avm/calldata.d.ts +0 -51
  109. package/dest/public/avm/calldata.d.ts.map +0 -1
  110. package/dest/public/avm/calldata.js +0 -64
  111. package/dest/public/avm/errors.d.ts +0 -104
  112. package/dest/public/avm/errors.d.ts.map +0 -1
  113. package/dest/public/avm/errors.js +0 -141
  114. package/dest/public/avm/fixtures/account_proof_fetcher.d.ts +0 -2
  115. package/dest/public/avm/fixtures/account_proof_fetcher.d.ts.map +0 -1
  116. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  117. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  118. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -84
  119. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  120. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  121. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  122. package/dest/public/avm/fixtures/initializers.js +0 -45
  123. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  124. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  125. package/dest/public/avm/index.d.ts +0 -2
  126. package/dest/public/avm/index.d.ts.map +0 -1
  127. package/dest/public/avm/index.js +0 -1
  128. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -74
  129. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  130. package/dest/public/avm/opcodes/accrued_substate.js +0 -254
  131. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  132. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  133. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  134. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -49
  135. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  136. package/dest/public/avm/opcodes/arithmetic.js +0 -97
  137. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  138. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  139. package/dest/public/avm/opcodes/bitwise.js +0 -99
  140. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  141. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  142. package/dest/public/avm/opcodes/comparators.js +0 -43
  143. package/dest/public/avm/opcodes/contract.d.ts +0 -21
  144. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  145. package/dest/public/avm/opcodes/contract.js +0 -69
  146. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  147. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  148. package/dest/public/avm/opcodes/control_flow.js +0 -107
  149. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  150. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  151. package/dest/public/avm/opcodes/conversion.js +0 -333
  152. package/dest/public/avm/opcodes/ec_add.d.ts +0 -17
  153. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  154. package/dest/public/avm/opcodes/ec_add.js +0 -79
  155. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  156. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  157. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  158. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  159. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  160. package/dest/public/avm/opcodes/external_calls.js +0 -210
  161. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  162. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  163. package/dest/public/avm/opcodes/hashing.js +0 -119
  164. package/dest/public/avm/opcodes/index.d.ts +0 -16
  165. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  166. package/dest/public/avm/opcodes/index.js +0 -15
  167. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  168. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  169. package/dest/public/avm/opcodes/instruction.js +0 -95
  170. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  171. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  172. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  173. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  174. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  175. package/dest/public/avm/opcodes/memory.js +0 -257
  176. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  177. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  178. package/dest/public/avm/opcodes/misc.js +0 -73
  179. package/dest/public/avm/opcodes/storage.d.ts +0 -25
  180. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  181. package/dest/public/avm/opcodes/storage.js +0 -78
  182. package/dest/public/avm/revert_reason.d.ts +0 -18
  183. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  184. package/dest/public/avm/revert_reason.js +0 -39
  185. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  186. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  187. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  188. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  189. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  190. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  191. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  192. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  193. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  194. package/dest/public/avm/test_utils.d.ts +0 -15
  195. package/dest/public/avm/test_utils.d.ts.map +0 -1
  196. package/dest/public/avm/test_utils.js +0 -44
  197. package/dest/public/debug_fn_name.d.ts +0 -18
  198. package/dest/public/debug_fn_name.d.ts.map +0 -1
  199. package/dest/public/debug_fn_name.js +0 -37
  200. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -19
  201. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  202. package/dest/public/fixtures/custom_bytecode_tests.js +0 -263
  203. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -4
  204. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  205. package/dest/public/fixtures/minimal_public_tx.js +0 -19
  206. package/dest/public/fixtures/opcode_spammer.d.ts +0 -122
  207. package/dest/public/fixtures/opcode_spammer.d.ts.map +0 -1
  208. package/dest/public/fixtures/opcode_spammer.js +0 -1645
  209. package/dest/public/hinting_db_sources.d.ts +0 -80
  210. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  211. package/dest/public/hinting_db_sources.js +0 -356
  212. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +0 -19
  213. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +0 -1
  214. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +0 -99
  215. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -53
  216. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  217. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -131
  218. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  219. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  220. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  221. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  222. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  223. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -171
  224. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +0 -23
  225. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +0 -1
  226. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  227. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  228. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  229. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -135
  230. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  231. package/dest/public/public_tx_simulator/public_tx_context.js +0 -298
  232. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  233. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  234. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -415
  235. package/dest/public/side_effect_trace.d.ts +0 -87
  236. package/dest/public/side_effect_trace.d.ts.map +0 -1
  237. package/dest/public/side_effect_trace.js +0 -199
  238. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  239. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  240. package/dest/public/side_effect_trace_interface.js +0 -1
  241. package/dest/public/state_manager/index.d.ts +0 -2
  242. package/dest/public/state_manager/index.d.ts.map +0 -1
  243. package/dest/public/state_manager/index.js +0 -1
  244. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  245. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  246. package/dest/public/state_manager/nullifiers.js +0 -92
  247. package/dest/public/state_manager/public_storage.d.ts +0 -66
  248. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  249. package/dest/public/state_manager/public_storage.js +0 -145
  250. package/dest/public/state_manager/state_manager.d.ts +0 -170
  251. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  252. package/dest/public/state_manager/state_manager.js +0 -402
  253. package/src/public/avm/avm_context.ts +0 -61
  254. package/src/public/avm/avm_contract_call_result.ts +0 -69
  255. package/src/public/avm/avm_execution_environment.ts +0 -51
  256. package/src/public/avm/avm_gas.ts +0 -183
  257. package/src/public/avm/avm_machine_state.ts +0 -170
  258. package/src/public/avm/avm_memory_types.ts +0 -440
  259. package/src/public/avm/avm_simulator.ts +0 -279
  260. package/src/public/avm/avm_simulator_interface.ts +0 -8
  261. package/src/public/avm/calldata.ts +0 -101
  262. package/src/public/avm/errors.ts +0 -177
  263. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -122
  264. package/src/public/avm/fixtures/initializers.ts +0 -103
  265. package/src/public/avm/index.ts +0 -1
  266. package/src/public/avm/opcodes/accrued_substate.ts +0 -285
  267. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  268. package/src/public/avm/opcodes/arithmetic.ts +0 -129
  269. package/src/public/avm/opcodes/bitwise.ts +0 -113
  270. package/src/public/avm/opcodes/comparators.ts +0 -55
  271. package/src/public/avm/opcodes/contract.ts +0 -76
  272. package/src/public/avm/opcodes/control_flow.ts +0 -123
  273. package/src/public/avm/opcodes/conversion.ts +0 -104
  274. package/src/public/avm/opcodes/ec_add.ts +0 -86
  275. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  276. package/src/public/avm/opcodes/external_calls.ts +0 -262
  277. package/src/public/avm/opcodes/hashing.ts +0 -151
  278. package/src/public/avm/opcodes/index.ts +0 -15
  279. package/src/public/avm/opcodes/instruction.ts +0 -136
  280. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  281. package/src/public/avm/opcodes/memory.ts +0 -293
  282. package/src/public/avm/opcodes/misc.ts +0 -102
  283. package/src/public/avm/opcodes/storage.ts +0 -95
  284. package/src/public/avm/revert_reason.ts +0 -58
  285. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  286. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  287. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  288. package/src/public/avm/test_utils.ts +0 -64
  289. package/src/public/debug_fn_name.ts +0 -52
  290. package/src/public/fixtures/custom_bytecode_tests.ts +0 -435
  291. package/src/public/fixtures/minimal_public_tx.ts +0 -26
  292. package/src/public/fixtures/opcode_spammer.ts +0 -1713
  293. package/src/public/hinting_db_sources.ts +0 -610
  294. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +0 -125
  295. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -210
  296. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -134
  297. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -239
  298. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  299. package/src/public/public_tx_simulator/public_tx_context.ts +0 -482
  300. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  301. package/src/public/side_effect_trace.ts +0 -293
  302. package/src/public/side_effect_trace_interface.ts +0 -28
  303. package/src/public/state_manager/index.ts +0 -1
  304. package/src/public/state_manager/nullifiers.ts +0 -103
  305. package/src/public/state_manager/public_storage.ts +0 -174
  306. package/src/public/state_manager/state_manager.ts +0 -569
  307. /package/dest/public/avm/{fixtures → testing}/account_proof_fetcher.js +0 -0
  308. /package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +0 -0
  309. /package/src/public/avm/{fixtures → testing}/account_proof.json +0 -0
  310. /package/src/public/avm/{fixtures → testing}/account_proof_fetcher.ts +0 -0
  311. /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
  }