@aztec/simulator 0.0.0-test.0 → 0.0.1-commit.023c3e5

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 (528) hide show
  1. package/README.md +8 -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 +6 -9
  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 +15 -7
  14. package/dest/private/acvm/acvm.d.ts.map +1 -1
  15. package/dest/private/acvm/acvm.js +14 -19
  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 +19 -20
  19. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  20. package/dest/private/acvm/deserialize.js +32 -24
  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 +21 -4
  25. package/dest/private/acvm/serialize.d.ts.map +1 -1
  26. package/dest/private/acvm/serialize.js +54 -1
  27. package/dest/private/acvm_native.d.ts +41 -0
  28. package/dest/private/acvm_native.d.ts.map +1 -0
  29. package/dest/private/{providers/acvm_native.js → acvm_native.js} +34 -26
  30. package/dest/private/acvm_wasm.d.ts +16 -0
  31. package/dest/private/acvm_wasm.d.ts.map +1 -0
  32. package/dest/private/acvm_wasm.js +65 -0
  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 +109 -0
  37. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -0
  38. package/dest/private/circuit_recording/circuit_recorder.js +212 -0
  39. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +32 -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 +10 -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} +8 -5
  54. package/dest/public/avm/avm_context.d.ts +8 -8
  55. package/dest/public/avm/avm_context.d.ts.map +1 -1
  56. package/dest/public/avm/avm_contract_call_result.d.ts +8 -6
  57. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  58. package/dest/public/avm/avm_contract_call_result.js +12 -8
  59. package/dest/public/avm/avm_execution_environment.d.ts +9 -6
  60. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  61. package/dest/public/avm/avm_execution_environment.js +5 -3
  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 +9 -6
  66. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  67. package/dest/public/avm/avm_machine_state.js +5 -2
  68. package/dest/public/avm/avm_memory_types.d.ts +100 -89
  69. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  70. package/dest/public/avm/avm_memory_types.js +21 -7
  71. package/dest/public/avm/avm_simulator.d.ts +8 -7
  72. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  73. package/dest/public/avm/avm_simulator.js +32 -42
  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/calldata.d.ts +51 -0
  78. package/dest/public/avm/calldata.d.ts.map +1 -0
  79. package/dest/public/avm/calldata.js +63 -0
  80. package/dest/public/avm/errors.d.ts +11 -29
  81. package/dest/public/avm/errors.d.ts.map +1 -1
  82. package/dest/public/avm/errors.js +19 -57
  83. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +6 -5
  84. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  85. package/dest/public/avm/fixtures/avm_simulation_tester.js +26 -18
  86. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts +8 -6
  87. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +1 -1
  88. package/dest/public/avm/fixtures/base_avm_simulation_tester.js +38 -15
  89. package/dest/public/avm/fixtures/initializers.d.ts +42 -0
  90. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -0
  91. package/dest/public/avm/fixtures/initializers.js +45 -0
  92. package/dest/public/avm/fixtures/utils.d.ts +39 -0
  93. package/dest/public/avm/fixtures/utils.d.ts.map +1 -0
  94. package/dest/public/avm/fixtures/utils.js +96 -0
  95. package/dest/public/avm/index.d.ts +1 -3
  96. package/dest/public/avm/index.d.ts.map +1 -1
  97. package/dest/public/avm/index.js +0 -2
  98. package/dest/public/avm/opcodes/accrued_substate.d.ts +17 -18
  99. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  100. package/dest/public/avm/opcodes/accrued_substate.js +58 -55
  101. package/dest/public/avm/opcodes/addressing_mode.d.ts +12 -8
  102. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +1 -1
  103. package/dest/public/avm/opcodes/addressing_mode.js +46 -26
  104. package/dest/public/avm/opcodes/arithmetic.d.ts +14 -2
  105. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  106. package/dest/public/avm/opcodes/arithmetic.js +27 -3
  107. package/dest/public/avm/opcodes/bitwise.d.ts +8 -16
  108. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  109. package/dest/public/avm/opcodes/bitwise.js +22 -29
  110. package/dest/public/avm/opcodes/comparators.d.ts +1 -1
  111. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  112. package/dest/public/avm/opcodes/comparators.js +3 -3
  113. package/dest/public/avm/opcodes/contract.d.ts +3 -4
  114. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  115. package/dest/public/avm/opcodes/contract.js +11 -12
  116. package/dest/public/avm/opcodes/control_flow.d.ts +3 -3
  117. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  118. package/dest/public/avm/opcodes/control_flow.js +13 -11
  119. package/dest/public/avm/opcodes/conversion.d.ts +4 -3
  120. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  121. package/dest/public/avm/opcodes/conversion.js +270 -6
  122. package/dest/public/avm/opcodes/ec_add.d.ts +3 -3
  123. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  124. package/dest/public/avm/opcodes/ec_add.js +21 -12
  125. package/dest/public/avm/opcodes/environment_getters.d.ts +5 -5
  126. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  127. package/dest/public/avm/opcodes/environment_getters.js +20 -22
  128. package/dest/public/avm/opcodes/external_calls.d.ts +14 -13
  129. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  130. package/dest/public/avm/opcodes/external_calls.js +52 -46
  131. package/dest/public/avm/opcodes/hashing.d.ts +7 -7
  132. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  133. package/dest/public/avm/opcodes/hashing.js +24 -19
  134. package/dest/public/avm/opcodes/index.d.ts +1 -1
  135. package/dest/public/avm/opcodes/instruction.d.ts +15 -11
  136. package/dest/public/avm/opcodes/instruction.d.ts.map +1 -1
  137. package/dest/public/avm/opcodes/instruction.js +23 -19
  138. package/dest/public/avm/opcodes/instruction_impl.d.ts +4 -4
  139. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +1 -1
  140. package/dest/public/avm/opcodes/instruction_impl.js +4 -4
  141. package/dest/public/avm/opcodes/memory.d.ts +15 -15
  142. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  143. package/dest/public/avm/opcodes/memory.js +52 -48
  144. package/dest/public/avm/opcodes/misc.d.ts +4 -3
  145. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  146. package/dest/public/avm/opcodes/misc.js +42 -17
  147. package/dest/public/avm/opcodes/storage.d.ts +14 -13
  148. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  149. package/dest/public/avm/opcodes/storage.js +39 -27
  150. package/dest/public/avm/revert_reason.d.ts +18 -0
  151. package/dest/public/avm/revert_reason.d.ts.map +1 -0
  152. package/dest/public/avm/revert_reason.js +39 -0
  153. package/dest/public/avm/serialization/buffer_cursor.d.ts +1 -3
  154. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +1 -1
  155. package/dest/public/avm/serialization/bytecode_serialization.d.ts +3 -7
  156. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +1 -1
  157. package/dest/public/avm/serialization/bytecode_serialization.js +79 -75
  158. package/dest/public/avm/serialization/instruction_serialization.d.ts +14 -5
  159. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  160. package/dest/public/avm/serialization/instruction_serialization.js +70 -35
  161. package/dest/public/avm/test_utils.d.ts +12 -15
  162. package/dest/public/avm/test_utils.d.ts.map +1 -1
  163. package/dest/public/avm/test_utils.js +17 -25
  164. package/dest/public/contracts_db_checkpoint.d.ts +16 -0
  165. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -0
  166. package/dest/public/contracts_db_checkpoint.js +30 -0
  167. package/dest/public/db_interfaces.d.ts +68 -0
  168. package/dest/public/db_interfaces.d.ts.map +1 -0
  169. package/dest/public/db_interfaces.js +3 -0
  170. package/dest/public/debug_fn_name.d.ts +18 -0
  171. package/dest/public/debug_fn_name.d.ts.map +1 -0
  172. package/dest/public/debug_fn_name.js +37 -0
  173. package/dest/public/executor_metrics.d.ts +12 -4
  174. package/dest/public/executor_metrics.d.ts.map +1 -1
  175. package/dest/public/executor_metrics.js +33 -23
  176. package/dest/public/executor_metrics_interface.d.ts +10 -0
  177. package/dest/public/executor_metrics_interface.d.ts.map +1 -0
  178. package/dest/public/executor_metrics_interface.js +1 -0
  179. package/dest/public/fixtures/amm_test.d.ts +10 -0
  180. package/dest/public/fixtures/amm_test.d.ts.map +1 -0
  181. package/dest/public/fixtures/amm_test.js +213 -0
  182. package/dest/public/fixtures/bulk_test.d.ts +6 -0
  183. package/dest/public/fixtures/bulk_test.d.ts.map +1 -0
  184. package/dest/public/fixtures/bulk_test.js +262 -0
  185. package/dest/public/fixtures/custom_bytecode_tester.d.ts +34 -0
  186. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -0
  187. package/dest/public/fixtures/custom_bytecode_tester.js +53 -0
  188. package/dest/public/fixtures/custom_bytecode_tests.d.ts +12 -0
  189. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -0
  190. package/dest/public/fixtures/custom_bytecode_tests.js +174 -0
  191. package/dest/public/fixtures/index.d.ts +10 -1
  192. package/dest/public/fixtures/index.d.ts.map +1 -1
  193. package/dest/public/fixtures/index.js +9 -0
  194. package/dest/public/fixtures/minimal_public_tx.d.ts +4 -0
  195. package/dest/public/fixtures/minimal_public_tx.d.ts.map +1 -0
  196. package/dest/public/fixtures/minimal_public_tx.js +19 -0
  197. package/dest/public/fixtures/opcode_spammer.d.ts +122 -0
  198. package/dest/public/fixtures/opcode_spammer.d.ts.map +1 -0
  199. package/dest/public/fixtures/opcode_spammer.js +1653 -0
  200. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +55 -15
  201. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  202. package/dest/public/fixtures/public_tx_simulation_tester.js +138 -72
  203. package/dest/public/fixtures/simple_contract_data_source.d.ts +36 -0
  204. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -0
  205. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.js +31 -10
  206. package/dest/public/fixtures/token_test.d.ts +12 -0
  207. package/dest/public/fixtures/token_test.d.ts.map +1 -0
  208. package/dest/public/fixtures/token_test.js +96 -0
  209. package/dest/public/fixtures/utils.d.ts +18 -5
  210. package/dest/public/fixtures/utils.d.ts.map +1 -1
  211. package/dest/public/fixtures/utils.js +102 -59
  212. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +60 -0
  213. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -0
  214. package/dest/public/fuzzing/avm_fuzzer_simulator.js +171 -0
  215. package/dest/public/fuzzing/avm_simulator_bin.d.ts +2 -0
  216. package/dest/public/fuzzing/avm_simulator_bin.d.ts.map +1 -0
  217. package/dest/public/fuzzing/avm_simulator_bin.js +118 -0
  218. package/dest/public/hinting_db_sources.d.ts +80 -0
  219. package/dest/public/hinting_db_sources.d.ts.map +1 -0
  220. package/dest/public/hinting_db_sources.js +355 -0
  221. package/dest/public/index.d.ts +6 -9
  222. package/dest/public/index.d.ts.map +1 -1
  223. package/dest/public/index.js +4 -7
  224. package/dest/public/public_db_sources.d.ts +54 -103
  225. package/dest/public/public_db_sources.d.ts.map +1 -1
  226. package/dest/public/public_db_sources.js +222 -195
  227. package/dest/public/public_errors.d.ts +12 -0
  228. package/dest/public/public_errors.d.ts.map +1 -0
  229. package/dest/public/public_errors.js +13 -0
  230. package/dest/public/public_processor/guarded_merkle_tree.d.ts +51 -0
  231. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -0
  232. package/dest/public/public_processor/guarded_merkle_tree.js +113 -0
  233. package/dest/public/public_processor/public_processor.d.ts +28 -38
  234. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  235. package/dest/public/public_processor/public_processor.js +576 -136
  236. package/dest/public/public_processor/public_processor_metrics.d.ts +4 -4
  237. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  238. package/dest/public/public_processor/public_processor_metrics.js +29 -46
  239. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +19 -0
  240. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -0
  241. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +98 -0
  242. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +53 -0
  243. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -0
  244. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +132 -0
  245. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +42 -0
  246. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +1 -0
  247. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +86 -0
  248. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +30 -0
  249. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +1 -0
  250. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +171 -0
  251. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +23 -0
  252. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +1 -0
  253. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.js +52 -0
  254. package/dest/public/public_tx_simulator/factories.d.ts +14 -0
  255. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -0
  256. package/dest/public/public_tx_simulator/factories.js +28 -0
  257. package/dest/public/public_tx_simulator/index.d.ts +8 -0
  258. package/dest/public/public_tx_simulator/index.d.ts.map +1 -0
  259. package/dest/public/public_tx_simulator/index.js +5 -0
  260. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +31 -0
  261. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +1 -0
  262. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +51 -0
  263. package/dest/public/public_tx_simulator/public_tx_context.d.ts +25 -31
  264. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  265. package/dest/public/public_tx_simulator/public_tx_context.js +75 -95
  266. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +38 -58
  267. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  268. package/dest/public/public_tx_simulator/public_tx_simulator.js +220 -207
  269. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +32 -0
  270. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -0
  271. package/dest/public/public_tx_simulator/public_tx_simulator_interface.js +1 -0
  272. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +21 -0
  273. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +1 -0
  274. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +415 -0
  275. package/dest/public/side_effect_errors.d.ts +42 -2
  276. package/dest/public/side_effect_errors.d.ts.map +1 -1
  277. package/dest/public/side_effect_errors.js +70 -1
  278. package/dest/public/side_effect_trace.d.ts +24 -69
  279. package/dest/public/side_effect_trace.d.ts.map +1 -1
  280. package/dest/public/side_effect_trace.js +74 -124
  281. package/dest/public/side_effect_trace_interface.d.ts +13 -25
  282. package/dest/public/side_effect_trace_interface.d.ts.map +1 -1
  283. package/dest/public/state_manager/index.d.ts +2 -0
  284. package/dest/public/state_manager/index.d.ts.map +1 -0
  285. package/dest/public/state_manager/index.js +1 -0
  286. package/dest/public/{avm/journal → state_manager}/nullifiers.d.ts +4 -7
  287. package/dest/public/state_manager/nullifiers.d.ts.map +1 -0
  288. package/dest/public/{avm/journal → state_manager}/nullifiers.js +3 -8
  289. package/dest/public/{avm/journal → state_manager}/public_storage.d.ts +4 -4
  290. package/dest/public/state_manager/public_storage.d.ts.map +1 -0
  291. package/dest/public/{avm/journal → state_manager}/public_storage.js +1 -1
  292. package/dest/public/state_manager/state_manager.d.ts +170 -0
  293. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  294. package/dest/public/state_manager/state_manager.js +402 -0
  295. package/dest/public/test_executor_metrics.d.ts +56 -0
  296. package/dest/public/test_executor_metrics.d.ts.map +1 -0
  297. package/dest/public/test_executor_metrics.js +307 -0
  298. package/dest/public/unique_class_ids.d.ts +1 -1
  299. package/dest/public/unique_class_ids.d.ts.map +1 -1
  300. package/dest/public/utils.d.ts +3 -5
  301. package/dest/public/utils.d.ts.map +1 -1
  302. package/dest/public/utils.js +4 -21
  303. package/dest/server.d.ts +7 -4
  304. package/dest/server.d.ts.map +1 -1
  305. package/dest/server.js +5 -2
  306. package/dest/testing.d.ts +2 -0
  307. package/dest/testing.d.ts.map +1 -0
  308. package/dest/testing.js +1 -0
  309. package/package.json +39 -33
  310. package/src/client.ts +5 -3
  311. package/src/common/errors.ts +80 -45
  312. package/src/common/index.ts +0 -1
  313. package/src/private/acvm/acvm.ts +21 -35
  314. package/src/private/acvm/acvm_types.ts +1 -1
  315. package/src/private/acvm/deserialize.ts +36 -30
  316. package/src/private/acvm/index.ts +0 -1
  317. package/src/private/acvm/serialize.ts +64 -1
  318. package/src/private/{providers/acvm_native.ts → acvm_native.ts} +57 -28
  319. package/src/private/acvm_wasm.ts +76 -0
  320. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  321. package/src/private/circuit_recording/circuit_recorder.ts +263 -0
  322. package/src/private/circuit_recording/file_circuit_recorder.ts +163 -0
  323. package/src/private/circuit_recording/memory_circuit_recorder.ts +13 -0
  324. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +91 -0
  325. package/src/private/circuit_simulator.ts +90 -0
  326. package/src/private/{providers/factory.ts → factory.ts} +13 -10
  327. package/src/public/avm/avm_context.ts +6 -6
  328. package/src/public/avm/avm_contract_call_result.ts +23 -9
  329. package/src/public/avm/avm_execution_environment.ts +17 -5
  330. package/src/public/avm/avm_gas.ts +26 -38
  331. package/src/public/avm/avm_machine_state.ts +12 -6
  332. package/src/public/avm/avm_memory_types.ts +24 -7
  333. package/src/public/avm/avm_simulator.ts +57 -62
  334. package/src/public/avm/avm_simulator_interface.ts +8 -0
  335. package/src/public/avm/calldata.ts +100 -0
  336. package/src/public/avm/errors.ts +20 -75
  337. package/src/public/avm/fixtures/avm_simulation_tester.ts +41 -24
  338. package/src/public/avm/fixtures/base_avm_simulation_tester.ts +46 -13
  339. package/src/public/avm/fixtures/initializers.ts +103 -0
  340. package/src/public/avm/fixtures/utils.ts +151 -0
  341. package/src/public/avm/index.ts +0 -2
  342. package/src/public/avm/opcodes/accrued_substate.ts +81 -48
  343. package/src/public/avm/opcodes/addressing_mode.ts +56 -32
  344. package/src/public/avm/opcodes/arithmetic.ts +37 -3
  345. package/src/public/avm/opcodes/bitwise.ts +33 -29
  346. package/src/public/avm/opcodes/comparators.ts +6 -3
  347. package/src/public/avm/opcodes/contract.ts +10 -10
  348. package/src/public/avm/opcodes/control_flow.ts +19 -10
  349. package/src/public/avm/opcodes/conversion.ts +29 -5
  350. package/src/public/avm/opcodes/ec_add.ts +22 -10
  351. package/src/public/avm/opcodes/environment_getters.ts +28 -23
  352. package/src/public/avm/opcodes/external_calls.ts +70 -36
  353. package/src/public/avm/opcodes/hashing.ts +39 -13
  354. package/src/public/avm/opcodes/instruction.ts +31 -21
  355. package/src/public/avm/opcodes/instruction_impl.ts +2 -2
  356. package/src/public/avm/opcodes/memory.ts +81 -42
  357. package/src/public/avm/opcodes/misc.ts +61 -19
  358. package/src/public/avm/opcodes/storage.ts +47 -23
  359. package/src/public/avm/revert_reason.ts +58 -0
  360. package/src/public/avm/serialization/buffer_cursor.ts +4 -1
  361. package/src/public/avm/serialization/bytecode_serialization.ts +89 -80
  362. package/src/public/avm/serialization/instruction_serialization.ts +75 -34
  363. package/src/public/avm/test_utils.ts +25 -42
  364. package/src/public/contracts_db_checkpoint.ts +41 -0
  365. package/src/public/db_interfaces.ts +76 -0
  366. package/src/public/debug_fn_name.ts +52 -0
  367. package/src/public/executor_metrics.ts +49 -23
  368. package/src/public/executor_metrics_interface.ts +15 -0
  369. package/src/public/fixtures/amm_test.ts +331 -0
  370. package/src/public/fixtures/bulk_test.ts +169 -0
  371. package/src/public/fixtures/custom_bytecode_tester.ts +83 -0
  372. package/src/public/fixtures/custom_bytecode_tests.ts +228 -0
  373. package/src/public/fixtures/index.ts +13 -0
  374. package/src/public/fixtures/minimal_public_tx.ts +26 -0
  375. package/src/public/fixtures/opcode_spammer.ts +1721 -0
  376. package/src/public/fixtures/public_tx_simulation_tester.ts +223 -114
  377. package/src/public/{avm/fixtures → fixtures}/simple_contract_data_source.ts +37 -20
  378. package/src/public/fixtures/token_test.ts +148 -0
  379. package/src/public/fixtures/utils.ts +141 -69
  380. package/src/public/fuzzing/avm_fuzzer_simulator.ts +288 -0
  381. package/src/public/fuzzing/avm_simulator_bin.ts +175 -0
  382. package/src/public/hinting_db_sources.ts +607 -0
  383. package/src/public/index.ts +11 -8
  384. package/src/public/public_db_sources.ts +290 -260
  385. package/src/public/public_errors.ts +14 -0
  386. package/src/public/public_processor/guarded_merkle_tree.ts +158 -0
  387. package/src/public/public_processor/public_processor.ts +257 -179
  388. package/src/public/public_processor/public_processor_metrics.ts +18 -46
  389. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +124 -0
  390. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +211 -0
  391. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +134 -0
  392. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +239 -0
  393. package/src/public/public_tx_simulator/dumping_cpp_public_tx_simulator.ts +83 -0
  394. package/src/public/public_tx_simulator/factories.ts +43 -0
  395. package/src/public/public_tx_simulator/index.ts +7 -0
  396. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +105 -0
  397. package/src/public/public_tx_simulator/public_tx_context.ts +179 -199
  398. package/src/public/public_tx_simulator/public_tx_simulator.ts +316 -263
  399. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +33 -0
  400. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +63 -0
  401. package/src/public/side_effect_errors.ts +91 -1
  402. package/src/public/side_effect_trace.ts +99 -322
  403. package/src/public/side_effect_trace_interface.ts +11 -59
  404. package/src/public/state_manager/index.ts +1 -0
  405. package/src/public/{avm/journal → state_manager}/nullifiers.ts +6 -12
  406. package/src/public/{avm/journal → state_manager}/public_storage.ts +3 -3
  407. package/src/public/state_manager/state_manager.ts +569 -0
  408. package/src/public/test_executor_metrics.ts +397 -0
  409. package/src/public/utils.ts +5 -21
  410. package/src/server.ts +6 -3
  411. package/src/testing.ts +1 -0
  412. package/dest/common/db_interfaces.d.ts +0 -80
  413. package/dest/common/db_interfaces.d.ts.map +0 -1
  414. package/dest/common/db_interfaces.js +0 -1
  415. package/dest/common/debug_fn_name.d.ts +0 -5
  416. package/dest/common/debug_fn_name.d.ts.map +0 -1
  417. package/dest/common/debug_fn_name.js +0 -6
  418. package/dest/common/message_load_oracle_inputs.d.ts +0 -15
  419. package/dest/common/message_load_oracle_inputs.d.ts.map +0 -1
  420. package/dest/common/message_load_oracle_inputs.js +0 -15
  421. package/dest/private/acvm/oracle/index.d.ts +0 -14
  422. package/dest/private/acvm/oracle/index.d.ts.map +0 -1
  423. package/dest/private/acvm/oracle/index.js +0 -2
  424. package/dest/private/acvm/oracle/oracle.d.ts +0 -49
  425. package/dest/private/acvm/oracle/oracle.d.ts.map +0 -1
  426. package/dest/private/acvm/oracle/oracle.js +0 -263
  427. package/dest/private/acvm/oracle/typed_oracle.d.ts +0 -83
  428. package/dest/private/acvm/oracle/typed_oracle.d.ts.map +0 -1
  429. package/dest/private/acvm/oracle/typed_oracle.js +0 -132
  430. package/dest/private/execution_data_provider.d.ts +0 -261
  431. package/dest/private/execution_data_provider.d.ts.map +0 -1
  432. package/dest/private/execution_data_provider.js +0 -14
  433. package/dest/private/execution_note_cache.d.ts +0 -93
  434. package/dest/private/execution_note_cache.d.ts.map +0 -1
  435. package/dest/private/execution_note_cache.js +0 -180
  436. package/dest/private/hashed_values_cache.d.ts +0 -28
  437. package/dest/private/hashed_values_cache.d.ts.map +0 -1
  438. package/dest/private/hashed_values_cache.js +0 -46
  439. package/dest/private/index.d.ts +0 -13
  440. package/dest/private/index.d.ts.map +0 -1
  441. package/dest/private/index.js +0 -12
  442. package/dest/private/pick_notes.d.ts +0 -85
  443. package/dest/private/pick_notes.d.ts.map +0 -1
  444. package/dest/private/pick_notes.js +0 -51
  445. package/dest/private/private_execution.d.ts +0 -25
  446. package/dest/private/private_execution.d.ts.map +0 -1
  447. package/dest/private/private_execution.js +0 -92
  448. package/dest/private/private_execution_oracle.d.ts +0 -215
  449. package/dest/private/private_execution_oracle.d.ts.map +0 -1
  450. package/dest/private/private_execution_oracle.js +0 -382
  451. package/dest/private/providers/acvm_native.d.ts +0 -40
  452. package/dest/private/providers/acvm_native.d.ts.map +0 -1
  453. package/dest/private/providers/acvm_wasm.d.ts +0 -15
  454. package/dest/private/providers/acvm_wasm.d.ts.map +0 -1
  455. package/dest/private/providers/acvm_wasm.js +0 -62
  456. package/dest/private/providers/acvm_wasm_with_blobs.d.ts +0 -19
  457. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  458. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  459. package/dest/private/providers/factory.d.ts +0 -12
  460. package/dest/private/providers/factory.d.ts.map +0 -1
  461. package/dest/private/providers/simulation_provider.d.ts +0 -19
  462. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  463. package/dest/private/providers/simulation_provider.js +0 -24
  464. package/dest/private/simulator.d.ts +0 -34
  465. package/dest/private/simulator.d.ts.map +0 -1
  466. package/dest/private/simulator.js +0 -76
  467. package/dest/private/unconstrained_execution.d.ts +0 -10
  468. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  469. package/dest/private/unconstrained_execution.js +0 -27
  470. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  471. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  472. package/dest/private/unconstrained_execution_oracle.js +0 -258
  473. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  474. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  475. package/dest/public/avm/bytecode_utils.js +0 -17
  476. package/dest/public/avm/fixtures/index.d.ts +0 -84
  477. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  478. package/dest/public/avm/fixtures/index.js +0 -175
  479. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts +0 -35
  480. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  481. package/dest/public/avm/journal/index.d.ts +0 -2
  482. package/dest/public/avm/journal/index.d.ts.map +0 -1
  483. package/dest/public/avm/journal/index.js +0 -1
  484. package/dest/public/avm/journal/journal.d.ts +0 -209
  485. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  486. package/dest/public/avm/journal/journal.js +0 -486
  487. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  488. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  489. package/dest/public/bytecode_errors.d.ts +0 -4
  490. package/dest/public/bytecode_errors.d.ts.map +0 -1
  491. package/dest/public/bytecode_errors.js +0 -6
  492. package/dest/public/execution.d.ts +0 -108
  493. package/dest/public/execution.d.ts.map +0 -1
  494. package/dest/public/execution.js +0 -9
  495. package/dest/public/tx_contract_cache.d.ts +0 -41
  496. package/dest/public/tx_contract_cache.d.ts.map +0 -1
  497. package/dest/public/tx_contract_cache.js +0 -49
  498. package/dest/test/utils.d.ts +0 -13
  499. package/dest/test/utils.d.ts.map +0 -1
  500. package/dest/test/utils.js +0 -22
  501. package/src/common/db_interfaces.ts +0 -94
  502. package/src/common/debug_fn_name.ts +0 -18
  503. package/src/common/message_load_oracle_inputs.ts +0 -15
  504. package/src/private/acvm/oracle/index.ts +0 -16
  505. package/src/private/acvm/oracle/oracle.ts +0 -455
  506. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  507. package/src/private/execution_data_provider.ts +0 -323
  508. package/src/private/execution_note_cache.ts +0 -217
  509. package/src/private/hashed_values_cache.ts +0 -55
  510. package/src/private/index.ts +0 -16
  511. package/src/private/pick_notes.ts +0 -141
  512. package/src/private/private_execution.ts +0 -151
  513. package/src/private/private_execution_oracle.ts +0 -614
  514. package/src/private/providers/acvm_wasm.ts +0 -63
  515. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  516. package/src/private/providers/simulation_provider.ts +0 -45
  517. package/src/private/simulator.ts +0 -147
  518. package/src/private/unconstrained_execution.ts +0 -50
  519. package/src/private/unconstrained_execution_oracle.ts +0 -373
  520. package/src/public/avm/bytecode_utils.ts +0 -17
  521. package/src/public/avm/fixtures/index.ts +0 -296
  522. package/src/public/avm/journal/index.ts +0 -1
  523. package/src/public/avm/journal/journal.ts +0 -742
  524. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  525. package/src/public/bytecode_errors.ts +0 -6
  526. package/src/public/execution.ts +0 -140
  527. package/src/public/tx_contract_cache.ts +0 -69
  528. package/src/test/utils.ts +0 -36
