@aztec/simulator 0.0.0-test.1 → 0.0.1-commit.5476d83

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 (492) hide show
  1. package/README.md +6 -0
  2. package/dest/client.d.ts +6 -4
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +4 -2
  5. package/dest/common/errors.d.ts +5 -14
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/common/errors.js +51 -32
  8. package/dest/common/index.d.ts +1 -2
  9. package/dest/common/index.d.ts.map +1 -1
  10. package/dest/common/index.js +0 -1
  11. package/dest/common/stats/index.d.ts +1 -1
  12. package/dest/common/stats/stats.d.ts +1 -1
  13. package/dest/private/acvm/acvm.d.ts +12 -6
  14. package/dest/private/acvm/acvm.d.ts.map +1 -1
  15. package/dest/private/acvm/acvm.js +10 -16
  16. package/dest/private/acvm/acvm_types.d.ts +2 -2
  17. package/dest/private/acvm/acvm_types.d.ts.map +1 -1
  18. package/dest/private/acvm/deserialize.d.ts +18 -19
  19. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  20. package/dest/private/acvm/deserialize.js +31 -23
  21. package/dest/private/acvm/index.d.ts +1 -2
  22. package/dest/private/acvm/index.d.ts.map +1 -1
  23. package/dest/private/acvm/index.js +0 -1
  24. package/dest/private/acvm/serialize.d.ts +20 -3
  25. package/dest/private/acvm/serialize.d.ts.map +1 -1
  26. package/dest/private/acvm/serialize.js +53 -0
  27. package/dest/private/acvm_native.d.ts +39 -0
  28. package/dest/private/acvm_native.d.ts.map +1 -0
  29. package/dest/private/{providers/acvm_native.js → acvm_native.js} +26 -20
  30. package/dest/private/acvm_wasm.d.ts +15 -0
  31. package/dest/private/acvm_wasm.d.ts.map +1 -0
  32. package/dest/private/{providers/acvm_wasm.js → acvm_wasm.js} +22 -19
  33. package/dest/private/acvm_wasm_with_blobs.d.ts +20 -0
  34. package/dest/private/acvm_wasm_with_blobs.d.ts.map +1 -0
  35. package/dest/private/acvm_wasm_with_blobs.js +35 -0
  36. package/dest/private/circuit_recording/circuit_recorder.d.ts +108 -0
  37. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -0
  38. package/dest/private/circuit_recording/circuit_recorder.js +209 -0
  39. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +31 -0
  40. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -0
  41. package/dest/private/circuit_recording/file_circuit_recorder.js +135 -0
  42. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +5 -0
  43. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -0
  44. package/dest/private/circuit_recording/memory_circuit_recorder.js +9 -0
  45. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +21 -0
  46. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -0
  47. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +44 -0
  48. package/dest/private/circuit_simulator.d.ts +35 -0
  49. package/dest/private/circuit_simulator.d.ts.map +1 -0
  50. package/dest/private/circuit_simulator.js +43 -0
  51. package/dest/private/factory.d.ts +12 -0
  52. package/dest/private/factory.d.ts.map +1 -0
  53. package/dest/private/{providers/factory.js → factory.js} +2 -2
  54. package/dest/public/avm/avm_context.d.ts +6 -6
  55. package/dest/public/avm/avm_context.d.ts.map +1 -1
  56. package/dest/public/avm/avm_contract_call_result.d.ts +5 -3
  57. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  58. package/dest/public/avm/avm_contract_call_result.js +11 -7
  59. package/dest/public/avm/avm_execution_environment.d.ts +4 -2
  60. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  61. package/dest/public/avm/avm_execution_environment.js +4 -2
  62. package/dest/public/avm/avm_gas.d.ts +5 -21
  63. package/dest/public/avm/avm_gas.d.ts.map +1 -1
  64. package/dest/public/avm/avm_gas.js +27 -35
  65. package/dest/public/avm/avm_machine_state.d.ts +3 -1
  66. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  67. package/dest/public/avm/avm_machine_state.js +2 -0
  68. package/dest/public/avm/avm_memory_types.d.ts +99 -88
  69. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  70. package/dest/public/avm/avm_memory_types.js +17 -6
  71. package/dest/public/avm/avm_simulator.d.ts +6 -6
  72. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  73. package/dest/public/avm/avm_simulator.js +23 -35
  74. package/dest/public/avm/avm_simulator_interface.d.ts +9 -0
  75. package/dest/public/avm/avm_simulator_interface.d.ts.map +1 -0
  76. package/dest/public/avm/avm_simulator_interface.js +3 -0
  77. package/dest/public/avm/errors.d.ts +7 -31
  78. package/dest/public/avm/errors.d.ts.map +1 -1
  79. package/dest/public/avm/errors.js +7 -57
  80. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +6 -5
  81. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  82. package/dest/public/avm/fixtures/avm_simulation_tester.js +22 -15
  83. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts +7 -5
  84. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +1 -1
  85. package/dest/public/avm/fixtures/base_avm_simulation_tester.js +37 -14
  86. package/dest/public/avm/fixtures/initializers.d.ts +42 -0
  87. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -0
  88. package/dest/public/avm/fixtures/initializers.js +44 -0
  89. package/dest/public/avm/fixtures/utils.d.ts +38 -0
  90. package/dest/public/avm/fixtures/utils.d.ts.map +1 -0
  91. package/dest/public/avm/fixtures/utils.js +95 -0
  92. package/dest/public/avm/index.d.ts +1 -3
  93. package/dest/public/avm/index.d.ts.map +1 -1
  94. package/dest/public/avm/index.js +0 -2
  95. package/dest/public/avm/opcodes/accrued_substate.d.ts +3 -3
  96. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  97. package/dest/public/avm/opcodes/accrued_substate.js +28 -25
  98. package/dest/public/avm/opcodes/addressing_mode.d.ts +12 -8
  99. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +1 -1
  100. package/dest/public/avm/opcodes/addressing_mode.js +46 -26
  101. package/dest/public/avm/opcodes/arithmetic.d.ts +17 -7
  102. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  103. package/dest/public/avm/opcodes/arithmetic.js +16 -2
  104. package/dest/public/avm/opcodes/bitwise.d.ts +10 -18
  105. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  106. package/dest/public/avm/opcodes/bitwise.js +19 -26
  107. package/dest/public/avm/opcodes/comparators.d.ts +4 -4
  108. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  109. package/dest/public/avm/opcodes/comparators.js +3 -3
  110. package/dest/public/avm/opcodes/contract.d.ts +2 -3
  111. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  112. package/dest/public/avm/opcodes/contract.js +9 -10
  113. package/dest/public/avm/opcodes/control_flow.d.ts +1 -1
  114. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  115. package/dest/public/avm/opcodes/control_flow.js +10 -8
  116. package/dest/public/avm/opcodes/conversion.d.ts +2 -1
  117. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  118. package/dest/public/avm/opcodes/conversion.js +267 -3
  119. package/dest/public/avm/opcodes/ec_add.d.ts +2 -2
  120. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  121. package/dest/public/avm/opcodes/ec_add.js +6 -6
  122. package/dest/public/avm/opcodes/environment_getters.d.ts +3 -3
  123. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  124. package/dest/public/avm/opcodes/environment_getters.js +17 -19
  125. package/dest/public/avm/opcodes/external_calls.d.ts +9 -8
  126. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  127. package/dest/public/avm/opcodes/external_calls.js +39 -34
  128. package/dest/public/avm/opcodes/hashing.d.ts +2 -2
  129. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  130. package/dest/public/avm/opcodes/hashing.js +6 -6
  131. package/dest/public/avm/opcodes/index.d.ts +1 -1
  132. package/dest/public/avm/opcodes/instruction.d.ts +15 -11
  133. package/dest/public/avm/opcodes/instruction.d.ts.map +1 -1
  134. package/dest/public/avm/opcodes/instruction.js +23 -19
  135. package/dest/public/avm/opcodes/instruction_impl.d.ts +1 -1
  136. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +1 -1
  137. package/dest/public/avm/opcodes/memory.d.ts +6 -6
  138. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  139. package/dest/public/avm/opcodes/memory.js +37 -33
  140. package/dest/public/avm/opcodes/misc.d.ts +3 -2
  141. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  142. package/dest/public/avm/opcodes/misc.js +41 -16
  143. package/dest/public/avm/opcodes/storage.d.ts +3 -3
  144. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  145. package/dest/public/avm/opcodes/storage.js +7 -5
  146. package/dest/public/avm/revert_reason.d.ts +18 -0
  147. package/dest/public/avm/revert_reason.d.ts.map +1 -0
  148. package/dest/public/avm/revert_reason.js +38 -0
  149. package/dest/public/avm/serialization/buffer_cursor.d.ts +1 -3
  150. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +1 -1
  151. package/dest/public/avm/serialization/bytecode_serialization.d.ts +3 -7
  152. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +1 -1
  153. package/dest/public/avm/serialization/bytecode_serialization.js +70 -69
  154. package/dest/public/avm/serialization/instruction_serialization.d.ts +14 -5
  155. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  156. package/dest/public/avm/serialization/instruction_serialization.js +70 -35
  157. package/dest/public/avm/test_utils.d.ts +11 -14
  158. package/dest/public/avm/test_utils.d.ts.map +1 -1
  159. package/dest/public/avm/test_utils.js +16 -24
  160. package/dest/public/contracts_db_checkpoint.d.ts +16 -0
  161. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -0
  162. package/dest/public/contracts_db_checkpoint.js +30 -0
  163. package/dest/public/db_interfaces.d.ts +68 -0
  164. package/dest/public/db_interfaces.d.ts.map +1 -0
  165. package/dest/public/db_interfaces.js +3 -0
  166. package/dest/public/debug_fn_name.d.ts +5 -0
  167. package/dest/public/debug_fn_name.d.ts.map +1 -0
  168. package/dest/public/debug_fn_name.js +9 -0
  169. package/dest/public/executor_metrics.d.ts +12 -4
  170. package/dest/public/executor_metrics.d.ts.map +1 -1
  171. package/dest/public/executor_metrics.js +37 -6
  172. package/dest/public/executor_metrics_interface.d.ts +10 -0
  173. package/dest/public/executor_metrics_interface.d.ts.map +1 -0
  174. package/dest/public/executor_metrics_interface.js +1 -0
  175. package/dest/public/fixtures/amm_test.d.ts +10 -0
  176. package/dest/public/fixtures/amm_test.d.ts.map +1 -0
  177. package/dest/public/fixtures/amm_test.js +213 -0
  178. package/dest/public/fixtures/bulk_test.d.ts +6 -0
  179. package/dest/public/fixtures/bulk_test.d.ts.map +1 -0
  180. package/dest/public/fixtures/bulk_test.js +326 -0
  181. package/dest/public/fixtures/custom_bytecode_tester.d.ts +12 -0
  182. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -0
  183. package/dest/public/fixtures/custom_bytecode_tester.js +29 -0
  184. package/dest/public/fixtures/custom_bytecode_tests.d.ts +9 -0
  185. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -0
  186. package/dest/public/fixtures/custom_bytecode_tests.js +109 -0
  187. package/dest/public/fixtures/index.d.ts +8 -1
  188. package/dest/public/fixtures/index.d.ts.map +1 -1
  189. package/dest/public/fixtures/index.js +7 -0
  190. package/dest/public/fixtures/minimal_public_tx.d.ts +9 -0
  191. package/dest/public/fixtures/minimal_public_tx.d.ts.map +1 -0
  192. package/dest/public/fixtures/minimal_public_tx.js +29 -0
  193. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +35 -14
  194. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  195. package/dest/public/fixtures/public_tx_simulation_tester.js +100 -71
  196. package/dest/public/fixtures/simple_contract_data_source.d.ts +35 -0
  197. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -0
  198. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.js +31 -10
  199. package/dest/public/fixtures/token_test.d.ts +8 -0
  200. package/dest/public/fixtures/token_test.d.ts.map +1 -0
  201. package/dest/public/fixtures/token_test.js +94 -0
  202. package/dest/public/fixtures/utils.d.ts +17 -4
  203. package/dest/public/fixtures/utils.d.ts.map +1 -1
  204. package/dest/public/fixtures/utils.js +100 -58
  205. package/dest/public/hinting_db_sources.d.ts +78 -0
  206. package/dest/public/hinting_db_sources.d.ts.map +1 -0
  207. package/dest/public/hinting_db_sources.js +350 -0
  208. package/dest/public/index.d.ts +6 -9
  209. package/dest/public/index.d.ts.map +1 -1
  210. package/dest/public/index.js +4 -7
  211. package/dest/public/public_db_sources.d.ts +51 -101
  212. package/dest/public/public_db_sources.d.ts.map +1 -1
  213. package/dest/public/public_db_sources.js +219 -192
  214. package/dest/public/public_errors.d.ts +12 -0
  215. package/dest/public/public_errors.d.ts.map +1 -0
  216. package/dest/public/public_errors.js +13 -0
  217. package/dest/public/public_processor/guarded_merkle_tree.d.ts +49 -0
  218. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -0
  219. package/dest/public/public_processor/guarded_merkle_tree.js +108 -0
  220. package/dest/public/public_processor/public_processor.d.ts +25 -37
  221. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  222. package/dest/public/public_processor/public_processor.js +154 -111
  223. package/dest/public/public_processor/public_processor_metrics.d.ts +3 -3
  224. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  225. package/dest/public/public_processor/public_processor_metrics.js +1 -1
  226. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +30 -0
  227. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -0
  228. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +133 -0
  229. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +66 -0
  230. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -0
  231. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +210 -0
  232. package/dest/public/public_tx_simulator/index.d.ts +5 -0
  233. package/dest/public/public_tx_simulator/index.d.ts.map +1 -0
  234. package/dest/public/public_tx_simulator/index.js +2 -0
  235. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +31 -0
  236. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +1 -0
  237. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +51 -0
  238. package/dest/public/public_tx_simulator/public_tx_context.d.ts +23 -30
  239. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  240. package/dest/public/public_tx_simulator/public_tx_context.js +71 -91
  241. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +36 -58
  242. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  243. package/dest/public/public_tx_simulator/public_tx_simulator.js +208 -206
  244. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +9 -0
  245. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -0
  246. package/dest/public/public_tx_simulator/public_tx_simulator_interface.js +1 -0
  247. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +21 -0
  248. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +1 -0
  249. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +39 -0
  250. package/dest/public/side_effect_errors.d.ts +42 -2
  251. package/dest/public/side_effect_errors.d.ts.map +1 -1
  252. package/dest/public/side_effect_errors.js +70 -1
  253. package/dest/public/side_effect_trace.d.ts +21 -67
  254. package/dest/public/side_effect_trace.d.ts.map +1 -1
  255. package/dest/public/side_effect_trace.js +71 -121
  256. package/dest/public/side_effect_trace_interface.d.ts +12 -24
  257. package/dest/public/side_effect_trace_interface.d.ts.map +1 -1
  258. package/dest/public/state_manager/index.d.ts +2 -0
  259. package/dest/public/state_manager/index.d.ts.map +1 -0
  260. package/dest/public/state_manager/index.js +1 -0
  261. package/dest/public/{avm/journal → state_manager}/nullifiers.d.ts +3 -6
  262. package/dest/public/state_manager/nullifiers.d.ts.map +1 -0
  263. package/dest/public/{avm/journal → state_manager}/nullifiers.js +3 -8
  264. package/dest/public/{avm/journal → state_manager}/public_storage.d.ts +3 -3
  265. package/dest/public/state_manager/public_storage.d.ts.map +1 -0
  266. package/dest/public/state_manager/state_manager.d.ts +159 -0
  267. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  268. package/dest/public/state_manager/state_manager.js +392 -0
  269. package/dest/public/test_executor_metrics.d.ts +55 -0
  270. package/dest/public/test_executor_metrics.d.ts.map +1 -0
  271. package/dest/public/test_executor_metrics.js +307 -0
  272. package/dest/public/unique_class_ids.d.ts +1 -1
  273. package/dest/public/unique_class_ids.d.ts.map +1 -1
  274. package/dest/public/utils.d.ts +3 -5
  275. package/dest/public/utils.d.ts.map +1 -1
  276. package/dest/public/utils.js +4 -21
  277. package/dest/server.d.ts +7 -4
  278. package/dest/server.d.ts.map +1 -1
  279. package/dest/server.js +5 -2
  280. package/dest/testing.d.ts +2 -0
  281. package/dest/testing.d.ts.map +1 -0
  282. package/dest/testing.js +1 -0
  283. package/package.json +39 -33
  284. package/src/client.ts +5 -3
  285. package/src/common/errors.ts +79 -44
  286. package/src/common/index.ts +0 -1
  287. package/src/private/acvm/acvm.ts +17 -32
  288. package/src/private/acvm/acvm_types.ts +1 -1
  289. package/src/private/acvm/deserialize.ts +35 -29
  290. package/src/private/acvm/index.ts +0 -1
  291. package/src/private/acvm/serialize.ts +63 -0
  292. package/src/private/{providers/acvm_native.ts → acvm_native.ts} +47 -24
  293. package/src/private/acvm_wasm.ts +72 -0
  294. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  295. package/src/private/circuit_recording/circuit_recorder.ts +260 -0
  296. package/src/private/circuit_recording/file_circuit_recorder.ts +158 -0
  297. package/src/private/circuit_recording/memory_circuit_recorder.ts +11 -0
  298. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +91 -0
  299. package/src/private/circuit_simulator.ts +90 -0
  300. package/src/private/{providers/factory.ts → factory.ts} +6 -6
  301. package/src/public/avm/avm_context.ts +4 -4
  302. package/src/public/avm/avm_contract_call_result.ts +17 -5
  303. package/src/public/avm/avm_execution_environment.ts +8 -1
  304. package/src/public/avm/avm_gas.ts +23 -35
  305. package/src/public/avm/avm_machine_state.ts +5 -0
  306. package/src/public/avm/avm_memory_types.ts +19 -6
  307. package/src/public/avm/avm_simulator.ts +43 -54
  308. package/src/public/avm/avm_simulator_interface.ts +8 -0
  309. package/src/public/avm/errors.ts +8 -77
  310. package/src/public/avm/fixtures/avm_simulation_tester.ts +32 -21
  311. package/src/public/avm/fixtures/base_avm_simulation_tester.ts +45 -12
  312. package/src/public/avm/fixtures/initializers.ts +102 -0
  313. package/src/public/avm/fixtures/utils.ts +150 -0
  314. package/src/public/avm/index.ts +0 -2
  315. package/src/public/avm/opcodes/accrued_substate.ts +64 -29
  316. package/src/public/avm/opcodes/addressing_mode.ts +56 -32
  317. package/src/public/avm/opcodes/arithmetic.ts +24 -2
  318. package/src/public/avm/opcodes/bitwise.ts +33 -29
  319. package/src/public/avm/opcodes/comparators.ts +6 -3
  320. package/src/public/avm/opcodes/contract.ts +10 -7
  321. package/src/public/avm/opcodes/control_flow.ts +19 -10
  322. package/src/public/avm/opcodes/conversion.ts +27 -3
  323. package/src/public/avm/opcodes/ec_add.ts +9 -6
  324. package/src/public/avm/opcodes/environment_getters.ts +27 -22
  325. package/src/public/avm/opcodes/external_calls.ts +61 -29
  326. package/src/public/avm/opcodes/hashing.ts +28 -8
  327. package/src/public/avm/opcodes/instruction.ts +31 -21
  328. package/src/public/avm/opcodes/memory.ts +71 -32
  329. package/src/public/avm/opcodes/misc.ts +60 -18
  330. package/src/public/avm/opcodes/storage.ts +22 -6
  331. package/src/public/avm/revert_reason.ts +55 -0
  332. package/src/public/avm/serialization/buffer_cursor.ts +4 -1
  333. package/src/public/avm/serialization/bytecode_serialization.ts +72 -74
  334. package/src/public/avm/serialization/instruction_serialization.ts +75 -34
  335. package/src/public/avm/test_utils.ts +24 -41
  336. package/src/public/contracts_db_checkpoint.ts +41 -0
  337. package/src/public/db_interfaces.ts +76 -0
  338. package/src/{common → public}/debug_fn_name.ts +7 -7
  339. package/src/public/executor_metrics.ts +56 -6
  340. package/src/public/executor_metrics_interface.ts +15 -0
  341. package/src/public/fixtures/amm_test.ts +331 -0
  342. package/src/public/fixtures/bulk_test.ts +169 -0
  343. package/src/public/fixtures/custom_bytecode_tester.ts +49 -0
  344. package/src/public/fixtures/custom_bytecode_tests.ts +135 -0
  345. package/src/public/fixtures/index.ts +7 -0
  346. package/src/public/fixtures/minimal_public_tx.ts +35 -0
  347. package/src/public/fixtures/public_tx_simulation_tester.ts +166 -113
  348. package/src/public/{avm/fixtures → fixtures}/simple_contract_data_source.ts +36 -18
  349. package/src/public/fixtures/token_test.ts +139 -0
  350. package/src/public/fixtures/utils.ts +141 -68
  351. package/src/public/hinting_db_sources.ts +602 -0
  352. package/src/public/index.ts +5 -8
  353. package/src/public/public_db_sources.ts +278 -258
  354. package/src/public/public_errors.ts +14 -0
  355. package/src/public/public_processor/guarded_merkle_tree.ts +153 -0
  356. package/src/public/public_processor/public_processor.ts +212 -164
  357. package/src/public/public_processor/public_processor_metrics.ts +2 -2
  358. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +162 -0
  359. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +306 -0
  360. package/src/public/public_tx_simulator/index.ts +4 -0
  361. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +105 -0
  362. package/src/public/public_tx_simulator/public_tx_context.ts +167 -194
  363. package/src/public/public_tx_simulator/public_tx_simulator.ts +292 -265
  364. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +10 -0
  365. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +63 -0
  366. package/src/public/side_effect_errors.ts +91 -1
  367. package/src/public/side_effect_trace.ts +94 -320
  368. package/src/public/side_effect_trace_interface.ts +10 -58
  369. package/src/public/state_manager/index.ts +1 -0
  370. package/src/public/{avm/journal → state_manager}/nullifiers.ts +5 -11
  371. package/src/public/{avm/journal → state_manager}/public_storage.ts +2 -2
  372. package/src/public/state_manager/state_manager.ts +553 -0
  373. package/src/public/test_executor_metrics.ts +397 -0
  374. package/src/public/utils.ts +5 -21
  375. package/src/server.ts +6 -3
  376. package/src/testing.ts +1 -0
  377. package/dest/common/db_interfaces.d.ts +0 -80
  378. package/dest/common/db_interfaces.d.ts.map +0 -1
  379. package/dest/common/db_interfaces.js +0 -1
  380. package/dest/common/debug_fn_name.d.ts +0 -5
  381. package/dest/common/debug_fn_name.d.ts.map +0 -1
  382. package/dest/common/debug_fn_name.js +0 -6
  383. package/dest/common/message_load_oracle_inputs.d.ts +0 -15
  384. package/dest/common/message_load_oracle_inputs.d.ts.map +0 -1
  385. package/dest/common/message_load_oracle_inputs.js +0 -15
  386. package/dest/private/acvm/oracle/index.d.ts +0 -14
  387. package/dest/private/acvm/oracle/index.d.ts.map +0 -1
  388. package/dest/private/acvm/oracle/index.js +0 -2
  389. package/dest/private/acvm/oracle/oracle.d.ts +0 -49
  390. package/dest/private/acvm/oracle/oracle.d.ts.map +0 -1
  391. package/dest/private/acvm/oracle/oracle.js +0 -263
  392. package/dest/private/acvm/oracle/typed_oracle.d.ts +0 -83
  393. package/dest/private/acvm/oracle/typed_oracle.d.ts.map +0 -1
  394. package/dest/private/acvm/oracle/typed_oracle.js +0 -132
  395. package/dest/private/execution_data_provider.d.ts +0 -261
  396. package/dest/private/execution_data_provider.d.ts.map +0 -1
  397. package/dest/private/execution_data_provider.js +0 -14
  398. package/dest/private/execution_note_cache.d.ts +0 -93
  399. package/dest/private/execution_note_cache.d.ts.map +0 -1
  400. package/dest/private/execution_note_cache.js +0 -180
  401. package/dest/private/hashed_values_cache.d.ts +0 -28
  402. package/dest/private/hashed_values_cache.d.ts.map +0 -1
  403. package/dest/private/hashed_values_cache.js +0 -46
  404. package/dest/private/index.d.ts +0 -13
  405. package/dest/private/index.d.ts.map +0 -1
  406. package/dest/private/index.js +0 -12
  407. package/dest/private/pick_notes.d.ts +0 -85
  408. package/dest/private/pick_notes.d.ts.map +0 -1
  409. package/dest/private/pick_notes.js +0 -51
  410. package/dest/private/private_execution.d.ts +0 -25
  411. package/dest/private/private_execution.d.ts.map +0 -1
  412. package/dest/private/private_execution.js +0 -92
  413. package/dest/private/private_execution_oracle.d.ts +0 -215
  414. package/dest/private/private_execution_oracle.d.ts.map +0 -1
  415. package/dest/private/private_execution_oracle.js +0 -382
  416. package/dest/private/providers/acvm_native.d.ts +0 -40
  417. package/dest/private/providers/acvm_native.d.ts.map +0 -1
  418. package/dest/private/providers/acvm_wasm.d.ts +0 -15
  419. package/dest/private/providers/acvm_wasm.d.ts.map +0 -1
  420. package/dest/private/providers/acvm_wasm_with_blobs.d.ts +0 -19
  421. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  422. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  423. package/dest/private/providers/factory.d.ts +0 -12
  424. package/dest/private/providers/factory.d.ts.map +0 -1
  425. package/dest/private/providers/simulation_provider.d.ts +0 -19
  426. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  427. package/dest/private/providers/simulation_provider.js +0 -24
  428. package/dest/private/simulator.d.ts +0 -34
  429. package/dest/private/simulator.d.ts.map +0 -1
  430. package/dest/private/simulator.js +0 -76
  431. package/dest/private/unconstrained_execution.d.ts +0 -10
  432. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  433. package/dest/private/unconstrained_execution.js +0 -27
  434. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  435. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  436. package/dest/private/unconstrained_execution_oracle.js +0 -258
  437. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  438. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  439. package/dest/public/avm/bytecode_utils.js +0 -17
  440. package/dest/public/avm/fixtures/index.d.ts +0 -84
  441. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  442. package/dest/public/avm/fixtures/index.js +0 -175
  443. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts +0 -35
  444. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  445. package/dest/public/avm/journal/index.d.ts +0 -2
  446. package/dest/public/avm/journal/index.d.ts.map +0 -1
  447. package/dest/public/avm/journal/index.js +0 -1
  448. package/dest/public/avm/journal/journal.d.ts +0 -209
  449. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  450. package/dest/public/avm/journal/journal.js +0 -486
  451. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  452. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  453. package/dest/public/bytecode_errors.d.ts +0 -4
  454. package/dest/public/bytecode_errors.d.ts.map +0 -1
  455. package/dest/public/bytecode_errors.js +0 -6
  456. package/dest/public/execution.d.ts +0 -108
  457. package/dest/public/execution.d.ts.map +0 -1
  458. package/dest/public/execution.js +0 -9
  459. package/dest/public/tx_contract_cache.d.ts +0 -41
  460. package/dest/public/tx_contract_cache.d.ts.map +0 -1
  461. package/dest/public/tx_contract_cache.js +0 -49
  462. package/dest/test/utils.d.ts +0 -13
  463. package/dest/test/utils.d.ts.map +0 -1
  464. package/dest/test/utils.js +0 -22
  465. package/src/common/db_interfaces.ts +0 -94
  466. package/src/common/message_load_oracle_inputs.ts +0 -15
  467. package/src/private/acvm/oracle/index.ts +0 -16
  468. package/src/private/acvm/oracle/oracle.ts +0 -455
  469. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  470. package/src/private/execution_data_provider.ts +0 -323
  471. package/src/private/execution_note_cache.ts +0 -217
  472. package/src/private/hashed_values_cache.ts +0 -55
  473. package/src/private/index.ts +0 -16
  474. package/src/private/pick_notes.ts +0 -141
  475. package/src/private/private_execution.ts +0 -151
  476. package/src/private/private_execution_oracle.ts +0 -614
  477. package/src/private/providers/acvm_wasm.ts +0 -63
  478. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  479. package/src/private/providers/simulation_provider.ts +0 -45
  480. package/src/private/simulator.ts +0 -147
  481. package/src/private/unconstrained_execution.ts +0 -50
  482. package/src/private/unconstrained_execution_oracle.ts +0 -373
  483. package/src/public/avm/bytecode_utils.ts +0 -17
  484. package/src/public/avm/fixtures/index.ts +0 -296
  485. package/src/public/avm/journal/index.ts +0 -1
  486. package/src/public/avm/journal/journal.ts +0 -742
  487. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  488. package/src/public/bytecode_errors.ts +0 -6
  489. package/src/public/execution.ts +0 -140
  490. package/src/public/tx_contract_cache.ts +0 -69
  491. package/src/test/utils.ts +0 -36
  492. /package/dest/public/{avm/journal → state_manager}/public_storage.js +0 -0
