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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (391) hide show
  1. package/README.md +6 -4
  2. package/dest/client.d.ts +1 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +0 -2
  5. package/dest/common/errors.d.ts +8 -2
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/private/acvm/acvm.d.ts +4 -2
  8. package/dest/private/acvm/acvm.d.ts.map +1 -1
  9. package/dest/private/acvm/acvm.js +4 -3
  10. package/dest/private/acvm/deserialize.d.ts +2 -2
  11. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  12. package/dest/private/acvm/deserialize.js +1 -1
  13. package/dest/private/acvm/serialize.d.ts +2 -2
  14. package/dest/private/acvm/serialize.d.ts.map +1 -1
  15. package/dest/private/acvm/serialize.js +1 -1
  16. package/dest/private/acvm_native.d.ts +5 -3
  17. package/dest/private/acvm_native.d.ts.map +1 -1
  18. package/dest/private/acvm_native.js +8 -6
  19. package/dest/private/acvm_wasm.d.ts +4 -3
  20. package/dest/private/acvm_wasm.d.ts.map +1 -1
  21. package/dest/private/acvm_wasm.js +7 -5
  22. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  23. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  24. package/dest/private/circuit_recording/circuit_recorder.js +71 -72
  25. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  26. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  27. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  28. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  29. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  30. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  31. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  32. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  33. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  34. package/dest/private/factory.d.ts +3 -3
  35. package/dest/private/factory.d.ts.map +1 -1
  36. package/dest/private/factory.js +7 -4
  37. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  38. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  39. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  40. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +3 -2
  41. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  42. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +19 -4
  43. package/dest/public/avm/testing/utils.d.ts +32 -0
  44. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  45. package/dest/public/avm/{fixtures → testing}/utils.js +5 -35
  46. package/dest/public/avm_simulator.d.ts +28 -0
  47. package/dest/public/avm_simulator.d.ts.map +1 -0
  48. package/dest/public/avm_simulator.js +4 -0
  49. package/dest/public/avm_simulator_pool.d.ts +45 -0
  50. package/dest/public/avm_simulator_pool.d.ts.map +1 -0
  51. package/dest/public/avm_simulator_pool.js +197 -0
  52. package/dest/public/cdb/generated/api_types.d.ts +171 -0
  53. package/dest/public/cdb/generated/api_types.d.ts.map +1 -0
  54. package/dest/public/cdb/generated/api_types.js +314 -0
  55. package/dest/public/cdb/generated/server.d.ts +26 -0
  56. package/dest/public/cdb/generated/server.d.ts.map +1 -0
  57. package/dest/public/cdb/generated/server.js +135 -0
  58. package/dest/public/cdb_ipc_server.d.ts +33 -0
  59. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  60. package/dest/public/cdb_ipc_server.js +153 -0
  61. package/dest/public/contracts_db_checkpoint.d.ts +3 -3
  62. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  63. package/dest/public/contracts_db_checkpoint.js +1 -1
  64. package/dest/public/db_interfaces.d.ts +2 -2
  65. package/dest/public/db_interfaces.d.ts.map +1 -1
  66. package/dest/public/executor_metrics.d.ts +1 -1
  67. package/dest/public/executor_metrics.d.ts.map +1 -1
  68. package/dest/public/executor_metrics.js +12 -33
  69. package/dest/public/fixtures/amm_test.js +6 -6
  70. package/dest/public/fixtures/bulk_test.d.ts +3 -3
  71. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  72. package/dest/public/fixtures/bulk_test.js +38 -75
  73. package/dest/public/fixtures/custom_bytecode_tester.d.ts +28 -6
  74. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  75. package/dest/public/fixtures/custom_bytecode_tester.js +36 -12
  76. package/dest/public/fixtures/index.d.ts +3 -3
  77. package/dest/public/fixtures/index.d.ts.map +1 -1
  78. package/dest/public/fixtures/index.js +2 -2
  79. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  80. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  81. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  82. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +24 -6
  83. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  84. package/dest/public/fixtures/public_tx_simulation_tester.js +66 -21
  85. package/dest/public/fixtures/simple_contract_data_source.d.ts +2 -2
  86. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -1
  87. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  88. package/dest/public/fixtures/token_test.js +4 -4
  89. package/dest/public/fixtures/utils.d.ts +3 -3
  90. package/dest/public/fixtures/utils.d.ts.map +1 -1
  91. package/dest/public/fixtures/utils.js +25 -23
  92. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +67 -0
  93. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -0
  94. package/dest/public/fuzzing/avm_fuzzer_simulator.js +185 -0
  95. package/dest/public/fuzzing/avm_simulator_bin.d.ts +2 -0
  96. package/dest/public/fuzzing/avm_simulator_bin.d.ts.map +1 -0
  97. package/dest/public/fuzzing/avm_simulator_bin.js +118 -0
  98. package/dest/public/index.d.ts +5 -2
  99. package/dest/public/index.d.ts.map +1 -1
  100. package/dest/public/index.js +2 -1
  101. package/dest/public/public_db_sources.d.ts +10 -6
  102. package/dest/public/public_db_sources.d.ts.map +1 -1
  103. package/dest/public/public_db_sources.js +21 -15
  104. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -6
  105. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  106. package/dest/public/public_processor/guarded_merkle_tree.js +12 -4
  107. package/dest/public/public_processor/public_processor.d.ts +17 -8
  108. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  109. package/dest/public/public_processor/public_processor.js +535 -100
  110. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  111. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  112. package/dest/public/public_processor/public_processor_metrics.js +36 -45
  113. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  114. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  115. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.js +39 -0
  116. package/dest/public/public_tx_simulator/factories.d.ts +14 -0
  117. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -0
  118. package/dest/public/public_tx_simulator/factories.js +28 -0
  119. package/dest/public/public_tx_simulator/index.d.ts +5 -5
  120. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  121. package/dest/public/public_tx_simulator/index.js +3 -3
  122. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +43 -70
  123. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  124. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -312
  125. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  126. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  127. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  128. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +24 -1
  129. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -1
  130. package/dest/public/test_executor_metrics.d.ts +3 -2
  131. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  132. package/dest/public/test_executor_metrics.js +2 -2
  133. package/package.json +23 -20
  134. package/src/client.ts +0 -2
  135. package/src/common/errors.ts +1 -1
  136. package/src/private/acvm/acvm.ts +4 -3
  137. package/src/private/acvm/deserialize.ts +1 -1
  138. package/src/private/acvm/serialize.ts +1 -1
  139. package/src/private/acvm_native.ts +11 -5
  140. package/src/private/acvm_wasm.ts +11 -4
  141. package/src/private/circuit_recording/circuit_recorder.ts +90 -81
  142. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  143. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  144. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  145. package/src/private/factory.ts +7 -4
  146. package/src/public/avm/testing/account_proof.json +553 -0
  147. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  148. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +24 -4
  149. package/src/public/avm/{fixtures → testing}/utils.ts +5 -41
  150. package/src/public/avm_simulator.ts +29 -0
  151. package/src/public/avm_simulator_pool.ts +226 -0
  152. package/src/public/cdb/generated/api_types.ts +457 -0
  153. package/src/public/cdb/generated/server.ts +109 -0
  154. package/src/public/cdb_ipc_server.ts +197 -0
  155. package/src/public/contracts_db_checkpoint.ts +2 -2
  156. package/src/public/db_interfaces.ts +1 -1
  157. package/src/public/executor_metrics.ts +9 -33
  158. package/src/public/fixtures/amm_test.ts +6 -6
  159. package/src/public/fixtures/bulk_test.ts +40 -15
  160. package/src/public/fixtures/custom_bytecode_tester.ts +53 -19
  161. package/src/public/fixtures/index.ts +6 -2
  162. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  163. package/src/public/fixtures/public_tx_simulation_tester.ts +82 -21
  164. package/src/public/fixtures/simple_contract_data_source.ts +2 -2
  165. package/src/public/fixtures/token_test.ts +4 -4
  166. package/src/public/fixtures/utils.ts +25 -27
  167. package/src/public/fuzzing/avm_fuzzer_simulator.ts +303 -0
  168. package/src/public/fuzzing/avm_simulator_bin.ts +173 -0
  169. package/src/public/index.ts +8 -2
  170. package/src/public/public_db_sources.ts +37 -20
  171. package/src/public/public_processor/guarded_merkle_tree.ts +14 -7
  172. package/src/public/public_processor/public_processor.ts +188 -102
  173. package/src/public/public_processor/public_processor_metrics.ts +28 -44
  174. package/src/public/public_tx_simulator/dumping_public_tx_simulator.ts +67 -0
  175. package/src/public/public_tx_simulator/factories.ts +61 -0
  176. package/src/public/public_tx_simulator/index.ts +7 -4
  177. package/src/public/public_tx_simulator/public_tx_simulator.ts +143 -458
  178. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  179. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +23 -0
  180. package/src/public/test_executor_metrics.ts +3 -3
  181. package/dest/public/avm/avm_context.d.ts +0 -41
  182. package/dest/public/avm/avm_context.d.ts.map +0 -1
  183. package/dest/public/avm/avm_context.js +0 -44
  184. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  185. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  186. package/dest/public/avm/avm_contract_call_result.js +0 -54
  187. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  188. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  189. package/dest/public/avm/avm_execution_environment.js +0 -33
  190. package/dest/public/avm/avm_gas.d.ts +0 -44
  191. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  192. package/dest/public/avm/avm_gas.js +0 -195
  193. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  194. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  195. package/dest/public/avm/avm_machine_state.js +0 -109
  196. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  197. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  198. package/dest/public/avm/avm_memory_types.js +0 -351
  199. package/dest/public/avm/avm_simulator.d.ts +0 -40
  200. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  201. package/dest/public/avm/avm_simulator.js +0 -191
  202. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  203. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  204. package/dest/public/avm/avm_simulator_interface.js +0 -3
  205. package/dest/public/avm/errors.d.ts +0 -104
  206. package/dest/public/avm/errors.d.ts.map +0 -1
  207. package/dest/public/avm/errors.js +0 -141
  208. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  209. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  210. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -83
  211. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  212. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  213. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  214. package/dest/public/avm/fixtures/initializers.js +0 -44
  215. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  216. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  217. package/dest/public/avm/index.d.ts +0 -2
  218. package/dest/public/avm/index.d.ts.map +0 -1
  219. package/dest/public/avm/index.js +0 -1
  220. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  221. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  222. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  223. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  224. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  225. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  226. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -47
  227. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  228. package/dest/public/avm/opcodes/arithmetic.js +0 -87
  229. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  230. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  231. package/dest/public/avm/opcodes/bitwise.js +0 -99
  232. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  233. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  234. package/dest/public/avm/opcodes/comparators.js +0 -43
  235. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  236. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  237. package/dest/public/avm/opcodes/contract.js +0 -65
  238. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  239. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  240. package/dest/public/avm/opcodes/control_flow.js +0 -107
  241. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  242. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  243. package/dest/public/avm/opcodes/conversion.js +0 -333
  244. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  245. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  246. package/dest/public/avm/opcodes/ec_add.js +0 -84
  247. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  248. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  249. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  250. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  251. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  252. package/dest/public/avm/opcodes/external_calls.js +0 -209
  253. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  254. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  255. package/dest/public/avm/opcodes/hashing.js +0 -114
  256. package/dest/public/avm/opcodes/index.d.ts +0 -16
  257. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  258. package/dest/public/avm/opcodes/index.js +0 -15
  259. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  260. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  261. package/dest/public/avm/opcodes/instruction.js +0 -95
  262. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  263. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  264. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  265. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  266. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  267. package/dest/public/avm/opcodes/memory.js +0 -257
  268. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  269. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  270. package/dest/public/avm/opcodes/misc.js +0 -73
  271. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  272. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  273. package/dest/public/avm/opcodes/storage.js +0 -68
  274. package/dest/public/avm/revert_reason.d.ts +0 -18
  275. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  276. package/dest/public/avm/revert_reason.js +0 -39
  277. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  278. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  279. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  280. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  281. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  282. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  283. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  284. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  285. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  286. package/dest/public/avm/test_utils.d.ts +0 -15
  287. package/dest/public/avm/test_utils.d.ts.map +0 -1
  288. package/dest/public/avm/test_utils.js +0 -44
  289. package/dest/public/debug_fn_name.d.ts +0 -18
  290. package/dest/public/debug_fn_name.d.ts.map +0 -1
  291. package/dest/public/debug_fn_name.js +0 -28
  292. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -9
  293. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  294. package/dest/public/fixtures/custom_bytecode_tests.js +0 -109
  295. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -9
  296. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  297. package/dest/public/fixtures/minimal_public_tx.js +0 -29
  298. package/dest/public/hinting_db_sources.d.ts +0 -79
  299. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  300. package/dest/public/hinting_db_sources.js +0 -350
  301. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +0 -30
  302. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +0 -1
  303. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +0 -133
  304. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -38
  305. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  306. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -93
  307. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  308. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  309. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  310. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  311. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  312. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -170
  313. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  314. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  315. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  316. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -130
  317. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  318. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  319. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  320. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  321. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -39
  322. package/dest/public/side_effect_trace.d.ts +0 -86
  323. package/dest/public/side_effect_trace.d.ts.map +0 -1
  324. package/dest/public/side_effect_trace.js +0 -199
  325. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  326. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  327. package/dest/public/side_effect_trace_interface.js +0 -1
  328. package/dest/public/state_manager/index.d.ts +0 -2
  329. package/dest/public/state_manager/index.d.ts.map +0 -1
  330. package/dest/public/state_manager/index.js +0 -1
  331. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  332. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  333. package/dest/public/state_manager/nullifiers.js +0 -92
  334. package/dest/public/state_manager/public_storage.d.ts +0 -66
  335. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  336. package/dest/public/state_manager/public_storage.js +0 -145
  337. package/dest/public/state_manager/state_manager.d.ts +0 -164
  338. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  339. package/dest/public/state_manager/state_manager.js +0 -395
  340. package/src/public/avm/avm_context.ts +0 -61
  341. package/src/public/avm/avm_contract_call_result.ts +0 -67
  342. package/src/public/avm/avm_execution_environment.ts +0 -46
  343. package/src/public/avm/avm_gas.ts +0 -183
  344. package/src/public/avm/avm_machine_state.ts +0 -169
  345. package/src/public/avm/avm_memory_types.ts +0 -436
  346. package/src/public/avm/avm_simulator.ts +0 -276
  347. package/src/public/avm/avm_simulator_interface.ts +0 -8
  348. package/src/public/avm/errors.ts +0 -177
  349. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -116
  350. package/src/public/avm/fixtures/initializers.ts +0 -102
  351. package/src/public/avm/index.ts +0 -1
  352. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  353. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  354. package/src/public/avm/opcodes/arithmetic.ts +0 -117
  355. package/src/public/avm/opcodes/bitwise.ts +0 -113
  356. package/src/public/avm/opcodes/comparators.ts +0 -55
  357. package/src/public/avm/opcodes/contract.ts +0 -75
  358. package/src/public/avm/opcodes/control_flow.ts +0 -123
  359. package/src/public/avm/opcodes/conversion.ts +0 -104
  360. package/src/public/avm/opcodes/ec_add.ts +0 -96
  361. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  362. package/src/public/avm/opcodes/external_calls.ts +0 -260
  363. package/src/public/avm/opcodes/hashing.ts +0 -145
  364. package/src/public/avm/opcodes/index.ts +0 -15
  365. package/src/public/avm/opcodes/instruction.ts +0 -136
  366. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  367. package/src/public/avm/opcodes/memory.ts +0 -293
  368. package/src/public/avm/opcodes/misc.ts +0 -102
  369. package/src/public/avm/opcodes/storage.ts +0 -87
  370. package/src/public/avm/revert_reason.ts +0 -58
  371. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  372. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  373. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  374. package/src/public/avm/test_utils.ts +0 -64
  375. package/src/public/debug_fn_name.ts +0 -43
  376. package/src/public/fixtures/custom_bytecode_tests.ts +0 -135
  377. package/src/public/fixtures/minimal_public_tx.ts +0 -35
  378. package/src/public/hinting_db_sources.ts +0 -603
  379. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +0 -162
  380. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -155
  381. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -132
  382. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -240
  383. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  384. package/src/public/public_tx_simulator/public_tx_context.ts +0 -477
  385. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  386. package/src/public/side_effect_trace.ts +0 -290
  387. package/src/public/side_effect_trace_interface.ts +0 -28
  388. package/src/public/state_manager/index.ts +0 -1
  389. package/src/public/state_manager/nullifiers.ts +0 -103
  390. package/src/public/state_manager/public_storage.ts +0 -174
  391. package/src/public/state_manager/state_manager.ts +0 -560
