@aztec/simulator 0.0.0-test.1 → 0.0.1-commit.0b941701

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 (527) 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 +12 -6
  14. package/dest/private/acvm/acvm.d.ts.map +1 -1
  15. package/dest/private/acvm/acvm.js +10 -16
  16. package/dest/private/acvm/acvm_types.d.ts +2 -2
  17. package/dest/private/acvm/acvm_types.d.ts.map +1 -1
  18. package/dest/private/acvm/deserialize.d.ts +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 +39 -0
  28. package/dest/private/acvm_native.d.ts.map +1 -0
  29. package/dest/private/{providers/acvm_native.js → acvm_native.js} +26 -20
  30. package/dest/private/acvm_wasm.d.ts +15 -0
  31. package/dest/private/acvm_wasm.d.ts.map +1 -0
  32. package/dest/private/{providers/acvm_wasm.js → acvm_wasm.js} +22 -19
  33. package/dest/private/acvm_wasm_with_blobs.d.ts +20 -0
  34. package/dest/private/acvm_wasm_with_blobs.d.ts.map +1 -0
  35. package/dest/private/acvm_wasm_with_blobs.js +35 -0
  36. package/dest/private/circuit_recording/circuit_recorder.d.ts +108 -0
  37. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -0
  38. package/dest/private/circuit_recording/circuit_recorder.js +210 -0
  39. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +31 -0
  40. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -0
  41. package/dest/private/circuit_recording/file_circuit_recorder.js +135 -0
  42. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +5 -0
  43. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -0
  44. package/dest/private/circuit_recording/memory_circuit_recorder.js +9 -0
  45. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +21 -0
  46. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -0
  47. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +44 -0
  48. package/dest/private/circuit_simulator.d.ts +35 -0
  49. package/dest/private/circuit_simulator.d.ts.map +1 -0
  50. package/dest/private/circuit_simulator.js +43 -0
  51. package/dest/private/factory.d.ts +12 -0
  52. package/dest/private/factory.d.ts.map +1 -0
  53. package/dest/private/{providers/factory.js → factory.js} +2 -2
  54. package/dest/public/avm/avm_context.d.ts +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 +16 -16
  99. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  100. package/dest/public/avm/opcodes/accrued_substate.js +52 -45
  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 +29 -24
  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 +123 -0
  198. package/dest/public/fixtures/opcode_spammer.d.ts.map +1 -0
  199. package/dest/public/fixtures/opcode_spammer.js +1693 -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 +52 -102
  225. package/dest/public/public_db_sources.d.ts.map +1 -1
  226. package/dest/public/public_db_sources.js +220 -193
  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 +26 -38
  234. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  235. package/dest/public/public_processor/public_processor.js +573 -136
  236. package/dest/public/public_processor/public_processor_metrics.d.ts +3 -3
  237. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  238. package/dest/public/public_processor/public_processor_metrics.js +13 -46
  239. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +18 -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 +22 -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 +13 -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 +24 -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 +72 -92
  266. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +37 -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 +217 -206
  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 +22 -67
  279. package/dest/public/side_effect_trace.d.ts.map +1 -1
  280. package/dest/public/side_effect_trace.js +72 -122
  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 +164 -0
  293. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  294. package/dest/public/state_manager/state_manager.js +395 -0
  295. package/dest/public/test_executor_metrics.d.ts +55 -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 +17 -32
  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} +47 -24
  319. package/src/private/acvm_wasm.ts +72 -0
  320. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  321. package/src/private/circuit_recording/circuit_recorder.ts +261 -0
  322. package/src/private/circuit_recording/file_circuit_recorder.ts +158 -0
  323. package/src/private/circuit_recording/memory_circuit_recorder.ts +11 -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} +6 -6
  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 +74 -33
  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 +47 -24
  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 +1754 -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 +279 -259
  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 +243 -178
  388. package/src/public/public_processor/public_processor_metrics.ts +13 -47
  389. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +121 -0
  390. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +208 -0
  391. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +132 -0
  392. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +237 -0
  393. package/src/public/public_tx_simulator/dumping_cpp_public_tx_simulator.ts +81 -0
  394. package/src/public/public_tx_simulator/factories.ts +41 -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 +168 -195
  398. package/src/public/public_tx_simulator/public_tx_simulator.ts +310 -261
  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 +95 -321
  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 +546 -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_with_blobs.d.ts +0 -19
  456. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  457. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  458. package/dest/private/providers/factory.d.ts +0 -12
  459. package/dest/private/providers/factory.d.ts.map +0 -1
  460. package/dest/private/providers/simulation_provider.d.ts +0 -19
  461. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  462. package/dest/private/providers/simulation_provider.js +0 -24
  463. package/dest/private/simulator.d.ts +0 -34
  464. package/dest/private/simulator.d.ts.map +0 -1
  465. package/dest/private/simulator.js +0 -76
  466. package/dest/private/unconstrained_execution.d.ts +0 -10
  467. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  468. package/dest/private/unconstrained_execution.js +0 -27
  469. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  470. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  471. package/dest/private/unconstrained_execution_oracle.js +0 -258
  472. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  473. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  474. package/dest/public/avm/bytecode_utils.js +0 -17
  475. package/dest/public/avm/fixtures/index.d.ts +0 -84
  476. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  477. package/dest/public/avm/fixtures/index.js +0 -175
  478. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts +0 -35
  479. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  480. package/dest/public/avm/journal/index.d.ts +0 -2
  481. package/dest/public/avm/journal/index.d.ts.map +0 -1
  482. package/dest/public/avm/journal/index.js +0 -1
  483. package/dest/public/avm/journal/journal.d.ts +0 -209
  484. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  485. package/dest/public/avm/journal/journal.js +0 -486
  486. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  487. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  488. package/dest/public/bytecode_errors.d.ts +0 -4
  489. package/dest/public/bytecode_errors.d.ts.map +0 -1
  490. package/dest/public/bytecode_errors.js +0 -6
  491. package/dest/public/execution.d.ts +0 -108
  492. package/dest/public/execution.d.ts.map +0 -1
  493. package/dest/public/execution.js +0 -9
  494. package/dest/public/tx_contract_cache.d.ts +0 -41
  495. package/dest/public/tx_contract_cache.d.ts.map +0 -1
  496. package/dest/public/tx_contract_cache.js +0 -49
  497. package/dest/test/utils.d.ts +0 -13
  498. package/dest/test/utils.d.ts.map +0 -1
  499. package/dest/test/utils.js +0 -22
  500. package/src/common/db_interfaces.ts +0 -94
  501. package/src/common/debug_fn_name.ts +0 -18
  502. package/src/common/message_load_oracle_inputs.ts +0 -15
  503. package/src/private/acvm/oracle/index.ts +0 -16
  504. package/src/private/acvm/oracle/oracle.ts +0 -455
  505. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  506. package/src/private/execution_data_provider.ts +0 -323
  507. package/src/private/execution_note_cache.ts +0 -217
  508. package/src/private/hashed_values_cache.ts +0 -55
  509. package/src/private/index.ts +0 -16
  510. package/src/private/pick_notes.ts +0 -141
  511. package/src/private/private_execution.ts +0 -151
  512. package/src/private/private_execution_oracle.ts +0 -614
  513. package/src/private/providers/acvm_wasm.ts +0 -63
  514. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  515. package/src/private/providers/simulation_provider.ts +0 -45
  516. package/src/private/simulator.ts +0 -147
  517. package/src/private/unconstrained_execution.ts +0 -50
  518. package/src/private/unconstrained_execution_oracle.ts +0 -373
  519. package/src/public/avm/bytecode_utils.ts +0 -17
  520. package/src/public/avm/fixtures/index.ts +0 -296
  521. package/src/public/avm/journal/index.ts +0 -1
  522. package/src/public/avm/journal/journal.ts +0 -742
  523. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  524. package/src/public/bytecode_errors.ts +0 -6
  525. package/src/public/execution.ts +0 -140
  526. package/src/public/tx_contract_cache.ts +0 -69
  527. 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,66 @@ import {
5
7
  type TelemetryClient,
6
8
  type Tracer,
7
9
  type UpDownCounter,
8
- ValueType,
9
10
  } from '@aztec/telemetry-client';