@@ -0,0 +1,162 @@
1
+ import { Fr } from '@aztec/foundation/fields';
2
+ import { type Logger, createLogger } from '@aztec/foundation/log';
3
+ import type { ContractProvider } from '@aztec/native';
4
+ import { FunctionSelector } from '@aztec/stdlib/abi';
5
+ import { deserializeFromMessagePack, serializeWithMessagePack } from '@aztec/stdlib/avm';
6
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
7
+ import { ContractDeploymentData } from '@aztec/stdlib/contract';
8
+ import { ContractClassLog, ContractClassLogFields, PrivateLog } from '@aztec/stdlib/logs';
9
+ import type { GlobalVariables } from '@aztec/stdlib/tx';
10
+
11
+ import type { PublicContractsDB } from '../public_db_sources.js';
12
+
13
+ export class ContractProviderForCpp implements ContractProvider {
14
+ private log: Logger = createLogger('simulator:contract_provider_for_cpp');
15
+
16
+ constructor(
17
+ private contractsDB: PublicContractsDB,
18
+ private globalVariables: GlobalVariables,
19
+ ) {}
20
+
21
+ public getContractInstance = async (address: string): Promise<Buffer | undefined> => {
22
+ this.log.debug(`Contract provider callback: getContractInstance(${address})`);
23
+
24
+ const aztecAddr = AztecAddress.fromString(address);
25
+
26
+ const instance = await this.contractsDB.getContractInstance(aztecAddr, this.globalVariables.timestamp);
27
+
28
+ if (!instance) {
29
+ this.log.debug(`Contract instance not found: ${address}`);
30
+ return undefined;
31
+ }
32
+
33
+ return serializeWithMessagePack(instance);
34
+ };
35
+
36
+ public getContractClass = async (classId: string): Promise<Buffer | undefined> => {
37
+ this.log.debug(`Contract provider callback: getContractClass(${classId})`);
38
+
39
+ // Parse classId string to Fr
40
+ const classIdFr = Fr.fromString(classId);
41
+
42
+ // Fetch contract class from the contracts DB
43
+ const contractClass = await this.contractsDB.getContractClass(classIdFr);
44
+
45
+ if (!contractClass) {
46
+ this.log.debug(`Contract class not found: ${classId}`);
47
+ return undefined;
48
+ }
49
+
50
+ return serializeWithMessagePack(contractClass);
51
+ };
52
+
53
+ public addContracts = async (contractDeploymentDataBuffer: Buffer): Promise<void> => {
54
+ this.log.debug(`Contract provider callback: addContracts`);
55
+
56
+ const rawData: any = deserializeFromMessagePack(contractDeploymentDataBuffer);
57
+
58
+ // Construct class instances using the from method
59
+ const contractDeploymentData = this.reconstructContractDeploymentData(rawData);
60
+
61
+ // Add contracts to the contracts DB
62
+ this.log.debug(`Calling contractsDB.addContracts`);
63
+ await this.contractsDB.addContracts(contractDeploymentData);
64
+ };
65
+
66
+ public getBytecodeCommitment = async (classId: string): Promise<Buffer | undefined> => {
67
+ this.log.debug(`Contract provider callback: getBytecodeCommitment(${classId})`);
68
+
69
+ // Parse classId string to Fr
70
+ const classIdFr = Fr.fromString(classId);
71
+
72
+ // Fetch bytecode commitment from the contracts DB
73
+ const commitment = await this.contractsDB.getBytecodeCommitment(classIdFr);
74
+
75
+ if (!commitment) {
76
+ this.log.debug(`Bytecode commitment not found: ${classId}`);
77
+ return undefined;
78
+ }
79
+
80
+ // Serialize the Fr to buffer
81
+ return serializeWithMessagePack(commitment);
82
+ };
83
+
84
+ public getDebugFunctionName = async (address: string, selector: string): Promise<string | undefined> => {
85
+ this.log.debug(`Contract provider callback: getDebugFunctionName(${address}, ${selector})`);
86
+
87
+ // Parse address and selector strings
88
+ const aztecAddr = AztecAddress.fromString(address);
89
+ const selectorFr = Fr.fromString(selector);
90
+ const functionSelector = FunctionSelector.fromField(selectorFr);
91
+
92
+ // Fetch debug function name from the contracts DB
93
+ const name = await this.contractsDB.getDebugFunctionName(aztecAddr, functionSelector);
94
+
95
+ if (!name) {
96
+ this.log.debug(`Debug function name not found for ${address}:${selector}`);
97
+ return undefined;
98
+ }
99
+
100
+ return name;
101
+ };
102
+
103
+ public createCheckpoint = (): Promise<void> => {
104
+ this.log.debug(`Contract provider callback: createCheckpoint`);
105
+ return Promise.resolve(this.contractsDB.createCheckpoint());
106
+ };
107
+
108
+ public commitCheckpoint = (): Promise<void> => {
109
+ this.log.debug(`Contract provider callback: commitCheckpoint`);
110
+ return Promise.resolve(this.contractsDB.commitCheckpoint());
111
+ };
112
+
113
+ public revertCheckpoint = (): Promise<void> => {
114
+ this.log.debug(`Contract provider callback: revertCheckpoint`);
115
+ return Promise.resolve(this.contractsDB.revertCheckpoint());
116
+ };
117
+
118
+ /**
119
+ * Reconstruct ContractDeploymentData from plain msgpack-deserialized objects.
120
+ *
121
+ * msgpackr does not automatically apply extensions to nested fields, so we need to
122
+ * manually reconstruct ContractClassLog and PrivateLog instances with proper types.
123
+ *
124
+ * TODO(dbanks12): we really shouldn't have to do this.... We need to for now because
125
+ * msgpack deserialization doesn't give us actual typed objects, but rather just JSON.
126
+ * It would be easier if all types matched between languages (like AztecAddress which is just
127
+ * FF in C++).
128
+ */
129
+ private reconstructContractDeploymentData(rawData: any): ContractDeploymentData {
130
+ // Helper to ensure a value is an Fr instance
131
+ const toFr = (value: any): Fr => {
132
+ if (value instanceof Fr) {
133
+ return value;
134
+ }
135
+ if (Buffer.isBuffer(value)) {
136
+ return Fr.fromBuffer(value);
137
+ }
138
+ return new Fr(value);
139
+ };
140
+
141
+ // Reconstruct ContractClassLogs
142
+ const contractClassLogs = (rawData.contractClassLogs || []).map((log: any) => {
143
+ // Convert contractAddress to TS AztecAddress
144
+ const addressFr = toFr(log.contractAddress);
145
+ const address = AztecAddress.fromField(addressFr);
146
+
147
+ // Ensure all fields are Fr instances
148
+ const fields = (log.fields.fields || []).map((field: any) => toFr(field));
149
+
150
+ // Create proper ContractClassLog instance
151
+ return new ContractClassLog(address, new ContractClassLogFields(fields), log.emittedLength);
152
+ });
153
+
154
+ // Reconstruct PrivateLogs - ensure fields are Fr instances
155
+ const privateLogs = (rawData.privateLogs || []).map((log: any) => {
156
+ const fields = (log.fields || []).map((field: any) => toFr(field));
157
+ return new PrivateLog(fields as any, log.emittedLength);
158
+ });
159
+
160
+ return new ContractDeploymentData(contractClassLogs, privateLogs);
161
+ }
162
+ }
@@ -0,0 +1,306 @@
1
+ import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import { writeTestData } from '@aztec/foundation/testing/files';
3
+ import { avmSimulate, avmSimulateWithHintedDbs } from '@aztec/native';
4
+ import { ProtocolContractsList } from '@aztec/protocol-contracts';
5
+ import {
6
+ AvmCircuitInputs,
7
+ AvmFastSimulationInputs,
8
+ AvmTxHint,
9
+ type PublicSimulatorConfig,
10
+ PublicTxResult,
11
+ deserializeFromMessagePack,
12
+ } from '@aztec/stdlib/avm';
13
+ import { SimulationError } from '@aztec/stdlib/errors';
14
+ import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
15
+ import type { GlobalVariables, StateReference, Tx } from '@aztec/stdlib/tx';
16
+ import { WorldStateRevisionWithHandle } from '@aztec/stdlib/world-state';
17
+
18
+ import { strict as assert } from 'assert';
19
+
20
+ import type { ExecutorMetricsInterface } from '../executor_metrics_interface.js';
21
+ import type { PublicContractsDB } from '../public_db_sources.js';
22
+ import { ContractProviderForCpp } from './contract_provider_for_cpp.js';
23
+ import { PublicTxSimulator } from './public_tx_simulator.js';
24
+ import type {
25
+ MeasuredPublicTxSimulatorInterface,
26
+ PublicTxSimulatorInterface,
27
+ } from './public_tx_simulator_interface.js';
28
+
29
+ /**
30
+ * C++ implementation of PublicTxSimulator using the C++ simulator.
31
+ * The C++ simulator accesses the world state directly/natively within C++.
32
+ * For contract DB accesses, it makes callbacks through NAPI back to the TS PublicContractsDB cache.
33
+ *
34
+ * TODO(dbanks12): for now this still simulates first in TS to generate hints and public inputs,
35
+ * since the C++ simulator doesn't have hinting & PI generation logic yet.
36
+ */
37
+ export class CppPublicTxSimulator extends PublicTxSimulator implements PublicTxSimulatorInterface {
38
+ protected override log: Logger;
39
+
40
+ constructor(
41
+ merkleTree: MerkleTreeWriteOperations,
42
+ contractsDB: PublicContractsDB,
43
+ globalVariables: GlobalVariables,
44
+ config?: Partial<PublicSimulatorConfig>,
45
+ ) {
46
+ super(merkleTree, contractsDB, globalVariables, config);
47
+ this.log = createLogger(`simulator:cpp_public_tx_simulator`);
48
+ }
49
+
50
+ /**
51
+ * Simulate a transaction's public portion using the C++ avvm simulator.
52
+ *
53
+ * @param tx - The transaction to simulate.
54
+ * @returns The result of the transaction's public execution.
55
+ */
56
+ public override async simulate(tx: Tx): Promise<PublicTxResult> {
57
+ const txHash = this.computeTxHash(tx);
58
+ this.log.debug(`C++ simulation of ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, {
59
+ txHash,
60
+ });
61
+
62
+ // TODO(dbanks12): remove the first run with TS that hints!
63
+ // Run TS simulation to generate hints and public inputs
64
+ this.log.debug(`Running TS simulation for tx ${txHash}`);
65
+
66
+ // create checkpoint for ws
67
+ let tsResult: PublicTxResult | undefined;
68
+ let tsStateRef: StateReference | undefined;
69
+ await this.merkleTree.createCheckpoint();
70
+ this.contractsDB.createCheckpoint();
71
+ try {
72
+ // Run the full TypeScript simulation using the parent class
73
+ // This will modify the merkle tree with the transaction's state changes
74
+ tsResult = await super.simulate(tx);
75
+ this.log.debug(`TS simulation completed for tx ${txHash}`);
76
+
77
+ tsStateRef = await this.merkleTree.getStateReference(); // capture tree roots for later comparsion
78
+ } catch (error: any) {
79
+ this.log.warn(`TS simulation failed, but still continuing with C++ simulation: ${error.message} ${error.stack}`);
80
+ } finally {
81
+ // revert checkpoint for ws and clear contract db changes
82
+ // (cpp should reapply exactly the same changes if there are no bugs)
83
+ await this.merkleTree.revertCheckpoint();
84
+ this.contractsDB.revertCheckpoint();
85
+ }
86
+
87
+ this.log.debug(`Running C++ simulation for tx ${txHash}`);
88
+
89
+ // Using the "as WorldStateRevisionWithHandle" is a bit of a "trust me bro", hence the assert.
90
+ let wsRevision = this.merkleTree.getRevision();
91
+ assert(
92
+ wsRevision instanceof WorldStateRevisionWithHandle,
93
+ 'CppPublicTxSimulator a real NativeWorldStateInstance with a handle to the C++ WorldState object',
94
+ );
95
+ const wsCppHandle = (wsRevision as WorldStateRevisionWithHandle).handle;
96
+ wsRevision = wsRevision.toWorldStateRevision(); // for msgpack serialization, we don't include the handle in the type
97
+
98
+ this.log.debug(`Running C++ simulation with world state revision ${JSON.stringify(wsRevision)}`);
99
+
100
+ // Create the fast simulation inputs
101
+ const txHint = AvmTxHint.fromTx(tx, this.globalVariables.gasFees);
102
+ const protocolContracts = ProtocolContractsList;
103
+ const fastSimInputs = new AvmFastSimulationInputs(
104
+ wsRevision,
105
+ this.config,
106
+ txHint,
107
+ this.globalVariables,
108
+ protocolContracts,
109
+ );
110
+
111
+ // Create contract provider for callbacks to TypeScript PublicContractsDB from C++
112
+ const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables);
113
+
114
+ // Serialize to msgpack and call the C++ simulator
115
+ this.log.verbose(`Serializing fast simulation inputs to msgpack...`);
116
+ const inputBuffer = fastSimInputs.serializeWithMessagePack();
117
+
118
+ let resultBuffer: Buffer;
119
+ try {
120
+ this.log.verbose(`Calling C++ simulator for tx ${txHash}`);
121
+ resultBuffer = await avmSimulate(inputBuffer, contractProvider, wsCppHandle);
122
+ } catch (error: any) {
123
+ throw new SimulationError(`C++ simulation failed: ${error.message}`, []);
124
+ }
125
+
126
+ // If we've reached this point, C++ succeeded during simulation,
127
+ // so we assert that TS also succeeded.
128
+ assert(tsResult !== undefined, 'TS simulation should have succeeded if C++ succeeded');
129
+ assert(tsStateRef !== undefined, 'TS state reference should have been captured if C++ succeeded');
130
+
131
+ // Deserialize the msgpack result
132
+ this.log.verbose(`Deserializing C++ from buffer (size: ${resultBuffer.length})...`);
133
+ const cppResultJSON: object = deserializeFromMessagePack(resultBuffer);
134
+ // Write testdata if AZTEC_WRITE_TESTDATA=1.
135
+ writeTestData(
136
+ `barretenberg/cpp/src/barretenberg/vm2/testing/tx_result_${txHash}.testdata.bin`,
137
+ resultBuffer,
138
+ /*raw=*/ true,
139
+ );
140
+ this.log.verbose(`Deserializing C++ result to PublicTxResult...`);
141
+ const cppResult = PublicTxResult.fromPlainObject(cppResultJSON);
142
+ this.log.verbose(`Done.`);
143
+ // TODO(fcarreiro): complete this.
144
+ assert(cppResult.revertCode.equals(tsResult.revertCode));
145
+ assert(cppResult.gasUsed.totalGas.equals(tsResult.gasUsed.totalGas));
146
+ assert(cppResult.gasUsed.publicGas.equals(tsResult.gasUsed.publicGas));
147
+ assert(cppResult.gasUsed.teardownGas.equals(tsResult.gasUsed.teardownGas));
148
+ assert(cppResult.gasUsed.billedGas.equals(tsResult.gasUsed.billedGas));
149
+ assert(cppResult.publicInputs.toBuffer().equals(tsResult.publicInputs.toBuffer()));
150
+ if (this.config?.collectCallMetadata) {
151
+ assert(cppResult.appLogicReturnValues.length == tsResult.appLogicReturnValues.length);
152
+ assert(cppResult.appLogicReturnValues.every((v, i) => v.equals(tsResult.appLogicReturnValues[i])));
153
+ }
154
+
155
+ // Confirm that tree roots match
156
+ const cppStateRef = await this.merkleTree.getStateReference();
157
+ assert(
158
+ cppStateRef.equals(tsStateRef),
159
+ `Tree roots mismatch between TS and C++ public simulations for tx ${txHash}`,
160
+ );
161
+
162
+ this.log.debug(`C++ simulation completed for tx ${txHash}`, {
163
+ txHash,
164
+ reverted: !tsResult.revertCode.isOK(),
165
+ tsGasUsed: tsResult.gasUsed.totalGas.l2Gas,
166
+ cppGasUsed: tsResult.gasUsed.totalGas.l2Gas,
167
+ });
168
+
169
+ // TODO(dbanks12): C++ should return PublicTxResult (or something similar)
170
+ return tsResult;
171
+ }
172
+ }
173
+
174
+ export class MeasuredCppPublicTxSimulator extends CppPublicTxSimulator implements MeasuredPublicTxSimulatorInterface {
175
+ constructor(
176
+ merkleTree: MerkleTreeWriteOperations,
177
+ contractsDB: PublicContractsDB,
178
+ globalVariables: GlobalVariables,
179
+ protected readonly metrics: ExecutorMetricsInterface,
180
+ config?: Partial<PublicSimulatorConfig>,
181
+ ) {
182
+ super(merkleTree, contractsDB, globalVariables, config);
183
+ }
184
+
185
+ public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
186
+ this.metrics.startRecordingTxSimulation(txLabel);
187
+ let result: PublicTxResult | undefined;
188
+ try {
189
+ result = await super.simulate(tx);
190
+ } finally {
191
+ this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
192
+ }
193
+ return result;
194
+ }
195
+ }
196
+
197
+ /**
198
+ * C++ implementation of PublicTxSimulator using pre-collected hints.
199
+ * This implementation runs TS simulation first to collect all hints,
200
+ * then passes the complete AvmCircuitInputs (hints + public inputs)
201
+ * to C++ to run hinted simulation.
202
+ */
203
+ export class CppPublicTxSimulatorHintedDbs extends PublicTxSimulator implements PublicTxSimulatorInterface {
204
+ protected override log: Logger;
205
+
206
+ constructor(
207
+ merkleTree: MerkleTreeWriteOperations,
208
+ contractsDB: PublicContractsDB,
209
+ globalVariables: GlobalVariables,
210
+ config?: Partial<PublicSimulatorConfig>,
211
+ ) {
212
+ super(merkleTree, contractsDB, globalVariables, config);
213
+ this.log = createLogger(`simulator:cpp_public_tx_simulator_hinted_dbs`);
214
+ }
215
+
216
+ /**
217
+ * Simulate a transaction's public portion using the C++ vm2 simulator with hinted DBs.
218
+ *
219
+ * This implementation:
220
+ * 1. Runs the full TypeScript simulation to generate AvmCircuitInputs (hints + public inputs)
221
+ * 2. Passes the complete AvmCircuitInputs to C++ to run hinted simulation
222
+ *
223
+ * @param tx - The transaction to simulate.
224
+ * @returns The result of the transaction's public execution.
225
+ */
226
+ public override async simulate(tx: Tx): Promise<PublicTxResult> {
227
+ const txHash = this.computeTxHash(tx);
228
+ this.log.debug(`C++ hinted DB simulation of ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, {
229
+ txHash,
230
+ });
231
+
232
+ // First, run TS simulation to generate hints and public inputs
233
+ this.log.debug(`Running TS simulation for tx ${txHash}`);
234
+
235
+ // Run the full TypeScript simulation using the parent class
236
+ // This will modify the merkle tree with the transaction's state changes
237
+ const tsResult = await super.simulate(tx);
238
+ this.log.debug(`TS simulation succeeded for tx ${txHash}`);
239
+
240
+ // Extract the full AvmCircuitInputs from the TS result
241
+ const avmCircuitInputs = new AvmCircuitInputs(tsResult.hints!, tsResult.publicInputs);
242
+
243
+ // Second, run C++ simulation with hinted DBs
244
+ this.log.debug(`Running C++ simulation with hinted DBs for tx ${txHash}`);
245
+
246
+ // Serialize to msgpack and call the C++ simulator
247
+ const inputBuffer = avmCircuitInputs.serializeWithMessagePack();
248
+
249
+ let resultBuffer: Buffer;
250
+ try {
251
+ resultBuffer = await avmSimulateWithHintedDbs(inputBuffer);
252
+ } catch (error: any) {
253
+ throw new SimulationError(`C++ hinted simulation failed: ${error.message}`, []);
254
+ }
255
+
256
+ // Deserialize the msgpack result
257
+ const cppResultJSON: object = deserializeFromMessagePack(resultBuffer);
258
+ const cppResult = PublicTxResult.fromPlainObject(cppResultJSON);
259
+
260
+ assert(cppResult.revertCode.equals(tsResult.revertCode));
261
+ assert(cppResult.gasUsed.totalGas.equals(tsResult.gasUsed.totalGas));
262
+
263
+ this.log.debug(`C++ hinted simulation completed for tx ${txHash}`, {
264
+ txHash,
265
+ reverted: !tsResult.revertCode.isOK(),
266
+ tsGasUsed: tsResult.gasUsed.totalGas.l2Gas,
267
+ cppGasUsed: tsResult.gasUsed.totalGas.l2Gas,
268
+ });
269
+
270
+ // TODO(fcarreiro): complete this.
271
+ return tsResult;
272
+ }
273
+ }
274
+
275
+ /**
276
+ * Class to record metrics for simulation.
277
+ *
278
+ * Note(dbanks12): We might not be able to collect all the same metrics in C++ as we do in TS!
279
+ * Unless we move some of the metrics collection to C++, we don't have inner functions exposed
280
+ * to TS for tracking.
281
+ */
282
+ export class MeasuredCppPublicTxSimulatorHintedDbs
283
+ extends CppPublicTxSimulatorHintedDbs
284
+ implements MeasuredPublicTxSimulatorInterface
285
+ {
286
+ constructor(
287
+ merkleTree: MerkleTreeWriteOperations,
288
+ contractsDB: PublicContractsDB,
289
+ globalVariables: GlobalVariables,
290
+ protected readonly metrics: ExecutorMetricsInterface,
291
+ config?: Partial<PublicSimulatorConfig>,
292
+ ) {
293
+ super(merkleTree, contractsDB, globalVariables, config);
294
+ }
295
+
296
+ public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
297
+ this.metrics.startRecordingTxSimulation(txLabel);
298
+ let result: PublicTxResult | undefined;
299
+ try {
300
+ result = await super.simulate(tx);
301
+ } finally {
302
+ this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
303
+ }
304
+ return result;
305
+ }
306
+ }
@@ -0,0 +1,4 @@
1
+ export * from './public_tx_simulator.js';
2
+ export type { PublicTxSimulatorInterface } from './public_tx_simulator_interface.js';
3
+ export { TelemetryPublicTxSimulator } from './telemetry_public_tx_simulator.js';
4
+ export type { PublicTxResult, PublicSimulatorConfig as PublicTxSimulatorConfig } from '@aztec/stdlib/avm';
@@ -0,0 +1,105 @@
1
+ import type { Fr } from '@aztec/foundation/fields';
2
+ import { Timer } from '@aztec/foundation/timer';
3
+ import type { PublicSimulatorConfig, PublicTxResult } from '@aztec/stdlib/avm';
4
+ import type { Gas } from '@aztec/stdlib/gas';
5
+ import type { AvmSimulationStats } from '@aztec/stdlib/stats';
6
+ import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
7
+ import { type GlobalVariables, PublicCallRequestWithCalldata, Tx, TxExecutionPhase } from '@aztec/stdlib/tx';
8
+
9
+ import type { AvmFinalizedCallResult } from '../avm/avm_contract_call_result.js';
10
+ import type { ExecutorMetricsInterface } from '../executor_metrics_interface.js';
11
+ import type { PublicContractsDB } from '../public_db_sources.js';
12
+ import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
13
+ import { PublicTxContext } from './public_tx_context.js';
14
+ import { PublicTxSimulator } from './public_tx_simulator.js';
15
+ import type { MeasuredPublicTxSimulatorInterface } from './public_tx_simulator_interface.js';
16
+
17
+ /**
18
+ * A public tx simulator that tracks miscellaneous simulation metrics without telemetry.
19
+ */
20
+ export class MeasuredPublicTxSimulator extends PublicTxSimulator implements MeasuredPublicTxSimulatorInterface {
21
+ constructor(
22
+ merkleTree: MerkleTreeWriteOperations,
23
+ contractsDB: PublicContractsDB,
24
+ globalVariables: GlobalVariables,
25
+ protected readonly metrics: ExecutorMetricsInterface,
26
+ config?: Partial<PublicSimulatorConfig>,
27
+ ) {
28
+ super(merkleTree, contractsDB, globalVariables, config);
29
+ }
30
+
31
+ public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
32
+ this.metrics.startRecordingTxSimulation(txLabel);
33
+ let avmResult: PublicTxResult | undefined;
34
+ try {
35
+ avmResult = await super.simulate(tx);
36
+ } finally {
37
+ this.metrics.stopRecordingTxSimulation(txLabel, avmResult?.gasUsed, avmResult?.revertCode);
38
+ }
39
+ return avmResult;
40
+ }
41
+
42
+ protected override async insertNonRevertiblesFromPrivate(context: PublicTxContext) {
43
+ const timer = new Timer();
44
+ await super.insertNonRevertiblesFromPrivate(context);
45
+ this.metrics.recordPrivateEffectsInsertion(timer.us(), 'non-revertible');
46
+ }
47
+
48
+ protected override async insertRevertiblesFromPrivate(context: PublicTxContext) {
49
+ const timer = new Timer();
50
+ await super.insertRevertiblesFromPrivate(context);
51
+ this.metrics.recordPrivateEffectsInsertion(timer.us(), 'revertible');
52
+ }
53
+
54
+ protected override async simulatePhase(phase: TxExecutionPhase, context: PublicTxContext) {
55
+ const timer = new Timer();
56
+ const result = await super.simulatePhase(phase, context);
57
+ result.durationMs = timer.ms();
58
+ return result;
59
+ }
60
+
61
+ protected override async simulateEnqueuedCallInternal(
62
+ stateManager: PublicPersistableStateManager,
63
+ callRequest: PublicCallRequestWithCalldata,
64
+ allocatedGas: Gas,
65
+ transactionFee: Fr,
66
+ fnName: string,
67
+ ): Promise<AvmFinalizedCallResult> {
68
+ const timer = new Timer();
69
+ const result = await super.simulateEnqueuedCallInternal(
70
+ stateManager,
71
+ callRequest,
72
+ allocatedGas,
73
+ transactionFee,
74
+ fnName,
75
+ );
76
+
77
+ this.log.verbose(
78
+ result.reverted
79
+ ? `Simulation of enqueued public call ${fnName} reverted with reason ${result.revertReason?.message}.`
80
+ : `Simulation of enqueued public call ${fnName} completed successfully.`,
81
+ {
82
+ eventName: 'avm-simulation',
83
+ appCircuitName: fnName,
84
+ duration: timer.ms(),
85
+ } satisfies AvmSimulationStats,
86
+ );
87
+
88
+ if (result.reverted) {
89
+ this.metrics.recordEnqueuedCallSimulationFailure(
90
+ fnName,
91
+ timer.ms(),
92
+ allocatedGas.sub(result.gasLeft).l2Gas,
93
+ result.totalInstructions,
94
+ );
95
+ } else {
96
+ this.metrics.recordEnqueuedCallSimulation(
97
+ fnName,
98
+ timer.ms(),
99
+ allocatedGas.sub(result.gasLeft).l2Gas,
100
+ result.totalInstructions,
101
+ );
102
+ }
103
+ return result;
104
+ }
105
+ }