@@ -1,162 +0,0 @@
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
- }
@@ -1,155 +0,0 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
2
- import { avmSimulate } from '@aztec/native';
3
- import { ProtocolContractsList } from '@aztec/protocol-contracts';
4
- import {
5
- AvmFastSimulationInputs,
6
- AvmTxHint,
7
- type PublicSimulatorConfig,
8
- PublicTxResult,
9
- deserializeFromMessagePack,
10
- } from '@aztec/stdlib/avm';
11
- import { SimulationError } from '@aztec/stdlib/errors';
12
- import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
13
- import type { GlobalVariables, Tx } from '@aztec/stdlib/tx';
14
- import { WorldStateRevisionWithHandle } from '@aztec/stdlib/world-state';
15
- import { type TelemetryClient, type Tracer, getTelemetryClient } from '@aztec/telemetry-client';
16
-
17
- import { strict as assert } from 'assert';
18
-
19
- import { ExecutorMetrics } from '../executor_metrics.js';
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
- export class CppPublicTxSimulator extends PublicTxSimulator implements PublicTxSimulatorInterface {
35
- protected override log: Logger;
36
-
37
- constructor(
38
- merkleTree: MerkleTreeWriteOperations,
39
- contractsDB: PublicContractsDB,
40
- globalVariables: GlobalVariables,
41
- config?: Partial<PublicSimulatorConfig>,
42
- ) {
43
- super(merkleTree, contractsDB, globalVariables, config);
44
- this.log = createLogger(`simulator:cpp_public_tx_simulator`);
45
- }
46
-
47
- /**
48
- * Simulate a transaction's public portion using the C++ avvm simulator.
49
- *
50
- * @param tx - The transaction to simulate.
51
- * @returns The result of the transaction's public execution.
52
- */
53
- public override async simulate(tx: Tx): Promise<PublicTxResult> {
54
- const txHash = this.computeTxHash(tx);
55
- this.log.debug(`C++ simulation of ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, {
56
- txHash,
57
- });
58
-
59
- // Using the "as WorldStateRevisionWithHandle" is a bit of a "trust me bro", hence the assert.
60
- let wsRevision = this.merkleTree.getRevision();
61
- assert(
62
- wsRevision instanceof WorldStateRevisionWithHandle,
63
- 'CppPublicTxSimulator a real NativeWorldStateInstance with a handle to the C++ WorldState object',
64
- );
65
- const wsCppHandle = (wsRevision as WorldStateRevisionWithHandle).handle;
66
- wsRevision = wsRevision.toWorldStateRevision(); // for msgpack serialization, we don't include the handle in the type
67
-
68
- this.log.trace(`Running C++ simulation with world state revision ${JSON.stringify(wsRevision)}`);
69
-
70
- // Create the fast simulation inputs
71
- const txHint = AvmTxHint.fromTx(tx, this.globalVariables.gasFees);
72
- const protocolContracts = ProtocolContractsList;
73
- const fastSimInputs = new AvmFastSimulationInputs(
74
- wsRevision,
75
- this.config,
76
- txHint,
77
- this.globalVariables,
78
- protocolContracts,
79
- );
80
-
81
- // Create contract provider for callbacks to TypeScript PublicContractsDB from C++
82
- const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables);
83
-
84
- // Serialize to msgpack and call the C++ simulator
85
- this.log.trace(`Serializing fast simulation inputs to msgpack...`);
86
- const inputBuffer = fastSimInputs.serializeWithMessagePack();
87
-
88
- let resultBuffer: Buffer;
89
- try {
90
- this.log.debug(`Calling C++ simulator for tx ${txHash}`);
91
- resultBuffer = await avmSimulate(inputBuffer, contractProvider, wsCppHandle, logLevel);
92
- } catch (error: any) {
93
- throw new SimulationError(`C++ simulation failed: ${error.message}`, []);
94
- }
95
-
96
- // If we've reached this point, C++ succeeded during simulation,
97
-
98
- // Deserialize the msgpack result
99
- this.log.trace(`Deserializing C++ from buffer (size: ${resultBuffer.length})...`);
100
- const cppResultJSON: object = deserializeFromMessagePack(resultBuffer);
101
- this.log.trace(`Deserializing C++ result to PublicTxResult...`);
102
- const cppResult = PublicTxResult.fromPlainObject(cppResultJSON);
103
-
104
- this.log.trace(`C++ simulation completed for tx ${txHash}`, {
105
- txHash,
106
- reverted: !cppResult.revertCode.isOK(),
107
- cppGasUsed: cppResult.gasUsed.totalGas.l2Gas,
108
- });
109
-
110
- return cppResult;
111
- }
112
- }
113
-
114
- export class MeasuredCppPublicTxSimulator extends CppPublicTxSimulator implements MeasuredPublicTxSimulatorInterface {
115
- constructor(
116
- merkleTree: MerkleTreeWriteOperations,
117
- contractsDB: PublicContractsDB,
118
- globalVariables: GlobalVariables,
119
- protected readonly metrics: ExecutorMetricsInterface,
120
- config?: Partial<PublicSimulatorConfig>,
121
- ) {
122
- super(merkleTree, contractsDB, globalVariables, config);
123
- }
124
-
125
- public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
126
- this.metrics.startRecordingTxSimulation(txLabel);
127
- let result: PublicTxResult | undefined;
128
- try {
129
- result = await super.simulate(tx);
130
- } finally {
131
- this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
132
- }
133
- return result;
134
- }
135
- }
136
-
137
- /**
138
- * A C++ public tx simulator that tracks runtime/production metrics with telemetry.
139
- */
140
- export class TelemetryCppPublicTxSimulator extends MeasuredCppPublicTxSimulator {
141
- /* tracer needed by trackSpans */
142
- public readonly tracer: Tracer;
143
-
144
- constructor(
145
- merkleTree: MerkleTreeWriteOperations,
146
- contractsDB: PublicContractsDB,
147
- globalVariables: GlobalVariables,
148
- telemetryClient: TelemetryClient = getTelemetryClient(),
149
- config?: Partial<PublicSimulatorConfig>,
150
- ) {
151
- const metrics = new ExecutorMetrics(telemetryClient, 'CppPublicTxSimulator');
152
- super(merkleTree, contractsDB, globalVariables, metrics, config);
153
- this.tracer = metrics.tracer;
154
- }
155
- }
@@ -1,132 +0,0 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
2
- import { avmSimulateWithHintedDbs } from '@aztec/native';
3
- import {
4
- AvmCircuitInputs,
5
- type PublicSimulatorConfig,
6
- PublicTxResult,
7
- deserializeFromMessagePack,
8
- } from '@aztec/stdlib/avm';
9
- import { SimulationError } from '@aztec/stdlib/errors';
10
- import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
11
- import type { GlobalVariables, Tx } from '@aztec/stdlib/tx';
12
-
13
- import { strict as assert } from 'assert';
14
-
15
- import type { ExecutorMetricsInterface } from '../executor_metrics_interface.js';
16
- import type { PublicContractsDB } from '../public_db_sources.js';
17
- import { PublicTxSimulator } from './public_tx_simulator.js';
18
- import type {
19
- MeasuredPublicTxSimulatorInterface,
20
- PublicTxSimulatorInterface,
21
- } from './public_tx_simulator_interface.js';
22
-
23
- /**
24
- * C++ implementation of PublicTxSimulator using pre-collected hints.
25
- * This implementation runs TS simulation first to collect all hints,
26
- * then passes the complete AvmCircuitInputs (hints + public inputs)
27
- * to C++ to run hinted simulation.
28
- */
29
- export class CppPublicTxSimulatorHintedDbs extends PublicTxSimulator implements PublicTxSimulatorInterface {
30
- protected override log: Logger;
31
-
32
- constructor(
33
- merkleTree: MerkleTreeWriteOperations,
34
- contractsDB: PublicContractsDB,
35
- globalVariables: GlobalVariables,
36
- config?: Partial<PublicSimulatorConfig>,
37
- ) {
38
- super(merkleTree, contractsDB, globalVariables, config);
39
- this.log = createLogger(`simulator:cpp_public_tx_simulator_hinted_dbs`);
40
- }
41
-
42
- /**
43
- * Simulate a transaction's public portion using the C++ vm2 simulator with hinted DBs.
44
- *
45
- * This implementation:
46
- * 1. Runs the full TypeScript simulation to generate AvmCircuitInputs (hints + public inputs)
47
- * 2. Passes the complete AvmCircuitInputs to C++ to run hinted simulation
48
- *
49
- * @param tx - The transaction to simulate.
50
- * @returns The result of the transaction's public execution.
51
- */
52
- public override async simulate(tx: Tx): Promise<PublicTxResult> {
53
- const txHash = this.computeTxHash(tx);
54
- this.log.debug(`C++ hinted DB simulation of ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, {
55
- txHash,
56
- });
57
-
58
- // First, run TS simulation to generate hints and public inputs
59
- this.log.debug(`Running TS simulation for tx ${txHash}`);
60
-
61
- // Run the full TypeScript simulation using the parent class
62
- // This will modify the merkle tree with the transaction's state changes
63
- const tsResult = await super.simulate(tx);
64
- this.log.debug(`TS simulation succeeded for tx ${txHash}`);
65
-
66
- // Extract the full AvmCircuitInputs from the TS result
67
- const avmCircuitInputs = new AvmCircuitInputs(tsResult.hints!, tsResult.publicInputs);
68
-
69
- // Second, run C++ simulation with hinted DBs
70
- this.log.debug(`Running C++ simulation with hinted DBs for tx ${txHash}`);
71
-
72
- // Serialize to msgpack and call the C++ simulator
73
- const inputBuffer = avmCircuitInputs.serializeWithMessagePack();
74
-
75
- let resultBuffer: Buffer;
76
- try {
77
- resultBuffer = await avmSimulateWithHintedDbs(inputBuffer, logLevel);
78
- } catch (error: any) {
79
- throw new SimulationError(`C++ hinted simulation failed: ${error.message}`, []);
80
- }
81
-
82
- // Deserialize the msgpack result
83
- const cppResultJSON: object = deserializeFromMessagePack(resultBuffer);
84
- const cppResult = PublicTxResult.fromPlainObject(cppResultJSON);
85
-
86
- assert(cppResult.revertCode.equals(tsResult.revertCode));
87
- assert(cppResult.gasUsed.totalGas.equals(tsResult.gasUsed.totalGas));
88
-
89
- this.log.debug(`C++ hinted simulation completed for tx ${txHash}`, {
90
- txHash,
91
- reverted: !tsResult.revertCode.isOK(),
92
- tsGasUsed: tsResult.gasUsed.totalGas.l2Gas,
93
- cppGasUsed: tsResult.gasUsed.totalGas.l2Gas,
94
- });
95
-
96
- // TODO(fcarreiro): complete this.
97
- return tsResult;
98
- }
99
- }
100
-
101
- /**
102
- * Class to record metrics for simulation.
103
- *
104
- * Note(dbanks12): We might not be able to collect all the same metrics in C++ as we do in TS!
105
- * Unless we move some of the metrics collection to C++, we don't have inner functions exposed
106
- * to TS for tracking.
107
- */
108
- export class MeasuredCppPublicTxSimulatorHintedDbs
109
- extends CppPublicTxSimulatorHintedDbs
110
- implements MeasuredPublicTxSimulatorInterface
111
- {
112
- constructor(
113
- merkleTree: MerkleTreeWriteOperations,
114
- contractsDB: PublicContractsDB,
115
- globalVariables: GlobalVariables,
116
- protected readonly metrics: ExecutorMetricsInterface,
117
- config?: Partial<PublicSimulatorConfig>,
118
- ) {
119
- super(merkleTree, contractsDB, globalVariables, config);
120
- }
121
-
122
- public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
123
- this.metrics.startRecordingTxSimulation(txLabel);
124
- let result: PublicTxResult | undefined;
125
- try {
126
- result = await super.simulate(tx);
127
- } finally {
128
- this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
129
- }
130
- return result;
131
- }
132
- }
@@ -1,240 +0,0 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
2
- import { writeTestData } from '@aztec/foundation/testing/files';
3
- import { avmSimulate } from '@aztec/native';
4
- import { ProtocolContractsList } from '@aztec/protocol-contracts';
5
- import {
6
- AvmFastSimulationInputs,
7
- AvmTxHint,
8
- type PublicSimulatorConfig,
9
- PublicTxResult,
10
- deserializeFromMessagePack,
11
- } from '@aztec/stdlib/avm';
12
- import { SimulationError } from '@aztec/stdlib/errors';
13
- import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
14
- import type { GlobalVariables, StateReference, Tx } from '@aztec/stdlib/tx';
15
- import { WorldStateRevisionWithHandle } from '@aztec/stdlib/world-state';
16
-
17
- import { strict as assert } from 'assert';
18
-
19
- import type { ExecutorMetricsInterface } from '../executor_metrics_interface.js';
20
- import type { PublicContractsDB } from '../public_db_sources.js';
21
- import { ContractProviderForCpp } from './contract_provider_for_cpp.js';
22
- import { PublicTxSimulator } from './public_tx_simulator.js';
23
- import type {
24
- MeasuredPublicTxSimulatorInterface,
25
- PublicTxSimulatorInterface,
26
- } from './public_tx_simulator_interface.js';
27
-
28
- /**
29
- * An implementation of PublicTxSimulator that first simulates in C++, then TS, an compares the results.
30
- * The C++ simulator accesses the world state directly/natively within C++.
31
- * For contract DB accesses, it makes callbacks through NAPI back to the TS PublicContractsDB cache.
32
- */
33
- export class CppVsTsPublicTxSimulator extends PublicTxSimulator implements PublicTxSimulatorInterface {
34
- protected override log: Logger;
35
-
36
- constructor(
37
- merkleTree: MerkleTreeWriteOperations,
38
- contractsDB: PublicContractsDB,
39
- globalVariables: GlobalVariables,
40
- config?: Partial<PublicSimulatorConfig>,
41
- ) {
42
- super(merkleTree, contractsDB, globalVariables, config);
43
- this.log = createLogger(`simulator:cpp_public_tx_simulator`);
44
- }
45
-
46
- /**
47
- * Simulate a transaction's public portion using the C++ avvm simulator.
48
- *
49
- * @param tx - The transaction to simulate.
50
- * @returns The result of the transaction's public execution.
51
- */
52
- public override async simulate(tx: Tx): Promise<PublicTxResult> {
53
- const txHash = this.computeTxHash(tx);
54
- this.log.debug(`C++ simulation of ${tx.publicFunctionCalldata.length} public calls for tx ${txHash}`, {
55
- txHash,
56
- });
57
-
58
- // Run TS simulation to generate hints and public inputs
59
- this.log.debug(`Running TS simulation for tx ${txHash}`);
60
-
61
- // create checkpoint for ws
62
- let tsResult: PublicTxResult | undefined;
63
- let tsStateRef: StateReference | undefined;
64
- await this.merkleTree.createCheckpoint();
65
- this.contractsDB.createCheckpoint();
66
- try {
67
- // Run the full TypeScript simulation using the parent class
68
- // This will modify the merkle tree with the transaction's state changes
69
- tsResult = await super.simulate(tx);
70
- this.log.debug(`TS simulation completed for tx ${txHash}`);
71
-
72
- tsStateRef = await this.merkleTree.getStateReference(); // capture tree roots for later comparsion
73
- } catch (error: any) {
74
- this.log.warn(`TS simulation failed, but still continuing with C++ simulation: ${error.message} ${error.stack}`);
75
- } finally {
76
- // revert checkpoint for ws and clear contract db changes
77
- // (cpp should reapply exactly the same changes if there are no bugs)
78
- await this.merkleTree.revertCheckpoint();
79
- this.contractsDB.revertCheckpoint();
80
- }
81
-
82
- this.log.debug(`Running C++ simulation for tx ${txHash}`);
83
-
84
- // Using the "as WorldStateRevisionWithHandle" is a bit of a "trust me bro", hence the assert.
85
- let wsRevision = this.merkleTree.getRevision();
86
- assert(
87
- wsRevision instanceof WorldStateRevisionWithHandle,
88
- 'CppPublicTxSimulator a real NativeWorldStateInstance with a handle to the C++ WorldState object',
89
- );
90
- const wsCppHandle = (wsRevision as WorldStateRevisionWithHandle).handle;
91
- wsRevision = wsRevision.toWorldStateRevision(); // for msgpack serialization, we don't include the handle in the type
92
-
93
- this.log.debug(`Running C++ simulation with world state revision ${JSON.stringify(wsRevision)}`);
94
-
95
- // Create the fast simulation inputs
96
- const txHint = AvmTxHint.fromTx(tx, this.globalVariables.gasFees);
97
- const protocolContracts = ProtocolContractsList;
98
- const fastSimInputs = new AvmFastSimulationInputs(
99
- wsRevision,
100
- this.config,
101
- txHint,
102
- this.globalVariables,
103
- protocolContracts,
104
- );
105
-
106
- // Create contract provider for callbacks to TypeScript PublicContractsDB from C++
107
- const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables);
108
-
109
- // Serialize to msgpack and call the C++ simulator
110
- this.log.debug(`Serializing fast simulation inputs to msgpack...`);
111
- const inputBuffer = fastSimInputs.serializeWithMessagePack();
112
-
113
- let resultBuffer: Buffer;
114
- try {
115
- this.log.debug(`Calling C++ simulator for tx ${txHash}`);
116
- resultBuffer = await avmSimulate(inputBuffer, contractProvider, wsCppHandle, logLevel);
117
- } catch (error: any) {
118
- throw new SimulationError(`C++ simulation failed: ${error.message}`, []);
119
- }
120
-
121
- // If we've reached this point, C++ succeeded during simulation,
122
- // so we assert that TS also succeeded.
123
- assert(tsResult !== undefined, 'TS simulation should have succeeded if C++ succeeded');
124
- assert(tsStateRef !== undefined, 'TS state reference should have been captured if C++ succeeded');
125
-
126
- // Deserialize the msgpack result
127
- this.log.debug(`Deserializing C++ from buffer (size: ${resultBuffer.length})...`);
128
- const cppResultJSON: object = deserializeFromMessagePack(resultBuffer);
129
- // Write testdata if AZTEC_WRITE_TESTDATA=1.
130
- writeTestData(
131
- `barretenberg/cpp/src/barretenberg/vm2/testing/tx_result_${txHash}.testdata.bin`,
132
- resultBuffer,
133
- /*raw=*/ true,
134
- );
135
- this.log.debug(`Deserializing C++ result to PublicTxResult...`);
136
- const cppResult = PublicTxResult.fromPlainObject(cppResultJSON);
137
- this.log.debug(`Done.`);
138
- assert(cppResult.revertCode.equals(tsResult.revertCode));
139
- assert(cppResult.gasUsed.totalGas.equals(tsResult.gasUsed.totalGas));
140
- assert(cppResult.gasUsed.publicGas.equals(tsResult.gasUsed.publicGas));
141
- assert(cppResult.gasUsed.teardownGas.equals(tsResult.gasUsed.teardownGas));
142
- assert(cppResult.gasUsed.billedGas.equals(tsResult.gasUsed.billedGas));
143
- assert(cppResult.publicInputs.toBuffer().equals(tsResult.publicInputs.toBuffer()));
144
-
145
- // TODO(fcarreiro): complete this.
146
- // Check that C++ hints are a strict subset of TS hints.
147
- // Then enable for misc tests and validate hints.
148
- //if (this.config?.collectHints) {
149
- //}
150
-
151
- if (this.config?.collectCallMetadata) {
152
- assert(cppResult.getAppLogicReturnValues().length === tsResult.getAppLogicReturnValues().length);
153
- for (let i = 0; i < cppResult.getAppLogicReturnValues().length; i++) {
154
- assert(cppResult.getAppLogicReturnValues()[i].equals(tsResult.getAppLogicReturnValues()[i]));
155
- }
156
- }
157
- // Messages are still not ok for exceptional halts (they are not plumbed in C++).
158
- const cppRevertReason = cppResult.findRevertReason() || {};
159
- const tsRevertReason = tsResult.findRevertReason() || {};
160
- const cppRevertReasonAsObject = JSON.parse(JSON.stringify(cppRevertReason));
161
- const tsRevertReasonAsObject = JSON.parse(JSON.stringify(tsRevertReason));
162
- if (JSON.stringify(cppRevertReasonAsObject) !== JSON.stringify(tsRevertReasonAsObject)) {
163
- this.log.debug('cppResult.findRevertReason()', cppRevertReasonAsObject);
164
- this.log.debug('tsResult.findRevertReason()', tsRevertReasonAsObject);
165
- }
166
- // TODO: dont compare the strings since this is not deterministic.
167
-
168
- // Sometimes error messages are different between C++ and TS, so we omit in the default comparison
169
- const cppRevertReasonWithoutMessage = { ...cppRevertReasonAsObject, originalMessage: undefined };
170
- const tsRevertReasonWithoutMessage = { ...tsRevertReasonAsObject, originalMessage: undefined };
171
- assert(JSON.stringify(cppRevertReasonWithoutMessage) === JSON.stringify(tsRevertReasonWithoutMessage));
172
-
173
- const cppHasRevertMessage =
174
- cppRevertReasonAsObject.originalMessage && cppRevertReasonAsObject.originalMessage.length > 0;
175
- const tsHasRevertMessage =
176
- tsRevertReasonAsObject.originalMessage && tsRevertReasonAsObject.originalMessage.length > 0;
177
- // assert that if one of the error messages is non-empty, the other is
178
- assert(
179
- cppHasRevertMessage === tsHasRevertMessage,
180
- 'One of the AVM simulators (C++ or TS) produced a revert message, but the other did not',
181
- );
182
- // Ideally, we'd love to be able to compare full error messages, but without a lot of work
183
- // the two simulators will always be able to produce some differing errors.
184
- // Commenting out the code below will enforce that the error messages are at least
185
- // similar (one contains the other). Even this is not something we can guarantee.
186
- //if (cppHasRevertMessage) {
187
- // const cppRevertMessageContainsTs = cppRevertReasonAsObject.originalMessage.includes(
188
- // tsRevertReasonAsObject.originalMessage,
189
- // );
190
- // const tsRevertMessageContainsCpp = tsRevertReasonAsObject.originalMessage.includes(
191
- // cppRevertReasonAsObject.originalMessage,
192
- // );
193
- // assert(
194
- // cppRevertMessageContainsTs || tsRevertMessageContainsCpp,
195
- // 'The AVM simulators (C++ and TS) produced different revert messages (neither was a substring of the other)',
196
- // );
197
- //}
198
-
199
- // Confirm that tree roots match
200
- const cppStateRef = await this.merkleTree.getStateReference();
201
- assert(
202
- cppStateRef.equals(tsStateRef),
203
- `Tree roots mismatch between TS and C++ public simulations for tx ${txHash}`,
204
- );
205
-
206
- this.log.debug(`C++ simulation completed for tx ${txHash}`, {
207
- txHash,
208
- reverted: !cppResult.revertCode.isOK(),
209
- cppGasUsed: cppResult.gasUsed.totalGas.l2Gas,
210
- });
211
-
212
- return tsResult;
213
- }
214
- }
215
-
216
- export class MeasuredCppVsTsPublicTxSimulator
217
- extends CppVsTsPublicTxSimulator
218
- implements MeasuredPublicTxSimulatorInterface
219
- {
220
- constructor(
221
- merkleTree: MerkleTreeWriteOperations,
222
- contractsDB: PublicContractsDB,
223
- globalVariables: GlobalVariables,
224
- protected readonly metrics: ExecutorMetricsInterface,
225
- config?: Partial<PublicSimulatorConfig>,
226
- ) {
227
- super(merkleTree, contractsDB, globalVariables, config);
228
- }
229
-
230
- public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
231
- this.metrics.startRecordingTxSimulation(txLabel);
232
- let result: PublicTxResult | undefined;
233
- try {
234
- result = await super.simulate(tx);
235
- } finally {
236
- this.metrics.stopRecordingTxSimulation(txLabel, result?.gasUsed, result?.revertCode);
237
- }
238
- return result;
239
- }
240
- }