@aztec/simulator 0.0.1-commit.d3ec352c → 0.0.1-commit.d58ff9d0

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 (391) hide show
  1. package/README.md +6 -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/common/errors.d.ts +8 -2
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/private/acvm/acvm.d.ts +4 -2
  8. package/dest/private/acvm/acvm.d.ts.map +1 -1
  9. package/dest/private/acvm/acvm.js +4 -3
  10. package/dest/private/acvm/deserialize.d.ts +2 -2
  11. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  12. package/dest/private/acvm/deserialize.js +1 -1
  13. package/dest/private/acvm/serialize.d.ts +2 -2
  14. package/dest/private/acvm/serialize.d.ts.map +1 -1
  15. package/dest/private/acvm/serialize.js +1 -1
  16. package/dest/private/acvm_native.d.ts +5 -3
  17. package/dest/private/acvm_native.d.ts.map +1 -1
  18. package/dest/private/acvm_native.js +8 -6
  19. package/dest/private/acvm_wasm.d.ts +4 -3
  20. package/dest/private/acvm_wasm.d.ts.map +1 -1
  21. package/dest/private/acvm_wasm.js +7 -5
  22. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  23. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  24. package/dest/private/circuit_recording/circuit_recorder.js +71 -72
  25. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  26. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  27. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  28. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  29. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  30. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  31. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  32. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  33. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  34. package/dest/private/factory.d.ts +3 -3
  35. package/dest/private/factory.d.ts.map +1 -1
  36. package/dest/private/factory.js +7 -4
  37. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  38. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  39. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  40. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +3 -2
  41. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  42. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +19 -4
  43. package/dest/public/avm/testing/utils.d.ts +32 -0
  44. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  45. package/dest/public/avm/{fixtures → testing}/utils.js +5 -35
  46. package/dest/public/avm_simulator.d.ts +28 -0
  47. package/dest/public/avm_simulator.d.ts.map +1 -0
  48. package/dest/public/avm_simulator.js +4 -0
  49. package/dest/public/avm_simulator_pool.d.ts +45 -0
  50. package/dest/public/avm_simulator_pool.d.ts.map +1 -0
  51. package/dest/public/avm_simulator_pool.js +197 -0
  52. package/dest/public/cdb/generated/api_types.d.ts +171 -0
  53. package/dest/public/cdb/generated/api_types.d.ts.map +1 -0
  54. package/dest/public/cdb/generated/api_types.js +314 -0
  55. package/dest/public/cdb/generated/server.d.ts +26 -0
  56. package/dest/public/cdb/generated/server.d.ts.map +1 -0
  57. package/dest/public/cdb/generated/server.js +135 -0
  58. package/dest/public/cdb_ipc_server.d.ts +33 -0
  59. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  60. package/dest/public/cdb_ipc_server.js +153 -0
  61. package/dest/public/contracts_db_checkpoint.d.ts +3 -3
  62. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  63. package/dest/public/contracts_db_checkpoint.js +1 -1
  64. package/dest/public/db_interfaces.d.ts +2 -2
  65. package/dest/public/db_interfaces.d.ts.map +1 -1
  66. package/dest/public/executor_metrics.d.ts +1 -1
  67. package/dest/public/executor_metrics.d.ts.map +1 -1
  68. package/dest/public/executor_metrics.js +12 -33
  69. package/dest/public/fixtures/amm_test.js +6 -6
  70. package/dest/public/fixtures/bulk_test.d.ts +3 -3
  71. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  72. package/dest/public/fixtures/bulk_test.js +38 -75
  73. package/dest/public/fixtures/custom_bytecode_tester.d.ts +28 -6
  74. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  75. package/dest/public/fixtures/custom_bytecode_tester.js +36 -12
  76. package/dest/public/fixtures/index.d.ts +3 -3
  77. package/dest/public/fixtures/index.d.ts.map +1 -1
  78. package/dest/public/fixtures/index.js +2 -2
  79. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  80. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  81. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  82. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +24 -6
  83. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  84. package/dest/public/fixtures/public_tx_simulation_tester.js +66 -21
  85. package/dest/public/fixtures/simple_contract_data_source.d.ts +2 -2
  86. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -1
  87. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  88. package/dest/public/fixtures/token_test.js +4 -4
  89. package/dest/public/fixtures/utils.d.ts +3 -3
  90. package/dest/public/fixtures/utils.d.ts.map +1 -1
  91. package/dest/public/fixtures/utils.js +25 -23
  92. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +67 -0
  93. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -0
  94. package/dest/public/fuzzing/avm_fuzzer_simulator.js +185 -0
  95. package/dest/public/fuzzing/avm_simulator_bin.d.ts +2 -0
  96. package/dest/public/fuzzing/avm_simulator_bin.d.ts.map +1 -0
  97. package/dest/public/fuzzing/avm_simulator_bin.js +118 -0
  98. package/dest/public/index.d.ts +5 -2
  99. package/dest/public/index.d.ts.map +1 -1
  100. package/dest/public/index.js +2 -1
  101. package/dest/public/public_db_sources.d.ts +10 -6
  102. package/dest/public/public_db_sources.d.ts.map +1 -1
  103. package/dest/public/public_db_sources.js +21 -15
  104. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -6
  105. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  106. package/dest/public/public_processor/guarded_merkle_tree.js +12 -4
  107. package/dest/public/public_processor/public_processor.d.ts +17 -8
  108. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  109. package/dest/public/public_processor/public_processor.js +535 -100
  110. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  111. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  112. package/dest/public/public_processor/public_processor_metrics.js +36 -45
  113. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  114. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  115. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.js +39 -0
  116. package/dest/public/public_tx_simulator/factories.d.ts +14 -0
  117. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -0
  118. package/dest/public/public_tx_simulator/factories.js +28 -0
  119. package/dest/public/public_tx_simulator/index.d.ts +5 -5
  120. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  121. package/dest/public/public_tx_simulator/index.js +3 -3
  122. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +43 -70
  123. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  124. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -312
  125. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  126. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  127. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  128. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +24 -1
  129. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -1
  130. package/dest/public/test_executor_metrics.d.ts +3 -2
  131. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  132. package/dest/public/test_executor_metrics.js +2 -2
  133. package/package.json +23 -20
  134. package/src/client.ts +0 -2
  135. package/src/common/errors.ts +1 -1
  136. package/src/private/acvm/acvm.ts +4 -3
  137. package/src/private/acvm/deserialize.ts +1 -1
  138. package/src/private/acvm/serialize.ts +1 -1
  139. package/src/private/acvm_native.ts +11 -5
  140. package/src/private/acvm_wasm.ts +11 -4
  141. package/src/private/circuit_recording/circuit_recorder.ts +90 -81
  142. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  143. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  144. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  145. package/src/private/factory.ts +7 -4
  146. package/src/public/avm/testing/account_proof.json +553 -0
  147. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  148. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +24 -4
  149. package/src/public/avm/{fixtures → testing}/utils.ts +5 -41
  150. package/src/public/avm_simulator.ts +29 -0
  151. package/src/public/avm_simulator_pool.ts +226 -0
  152. package/src/public/cdb/generated/api_types.ts +457 -0
  153. package/src/public/cdb/generated/server.ts +109 -0
  154. package/src/public/cdb_ipc_server.ts +197 -0
  155. package/src/public/contracts_db_checkpoint.ts +2 -2
  156. package/src/public/db_interfaces.ts +1 -1
  157. package/src/public/executor_metrics.ts +9 -33
  158. package/src/public/fixtures/amm_test.ts +6 -6
  159. package/src/public/fixtures/bulk_test.ts +40 -15
  160. package/src/public/fixtures/custom_bytecode_tester.ts +53 -19
  161. package/src/public/fixtures/index.ts +6 -2
  162. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  163. package/src/public/fixtures/public_tx_simulation_tester.ts +82 -21
  164. package/src/public/fixtures/simple_contract_data_source.ts +2 -2
  165. package/src/public/fixtures/token_test.ts +4 -4
  166. package/src/public/fixtures/utils.ts +25 -27
  167. package/src/public/fuzzing/avm_fuzzer_simulator.ts +303 -0
  168. package/src/public/fuzzing/avm_simulator_bin.ts +173 -0
  169. package/src/public/index.ts +8 -2
  170. package/src/public/public_db_sources.ts +37 -20
  171. package/src/public/public_processor/guarded_merkle_tree.ts +14 -7
  172. package/src/public/public_processor/public_processor.ts +188 -102
  173. package/src/public/public_processor/public_processor_metrics.ts +28 -44
  174. package/src/public/public_tx_simulator/dumping_public_tx_simulator.ts +67 -0
  175. package/src/public/public_tx_simulator/factories.ts +61 -0
  176. package/src/public/public_tx_simulator/index.ts +7 -4
  177. package/src/public/public_tx_simulator/public_tx_simulator.ts +143 -458
  178. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  179. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +23 -0
  180. package/src/public/test_executor_metrics.ts +3 -3
  181. package/dest/public/avm/avm_context.d.ts +0 -41
  182. package/dest/public/avm/avm_context.d.ts.map +0 -1
  183. package/dest/public/avm/avm_context.js +0 -44
  184. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  185. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  186. package/dest/public/avm/avm_contract_call_result.js +0 -54
  187. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  188. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  189. package/dest/public/avm/avm_execution_environment.js +0 -33
  190. package/dest/public/avm/avm_gas.d.ts +0 -44
  191. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  192. package/dest/public/avm/avm_gas.js +0 -195
  193. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  194. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  195. package/dest/public/avm/avm_machine_state.js +0 -109
  196. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  197. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  198. package/dest/public/avm/avm_memory_types.js +0 -351
  199. package/dest/public/avm/avm_simulator.d.ts +0 -40
  200. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  201. package/dest/public/avm/avm_simulator.js +0 -191
  202. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  203. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  204. package/dest/public/avm/avm_simulator_interface.js +0 -3
  205. package/dest/public/avm/errors.d.ts +0 -104
  206. package/dest/public/avm/errors.d.ts.map +0 -1
  207. package/dest/public/avm/errors.js +0 -141
  208. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  209. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  210. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -83
  211. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  212. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  213. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  214. package/dest/public/avm/fixtures/initializers.js +0 -44
  215. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  216. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  217. package/dest/public/avm/index.d.ts +0 -2
  218. package/dest/public/avm/index.d.ts.map +0 -1
  219. package/dest/public/avm/index.js +0 -1
  220. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  221. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  222. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  223. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  224. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  225. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  226. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -47
  227. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  228. package/dest/public/avm/opcodes/arithmetic.js +0 -87
  229. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  230. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  231. package/dest/public/avm/opcodes/bitwise.js +0 -99
  232. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  233. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  234. package/dest/public/avm/opcodes/comparators.js +0 -43
  235. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  236. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  237. package/dest/public/avm/opcodes/contract.js +0 -65
  238. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  239. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  240. package/dest/public/avm/opcodes/control_flow.js +0 -107
  241. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  242. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  243. package/dest/public/avm/opcodes/conversion.js +0 -333
  244. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  245. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  246. package/dest/public/avm/opcodes/ec_add.js +0 -84
  247. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  248. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  249. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  250. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  251. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  252. package/dest/public/avm/opcodes/external_calls.js +0 -209
  253. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  254. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  255. package/dest/public/avm/opcodes/hashing.js +0 -114
  256. package/dest/public/avm/opcodes/index.d.ts +0 -16
  257. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  258. package/dest/public/avm/opcodes/index.js +0 -15
  259. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  260. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  261. package/dest/public/avm/opcodes/instruction.js +0 -95
  262. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  263. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  264. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  265. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  266. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  267. package/dest/public/avm/opcodes/memory.js +0 -257
  268. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  269. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  270. package/dest/public/avm/opcodes/misc.js +0 -73
  271. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  272. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  273. package/dest/public/avm/opcodes/storage.js +0 -68
  274. package/dest/public/avm/revert_reason.d.ts +0 -18
  275. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  276. package/dest/public/avm/revert_reason.js +0 -39
  277. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  278. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  279. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  280. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  281. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  282. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  283. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  284. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  285. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  286. package/dest/public/avm/test_utils.d.ts +0 -15
  287. package/dest/public/avm/test_utils.d.ts.map +0 -1
  288. package/dest/public/avm/test_utils.js +0 -44
  289. package/dest/public/debug_fn_name.d.ts +0 -18
  290. package/dest/public/debug_fn_name.d.ts.map +0 -1
  291. package/dest/public/debug_fn_name.js +0 -28
  292. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -9
  293. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  294. package/dest/public/fixtures/custom_bytecode_tests.js +0 -109
  295. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -9
  296. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  297. package/dest/public/fixtures/minimal_public_tx.js +0 -29
  298. package/dest/public/hinting_db_sources.d.ts +0 -79
  299. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  300. package/dest/public/hinting_db_sources.js +0 -350
  301. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +0 -30
  302. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +0 -1
  303. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +0 -133
  304. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -38
  305. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  306. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -93
  307. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  308. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  309. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  310. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  311. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  312. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -170
  313. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  314. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  315. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  316. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -130
  317. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  318. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  319. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  320. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  321. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -39
  322. package/dest/public/side_effect_trace.d.ts +0 -86
  323. package/dest/public/side_effect_trace.d.ts.map +0 -1
  324. package/dest/public/side_effect_trace.js +0 -199
  325. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  326. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  327. package/dest/public/side_effect_trace_interface.js +0 -1
  328. package/dest/public/state_manager/index.d.ts +0 -2
  329. package/dest/public/state_manager/index.d.ts.map +0 -1
  330. package/dest/public/state_manager/index.js +0 -1
  331. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  332. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  333. package/dest/public/state_manager/nullifiers.js +0 -92
  334. package/dest/public/state_manager/public_storage.d.ts +0 -66
  335. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  336. package/dest/public/state_manager/public_storage.js +0 -145
  337. package/dest/public/state_manager/state_manager.d.ts +0 -164
  338. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  339. package/dest/public/state_manager/state_manager.js +0 -395
  340. package/src/public/avm/avm_context.ts +0 -61
  341. package/src/public/avm/avm_contract_call_result.ts +0 -67
  342. package/src/public/avm/avm_execution_environment.ts +0 -46
  343. package/src/public/avm/avm_gas.ts +0 -183
  344. package/src/public/avm/avm_machine_state.ts +0 -169
  345. package/src/public/avm/avm_memory_types.ts +0 -436
  346. package/src/public/avm/avm_simulator.ts +0 -276
  347. package/src/public/avm/avm_simulator_interface.ts +0 -8
  348. package/src/public/avm/errors.ts +0 -177
  349. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -116
  350. package/src/public/avm/fixtures/initializers.ts +0 -102
  351. package/src/public/avm/index.ts +0 -1
  352. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  353. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  354. package/src/public/avm/opcodes/arithmetic.ts +0 -117
  355. package/src/public/avm/opcodes/bitwise.ts +0 -113
  356. package/src/public/avm/opcodes/comparators.ts +0 -55
  357. package/src/public/avm/opcodes/contract.ts +0 -75
  358. package/src/public/avm/opcodes/control_flow.ts +0 -123
  359. package/src/public/avm/opcodes/conversion.ts +0 -104
  360. package/src/public/avm/opcodes/ec_add.ts +0 -96
  361. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  362. package/src/public/avm/opcodes/external_calls.ts +0 -260
  363. package/src/public/avm/opcodes/hashing.ts +0 -145
  364. package/src/public/avm/opcodes/index.ts +0 -15
  365. package/src/public/avm/opcodes/instruction.ts +0 -136
  366. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  367. package/src/public/avm/opcodes/memory.ts +0 -293
  368. package/src/public/avm/opcodes/misc.ts +0 -102
  369. package/src/public/avm/opcodes/storage.ts +0 -87
  370. package/src/public/avm/revert_reason.ts +0 -58
  371. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  372. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  373. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  374. package/src/public/avm/test_utils.ts +0 -64
  375. package/src/public/debug_fn_name.ts +0 -43
  376. package/src/public/fixtures/custom_bytecode_tests.ts +0 -135
  377. package/src/public/fixtures/minimal_public_tx.ts +0 -35
  378. package/src/public/hinting_db_sources.ts +0 -603
  379. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +0 -162
  380. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -155
  381. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -132
  382. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -240
  383. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  384. package/src/public/public_tx_simulator/public_tx_context.ts +0 -477
  385. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  386. package/src/public/side_effect_trace.ts +0 -290
  387. package/src/public/side_effect_trace_interface.ts +0 -28
  388. package/src/public/state_manager/index.ts +0 -1
  389. package/src/public/state_manager/nullifiers.ts +0 -103
  390. package/src/public/state_manager/public_storage.ts +0 -174
  391. package/src/public/state_manager/state_manager.ts +0 -560
