@aztec/simulator 0.0.0-test.1 → 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
@@ -0,0 +1,52 @@
1
+ import { FunctionSelector } from '@aztec/stdlib/abi';
2
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+
4
+ import type { CallData } from './avm/calldata.js';
5
+ import type { PublicContractsDBInterface } from './db_interfaces.js';
6
+
7
+ export async function getPublicFunctionDebugName(
8
+ db: PublicContractsDBInterface,
9
+ contractAddress: AztecAddress,
10
+ calldata: CallData,
11
+ ): Promise<string> {
12
+ // Public function is dispatched and therefore the target function is passed in the first argument.
13
+ const selectorField = calldata.read(0);
14
+ if (!selectorField) {
15
+ return `<calldata[0] undefined> (Contract Address: ${contractAddress})`;
16
+ }
17
+ const fallbackName = `<calldata[0]:${selectorField.toString()}> (Contract Address: ${contractAddress})`;
18
+ const selector = FunctionSelector.fromFieldOrUndefined(selectorField);
19
+ if (!selector) {
20
+ return fallbackName;
21
+ }
22
+ return (await db.getDebugFunctionName(contractAddress, selector)) ?? fallbackName;
23
+ }
24
+
25
+ /**
26
+ * Get the function selector and optional debug name for a public function.
27
+ * Returns the selector and name separately, with name only populated if a debug name is available.
28
+ * @param db - The contracts database
29
+ * @param contractAddress - The contract address
30
+ * @param calldata - The calldata (selector is in calldata[0])
31
+ * @returns An object with functionSelector (always if calldata[0] exists) and functionName (only if debug name found)
32
+ */
33
+ export async function getPublicFunctionSelectorAndName(
34
+ db: PublicContractsDBInterface,
35
+ contractAddress: AztecAddress,
36
+ calldata: CallData,
37
+ ): Promise<{ functionSelector?: FunctionSelector; functionName?: string }> {
38
+ // Public function is dispatched and therefore the target function is passed in the first argument.
39
+ const selectorField = calldata.read(0);
40
+ if (!selectorField) {
41
+ return {};
42
+ }
43
+ const selector = FunctionSelector.fromFieldOrUndefined(selectorField);
44
+ if (!selector) {
45
+ return {};
46
+ }
47
+ const debugName = await db.getDebugFunctionName(contractAddress, selector);
48
+ return {
49
+ functionSelector: selector,
50
+ functionName: debugName ?? undefined,
51
+ };
52
+ }
@@ -1,3 +1,5 @@
1
+ import type { RevertCode } from '@aztec/stdlib/avm';
2
+ import type { GasUsed } from '@aztec/stdlib/gas';
1
3
  import {
2
4
  Attributes,
3
5
  type Histogram,
@@ -5,50 +7,69 @@ import {
5
7
  type TelemetryClient,
6
8
  type Tracer,
7
9
  type UpDownCounter,
8
- ValueType,
10
+ createUpDownCounterWithDefault,
9
11
  } from '@aztec/telemetry-client';
10
12
 
11
- export class ExecutorMetrics {
13
+ import type { ExecutorMetricsInterface } from './executor_metrics_interface.js';
14
+
15
+ export class ExecutorMetrics implements ExecutorMetricsInterface {
12
16
  public readonly tracer: Tracer;
13
17
  private fnCount: UpDownCounter;
14
18
  private fnDuration: Histogram;
15
19
  private manaPerSecond: Histogram;
20
+ private manaUsed: Histogram;
21
+ private totalInstructionsExecuted: Histogram;
22
+ private txHashing: Histogram;
16
23
  private privateEffectsInsertions: Histogram;
17
24
 
18
25
  constructor(client: TelemetryClient, name = 'PublicExecutor') {
19
26
  this.tracer = client.getTracer(name);
20
27
  const meter = client.getMeter(name);
21
28
 
22
- this.fnCount = meter.createUpDownCounter(Metrics.PUBLIC_EXECUTOR_SIMULATION_COUNT, {
23
- description: 'Number of functions executed',
29
+ this.fnCount = createUpDownCounterWithDefault(meter, Metrics.PUBLIC_EXECUTOR_SIMULATION_COUNT, {
30
+ [Attributes.OK]: [true, false],
24
31
  });
25
32
 
26
- this.fnDuration = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_DURATION, {
27
- description: 'How long it takes to execute a function',
28
- unit: 'ms',
29
- valueType: ValueType.INT,
30
- });
33
+ this.fnDuration = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_DURATION);
31
34
 
32
- this.manaPerSecond = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_MANA_PER_SECOND, {
33
- description: 'Mana used per second',
34
- unit: 'mana/s',
35
- valueType: ValueType.INT,
36
- });
35
+ this.manaPerSecond = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_MANA_PER_SECOND);
37
36
 
38
- this.privateEffectsInsertions = meter.createHistogram(Metrics.PUBLIC_EXECUTION_PRIVATE_EFFECTS_INSERTION, {
39
- description: 'Private effects insertion time',
40
- unit: 'us',
41
- valueType: ValueType.INT,
42
- });
37
+ this.manaUsed = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_MANA_USED);
38
+
39
+ this.totalInstructionsExecuted = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_TOTAL_INSTRUCTIONS);
40
+
41
+ this.txHashing = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_TX_HASHING);
42
+
43
+ this.privateEffectsInsertions = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_PRIVATE_EFFECTS_INSERTION);
44
+ }
45
+
46
+ startRecordingTxSimulation(_txLabel: string) {
47
+ // do nothing (unimplemented)
43
48
  }