10
11
 
11
- export class ExecutorMetrics {
12
+ import type { ExecutorMetricsInterface } from './executor_metrics_interface.js';
13
+
14
+ export class ExecutorMetrics implements ExecutorMetricsInterface {
12
15
  public readonly tracer: Tracer;
13
16
  private fnCount: UpDownCounter;
14
17
  private fnDuration: Histogram;
15
18
  private manaPerSecond: Histogram;
19
+ private manaUsed: Histogram;
20
+ private totalInstructionsExecuted: Histogram;
21
+ private txHashing: Histogram;
16
22
  private privateEffectsInsertions: Histogram;
17
23
 
18
24
  constructor(client: TelemetryClient, name = 'PublicExecutor') {
19
25
  this.tracer = client.getTracer(name);
20
26
  const meter = client.getMeter(name);
21
27
 
22
- this.fnCount = meter.createUpDownCounter(Metrics.PUBLIC_EXECUTOR_SIMULATION_COUNT, {
23
- description: 'Number of functions executed',
24
- });
28
+ this.fnCount = meter.createUpDownCounter(Metrics.PUBLIC_EXECUTOR_SIMULATION_COUNT);
25
29
 
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
- });
30
+ this.fnDuration = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_DURATION);
31
31
 
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
- });
32
+ this.manaPerSecond = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_MANA_PER_SECOND);
37
33
 
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
- });
34
+ this.manaUsed = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_MANA_USED);
35
+
36
+ this.totalInstructionsExecuted = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_SIMULATION_TOTAL_INSTRUCTIONS);
37
+
38
+ this.txHashing = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_TX_HASHING);
39
+
40
+ this.privateEffectsInsertions = meter.createHistogram(Metrics.PUBLIC_EXECUTOR_PRIVATE_EFFECTS_INSERTION);
41
+ }
42
+
43
+ startRecordingTxSimulation(_txLabel: string) {
44
+ // do nothing (unimplemented)
45
+ }
46
+
47
+ stopRecordingTxSimulation(_txLabel: string, _gasUsed?: GasUsed, _revertedCode?: RevertCode) {
48
+ // do nothing (unimplemented)
43
49
  }
