@aztec/simulator 0.0.0-test.1 → 0.0.1-commit.5daedc8

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 (492) hide show
  1. package/README.md +6 -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 +5 -14
  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 +18 -19
  19. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  20. package/dest/private/acvm/deserialize.js +31 -23
  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 +20 -3
  25. package/dest/private/acvm/serialize.d.ts.map +1 -1
  26. package/dest/private/acvm/serialize.js +53 -0
  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 +209 -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 +6 -6
  55. package/dest/public/avm/avm_context.d.ts.map +1 -1
  56. package/dest/public/avm/avm_contract_call_result.d.ts +5 -3
  57. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  58. package/dest/public/avm/avm_contract_call_result.js +11 -7
  59. package/dest/public/avm/avm_execution_environment.d.ts +4 -2
  60. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  61. package/dest/public/avm/avm_execution_environment.js +4 -2
  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 +3 -1
  66. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  67. package/dest/public/avm/avm_machine_state.js +2 -0
  68. package/dest/public/avm/avm_memory_types.d.ts +99 -88
  69. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  70. package/dest/public/avm/avm_memory_types.js +17 -6
  71. package/dest/public/avm/avm_simulator.d.ts +6 -6
  72. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  73. package/dest/public/avm/avm_simulator.js +23 -35
  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/errors.d.ts +7 -31
  78. package/dest/public/avm/errors.d.ts.map +1 -1
  79. package/dest/public/avm/errors.js +7 -57
  80. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +6 -5
  81. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  82. package/dest/public/avm/fixtures/avm_simulation_tester.js +22 -15
  83. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts +7 -5
  84. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +1 -1
  85. package/dest/public/avm/fixtures/base_avm_simulation_tester.js +37 -14
  86. package/dest/public/avm/fixtures/initializers.d.ts +42 -0
  87. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -0
  88. package/dest/public/avm/fixtures/initializers.js +44 -0
  89. package/dest/public/avm/fixtures/utils.d.ts +38 -0
  90. package/dest/public/avm/fixtures/utils.d.ts.map +1 -0
  91. package/dest/public/avm/fixtures/utils.js +95 -0
  92. package/dest/public/avm/index.d.ts +1 -3
  93. package/dest/public/avm/index.d.ts.map +1 -1
  94. package/dest/public/avm/index.js +0 -2
  95. package/dest/public/avm/opcodes/accrued_substate.d.ts +3 -3
  96. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  97. package/dest/public/avm/opcodes/accrued_substate.js +28 -25
  98. package/dest/public/avm/opcodes/addressing_mode.d.ts +12 -8
  99. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +1 -1
  100. package/dest/public/avm/opcodes/addressing_mode.js +46 -26
  101. package/dest/public/avm/opcodes/arithmetic.d.ts +17 -7
  102. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  103. package/dest/public/avm/opcodes/arithmetic.js +16 -2
  104. package/dest/public/avm/opcodes/bitwise.d.ts +10 -18
  105. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  106. package/dest/public/avm/opcodes/bitwise.js +19 -26
  107. package/dest/public/avm/opcodes/comparators.d.ts +4 -4
  108. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  109. package/dest/public/avm/opcodes/comparators.js +3 -3
  110. package/dest/public/avm/opcodes/contract.d.ts +2 -3
  111. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  112. package/dest/public/avm/opcodes/contract.js +9 -10
  113. package/dest/public/avm/opcodes/control_flow.d.ts +1 -1
  114. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  115. package/dest/public/avm/opcodes/control_flow.js +10 -8
  116. package/dest/public/avm/opcodes/conversion.d.ts +2 -1
  117. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  118. package/dest/public/avm/opcodes/conversion.js +267 -3
  119. package/dest/public/avm/opcodes/ec_add.d.ts +2 -2
  120. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  121. package/dest/public/avm/opcodes/ec_add.js +6 -6
  122. package/dest/public/avm/opcodes/environment_getters.d.ts +3 -3
  123. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  124. package/dest/public/avm/opcodes/environment_getters.js +17 -19
  125. package/dest/public/avm/opcodes/external_calls.d.ts +9 -8
  126. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  127. package/dest/public/avm/opcodes/external_calls.js +39 -34
  128. package/dest/public/avm/opcodes/hashing.d.ts +2 -2
  129. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  130. package/dest/public/avm/opcodes/hashing.js +6 -6
  131. package/dest/public/avm/opcodes/index.d.ts +1 -1
  132. package/dest/public/avm/opcodes/instruction.d.ts +15 -11
  133. package/dest/public/avm/opcodes/instruction.d.ts.map +1 -1
  134. package/dest/public/avm/opcodes/instruction.js +23 -19
  135. package/dest/public/avm/opcodes/instruction_impl.d.ts +1 -1
  136. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +1 -1
  137. package/dest/public/avm/opcodes/memory.d.ts +6 -6
  138. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  139. package/dest/public/avm/opcodes/memory.js +37 -33
  140. package/dest/public/avm/opcodes/misc.d.ts +3 -2
  141. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  142. package/dest/public/avm/opcodes/misc.js +41 -16
  143. package/dest/public/avm/opcodes/storage.d.ts +3 -3
  144. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  145. package/dest/public/avm/opcodes/storage.js +7 -5
  146. package/dest/public/avm/revert_reason.d.ts +18 -0
  147. package/dest/public/avm/revert_reason.d.ts.map +1 -0
  148. package/dest/public/avm/revert_reason.js +38 -0
  149. package/dest/public/avm/serialization/buffer_cursor.d.ts +1 -3
  150. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +1 -1
  151. package/dest/public/avm/serialization/bytecode_serialization.d.ts +3 -7
  152. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +1 -1
  153. package/dest/public/avm/serialization/bytecode_serialization.js +70 -69
  154. package/dest/public/avm/serialization/instruction_serialization.d.ts +14 -5
  155. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  156. package/dest/public/avm/serialization/instruction_serialization.js +70 -35
  157. package/dest/public/avm/test_utils.d.ts +11 -14
  158. package/dest/public/avm/test_utils.d.ts.map +1 -1
  159. package/dest/public/avm/test_utils.js +16 -24
  160. package/dest/public/contracts_db_checkpoint.d.ts +16 -0
  161. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -0
  162. package/dest/public/contracts_db_checkpoint.js +30 -0
  163. package/dest/public/db_interfaces.d.ts +68 -0
  164. package/dest/public/db_interfaces.d.ts.map +1 -0
  165. package/dest/public/db_interfaces.js +3 -0
  166. package/dest/public/debug_fn_name.d.ts +5 -0
  167. package/dest/public/debug_fn_name.d.ts.map +1 -0
  168. package/dest/public/debug_fn_name.js +9 -0
  169. package/dest/public/executor_metrics.d.ts +12 -4
  170. package/dest/public/executor_metrics.d.ts.map +1 -1
  171. package/dest/public/executor_metrics.js +37 -6
  172. package/dest/public/executor_metrics_interface.d.ts +10 -0
  173. package/dest/public/executor_metrics_interface.d.ts.map +1 -0
  174. package/dest/public/executor_metrics_interface.js +1 -0
  175. package/dest/public/fixtures/amm_test.d.ts +10 -0
  176. package/dest/public/fixtures/amm_test.d.ts.map +1 -0
  177. package/dest/public/fixtures/amm_test.js +213 -0
  178. package/dest/public/fixtures/bulk_test.d.ts +6 -0
  179. package/dest/public/fixtures/bulk_test.d.ts.map +1 -0
  180. package/dest/public/fixtures/bulk_test.js +326 -0
  181. package/dest/public/fixtures/custom_bytecode_tester.d.ts +12 -0
  182. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -0
  183. package/dest/public/fixtures/custom_bytecode_tester.js +29 -0
  184. package/dest/public/fixtures/custom_bytecode_tests.d.ts +9 -0
  185. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -0
  186. package/dest/public/fixtures/custom_bytecode_tests.js +109 -0
  187. package/dest/public/fixtures/index.d.ts +8 -1
  188. package/dest/public/fixtures/index.d.ts.map +1 -1
  189. package/dest/public/fixtures/index.js +7 -0
  190. package/dest/public/fixtures/minimal_public_tx.d.ts +9 -0
  191. package/dest/public/fixtures/minimal_public_tx.d.ts.map +1 -0
  192. package/dest/public/fixtures/minimal_public_tx.js +29 -0
  193. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +35 -14
  194. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  195. package/dest/public/fixtures/public_tx_simulation_tester.js +100 -71
  196. package/dest/public/fixtures/simple_contract_data_source.d.ts +35 -0
  197. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -0
  198. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.js +31 -10
  199. package/dest/public/fixtures/token_test.d.ts +8 -0
  200. package/dest/public/fixtures/token_test.d.ts.map +1 -0
  201. package/dest/public/fixtures/token_test.js +94 -0
  202. package/dest/public/fixtures/utils.d.ts +17 -4
  203. package/dest/public/fixtures/utils.d.ts.map +1 -1
  204. package/dest/public/fixtures/utils.js +100 -58
  205. package/dest/public/hinting_db_sources.d.ts +78 -0
  206. package/dest/public/hinting_db_sources.d.ts.map +1 -0
  207. package/dest/public/hinting_db_sources.js +350 -0
  208. package/dest/public/index.d.ts +6 -9
  209. package/dest/public/index.d.ts.map +1 -1
  210. package/dest/public/index.js +4 -7
  211. package/dest/public/public_db_sources.d.ts +51 -101
  212. package/dest/public/public_db_sources.d.ts.map +1 -1
  213. package/dest/public/public_db_sources.js +219 -192
  214. package/dest/public/public_errors.d.ts +12 -0
  215. package/dest/public/public_errors.d.ts.map +1 -0
  216. package/dest/public/public_errors.js +13 -0
  217. package/dest/public/public_processor/guarded_merkle_tree.d.ts +49 -0
  218. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -0
  219. package/dest/public/public_processor/guarded_merkle_tree.js +108 -0
  220. package/dest/public/public_processor/public_processor.d.ts +25 -37
  221. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  222. package/dest/public/public_processor/public_processor.js +154 -111
  223. package/dest/public/public_processor/public_processor_metrics.d.ts +3 -3
  224. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  225. package/dest/public/public_processor/public_processor_metrics.js +1 -1
  226. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +30 -0
  227. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -0
  228. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +133 -0
  229. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +66 -0
  230. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -0
  231. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +210 -0
  232. package/dest/public/public_tx_simulator/index.d.ts +5 -0
  233. package/dest/public/public_tx_simulator/index.d.ts.map +1 -0
  234. package/dest/public/public_tx_simulator/index.js +2 -0
  235. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +31 -0
  236. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +1 -0
  237. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +51 -0
  238. package/dest/public/public_tx_simulator/public_tx_context.d.ts +23 -30
  239. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  240. package/dest/public/public_tx_simulator/public_tx_context.js +71 -91
  241. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +36 -58
  242. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  243. package/dest/public/public_tx_simulator/public_tx_simulator.js +208 -206
  244. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +9 -0
  245. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -0
  246. package/dest/public/public_tx_simulator/public_tx_simulator_interface.js +1 -0
  247. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +21 -0
  248. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +1 -0
  249. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +39 -0
  250. package/dest/public/side_effect_errors.d.ts +42 -2
  251. package/dest/public/side_effect_errors.d.ts.map +1 -1
  252. package/dest/public/side_effect_errors.js +70 -1
  253. package/dest/public/side_effect_trace.d.ts +21 -67
  254. package/dest/public/side_effect_trace.d.ts.map +1 -1
  255. package/dest/public/side_effect_trace.js +71 -121
  256. package/dest/public/side_effect_trace_interface.d.ts +12 -24
  257. package/dest/public/side_effect_trace_interface.d.ts.map +1 -1
  258. package/dest/public/state_manager/index.d.ts +2 -0
  259. package/dest/public/state_manager/index.d.ts.map +1 -0
  260. package/dest/public/state_manager/index.js +1 -0
  261. package/dest/public/{avm/journal → state_manager}/nullifiers.d.ts +3 -6
  262. package/dest/public/state_manager/nullifiers.d.ts.map +1 -0
  263. package/dest/public/{avm/journal → state_manager}/nullifiers.js +3 -8
  264. package/dest/public/{avm/journal → state_manager}/public_storage.d.ts +3 -3
  265. package/dest/public/state_manager/public_storage.d.ts.map +1 -0
  266. package/dest/public/state_manager/state_manager.d.ts +159 -0
  267. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  268. package/dest/public/state_manager/state_manager.js +392 -0
  269. package/dest/public/test_executor_metrics.d.ts +55 -0
  270. package/dest/public/test_executor_metrics.d.ts.map +1 -0
  271. package/dest/public/test_executor_metrics.js +307 -0
  272. package/dest/public/unique_class_ids.d.ts +1 -1
  273. package/dest/public/unique_class_ids.d.ts.map +1 -1
  274. package/dest/public/utils.d.ts +3 -5
  275. package/dest/public/utils.d.ts.map +1 -1
  276. package/dest/public/utils.js +4 -21
  277. package/dest/server.d.ts +7 -4
  278. package/dest/server.d.ts.map +1 -1
  279. package/dest/server.js +5 -2
  280. package/dest/testing.d.ts +2 -0
  281. package/dest/testing.d.ts.map +1 -0
  282. package/dest/testing.js +1 -0
  283. package/package.json +39 -33
  284. package/src/client.ts +5 -3
  285. package/src/common/errors.ts +79 -44
  286. package/src/common/index.ts +0 -1
  287. package/src/private/acvm/acvm.ts +17 -32
  288. package/src/private/acvm/acvm_types.ts +1 -1
  289. package/src/private/acvm/deserialize.ts +35 -29
  290. package/src/private/acvm/index.ts +0 -1
  291. package/src/private/acvm/serialize.ts +63 -0
  292. package/src/private/{providers/acvm_native.ts → acvm_native.ts} +47 -24
  293. package/src/private/acvm_wasm.ts +72 -0
  294. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  295. package/src/private/circuit_recording/circuit_recorder.ts +260 -0
  296. package/src/private/circuit_recording/file_circuit_recorder.ts +158 -0
  297. package/src/private/circuit_recording/memory_circuit_recorder.ts +11 -0
  298. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +91 -0
  299. package/src/private/circuit_simulator.ts +90 -0
  300. package/src/private/{providers/factory.ts → factory.ts} +6 -6
  301. package/src/public/avm/avm_context.ts +4 -4
  302. package/src/public/avm/avm_contract_call_result.ts +17 -5
  303. package/src/public/avm/avm_execution_environment.ts +8 -1
  304. package/src/public/avm/avm_gas.ts +23 -35
  305. package/src/public/avm/avm_machine_state.ts +5 -0
  306. package/src/public/avm/avm_memory_types.ts +19 -6
  307. package/src/public/avm/avm_simulator.ts +43 -54
  308. package/src/public/avm/avm_simulator_interface.ts +8 -0
  309. package/src/public/avm/errors.ts +8 -77
  310. package/src/public/avm/fixtures/avm_simulation_tester.ts +32 -21
  311. package/src/public/avm/fixtures/base_avm_simulation_tester.ts +45 -12
  312. package/src/public/avm/fixtures/initializers.ts +102 -0
  313. package/src/public/avm/fixtures/utils.ts +150 -0
  314. package/src/public/avm/index.ts +0 -2
  315. package/src/public/avm/opcodes/accrued_substate.ts +64 -29
  316. package/src/public/avm/opcodes/addressing_mode.ts +56 -32
  317. package/src/public/avm/opcodes/arithmetic.ts +24 -2
  318. package/src/public/avm/opcodes/bitwise.ts +33 -29
  319. package/src/public/avm/opcodes/comparators.ts +6 -3
  320. package/src/public/avm/opcodes/contract.ts +10 -7
  321. package/src/public/avm/opcodes/control_flow.ts +19 -10
  322. package/src/public/avm/opcodes/conversion.ts +27 -3
  323. package/src/public/avm/opcodes/ec_add.ts +9 -6
  324. package/src/public/avm/opcodes/environment_getters.ts +27 -22
  325. package/src/public/avm/opcodes/external_calls.ts +61 -29
  326. package/src/public/avm/opcodes/hashing.ts +28 -8
  327. package/src/public/avm/opcodes/instruction.ts +31 -21
  328. package/src/public/avm/opcodes/memory.ts +71 -32
  329. package/src/public/avm/opcodes/misc.ts +60 -18
  330. package/src/public/avm/opcodes/storage.ts +22 -6
  331. package/src/public/avm/revert_reason.ts +55 -0
  332. package/src/public/avm/serialization/buffer_cursor.ts +4 -1
  333. package/src/public/avm/serialization/bytecode_serialization.ts +72 -74
  334. package/src/public/avm/serialization/instruction_serialization.ts +75 -34
  335. package/src/public/avm/test_utils.ts +24 -41
  336. package/src/public/contracts_db_checkpoint.ts +41 -0
  337. package/src/public/db_interfaces.ts +76 -0
  338. package/src/{common → public}/debug_fn_name.ts +7 -7
  339. package/src/public/executor_metrics.ts +56 -6
  340. package/src/public/executor_metrics_interface.ts +15 -0
  341. package/src/public/fixtures/amm_test.ts +331 -0
  342. package/src/public/fixtures/bulk_test.ts +169 -0
  343. package/src/public/fixtures/custom_bytecode_tester.ts +49 -0
  344. package/src/public/fixtures/custom_bytecode_tests.ts +135 -0
  345. package/src/public/fixtures/index.ts +7 -0
  346. package/src/public/fixtures/minimal_public_tx.ts +35 -0
  347. package/src/public/fixtures/public_tx_simulation_tester.ts +166 -113
  348. package/src/public/{avm/fixtures → fixtures}/simple_contract_data_source.ts +36 -18
  349. package/src/public/fixtures/token_test.ts +139 -0
  350. package/src/public/fixtures/utils.ts +141 -68
  351. package/src/public/hinting_db_sources.ts +602 -0
  352. package/src/public/index.ts +5 -8
  353. package/src/public/public_db_sources.ts +278 -258
  354. package/src/public/public_errors.ts +14 -0
  355. package/src/public/public_processor/guarded_merkle_tree.ts +153 -0
  356. package/src/public/public_processor/public_processor.ts +212 -164
  357. package/src/public/public_processor/public_processor_metrics.ts +2 -2
  358. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +162 -0
  359. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +306 -0
  360. package/src/public/public_tx_simulator/index.ts +4 -0
  361. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +105 -0
  362. package/src/public/public_tx_simulator/public_tx_context.ts +167 -194
  363. package/src/public/public_tx_simulator/public_tx_simulator.ts +292 -265
  364. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +10 -0
  365. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +63 -0
  366. package/src/public/side_effect_errors.ts +91 -1
  367. package/src/public/side_effect_trace.ts +94 -320
  368. package/src/public/side_effect_trace_interface.ts +10 -58
  369. package/src/public/state_manager/index.ts +1 -0
  370. package/src/public/{avm/journal → state_manager}/nullifiers.ts +5 -11
  371. package/src/public/{avm/journal → state_manager}/public_storage.ts +2 -2
  372. package/src/public/state_manager/state_manager.ts +553 -0
  373. package/src/public/test_executor_metrics.ts +397 -0
  374. package/src/public/utils.ts +5 -21
  375. package/src/server.ts +6 -3
  376. package/src/testing.ts +1 -0
  377. package/dest/common/db_interfaces.d.ts +0 -80
  378. package/dest/common/db_interfaces.d.ts.map +0 -1
  379. package/dest/common/db_interfaces.js +0 -1
  380. package/dest/common/debug_fn_name.d.ts +0 -5
  381. package/dest/common/debug_fn_name.d.ts.map +0 -1
  382. package/dest/common/debug_fn_name.js +0 -6
  383. package/dest/common/message_load_oracle_inputs.d.ts +0 -15
  384. package/dest/common/message_load_oracle_inputs.d.ts.map +0 -1
  385. package/dest/common/message_load_oracle_inputs.js +0 -15
  386. package/dest/private/acvm/oracle/index.d.ts +0 -14
  387. package/dest/private/acvm/oracle/index.d.ts.map +0 -1
  388. package/dest/private/acvm/oracle/index.js +0 -2
  389. package/dest/private/acvm/oracle/oracle.d.ts +0 -49
  390. package/dest/private/acvm/oracle/oracle.d.ts.map +0 -1
  391. package/dest/private/acvm/oracle/oracle.js +0 -263
  392. package/dest/private/acvm/oracle/typed_oracle.d.ts +0 -83
  393. package/dest/private/acvm/oracle/typed_oracle.d.ts.map +0 -1
  394. package/dest/private/acvm/oracle/typed_oracle.js +0 -132
  395. package/dest/private/execution_data_provider.d.ts +0 -261
  396. package/dest/private/execution_data_provider.d.ts.map +0 -1
  397. package/dest/private/execution_data_provider.js +0 -14
  398. package/dest/private/execution_note_cache.d.ts +0 -93
  399. package/dest/private/execution_note_cache.d.ts.map +0 -1
  400. package/dest/private/execution_note_cache.js +0 -180
  401. package/dest/private/hashed_values_cache.d.ts +0 -28
  402. package/dest/private/hashed_values_cache.d.ts.map +0 -1
  403. package/dest/private/hashed_values_cache.js +0 -46
  404. package/dest/private/index.d.ts +0 -13
  405. package/dest/private/index.d.ts.map +0 -1
  406. package/dest/private/index.js +0 -12
  407. package/dest/private/pick_notes.d.ts +0 -85
  408. package/dest/private/pick_notes.d.ts.map +0 -1
  409. package/dest/private/pick_notes.js +0 -51
  410. package/dest/private/private_execution.d.ts +0 -25
  411. package/dest/private/private_execution.d.ts.map +0 -1
  412. package/dest/private/private_execution.js +0 -92
  413. package/dest/private/private_execution_oracle.d.ts +0 -215
  414. package/dest/private/private_execution_oracle.d.ts.map +0 -1
  415. package/dest/private/private_execution_oracle.js +0 -382
  416. package/dest/private/providers/acvm_native.d.ts +0 -40
  417. package/dest/private/providers/acvm_native.d.ts.map +0 -1
  418. package/dest/private/providers/acvm_wasm.d.ts +0 -15
  419. package/dest/private/providers/acvm_wasm.d.ts.map +0 -1
  420. package/dest/private/providers/acvm_wasm_with_blobs.d.ts +0 -19
  421. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  422. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  423. package/dest/private/providers/factory.d.ts +0 -12
  424. package/dest/private/providers/factory.d.ts.map +0 -1
  425. package/dest/private/providers/simulation_provider.d.ts +0 -19
  426. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  427. package/dest/private/providers/simulation_provider.js +0 -24
  428. package/dest/private/simulator.d.ts +0 -34
  429. package/dest/private/simulator.d.ts.map +0 -1
  430. package/dest/private/simulator.js +0 -76
  431. package/dest/private/unconstrained_execution.d.ts +0 -10
  432. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  433. package/dest/private/unconstrained_execution.js +0 -27
  434. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  435. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  436. package/dest/private/unconstrained_execution_oracle.js +0 -258
  437. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  438. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  439. package/dest/public/avm/bytecode_utils.js +0 -17
  440. package/dest/public/avm/fixtures/index.d.ts +0 -84
  441. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  442. package/dest/public/avm/fixtures/index.js +0 -175
  443. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts +0 -35
  444. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  445. package/dest/public/avm/journal/index.d.ts +0 -2
  446. package/dest/public/avm/journal/index.d.ts.map +0 -1
  447. package/dest/public/avm/journal/index.js +0 -1
  448. package/dest/public/avm/journal/journal.d.ts +0 -209
  449. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  450. package/dest/public/avm/journal/journal.js +0 -486
  451. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  452. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  453. package/dest/public/bytecode_errors.d.ts +0 -4
  454. package/dest/public/bytecode_errors.d.ts.map +0 -1
  455. package/dest/public/bytecode_errors.js +0 -6
  456. package/dest/public/execution.d.ts +0 -108
  457. package/dest/public/execution.d.ts.map +0 -1
  458. package/dest/public/execution.js +0 -9
  459. package/dest/public/tx_contract_cache.d.ts +0 -41
  460. package/dest/public/tx_contract_cache.d.ts.map +0 -1
  461. package/dest/public/tx_contract_cache.js +0 -49
  462. package/dest/test/utils.d.ts +0 -13
  463. package/dest/test/utils.d.ts.map +0 -1
  464. package/dest/test/utils.js +0 -22
  465. package/src/common/db_interfaces.ts +0 -94
  466. package/src/common/message_load_oracle_inputs.ts +0 -15
  467. package/src/private/acvm/oracle/index.ts +0 -16
  468. package/src/private/acvm/oracle/oracle.ts +0 -455
  469. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  470. package/src/private/execution_data_provider.ts +0 -323
  471. package/src/private/execution_note_cache.ts +0 -217
  472. package/src/private/hashed_values_cache.ts +0 -55
  473. package/src/private/index.ts +0 -16
  474. package/src/private/pick_notes.ts +0 -141
  475. package/src/private/private_execution.ts +0 -151
  476. package/src/private/private_execution_oracle.ts +0 -614
  477. package/src/private/providers/acvm_wasm.ts +0 -63
  478. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  479. package/src/private/providers/simulation_provider.ts +0 -45
  480. package/src/private/simulator.ts +0 -147
  481. package/src/private/unconstrained_execution.ts +0 -50
  482. package/src/private/unconstrained_execution_oracle.ts +0 -373
  483. package/src/public/avm/bytecode_utils.ts +0 -17
  484. package/src/public/avm/fixtures/index.ts +0 -296
  485. package/src/public/avm/journal/index.ts +0 -1
  486. package/src/public/avm/journal/journal.ts +0 -742
  487. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  488. package/src/public/bytecode_errors.ts +0 -6
  489. package/src/public/execution.ts +0 -140
  490. package/src/public/tx_contract_cache.ts +0 -69
  491. package/src/test/utils.ts +0 -36
  492. /package/dest/public/{avm/journal → state_manager}/public_storage.js +0 -0