@@ -1,58 +0,0 @@
1
- import type { Fr } from '@aztec/foundation/fields';
2
-
3
- import type { AvmContext } from './avm_context.js';
4
- import { type AvmExecutionError, AvmRevertReason } from './errors.js';
5
-
6
- async function createRevertReason(message: string, revertData: Fr[], context: AvmContext): Promise<AvmRevertReason> {
7
- // We drop the returnPc information.
8
- const internalCallStack = context.machineState.internalCallStack.map(entry => entry.callPc);
9
-
10
- // If we are reverting due to the same error that we have been tracking, we use the nested error as the cause.
11
- let nestedError = undefined;
12
- const revertDataEquals = (a: Fr[], b: Fr[]) => a.length === b.length && a.every((v, i) => v.equals(b[i]));
13
- if (
14
- context.machineState.collectedRevertInfo &&
15
- revertDataEquals(context.machineState.collectedRevertInfo.revertDataRepresentative, revertData)
16
- ) {
17
- nestedError = context.machineState.collectedRevertInfo.recursiveRevertReason;
18
- message = context.machineState.collectedRevertInfo.recursiveRevertReason.message;
19
- }
20
-
21
- const { functionSelector, functionName } = await context.persistableState.getPublicFunctionSelectorAndName(
22
- context.environment,
23
- );
24
-
25
- return new AvmRevertReason(
26
- message,
27
- /*failingFunction=*/ {
28
- contractAddress: context.environment.address,
29
- functionSelector,
30
- functionName,
31
- },
32
- /*noirCallStack=*/ [...internalCallStack, context.machineState.pc].map(pc => `0.${pc}`),
33
- /*options=*/ { cause: nestedError },
34
- );
35
- }
36
-
37
- /**
38
- * Create a "revert reason" error for an exceptional halt.
39
- *
40
- * @param haltingError - the lower-level error causing the exceptional halt
41
- * @param context - the context of the AVM execution used to extract the failingFunction and noirCallStack
42
- */
43
- export async function revertReasonFromExceptionalHalt(
44
- haltingError: AvmExecutionError,
45
- context: AvmContext,
46
- ): Promise<AvmRevertReason> {
47
- return await createRevertReason(haltingError.message, [], context);
48
- }
49
-
50
- /**
51
- * Create a "revert reason" error for an explicit revert (a root cause).
52
- *
53
- * @param revertData - output data of the explicit REVERT instruction
54
- * @param context - the context of the AVM execution used to extract the failingFunction and noirCallStack
55
- */
56
- export async function revertReasonFromExplicitRevert(revertData: Fr[], context: AvmContext): Promise<AvmRevertReason> {
57
- return await createRevertReason('Assertion failed: ', revertData, context);
58
- }
@@ -1,118 +0,0 @@
1
- /*
2
- * A Buffer-like class that automatically advances the position.
3
- */
4
- export class BufferCursor {
5
- constructor(
6
- private _buffer: Buffer,
7
- private _position: number = 0,
8
- ) {}
9
-
10
- public position(): number {
11
- return this._position;
12
- }
13
-
14
- public buffer(): Buffer {
15
- return this._buffer;
16
- }
17
-
18
- public eof(): boolean {
19
- return this._position === this._buffer.length;
20
- }
21
-
22
- public bufferAtPosition(): Buffer {
23
- return this._buffer.subarray(this._position);
24
- }
25
-
26
- public advance(n: number): void {
27
- this._position += n;
28
- }
29
-
30
- public peekUint8(): number {
31
- const ret = this._buffer.readUint8(this._position);
32
- return ret;
33
- }
34
-
35
- public readUint8(): number {
36
- const ret = this._buffer.readUint8(this._position);
37
- this._position += 1;
38
- return ret;
39
- }
40
-
41
- public readUint16LE(): number {
42
- const ret = this._buffer.readUint16LE(this._position);
43
- this._position += 2;
44
- return ret;
45
- }
46
-
47
- public readUint16BE(): number {
48
- const ret = this._buffer.readUint16BE(this._position);
49
- this._position += 2;
50
- return ret;
51
- }
52
-
53
- public readUint32LE(): number {
54
- const ret = this._buffer.readUint32LE(this._position);
55
- this._position += 4;
56
- return ret;
57
- }
58
-
59
- public readUint32BE(): number {
60
- const ret = this._buffer.readUint32BE(this._position);
61
- this._position += 4;
62
- return ret;
63
- }
64
-
65
- public readBigInt64LE(): bigint {
66
- const ret = this._buffer.readBigInt64LE(this._position);
67
- this._position += 8;
68
- return ret;
69
- }
70
-
71
- public readBigInt64BE(): bigint {
72
- const ret = this._buffer.readBigInt64BE(this._position);
73
- this._position += 8;
74
- return ret;
75
- }
76
-
77
- public writeUint8(v: number) {
78
- const ret = this._buffer.writeUint8(v, this._position);
79
- this._position += 1;
80
- return ret;
81
- }
82
-
83
- public writeUint16LE(v: number) {
84
- const ret = this._buffer.writeUint16LE(v, this._position);
85
- this._position += 2;
86
- return ret;
87
- }
88
-
89
- public writeUint16BE(v: number) {
90
- const ret = this._buffer.writeUint16BE(v, this._position);
91
- this._position += 2;
92
- return ret;
93
- }
94
-
95
- public writeUint32LE(v: number) {
96
- const ret = this._buffer.writeUint32LE(v, this._position);
97
- this._position += 4;
98
- return ret;
99
- }
100
-
101
- public writeUint32BE(v: number) {
102
- const ret = this._buffer.writeUint32BE(v, this._position);
103
- this._position += 4;
104
- return ret;
105
- }
106
-
107
- public writeBigInt64LE(v: bigint) {
108
- const ret = this._buffer.writeBigInt64LE(v, this._position);
109
- this._position += 8;
110
- return ret;
111
- }
112
-
113
- public writeBigInt64BE(v: bigint) {
114
- const ret = this._buffer.writeBigInt64BE(v, this._position);
115
- this._position += 8;
116
- return ret;
117
- }
118
- }
@@ -1,215 +0,0 @@
1
- import { type Bufferable, serializeToBuffer } from '@aztec/foundation/serialize';
2
-
3
- import {
4
- AvmExecutionError,
5
- AvmParsingError,
6
- InvalidOpcodeError,
7
- InvalidProgramCounterError,
8
- InvalidTagValueError,
9
- duringInstrFetch,
10
- } from '../errors.js';
11
- import {
12
- Add,
13
- And,
14
- Call,
15
- CalldataCopy,
16
- Cast,
17
- DebugLog,
18
- Div,
19
- EcAdd,
20
- EmitNoteHash,
21
- EmitNullifier,
22
- EmitUnencryptedLog,
23
- Eq,
24
- FieldDiv,
25
- GetContractInstance,
26
- GetEnvVar,
27
- Instruction,
28
- InternalCall,
29
- InternalReturn,
30
- Jump,
31
- JumpI,
32
- KeccakF1600,
33
- L1ToL2MessageExists,
34
- Lt,
35
- Lte,
36
- Mov,
37
- Mul,
38
- Not,
39
- NoteHashExists,
40
- NullifierExists,
41
- Or,
42
- Poseidon2,
43
- Return,
44
- ReturndataCopy,
45
- ReturndataSize,
46
- Revert,
47
- SLoad,
48
- SStore,
49
- SendL2ToL1Message,
50
- Set,
51
- Sha256Compression,
52
- Shl,
53
- Shr,
54
- StaticCall,
55
- Sub,
56
- SuccessCopy,
57
- ToRadixBE,
58
- Xor,
59
- } from '../opcodes/index.js';
60
- import { BufferCursor } from './buffer_cursor.js';
61
- import { MAX_OPCODE_VALUE, Opcode } from './instruction_serialization.js';
62
-
63
- export type InstructionDeserializer = (buf: BufferCursor | Buffer) => Instruction;
64
-
65
- export interface Deserializable {
66
- deserialize: InstructionDeserializer;
67
- }
68
-
69
- export type InstructionSet = Map<Opcode, InstructionDeserializer>;
70
- export const INSTRUCTION_SET = new Map<Opcode, InstructionDeserializer>([
71
- [Opcode.ADD_8, Add.as(Add.wireFormat8).fromBuffer],
72
- [Opcode.ADD_16, Add.as(Add.wireFormat16).fromBuffer],
73
- [Opcode.SUB_8, Sub.as(Sub.wireFormat8).fromBuffer],
74
- [Opcode.SUB_16, Sub.as(Sub.wireFormat16).fromBuffer],
75
- [Opcode.MUL_8, Mul.as(Mul.wireFormat8).fromBuffer],
76
- [Opcode.MUL_16, Mul.as(Mul.wireFormat16).fromBuffer],
77
- [Opcode.DIV_8, Div.as(Div.wireFormat8).fromBuffer],
78
- [Opcode.DIV_16, Div.as(Div.wireFormat16).fromBuffer],
79
- [Opcode.FDIV_8, FieldDiv.as(FieldDiv.wireFormat8).fromBuffer],
80
- [Opcode.FDIV_16, FieldDiv.as(FieldDiv.wireFormat16).fromBuffer],
81
- [Opcode.EQ_8, Eq.as(Eq.wireFormat8).fromBuffer],
82
- [Opcode.EQ_16, Eq.as(Eq.wireFormat16).fromBuffer],
83
- [Opcode.LT_8, Lt.as(Lt.wireFormat8).fromBuffer],
84
- [Opcode.LT_16, Lt.as(Lt.wireFormat16).fromBuffer],
85
- [Opcode.LTE_8, Lte.as(Lte.wireFormat8).fromBuffer],
86
- [Opcode.LTE_16, Lte.as(Lte.wireFormat16).fromBuffer],
87
- [Opcode.AND_8, And.as(And.wireFormat8).fromBuffer],
88
- [Opcode.AND_16, And.as(And.wireFormat16).fromBuffer],
89
- [Opcode.OR_8, Or.as(Or.wireFormat8).fromBuffer],
90
- [Opcode.OR_16, Or.as(Or.wireFormat16).fromBuffer],
91
- [Opcode.XOR_8, Xor.as(Xor.wireFormat8).fromBuffer],
92
- [Opcode.XOR_16, Xor.as(Xor.wireFormat16).fromBuffer],
93
- [Opcode.NOT_8, Not.as(Not.wireFormat8).fromBuffer],
94
- [Opcode.NOT_16, Not.as(Not.wireFormat16).fromBuffer],
95
- [Opcode.SHL_8, Shl.as(Shl.wireFormat8).fromBuffer],
96
- [Opcode.SHL_16, Shl.as(Shl.wireFormat16).fromBuffer],
97
- [Opcode.SHR_8, Shr.as(Shr.wireFormat8).fromBuffer],
98
- [Opcode.SHR_16, Shr.as(Shr.wireFormat16).fromBuffer],
99
- [Opcode.CAST_8, Cast.as(Cast.wireFormat8).fromBuffer],
100
- [Opcode.CAST_16, Cast.as(Cast.wireFormat16).fromBuffer],
101
- // Execution Environment
102
- [Opcode.GETENVVAR_16, GetEnvVar.as(GetEnvVar.wireFormat16).fromBuffer],
103
- [CalldataCopy.opcode, Instruction.fromBuffer.bind(CalldataCopy)],
104
- [SuccessCopy.opcode, Instruction.fromBuffer.bind(SuccessCopy)],
105
- [Opcode.RETURNDATASIZE, Instruction.fromBuffer.bind(ReturndataSize)],
106
- [Opcode.RETURNDATACOPY, Instruction.fromBuffer.bind(ReturndataCopy)],
107
-
108
- // Machine State - Internal Control Flow
109
- [Jump.opcode, Instruction.fromBuffer.bind(Jump)],
110
- [JumpI.opcode, Instruction.fromBuffer.bind(JumpI)],
111
- [InternalCall.opcode, Instruction.fromBuffer.bind(InternalCall)],
112
- [InternalReturn.opcode, Instruction.fromBuffer.bind(InternalReturn)],
113
- [Opcode.SET_8, Set.as(Set.wireFormat8).fromBuffer],
114
- [Opcode.SET_16, Set.as(Set.wireFormat16).fromBuffer],
115
- [Opcode.SET_32, Set.as(Set.wireFormat32).fromBuffer],
116
- [Opcode.SET_64, Set.as(Set.wireFormat64).fromBuffer],
117
- [Opcode.SET_128, Set.as(Set.wireFormat128).fromBuffer],
118
- [Opcode.SET_FF, Set.as(Set.wireFormatFF).fromBuffer],
119
- [Opcode.MOV_8, Mov.as(Mov.wireFormat8).fromBuffer],
120
- [Opcode.MOV_16, Mov.as(Mov.wireFormat16).fromBuffer],
121
-
122
- // World State
123
- [SLoad.opcode, Instruction.fromBuffer.bind(SLoad)], // Public Storage
124
- [SStore.opcode, Instruction.fromBuffer.bind(SStore)], // Public Storage
125
- [NoteHashExists.opcode, Instruction.fromBuffer.bind(NoteHashExists)], // Notes & Nullifiers
126
- [EmitNoteHash.opcode, Instruction.fromBuffer.bind(EmitNoteHash)], // Notes & Nullifiers
127
- [NullifierExists.opcode, Instruction.fromBuffer.bind(NullifierExists)], // Notes & Nullifiers
128
- [EmitNullifier.opcode, Instruction.fromBuffer.bind(EmitNullifier)], // Notes & Nullifiers
129
- [L1ToL2MessageExists.opcode, Instruction.fromBuffer.bind(L1ToL2MessageExists)], // Messages
130
-
131
- // Accrued Substate
132
- [EmitUnencryptedLog.opcode, Instruction.fromBuffer.bind(EmitUnencryptedLog)],
133
- [SendL2ToL1Message.opcode, Instruction.fromBuffer.bind(SendL2ToL1Message)],
134
- [GetContractInstance.opcode, Instruction.fromBuffer.bind(GetContractInstance)],
135
-
136
- // Control Flow - Contract Calls
137
- [Call.opcode, Instruction.fromBuffer.bind(Call)],
138
- [StaticCall.opcode, Instruction.fromBuffer.bind(StaticCall)],
139
- [Return.opcode, Instruction.fromBuffer.bind(Return)],
140
- [Opcode.REVERT_8, Revert.as(Revert.wireFormat8).fromBuffer],
141
- [Opcode.REVERT_16, Revert.as(Revert.wireFormat16).fromBuffer],
142
-
143
- // Misc
144
- [DebugLog.opcode, Instruction.fromBuffer.bind(DebugLog)],
145
-
146
- // Gadgets
147
- [EcAdd.opcode, Instruction.fromBuffer.bind(EcAdd)],
148
- [Poseidon2.opcode, Instruction.fromBuffer.bind(Poseidon2)],
149
- [Sha256Compression.opcode, Instruction.fromBuffer.bind(Sha256Compression)],
150
- [KeccakF1600.opcode, Instruction.fromBuffer.bind(KeccakF1600)],
151
-
152
- // Conversions
153
- [ToRadixBE.opcode, Instruction.fromBuffer.bind(ToRadixBE)],
154
- ]);
155
-
156
- /**
157
- * Serializes an array of instructions to bytecode.
158
- */
159
- export function encodeToBytecode(instructions: Bufferable[]): Buffer {
160
- return serializeToBuffer(instructions);
161
- }
162
-
163
- // For testing only
164
- export function decodeFromBytecode(bytecode: Buffer, instructionSet: InstructionSet = INSTRUCTION_SET): Instruction[] {
165
- const instructions: Instruction[] = [];
166
- let pc = 0;
167
- while (pc < bytecode.length) {
168
- const [instruction, bytesConsumed] = decodeInstructionFromBytecode(bytecode, pc, instructionSet);
169
- instructions.push(instruction);
170
- pc += bytesConsumed;
171
- }
172
- return instructions;
173
- }
174
-
175
- // Returns the instruction and the number of bytes consumed.
176
- export function decodeInstructionFromBytecode(
177
- bytecode: Buffer,
178
- pc: number,
179
- instructionSet: InstructionSet = INSTRUCTION_SET,
180
- ): [Instruction, number] {
181
- if (pc >= bytecode.length) {
182
- throw new InvalidProgramCounterError(pc, bytecode.length - 1);
183
- }
184
-
185
- try {
186
- const cursor = new BufferCursor(bytecode, pc);
187
- const startingPosition = cursor.position();
188
- const opcode: number = cursor.bufferAtPosition().readUint8(); // peek.
189
-
190
- if (opcode > MAX_OPCODE_VALUE) {
191
- throw new InvalidOpcodeError(
192
- `Opcode ${opcode} (0x${opcode.toString(16)}) value is not in the range of valid opcodes (at PC ${pc}).`,
193
- );
194
- }
195
-
196
- const instructionDeserializerOrUndef = instructionSet.get(opcode);
197
- if (instructionDeserializerOrUndef === undefined) {
198
- throw new InvalidOpcodeError(`Opcode ${Opcode[opcode]} (0x${opcode.toString(16)}) is not implemented`);
199
- }
200
-
201
- const instructionDeserializer: InstructionDeserializer = instructionDeserializerOrUndef;
202
-
203
- const instruction = instructionDeserializer(cursor);
204
- return [instruction, cursor.position() - startingPosition];
205
- } catch (error) {
206
- if (error instanceof InvalidTagValueError || error instanceof InvalidOpcodeError) {
207
- throw duringInstrFetch(error, pc);
208
- } else if (error instanceof AvmExecutionError) {
209
- throw new AvmParsingError(`Instruction parsing error at pc ${pc}: ${error.message}`);
210
- } else {
211
- const msg = error instanceof Error ? `: ${error.message}` : '';
212
- throw new AvmParsingError(`Instruction fetching error at pc ${pc}${msg}`);
213
- }
214
- }
215
- }
@@ -1,249 +0,0 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
-
3
- import { strict as assert } from 'assert';
4
-
5
- import { TaggedMemory } from '../avm_memory_types.js';
6
- import { BufferCursor } from './buffer_cursor.js';
7
-
8
- /**
9
- * All AVM opcodes. (Keep in sync with cpp counterpart code avm_opcode.hpp and rs in opcodes.rs).
10
- * Source: https://yp-aztec.netlify.app/docs/public-vm/instruction-set
11
- */
12
- export enum Opcode {
13
- // Compute
14
- ADD_8,
15
- ADD_16,
16
- SUB_8,
17
- SUB_16,
18
- MUL_8,
19
- MUL_16,
20
- DIV_8,
21
- DIV_16,
22
- FDIV_8,
23
- FDIV_16,
24
- EQ_8,
25
- EQ_16,
26
- LT_8,
27
- LT_16,
28
- LTE_8,
29
- LTE_16,
30
- AND_8,
31
- AND_16,
32
- OR_8,
33
- OR_16,
34
- XOR_8,
35
- XOR_16,
36
- NOT_8,
37
- NOT_16,
38
- SHL_8,
39
- SHL_16,
40
- SHR_8,
41
- SHR_16,
42
- CAST_8,
43
- CAST_16,
44
- // Execution environment
45
- GETENVVAR_16,
46
- CALLDATACOPY,
47
- SUCCESSCOPY,
48
- RETURNDATASIZE,
49
- RETURNDATACOPY,
50
- // Control flow
51
- JUMP_32,
52
- JUMPI_32,
53
- INTERNALCALL,
54
- INTERNALRETURN,
55
- // Memory
56
- SET_8,
57
- SET_16,
58
- SET_32,
59
- SET_64,
60
- SET_128,
61
- SET_FF,
62
- MOV_8,
63
- MOV_16,
64
- // World state
65
- SLOAD,
66
- SSTORE,
67
- NOTEHASHEXISTS,
68
- EMITNOTEHASH,
69
- NULLIFIEREXISTS,
70
- EMITNULLIFIER,
71
- L1TOL2MSGEXISTS,
72
- GETCONTRACTINSTANCE,
73
- EMITUNENCRYPTEDLOG,
74
- SENDL2TOL1MSG,
75
- // External calls
76
- CALL,
77
- STATICCALL,
78
- RETURN,
79
- REVERT_8,
80
- REVERT_16,
81
- // Misc
82
- DEBUGLOG,
83
- // Gadgets
84
- POSEIDON2,
85
- SHA256COMPRESSION,
86
- KECCAKF1600,
87
- ECADD,
88
- // Conversion
89
- TORADIXBE,
90
- }
91
-
92
- export const MAX_OPCODE_VALUE = Math.max(
93
- ...Object.values(Opcode)
94
- .map(k => +k)
95
- .filter(k => !isNaN(k)),
96
- );
97
-
98
- // Possible types for an instruction's operand in its wire format.
99
- // The counterpart cpp file is: vm2/simulation/lib/serialization.hpp.
100
- export enum OperandType {
101
- UINT8,
102
- UINT16,
103
- UINT32,
104
- UINT64,
105
- UINT128,
106
- FF,
107
- TAG,
108
- }
109
-
110
- // Define a type that represents the possible types of the deserialized values.
111
- type DeserializedValue = number | bigint;
112
-
113
- type OperandNativeType = number | bigint;
114
- type OperandWriter = (value: any) => void;
115
-
116
- // Specifies how to read and write each operand type.
117
- const OPERAND_SPEC = new Map<OperandType, [number, (offset: number) => OperandNativeType, OperandWriter]>([
118
- [OperandType.UINT8, [1, Buffer.prototype.readUint8, Buffer.prototype.writeUint8]],
119
- [OperandType.UINT16, [2, Buffer.prototype.readUint16BE, Buffer.prototype.writeUint16BE]],
120
- [OperandType.UINT32, [4, Buffer.prototype.readUint32BE, Buffer.prototype.writeUint32BE]],
121
- [OperandType.UINT64, [8, readUint64BE, writeUint64BE]],
122
- [OperandType.UINT128, [16, readUint128BE, writeUint128BE]],
123
- [OperandType.FF, [32, readUint254BE, writeUint254BE]],
124
- [OperandType.TAG, [1, Buffer.prototype.readUint8, Buffer.prototype.writeUint8]],
125
- ]);
126
-
127
- /**
128
- * Returns the size of an operand in bytes.
129
- * Should not be called with unknown operand types.
130
- * @param operandType
131
- * @returns number size in bytes
132
- * @throws AssertionError if the operand type is unknown
133
- */
134
- export function getOperandSize(operandType: OperandType): number {
135
- assert(OPERAND_SPEC.has(operandType), `Unknown operand type: ${operandType}`);
136
- return OPERAND_SPEC.get(operandType)![0];
137
- }
138
-
139
- function readUintBE(buf: Buffer, offset: number, totalBytes: number): bigint {
140
- let value: bigint = 0n;
141
- for (let i = 0; i < totalBytes; ++i) {
142
- value <<= 8n;
143
- value |= BigInt(buf.readUint8(i + offset));
144
- }
145
- return value;
146
- }
147
-
148
- function writeUintBE(buf: Buffer, value: bigint, totalBytes: number): void {
149
- for (let offset = totalBytes - 1; offset >= 0; --offset) {
150
- buf.writeUint8(Number(value & 0xffn), offset);
151
- value >>= 8n;
152
- }
153
- }
154
-
155
- function readUint64BE(this: Buffer, offset: number): bigint {
156
- return readUintBE(this, offset, 8);
157
- }
158
-
159
- function writeUint64BE(this: Buffer, value: bigint): void {
160
- writeUintBE(this, value, 8);
161
- }
162
-
163
- function readUint254BE(this: Buffer, offset: number): bigint {
164
- let value = readUintBE(this, offset, 32);
165
-
166
- // In circuit, we only support values up to Fr.MODULUS and any deserialized value
167
- // would naturally undergo a modulus reduction.
168
- if (value >= Fr.MODULUS) {
169
- value = value % Fr.MODULUS;
170
- }
171
-
172
- return value;
173
- }
174
-
175
- function writeUint254BE(this: Buffer, value: bigint): void {
176
- writeUintBE(this, value, 32);
177
- }
178
-
179
- function readUint128BE(this: Buffer, offset: number): bigint {
180
- return readUintBE(this, offset, 16);
181
- }
182
-
183
- function writeUint128BE(this: Buffer, value: bigint): void {
184
- writeUintBE(this, value, 16);
185
- }
186
-
187
- /**
188
- * Reads an array of operands from a buffer.
189
- * @param cursor Buffer to read from. Might be longer than needed.
190
- * @param operands Specification of the operand types.
191
- * @returns An array as big as {@code operands}, with the converted TS values.
192
- */
193
- export function deserialize(cursor: BufferCursor | Buffer, operands: OperandType[]): DeserializedValue[] {
194
- const argValues: DeserializedValue[] = [];
195
- if (Buffer.isBuffer(cursor)) {
196
- cursor = new BufferCursor(cursor);
197
- }
198
-
199
- for (const opType of operands) {
200
- const [sizeBytes, reader, _writer] = OPERAND_SPEC.get(opType)!;
201
- const value = reader.call(cursor.buffer(), cursor.position());
202
- argValues.push(value);
203
- cursor.advance(sizeBytes);
204
- }
205
-
206
- // We first want to detect other parsing errors (e.g., instruction size
207
- // is longer than remaining bytes) first and therefore tag validation is done after completion
208
- // of parsing above. Order of errors need to match with circuit.
209
- for (let i = 0; i < operands.length; i++) {
210
- if (operands[i] === OperandType.TAG) {
211
- // We parsed a single byte (readUInt8()) and therefore value is of number type (not bigint)
212
- // We need to cast to number because checkIsValidTag expects a number.
213
- TaggedMemory.checkIsValidTag(Number(argValues[i] ?? 0));
214
- }
215
- }
216
-
217
- return argValues;
218
- }
219
-
220
- /**
221
- * Serializes a class using the specified operand types.
222
- * More specifically, this serializes {@code [cls.constructor.opcode, ...Object.values(cls)]}.
223
- * Observe in particular that:
224
- * (1) the first operand type specified must correspond to the opcode;
225
- * (2) the rest of the operand types must be specified in the order returned by {@code Object.values()}.
226
- * @param operands Type specification for the values to be serialized.
227
- * @param cls The class to be serialized.
228
- * @returns
229
- */
230
- export function serializeAs(operands: OperandType[], opcode: Opcode, cls: any): Buffer {
231
- const chunks: Buffer[] = [];
232
-
233
- const rawClassValues: any[] = [opcode, ...Object.values(cls)];
234
- assert(
235
- rawClassValues.length === operands.length,
236
- `Got ${rawClassValues.length} values but only ${operands.length} serialization operands are specified!`,
237
- );
238
- const classValues = rawClassValues as OperandNativeType[];
239
-
240
- for (let i = 0; i < operands.length; i++) {
241
- const opType = operands[i];
242
- const [sizeBytes, _reader, writer] = OPERAND_SPEC.get(opType)!;
243
- const buf = Buffer.alloc(sizeBytes);
244
- writer.call(buf, classValues[i]);
245
- chunks.push(buf);
246
- }
247
-
248
- return Buffer.concat(chunks);
249
- }
@@ -1,64 +0,0 @@
1
- import { Fr } from '@aztec/foundation/fields';
2
- import type { ContractClassPublic, ContractInstanceWithAddress } from '@aztec/stdlib/contract';
3
-
4
- import type { jest } from '@jest/globals';
5
- import { mock } from 'jest-mock-extended';
6
-
7
- import type { PublicContractsDB, PublicTreesDB } from '../public_db_sources.js';
8
- import type { PublicSideEffectTraceInterface } from '../side_effect_trace_interface.js';
9
-
10
- export function mockTraceFork(trace: PublicSideEffectTraceInterface, nestedTrace?: PublicSideEffectTraceInterface) {
11
- (trace as jest.Mocked<PublicSideEffectTraceInterface>).fork.mockReturnValue(
12
- nestedTrace ?? mock<PublicSideEffectTraceInterface>(),
13
- );
14
- }
15
-
16
- export function mockStorageRead(worldStateDB: PublicTreesDB, value: Fr) {
17
- (worldStateDB as jest.Mocked<PublicTreesDB>).storageRead.mockResolvedValue(value);
18
- }
19
-
20
- export function mockNoteHashCount(mockedTrace: PublicSideEffectTraceInterface, count: number) {
21
- (mockedTrace as jest.Mocked<PublicSideEffectTraceInterface>).getNoteHashCount.mockReturnValue(count);
22
- }
23
-
24
- export function mockStorageReadWithMap(worldStateDB: PublicTreesDB, mockedStorage: Map<bigint, Fr>) {
25
- (worldStateDB as jest.Mocked<PublicTreesDB>).storageRead.mockImplementation((_address, slot) =>
26
- Promise.resolve(mockedStorage.get(slot.toBigInt()) ?? Fr.ZERO),
27
- );
28
- }
29
-
30
- export function mockGetNoteHash(worldStateDB: PublicTreesDB, _leafIndex: bigint, value?: Fr) {
31
- (worldStateDB as jest.Mocked<PublicTreesDB>).getNoteHash.mockImplementation((index: bigint) => {
32
- if (index == _leafIndex && value) {
33
- return Promise.resolve(value);
34
- } else {
35
- return Promise.resolve(Fr.ZERO);
36
- }
37
- });
38
- }
39
-
40
- export function mockCheckNullifierExists(worldStateDB: PublicTreesDB, exists: boolean, _ignoredValue?: Fr) {
41
- (worldStateDB as jest.Mocked<PublicTreesDB>).checkNullifierExists.mockResolvedValue(exists);
42
- }
43
-
44
- export function mockGetL1ToL2LeafValue(worldStateDB: PublicTreesDB, leafIndex: bigint, value?: Fr) {
45
- (worldStateDB as jest.Mocked<PublicTreesDB>).getL1ToL2LeafValue.mockImplementation((index: bigint) => {
46
- if (index == leafIndex && value) {
47
- return Promise.resolve(value);
48
- } else {
49
- return Promise.resolve(Fr.ZERO!);
50
- }
51
- });
52
- }
53
-
54
- export function mockGetContractInstance(contractsDB: PublicContractsDB, contractInstance: ContractInstanceWithAddress) {
55
- (contractsDB as jest.Mocked<PublicContractsDB>).getContractInstance.mockResolvedValue(contractInstance);
56
- }
57
-
58
- export function mockGetContractClass(contractsDB: PublicContractsDB, contractClass: ContractClassPublic) {
59
- (contractsDB as jest.Mocked<PublicContractsDB>).getContractClass.mockResolvedValue(contractClass);
60
- }
61
-
62
- export function mockGetBytecodeCommitment(contractsDB: PublicContractsDB, commitment: Fr) {
63
- (contractsDB as jest.Mocked<PublicContractsDB>).getBytecodeCommitment.mockResolvedValue(commitment);
64
- }