@aztec/simulator 0.0.1-commit.b655e406 → 0.0.1-commit.b8a057fa

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 (405) 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 +2 -2
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/common/index.d.ts +1 -1
  8. package/dest/common/stats/index.d.ts +1 -1
  9. package/dest/common/stats/stats.d.ts +1 -1
  10. package/dest/private/acvm/acvm.d.ts +4 -2
  11. package/dest/private/acvm/acvm.d.ts.map +1 -1
  12. package/dest/private/acvm/acvm.js +4 -3
  13. package/dest/private/acvm/acvm_types.d.ts +1 -1
  14. package/dest/private/acvm/deserialize.d.ts +2 -2
  15. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  16. package/dest/private/acvm/deserialize.js +1 -1
  17. package/dest/private/acvm/index.d.ts +1 -1
  18. package/dest/private/acvm/serialize.d.ts +2 -2
  19. package/dest/private/acvm/serialize.d.ts.map +1 -1
  20. package/dest/private/acvm/serialize.js +1 -1
  21. package/dest/private/acvm_native.d.ts +5 -3
  22. package/dest/private/acvm_native.d.ts.map +1 -1
  23. package/dest/private/acvm_native.js +8 -6
  24. package/dest/private/acvm_wasm.d.ts +4 -3
  25. package/dest/private/acvm_wasm.d.ts.map +1 -1
  26. package/dest/private/acvm_wasm.js +7 -5
  27. package/dest/private/acvm_wasm_with_blobs.d.ts +1 -1
  28. package/dest/private/acvm_wasm_with_blobs.d.ts.map +1 -1
  29. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  30. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  31. package/dest/private/circuit_recording/circuit_recorder.js +71 -72
  32. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  33. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  34. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  35. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  36. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  37. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  38. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  39. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  40. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  41. package/dest/private/circuit_simulator.d.ts +1 -1
  42. package/dest/private/factory.d.ts +3 -3
  43. package/dest/private/factory.d.ts.map +1 -1
  44. package/dest/private/factory.js +7 -4
  45. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  46. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  47. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  48. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +3 -2
  49. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  50. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +19 -4
  51. package/dest/public/avm/{fixtures → testing}/utils.d.ts +4 -10
  52. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  53. package/dest/public/avm/{fixtures → testing}/utils.js +7 -36
  54. package/dest/public/avm_simulator.d.ts +28 -0
  55. package/dest/public/avm_simulator.d.ts.map +1 -0
  56. package/dest/public/avm_simulator.js +4 -0
  57. package/dest/public/avm_simulator_pool.d.ts +45 -0
  58. package/dest/public/avm_simulator_pool.d.ts.map +1 -0
  59. package/dest/public/avm_simulator_pool.js +197 -0
  60. package/dest/public/cdb/generated/api_types.d.ts +171 -0
  61. package/dest/public/cdb/generated/api_types.d.ts.map +1 -0
  62. package/dest/public/cdb/generated/api_types.js +314 -0
  63. package/dest/public/cdb/generated/server.d.ts +26 -0
  64. package/dest/public/cdb/generated/server.d.ts.map +1 -0
  65. package/dest/public/cdb/generated/server.js +135 -0
  66. package/dest/public/cdb_ipc_server.d.ts +33 -0
  67. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  68. package/dest/public/cdb_ipc_server.js +153 -0
  69. package/dest/public/contracts_db_checkpoint.d.ts +16 -0
  70. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -0
  71. package/dest/public/contracts_db_checkpoint.js +30 -0
  72. package/dest/public/db_interfaces.d.ts +14 -2
  73. package/dest/public/db_interfaces.d.ts.map +1 -1
  74. package/dest/public/executor_metrics.d.ts +3 -2
  75. package/dest/public/executor_metrics.d.ts.map +1 -1
  76. package/dest/public/executor_metrics.js +13 -34
  77. package/dest/public/executor_metrics_interface.d.ts +3 -2
  78. package/dest/public/executor_metrics_interface.d.ts.map +1 -1
  79. package/dest/public/fixtures/amm_test.d.ts +1 -1
  80. package/dest/public/fixtures/amm_test.js +6 -6
  81. package/dest/public/fixtures/bulk_test.d.ts +3 -3
  82. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  83. package/dest/public/fixtures/bulk_test.js +38 -75
  84. package/dest/public/fixtures/custom_bytecode_tester.d.ts +29 -7
  85. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  86. package/dest/public/fixtures/custom_bytecode_tester.js +36 -12
  87. package/dest/public/fixtures/index.d.ts +3 -3
  88. package/dest/public/fixtures/index.d.ts.map +1 -1
  89. package/dest/public/fixtures/index.js +2 -2
  90. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  91. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  92. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  93. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +32 -9
  94. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  95. package/dest/public/fixtures/public_tx_simulation_tester.js +84 -26
  96. package/dest/public/fixtures/simple_contract_data_source.d.ts +5 -4
  97. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -1
  98. package/dest/public/fixtures/simple_contract_data_source.js +5 -5
  99. package/dest/public/fixtures/token_test.d.ts +6 -2
  100. package/dest/public/fixtures/token_test.d.ts.map +1 -1
  101. package/dest/public/fixtures/token_test.js +16 -15
  102. package/dest/public/fixtures/utils.d.ts +3 -3
  103. package/dest/public/fixtures/utils.d.ts.map +1 -1
  104. package/dest/public/fixtures/utils.js +25 -23
  105. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +67 -0
  106. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -0
  107. package/dest/public/fuzzing/avm_fuzzer_simulator.js +185 -0
  108. package/dest/public/fuzzing/avm_simulator_bin.d.ts +2 -0
  109. package/dest/public/fuzzing/avm_simulator_bin.d.ts.map +1 -0
  110. package/dest/public/fuzzing/avm_simulator_bin.js +118 -0
  111. package/dest/public/index.d.ts +6 -2
  112. package/dest/public/index.d.ts.map +1 -1
  113. package/dest/public/index.js +2 -1
  114. package/dest/public/public_db_sources.d.ts +29 -66
  115. package/dest/public/public_db_sources.d.ts.map +1 -1
  116. package/dest/public/public_db_sources.js +83 -134
  117. package/dest/public/public_errors.d.ts +1 -1
  118. package/dest/public/public_errors.d.ts.map +1 -1
  119. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -5
  120. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  121. package/dest/public/public_processor/guarded_merkle_tree.js +12 -4
  122. package/dest/public/public_processor/public_processor.d.ts +24 -22
  123. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  124. package/dest/public/public_processor/public_processor.js +559 -125
  125. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  126. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  127. package/dest/public/public_processor/public_processor_metrics.js +36 -45
  128. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  129. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  130. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.js +39 -0
  131. package/dest/public/public_tx_simulator/factories.d.ts +14 -0
  132. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -0
  133. package/dest/public/public_tx_simulator/factories.js +28 -0
  134. package/dest/public/public_tx_simulator/index.d.ts +6 -4
  135. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  136. package/dest/public/public_tx_simulator/index.js +3 -2
  137. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +43 -90
  138. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  139. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -331
  140. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  141. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  142. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  143. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +25 -2
  144. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -1
  145. package/dest/public/side_effect_errors.d.ts +1 -1
  146. package/dest/public/side_effect_errors.d.ts.map +1 -1
  147. package/dest/public/test_executor_metrics.d.ts +6 -4
  148. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  149. package/dest/public/test_executor_metrics.js +7 -6
  150. package/dest/public/unique_class_ids.d.ts +1 -1
  151. package/dest/public/unique_class_ids.d.ts.map +1 -1
  152. package/dest/public/utils.d.ts +1 -1
  153. package/dest/server.d.ts +1 -1
  154. package/dest/testing.d.ts +1 -1
  155. package/package.json +26 -22
  156. package/src/client.ts +0 -2
  157. package/src/common/errors.ts +1 -1
  158. package/src/private/acvm/acvm.ts +4 -3
  159. package/src/private/acvm/deserialize.ts +1 -1
  160. package/src/private/acvm/serialize.ts +1 -1
  161. package/src/private/acvm_native.ts +11 -5
  162. package/src/private/acvm_wasm.ts +11 -4
  163. package/src/private/circuit_recording/circuit_recorder.ts +90 -81
  164. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  165. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  166. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  167. package/src/private/factory.ts +7 -4
  168. package/src/public/avm/testing/account_proof.json +553 -0
  169. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  170. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +24 -4
  171. package/src/public/avm/{fixtures → testing}/utils.ts +7 -42
  172. package/src/public/avm_simulator.ts +29 -0
  173. package/src/public/avm_simulator_pool.ts +226 -0
  174. package/src/public/cdb/generated/api_types.ts +457 -0
  175. package/src/public/cdb/generated/server.ts +109 -0
  176. package/src/public/cdb_ipc_server.ts +197 -0
  177. package/src/public/contracts_db_checkpoint.ts +41 -0
  178. package/src/public/db_interfaces.ts +16 -1
  179. package/src/public/executor_metrics.ts +11 -34
  180. package/src/public/executor_metrics_interface.ts +2 -1
  181. package/src/public/fixtures/amm_test.ts +6 -6
  182. package/src/public/fixtures/bulk_test.ts +40 -15
  183. package/src/public/fixtures/custom_bytecode_tester.ts +54 -20
  184. package/src/public/fixtures/index.ts +6 -2
  185. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  186. package/src/public/fixtures/public_tx_simulation_tester.ts +117 -26
  187. package/src/public/fixtures/simple_contract_data_source.ts +9 -10
  188. package/src/public/fixtures/token_test.ts +21 -13
  189. package/src/public/fixtures/utils.ts +25 -27
  190. package/src/public/fuzzing/avm_fuzzer_simulator.ts +303 -0
  191. package/src/public/fuzzing/avm_simulator_bin.ts +173 -0
  192. package/src/public/index.ts +8 -2
  193. package/src/public/public_db_sources.ts +112 -174
  194. package/src/public/public_processor/guarded_merkle_tree.ts +14 -6
  195. package/src/public/public_processor/public_processor.ts +234 -138
  196. package/src/public/public_processor/public_processor_metrics.ts +28 -44
  197. package/src/public/public_tx_simulator/dumping_public_tx_simulator.ts +67 -0
  198. package/src/public/public_tx_simulator/factories.ts +61 -0
  199. package/src/public/public_tx_simulator/index.ts +8 -3
  200. package/src/public/public_tx_simulator/public_tx_simulator.ts +142 -500
  201. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  202. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +24 -2
  203. package/src/public/test_executor_metrics.ts +10 -8
  204. package/dest/public/avm/avm_context.d.ts +0 -41
  205. package/dest/public/avm/avm_context.d.ts.map +0 -1
  206. package/dest/public/avm/avm_context.js +0 -44
  207. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  208. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  209. package/dest/public/avm/avm_contract_call_result.js +0 -54
  210. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  211. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  212. package/dest/public/avm/avm_execution_environment.js +0 -36
  213. package/dest/public/avm/avm_gas.d.ts +0 -44
  214. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  215. package/dest/public/avm/avm_gas.js +0 -195
  216. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  217. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  218. package/dest/public/avm/avm_machine_state.js +0 -109
  219. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  220. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  221. package/dest/public/avm/avm_memory_types.js +0 -351
  222. package/dest/public/avm/avm_simulator.d.ts +0 -39
  223. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  224. package/dest/public/avm/avm_simulator.js +0 -190
  225. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  226. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  227. package/dest/public/avm/avm_simulator_interface.js +0 -3
  228. package/dest/public/avm/errors.d.ts +0 -98
  229. package/dest/public/avm/errors.d.ts.map +0 -1
  230. package/dest/public/avm/errors.js +0 -129
  231. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  232. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  233. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -74
  234. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  235. package/dest/public/avm/fixtures/initializers.d.ts +0 -43
  236. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  237. package/dest/public/avm/fixtures/initializers.js +0 -42
  238. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  239. package/dest/public/avm/index.d.ts +0 -2
  240. package/dest/public/avm/index.d.ts.map +0 -1
  241. package/dest/public/avm/index.js +0 -1
  242. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  243. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  244. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  245. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  246. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  247. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  248. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -47
  249. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  250. package/dest/public/avm/opcodes/arithmetic.js +0 -87
  251. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  252. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  253. package/dest/public/avm/opcodes/bitwise.js +0 -99
  254. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  255. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  256. package/dest/public/avm/opcodes/comparators.js +0 -43
  257. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  258. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  259. package/dest/public/avm/opcodes/contract.js +0 -65
  260. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  261. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  262. package/dest/public/avm/opcodes/control_flow.js +0 -107
  263. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  264. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  265. package/dest/public/avm/opcodes/conversion.js +0 -333
  266. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  267. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  268. package/dest/public/avm/opcodes/ec_add.js +0 -84
  269. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  270. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  271. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  272. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  273. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  274. package/dest/public/avm/opcodes/external_calls.js +0 -209
  275. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  276. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  277. package/dest/public/avm/opcodes/hashing.js +0 -114
  278. package/dest/public/avm/opcodes/index.d.ts +0 -16
  279. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  280. package/dest/public/avm/opcodes/index.js +0 -15
  281. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  282. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  283. package/dest/public/avm/opcodes/instruction.js +0 -95
  284. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  285. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  286. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  287. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  288. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  289. package/dest/public/avm/opcodes/memory.js +0 -257
  290. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  291. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  292. package/dest/public/avm/opcodes/misc.js +0 -73
  293. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  294. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  295. package/dest/public/avm/opcodes/storage.js +0 -68
  296. package/dest/public/avm/revert_reason.d.ts +0 -18
  297. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  298. package/dest/public/avm/revert_reason.js +0 -38
  299. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  300. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  301. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  302. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  303. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  304. package/dest/public/avm/serialization/bytecode_serialization.js +0 -333
  305. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  306. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  307. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  308. package/dest/public/avm/test_utils.d.ts +0 -15
  309. package/dest/public/avm/test_utils.d.ts.map +0 -1
  310. package/dest/public/avm/test_utils.js +0 -44
  311. package/dest/public/debug_fn_name.d.ts +0 -5
  312. package/dest/public/debug_fn_name.d.ts.map +0 -1
  313. package/dest/public/debug_fn_name.js +0 -9
  314. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -9
  315. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  316. package/dest/public/fixtures/custom_bytecode_tests.js +0 -109
  317. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -10
  318. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  319. package/dest/public/fixtures/minimal_public_tx.js +0 -29
  320. package/dest/public/hinting_db_sources.d.ts +0 -70
  321. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  322. package/dest/public/hinting_db_sources.js +0 -297
  323. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -41
  324. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  325. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -89
  326. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -24
  327. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  328. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  329. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -127
  330. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  331. package/dest/public/public_tx_simulator/public_tx_context.js +0 -292
  332. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  333. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  334. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -39
  335. package/dest/public/side_effect_trace.d.ts +0 -87
  336. package/dest/public/side_effect_trace.d.ts.map +0 -1
  337. package/dest/public/side_effect_trace.js +0 -199
  338. package/dest/public/side_effect_trace_interface.d.ts +0 -23
  339. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  340. package/dest/public/side_effect_trace_interface.js +0 -1
  341. package/dest/public/state_manager/index.d.ts +0 -2
  342. package/dest/public/state_manager/index.d.ts.map +0 -1
  343. package/dest/public/state_manager/index.js +0 -1
  344. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  345. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  346. package/dest/public/state_manager/nullifiers.js +0 -92
  347. package/dest/public/state_manager/public_storage.d.ts +0 -66
  348. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  349. package/dest/public/state_manager/public_storage.js +0 -145
  350. package/dest/public/state_manager/state_manager.d.ts +0 -166
  351. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  352. package/dest/public/state_manager/state_manager.js +0 -391
  353. package/dest/public/tx_contract_cache.d.ts +0 -41
  354. package/dest/public/tx_contract_cache.d.ts.map +0 -1
  355. package/dest/public/tx_contract_cache.js +0 -49
  356. package/src/public/avm/avm_context.ts +0 -61
  357. package/src/public/avm/avm_contract_call_result.ts +0 -67
  358. package/src/public/avm/avm_execution_environment.ts +0 -48
  359. package/src/public/avm/avm_gas.ts +0 -183
  360. package/src/public/avm/avm_machine_state.ts +0 -169
  361. package/src/public/avm/avm_memory_types.ts +0 -436
  362. package/src/public/avm/avm_simulator.ts +0 -274
  363. package/src/public/avm/avm_simulator_interface.ts +0 -8
  364. package/src/public/avm/errors.ts +0 -163
  365. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -108
  366. package/src/public/avm/fixtures/initializers.ts +0 -104
  367. package/src/public/avm/index.ts +0 -1
  368. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  369. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  370. package/src/public/avm/opcodes/arithmetic.ts +0 -117
  371. package/src/public/avm/opcodes/bitwise.ts +0 -113
  372. package/src/public/avm/opcodes/comparators.ts +0 -55
  373. package/src/public/avm/opcodes/contract.ts +0 -75
  374. package/src/public/avm/opcodes/control_flow.ts +0 -123
  375. package/src/public/avm/opcodes/conversion.ts +0 -104
  376. package/src/public/avm/opcodes/ec_add.ts +0 -96
  377. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  378. package/src/public/avm/opcodes/external_calls.ts +0 -260
  379. package/src/public/avm/opcodes/hashing.ts +0 -145
  380. package/src/public/avm/opcodes/index.ts +0 -15
  381. package/src/public/avm/opcodes/instruction.ts +0 -136
  382. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  383. package/src/public/avm/opcodes/memory.ts +0 -293
  384. package/src/public/avm/opcodes/misc.ts +0 -102
  385. package/src/public/avm/opcodes/storage.ts +0 -87
  386. package/src/public/avm/revert_reason.ts +0 -55
  387. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  388. package/src/public/avm/serialization/bytecode_serialization.ts +0 -204
  389. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  390. package/src/public/avm/test_utils.ts +0 -64
  391. package/src/public/debug_fn_name.ts +0 -18
  392. package/src/public/fixtures/custom_bytecode_tests.ts +0 -135
  393. package/src/public/fixtures/minimal_public_tx.ts +0 -36
  394. package/src/public/hinting_db_sources.ts +0 -505
  395. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -128
  396. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -109
  397. package/src/public/public_tx_simulator/public_tx_context.ts +0 -471
  398. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  399. package/src/public/side_effect_trace.ts +0 -290
  400. package/src/public/side_effect_trace_interface.ts +0 -28
  401. package/src/public/state_manager/index.ts +0 -1
  402. package/src/public/state_manager/nullifiers.ts +0 -103
  403. package/src/public/state_manager/public_storage.ts +0 -174
  404. package/src/public/state_manager/state_manager.ts +0 -560
  405. package/src/public/tx_contract_cache.ts +0 -69