@@ -1,6 +1,15 @@
1
- import type { Fr } from '@aztec/foundation/fields';
1
+ import type { Fr } from '@aztec/foundation/curves/bn254';
2
2
  import { jsonStringify } from '@aztec/foundation/json-rpc';
3
- import type { BrilligFunctionId, FunctionAbi, FunctionDebugMetadata, OpcodeLocation } from '@aztec/stdlib/abi';
3
+ import type { RawAssertionPayload } from '@aztec/noir-acvm_js';
4
+ import { abiDecodeError } from '@aztec/noir-noirc_abi';
5
+ import type {
6
+ BrilligFunctionId,
7
+ DebugFileMap,
8
+ DebugInfo,
9
+ FunctionAbi,
10
+ LocationNodeDebugInfo,
11
+ OpcodeLocation,
12
+ } from '@aztec/stdlib/abi';
4
13
  import {
5
14
  type FailingFunction,
6
15
  type NoirCallStack,
@@ -8,9 +17,6 @@ import {
8
17
  type SourceCodeLocation,
9
18
  } from '@aztec/stdlib/errors';
10
19
 
11
- import type { RawAssertionPayload } from '@noir-lang/acvm_js';
12
- import { abiDecodeError } from '@noir-lang/noirc_abi';
13
-
14
20
  /**
15
21
  * An error that occurred during the execution of a function.
16
22
  * @param message - the error message
@@ -77,38 +83,42 @@ export function createSimulationError(error: Error, revertData?: Fr[]): Simulati
77
83
  }
78
84
 
79
85
  /**
80
- * Extracts a brillig location from an opcode location.
81
- * @param opcodeLocation - The opcode location to extract from. It should be in the format `acirLocation.brilligLocation` or `acirLocation`.
82
- * @returns The brillig location if the opcode location contains one.
83
- */
84
- function extractBrilligLocation(opcodeLocation: string): string | undefined {
85
- const splitted = opcodeLocation.split('.');
86
- if (splitted.length === 2) {
87
- return splitted[1];
88
- }
89
- return undefined;
90
- }
91
-
92
- /**
93
- * Extracts the call stack from the location of a failing opcode and the debug metadata.
94
- * One opcode can point to multiple calls due to inlining.
86
+ * Resolves the source code locations from an array of opcode locations
95
87
  */
96
- function getSourceCodeLocationsFromOpcodeLocation(
97
- opcodeLocation: string,
98
- debug: FunctionDebugMetadata,
88
+ export function resolveOpcodeLocations(
89
+ opcodeLocations: OpcodeLocation[],
90
+ debug: DebugInfo,
91
+ files: DebugFileMap,
99
92
  brilligFunctionId?: BrilligFunctionId,
100
93
  ): SourceCodeLocation[] {
101
- const { debugSymbols, files } = debug;
94
+ let locations = opcodeLocations.flatMap(opcodeLocation =>
95
+ getSourceCodeLocationsFromOpcodeLocation(opcodeLocation, debug, files, brilligFunctionId),
96
+ );
102
97
 
103
- let callStack = debugSymbols.locations[opcodeLocation] || [];
104
- if (callStack.length === 0) {
105
- const brilligLocation = extractBrilligLocation(opcodeLocation);
106
- if (brilligFunctionId !== undefined && brilligLocation !== undefined) {
107
- callStack = debugSymbols.brillig_locations[brilligFunctionId][brilligLocation] || [];
98
+ // Adds the acir call stack if the last location is a brillig opcode
99
+ if (locations.length > 0) {
100
+ const decomposedOpcodeLocation = opcodeLocations[opcodeLocations.length - 1].split('.');
101
+ if (decomposedOpcodeLocation.length === 2) {
102
+ const acirCallstackId = debug.acir_locations[decomposedOpcodeLocation[0]];
103
+ if (acirCallstackId !== undefined) {
104
+ const callStack = debug.location_tree.locations[acirCallstackId];
105
+ const acirCallstack = getCallStackFromLocationNode(callStack, debug.location_tree.locations, files);
106
+ locations = acirCallstack.concat(locations);
107
+ }
108
108
  }
109
109
  }
110
- return callStack.map(call => {
111
- const { file: fileId, span } = call;
110
+ return locations;
111
+ }
112
+
113
+ function getCallStackFromLocationNode(
114
+ callStack: LocationNodeDebugInfo,
115
+ locationTree: LocationNodeDebugInfo[],
116
+ files: DebugFileMap,
117
+ ): SourceCodeLocation[] {
118
+ const result: SourceCodeLocation[] = [];
119
+
120
+ while (callStack.parent !== null) {
121
+ const { file: fileId, span } = callStack.value;
112
122
 
113
123
  const { path, source } = files[fileId];
114
124
 
@@ -119,30 +129,55 @@ function getSourceCodeLocationsFromOpcodeLocation(
119
129
  const line = previousLines.length;
120
130
  const column = previousLines[previousLines.length - 1].length + 1;
121
131
 
122
- return {
132
+ // Unshift since we are exploring child nodes first
133
+ result.unshift({
123
134
  filePath: path,
124
135
  line,
125
136
  column,
126
137
  fileSource: source,
127
138
  locationText,
128
- };
129
- });
130
- }
139
+ });
131
140
 
141
+ callStack = locationTree[callStack.parent];
142
+ }
143
+
144
+ return result;
145
+ }
132
146
  /**
133
- * Extracts the source code locations for an array of opcode locations
134
- * @param opcodeLocations - The opcode locations that caused the error.
135
- * @param debug - The debug metadata of the function.
136
- * @returns The source code locations.
147
+ * Extracts the call stack from the location of a failing opcode and the debug metadata.
148
+ * One opcode can point to multiple calls due to inlining.
137
149
  */
138
- export function resolveOpcodeLocations(
139
- opcodeLocations: OpcodeLocation[],
140
- debug: FunctionDebugMetadata,
150
+ function getSourceCodeLocationsFromOpcodeLocation(
151
+ opcodeLocation: string,
152
+ debug: DebugInfo,
153
+ files: DebugFileMap,
141
154
  brilligFunctionId?: BrilligFunctionId,
142
155
  ): SourceCodeLocation[] {
143
- return opcodeLocations.flatMap(opcodeLocation =>
144
- getSourceCodeLocationsFromOpcodeLocation(opcodeLocation, debug, brilligFunctionId),
145
- );
156
+ let callStackID = debug.acir_locations[opcodeLocation];
157
+ const brilligLocation = extractBrilligLocation(opcodeLocation);
158
+ if (brilligFunctionId !== undefined && brilligLocation !== undefined) {
159
+ callStackID = debug.brillig_locations[brilligFunctionId][brilligLocation];
160
+ if (callStackID === undefined) {
161
+ return [];
162
+ }
163
+ }
164
+
165
+ if (callStackID === undefined) {
166
+ return [];
167
+ }
168
+ const callStack = debug.location_tree.locations[callStackID];
169
+ return getCallStackFromLocationNode(callStack, debug.location_tree.locations, files);
170
+ }
171
+
172
+ /**
173
+ * Extracts a brillig location from an opcode location.
174
+ */
175
+ function extractBrilligLocation(opcodeLocation: string): string | undefined {
176
+ const splitted = opcodeLocation.split('.');
177
+ if (splitted.length === 2) {
178
+ return splitted[1];
179
+ }
180
+ return undefined;
146
181
  }
147
182
 
148
183
  export function resolveAssertionMessage(errorPayload: RawAssertionPayload, abi: FunctionAbi): string | undefined {
@@ -1,3 +1,2 @@
1
1
  export * from './errors.js';
2
2
  export * from './stats/index.js';
3
- export * from './message_load_oracle_inputs.js';
@@ -1,33 +1,22 @@
1
- import { createLogger } from '@aztec/foundation/log';
2
- import type { FunctionDebugMetadata } from '@aztec/stdlib/abi';
3
- import type { NoirCallStack } from '@aztec/stdlib/errors';
4
-
1
+ import { type Logger, type LoggerBindings, resolveLogger } from '@aztec/foundation/log';
5
2
  import {
6
3
  type ExecutionError,
7
4
  type ForeignCallInput,
8
5
  type ForeignCallOutput,
9
6
  executeCircuitWithReturnWitness,
10
- } from '@noir-lang/acvm_js';
7
+ } from '@aztec/noir-acvm_js';
8
+ import type { FunctionDebugMetadata } from '@aztec/stdlib/abi';
9
+ import type { NoirCallStack } from '@aztec/stdlib/errors';
11
10
 
12
11
  import { resolveOpcodeLocations, traverseCauseChain } from '../../common/errors.js';
13
12
  import type { ACVMWitness } from './acvm_types.js';
14
- import type { ORACLE_NAMES } from './oracle/index.js';
15
13
 
16
14
  /**
17
15
  * The callback interface for the ACIR.
18
16
  */
19
- export type ACIRCallback = Record<
20
- ORACLE_NAMES,
21
- (
22
- ...args: ForeignCallInput[]
23
- ) =>
24
- | void
25
- | Promise<void>
26
- | ForeignCallOutput
27
- | ForeignCallOutput[]
28
- | Promise<ForeignCallOutput>
29
- | Promise<ForeignCallOutput[]>
30
- >;
17
+ export type ACIRCallback = Record<string, (...args: ForeignCallInput[]) => Promise<ForeignCallOutput[]>>;
18
+
19
+ export type ACIRCallbackStats = { times: number[] };
31
20
 
32
21
  /**
33
22
  * The result of executing an ACIR.
@@ -40,40 +29,37 @@ export interface ACIRExecutionResult {
40
29
  */
41
30
  partialWitness: ACVMWitness;
42
31
  returnWitness: ACVMWitness;
32
+ oracles?: Record<string, ACIRCallbackStats>;
43
33
  }
44
34
 
45
35
  /**
46
36
  * The function call that executes an ACIR.
37
+ * @param acir - The ACIR circuit bytecode to execute.
38
+ * @param initialWitness - The initial witness map defining all of the inputs to `circuit`.
39
+ * @param callback - A callback to process any foreign calls from the circuit.
40
+ * @param logger - Optional logger for ACVM execution logs.
41
+ * @returns The solved witness calculated by executing the circuit on the provided inputs, as well as the return
42
+ * witness indices as specified by the circuit.
47
43
  */
48
44
  export async function acvm(
49
45
  acir: Buffer,
50
46
  initialWitness: ACVMWitness,
51
47
  callback: ACIRCallback,
48
+ loggerOrBindings?: Logger | LoggerBindings,
52
49
  ): Promise<ACIRExecutionResult> {
53
- const logger = createLogger('simulator:acvm');
54
-
50
+ const logger = resolveLogger('simulator:acvm', loggerOrBindings);
55
51
  const solvedAndReturnWitness = await executeCircuitWithReturnWitness(
56
52
  acir,
57
53
  initialWitness,
58
- async (name: string, args: ForeignCallInput[]) => {
54
+ (name: string, args: ForeignCallInput[]) => {
59
55
  try {
60
56
  logger.debug(`Oracle callback ${name}`);
61
- const oracleFunction = callback[name as ORACLE_NAMES];
57
+ const oracleFunction = callback[name];
62
58
  if (!oracleFunction) {
63
59
  throw new Error(`Oracle callback ${name} not found`);
64
60
  }
65
61
 
66
- const result = await oracleFunction.call(callback, ...args);
67
-
68
- if (typeof result === 'undefined') {
69
- return [];
70
- } else if (result instanceof Array && !result.every(item => typeof item === 'string')) {
71
- // We are dealing with a nested array which means that we do not need it wrap it in another array as to have
72
- // the nested array structure it is already "wrapped".
73
- return result;
74
- } else {
75
- return [result] as ForeignCallOutput[];
76
- }
62
+ return oracleFunction.call(callback, ...args);
77
63
  } catch (err) {
78
64
  let typedError: Error;
79
65
  if (err instanceof Error) {
@@ -120,8 +106,8 @@ export function extractCallStack(
120
106
  }
121
107
 
122
108
  try {
123
- return resolveOpcodeLocations(callStack, debug, brilligFunctionId);
124
- } catch (err) {
109
+ return resolveOpcodeLocations(callStack, debug.debugSymbols, debug.files, brilligFunctionId);
110
+ } catch {
125
111
  return callStack;
126
112
  }
127
113
  }
@@ -1,4 +1,4 @@
1
- import type { WitnessMap } from '@noir-lang/acvm_js';
1
+ import type { WitnessMap } from '@aztec/noir-acvm_js';
2
2
 
3
3
  /**
4
4
  * ACVMField
@@ -1,34 +1,8 @@
1
- import { Fr } from '@aztec/foundation/fields';
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { hexToBuffer } from '@aztec/foundation/string';
2
3
 
3
4
  import type { ACVMField, ACVMWitness } from './acvm_types.js';
4
5
 
5
- /**
6
- * Converts an ACVM field to a Fr.
7
- * @param field - The ACVM field to convert.
8
- * @returns The Fr.
9
- */
10
- export function fromACVMField(field: ACVMField): Fr {
11
- return Fr.fromBuffer(Buffer.from(field.slice(2), 'hex'));
12
- }
13
-
14
- /**
15
- * Converts a field to a number.
16
- * @param fr - The field to convert.
17
- * @returns The number.
18
- * TODO(#4102): Nuke this once block number is big int.
19
- */
20
- export function frToNumber(fr: Fr): number {
21
- return Number(fr.value);
22
- }
23
-
24
- /**
25
- * Converts a field to a boolean.
26
- * @param fr - The field to convert.
27
- */
28
- export function frToBoolean(fr: Fr): boolean {
29
- return fr.toBigInt() === BigInt(1);
30
- }
31
-
32
6
  /**
33
7
  * Converts a Noir BoundedVec of Fields into an Fr array. Note that BoundedVecs are structs, and therefore translated as
34
8
  * two separate ACVMField values (an array and a single field).
@@ -38,7 +12,25 @@ export function frToBoolean(fr: Fr): boolean {
38
12
  * @returns An array with the same content as the Noir version. Elements past the length are discarded.
39
13
  */
40
14
  export function fromBoundedVec(storage: ACVMField[], length: ACVMField): Fr[] {
41
- return storage.slice(0, frToNumber(fromACVMField(length))).map(fromACVMField);
15
+ return storage.slice(0, Fr.fromString(length).toNumber()).map(Fr.fromString);
16
+ }
17
+
18
+ /**
19
+ * Converts a Noir BoundedVec of unsigned integers into a Buffer. Note that BoundedVecs are structs, and therefore
20
+ * translated as two separate ACVMField values (an array and a single field).
21
+ *
22
+ * @param storage The array with the BoundedVec's storage (i.e. BoundedVec::storage())
23
+ * @param length The length of the BoundedVec (i.e. BoundedVec::len())
24
+ * @param uintBitSize If it's an array of Noir u8's, put `8`, etc.
25
+ * @returns A buffer containing the unsigned integers tightly packed
26
+ */
27
+ export function fromUintBoundedVec(storage: ACVMField[], length: ACVMField, uintBitSize: number): Buffer {
28
+ if (uintBitSize % 8 !== 0) {
29
+ throw new Error(`u${uintBitSize} is not a supported type in Noir`);
30
+ }
31
+ const uintByteSize = uintBitSize / 8;
32
+ const boundedStorage = storage.slice(0, Fr.fromString(length).toNumber());
33
+ return Buffer.concat(boundedStorage.map(str => hexToBuffer(str).subarray(-uintByteSize)));
42
34
  }
43
35
 
44
36
  /**
@@ -48,5 +40,19 @@ export function fromBoundedVec(storage: ACVMField[], length: ACVMField): Fr[] {
48
40
  */
49
41
  export function witnessMapToFields(witness: ACVMWitness): Fr[] {
50
42
  const sortedKeys = [...witness.keys()].sort((a, b) => a - b);
51
- return sortedKeys.map(key => witness.get(key)!).map(fromACVMField);
43
+ return sortedKeys.map(key => witness.get(key)!).map(Fr.fromString);
44
+ }
45
+
46
+ /**
47
+ * Converts an array of Noir unsigned integers to a single tightly-packed buffer.
48
+ * @param uintBitSize If it's an array of Noir u8's, put `8`, etc.
49
+ * @returns A buffer where each byte is correctly represented as a single byte in the buffer.
50
+ * Copy of the function in txe/src/util/encoding.ts.
51
+ */
52
+ export function fromUintArray(obj: ACVMField[], uintBitSize: number): Buffer {
53
+ if (uintBitSize % 8 !== 0) {
54
+ throw new Error(`u${uintBitSize} is not a supported type in Noir`);
55
+ }
56
+ const uintByteSize = uintBitSize / 8;
57
+ return Buffer.concat(obj.map(str => hexToBuffer(str).slice(-uintByteSize)));
52
58
  }
@@ -1,5 +1,4 @@
1
1
  export { extractCallStack, type ACIRCallback, type ACIRExecutionResult } from './acvm.js';
2
2
  export * from './acvm_types.js';
3
3
  export * from './deserialize.js';
4
- export * from './oracle/index.js';
5
4
  export * from './serialize.js';
@@ -1,5 +1,5 @@
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
1
2
  import type { EthAddress } from '@aztec/foundation/eth-address';
2
- import { Fr } from '@aztec/foundation/fields';
3
3
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
 
5
5
  import type { ACVMField } from './acvm_types.js';
@@ -58,3 +58,66 @@ export function toACVMWitness(witnessStartIndex: number, fields: Parameters<type
58
58
  return witness;
59
59
  }, new Map<number, ACVMField>());
60
60
  }
61
+
62
+ export function bufferToU8Array(buffer: Buffer): ACVMField[] {
63
+ return Array.from(buffer).map(byte => toACVMField(BigInt(byte)));
64
+ }
65
+
66
+ export function bufferToBoundedVec(buffer: Buffer, maxLen: number): [ACVMField[], ACVMField] {
67
+ const u8Array = bufferToU8Array(buffer);
68
+ return arrayToBoundedVec(u8Array, maxLen);
69
+ }
70
+
71
+ /**
72
+ * Converts a ForeignCallArray into a tuple which represents a nr BoundedVec.
73
+ * If the input array is shorter than the maxLen, it pads the result with zeros,
74
+ * so that nr can correctly coerce this result into a BoundedVec.
75
+ * @param bVecStorage - The array underlying the BoundedVec.
76
+ * @param maxLen - the max length of the BoundedVec.
77
+ * @returns a tuple representing a BoundedVec.
78
+ */
79
+ export function arrayToBoundedVec(bVecStorage: ACVMField[], maxLen: number): [ACVMField[], ACVMField] {
80
+ if (bVecStorage.length > maxLen) {
81
+ throw new Error(`Array of length ${bVecStorage.length} larger than maxLen ${maxLen}`);
82
+ }
83
+ const lengthDiff = maxLen - bVecStorage.length;
84
+ const zeroPaddingArray = Array(lengthDiff).fill(toACVMField(BigInt(0)));
85
+ const storage = bVecStorage.concat(zeroPaddingArray);
86
+ const len = toACVMField(BigInt(bVecStorage.length));
87
+ return [storage, len];
88
+ }
89
+
90
+ /**
91
+ * Converts an array of arrays representing Noir BoundedVec of nested arrays into its Noir serialized form.
92
+ * @param bVecStorage - The array underlying the BoundedVec.
93
+ * @param maxLen - The max length of the BoundedVec (max num of the nested arrays in the BoundedVec).
94
+ * @param nestedArrayLength - The length of the nested arrays (each nested array has to have the same length).
95
+ * @returns Serialized BoundedVec following Noir intrinsic serialization.
96
+ */
97
+ export function arrayOfArraysToBoundedVecOfArrays(
98
+ bVecStorage: ACVMField[][],
99
+ maxLen: number,
100
+ nestedArrayLength: number,
101
+ ): [ACVMField[], ACVMField] {
102
+ if (bVecStorage.length > maxLen) {
103
+ throw new Error(`Array of length ${bVecStorage.length} larger than maxLen ${maxLen}`);
104
+ }
105
+
106
+ // Check that all nested arrays have length nestedArrayLength
107
+ if (!bVecStorage.every(nestedArray => nestedArray.length === nestedArrayLength)) {
108
+ throw new Error(
109
+ `Nested array length passed in from Noir does not correspond to the length obtained in TS: ${nestedArrayLength} !== ${bVecStorage[0].length}`,
110
+ );
111
+ }
112
+
113
+ // Flatten the array of arrays
114
+ const flattenedStorage = bVecStorage.flat();
115
+
116
+ // Calculate and add padding
117
+ const numFieldsToPad = maxLen * nestedArrayLength - flattenedStorage.length;
118
+ const flattenedStorageWithPadding = flattenedStorage.concat(Array(numFieldsToPad).fill(toACVMField(BigInt(0))));
119
+
120
+ // Return flattened array with padding and length
121
+ const len = toACVMField(BigInt(bVecStorage.length));
122
+ return [flattenedStorageWithPadding, len];
123
+ }
@@ -1,17 +1,16 @@
1
1
  import { runInDirectory } from '@aztec/foundation/fs';
2
- import { createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, resolveLogger } from '@aztec/foundation/log';
3
3
  import { Timer } from '@aztec/foundation/timer';
4
- import type { NoirCompiledCircuit } from '@aztec/stdlib/noir';
4
+ import type { ForeignCallHandler, WitnessMap } from '@aztec/noir-acvm_js';
5
+ import type { FunctionArtifactWithContractName } from '@aztec/stdlib/abi';
6
+ import type { NoirCompiledCircuitWithName } from '@aztec/stdlib/noir';
5
7
 
6
- import type { WitnessMap } from '@noir-lang/types';
7
8
  import * as proc from 'child_process';
8
9
  import { promises as fs } from 'fs';
9
10
 
10
- import type { ACIRCallback, ACIRExecutionResult } from '../acvm/acvm.js';
11
- import type { ACVMWitness } from '../acvm/acvm_types.js';
12
- import type { SimulationProvider } from './simulation_provider.js';
13
-
14
- const logger = createLogger('simulator:acvm-native');
11
+ import type { ACIRCallback, ACIRExecutionResult } from './acvm/acvm.js';
12
+ import type { ACVMWitness } from './acvm/acvm_types.js';
13
+ import type { CircuitSimulator } from './circuit_simulator.js';
15
14
 
16
15
  export enum ACVM_RESULT {
17
16
  SUCCESS,
@@ -63,7 +62,9 @@ export async function executeNativeCircuit(
63
62
  workingDirectory: string,
64
63
  pathToAcvm: string,
65
64
  outputFilename?: string,
65
+ loggerOrBindings?: Logger | LoggerBindings,
66
66
  ): Promise<ACVMResult> {
67
+ const logger = resolveLogger('simulator:acvm-native', loggerOrBindings);
67
68
  const bytecodeFilename = 'bytecode';
68
69
  const witnessFilename = 'input_witness.toml';
69
70
 
@@ -76,7 +77,7 @@ export async function executeNativeCircuit(
76
77
  try {
77
78
  // Check that the directory exists
78
79
  await fs.access(workingDirectory);
79
- } catch (error) {
80
+ } catch {
80
81
  return { status: ACVM_RESULT.FAILURE, reason: `Working directory ${workingDirectory} does not exist` };
81
82
  }
82
83
 
@@ -102,46 +103,73 @@ export async function executeNativeCircuit(
102
103
  logger.debug(`Calling ACVM with ${args.join(' ')}`);
103
104
 
104
105
  const processPromise = new Promise<string>((resolve, reject) => {
105
- let outputWitness = Buffer.alloc(0);
106
- let errorBuffer = Buffer.alloc(0);
106
+ const outChunks: Buffer[] = [];
107
+ const errChunks: Buffer[] = [];
108
+ let outLen = 0;
109
+ let errLen = 0;
107
110
  const acvm = proc.spawn(pathToAcvm, args);
108
- acvm.stdout.on('data', data => {
109
- outputWitness = Buffer.concat([outputWitness, data]);
111
+ acvm.stdout.on('data', (data: Buffer) => {
112
+ outChunks.push(data);
113
+ outLen += data.length;
110
114
  });
111
- acvm.stderr.on('data', data => {
112
- errorBuffer = Buffer.concat([errorBuffer, data]);
115
+ acvm.stderr.on('data', (data: Buffer) => {
116
+ errChunks.push(data);
117
+ errLen += data.length;
113
118
  });
114
119
  acvm.on('close', code => {
115
120
  if (code === 0) {
116
- resolve(outputWitness.toString('utf-8'));
121
+ resolve(Buffer.concat(outChunks, outLen).toString('utf-8'));
117
122
  } else {
118
- logger.error(`From ACVM: ${errorBuffer.toString('utf-8')}`);
119
- reject(errorBuffer.toString('utf-8'));
123
+ const stderr = Buffer.concat(errChunks, errLen);
124
+ logger.error(`From ACVM: ${stderr.toString('utf-8')}`);
125
+ reject(stderr.toString('utf-8'));
120
126
  }
121
127
  });
122
128
  });
123
129
 
124
- const duration = new Timer();
130
+ const timer = new Timer();
125
131
  const output = await processPromise;
132
+ const duration = timer.ms();
126
133
  if (outputFilename) {
127
134
  const outputWitnessFileName = `${workingDirectory}/output-witness.gz`;
128
135
  await fs.copyFile(outputWitnessFileName, outputFilename);
129
136
  }
137
+ // TODO: We shouldn't be parsing the witness from stdout, it's not very performant, and we end up with two ways of fetching the witness.
138
+ // We probably should implement the WitnessStack type, run the ACVM with msgpack serialization mode (env variable), and ungzip and parse the witness from
139
+ // the outputted gz witness file.
130
140
  const witness = parseIntoWitnessMap(output);
131
- return { status: ACVM_RESULT.SUCCESS, witness, duration: duration.ms() };
141
+ return { status: ACVM_RESULT.SUCCESS, witness, duration };
132
142
  } catch (error) {
133
143
  return { status: ACVM_RESULT.FAILURE, reason: `${error}` };
134
144
  }
135
145
  }
136
146
 
137
- export class NativeACVMSimulator implements SimulationProvider {
138
- constructor(private workingDirectory: string, private pathToAcvm: string, private witnessFilename?: string) {}
139
- async executeProtocolCircuit(input: WitnessMap, compiledCircuit: NoirCompiledCircuit): Promise<WitnessMap> {
147
+ export class NativeACVMSimulator implements CircuitSimulator {
148
+ private logger: Logger;
149
+
150
+ constructor(
151
+ private workingDirectory: string,
152
+ private pathToAcvm: string,
153
+ private witnessFilename?: string,
154
+ loggerOrBindings?: Logger | LoggerBindings,
155
+ ) {
156
+ this.logger = resolveLogger('simulator:acvm-native', loggerOrBindings);
157
+ }
158
+
159
+ async executeProtocolCircuit(
160
+ input: ACVMWitness,
161
+ artifact: NoirCompiledCircuitWithName,
162
+ callback: ForeignCallHandler | undefined,
163
+ ): Promise<ACVMSuccess> {
140
164
  // Execute the circuit on those initial witness values
141
165
 
166
+ if (callback) {
167
+ throw new Error('Native ACVM simulator does not support foreign calls. Ignoring callback.');
168
+ }
169
+
142
170
  const operation = async (directory: string) => {
143
171
  // Decode the bytecode from base64 since the acvm does not know about base64 encoding
144
- const decodedBytecode = Buffer.from(compiledCircuit.bytecode, 'base64');
172
+ const decodedBytecode = Buffer.from(artifact.bytecode, 'base64');
145
173
  // Execute the circuit
146
174
  const result = await executeNativeCircuit(
147
175
  input,
@@ -149,21 +177,22 @@ export class NativeACVMSimulator implements SimulationProvider {
149
177
  directory,
150
178
  this.pathToAcvm,
151
179
  this.witnessFilename,
180
+ this.logger,
152
181
  );
153
182
 
154
183
  if (result.status == ACVM_RESULT.FAILURE) {
155
184
  throw new Error(`Failed to generate witness: ${result.reason}`);
156
185
  }
157
186
 
158
- return result.witness;
187
+ return result;
159
188
  };
160
189
 
161
- return await runInDirectory(this.workingDirectory, operation, false, logger);
190
+ return await runInDirectory(this.workingDirectory, operation, false, this.logger);
162
191
  }
163
192
 
164
193
  executeUserCircuit(
165
- _acir: Buffer,
166
- _initialWitness: ACVMWitness,
194
+ _input: ACVMWitness,
195
+ _artifact: FunctionArtifactWithContractName,
167
196
  _callback: ACIRCallback,
168
197
  ): Promise<ACIRExecutionResult> {
169
198
  throw new Error('Not implemented');