@aztec/simulator 0.0.0-test.1 → 0.0.1-fake-c83136db25

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 (466) hide show
  1. package/README.md +6 -0
  2. package/dest/client.d.ts +5 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +4 -2
  5. package/dest/common/errors.d.ts +4 -7
  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 +0 -1
  9. package/dest/common/index.d.ts.map +1 -1
  10. package/dest/common/index.js +0 -1
  11. package/dest/private/acvm/acvm.d.ts +11 -5
  12. package/dest/private/acvm/acvm.d.ts.map +1 -1
  13. package/dest/private/acvm/acvm.js +10 -16
  14. package/dest/private/acvm/acvm_types.d.ts +1 -1
  15. package/dest/private/acvm/acvm_types.d.ts.map +1 -1
  16. package/dest/private/acvm/deserialize.d.ts +17 -18
  17. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  18. package/dest/private/acvm/deserialize.js +31 -23
  19. package/dest/private/acvm/index.d.ts +0 -1
  20. package/dest/private/acvm/index.d.ts.map +1 -1
  21. package/dest/private/acvm/index.js +0 -1
  22. package/dest/private/acvm/serialize.d.ts +19 -2
  23. package/dest/private/acvm/serialize.d.ts.map +1 -1
  24. package/dest/private/acvm/serialize.js +53 -0
  25. package/dest/private/{providers/acvm_native.d.ts → acvm_native.d.ts} +9 -10
  26. package/dest/private/acvm_native.d.ts.map +1 -0
  27. package/dest/private/{providers/acvm_native.js → acvm_native.js} +11 -7
  28. package/dest/private/acvm_wasm.d.ts +15 -0
  29. package/dest/private/acvm_wasm.d.ts.map +1 -0
  30. package/dest/private/{providers/acvm_wasm.js → acvm_wasm.js} +22 -19
  31. package/dest/private/acvm_wasm_with_blobs.d.ts +20 -0
  32. package/dest/private/acvm_wasm_with_blobs.d.ts.map +1 -0
  33. package/dest/private/acvm_wasm_with_blobs.js +35 -0
  34. package/dest/private/circuit_recording/circuit_recorder.d.ts +108 -0
  35. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -0
  36. package/dest/private/circuit_recording/circuit_recorder.js +209 -0
  37. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +31 -0
  38. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -0
  39. package/dest/private/circuit_recording/file_circuit_recorder.js +135 -0
  40. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +5 -0
  41. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -0
  42. package/dest/private/circuit_recording/memory_circuit_recorder.js +9 -0
  43. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +21 -0
  44. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -0
  45. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +44 -0
  46. package/dest/private/circuit_simulator.d.ts +35 -0
  47. package/dest/private/circuit_simulator.d.ts.map +1 -0
  48. package/dest/private/circuit_simulator.js +43 -0
  49. package/dest/private/factory.d.ts +12 -0
  50. package/dest/private/factory.d.ts.map +1 -0
  51. package/dest/private/{providers/factory.js → factory.js} +2 -2
  52. package/dest/public/avm/avm_context.d.ts +5 -5
  53. package/dest/public/avm/avm_context.d.ts.map +1 -1
  54. package/dest/public/avm/avm_contract_call_result.d.ts +4 -2
  55. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  56. package/dest/public/avm/avm_contract_call_result.js +11 -7
  57. package/dest/public/avm/avm_execution_environment.d.ts +3 -1
  58. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  59. package/dest/public/avm/avm_execution_environment.js +7 -2
  60. package/dest/public/avm/avm_gas.d.ts +4 -20
  61. package/dest/public/avm/avm_gas.d.ts.map +1 -1
  62. package/dest/public/avm/avm_gas.js +27 -35
  63. package/dest/public/avm/avm_machine_state.d.ts +2 -0
  64. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  65. package/dest/public/avm/avm_machine_state.js +2 -0
  66. package/dest/public/avm/avm_memory_types.d.ts +98 -87
  67. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  68. package/dest/public/avm/avm_memory_types.js +17 -6
  69. package/dest/public/avm/avm_simulator.d.ts +4 -5
  70. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  71. package/dest/public/avm/avm_simulator.js +23 -35
  72. package/dest/public/avm/avm_simulator_interface.d.ts +9 -0
  73. package/dest/public/avm/avm_simulator_interface.d.ts.map +1 -0
  74. package/dest/public/avm/avm_simulator_interface.js +3 -0
  75. package/dest/public/avm/errors.d.ts +6 -30
  76. package/dest/public/avm/errors.d.ts.map +1 -1
  77. package/dest/public/avm/errors.js +7 -57
  78. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +5 -4
  79. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  80. package/dest/public/avm/fixtures/avm_simulation_tester.js +12 -14
  81. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts +6 -4
  82. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +1 -1
  83. package/dest/public/avm/fixtures/base_avm_simulation_tester.js +37 -14
  84. package/dest/public/avm/fixtures/initializers.d.ts +43 -0
  85. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -0
  86. package/dest/public/avm/fixtures/initializers.js +42 -0
  87. package/dest/public/avm/fixtures/utils.d.ts +38 -0
  88. package/dest/public/avm/fixtures/utils.d.ts.map +1 -0
  89. package/dest/public/avm/fixtures/utils.js +95 -0
  90. package/dest/public/avm/index.d.ts +0 -2
  91. package/dest/public/avm/index.d.ts.map +1 -1
  92. package/dest/public/avm/index.js +0 -2
  93. package/dest/public/avm/opcodes/accrued_substate.d.ts +2 -2
  94. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  95. package/dest/public/avm/opcodes/accrued_substate.js +28 -25
  96. package/dest/public/avm/opcodes/addressing_mode.d.ts +11 -7
  97. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +1 -1
  98. package/dest/public/avm/opcodes/addressing_mode.js +46 -26
  99. package/dest/public/avm/opcodes/arithmetic.d.ts +11 -1
  100. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  101. package/dest/public/avm/opcodes/arithmetic.js +16 -2
  102. package/dest/public/avm/opcodes/bitwise.d.ts +5 -13
  103. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  104. package/dest/public/avm/opcodes/bitwise.js +19 -26
  105. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  106. package/dest/public/avm/opcodes/comparators.js +3 -3
  107. package/dest/public/avm/opcodes/contract.d.ts +1 -2
  108. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  109. package/dest/public/avm/opcodes/contract.js +9 -10
  110. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  111. package/dest/public/avm/opcodes/control_flow.js +10 -8
  112. package/dest/public/avm/opcodes/conversion.d.ts +1 -0
  113. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  114. package/dest/public/avm/opcodes/conversion.js +267 -3
  115. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  116. package/dest/public/avm/opcodes/ec_add.js +6 -6
  117. package/dest/public/avm/opcodes/environment_getters.d.ts +2 -2
  118. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  119. package/dest/public/avm/opcodes/environment_getters.js +17 -19
  120. package/dest/public/avm/opcodes/external_calls.d.ts +8 -7
  121. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  122. package/dest/public/avm/opcodes/external_calls.js +39 -34
  123. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  124. package/dest/public/avm/opcodes/hashing.js +6 -6
  125. package/dest/public/avm/opcodes/instruction.d.ts +14 -10
  126. package/dest/public/avm/opcodes/instruction.d.ts.map +1 -1
  127. package/dest/public/avm/opcodes/instruction.js +23 -19
  128. package/dest/public/avm/opcodes/memory.d.ts +4 -4
  129. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  130. package/dest/public/avm/opcodes/memory.js +37 -33
  131. package/dest/public/avm/opcodes/misc.d.ts +2 -1
  132. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  133. package/dest/public/avm/opcodes/misc.js +41 -16
  134. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  135. package/dest/public/avm/opcodes/storage.js +7 -5
  136. package/dest/public/avm/revert_reason.d.ts +18 -0
  137. package/dest/public/avm/revert_reason.d.ts.map +1 -0
  138. package/dest/public/avm/revert_reason.js +38 -0
  139. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -2
  140. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +1 -1
  141. package/dest/public/avm/serialization/bytecode_serialization.d.ts +2 -6
  142. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +1 -1
  143. package/dest/public/avm/serialization/bytecode_serialization.js +70 -69
  144. package/dest/public/avm/serialization/instruction_serialization.d.ts +13 -4
  145. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  146. package/dest/public/avm/serialization/instruction_serialization.js +70 -35
  147. package/dest/public/avm/test_utils.d.ts +10 -13
  148. package/dest/public/avm/test_utils.d.ts.map +1 -1
  149. package/dest/public/avm/test_utils.js +16 -24
  150. package/dest/public/db_interfaces.d.ts +56 -0
  151. package/dest/public/db_interfaces.d.ts.map +1 -0
  152. package/dest/public/db_interfaces.js +3 -0
  153. package/dest/public/debug_fn_name.d.ts +5 -0
  154. package/dest/public/debug_fn_name.d.ts.map +1 -0
  155. package/dest/public/debug_fn_name.js +9 -0
  156. package/dest/public/executor_metrics.d.ts +10 -3
  157. package/dest/public/executor_metrics.d.ts.map +1 -1
  158. package/dest/public/executor_metrics.js +37 -6
  159. package/dest/public/executor_metrics_interface.d.ts +9 -0
  160. package/dest/public/executor_metrics_interface.d.ts.map +1 -0
  161. package/dest/public/executor_metrics_interface.js +1 -0
  162. package/dest/public/fixtures/amm_test.d.ts +10 -0
  163. package/dest/public/fixtures/amm_test.d.ts.map +1 -0
  164. package/dest/public/fixtures/amm_test.js +213 -0
  165. package/dest/public/fixtures/bulk_test.d.ts +6 -0
  166. package/dest/public/fixtures/bulk_test.d.ts.map +1 -0
  167. package/dest/public/fixtures/bulk_test.js +326 -0
  168. package/dest/public/fixtures/custom_bytecode_tester.d.ts +12 -0
  169. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -0
  170. package/dest/public/fixtures/custom_bytecode_tester.js +29 -0
  171. package/dest/public/fixtures/custom_bytecode_tests.d.ts +9 -0
  172. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -0
  173. package/dest/public/fixtures/custom_bytecode_tests.js +109 -0
  174. package/dest/public/fixtures/index.d.ts +7 -0
  175. package/dest/public/fixtures/index.d.ts.map +1 -1
  176. package/dest/public/fixtures/index.js +7 -0
  177. package/dest/public/fixtures/minimal_public_tx.d.ts +10 -0
  178. package/dest/public/fixtures/minimal_public_tx.d.ts.map +1 -0
  179. package/dest/public/fixtures/minimal_public_tx.js +29 -0
  180. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +35 -13
  181. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  182. package/dest/public/fixtures/public_tx_simulation_tester.js +96 -71
  183. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.d.ts +6 -6
  184. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -0
  185. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.js +31 -10
  186. package/dest/public/fixtures/token_test.d.ts +8 -0
  187. package/dest/public/fixtures/token_test.d.ts.map +1 -0
  188. package/dest/public/fixtures/token_test.js +95 -0
  189. package/dest/public/fixtures/utils.d.ts +16 -3
  190. package/dest/public/fixtures/utils.d.ts.map +1 -1
  191. package/dest/public/fixtures/utils.js +100 -58
  192. package/dest/public/hinting_db_sources.d.ts +70 -0
  193. package/dest/public/hinting_db_sources.d.ts.map +1 -0
  194. package/dest/public/hinting_db_sources.js +297 -0
  195. package/dest/public/index.d.ts +4 -8
  196. package/dest/public/index.d.ts.map +1 -1
  197. package/dest/public/index.js +4 -7
  198. package/dest/public/public_db_sources.d.ts +30 -39
  199. package/dest/public/public_db_sources.d.ts.map +1 -1
  200. package/dest/public/public_db_sources.js +151 -67
  201. package/dest/public/public_errors.d.ts +12 -0
  202. package/dest/public/public_errors.d.ts.map +1 -0
  203. package/dest/public/public_errors.js +13 -0
  204. package/dest/public/public_processor/guarded_merkle_tree.d.ts +49 -0
  205. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -0
  206. package/dest/public/public_processor/guarded_merkle_tree.js +108 -0
  207. package/dest/public/public_processor/public_processor.d.ts +25 -30
  208. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  209. package/dest/public/public_processor/public_processor.js +141 -96
  210. package/dest/public/public_processor/public_processor_metrics.d.ts +2 -2
  211. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  212. package/dest/public/public_processor/public_processor_metrics.js +1 -1
  213. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +41 -0
  214. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -0
  215. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +89 -0
  216. package/dest/public/public_tx_simulator/index.d.ts +4 -0
  217. package/dest/public/public_tx_simulator/index.d.ts.map +1 -0
  218. package/dest/public/public_tx_simulator/index.js +2 -0
  219. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +24 -0
  220. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +1 -0
  221. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +51 -0
  222. package/dest/public/public_tx_simulator/public_tx_context.d.ts +19 -29
  223. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  224. package/dest/public/public_tx_simulator/public_tx_context.js +63 -91
  225. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +45 -47
  226. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  227. package/dest/public/public_tx_simulator/public_tx_simulator.js +209 -184
  228. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +9 -0
  229. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -0
  230. package/dest/public/public_tx_simulator/public_tx_simulator_interface.js +1 -0
  231. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +21 -0
  232. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +1 -0
  233. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +39 -0
  234. package/dest/public/side_effect_errors.d.ts +41 -1
  235. package/dest/public/side_effect_errors.d.ts.map +1 -1
  236. package/dest/public/side_effect_errors.js +70 -1
  237. package/dest/public/side_effect_trace.d.ts +20 -65
  238. package/dest/public/side_effect_trace.d.ts.map +1 -1
  239. package/dest/public/side_effect_trace.js +71 -121
  240. package/dest/public/side_effect_trace_interface.d.ts +11 -22
  241. package/dest/public/side_effect_trace_interface.d.ts.map +1 -1
  242. package/dest/public/state_manager/index.d.ts +2 -0
  243. package/dest/public/state_manager/index.d.ts.map +1 -0
  244. package/dest/public/state_manager/index.js +1 -0
  245. package/dest/public/{avm/journal → state_manager}/nullifiers.d.ts +2 -5
  246. package/dest/public/state_manager/nullifiers.d.ts.map +1 -0
  247. package/dest/public/{avm/journal → state_manager}/nullifiers.js +3 -8
  248. package/dest/public/{avm/journal → state_manager}/public_storage.d.ts +2 -2
  249. package/dest/public/state_manager/public_storage.d.ts.map +1 -0
  250. package/dest/public/{avm/journal/journal.d.ts → state_manager/state_manager.d.ts} +42 -85
  251. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  252. package/dest/public/state_manager/state_manager.js +391 -0
  253. package/dest/public/test_executor_metrics.d.ts +54 -0
  254. package/dest/public/test_executor_metrics.d.ts.map +1 -0
  255. package/dest/public/test_executor_metrics.js +306 -0
  256. package/dest/public/unique_class_ids.d.ts.map +1 -1
  257. package/dest/public/utils.d.ts +2 -4
  258. package/dest/public/utils.d.ts.map +1 -1
  259. package/dest/public/utils.js +4 -21
  260. package/dest/server.d.ts +6 -3
  261. package/dest/server.d.ts.map +1 -1
  262. package/dest/server.js +5 -2
  263. package/dest/testing.d.ts +2 -0
  264. package/dest/testing.d.ts.map +1 -0
  265. package/dest/testing.js +1 -0
  266. package/package.json +36 -31
  267. package/src/client.ts +5 -3
  268. package/src/common/errors.ts +79 -44
  269. package/src/common/index.ts +0 -1
  270. package/src/private/acvm/acvm.ts +17 -32
  271. package/src/private/acvm/acvm_types.ts +1 -1
  272. package/src/private/acvm/deserialize.ts +35 -29
  273. package/src/private/acvm/index.ts +0 -1
  274. package/src/private/acvm/serialize.ts +63 -0
  275. package/src/private/{providers/acvm_native.ts → acvm_native.ts} +30 -15
  276. package/src/private/acvm_wasm.ts +72 -0
  277. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  278. package/src/private/circuit_recording/circuit_recorder.ts +260 -0
  279. package/src/private/circuit_recording/file_circuit_recorder.ts +158 -0
  280. package/src/private/circuit_recording/memory_circuit_recorder.ts +11 -0
  281. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +91 -0
  282. package/src/private/circuit_simulator.ts +90 -0
  283. package/src/private/{providers/factory.ts → factory.ts} +6 -6
  284. package/src/public/avm/avm_context.ts +4 -4
  285. package/src/public/avm/avm_contract_call_result.ts +17 -5
  286. package/src/public/avm/avm_execution_environment.ts +10 -1
  287. package/src/public/avm/avm_gas.ts +23 -35
  288. package/src/public/avm/avm_machine_state.ts +5 -0
  289. package/src/public/avm/avm_memory_types.ts +19 -6
  290. package/src/public/avm/avm_simulator.ts +44 -54
  291. package/src/public/avm/avm_simulator_interface.ts +8 -0
  292. package/src/public/avm/errors.ts +8 -77
  293. package/src/public/avm/fixtures/avm_simulation_tester.ts +23 -20
  294. package/src/public/avm/fixtures/base_avm_simulation_tester.ts +45 -12
  295. package/src/public/avm/fixtures/initializers.ts +104 -0
  296. package/src/public/avm/fixtures/utils.ts +150 -0
  297. package/src/public/avm/index.ts +0 -2
  298. package/src/public/avm/opcodes/accrued_substate.ts +64 -29
  299. package/src/public/avm/opcodes/addressing_mode.ts +56 -32
  300. package/src/public/avm/opcodes/arithmetic.ts +24 -2
  301. package/src/public/avm/opcodes/bitwise.ts +33 -29
  302. package/src/public/avm/opcodes/comparators.ts +6 -3
  303. package/src/public/avm/opcodes/contract.ts +10 -7
  304. package/src/public/avm/opcodes/control_flow.ts +19 -10
  305. package/src/public/avm/opcodes/conversion.ts +27 -3
  306. package/src/public/avm/opcodes/ec_add.ts +9 -6
  307. package/src/public/avm/opcodes/environment_getters.ts +27 -22
  308. package/src/public/avm/opcodes/external_calls.ts +61 -29
  309. package/src/public/avm/opcodes/hashing.ts +28 -8
  310. package/src/public/avm/opcodes/instruction.ts +31 -21
  311. package/src/public/avm/opcodes/memory.ts +71 -32
  312. package/src/public/avm/opcodes/misc.ts +60 -18
  313. package/src/public/avm/opcodes/storage.ts +22 -6
  314. package/src/public/avm/revert_reason.ts +55 -0
  315. package/src/public/avm/serialization/buffer_cursor.ts +4 -1
  316. package/src/public/avm/serialization/bytecode_serialization.ts +72 -74
  317. package/src/public/avm/serialization/instruction_serialization.ts +75 -34
  318. package/src/public/avm/test_utils.ts +24 -41
  319. package/src/public/db_interfaces.ts +61 -0
  320. package/src/{common → public}/debug_fn_name.ts +7 -7
  321. package/src/public/executor_metrics.ts +55 -6
  322. package/src/public/executor_metrics_interface.ts +14 -0
  323. package/src/public/fixtures/amm_test.ts +331 -0
  324. package/src/public/fixtures/bulk_test.ts +169 -0
  325. package/src/public/fixtures/custom_bytecode_tester.ts +49 -0
  326. package/src/public/fixtures/custom_bytecode_tests.ts +135 -0
  327. package/src/public/fixtures/index.ts +7 -0
  328. package/src/public/fixtures/minimal_public_tx.ts +36 -0
  329. package/src/public/fixtures/public_tx_simulation_tester.ts +158 -113
  330. package/src/public/{avm/fixtures → fixtures}/simple_contract_data_source.ts +36 -18
  331. package/src/public/fixtures/token_test.ts +140 -0
  332. package/src/public/fixtures/utils.ts +141 -68
  333. package/src/public/hinting_db_sources.ts +505 -0
  334. package/src/public/index.ts +9 -8
  335. package/src/public/public_db_sources.ts +196 -97
  336. package/src/public/public_errors.ts +14 -0
  337. package/src/public/public_processor/guarded_merkle_tree.ts +153 -0
  338. package/src/public/public_processor/public_processor.ts +191 -153
  339. package/src/public/public_processor/public_processor_metrics.ts +2 -2
  340. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +128 -0
  341. package/src/public/public_tx_simulator/index.ts +3 -0
  342. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +109 -0
  343. package/src/public/public_tx_simulator/public_tx_context.ts +160 -193
  344. package/src/public/public_tx_simulator/public_tx_simulator.ts +294 -220
  345. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +11 -0
  346. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +63 -0
  347. package/src/public/side_effect_errors.ts +91 -1
  348. package/src/public/side_effect_trace.ts +94 -320
  349. package/src/public/side_effect_trace_interface.ts +10 -58
  350. package/src/public/state_manager/index.ts +1 -0
  351. package/src/public/{avm/journal → state_manager}/nullifiers.ts +5 -11
  352. package/src/public/{avm/journal → state_manager}/public_storage.ts +2 -2
  353. package/src/public/state_manager/state_manager.ts +560 -0
  354. package/src/public/test_executor_metrics.ts +395 -0
  355. package/src/public/utils.ts +5 -21
  356. package/src/server.ts +6 -3
  357. package/src/testing.ts +1 -0
  358. package/dest/common/db_interfaces.d.ts +0 -80
  359. package/dest/common/db_interfaces.d.ts.map +0 -1
  360. package/dest/common/db_interfaces.js +0 -1
  361. package/dest/common/debug_fn_name.d.ts +0 -5
  362. package/dest/common/debug_fn_name.d.ts.map +0 -1
  363. package/dest/common/debug_fn_name.js +0 -6
  364. package/dest/common/message_load_oracle_inputs.d.ts +0 -15
  365. package/dest/common/message_load_oracle_inputs.d.ts.map +0 -1
  366. package/dest/common/message_load_oracle_inputs.js +0 -15
  367. package/dest/private/acvm/oracle/index.d.ts +0 -14
  368. package/dest/private/acvm/oracle/index.d.ts.map +0 -1
  369. package/dest/private/acvm/oracle/index.js +0 -2
  370. package/dest/private/acvm/oracle/oracle.d.ts +0 -49
  371. package/dest/private/acvm/oracle/oracle.d.ts.map +0 -1
  372. package/dest/private/acvm/oracle/oracle.js +0 -263
  373. package/dest/private/acvm/oracle/typed_oracle.d.ts +0 -83
  374. package/dest/private/acvm/oracle/typed_oracle.d.ts.map +0 -1
  375. package/dest/private/acvm/oracle/typed_oracle.js +0 -132
  376. package/dest/private/execution_data_provider.d.ts +0 -261
  377. package/dest/private/execution_data_provider.d.ts.map +0 -1
  378. package/dest/private/execution_data_provider.js +0 -14
  379. package/dest/private/execution_note_cache.d.ts +0 -93
  380. package/dest/private/execution_note_cache.d.ts.map +0 -1
  381. package/dest/private/execution_note_cache.js +0 -180
  382. package/dest/private/hashed_values_cache.d.ts +0 -28
  383. package/dest/private/hashed_values_cache.d.ts.map +0 -1
  384. package/dest/private/hashed_values_cache.js +0 -46
  385. package/dest/private/index.d.ts +0 -13
  386. package/dest/private/index.d.ts.map +0 -1
  387. package/dest/private/index.js +0 -12
  388. package/dest/private/pick_notes.d.ts +0 -85
  389. package/dest/private/pick_notes.d.ts.map +0 -1
  390. package/dest/private/pick_notes.js +0 -51
  391. package/dest/private/private_execution.d.ts +0 -25
  392. package/dest/private/private_execution.d.ts.map +0 -1
  393. package/dest/private/private_execution.js +0 -92
  394. package/dest/private/private_execution_oracle.d.ts +0 -215
  395. package/dest/private/private_execution_oracle.d.ts.map +0 -1
  396. package/dest/private/private_execution_oracle.js +0 -382
  397. package/dest/private/providers/acvm_native.d.ts.map +0 -1
  398. package/dest/private/providers/acvm_wasm.d.ts +0 -15
  399. package/dest/private/providers/acvm_wasm.d.ts.map +0 -1
  400. package/dest/private/providers/acvm_wasm_with_blobs.d.ts +0 -19
  401. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  402. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  403. package/dest/private/providers/factory.d.ts +0 -12
  404. package/dest/private/providers/factory.d.ts.map +0 -1
  405. package/dest/private/providers/simulation_provider.d.ts +0 -19
  406. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  407. package/dest/private/providers/simulation_provider.js +0 -24
  408. package/dest/private/simulator.d.ts +0 -34
  409. package/dest/private/simulator.d.ts.map +0 -1
  410. package/dest/private/simulator.js +0 -76
  411. package/dest/private/unconstrained_execution.d.ts +0 -10
  412. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  413. package/dest/private/unconstrained_execution.js +0 -27
  414. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  415. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  416. package/dest/private/unconstrained_execution_oracle.js +0 -258
  417. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  418. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  419. package/dest/public/avm/bytecode_utils.js +0 -17
  420. package/dest/public/avm/fixtures/index.d.ts +0 -84
  421. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  422. package/dest/public/avm/fixtures/index.js +0 -175
  423. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  424. package/dest/public/avm/journal/index.d.ts +0 -2
  425. package/dest/public/avm/journal/index.d.ts.map +0 -1
  426. package/dest/public/avm/journal/index.js +0 -1
  427. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  428. package/dest/public/avm/journal/journal.js +0 -486
  429. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  430. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  431. package/dest/public/bytecode_errors.d.ts +0 -4
  432. package/dest/public/bytecode_errors.d.ts.map +0 -1
  433. package/dest/public/bytecode_errors.js +0 -6
  434. package/dest/public/execution.d.ts +0 -108
  435. package/dest/public/execution.d.ts.map +0 -1
  436. package/dest/public/execution.js +0 -9
  437. package/dest/test/utils.d.ts +0 -13
  438. package/dest/test/utils.d.ts.map +0 -1
  439. package/dest/test/utils.js +0 -22
  440. package/src/common/db_interfaces.ts +0 -94
  441. package/src/common/message_load_oracle_inputs.ts +0 -15
  442. package/src/private/acvm/oracle/index.ts +0 -16
  443. package/src/private/acvm/oracle/oracle.ts +0 -455
  444. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  445. package/src/private/execution_data_provider.ts +0 -323
  446. package/src/private/execution_note_cache.ts +0 -217
  447. package/src/private/hashed_values_cache.ts +0 -55
  448. package/src/private/index.ts +0 -16
  449. package/src/private/pick_notes.ts +0 -141
  450. package/src/private/private_execution.ts +0 -151
  451. package/src/private/private_execution_oracle.ts +0 -614
  452. package/src/private/providers/acvm_wasm.ts +0 -63
  453. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  454. package/src/private/providers/simulation_provider.ts +0 -45
  455. package/src/private/simulator.ts +0 -147
  456. package/src/private/unconstrained_execution.ts +0 -50
  457. package/src/private/unconstrained_execution_oracle.ts +0 -373
  458. package/src/public/avm/bytecode_utils.ts +0 -17
  459. package/src/public/avm/fixtures/index.ts +0 -296
  460. package/src/public/avm/journal/index.ts +0 -1
  461. package/src/public/avm/journal/journal.ts +0 -742
  462. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  463. package/src/public/bytecode_errors.ts +0 -6
  464. package/src/public/execution.ts +0 -140
  465. package/src/test/utils.ts +0 -36
  466. /package/dest/public/{avm/journal → state_manager}/public_storage.js +0 -0