@@ -1,55 +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 fnName = await context.persistableState.getPublicFunctionDebugName(context.environment);
22
-
23
- return new AvmRevertReason(
24
- message,
25
- /*failingFunction=*/ {
26
- contractAddress: context.environment.address,
27
- functionName: fnName,
28
- },
29
- /*noirCallStack=*/ [...internalCallStack, context.machineState.pc].map(pc => `0.${pc}`),
30
- /*options=*/ { cause: nestedError },
31
- );
32
- }
33
-
34
- /**
35
- * Create a "revert reason" error for an exceptional halt.
36
- *
37
- * @param haltingError - the lower-level error causing the exceptional halt
38
- * @param context - the context of the AVM execution used to extract the failingFunction and noirCallStack
39
- */
40
- export async function revertReasonFromExceptionalHalt(
41
- haltingError: AvmExecutionError,
42
- context: AvmContext,
43
- ): Promise<AvmRevertReason> {
44
- return await createRevertReason(haltingError.message, [], context);
45
- }
46
-
47
- /**
48
- * Create a "revert reason" error for an explicit revert (a root cause).
49
- *
50
- * @param revertData - output data of the explicit REVERT instruction
51
- * @param context - the context of the AVM execution used to extract the failingFunction and noirCallStack
52
- */
53
- export async function revertReasonFromExplicitRevert(revertData: Fr[], context: AvmContext): Promise<AvmRevertReason> {
54
- return await createRevertReason('Assertion failed: ', revertData, context);
55
- }
@@ -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,204 +0,0 @@
1
- import { type Bufferable, serializeToBuffer } from '@aztec/foundation/serialize';
2
-
3
- import { AvmExecutionError, AvmParsingError, InvalidOpcodeError, InvalidProgramCounterError } from '../errors.js';
4
- import {
5
- Add,
6
- And,
7
- Call,
8
- CalldataCopy,
9
- Cast,
10
- DebugLog,
11
- Div,
12
- EcAdd,
13
- EmitNoteHash,
14
- EmitNullifier,
15
- EmitUnencryptedLog,
16
- Eq,
17
- FieldDiv,
18
- GetContractInstance,
19
- GetEnvVar,
20
- Instruction,
21
- InternalCall,
22
- InternalReturn,
23
- Jump,
24
- JumpI,
25
- KeccakF1600,
26
- L1ToL2MessageExists,
27
- Lt,
28
- Lte,
29
- Mov,
30
- Mul,
31
- Not,
32
- NoteHashExists,
33
- NullifierExists,
34
- Or,
35
- Poseidon2,
36
- Return,
37
- ReturndataCopy,
38
- ReturndataSize,
39
- Revert,
40
- SLoad,
41
- SStore,
42
- SendL2ToL1Message,
43
- Set,
44
- Sha256Compression,
45
- Shl,
46
- Shr,
47
- StaticCall,
48
- Sub,
49
- SuccessCopy,
50
- ToRadixBE,
51
- Xor,
52
- } from '../opcodes/index.js';
53
- import { BufferCursor } from './buffer_cursor.js';
54
- import { MAX_OPCODE_VALUE, Opcode } from './instruction_serialization.js';
55
-
56
- export type InstructionDeserializer = (buf: BufferCursor | Buffer) => Instruction;
57
-
58
- export interface Deserializable {
59
- deserialize: InstructionDeserializer;
60
- }
61
-
62
- export type InstructionSet = Map<Opcode, InstructionDeserializer>;
63
- export const INSTRUCTION_SET = new Map<Opcode, InstructionDeserializer>([
64
- [Opcode.ADD_8, Add.as(Add.wireFormat8).fromBuffer],
65
- [Opcode.ADD_16, Add.as(Add.wireFormat16).fromBuffer],
66
- [Opcode.SUB_8, Sub.as(Sub.wireFormat8).fromBuffer],
67
- [Opcode.SUB_16, Sub.as(Sub.wireFormat16).fromBuffer],
68
- [Opcode.MUL_8, Mul.as(Mul.wireFormat8).fromBuffer],
69
- [Opcode.MUL_16, Mul.as(Mul.wireFormat16).fromBuffer],
70
- [Opcode.DIV_8, Div.as(Div.wireFormat8).fromBuffer],
71
- [Opcode.DIV_16, Div.as(Div.wireFormat16).fromBuffer],
72
- [Opcode.FDIV_8, FieldDiv.as(FieldDiv.wireFormat8).fromBuffer],
73
- [Opcode.FDIV_16, FieldDiv.as(FieldDiv.wireFormat16).fromBuffer],
74
- [Opcode.EQ_8, Eq.as(Eq.wireFormat8).fromBuffer],
75
- [Opcode.EQ_16, Eq.as(Eq.wireFormat16).fromBuffer],
76
- [Opcode.LT_8, Lt.as(Lt.wireFormat8).fromBuffer],
77
- [Opcode.LT_16, Lt.as(Lt.wireFormat16).fromBuffer],
78
- [Opcode.LTE_8, Lte.as(Lte.wireFormat8).fromBuffer],
79
- [Opcode.LTE_16, Lte.as(Lte.wireFormat16).fromBuffer],
80
- [Opcode.AND_8, And.as(And.wireFormat8).fromBuffer],
81
- [Opcode.AND_16, And.as(And.wireFormat16).fromBuffer],
82
- [Opcode.OR_8, Or.as(Or.wireFormat8).fromBuffer],
83
- [Opcode.OR_16, Or.as(Or.wireFormat16).fromBuffer],
84
- [Opcode.XOR_8, Xor.as(Xor.wireFormat8).fromBuffer],
85
- [Opcode.XOR_16, Xor.as(Xor.wireFormat16).fromBuffer],
86
- [Opcode.NOT_8, Not.as(Not.wireFormat8).fromBuffer],
87
- [Opcode.NOT_16, Not.as(Not.wireFormat16).fromBuffer],
88
- [Opcode.SHL_8, Shl.as(Shl.wireFormat8).fromBuffer],
89
- [Opcode.SHL_16, Shl.as(Shl.wireFormat16).fromBuffer],
90
- [Opcode.SHR_8, Shr.as(Shr.wireFormat8).fromBuffer],
91
- [Opcode.SHR_16, Shr.as(Shr.wireFormat16).fromBuffer],
92
- [Opcode.CAST_8, Cast.as(Cast.wireFormat8).fromBuffer],
93
- [Opcode.CAST_16, Cast.as(Cast.wireFormat16).fromBuffer],
94
- // Execution Environment
95
- [Opcode.GETENVVAR_16, GetEnvVar.as(GetEnvVar.wireFormat16).fromBuffer],
96
- [CalldataCopy.opcode, Instruction.fromBuffer.bind(CalldataCopy)],
97
- [SuccessCopy.opcode, Instruction.fromBuffer.bind(SuccessCopy)],
98
- [Opcode.RETURNDATASIZE, Instruction.fromBuffer.bind(ReturndataSize)],
99
- [Opcode.RETURNDATACOPY, Instruction.fromBuffer.bind(ReturndataCopy)],
100
-
101
- // Machine State - Internal Control Flow
102
- [Jump.opcode, Instruction.fromBuffer.bind(Jump)],
103
- [JumpI.opcode, Instruction.fromBuffer.bind(JumpI)],
104
- [InternalCall.opcode, Instruction.fromBuffer.bind(InternalCall)],
105
- [InternalReturn.opcode, Instruction.fromBuffer.bind(InternalReturn)],
106
- [Opcode.SET_8, Set.as(Set.wireFormat8).fromBuffer],
107
- [Opcode.SET_16, Set.as(Set.wireFormat16).fromBuffer],
108
- [Opcode.SET_32, Set.as(Set.wireFormat32).fromBuffer],
109
- [Opcode.SET_64, Set.as(Set.wireFormat64).fromBuffer],
110
- [Opcode.SET_128, Set.as(Set.wireFormat128).fromBuffer],
111
- [Opcode.SET_FF, Set.as(Set.wireFormatFF).fromBuffer],
112
- [Opcode.MOV_8, Mov.as(Mov.wireFormat8).fromBuffer],
113
- [Opcode.MOV_16, Mov.as(Mov.wireFormat16).fromBuffer],
114
-
115
- // World State
116
- [SLoad.opcode, Instruction.fromBuffer.bind(SLoad)], // Public Storage
117
- [SStore.opcode, Instruction.fromBuffer.bind(SStore)], // Public Storage
118
- [NoteHashExists.opcode, Instruction.fromBuffer.bind(NoteHashExists)], // Notes & Nullifiers
119
- [EmitNoteHash.opcode, Instruction.fromBuffer.bind(EmitNoteHash)], // Notes & Nullifiers
120
- [NullifierExists.opcode, Instruction.fromBuffer.bind(NullifierExists)], // Notes & Nullifiers
121
- [EmitNullifier.opcode, Instruction.fromBuffer.bind(EmitNullifier)], // Notes & Nullifiers
122
- [L1ToL2MessageExists.opcode, Instruction.fromBuffer.bind(L1ToL2MessageExists)], // Messages
123
-
124
- // Accrued Substate
125
- [EmitUnencryptedLog.opcode, Instruction.fromBuffer.bind(EmitUnencryptedLog)],
126
- [SendL2ToL1Message.opcode, Instruction.fromBuffer.bind(SendL2ToL1Message)],
127
- [GetContractInstance.opcode, Instruction.fromBuffer.bind(GetContractInstance)],
128
-
129
- // Control Flow - Contract Calls
130
- [Call.opcode, Instruction.fromBuffer.bind(Call)],
131
- [StaticCall.opcode, Instruction.fromBuffer.bind(StaticCall)],
132
- [Return.opcode, Instruction.fromBuffer.bind(Return)],
133
- [Opcode.REVERT_8, Revert.as(Revert.wireFormat8).fromBuffer],
134
- [Opcode.REVERT_16, Revert.as(Revert.wireFormat16).fromBuffer],
135
-
136
- // Misc
137
- [DebugLog.opcode, Instruction.fromBuffer.bind(DebugLog)],
138
-
139
- // Gadgets
140
- [EcAdd.opcode, Instruction.fromBuffer.bind(EcAdd)],
141
- [Poseidon2.opcode, Instruction.fromBuffer.bind(Poseidon2)],
142
- [Sha256Compression.opcode, Instruction.fromBuffer.bind(Sha256Compression)],
143
- [KeccakF1600.opcode, Instruction.fromBuffer.bind(KeccakF1600)],
144
-
145
- // Conversions
146
- [ToRadixBE.opcode, Instruction.fromBuffer.bind(ToRadixBE)],
147
- ]);
148
-
149
- /**
150
- * Serializes an array of instructions to bytecode.
151
- */
152
- export function encodeToBytecode(instructions: Bufferable[]): Buffer {
153
- return serializeToBuffer(instructions);
154
- }
155
-
156
- // For testing only
157
- export function decodeFromBytecode(bytecode: Buffer, instructionSet: InstructionSet = INSTRUCTION_SET): Instruction[] {
158
- const instructions: Instruction[] = [];
159
- let pc = 0;
160
- while (pc < bytecode.length) {
161
- const [instruction, bytesConsumed] = decodeInstructionFromBytecode(bytecode, pc, instructionSet);
162
- instructions.push(instruction);
163
- pc += bytesConsumed;
164
- }
165
- return instructions;
166
- }
167
-
168
- // Returns the instruction and the number of bytes consumed.
169
- export function decodeInstructionFromBytecode(
170
- bytecode: Buffer,
171
- pc: number,
172
- instructionSet: InstructionSet = INSTRUCTION_SET,
173
- ): [Instruction, number] {
174
- if (pc >= bytecode.length) {
175
- throw new InvalidProgramCounterError(pc, bytecode.length);
176
- }
177
-
178
- try {
179
- const cursor = new BufferCursor(bytecode, pc);
180
- const startingPosition = cursor.position();
181
- const opcode: number = cursor.bufferAtPosition().readUint8(); // peek.
182
-
183
- if (opcode > MAX_OPCODE_VALUE) {
184
- throw new InvalidOpcodeError(
185
- `Opcode ${opcode} (0x${opcode.toString(16)}) value is not in the range of valid opcodes.`,
186
- );
187
- }
188
-
189
- const instructionDeserializerOrUndef = instructionSet.get(opcode);
190
- if (instructionDeserializerOrUndef === undefined) {
191
- throw new InvalidOpcodeError(`Opcode ${Opcode[opcode]} (0x${opcode.toString(16)}) is not implemented`);
192
- }
193
-
194
- const instructionDeserializer: InstructionDeserializer = instructionDeserializerOrUndef;
195
- const instruction = instructionDeserializer(cursor);
196
- return [instruction, cursor.position() - startingPosition];
197
- } catch (error) {
198
- if (error instanceof InvalidOpcodeError || error instanceof AvmExecutionError) {
199
- throw error;
200
- } else {
201
- throw new AvmParsingError(`${error}`);
202
- }
203
- }
204
- }
@@ -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
- }