@@ -1,50 +0,0 @@
1
- import { foreignCallHandler } from '@aztec/noir-protocol-circuits-types/server';
2
- import type { NoirCompiledCircuit } from '@aztec/stdlib/noir';
3
-
4
- import { type ExecutionError, executeCircuit } from '@noir-lang/acvm_js';
5
- import type { WitnessMap } from '@noir-lang/types';
6
-
7
- import type { ACIRCallback, ACIRExecutionResult } from '../acvm/acvm.js';
8
- import type { ACVMWitness } from '../acvm/acvm_types.js';
9
- import { type SimulationProvider, parseErrorPayload } from './simulation_provider.js';
10
-
11
- /**
12
- * A simulation provider that uses the WASM simulator with the ability to handle blobs via the foreign call handler.
13
- * This class is temporary while brillig cannot handle the blob math, and it is kept separate
14
- * because the zkg commitment library used in the blob code is not browser compatible.
15
- *
16
- * It is only used in the context of server-side code executing simulated protocol circuits.
17
- */
18
- export class WASMSimulatorWithBlobs implements SimulationProvider {
19
- async executeProtocolCircuit(input: WitnessMap, compiledCircuit: NoirCompiledCircuit): Promise<WitnessMap> {
20
- // Execute the circuit on those initial witness values
21
- //
22
- // Decode the bytecode from base64 since the acvm does not know about base64 encoding
23
- const decodedBytecode = Buffer.from(compiledCircuit.bytecode, 'base64');
24
- //
25
- // Execute the circuit
26
- try {
27
- const _witnessMap = await executeCircuit(
28
- decodedBytecode,
29
- input,
30
- foreignCallHandler, // handle calls to debug_log and evaluate_blobs mock
31
- );
32
-
33
- return _witnessMap;
34
- } catch (err) {
35
- // Typescript types catched errors as unknown or any, so we need to narrow its type to check if it has raw assertion payload.
36
- if (typeof err === 'object' && err !== null && 'rawAssertionPayload' in err) {
37
- throw parseErrorPayload(compiledCircuit.abi, err as ExecutionError);
38
- }
39
- throw new Error(`Circuit execution failed: ${err}`);
40
- }
41
- }
42
-
43
- executeUserCircuit(
44
- _acir: Buffer,
45
- _initialWitness: ACVMWitness,
46
- _callback: ACIRCallback,
47
- ): Promise<ACIRExecutionResult> {
48
- throw new Error('Not implemented');
49
- }
50
- }
@@ -1,45 +0,0 @@
1
- import type { NoirCompiledCircuit } from '@aztec/stdlib/noir';
2
-
3
- import type { ExecutionError } from '@noir-lang/acvm_js';
4
- import { abiDecodeError } from '@noir-lang/noirc_abi';
5
- import type { Abi, WitnessMap } from '@noir-lang/types';
6
-
7
- import type { ACIRCallback, ACIRExecutionResult } from '../acvm/acvm.js';
8
- import type { ACVMWitness } from '../acvm/acvm_types.js';
9
-
10
- /**
11
- * Low level simulation interface
12
- */
13
- export interface SimulationProvider {
14
- executeProtocolCircuit(input: WitnessMap, compiledCircuit: NoirCompiledCircuit): Promise<WitnessMap>;
15
- executeUserCircuit(acir: Buffer, initialWitness: ACVMWitness, callback: ACIRCallback): Promise<ACIRExecutionResult>;
16
- }
17
-
18
- export type ErrorWithPayload = ExecutionError & { decodedAssertionPayload?: any };
19
-
20
- // Error handling taken from noir/noir-repo/tooling/noir_js/src/witness_generation.ts.
21
- // TODO: import this in isolation without having to import noir_js in its entirety.
22
- export function parseErrorPayload(abi: Abi, originalError: ExecutionError): Error {
23
- const payload = originalError.rawAssertionPayload;
24
- if (!payload) {
25
- return originalError;
26
- }
27
- const enrichedError = originalError as ErrorWithPayload;
28
-
29
- try {
30
- // Decode the payload
31
- const decodedPayload = abiDecodeError(abi, payload);
32
-
33
- if (typeof decodedPayload === 'string') {
34
- // If it's a string, just add it to the error message
35
- enrichedError.message = `Circuit execution failed: ${decodedPayload}`;
36
- } else {
37
- // If not, attach the payload to the original error
38
- enrichedError.decodedAssertionPayload = decodedPayload;
39
- }
40
- } catch (_errorDecoding) {
41
- // Ignore errors decoding the payload
42
- }
43
-
44
- return enrichedError;
45
- }
@@ -1,147 +0,0 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
- import { type Logger, createLogger } from '@aztec/foundation/log';
3
- import type { FunctionCall } from '@aztec/stdlib/abi';
4
- import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
5
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
6
- import { CallContext, PrivateExecutionResult, TxExecutionRequest } from '@aztec/stdlib/tx';
7
-
8
- import { createSimulationError } from '../common/errors.js';
9
- import type { ExecutionDataProvider } from './execution_data_provider.js';
10
- import { ExecutionNoteCache } from './execution_note_cache.js';
11
- import { HashedValuesCache } from './hashed_values_cache.js';
12
- import { executePrivateFunction, verifyCurrentClassId } from './private_execution.js';
13
- import { PrivateExecutionOracle } from './private_execution_oracle.js';
14
- import type { SimulationProvider } from './providers/simulation_provider.js';
15
- import { executeUnconstrainedFunction } from './unconstrained_execution.js';
16
- import { UnconstrainedExecutionOracle } from './unconstrained_execution_oracle.js';
17
-
18
- /**
19
- * The ACIR simulator.
20
- */
21
- export class AcirSimulator {
22
- private log: Logger;
23
-
24
- constructor(private executionDataProvider: ExecutionDataProvider, private simulationProvider: SimulationProvider) {
25
- this.log = createLogger('simulator');
26
- }
27
-
28
- /**
29
- * Runs a private function.
30
- * @param request - The transaction request.
31
- * @param entryPointArtifact - The artifact of the entry point function.
32
- * @param contractAddress - The address of the contract (should match request.origin)
33
- * @param msgSender - The address calling the function. This can be replaced to simulate a call from another contract or a specific account.
34
- * @param scopes - The accounts whose notes we can access in this call. Currently optional and will default to all.
35
- * @returns The result of the execution.
36
- */
37
- public async run(
38
- request: TxExecutionRequest,
39
- contractAddress: AztecAddress,
40
- selector: FunctionSelector,
41
- msgSender = AztecAddress.fromField(Fr.MAX_FIELD_VALUE),
42
- scopes?: AztecAddress[],
43
- ): Promise<PrivateExecutionResult> {
44
- const header = await this.executionDataProvider.getBlockHeader();
45
-
46
- await verifyCurrentClassId(contractAddress, this.executionDataProvider);
47
- const entryPointArtifact = await this.executionDataProvider.getFunctionArtifact(contractAddress, selector);
48
-
49
- if (entryPointArtifact.functionType !== FunctionType.PRIVATE) {
50
- throw new Error(`Cannot run ${entryPointArtifact.functionType} function as private`);
51
- }
52
-
53
- if (request.origin !== contractAddress) {
54
- this.log.warn(
55
- `Request origin does not match contract address in simulation. Request origin: ${request.origin}, contract address: ${contractAddress}`,
56
- );
57
- }
58
-
59
- // reserve the first side effect for the tx hash (inserted by the private kernel)
60
- const startSideEffectCounter = 1;
61
-
62
- const callContext = new CallContext(
63
- msgSender,
64
- contractAddress,
65
- await FunctionSelector.fromNameAndParameters(entryPointArtifact.name, entryPointArtifact.parameters),
66
- entryPointArtifact.isStatic,
67
- );
68
-
69
- const txRequestHash = await request.toTxRequest().hash();
70
- const noteCache = new ExecutionNoteCache(txRequestHash);
71
-
72
- const context = new PrivateExecutionOracle(
73
- request.firstCallArgsHash,
74
- request.txContext,
75
- callContext,
76
- header,
77
- request.authWitnesses,
78
- request.capsules,
79
- HashedValuesCache.create(request.argsOfCalls),
80
- noteCache,
81
- this.executionDataProvider,
82
- this.simulationProvider,
83
- /*totalPublicArgsCount=*/ 0,
84
- startSideEffectCounter,
85
- undefined,
86
- scopes,
87
- );
88
-
89
- try {
90
- const executionResult = await executePrivateFunction(
91
- this.simulationProvider,
92
- context,
93
- entryPointArtifact,
94
- contractAddress,
95
- request.functionSelector,
96
- );
97
- const { usedTxRequestHashForNonces } = noteCache.finish();
98
- const firstNullifierHint = usedTxRequestHashForNonces ? Fr.ZERO : noteCache.getAllNullifiers()[0];
99
- return new PrivateExecutionResult(executionResult, firstNullifierHint);
100
- } catch (err) {
101
- throw createSimulationError(err instanceof Error ? err : new Error('Unknown error during private execution'));
102
- }
103
- }
104
-
105
- /**
106
- * Runs an unconstrained function.
107
- * @param request - The transaction request.
108
- * @param entryPointArtifact - The artifact of the entry point function.
109
- * @param contractAddress - The address of the contract.
110
- * @param scopes - The accounts whose notes we can access in this call. Currently optional and will default to all.
111
- */
112
- public async runUnconstrained(
113
- request: FunctionCall,
114
- contractAddress: AztecAddress,
115
- selector: FunctionSelector,
116
- scopes?: AztecAddress[],
117
- ) {
118
- await verifyCurrentClassId(contractAddress, this.executionDataProvider);
119
- const entryPointArtifact = await this.executionDataProvider.getFunctionArtifact(contractAddress, selector);
120
-
121
- if (entryPointArtifact.functionType !== FunctionType.UNCONSTRAINED) {
122
- throw new Error(`Cannot run ${entryPointArtifact.functionType} function as unconstrained`);
123
- }
124
-
125
- const context = new UnconstrainedExecutionOracle(
126
- contractAddress,
127
- [],
128
- [],
129
- this.executionDataProvider,
130
- undefined,
131
- scopes,
132
- );
133
-
134
- try {
135
- return await executeUnconstrainedFunction(
136
- this.simulationProvider,
137
- context,
138
- entryPointArtifact,
139
- contractAddress,
140
- request.selector,
141
- request.args,
142
- );
143
- } catch (err) {
144
- throw createSimulationError(err instanceof Error ? err : new Error('Unknown error during private execution'));
145
- }
146
- }
147
- }
@@ -1,50 +0,0 @@
1
- import type { Fr } from '@aztec/foundation/fields';
2
- import { createLogger } from '@aztec/foundation/log';
3
- import { type AbiDecoded, type FunctionArtifact, type FunctionSelector, decodeFromAbi } from '@aztec/stdlib/abi';
4
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
5
-
6
- import { ExecutionError, resolveAssertionMessageFromError } from '../common/errors.js';
7
- import { witnessMapToFields } from './acvm/deserialize.js';
8
- import { Oracle, extractCallStack, toACVMWitness } from './acvm/index.js';
9
- import type { SimulationProvider } from './providers/simulation_provider.js';
10
- import type { UnconstrainedExecutionOracle } from './unconstrained_execution_oracle.js';
11
-
12
- // docs:start:execute_unconstrained_function
13
- /**
14
- * Execute an unconstrained function and return the decoded values.
15
- */
16
- export async function executeUnconstrainedFunction(
17
- simulatorProvider: SimulationProvider,
18
- oracle: UnconstrainedExecutionOracle,
19
- artifact: FunctionArtifact,
20
- contractAddress: AztecAddress,
21
- functionSelector: FunctionSelector,
22
- args: Fr[],
23
- log = createLogger('simulator:unconstrained_execution'),
24
- ): Promise<AbiDecoded> {
25
- log.verbose(`Executing unconstrained function ${artifact.name}`, {
26
- contract: contractAddress,
27
- selector: functionSelector,
28
- });
29
-
30
- const acir = artifact.bytecode;
31
- const initialWitness = toACVMWitness(0, args);
32
- const acirExecutionResult = await simulatorProvider
33
- .executeUserCircuit(acir, initialWitness, new Oracle(oracle))
34
- .catch((err: Error) => {
35
- err.message = resolveAssertionMessageFromError(err, artifact);
36
- throw new ExecutionError(
37
- err.message,
38
- {
39
- contractAddress,
40
- functionSelector,
41
- },
42
- extractCallStack(err, artifact.debug),
43
- { cause: err },
44
- );
45
- });
46
-
47
- const returnWitness = witnessMapToFields(acirExecutionResult.returnWitness);
48
- return decodeFromAbi(artifact.returnTypes, returnWitness);
49
- }
50
- // docs:end:execute_unconstrained_function
@@ -1,373 +0,0 @@
1
- import { Aes128 } from '@aztec/foundation/crypto';
2
- import { Fr } from '@aztec/foundation/fields';
3
- import { applyStringFormatting, createLogger } from '@aztec/foundation/log';
4
- import type { AuthWitness } from '@aztec/stdlib/auth-witness';
5
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
6
- import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
7
- import { siloNullifier } from '@aztec/stdlib/hash';
8
- import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
9
- import { IndexedTaggingSecret, LogWithTxData } from '@aztec/stdlib/logs';
10
- import type { NoteStatus } from '@aztec/stdlib/note';
11
- import { type MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
12
- import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
13
-
14
- import { type NoteData, TypedOracle } from './acvm/index.js';
15
- import type { ExecutionDataProvider } from './execution_data_provider.js';
16
- import { pickNotes } from './pick_notes.js';
17
-
18
- /**
19
- * The oracle for an unconstrained function execution.
20
- */
21
- export class UnconstrainedExecutionOracle extends TypedOracle {
22
- constructor(
23
- protected readonly contractAddress: AztecAddress,
24
- /** List of transient auth witnesses to be used during this simulation */
25
- protected readonly authWitnesses: AuthWitness[],
26
- protected readonly capsules: Capsule[],
27
- protected readonly executionDataProvider: ExecutionDataProvider,
28
- protected log = createLogger('simulator:client_view_context'),
29
- protected readonly scopes?: AztecAddress[],
30
- ) {
31
- super();
32
- }
33
-
34
- public override getBlockNumber(): Promise<number> {
35
- return this.executionDataProvider.getBlockNumber();
36
- }
37
-
38
- public override getContractAddress(): Promise<AztecAddress> {
39
- return Promise.resolve(this.contractAddress);
40
- }
41
-
42
- public override getChainId(): Promise<Fr> {
43
- return Promise.resolve(this.executionDataProvider.getChainId().then(id => new Fr(id)));
44
- }
45
-
46
- public override getVersion(): Promise<Fr> {
47
- return Promise.resolve(this.executionDataProvider.getVersion().then(v => new Fr(v)));
48
- }
49
-
50
- /**
51
- * Retrieve keys associated with a specific master public key and app address.
52
- * @param pkMHash - The master public key hash.
53
- * @returns A Promise that resolves to nullifier keys.
54
- * @throws If the keys are not registered in the key store.
55
- */
56
- public override getKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
57
- return this.executionDataProvider.getKeyValidationRequest(pkMHash, this.contractAddress);
58
- }
59
-
60
- /**
61
- * Fetches the index and sibling path of a leaf at a given block from a given tree.
62
- * @param blockNumber - The block number at which to get the membership witness.
63
- * @param treeId - Id of the tree to get the sibling path from.
64
- * @param leafValue - The leaf value
65
- * @returns The index and sibling path concatenated [index, sibling_path]
66
- */
67
- public override getMembershipWitness(blockNumber: number, treeId: MerkleTreeId, leafValue: Fr): Promise<Fr[]> {
68
- return this.executionDataProvider.getMembershipWitness(blockNumber, treeId, leafValue);
69
- }
70
-
71
- /**
72
- * Returns a nullifier membership witness for a given nullifier at a given block.
73
- * @param blockNumber - The block number at which to get the index.
74
- * @param nullifier - Nullifier we try to find witness for.
75
- * @returns The nullifier membership witness (if found).
76
- */
77
- public override async getNullifierMembershipWitness(
78
- blockNumber: number,
79
- nullifier: Fr,
80
- ): Promise<NullifierMembershipWitness | undefined> {
81
- return await this.executionDataProvider.getNullifierMembershipWitness(blockNumber, nullifier);
82
- }
83
-
84
- /**
85
- * Returns a low nullifier membership witness for a given nullifier at a given block.
86
- * @param blockNumber - The block number at which to get the index.
87
- * @param nullifier - Nullifier we try to find the low nullifier witness for.
88
- * @returns The low nullifier membership witness (if found).
89
- * @remarks Low nullifier witness can be used to perform a nullifier non-inclusion proof by leveraging the "linked
90
- * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
91
- * we are trying to prove non-inclusion for.
92
- */
93
- public override async getLowNullifierMembershipWitness(
94
- blockNumber: number,
95
- nullifier: Fr,
96
- ): Promise<NullifierMembershipWitness | undefined> {
97
- return await this.executionDataProvider.getLowNullifierMembershipWitness(blockNumber, nullifier);
98
- }
99
-
100
- /**
101
- * Returns a public data tree witness for a given leaf slot at a given block.
102
- * @param blockNumber - The block number at which to get the index.
103
- * @param leafSlot - The slot of the public data tree to get the witness for.
104
- * @returns - The witness
105
- */
106
- public override async getPublicDataTreeWitness(
107
- blockNumber: number,
108
- leafSlot: Fr,
109
- ): Promise<PublicDataWitness | undefined> {
110
- return await this.executionDataProvider.getPublicDataTreeWitness(blockNumber, leafSlot);
111
- }
112
-
113
- /**
114
- * Fetches a block header of a given block.
115
- * @param blockNumber - The number of a block of which to get the block header.
116
- * @returns Block extracted from a block with block number `blockNumber`.
117
- */
118
- public override async getBlockHeader(blockNumber: number): Promise<BlockHeader | undefined> {
119
- const block = await this.executionDataProvider.getBlock(blockNumber);
120
- if (!block) {
121
- return undefined;
122
- }
123
- return block.header;
124
- }
125
-
126
- /**
127
- * Retrieve the complete address associated to a given address.
128
- * @param account - The account address.
129
- * @returns A complete address associated with the input address.
130
- * @throws An error if the account is not registered in the database.
131
- */
132
- public override getCompleteAddress(account: AztecAddress): Promise<CompleteAddress> {
133
- return this.executionDataProvider.getCompleteAddress(account);
134
- }
135
-
136
- /**
137
- * Returns a contract instance associated with an address or throws if not found.
138
- * @param address - Address.
139
- * @returns A contract instance.
140
- */
141
- public override getContractInstance(address: AztecAddress): Promise<ContractInstance> {
142
- return this.executionDataProvider.getContractInstance(address);
143
- }
144
-
145
- /**
146
- * Returns an auth witness for the given message hash. Checks on the list of transient witnesses
147
- * for this transaction first, and falls back to the local database if not found.
148
- * @param messageHash - Hash of the message to authenticate.
149
- * @returns Authentication witness for the requested message hash.
150
- */
151
- public override getAuthWitness(messageHash: Fr): Promise<Fr[] | undefined> {
152
- return Promise.resolve(
153
- this.authWitnesses.find(w => w.requestHash.equals(messageHash))?.witness ??
154
- this.executionDataProvider.getAuthWitness(messageHash),
155
- );
156
- }
157
-
158
- /**
159
- * Gets some notes for a contract address and storage slot.
160
- * Returns a flattened array containing filtered notes.
161
- *
162
- * @remarks
163
- * Check for pending notes with matching slot.
164
- * Real notes coming from DB will have a leafIndex which
165
- * represents their index in the note hash tree.
166
- *
167
- * @param storageSlot - The storage slot.
168
- * @param numSelects - The number of valid selects in selectBy and selectValues.
169
- * @param selectBy - An array of indices of the fields to selects.
170
- * @param selectValues - The values to match.
171
- * @param selectComparators - The comparators to use to match values.
172
- * @param sortBy - An array of indices of the fields to sort.
173
- * @param sortOrder - The order of the corresponding index in sortBy. (1: DESC, 2: ASC, 0: Do nothing)
174
- * @param limit - The number of notes to retrieve per query.
175
- * @param offset - The starting index for pagination.
176
- * @param status - The status of notes to fetch.
177
- * @returns Array of note data.
178
- */
179
- public override async getNotes(
180
- storageSlot: Fr,
181
- numSelects: number,
182
- selectByIndexes: number[],
183
- selectByOffsets: number[],
184
- selectByLengths: number[],
185
- selectValues: Fr[],
186
- selectComparators: number[],
187
- sortByIndexes: number[],
188
- sortByOffsets: number[],
189
- sortByLengths: number[],
190
- sortOrder: number[],
191
- limit: number,
192
- offset: number,
193
- status: NoteStatus,
194
- ): Promise<NoteData[]> {
195
- const dbNotes = await this.executionDataProvider.getNotes(this.contractAddress, storageSlot, status, this.scopes);
196
- return pickNotes<NoteData>(dbNotes, {
197
- selects: selectByIndexes.slice(0, numSelects).map((index, i) => ({
198
- selector: { index, offset: selectByOffsets[i], length: selectByLengths[i] },
199
- value: selectValues[i],
200
- comparator: selectComparators[i],
201
- })),
202
- sorts: sortByIndexes.map((index, i) => ({
203
- selector: { index, offset: sortByOffsets[i], length: sortByLengths[i] },
204
- order: sortOrder[i],
205
- })),
206
- limit,
207
- offset,
208
- });
209
- }
210
-
211
- /**
212
- * Check if a nullifier exists in the nullifier tree.
213
- * @param innerNullifier - The inner nullifier.
214
- * @returns A boolean indicating whether the nullifier exists in the tree or not.
215
- */
216
- public override async checkNullifierExists(innerNullifier: Fr) {
217
- const nullifier = await siloNullifier(this.contractAddress, innerNullifier!);
218
- const index = await this.executionDataProvider.getNullifierIndex(nullifier);
219
- return index !== undefined;
220
- }
221
-
222
- /**
223
- * Fetches a message from the executionDataProvider, given its key.
224
- * @param contractAddress - Address of a contract by which the message was emitted.
225
- * @param messageHash - Hash of the message.
226
- * @param secret - Secret used to compute a nullifier.
227
- * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
228
- * @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
229
- */
230
- public override async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) {
231
- return await this.executionDataProvider.getL1ToL2MembershipWitness(contractAddress, messageHash, secret);
232
- }
233
-
234
- /**
235
- * Read the public storage data.
236
- * @param contractAddress - The address to read storage from.
237
- * @param startStorageSlot - The starting storage slot.
238
- * @param blockNumber - The block number to read storage at.
239
- * @param numberOfElements - Number of elements to read from the starting storage slot.
240
- */
241
- public override async storageRead(
242
- contractAddress: AztecAddress,
243
- startStorageSlot: Fr,
244
- blockNumber: number,
245
- numberOfElements: number,
246
- ) {
247
- const values = [];
248
- for (let i = 0n; i < numberOfElements; i++) {
249
- const storageSlot = new Fr(startStorageSlot.value + i);
250
- const value = await this.executionDataProvider.getPublicStorageAt(blockNumber, contractAddress, storageSlot);
251
-
252
- this.log.debug(
253
- `Oracle storage read: slot=${storageSlot.toString()} address-${contractAddress.toString()} value=${value}`,
254
- );
255
- values.push(value);
256
- }
257
- return values;
258
- }
259
-
260
- public override debugLog(message: string, fields: Fr[]): void {
261
- // TODO(#10558) Remove this check once the debug log is fixed
262
- if (message.startsWith('Context.note_hashes, after pushing new note hash:')) {
263
- return;
264
- }
265
- this.log.verbose(`${applyStringFormatting(message, fields)}`, { module: `${this.log.module}:debug_log` });
266
- }
267
-
268
- /**
269
- * Returns the tagging secret for a given sender and recipient pair, siloed to the current contract address.
270
- * Includes the next index to be used used for tagging with this secret.
271
- * For this to work, the ivsk_m of the sender must be known.
272
- * @param sender - The address sending the note
273
- * @param recipient - The address receiving the note
274
- * @returns A tagging secret that can be used to tag notes.
275
- */
276
- public override async getIndexedTaggingSecretAsSender(
277
- sender: AztecAddress,
278
- recipient: AztecAddress,
279
- ): Promise<IndexedTaggingSecret> {
280
- return await this.executionDataProvider.getIndexedTaggingSecretAsSender(this.contractAddress, sender, recipient);
281
- }
282
-
283
- public override async syncNotes() {
284
- const taggedLogsByRecipient = await this.executionDataProvider.syncTaggedLogs(
285
- this.contractAddress,
286
- await this.executionDataProvider.getBlockNumber(),
287
- this.scopes,
288
- );
289
-
290
- for (const [recipient, taggedLogs] of taggedLogsByRecipient.entries()) {
291
- await this.executionDataProvider.processTaggedLogs(taggedLogs, AztecAddress.fromString(recipient));
292
- }
293
-
294
- await this.executionDataProvider.removeNullifiedNotes(this.contractAddress);
295
- }
296
-
297
- public override async deliverNote(
298
- contractAddress: AztecAddress,
299
- storageSlot: Fr,
300
- nonce: Fr,
301
- content: Fr[],
302
- noteHash: Fr,
303
- nullifier: Fr,
304
- txHash: Fr,
305
- recipient: AztecAddress,
306
- ) {
307
- // TODO(#10727): allow other contracts to deliver notes
308
- if (!this.contractAddress.equals(contractAddress)) {
309
- throw new Error(`Got a note delivery request from ${contractAddress}, expected ${this.contractAddress}`);
310
- }
311
-
312
- await this.executionDataProvider.deliverNote(
313
- contractAddress,
314
- storageSlot,
315
- nonce,
316
- content,
317
- noteHash,
318
- nullifier,
319
- txHash,
320
- recipient,
321
- );
322
- }
323
-
324
- public override getLogByTag(tag: Fr): Promise<LogWithTxData | null> {
325
- return this.executionDataProvider.getLogByTag(tag);
326
- }
327
-
328
- public override storeCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void> {
329
- if (!contractAddress.equals(this.contractAddress)) {
330
- // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
331
- throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
332
- }
333
- return this.executionDataProvider.storeCapsule(this.contractAddress, slot, capsule);
334
- }
335
-
336
- public override async loadCapsule(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null> {
337
- if (!contractAddress.equals(this.contractAddress)) {
338
- // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
339
- throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
340
- }
341
- return (
342
- this.capsules.find(c => c.contractAddress.equals(contractAddress) && c.storageSlot.equals(slot))?.data ??
343
- (await this.executionDataProvider.loadCapsule(this.contractAddress, slot))
344
- );
345
- }
346
-
347
- public override deleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void> {
348
- if (!contractAddress.equals(this.contractAddress)) {
349
- // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
350
- throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
351
- }
352
- return this.executionDataProvider.deleteCapsule(this.contractAddress, slot);
353
- }
354
-
355
- public override copyCapsule(
356
- contractAddress: AztecAddress,
357
- srcSlot: Fr,
358
- dstSlot: Fr,
359
- numEntries: number,
360
- ): Promise<void> {
361
- if (!contractAddress.equals(this.contractAddress)) {
362
- // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
363
- throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
364
- }
365
- return this.executionDataProvider.copyCapsule(this.contractAddress, srcSlot, dstSlot, numEntries);
366
- }
367
-
368
- // TODO(#11849): consider replacing this oracle with a pure Noir implementation of aes decryption.
369
- public override aes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer> {
370
- const aes128 = new Aes128();
371
- return aes128.decryptBufferCBC(ciphertext, iv, symKey);
372
- }
373
- }
@@ -1,17 +0,0 @@
1
- import { Opcode } from './serialization/instruction_serialization.js';
2
-
3
- const AVM_MAGIC_SUFFIX = Buffer.from([
4
- Opcode.MOV_16, // opcode
5
- 0x00, // indirect
6
- ...Buffer.from('18ca', 'hex'), // srcOffset
7
- ...Buffer.from('18ca', 'hex'), // dstOffset
8
- ]);
9
-
10
- export function markBytecodeAsAvm(bytecode: Buffer): Buffer {
11
- return Buffer.concat([bytecode, AVM_MAGIC_SUFFIX]);
12
- }
13
-
14
- export function isAvmBytecode(bytecode: Buffer): boolean {
15
- const magicSize = AVM_MAGIC_SUFFIX.length;
16
- return bytecode.subarray(-magicSize).equals(AVM_MAGIC_SUFFIX);
17
- }