@@ -1,6 +1,15 @@
1
1
  import type { Fr } from '@aztec/foundation/fields';
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
1
  import { createLogger } from '@aztec/foundation/log';
2
- import type { FunctionDebugMetadata } from '@aztec/stdlib/abi';
3
- import type { NoirCallStack } from '@aztec/stdlib/errors';
4
-
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,10 +29,16 @@ 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
+ * @returns The solved witness calculated by executing the circuit on the provided inputs, as well as the return
41
+ * witness indices as specified by the circuit.
47
42
  */
48
43
  export async function acvm(
49
44
  acir: Buffer,
@@ -55,25 +50,15 @@ export async function acvm(
55
50
  const solvedAndReturnWitness = await executeCircuitWithReturnWitness(
56
51
  acir,
57
52
  initialWitness,
58
- async (name: string, args: ForeignCallInput[]) => {
53
+ (name: string, args: ForeignCallInput[]) => {
59
54
  try {
60
55
  logger.debug(`Oracle callback ${name}`);
61
- const oracleFunction = callback[name as ORACLE_NAMES];
56
+ const oracleFunction = callback[name];
62
57
  if (!oracleFunction) {
63
58
  throw new Error(`Oracle callback ${name} not found`);
64
59
  }
65
60
 
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
- }
61
+ return oracleFunction.call(callback, ...args);
77
62
  } catch (err) {
78
63
  let typedError: Error;
79
64
  if (err instanceof Error) {
@@ -120,8 +105,8 @@ export function extractCallStack(
120
105
  }
121
106
 
122
107
  try {
123
- return resolveOpcodeLocations(callStack, debug, brilligFunctionId);
124
- } catch (err) {
108
+ return resolveOpcodeLocations(callStack, debug.debugSymbols, debug.files, brilligFunctionId);
109
+ } catch {
125
110
  return callStack;
126
111
  }
127
112
  }
@@ -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
1
  import { Fr } from '@aztec/foundation/fields';
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';
@@ -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,15 +1,16 @@
1
1
  import { runInDirectory } from '@aztec/foundation/fs';
2
2
  import { createLogger } 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';
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';
13
14
 
14
15
  const logger = createLogger('simulator:acvm-native');
15
16
 
@@ -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
 
@@ -121,27 +122,41 @@ export async function executeNativeCircuit(
121
122
  });
122
123
  });
123
124
 
124
- const duration = new Timer();
125
+ const timer = new Timer();
125
126
  const output = await processPromise;
127
+ const duration = timer.ms();
126
128
  if (outputFilename) {
127
129
  const outputWitnessFileName = `${workingDirectory}/output-witness.gz`;
128
130
  await fs.copyFile(outputWitnessFileName, outputFilename);
129
131
  }
130
132
  const witness = parseIntoWitnessMap(output);
131
- return { status: ACVM_RESULT.SUCCESS, witness, duration: duration.ms() };
133
+ return { status: ACVM_RESULT.SUCCESS, witness, duration };
132
134
  } catch (error) {
133
135
  return { status: ACVM_RESULT.FAILURE, reason: `${error}` };
134
136
  }
135
137
  }