44
49
 
45
- recordFunctionSimulation(durationMs: number, manaUsed: number, fnName: string) {
50
+ stopRecordingTxSimulation(_txLabel: string, _gasUsed?: GasUsed, _revertedCode?: RevertCode) {
51
+ // do nothing (unimplemented)
52
+ }
53
+
54
+ recordEnqueuedCallSimulation(
55
+ fnName: string,
56
+ durationMs: number,
57
+ manaUsed: number,
58
+ totalInstructionsExecuted: number,
59
+ ) {
46
60
  this.fnCount.add(1, {
47
61
  [Attributes.OK]: true,
48
62
  [Attributes.APP_CIRCUIT_NAME]: fnName,
49
- [Attributes.MANA_USED]: manaUsed,
50
63
  });
51
- this.fnDuration.record(Math.ceil(durationMs));
64
+ this.manaUsed.record(Math.ceil(manaUsed), {
65
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
66
+ });
67
+ this.totalInstructionsExecuted.record(Math.ceil(totalInstructionsExecuted), {
68
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
69
+ });
70
+ this.fnDuration.record(Math.ceil(durationMs), {
71
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
72
+ });
52
73
  if (durationMs > 0 && manaUsed > 0) {
53
74
  const manaPerSecond = Math.round((manaUsed * 1000) / durationMs);
54
75
  this.manaPerSecond.record(manaPerSecond, {
@@ -57,7 +78,12 @@ export class ExecutorMetrics {
57
78
  }
58
79
  }
59
80
 
60
- recordFunctionSimulationFailure() {
81
+ recordEnqueuedCallSimulationFailure(
82
+ _fnName: string,
83
+ _durationMs: number,
84
+ _manaUsed: number,
85
+ _totalInstructionsExecuted: number,
86
+ ) {
61
87
  this.fnCount.add(1, {
62
88
  [Attributes.OK]: false,
63
89
  });
@@ -0,0 +1,15 @@
1
+ import type { RevertCode } from '@aztec/stdlib/avm';
2
+ import type { GasUsed } from '@aztec/stdlib/gas';
3
+
4
+ export interface ExecutorMetricsInterface {
5
+ startRecordingTxSimulation(txLabel: string): void;
6
+ stopRecordingTxSimulation(txLabel: string, gasUsed?: GasUsed, revertedCode?: RevertCode): void;
7
+ recordEnqueuedCallSimulation(fnName: string, durationMs: number, manaUsed: number, totalInstructions: number): void;
8
+ recordEnqueuedCallSimulationFailure(
9
+ fnName: string,
10
+ durationMs: number,
11
+ manaUsed: number,
12
+ totalInstructionsExecuted: number,
13
+ ): void;
14
+ recordPrivateEffectsInsertion(durationUs: number, type: 'revertible' | 'non-revertible'): void;
15
+ }
@@ -0,0 +1,331 @@
1
+ import { GeneratorIndex } from '@aztec/constants';
2
+ import { poseidon2HashWithSeparator } from '@aztec/foundation/crypto/poseidon';
3
+ import { Fr } from '@aztec/foundation/curves/bn254';
4
+ import type { Logger } from '@aztec/foundation/log';
5
+ import { Timer } from '@aztec/foundation/timer';
6
+ import type { ContractArtifact } from '@aztec/stdlib/abi';
7
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
8
+ import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
9
+
10
+ import { PublicTxSimulationTester } from './public_tx_simulation_tester.js';
11
+ import { setUpToken } from './token_test.js';
12
+
13
+ const INITIAL_TOKEN_BALANCE = 1_000_000_000n;
14
+ /**
15
+ * THIS TEST IS BRITTLE! If it breaks, don't try fixing it.
16
+ * `.skip` it or literally just delete it and notify AVM team.
17
+ * You do NOT need permission to remove this test!
18
+ */
19
+ export async function ammTest(
20
+ tester: PublicTxSimulationTester,
21
+ logger: Logger,
22
+ tokenArtifact: ContractArtifact,
23
+ ammArtifact: ContractArtifact,
24
+ expectToBeTrue: (x: boolean) => void,
25
+ ) {
26
+ const timer = new Timer();
27
+
28
+ const admin = AztecAddress.fromNumber(42);
29
+ const sender = AztecAddress.fromNumber(111);
30
+
31
+ logger.debug(`Deploying tokens`);
32
+ const token0 = await setUpToken(tester, tokenArtifact, admin, expectToBeTrue, /*seed=*/ 0);
33
+ const token1 = await setUpToken(tester, tokenArtifact, admin, expectToBeTrue, /*seed=*/ 1);
34
+ const liquidityToken = await setUpToken(tester, tokenArtifact, admin, expectToBeTrue, /*seed=*/ 2);
35
+ logger.debug(`Deploying AMM`);
36
+ const constructorArgs = [token0, token1, liquidityToken];
37
+ const amm = await tester.registerAndDeployContract(
38
+ constructorArgs,
39
+ /*deployer=*/ admin,
40
+ ammArtifact,
41
+ /*skipNullifierInsertion=*/ false,
42
+ /*seed=*/ 3,
43
+ );
44
+
45
+ // EXECUTE! This means that if using AvmProvingTester subclass, it will PROVE the transaction!
46
+ const ammConstructorResult = await tester.executeTxWithLabel(
47
+ /*txLabel=*/ 'AMM/constructor',
48
+ /*sender=*/ admin,
49
+ /*setupCalls=*/ [],
50
+ /*appCalls=*/ [
51
+ {
52
+ fnName: 'constructor',
53
+ args: constructorArgs,
54
+ address: amm.address,
55
+ },
56
+ ],
57
+ );
58
+ expectToBeTrue(ammConstructorResult.revertCode.isOK());
59
+
60
+ logger.debug(`Setting AMM as minter for liquidity token`);
61
+
62
+ // set the AMM as the minter for the liquidity token
63
+ // EXECUTE! This means that if using AvmProvingTester subclass, it will PROVE the transaction!
64
+ const setMinterResult = await tester.executeTxWithLabel(
65
+ /*txLabel=*/ 'AMM/set_minter',
66
+ /*sender=*/ admin,
67
+ /*setupCalls=*/ [],
68
+ /*appCalls=*/ [
69
+ {
70
+ fnName: 'set_minter',
71
+ args: [/*minter=*/ amm, /*approve=*/ true],
72
+ address: liquidityToken.address,
73
+ },
74
+ ],
75
+ );
76
+ expectToBeTrue(setMinterResult.revertCode.isOK());
77
+
78
+ logger.debug(`Adding liquidity`);
79
+ const amount0Max = (INITIAL_TOKEN_BALANCE * 6n) / 10n;
80
+ const amount0Min = (INITIAL_TOKEN_BALANCE * 4n) / 10n;
81
+ const amount1Max = (INITIAL_TOKEN_BALANCE * 5n) / 10n;
82
+ const amount1Min = (INITIAL_TOKEN_BALANCE * 4n) / 10n;
83
+
84
+ const addLiquidityResult = await addLiquidity(
85
+ tester,
86
+ sender,
87
+ /*amm=*/ amm,
88
+ /*token0=*/ token0,
89
+ /*token1=*/ token1,
90
+ /*liquidityToken=*/ liquidityToken,
91
+ /*amount0Max=*/ amount0Max,
92
+ /*amount1Max=*/ amount1Max,
93
+ /*amount0Min=*/ amount0Min,
94
+ /*amount1Min=*/ amount1Min,
95
+ );
96
+ expectToBeTrue(addLiquidityResult.revertCode.isOK());
97
+
98
+ logger.debug(`Swapping tokens`);
99
+ const swapResult = await swapExactTokensForTokens(
100
+ tester,
101
+ sender,
102
+ /*amm=*/ amm,
103
+ /*tokenIn=*/ token0,
104
+ /*tokenOut=*/ token1,
105
+ /*amountIn=*/ amount0Min / 10n, // something smaller than total liquidity
106
+ /*amountOutMin=*/ amount1Min / 100n, // something even smaller
107
+ );
108
+ expectToBeTrue(swapResult.revertCode.isOK());
109
+
110
+ logger.debug(`Removing liquidity`);
111
+ const removeLiquidityResult = await removeLiquidity(
112
+ tester,
113
+ sender,
114
+ /*amm=*/ amm,
115
+ /*token0=*/ token0,
116
+ /*token1=*/ token1,
117
+ /*liquidityToken=*/ liquidityToken,
118
+ /*liquidity=*/ 100n,
119
+ /*amount0Min=*/ 1n, // remove some tiny amount
120
+ /*amount1Min=*/ 1n,
121
+ );
122
+ expectToBeTrue(removeLiquidityResult.revertCode.isOK());
123
+
124
+ logger.info(`AMM public tx simulator test took ${timer.ms()}ms\n`);
125
+ }
126
+
127
+ async function addLiquidity(
128
+ tester: PublicTxSimulationTester,
129
+ sender: AztecAddress,
130
+ amm: ContractInstanceWithAddress,
131
+ token0: ContractInstanceWithAddress,
132
+ token1: ContractInstanceWithAddress,
133
+ liquidityToken: ContractInstanceWithAddress,
134
+ amount0Max: bigint,
135
+ amount1Max: bigint,
136
+ amount0Min: bigint,
137
+ amount1Min: bigint,
138
+ _nonce?: bigint,
139
+ ) {
140
+ const refundToken0PartialNote = {
141
+ commitment: new Fr(42),
142
+ };
143
+ const refundToken1PartialNote = {
144
+ commitment: new Fr(66),
145
+ };
146
+ const liquidityPartialNote = {
147
+ commitment: new Fr(99),
148
+ };
149
+ const refundToken0PartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
150
+ refundToken0PartialNote,
151
+ amm.address,
152
+ );
153
+ const refundToken1PartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
154
+ refundToken1PartialNote,
155
+ amm.address,
156
+ );
157
+ const liquidityPartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
158
+ liquidityPartialNote,
159
+ amm.address,
160
+ );
161
+
162
+ // We need to inject the validity commitments into the nullifier tree as that would be performed by the private token
163
+ // functions that are not invoked in this test.
164
+ await tester.insertNullifier(token0.address, refundToken0PartialNoteValidityCommitment);
165
+ await tester.insertNullifier(token1.address, refundToken1PartialNoteValidityCommitment);
166
+ await tester.insertNullifier(liquidityToken.address, liquidityPartialNoteValidityCommitment);
167
+
168
+ // EXECUTE! This means that if using AvmProvingTester subclass, it will PROVE the transaction!
169
+ return await tester.executeTxWithLabel(
170
+ /*txLabel=*/ 'AMM/add_liquidity',
171
+ /*sender=*/ sender,
172
+ /*setupCalls=*/ [],
173
+ /*appCalls=*/ [
174
+ // token0.transfer_to_public enqueues a call to _increase_public_balance
175
+ {
176
+ sender: token0.address, // INTERNAL FUNCTION! Sender must be 'this'.
177
+ fnName: '_increase_public_balance',
178
+ args: [/*to=*/ amm.address, /*amount=*/ amount0Max],
179
+ address: token0.address,
180
+ },
181
+ // token1.transfer_to_public enqueues a call to _increase_public_balance
182
+ {
183
+ sender: token1.address, // INTERNAL FUNCTION! Sender must be 'this'.
184
+ fnName: '_increase_public_balance',
185
+ args: [/*to=*/ amm.address, /*amount=*/ amount1Max],
186
+ address: token1.address,
187
+ },
188
+ // amm.add_liquidity enqueues a call to _add_liquidity
189
+ {
190
+ sender: amm.address, // INTERNAL FUNCTION! Sender must be 'this'.
191
+ fnName: '_add_liquidity',
192
+ args: [
193
+ /*config=*/ {
194
+ token0: token0.address,
195
+ token1: token1.address,
196
+ // eslint-disable-next-line camelcase
197
+ liquidity_token: liquidityToken.address,
198
+ },
199
+ refundToken0PartialNote,
200
+ refundToken1PartialNote,
201
+ liquidityPartialNote,
202
+ amount0Max,
203
+ amount1Max,
204
+ amount0Min,
205
+ amount1Min,
206
+ ],
207
+ address: amm.address,
208
+ },
209
+ ],
210
+ );
211
+ }
212
+
213
+ async function swapExactTokensForTokens(
214
+ tester: PublicTxSimulationTester,
215
+ sender: AztecAddress,
216
+ amm: ContractInstanceWithAddress,
217
+ tokenIn: ContractInstanceWithAddress,
218
+ tokenOut: ContractInstanceWithAddress,
219
+ amountIn: bigint,
220
+ amountOutMin: bigint,
221
+ _nonce?: bigint,
222
+ ) {
223
+ const tokenOutPartialNote = {
224
+ commitment: new Fr(166),
225
+ };
226
+ const tokenOutPartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
227
+ tokenOutPartialNote,
228
+ amm.address,
229
+ );
230
+
231
+ // We need to inject the validity commitment into the nullifier tree as that would be performed by the private token
232
+ // function that is not invoked in this test.
233
+ await tester.insertNullifier(tokenOut.address, tokenOutPartialNoteValidityCommitment);
234
+
235
+ // EXECUTE! This means that if using AvmProvingTester subclass, it will PROVE the transaction!
236
+ return await tester.executeTxWithLabel(
237
+ /*txLabel=*/ 'AMM/swap_exact_tokens_for_tokens',
238
+ /*sender=*/ sender,
239
+ /*setupCalls=*/ [],
240
+ /*appCalls=*/ [
241
+ // tokenIn.transfer_to_public enqueues a call to _increase_public_balance
242
+ {
243
+ sender: tokenIn.address, // INTERNAL FUNCTION! Sender must be 'this'.
244
+ fnName: '_increase_public_balance',
245
+ args: [/*to=*/ amm.address, /*amount=*/ amountIn],
246
+ address: tokenIn.address,
247
+ },
248
+ {
249
+ sender: amm.address, // INTERNAL FUNCTION! Sender must be 'this'.
250
+ fnName: '_swap_exact_tokens_for_tokens',
251
+ args: [tokenIn.address, tokenOut.address, amountIn, amountOutMin, tokenOutPartialNote],
252
+ address: amm.address,
253
+ },
254
+ ],
255
+ );
256
+ }
257
+
258
+ async function removeLiquidity(
259
+ tester: PublicTxSimulationTester,
260
+ sender: AztecAddress,
261
+ amm: ContractInstanceWithAddress,
262
+ token0: ContractInstanceWithAddress,
263
+ token1: ContractInstanceWithAddress,
264
+ liquidityToken: ContractInstanceWithAddress,
265
+ liquidity: bigint,
266
+ amount0Min: bigint,
267
+ amount1Min: bigint,
268
+ _nonce?: bigint,
269
+ ) {
270
+ const token0PartialNote = {
271
+ commitment: new Fr(111),
272
+ };
273
+ const token1PartialNote = {
274
+ commitment: new Fr(222),
275
+ };
276
+ const token0PartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
277
+ token0PartialNote,
278
+ amm.address,
279
+ );
280
+ const token1PartialNoteValidityCommitment = await computePartialNoteValidityCommitment(
281
+ token1PartialNote,
282
+ amm.address,
283
+ );
284
+
285
+ // We need to inject the validity commitments into the nullifier tree as that would be performed by the private token
286
+ // functions that are not invoked in this test.
287
+ await tester.insertNullifier(token0.address, token0PartialNoteValidityCommitment);
288
+ await tester.insertNullifier(token1.address, token1PartialNoteValidityCommitment);
289
+
290
+ // EXECUTE! This means that if using AvmProvingTester subclass, it will PROVE the transaction!
291
+ return await tester.executeTxWithLabel(
292
+ /*txLabel=*/ 'AMM/remove_liquidity',
293
+ /*sender=*/ sender,
294
+ /*setupCalls=*/ [],
295
+ /*appCalls=*/ [
296
+ // liquidityToken.transfer_to_public enqueues a call to _increase_public_balance
297
+ {
298
+ sender: liquidityToken.address, // INTERNAL FUNCTION! Sender must be 'this'.
299
+ fnName: '_increase_public_balance',
300
+ args: [/*to=*/ amm.address, /*amount=*/ liquidity],
301
+ address: liquidityToken.address,
302
+ },
303
+ // amm.remove_liquidity enqueues a call to _remove_liquidity
304
+ {
305
+ sender: amm.address, // INTERNAL FUNCTION! Sender must be 'this'.
306
+ fnName: '_remove_liquidity',
307
+ args: [
308
+ /*config=*/ {
309
+ token0: token0.address,
310
+ token1: token1.address,
311
+ // eslint-disable-next-line camelcase
312
+ liquidity_token: liquidityToken.address,
313
+ },
314
+ liquidity,
315
+ token0PartialNote,
316
+ token1PartialNote,
317
+ amount0Min,
318
+ amount1Min,
319
+ ],
320
+ address: amm.address,
321
+ },
322
+ ],
323
+ );
324
+ }
325
+
326
+ async function computePartialNoteValidityCommitment(partialNote: { commitment: Fr }, completer: AztecAddress) {
327
+ return await poseidon2HashWithSeparator(
328
+ [partialNote.commitment, completer],
329
+ GeneratorIndex.PARTIAL_NOTE_VALIDITY_COMMITMENT,
330
+ );
331
+ }
@@ -0,0 +1,169 @@
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
2
+ import type { Logger } from '@aztec/foundation/log';
3
+ import { Timer } from '@aztec/foundation/timer';
4
+ import type { ContractArtifact } from '@aztec/stdlib/abi';
5
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
6
+
7
+ import { PublicTxSimulationTester } from './public_tx_simulation_tester.js';
8
+
9
+ export async function bulkTest(
10
+ tester: PublicTxSimulationTester,
11
+ logger: Logger,
12
+ avmTestContractArtifact: ContractArtifact,
13
+ ) {
14
+ const timer = new Timer();
15
+
16
+ const deployer = AztecAddress.fromNumber(42);
17
+ const avmTestContract = await tester.registerAndDeployContract(
18
+ /*constructorArgs=*/ [],
19
+ deployer,
20
+ avmTestContractArtifact,
21
+ );
22
+
23
+ // Needed since we invoke the Fee Juice Contract in the bulk test.registerFeeJuiceContract
24
+ await tester.registerFeeJuiceContract();
25
+ // Register multiple different protocol contracts (to ensure we don't dedup bytecode hashing events):
26
+ await tester.registerAuthContract();
27
+ await tester.registerInstanceRegistryContract();
28
+
29
+ // Get a deployed contract instance to pass to the contract
30
+ // for it to use as "expected" values when testing contract instance retrieval.
31
+ const expectContractInstance = avmTestContract;
32
+ const argsField = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
33
+ const argsU8 = [1, 2, 3, 4, 5, 6, 7, 8].map(x => new Fr(x));
34
+ argsU8.push(new Fr(2n ** 128n + 9n)); // Trigger truncation from large (> 128 bits) value (canonical decomposition event)
35
+ argsU8.push(new Fr(2n ** 125n + 10n)); // Trigger truncation from small (< 128 bits) value (no canonical decomposition event)
36
+ const args = [
37
+ argsField,
38
+ argsU8,
39
+ /*getInstanceForAddress=*/ expectContractInstance.address,
40
+ /*expectedDeployer=*/ expectContractInstance.deployer,
41
+ /*expectedClassId=*/ expectContractInstance.currentContractClassId,
42
+ /*expectedInitializationHash=*/ expectContractInstance.initializationHash,
43
+ /*skip_strictly_limited_side_effects=*/ false,
44
+ ];
45
+
46
+ const bulkResult = await tester.executeTxWithLabel(
47
+ /*txLabel=*/ 'AvmTest/bulk_testing',
48
+ /*sender=*/ deployer,
49
+ /*setupCalls=*/ [],
50
+ /*appCalls=*/ [
51
+ {
52
+ address: avmTestContract.address,
53
+ fnName: 'bulk_testing',
54
+ args,
55
+ },
56
+ // 3 calls creating calldata + asserting calldata copy:
57
+ {
58
+ address: avmTestContract.address,
59
+ fnName: 'assert_calldata_copy_large',
60
+ args: [Array.from({ length: 300 }, () => Fr.random()), /* with_selector: */ true],
61
+ },
62
+ {
63
+ address: avmTestContract.address,
64
+ fnName: 'assert_calldata_copy',
65
+ args: [argsField.slice(3), /* with_selector: */ true],
66
+ },
67
+ {
68
+ address: avmTestContract.address,
69
+ fnName: 'assert_calldata_copy_large',
70
+ args: [Array.from({ length: 300 }, () => Fr.random()), /* with_selector: */ true],
71
+ },
72
+ // 3 calls to external contracts
73
+ { address: avmTestContract.address, fnName: 'call_fee_juice', args: [] },
74
+ { address: avmTestContract.address, fnName: 'call_auth_registry', args: [] },
75
+ { address: avmTestContract.address, fnName: 'call_instance_registry', args: [] },
76
+ ],
77
+ /*teardownCall=*/ undefined,
78
+ /*feePayer*/ undefined,
79
+ /*privateInsertions=*/ {
80
+ nonRevertible: {
81
+ nullifiers: [new Fr(420000)],
82
+ noteHashes: [new Fr(420001)],
83
+ },
84
+ revertible: {
85
+ nullifiers: [new Fr(420002)],
86
+ noteHashes: [new Fr(420003)],
87
+ },
88
+ },
89
+ );
90
+
91
+ logger.info(`Bulk test took ${timer.ms()}ms\n`);
92
+
93
+ return bulkResult;
94
+ }
95
+
96
+ export async function megaBulkTest(
97
+ tester: PublicTxSimulationTester,
98
+ logger: Logger,
99
+ avmTestContractArtifact: ContractArtifact,
100
+ ) {
101
+ const timer = new Timer();
102
+
103
+ const deployer = AztecAddress.fromNumber(42);
104
+ const avmTestContract = await tester.registerAndDeployContract(
105
+ /*constructorArgs=*/ [],
106
+ deployer,
107
+ avmTestContractArtifact,
108
+ );
109
+
110
+ // Needed since we invoke the Fee Juice Contract in the bulk test.registerFeeJuiceContract
111
+ await tester.registerFeeJuiceContract();
112
+
113
+ // Get a deployed contract instance to pass to the contract
114
+ // for it to use as "expected" values when testing contract instance retrieval.
115
+ const expectContractInstance = avmTestContract;
116
+ const argsField0 = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
117
+ const argsField1 = [3, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
118
+ const argsField2 = [5, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
119
+ const argsField3 = [7, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
120
+ const argsField4 = [9, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
121
+ //const argsField5 = [11, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
122
+ //const argsField6 = [13, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
123
+ //const argsField7 = [15, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
124
+ //const argsField8 = [17, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
125
+ const argsU8 = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10].map(x => new Fr(x));
126
+ const genArgs = (argsField: Fr[]) => [
127
+ argsField,
128
+ argsU8,
129
+ /*getInstanceForAddress=*/ expectContractInstance.address.toField(),
130
+ /*expectedDeployer=*/ expectContractInstance.deployer.toField(),
131
+ /*expectedClassId=*/ expectContractInstance.currentContractClassId.toField(),
132
+ /*expectedInitializationHash=*/ expectContractInstance.initializationHash.toField(),
133
+ // Must skip strictly limited side effects (logs, messages) so we can spam the bulk test several times.
134
+ /*skip_strictly_limited_side_effects=*/ true,
135
+ ];
136
+
137
+ const bulkResult = await tester.executeTxWithLabel(
138
+ /*txLabel=*/ 'AvmTest/mega_bulk_testing',
139
+ /*sender=*/ deployer,
140
+ /*setupCalls=*/ [],
141
+ /*appCalls=*/ [
142
+ { address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField0) },
143
+ { address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField1) },
144
+ { address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField2) },
145
+ { address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField3) },
146
+ { address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField4) },
147
+ //{ address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField5) },
148
+ //{ address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField6) },
149
+ //{ address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField7) },
150
+ //{ address: avmTestContract.address, fnName: 'bulk_testing', args: genArgs(argsField8) },
151
+ ],
152
+ /*teardownCall=*/ undefined,
153
+ /*feePayer*/ undefined,
154
+ /*privateInsertions=*/ {
155
+ nonRevertible: {
156
+ nullifiers: [new Fr(420000)],
157
+ noteHashes: [new Fr(420001)],
158
+ },
159
+ revertible: {
160
+ nullifiers: [new Fr(420002)],
161
+ noteHashes: [new Fr(420003)],
162
+ },
163
+ },
164
+ );
165
+
166
+ logger.info(`Mega bulk test took ${timer.ms()}ms\n`);
167
+
168
+ return bulkResult;
169
+ }