44
50
 
45
- recordFunctionSimulation(durationMs: number, manaUsed: number, fnName: string) {
51
+ recordEnqueuedCallSimulation(
52
+ fnName: string,
53
+ durationMs: number,
54
+ manaUsed: number,
55
+ totalInstructionsExecuted: number,
56
+ ) {
46
57
  this.fnCount.add(1, {
47
58
  [Attributes.OK]: true,
48
59
  [Attributes.APP_CIRCUIT_NAME]: fnName,
49
- [Attributes.MANA_USED]: manaUsed,
50
60
  });
51
- this.fnDuration.record(Math.ceil(durationMs));
61
+ this.manaUsed.record(Math.ceil(manaUsed), {
62
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
63
+ });
64
+ this.totalInstructionsExecuted.record(Math.ceil(totalInstructionsExecuted), {
65
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
66
+ });
67
+ this.fnDuration.record(Math.ceil(durationMs), {
68
+ [Attributes.APP_CIRCUIT_NAME]: fnName,
69
+ });
52
70
  if (durationMs > 0 && manaUsed > 0) {
53
71
  const manaPerSecond = Math.round((manaUsed * 1000) / durationMs);
54
72
  this.manaPerSecond.record(manaPerSecond, {
@@ -57,7 +75,12 @@ export class ExecutorMetrics {
57
75
  }
58
76
  }
59
77
 
60
- recordFunctionSimulationFailure() {
78
+ recordEnqueuedCallSimulationFailure(
79
+ _fnName: string,
80
+ _durationMs: number,
81
+ _manaUsed: number,
82
+ _totalInstructionsExecuted: number,
83
+ ) {
61
84
  this.fnCount.add(1, {
62
85
  [Attributes.OK]: false,
63
86
  });
@@ -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
+ }