@aztec/simulator 0.0.1-commit.3469e52 → 0.0.1-commit.350e0a4d

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 (352) hide show
  1. package/README.md +4 -4
  2. package/dest/client.d.ts +1 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +0 -2
  5. package/dest/private/acvm/acvm.d.ts +4 -2
  6. package/dest/private/acvm/acvm.d.ts.map +1 -1
  7. package/dest/private/acvm/acvm.js +4 -3
  8. package/dest/private/acvm_native.d.ts +5 -3
  9. package/dest/private/acvm_native.d.ts.map +1 -1
  10. package/dest/private/acvm_native.js +8 -6
  11. package/dest/private/acvm_wasm.d.ts +4 -3
  12. package/dest/private/acvm_wasm.d.ts.map +1 -1
  13. package/dest/private/acvm_wasm.js +7 -5
  14. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  15. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  16. package/dest/private/circuit_recording/circuit_recorder.js +70 -72
  17. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  18. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  19. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  20. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  21. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  22. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  23. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  24. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  25. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  26. package/dest/private/factory.d.ts +3 -3
  27. package/dest/private/factory.d.ts.map +1 -1
  28. package/dest/private/factory.js +7 -4
  29. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  30. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  31. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  32. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +2 -1
  33. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  34. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +18 -3
  35. package/dest/public/avm/testing/utils.d.ts +32 -0
  36. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  37. package/dest/public/avm/{fixtures → testing}/utils.js +4 -34
  38. package/dest/public/contracts_db_checkpoint.d.ts +2 -2
  39. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  40. package/dest/public/contracts_db_checkpoint.js +1 -1
  41. package/dest/public/executor_metrics.d.ts +1 -1
  42. package/dest/public/executor_metrics.d.ts.map +1 -1
  43. package/dest/public/executor_metrics.js +7 -2
  44. package/dest/public/fixtures/amm_test.js +4 -4
  45. package/dest/public/fixtures/bulk_test.d.ts +1 -1
  46. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  47. package/dest/public/fixtures/bulk_test.js +33 -6
  48. package/dest/public/fixtures/custom_bytecode_tester.d.ts +1 -1
  49. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  50. package/dest/public/fixtures/custom_bytecode_tester.js +2 -2
  51. package/dest/public/fixtures/index.d.ts +1 -4
  52. package/dest/public/fixtures/index.d.ts.map +1 -1
  53. package/dest/public/fixtures/index.js +0 -3
  54. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +8 -7
  55. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  56. package/dest/public/fixtures/public_tx_simulation_tester.js +17 -16
  57. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  58. package/dest/public/fixtures/token_test.js +3 -3
  59. package/dest/public/fixtures/utils.d.ts +2 -2
  60. package/dest/public/fixtures/utils.d.ts.map +1 -1
  61. package/dest/public/fixtures/utils.js +21 -20
  62. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +6 -4
  63. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -1
  64. package/dest/public/fuzzing/avm_fuzzer_simulator.js +12 -7
  65. package/dest/public/fuzzing/avm_simulator_bin.js +11 -8
  66. package/dest/public/index.d.ts +2 -2
  67. package/dest/public/index.d.ts.map +1 -1
  68. package/dest/public/index.js +1 -1
  69. package/dest/public/public_db_sources.d.ts +9 -5
  70. package/dest/public/public_db_sources.d.ts.map +1 -1
  71. package/dest/public/public_db_sources.js +20 -14
  72. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -7
  73. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  74. package/dest/public/public_processor/guarded_merkle_tree.js +8 -5
  75. package/dest/public/public_processor/public_processor.d.ts +11 -6
  76. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  77. package/dest/public/public_processor/public_processor.js +112 -74
  78. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  79. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  80. package/dest/public/public_processor/public_processor_metrics.js +28 -4
  81. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +3 -2
  82. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -1
  83. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +7 -6
  84. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +23 -0
  85. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  86. package/dest/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.js → dumping_public_tx_simulator.js} +4 -4
  87. package/dest/public/public_tx_simulator/factories.d.ts +7 -6
  88. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -1
  89. package/dest/public/public_tx_simulator/factories.js +8 -8
  90. package/dest/public/public_tx_simulator/index.d.ts +3 -5
  91. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  92. package/dest/public/public_tx_simulator/index.js +2 -4
  93. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +42 -70
  94. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  95. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -317
  96. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +22 -0
  97. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  98. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +28 -0
  99. package/dest/public/test_executor_metrics.d.ts +3 -2
  100. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  101. package/dest/public/test_executor_metrics.js +2 -2
  102. package/package.json +17 -18
  103. package/src/client.ts +0 -2
  104. package/src/private/acvm/acvm.ts +4 -3
  105. package/src/private/acvm_native.ts +11 -5
  106. package/src/private/acvm_wasm.ts +11 -4
  107. package/src/private/circuit_recording/circuit_recorder.ts +89 -81
  108. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  109. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  110. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  111. package/src/private/factory.ts +7 -4
  112. package/src/public/avm/testing/account_proof.json +553 -0
  113. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  114. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +23 -3
  115. package/src/public/avm/{fixtures → testing}/utils.ts +4 -40
  116. package/src/public/contracts_db_checkpoint.ts +1 -1
  117. package/src/public/executor_metrics.ts +4 -1
  118. package/src/public/fixtures/amm_test.ts +4 -4
  119. package/src/public/fixtures/bulk_test.ts +31 -6
  120. package/src/public/fixtures/custom_bytecode_tester.ts +2 -2
  121. package/src/public/fixtures/index.ts +0 -3
  122. package/src/public/fixtures/public_tx_simulation_tester.ts +28 -14
  123. package/src/public/fixtures/simple_contract_data_source.ts +1 -1
  124. package/src/public/fixtures/token_test.ts +3 -3
  125. package/src/public/fixtures/utils.ts +23 -24
  126. package/src/public/fuzzing/avm_fuzzer_simulator.ts +16 -19
  127. package/src/public/fuzzing/avm_simulator_bin.ts +14 -6
  128. package/src/public/index.ts +3 -3
  129. package/src/public/public_db_sources.ts +36 -19
  130. package/src/public/public_processor/guarded_merkle_tree.ts +11 -8
  131. package/src/public/public_processor/public_processor.ts +156 -94
  132. package/src/public/public_processor/public_processor_metrics.ts +22 -4
  133. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +11 -7
  134. package/src/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.ts → dumping_public_tx_simulator.ts} +5 -3
  135. package/src/public/public_tx_simulator/factories.ts +10 -7
  136. package/src/public/public_tx_simulator/index.ts +2 -4
  137. package/src/public/public_tx_simulator/public_tx_simulator.ts +153 -470
  138. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +35 -0
  139. package/src/public/test_executor_metrics.ts +3 -3
  140. package/dest/public/avm/avm_context.d.ts +0 -41
  141. package/dest/public/avm/avm_context.d.ts.map +0 -1
  142. package/dest/public/avm/avm_context.js +0 -44
  143. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  144. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  145. package/dest/public/avm/avm_contract_call_result.js +0 -54
  146. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  147. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  148. package/dest/public/avm/avm_execution_environment.js +0 -33
  149. package/dest/public/avm/avm_gas.d.ts +0 -44
  150. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  151. package/dest/public/avm/avm_gas.js +0 -195
  152. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  153. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  154. package/dest/public/avm/avm_machine_state.js +0 -109
  155. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  156. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  157. package/dest/public/avm/avm_memory_types.js +0 -351
  158. package/dest/public/avm/avm_simulator.d.ts +0 -40
  159. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  160. package/dest/public/avm/avm_simulator.js +0 -191
  161. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  162. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  163. package/dest/public/avm/avm_simulator_interface.js +0 -3
  164. package/dest/public/avm/errors.d.ts +0 -104
  165. package/dest/public/avm/errors.d.ts.map +0 -1
  166. package/dest/public/avm/errors.js +0 -141
  167. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  168. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  169. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -83
  170. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  171. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  172. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  173. package/dest/public/avm/fixtures/initializers.js +0 -44
  174. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  175. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  176. package/dest/public/avm/index.d.ts +0 -2
  177. package/dest/public/avm/index.d.ts.map +0 -1
  178. package/dest/public/avm/index.js +0 -1
  179. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  180. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  181. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  182. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  183. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  184. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  185. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -49
  186. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  187. package/dest/public/avm/opcodes/arithmetic.js +0 -97
  188. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  189. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  190. package/dest/public/avm/opcodes/bitwise.js +0 -99
  191. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  192. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  193. package/dest/public/avm/opcodes/comparators.js +0 -43
  194. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  195. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  196. package/dest/public/avm/opcodes/contract.js +0 -65
  197. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  198. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  199. package/dest/public/avm/opcodes/control_flow.js +0 -107
  200. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  201. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  202. package/dest/public/avm/opcodes/conversion.js +0 -333
  203. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  204. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  205. package/dest/public/avm/opcodes/ec_add.js +0 -93
  206. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  207. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  208. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  209. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  210. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  211. package/dest/public/avm/opcodes/external_calls.js +0 -210
  212. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  213. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  214. package/dest/public/avm/opcodes/hashing.js +0 -119
  215. package/dest/public/avm/opcodes/index.d.ts +0 -16
  216. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  217. package/dest/public/avm/opcodes/index.js +0 -15
  218. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  219. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  220. package/dest/public/avm/opcodes/instruction.js +0 -95
  221. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  222. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  223. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  224. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  225. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  226. package/dest/public/avm/opcodes/memory.js +0 -257
  227. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  228. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  229. package/dest/public/avm/opcodes/misc.js +0 -73
  230. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  231. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  232. package/dest/public/avm/opcodes/storage.js +0 -68
  233. package/dest/public/avm/revert_reason.d.ts +0 -18
  234. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  235. package/dest/public/avm/revert_reason.js +0 -39
  236. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  237. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  238. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  239. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  240. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  241. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  242. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  243. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  244. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  245. package/dest/public/avm/test_utils.d.ts +0 -15
  246. package/dest/public/avm/test_utils.d.ts.map +0 -1
  247. package/dest/public/avm/test_utils.js +0 -44
  248. package/dest/public/debug_fn_name.d.ts +0 -18
  249. package/dest/public/debug_fn_name.d.ts.map +0 -1
  250. package/dest/public/debug_fn_name.js +0 -35
  251. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -12
  252. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  253. package/dest/public/fixtures/custom_bytecode_tests.js +0 -174
  254. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -4
  255. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  256. package/dest/public/fixtures/minimal_public_tx.js +0 -19
  257. package/dest/public/fixtures/opcode_spammer.d.ts +0 -123
  258. package/dest/public/fixtures/opcode_spammer.d.ts.map +0 -1
  259. package/dest/public/fixtures/opcode_spammer.js +0 -1681
  260. package/dest/public/hinting_db_sources.d.ts +0 -80
  261. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  262. package/dest/public/hinting_db_sources.js +0 -355
  263. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -53
  264. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  265. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -132
  266. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  267. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  268. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  269. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  270. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  271. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -171
  272. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +0 -22
  273. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +0 -1
  274. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  275. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  276. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  277. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -130
  278. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  279. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  280. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  281. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  282. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -415
  283. package/dest/public/side_effect_trace.d.ts +0 -87
  284. package/dest/public/side_effect_trace.d.ts.map +0 -1
  285. package/dest/public/side_effect_trace.js +0 -199
  286. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  287. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  288. package/dest/public/side_effect_trace_interface.js +0 -1
  289. package/dest/public/state_manager/index.d.ts +0 -2
  290. package/dest/public/state_manager/index.d.ts.map +0 -1
  291. package/dest/public/state_manager/index.js +0 -1
  292. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  293. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  294. package/dest/public/state_manager/nullifiers.js +0 -92
  295. package/dest/public/state_manager/public_storage.d.ts +0 -66
  296. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  297. package/dest/public/state_manager/public_storage.js +0 -145
  298. package/dest/public/state_manager/state_manager.d.ts +0 -164
  299. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  300. package/dest/public/state_manager/state_manager.js +0 -395
  301. package/src/public/avm/avm_context.ts +0 -61
  302. package/src/public/avm/avm_contract_call_result.ts +0 -67
  303. package/src/public/avm/avm_execution_environment.ts +0 -46
  304. package/src/public/avm/avm_gas.ts +0 -183
  305. package/src/public/avm/avm_machine_state.ts +0 -169
  306. package/src/public/avm/avm_memory_types.ts +0 -436
  307. package/src/public/avm/avm_simulator.ts +0 -276
  308. package/src/public/avm/avm_simulator_interface.ts +0 -8
  309. package/src/public/avm/errors.ts +0 -177
  310. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -116
  311. package/src/public/avm/fixtures/initializers.ts +0 -102
  312. package/src/public/avm/index.ts +0 -1
  313. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  314. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  315. package/src/public/avm/opcodes/arithmetic.ts +0 -129
  316. package/src/public/avm/opcodes/bitwise.ts +0 -113
  317. package/src/public/avm/opcodes/comparators.ts +0 -55
  318. package/src/public/avm/opcodes/contract.ts +0 -75
  319. package/src/public/avm/opcodes/control_flow.ts +0 -123
  320. package/src/public/avm/opcodes/conversion.ts +0 -104
  321. package/src/public/avm/opcodes/ec_add.ts +0 -105
  322. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  323. package/src/public/avm/opcodes/external_calls.ts +0 -261
  324. package/src/public/avm/opcodes/hashing.ts +0 -151
  325. package/src/public/avm/opcodes/index.ts +0 -15
  326. package/src/public/avm/opcodes/instruction.ts +0 -136
  327. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  328. package/src/public/avm/opcodes/memory.ts +0 -293
  329. package/src/public/avm/opcodes/misc.ts +0 -102
  330. package/src/public/avm/opcodes/storage.ts +0 -87
  331. package/src/public/avm/revert_reason.ts +0 -58
  332. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  333. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  334. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  335. package/src/public/avm/test_utils.ts +0 -64
  336. package/src/public/debug_fn_name.ts +0 -50
  337. package/src/public/fixtures/custom_bytecode_tests.ts +0 -228
  338. package/src/public/fixtures/minimal_public_tx.ts +0 -26
  339. package/src/public/fixtures/opcode_spammer.ts +0 -1725
  340. package/src/public/hinting_db_sources.ts +0 -607
  341. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -208
  342. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -132
  343. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -237
  344. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  345. package/src/public/public_tx_simulator/public_tx_context.ts +0 -477
  346. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  347. package/src/public/side_effect_trace.ts +0 -290
  348. package/src/public/side_effect_trace_interface.ts +0 -28
  349. package/src/public/state_manager/index.ts +0 -1
  350. package/src/public/state_manager/nullifiers.ts +0 -103
  351. package/src/public/state_manager/public_storage.ts +0 -174
  352. package/src/public/state_manager/state_manager.ts +0 -546