136
138
 
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> {
139
+ export class NativeACVMSimulator implements CircuitSimulator {
140
+ constructor(
141
+ private workingDirectory: string,
142
+ private pathToAcvm: string,
143
+ private witnessFilename?: string,
144
+ ) {}
145
+
146
+ async executeProtocolCircuit(
147
+ input: ACVMWitness,
148
+ artifact: NoirCompiledCircuitWithName,
149
+ callback: ForeignCallHandler | undefined,
150
+ ): Promise<ACVMSuccess> {
140
151
  // Execute the circuit on those initial witness values
141
152
 
153
+ if (callback) {
154
+ throw new Error('Native ACVM simulator does not support foreign calls. Ignoring callback.');
155
+ }
156
+
142
157
  const operation = async (directory: string) => {
143
158
  // Decode the bytecode from base64 since the acvm does not know about base64 encoding
144
- const decodedBytecode = Buffer.from(compiledCircuit.bytecode, 'base64');
159
+ const decodedBytecode = Buffer.from(artifact.bytecode, 'base64');
145
160
  // Execute the circuit
146
161
  const result = await executeNativeCircuit(
147
162
  input,
@@ -155,15 +170,15 @@ export class NativeACVMSimulator implements SimulationProvider {
155
170
  throw new Error(`Failed to generate witness: ${result.reason}`);
156
171
  }
157
172
 
158
- return result.witness;
173
+ return result;
159
174
  };
160
175
 
161
176
  return await runInDirectory(this.workingDirectory, operation, false, logger);
162
177
  }
163
178
 
164
179
  executeUserCircuit(
165
- _acir: Buffer,
166
- _initialWitness: ACVMWitness,
180
+ _input: ACVMWitness,
181
+ _artifact: FunctionArtifactWithContractName,
167
182
  _callback: ACIRCallback,
168
183
  ): Promise<ACIRExecutionResult> {
169
184
  throw new Error('Not implemented');
@@ -0,0 +1,72 @@
1
+ import { createLogger } from '@aztec/foundation/log';
2
+ import { Timer } from '@aztec/foundation/timer';
3
+ import initACVM, { type ExecutionError, type ForeignCallHandler, executeCircuit } from '@aztec/noir-acvm_js';
4
+ import initAbi from '@aztec/noir-noirc_abi';
5
+ import type { FunctionArtifactWithContractName } from '@aztec/stdlib/abi';
6
+ import type { NoirCompiledCircuitWithName } from '@aztec/stdlib/noir';
7
+
8
+ import { type ACIRCallback, type ACIRExecutionResult, acvm } from './acvm/acvm.js';
9
+ import type { ACVMWitness } from './acvm/acvm_types.js';
10
+ import type { ACVMSuccess } from './acvm_native.js';
11
+ import { type CircuitSimulator, enrichNoirError } from './circuit_simulator.js';
12
+
13
+ export class WASMSimulator implements CircuitSimulator {
14
+ constructor(protected log = createLogger('wasm-simulator')) {}
15
+
16
+ async init(): Promise<void> {
17
+ // If these are available, then we are in the
18
+ // web environment. For the node environment, this
19
+ // is a no-op.
20
+ if (typeof initAbi === 'function') {
21
+ /** @ts-expect-error The node bundle doesn't include these default imports, so TS complains */
22
+ await Promise.all([initAbi(), initACVM()]);
23
+ }
24
+ }
25
+
26
+ async executeProtocolCircuit(
27
+ input: ACVMWitness,
28
+ artifact: NoirCompiledCircuitWithName,
29
+ callback: ForeignCallHandler,
30
+ ): Promise<ACVMSuccess> {
31
+ this.log.debug('init', { hash: artifact.hash });
32
+ await this.init();
33
+
34
+ // Decode the bytecode from base64 since the acvm does not know about base64 encoding
35
+ const decodedBytecode = Buffer.from(artifact.bytecode, 'base64');
36
+ //
37
+ // Execute the circuit
38
+ try {
39
+ const timer = new Timer();
40
+ const result = await executeCircuit(
41
+ decodedBytecode,
42
+ input,
43
+ callback, // handle calls to debug_log
44
+ );
45
+ this.log.debug('execution successful', { hash: artifact.hash });
46
+ return { witness: result, duration: timer.ms() } as ACVMSuccess;
47
+ } catch (err) {
48
+ // Typescript types caught errors as unknown or any, so we need to narrow its type to check if it has raw
49
+ // assertion payload.
50
+ if (typeof err === 'object' && err !== null && 'rawAssertionPayload' in err) {
51
+ const parsed = enrichNoirError(artifact, err as ExecutionError);
52
+ this.log.debug('execution failed', {
53
+ hash: artifact.hash,
54
+ error: parsed,
55
+ message: parsed.message,
56
+ });
57
+ throw parsed;
58
+ }
59
+ this.log.debug('execution failed', { hash: artifact.hash, error: err });
60
+ throw new Error(`Circuit execution failed: ${err}`);
61
+ }
62
+ }
63
+
64
+ async executeUserCircuit(
65
+ input: ACVMWitness,
66
+ artifact: FunctionArtifactWithContractName,
67
+ callback: ACIRCallback,
68
+ ): Promise<ACIRExecutionResult> {
69
+ await this.init();
70
+ return acvm(artifact.bytecode, input, callback);
71
+ }
72
+ }
@@ -0,0 +1,54 @@
1
+ import { Timer } from '@aztec/foundation/timer';
2
+ import { type ExecutionError, type ForeignCallHandler, executeCircuit } from '@aztec/noir-acvm_js';
3
+ import type { WitnessMap } from '@aztec/noir-types';
4
+ import type { FunctionArtifactWithContractName } from '@aztec/stdlib/abi';
5
+ import type { NoirCompiledCircuitWithName } from '@aztec/stdlib/noir';
6
+
7
+ import type { ACIRCallback, ACIRExecutionResult } from './acvm/acvm.js';
8
+ import type { ACVMWitness } from './acvm/acvm_types.js';
9
+ import type { ACVMSuccess } from './acvm_native.js';
10
+ import { type CircuitSimulator, enrichNoirError } from './circuit_simulator.js';
11
+
12
+ /**
13
+ * A circuit simulator that uses the WASM simulator with the ability to handle blobs via the foreign call handler.
14
+ * This class is temporary while brillig cannot handle the blob math, and it is kept separate
15
+ * because the zkg commitment library used in the blob code is not browser compatible.
16
+ *
17
+ * It is only used in the context of server-side code executing simulated protocol circuits.
18
+ */
19
+ export class WASMSimulatorWithBlobs implements CircuitSimulator {
20
+ async executeProtocolCircuit(
21
+ input: WitnessMap,
22
+ artifact: NoirCompiledCircuitWithName,
23
+ callback: ForeignCallHandler,
24
+ ): Promise<ACVMSuccess> {
25
+ // Decode the bytecode from base64 since the acvm does not know about base64 encoding
26
+ const decodedBytecode = Buffer.from(artifact.bytecode, 'base64');
27
+ //
28
+ // Execute the circuit
29
+ try {
30
+ const timer = new Timer();
31
+ const _witnessMap = await executeCircuit(
32
+ decodedBytecode,
33
+ input,
34
+ callback, // handle calls to debug_log and evaluate_blobs mock
35
+ );
36
+ return { witness: _witnessMap, duration: timer.ms() } as ACVMSuccess;
37
+ } catch (err) {
38
+ // Typescript types caught errors as unknown or any, so we need to narrow its type to check if it has raw
39
+ // assertion payload.
40
+ if (typeof err === 'object' && err !== null && 'rawAssertionPayload' in err) {
41
+ throw enrichNoirError(artifact, err as ExecutionError);
42
+ }
43
+ throw new Error(`Circuit execution failed: ${err}`);
44
+ }
45
+ }
46
+
47
+ executeUserCircuit(
48
+ _input: ACVMWitness,
49
+ _artifact: FunctionArtifactWithContractName,
50
+ _callback: ACIRCallback,
51
+ ): Promise<ACIRExecutionResult> {
52
+ throw new Error('Not implemented');
53
+ }
54
+ }