@@ -1,607 +0,0 @@
1
- import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import { sha256Trunc } from '@aztec/foundation/crypto/sha256';
3
- import { Fr } from '@aztec/foundation/curves/bn254';
4
- import { type Logger, createLogger } from '@aztec/foundation/log';
5
- import type { IndexedTreeLeafPreimage, SiblingPath } from '@aztec/foundation/trees';
6
- import type { FunctionSelector } from '@aztec/stdlib/abi';
7
- import {
8
- AvmAppendLeavesHint,
9
- AvmBytecodeCommitmentHint,
10
- AvmCommitCheckpointHint,
11
- AvmContractClassHint,
12
- AvmContractDbCommitCheckpointHint,
13
- AvmContractDbCreateCheckpointHint,
14
- AvmContractDbRevertCheckpointHint,
15
- AvmContractInstanceHint,
16
- AvmCreateCheckpointHint,
17
- AvmDebugFunctionNameHint,
18
- type AvmExecutionHints,
19
- AvmGetLeafPreimageHintNullifierTree,
20
- AvmGetLeafPreimageHintPublicDataTree,
21
- AvmGetLeafValueHint,
22
- AvmGetPreviousValueIndexHint,
23
- AvmGetSiblingPathHint,
24
- AvmRevertCheckpointHint,
25
- AvmSequentialInsertHintNullifierTree,
26
- AvmSequentialInsertHintPublicDataTree,
27
- } from '@aztec/stdlib/avm';
28
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
29
- import type { ContractClassPublic, ContractInstanceWithAddress } from '@aztec/stdlib/contract';
30
- import {
31
- AppendOnlyTreeSnapshot,
32
- type BatchInsertionResult,
33
- type IndexedTreeId,
34
- MerkleTreeId,
35
- type MerkleTreeLeafType,
36
- type MerkleTreeWriteOperations,
37
- NullifierLeaf,
38
- NullifierLeafPreimage,
39
- PublicDataTreeLeaf,
40
- PublicDataTreeLeafPreimage,
41
- type SequentialInsertionResult,
42
- type TreeHeights,
43
- getTreeName,
44
- merkleTreeIds,
45
- } from '@aztec/stdlib/trees';
46
- import { TreeSnapshots } from '@aztec/stdlib/tx';
47
- import type { UInt64 } from '@aztec/stdlib/types';
48
- import type { WorldStateRevision } from '@aztec/stdlib/world-state';
49
-
50
- import { strict as assert } from 'assert';
51
-
52
- import type { PublicContractsDBInterface } from './db_interfaces.js';
53
-
54
- /**
55
- * A public contracts database that forwards requests and collects AVM hints.
56
- */
57
- export class HintingPublicContractsDB implements PublicContractsDBInterface {
58
- private static readonly log: Logger = createLogger('simulator:hinting-public-contracts-db');
59
-
60
- private checkpointActionCounter: number = 0;
61
- private nextCheckpointId: number = 1;
62
- private checkpointStack: number[] = [0];
63
-
64
- constructor(
65
- private readonly db: PublicContractsDBInterface,
66
- private hints: AvmExecutionHints,
67
- ) {}
68
-
69
- public async getContractInstance(
70
- address: AztecAddress,
71
- timestamp: UInt64,
72
- ): Promise<ContractInstanceWithAddress | undefined> {
73
- const instance = await this.db.getContractInstance(address, timestamp);
74
- if (instance) {
75
- const hintKey = this.getHintKey();
76
-
77
- this.hints.contractInstances.push(
78
- new AvmContractInstanceHint(
79
- hintKey,
80
- instance.address,
81
- instance.salt,
82
- instance.deployer,
83
- instance.currentContractClassId,
84
- instance.originalContractClassId,
85
- instance.initializationHash,
86
- instance.publicKeys,
87
- ),
88
- );
89
-
90
- HintingPublicContractsDB.log.trace(
91
- `[getContractInstance:${hintKey}] Added contract instance ${instance.address.toString()} to hints.`,
92
- );
93
- }
94
- return instance;
95
- }
96
-
97
- public async getContractClass(contractClassId: Fr): Promise<ContractClassPublic | undefined> {
98
- const contractClass = await this.db.getContractClass(contractClassId);
99
- if (contractClass) {
100
- const hintKey = this.getHintKey();
101
- this.hints.contractClasses.push(
102
- new AvmContractClassHint(
103
- hintKey,
104
- contractClass.id,
105
- contractClass.artifactHash,
106
- contractClass.privateFunctionsRoot,
107
- contractClass.packedBytecode,
108
- ),
109
- );
110
-
111
- HintingPublicContractsDB.log.trace(
112
- `[getContractClass:${hintKey}] Added contract class ${contractClassId.toString()} to hints.`,
113
- );
114
- }
115
- return contractClass;
116
- }
117
-
118
- public async getBytecodeCommitment(contractClassId: Fr): Promise<Fr | undefined> {
119
- const commitment = await this.db.getBytecodeCommitment(contractClassId);
120
- if (commitment) {
121
- const hintKey = this.getHintKey();
122
- this.hints.bytecodeCommitments.push(new AvmBytecodeCommitmentHint(hintKey, contractClassId, commitment));
123
-
124
- HintingPublicContractsDB.log.trace(
125
- `[getBytecodeCommitment:${hintKey}] Added bytecode commitment ${commitment.toString()} to hints for contract class ${contractClassId.toString()}.`,
126
- );
127
- }
128
- return commitment;
129
- }
130
-
131
- public async getDebugFunctionName(
132
- contractAddress: AztecAddress,
133
- selector: FunctionSelector,
134
- ): Promise<string | undefined> {
135
- const name = await this.db.getDebugFunctionName(contractAddress, selector);
136
- if (name) {
137
- HintingPublicContractsDB.log.debug(
138
- `[getDebugFunctionName] Adding debug function name ${name} to hints for contract ${contractAddress.toString()} and selector ${selector.toString()}.`,
139
- );
140
- // We hint selector as a field to make things way simpler in C++.
141
- this.hints.debugFunctionNames.push(new AvmDebugFunctionNameHint(contractAddress, selector.toField(), name));
142
- }
143
- return name;
144
- }
145
-
146
- public createCheckpoint(): void {
147
- const hintKey = this.getHintKey();
148
- this.checkpointActionCounter++;
149
- const oldCheckpointId = this.getCurrentCheckpointId();
150
-
151
- this.db.createCheckpoint();
152
-
153
- const newCheckpointId = this.nextCheckpointId++;
154
- this.checkpointStack.push(newCheckpointId);
155
-
156
- this.hints.contractDbCreateCheckpointHints.push(
157
- new AvmContractDbCreateCheckpointHint(hintKey, oldCheckpointId, newCheckpointId),
158
- );
159
-
160
- HintingPublicContractsDB.log.trace(
161
- `[createCheckpoint:${hintKey}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId}.`,
162
- );
163
- }
164
-
165
- public commitCheckpoint(): void {
166
- const hintKey = this.getHintKey();
167
- this.checkpointActionCounter++;
168
- const oldCheckpointId = this.getCurrentCheckpointId();
169
-
170
- this.db.commitCheckpoint();
171
-
172
- this.checkpointStack.pop();
173
- const newCheckpointId = this.getCurrentCheckpointId();
174
-
175
- this.hints.contractDbCommitCheckpointHints.push(
176
- new AvmContractDbCommitCheckpointHint(hintKey, oldCheckpointId, newCheckpointId),
177
- );
178
-
179
- HintingPublicContractsDB.log.trace(
180
- `[commitCheckpoint:${hintKey}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId}.`,
181
- );
182
- }
183
-
184
- public revertCheckpoint(): void {
185
- const hintKey = this.getHintKey();
186
- this.checkpointActionCounter++;
187
- const oldCheckpointId = this.getCurrentCheckpointId();
188
-
189
- this.db.revertCheckpoint();
190
-
191
- this.checkpointStack.pop();
192
- const newCheckpointId = this.getCurrentCheckpointId();
193
-
194
- this.hints.contractDbRevertCheckpointHints.push(
195
- new AvmContractDbRevertCheckpointHint(hintKey, oldCheckpointId, newCheckpointId),
196
- );
197
-
198
- HintingPublicContractsDB.log.trace(
199
- `[revertCheckpoint:${hintKey}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId}.`,
200
- );
201
- }
202
-
203
- // Private methods.
204
- private getHintKey(): number {
205
- return this.checkpointActionCounter;
206
- }
207
-
208
- private getCurrentCheckpointId(): number {
209
- return this.checkpointStack[this.checkpointStack.length - 1];
210
- }
211
- }
212
-
213
- /**
214
- * A low-level merkle DB that collects hints.
215
- */
216
- export class HintingMerkleWriteOperations implements MerkleTreeWriteOperations {
217
- private static readonly log: Logger = createLogger('simulator:hinting-merkle-db');
218
- // This stack is only for debugging purposes.
219
- // The top of the stack is the current checkpoint id.
220
- // We need the stack to be non-empty and use 0 as an arbitrary initial checkpoint id.
221
- // This is not necessarily a checkpoint that happened, but whatever tree state we start with.
222
- private checkpointStack: number[] = [0];
223
- private nextCheckpointId: number = 1;
224
- private checkpointActionCounter: number = 0; // yes, a side-effect counter.
225
-
226
- public static async create(db: MerkleTreeWriteOperations, hints: AvmExecutionHints) {
227
- const hintingTreesDB = new HintingMerkleWriteOperations(db, hints);
228
- const startStateReference = await db.getStateReference();
229
- hints.startingTreeRoots = new TreeSnapshots(
230
- startStateReference.l1ToL2MessageTree,
231
- startStateReference.partial.noteHashTree,
232
- startStateReference.partial.nullifierTree,
233
- startStateReference.partial.publicDataTree,
234
- );
235
-
236
- return hintingTreesDB;
237
- }
238
-
239
- // Use create() to instantiate.
240
- private constructor(
241
- private db: MerkleTreeWriteOperations,
242
- private hints: AvmExecutionHints,
243
- ) {}
244
-
245
- // Getters.
246
- public async getSiblingPath<ID extends MerkleTreeId>(
247
- treeId: ID,
248
- index: bigint,
249
- ): Promise<SiblingPath<TreeHeights[ID]>> {
250
- const path = await this.db.getSiblingPath(treeId, index);
251
- const key = await this.getHintKey(treeId);
252
- this.hints.getSiblingPathHints.push(new AvmGetSiblingPathHint(key, treeId, index, path.toFields()));
253
- return Promise.resolve(path);
254
- }
255
-
256
- public async getPreviousValueIndex<ID extends IndexedTreeId>(
257
- treeId: ID,
258
- value: bigint,
259
- ): Promise<
260
- | {
261
- index: bigint;
262
- alreadyPresent: boolean;
263
- }
264
- | undefined
265
- > {
266
- const result = await this.db.getPreviousValueIndex(treeId, value);
267
- if (result === undefined) {
268
- throw new Error(
269
- `getPreviousValueIndex(${getTreeName(
270
- treeId,
271
- )}, ${value}}) returned undefined. Possible wrong tree setup or corrupted state.`,
272
- );
273
- }
274
- const key = await this.getHintKey(treeId);
275
- this.hints.getPreviousValueIndexHints.push(
276
- new AvmGetPreviousValueIndexHint(key, treeId, new Fr(value), result.index, result.alreadyPresent),
277
- );
278
- return result;
279
- }
280
-
281
- public async getLeafPreimage<ID extends IndexedTreeId>(
282
- treeId: ID,
283
- index: bigint,
284
- ): Promise<IndexedTreeLeafPreimage | undefined> {
285
- const preimage = await this.db.getLeafPreimage<ID>(treeId, index);
286
- if (preimage) {
287
- const key = await this.getHintKey(treeId);
288
-
289
- switch (treeId) {
290
- case MerkleTreeId.PUBLIC_DATA_TREE:
291
- this.hints.getLeafPreimageHintsPublicDataTree.push(
292
- new AvmGetLeafPreimageHintPublicDataTree(key, index, preimage as PublicDataTreeLeafPreimage),
293
- );
294
- break;
295
- case MerkleTreeId.NULLIFIER_TREE:
296
- this.hints.getLeafPreimageHintsNullifierTree.push(
297
- new AvmGetLeafPreimageHintNullifierTree(key, index, preimage as NullifierLeafPreimage),
298
- );
299
- break;
300
- default:
301
- // Use getLeafValue for the other trees.
302
- throw new Error('getLeafPreimage only supported for PublicDataTree and NullifierTree!');
303
- break;
304
- }
305
- }
306
-
307
- return preimage;
308
- }
309
-
310
- public async getLeafValue<ID extends MerkleTreeId>(
311
- treeId: ID,
312
- index: bigint,
313
- ): Promise<MerkleTreeLeafType<typeof treeId> | undefined> {
314
- // Use getLeafPreimage for PublicDataTree and NullifierTree.
315
- assert(treeId == MerkleTreeId.NOTE_HASH_TREE || treeId == MerkleTreeId.L1_TO_L2_MESSAGE_TREE);
316
-
317
- const value = await this.db.getLeafValue<ID>(treeId, index);
318
- if (value) {
319
- const key = await this.getHintKey(treeId);
320
- // We can cast to Fr because we know the type of the tree.
321
- this.hints.getLeafValueHints.push(new AvmGetLeafValueHint(key, treeId, index, value as Fr));
322
- }
323
-
324
- return value;
325
- }
326
-
327
- // State modification.
328
- // FIXME(fcarreiro): This is a horrible interface (in the merkle ops). It's receiving the leaves as buffers,
329
- // from a leaf class that is NOT the one that will be used to write. Make this type safe.
330
- public async sequentialInsert<TreeHeight extends number, ID extends IndexedTreeId>(
331
- treeId: ID,
332
- leaves: Buffer[],
333
- ): Promise<SequentialInsertionResult<TreeHeight>> {
334
- // Use appendLeaf for NoteHashTree and L1ToL2MessageTree.
335
- assert(treeId == MerkleTreeId.PUBLIC_DATA_TREE || treeId == MerkleTreeId.NULLIFIER_TREE);
336
- // We only support 1 leaf at a time for now. Can easily be extended.
337
- assert(leaves.length === 1, 'sequentialInsert supports only one leaf at a time!');
338
-
339
- const beforeState = await this.getHintKey(treeId);
340
-
341
- const result = await this.db.sequentialInsert<TreeHeight, ID>(treeId, leaves);
342
-
343
- const afterState = await this.getHintKey(treeId);
344
- HintingMerkleWriteOperations.logTreeChange('sequentialInsert', beforeState, afterState, treeId);
345
-
346
- switch (treeId) {
347
- case MerkleTreeId.PUBLIC_DATA_TREE:
348
- this.hints.sequentialInsertHintsPublicDataTree.push(
349
- new AvmSequentialInsertHintPublicDataTree(
350
- beforeState,
351
- afterState,
352
- treeId,
353
- PublicDataTreeLeaf.fromBuffer(leaves[0]),
354
- {
355
- leaf: result.lowLeavesWitnessData[0].leafPreimage as PublicDataTreeLeafPreimage,
356
- index: result.lowLeavesWitnessData[0].index,
357
- path: result.lowLeavesWitnessData[0].siblingPath.toFields(),
358
- },
359
- {
360
- leaf: result.insertionWitnessData[0].leafPreimage as PublicDataTreeLeafPreimage,
361
- index: result.insertionWitnessData[0].index,
362
- path: result.insertionWitnessData[0].siblingPath.toFields(),
363
- },
364
- ),
365
- );
366
- break;
367
- case MerkleTreeId.NULLIFIER_TREE:
368
- this.hints.sequentialInsertHintsNullifierTree.push(
369
- new AvmSequentialInsertHintNullifierTree(
370
- beforeState,
371
- afterState,
372
- treeId,
373
- NullifierLeaf.fromBuffer(leaves[0]),
374
- {
375
- leaf: result.lowLeavesWitnessData[0].leafPreimage as NullifierLeafPreimage,
376
- index: result.lowLeavesWitnessData[0].index,
377
- path: result.lowLeavesWitnessData[0].siblingPath.toFields(),
378
- },
379
- {
380
- leaf: result.insertionWitnessData[0].leafPreimage as NullifierLeafPreimage,
381
- index: result.insertionWitnessData[0].index,
382
- path: result.insertionWitnessData[0].siblingPath.toFields(),
383
- },
384
- ),
385
- );
386
- break;
387
- default:
388
- throw new Error('sequentialInsert only supported for PublicDataTree and NullifierTree!');
389
- break;
390
- }
391
-
392
- return result;
393
- }
394
-
395
- public async appendLeaves<ID extends MerkleTreeId>(treeId: ID, leaves: MerkleTreeLeafType<ID>[]): Promise<void> {
396
- // Use sequentialInsert for PublicDataTree and NullifierTree.
397
- assert(treeId == MerkleTreeId.NOTE_HASH_TREE || treeId == MerkleTreeId.L1_TO_L2_MESSAGE_TREE);
398
-
399
- // We need to process each leaf individually because we need the sibling path after insertion, to be able to constraint the insertion.
400
- // TODO(https://github.com/AztecProtocol/aztec-packages/issues/13380): This can be changed if the world state appendLeaves returns the sibling paths.
401
- if (leaves.length === 1) {
402
- await this.appendLeafInternal(treeId, leaves[0]);
403
- return;
404
- } else {
405
- // TODO(dbanks12): NON-HINTING! We skip hinting here for now because:
406
- // 1. We only ever append multiple leaves (for now) when padding (all empty leaves).
407
- // 2. We don't need hints per-item when padding.
408
- // 3. In order to get per-item hints today, you need to append one-at-a-time (mentioned above), which is VERY slow.
409
- await this.db.appendLeaves<ID>(treeId, leaves);
410
- }
411
- }
412
-
413
- public async createCheckpoint(): Promise<void> {
414
- const actionCounter = this.checkpointActionCounter++;
415
- const oldCheckpointId = this.getCurrentCheckpointId();
416
- const treesStateHash = await this.getTreesStateHash();
417
-
418
- await this.db.createCheckpoint();
419
- this.checkpointStack.push(this.nextCheckpointId++);
420
- const newCheckpointId = this.getCurrentCheckpointId();
421
-
422
- this.hints.createCheckpointHints.push(new AvmCreateCheckpointHint(actionCounter, oldCheckpointId, newCheckpointId));
423
-
424
- HintingMerkleWriteOperations.log.trace(
425
- `[createCheckpoint:${actionCounter}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId} at trees state ${treesStateHash}.`,
426
- );
427
- }
428
-
429
- public commitAllCheckpoints(): Promise<void> {
430
- throw new Error('commitAllCheckpoints is not supported in HintingMerkleWriteOperations.');
431
- }
432
-
433
- public revertAllCheckpoints(): Promise<void> {
434
- throw new Error('revertAllCheckpoints is not supported in HintingMerkleWriteOperations.');
435
- }
436
-
437
- public async commitCheckpoint(): Promise<void> {
438
- const actionCounter = this.checkpointActionCounter++;
439
- const oldCheckpointId = this.getCurrentCheckpointId();
440
- const treesStateHash = await this.getTreesStateHash();
441
-
442
- await this.db.commitCheckpoint();
443
- this.checkpointStack.pop();
444
- const newCheckpointId = this.getCurrentCheckpointId();
445
-
446
- this.hints.commitCheckpointHints.push(new AvmCommitCheckpointHint(actionCounter, oldCheckpointId, newCheckpointId));
447
-
448
- HintingMerkleWriteOperations.log.trace(
449
- `[commitCheckpoint:${actionCounter}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId} at trees state ${treesStateHash}.`,
450
- );
451
- }
452
-
453
- public async revertCheckpoint(): Promise<void> {
454
- const actionCounter = this.checkpointActionCounter++;
455
- const oldCheckpointId = this.getCurrentCheckpointId();
456
- const treesStateHash = await this.getTreesStateHash();
457
-
458
- const beforeState: Record<MerkleTreeId, AppendOnlyTreeSnapshot> = {
459
- [MerkleTreeId.PUBLIC_DATA_TREE]: await this.getHintKey(MerkleTreeId.PUBLIC_DATA_TREE),
460
- [MerkleTreeId.NULLIFIER_TREE]: await this.getHintKey(MerkleTreeId.NULLIFIER_TREE),
461
- [MerkleTreeId.NOTE_HASH_TREE]: await this.getHintKey(MerkleTreeId.NOTE_HASH_TREE),
462
- [MerkleTreeId.L1_TO_L2_MESSAGE_TREE]: await this.getHintKey(MerkleTreeId.L1_TO_L2_MESSAGE_TREE),
463
- [MerkleTreeId.ARCHIVE]: await this.getHintKey(MerkleTreeId.ARCHIVE),
464
- };
465
-
466
- await this.db.revertCheckpoint();
467
- this.checkpointStack.pop();
468
- const newCheckpointId = this.getCurrentCheckpointId();
469
-
470
- const afterState: Record<MerkleTreeId, AppendOnlyTreeSnapshot> = {
471
- [MerkleTreeId.PUBLIC_DATA_TREE]: await this.getHintKey(MerkleTreeId.PUBLIC_DATA_TREE),
472
- [MerkleTreeId.NULLIFIER_TREE]: await this.getHintKey(MerkleTreeId.NULLIFIER_TREE),
473
- [MerkleTreeId.NOTE_HASH_TREE]: await this.getHintKey(MerkleTreeId.NOTE_HASH_TREE),
474
- [MerkleTreeId.L1_TO_L2_MESSAGE_TREE]: await this.getHintKey(MerkleTreeId.L1_TO_L2_MESSAGE_TREE),
475
- [MerkleTreeId.ARCHIVE]: await this.getHintKey(MerkleTreeId.ARCHIVE),
476
- };
477
-
478
- this.hints.revertCheckpointHints.push(
479
- AvmRevertCheckpointHint.create(actionCounter, oldCheckpointId, newCheckpointId, beforeState, afterState),
480
- );
481
-
482
- HintingMerkleWriteOperations.log.trace(
483
- `[revertCheckpoint:${actionCounter}] Checkpoint evolved ${oldCheckpointId} -> ${newCheckpointId} at trees state ${treesStateHash}.`,
484
- );
485
- for (const treeId of merkleTreeIds()) {
486
- HintingMerkleWriteOperations.logTreeChange('revertCheckpoint', beforeState[treeId], afterState[treeId], treeId);
487
- }
488
- }
489
-
490
- // Private methods.
491
- private async getHintKey(treeId: MerkleTreeId): Promise<AppendOnlyTreeSnapshot> {
492
- const treeInfo = await this.db.getTreeInfo(treeId);
493
- return new AppendOnlyTreeSnapshot(Fr.fromBuffer(treeInfo.root), Number(treeInfo.size));
494
- }
495
-
496
- private getCurrentCheckpointId(): number {
497
- return this.checkpointStack[this.checkpointStack.length - 1];
498
- }
499
-
500
- // For logging/debugging purposes.
501
- private async getTreesStateHash(): Promise<Fr> {
502
- const stateReferenceFields = (await this.db.getStateReference()).toFields();
503
- return Fr.fromBuffer(sha256Trunc(Buffer.concat(stateReferenceFields.map(field => field.toBuffer()))));
504
- }
505
-
506
- private static logTreeChange(
507
- action: string,
508
- beforeState: AppendOnlyTreeSnapshot,
509
- afterState: AppendOnlyTreeSnapshot,
510
- treeId: MerkleTreeId,
511
- ) {
512
- const treeName = getTreeName(treeId);
513
- HintingMerkleWriteOperations.log.trace(
514
- `[${action}] ${treeName} tree state: ${beforeState.root}, ${beforeState.nextAvailableLeafIndex} -> ${afterState.root}, ${afterState.nextAvailableLeafIndex}.`,
515
- );
516
- }
517
-
518
- private async appendLeafInternal<ID extends MerkleTreeId>(
519
- treeId: ID,
520
- leaf: MerkleTreeLeafType<ID>,
521
- ): Promise<SiblingPath<TreeHeights[ID]>> {
522
- // Use sequentialInsert for PublicDataTree and NullifierTree.
523
- assert(treeId == MerkleTreeId.NOTE_HASH_TREE || treeId == MerkleTreeId.L1_TO_L2_MESSAGE_TREE);
524
-
525
- const beforeState = await this.getHintKey(treeId);
526
-
527
- await this.db.appendLeaves<ID>(treeId, [leaf]);
528
-
529
- const afterState = await this.getHintKey(treeId);
530
-
531
- HintingMerkleWriteOperations.logTreeChange('appendLeaves', beforeState, afterState, treeId);
532
-
533
- this.hints.appendLeavesHints.push(new AvmAppendLeavesHint(beforeState, afterState, treeId, [leaf as Fr]));
534
-
535
- return await this.getSiblingPath(treeId, BigInt(beforeState.nextAvailableLeafIndex));
536
- }
537
-
538
- // Non-hinted required methods from MerkleTreeWriteOperations interface
539
- public async getTreeInfo(treeId: MerkleTreeId) {
540
- return await this.db.getTreeInfo(treeId);
541
- }
542
-
543
- public async getStateReference() {
544
- return await this.db.getStateReference();
545
- }
546
-
547
- public getInitialHeader() {
548
- return this.db.getInitialHeader();
549
- }
550
-
551
- public getRevision(): WorldStateRevision {
552
- return this.db.getRevision();
553
- }
554
-
555
- public async updateArchive(header: any): Promise<void> {
556
- return await this.db.updateArchive(header);
557
- }
558
-
559
- public async batchInsert<
560
- TreeHeight extends number,
561
- SubtreeSiblingPathHeight extends number,
562
- ID extends IndexedTreeId,
563
- >(
564
- treeId: ID,
565
- leaves: Buffer[],
566
- subtreeHeight: number,
567
- ): Promise<BatchInsertionResult<TreeHeight, SubtreeSiblingPathHeight>> {
568
- return await this.db.batchInsert<TreeHeight, SubtreeSiblingPathHeight, ID>(treeId, leaves, subtreeHeight);
569
- }
570
-
571
- public async close(): Promise<void> {
572
- return await this.db.close();
573
- }
574
-
575
- async [Symbol.dispose](): Promise<void> {
576
- await this.close();
577
- }
578
-
579
- public async findLeafIndices<ID extends MerkleTreeId>(
580
- treeId: ID,
581
- values: MerkleTreeLeafType<ID>[],
582
- ): Promise<(bigint | undefined)[]> {
583
- return await this.db.findLeafIndices(treeId, values);
584
- }
585
-
586
- public findSiblingPaths<ID extends MerkleTreeId>(
587
- treeId: ID,
588
- values: MerkleTreeLeafType<ID>[],
589
- ): Promise<({ path: SiblingPath<TreeHeights[ID]>; index: bigint } | undefined)[]> {
590
- return this.db.findSiblingPaths(treeId, values);
591
- }
592
-
593
- public async findLeafIndicesAfter<ID extends MerkleTreeId>(
594
- treeId: ID,
595
- values: MerkleTreeLeafType<ID>[],
596
- startIndex: bigint,
597
- ): Promise<(bigint | undefined)[]> {
598
- return await this.db.findLeafIndicesAfter(treeId, values, startIndex);
599
- }
600
-
601
- public async getBlockNumbersForLeafIndices<ID extends MerkleTreeId>(
602
- treeId: ID,
603
- leafIndices: bigint[],
604
- ): Promise<(BlockNumber | undefined)[]> {
605
- return await this.db.getBlockNumbersForLeafIndices(treeId, leafIndices);
606
- }
607
- }