@aztec/simulator 0.0.1-commit.d431d1c → 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 (378) hide show
  1. package/README.md +4 -4
  2. package/dest/client.d.ts +1 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +0 -2
  5. package/dest/private/acvm/acvm.d.ts +4 -2
  6. package/dest/private/acvm/acvm.d.ts.map +1 -1
  7. package/dest/private/acvm/acvm.js +4 -3
  8. package/dest/private/acvm_native.d.ts +5 -3
  9. package/dest/private/acvm_native.d.ts.map +1 -1
  10. package/dest/private/acvm_native.js +8 -6
  11. package/dest/private/acvm_wasm.d.ts +4 -3
  12. package/dest/private/acvm_wasm.d.ts.map +1 -1
  13. package/dest/private/acvm_wasm.js +7 -5
  14. package/dest/private/circuit_recording/circuit_recorder.d.ts +39 -25
  15. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  16. package/dest/private/circuit_recording/circuit_recorder.js +70 -72
  17. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +9 -20
  18. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  19. package/dest/private/circuit_recording/file_circuit_recorder.js +39 -43
  20. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  21. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  22. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  23. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +1 -1
  24. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -1
  25. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +11 -14
  26. package/dest/private/factory.d.ts +3 -3
  27. package/dest/private/factory.d.ts.map +1 -1
  28. package/dest/private/factory.js +7 -4
  29. package/dest/public/avm/testing/account_proof_fetcher.d.ts +2 -0
  30. package/dest/public/avm/testing/account_proof_fetcher.d.ts.map +1 -0
  31. package/dest/public/avm/testing/account_proof_fetcher.js +152 -0
  32. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.d.ts +2 -1
  33. package/dest/public/avm/testing/base_avm_simulation_tester.d.ts.map +1 -0
  34. package/dest/public/avm/{fixtures → testing}/base_avm_simulation_tester.js +18 -3
  35. package/dest/public/avm/testing/utils.d.ts +32 -0
  36. package/dest/public/avm/testing/utils.d.ts.map +1 -0
  37. package/dest/public/avm/{fixtures → testing}/utils.js +4 -34
  38. package/dest/public/avm_simulator.d.ts +28 -0
  39. package/dest/public/avm_simulator.d.ts.map +1 -0
  40. package/dest/public/avm_simulator.js +4 -0
  41. package/dest/public/avm_simulator_pool.d.ts +45 -0
  42. package/dest/public/avm_simulator_pool.d.ts.map +1 -0
  43. package/dest/public/avm_simulator_pool.js +197 -0
  44. package/dest/public/cdb/generated/api_types.d.ts +171 -0
  45. package/dest/public/cdb/generated/api_types.d.ts.map +1 -0
  46. package/dest/public/cdb/generated/api_types.js +314 -0
  47. package/dest/public/cdb/generated/server.d.ts +26 -0
  48. package/dest/public/cdb/generated/server.d.ts.map +1 -0
  49. package/dest/public/cdb/generated/server.js +135 -0
  50. package/dest/public/cdb_ipc_server.d.ts +33 -0
  51. package/dest/public/cdb_ipc_server.d.ts.map +1 -0
  52. package/dest/public/cdb_ipc_server.js +153 -0
  53. package/dest/public/contracts_db_checkpoint.d.ts +2 -2
  54. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  55. package/dest/public/contracts_db_checkpoint.js +1 -1
  56. package/dest/public/executor_metrics.d.ts +1 -1
  57. package/dest/public/executor_metrics.d.ts.map +1 -1
  58. package/dest/public/executor_metrics.js +7 -2
  59. package/dest/public/fixtures/amm_test.js +4 -4
  60. package/dest/public/fixtures/bulk_test.d.ts +1 -1
  61. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  62. package/dest/public/fixtures/bulk_test.js +33 -6
  63. package/dest/public/fixtures/custom_bytecode_tester.d.ts +1 -1
  64. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -1
  65. package/dest/public/fixtures/custom_bytecode_tester.js +2 -2
  66. package/dest/public/fixtures/index.d.ts +2 -4
  67. package/dest/public/fixtures/index.d.ts.map +1 -1
  68. package/dest/public/fixtures/index.js +1 -3
  69. package/dest/public/fixtures/public_processor_test_env.d.ts +30 -0
  70. package/dest/public/fixtures/public_processor_test_env.d.ts.map +1 -0
  71. package/dest/public/fixtures/public_processor_test_env.js +73 -0
  72. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +12 -7
  73. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  74. package/dest/public/fixtures/public_tx_simulation_tester.js +32 -15
  75. package/dest/public/fixtures/simple_contract_data_source.js +1 -1
  76. package/dest/public/fixtures/token_test.js +3 -3
  77. package/dest/public/fixtures/utils.d.ts +2 -2
  78. package/dest/public/fixtures/utils.d.ts.map +1 -1
  79. package/dest/public/fixtures/utils.js +21 -20
  80. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts +11 -4
  81. package/dest/public/fuzzing/avm_fuzzer_simulator.d.ts.map +1 -1
  82. package/dest/public/fuzzing/avm_fuzzer_simulator.js +24 -10
  83. package/dest/public/fuzzing/avm_simulator_bin.js +11 -8
  84. package/dest/public/index.d.ts +5 -2
  85. package/dest/public/index.d.ts.map +1 -1
  86. package/dest/public/index.js +2 -1
  87. package/dest/public/public_db_sources.d.ts +9 -5
  88. package/dest/public/public_db_sources.d.ts.map +1 -1
  89. package/dest/public/public_db_sources.js +20 -14
  90. package/dest/public/public_processor/guarded_merkle_tree.d.ts +8 -7
  91. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  92. package/dest/public/public_processor/guarded_merkle_tree.js +8 -5
  93. package/dest/public/public_processor/public_processor.d.ts +17 -8
  94. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  95. package/dest/public/public_processor/public_processor.js +119 -77
  96. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  97. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  98. package/dest/public/public_processor/public_processor_metrics.js +28 -4
  99. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts +17 -0
  100. package/dest/public/public_tx_simulator/dumping_public_tx_simulator.d.ts.map +1 -0
  101. package/dest/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.js → dumping_public_tx_simulator.js} +10 -23
  102. package/dest/public/public_tx_simulator/factories.d.ts +9 -8
  103. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -1
  104. package/dest/public/public_tx_simulator/factories.js +9 -9
  105. package/dest/public/public_tx_simulator/index.d.ts +4 -6
  106. package/dest/public/public_tx_simulator/index.d.ts.map +1 -1
  107. package/dest/public/public_tx_simulator/index.js +2 -4
  108. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +43 -71
  109. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  110. package/dest/public/public_tx_simulator/public_tx_simulator.js +99 -316
  111. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts +24 -0
  112. package/dest/public/public_tx_simulator/public_tx_simulator_base.d.ts.map +1 -0
  113. package/dest/public/public_tx_simulator/public_tx_simulator_base.js +31 -0
  114. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +5 -5
  115. package/dest/public/test_executor_metrics.d.ts +3 -2
  116. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  117. package/dest/public/test_executor_metrics.js +2 -2
  118. package/package.json +22 -19
  119. package/src/client.ts +0 -2
  120. package/src/private/acvm/acvm.ts +4 -3
  121. package/src/private/acvm_native.ts +11 -5
  122. package/src/private/acvm_wasm.ts +11 -4
  123. package/src/private/circuit_recording/circuit_recorder.ts +89 -81
  124. package/src/private/circuit_recording/file_circuit_recorder.ts +45 -50
  125. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  126. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +9 -15
  127. package/src/private/factory.ts +7 -4
  128. package/src/public/avm/testing/account_proof.json +553 -0
  129. package/src/public/avm/testing/account_proof_fetcher.ts +166 -0
  130. package/src/public/avm/{fixtures → testing}/base_avm_simulation_tester.ts +23 -3
  131. package/src/public/avm/{fixtures → testing}/utils.ts +4 -40
  132. package/src/public/avm_simulator.ts +29 -0
  133. package/src/public/avm_simulator_pool.ts +226 -0
  134. package/src/public/cdb/generated/api_types.ts +457 -0
  135. package/src/public/cdb/generated/server.ts +109 -0
  136. package/src/public/cdb_ipc_server.ts +197 -0
  137. package/src/public/contracts_db_checkpoint.ts +1 -1
  138. package/src/public/executor_metrics.ts +4 -1
  139. package/src/public/fixtures/amm_test.ts +4 -4
  140. package/src/public/fixtures/bulk_test.ts +31 -6
  141. package/src/public/fixtures/custom_bytecode_tester.ts +2 -2
  142. package/src/public/fixtures/index.ts +1 -3
  143. package/src/public/fixtures/public_processor_test_env.ts +88 -0
  144. package/src/public/fixtures/public_tx_simulation_tester.ts +45 -18
  145. package/src/public/fixtures/simple_contract_data_source.ts +1 -1
  146. package/src/public/fixtures/token_test.ts +3 -3
  147. package/src/public/fixtures/utils.ts +23 -24
  148. package/src/public/fuzzing/avm_fuzzer_simulator.ts +26 -11
  149. package/src/public/fuzzing/avm_simulator_bin.ts +14 -6
  150. package/src/public/index.ts +7 -3
  151. package/src/public/public_db_sources.ts +36 -19
  152. package/src/public/public_processor/guarded_merkle_tree.ts +11 -8
  153. package/src/public/public_processor/public_processor.ts +166 -97
  154. package/src/public/public_processor/public_processor_metrics.ts +22 -4
  155. package/src/public/public_tx_simulator/{dumping_cpp_public_tx_simulator.ts → dumping_public_tx_simulator.ts} +17 -31
  156. package/src/public/public_tx_simulator/factories.ts +31 -11
  157. package/src/public/public_tx_simulator/index.ts +6 -5
  158. package/src/public/public_tx_simulator/public_tx_simulator.ts +142 -470
  159. package/src/public/public_tx_simulator/public_tx_simulator_base.ts +37 -0
  160. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +5 -5
  161. package/src/public/test_executor_metrics.ts +3 -3
  162. package/dest/public/avm/avm_context.d.ts +0 -41
  163. package/dest/public/avm/avm_context.d.ts.map +0 -1
  164. package/dest/public/avm/avm_context.js +0 -44
  165. package/dest/public/avm/avm_contract_call_result.d.ts +0 -32
  166. package/dest/public/avm/avm_contract_call_result.d.ts.map +0 -1
  167. package/dest/public/avm/avm_contract_call_result.js +0 -54
  168. package/dest/public/avm/avm_execution_environment.d.ts +0 -23
  169. package/dest/public/avm/avm_execution_environment.d.ts.map +0 -1
  170. package/dest/public/avm/avm_execution_environment.js +0 -33
  171. package/dest/public/avm/avm_gas.d.ts +0 -44
  172. package/dest/public/avm/avm_gas.d.ts.map +0 -1
  173. package/dest/public/avm/avm_gas.js +0 -195
  174. package/dest/public/avm/avm_machine_state.d.ts +0 -97
  175. package/dest/public/avm/avm_machine_state.d.ts.map +0 -1
  176. package/dest/public/avm/avm_machine_state.js +0 -109
  177. package/dest/public/avm/avm_memory_types.d.ts +0 -275
  178. package/dest/public/avm/avm_memory_types.d.ts.map +0 -1
  179. package/dest/public/avm/avm_memory_types.js +0 -351
  180. package/dest/public/avm/avm_simulator.d.ts +0 -40
  181. package/dest/public/avm/avm_simulator.d.ts.map +0 -1
  182. package/dest/public/avm/avm_simulator.js +0 -191
  183. package/dest/public/avm/avm_simulator_interface.d.ts +0 -9
  184. package/dest/public/avm/avm_simulator_interface.d.ts.map +0 -1
  185. package/dest/public/avm/avm_simulator_interface.js +0 -3
  186. package/dest/public/avm/errors.d.ts +0 -104
  187. package/dest/public/avm/errors.d.ts.map +0 -1
  188. package/dest/public/avm/errors.js +0 -141
  189. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +0 -22
  190. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +0 -1
  191. package/dest/public/avm/fixtures/avm_simulation_tester.js +0 -83
  192. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +0 -1
  193. package/dest/public/avm/fixtures/initializers.d.ts +0 -42
  194. package/dest/public/avm/fixtures/initializers.d.ts.map +0 -1
  195. package/dest/public/avm/fixtures/initializers.js +0 -44
  196. package/dest/public/avm/fixtures/utils.d.ts +0 -39
  197. package/dest/public/avm/fixtures/utils.d.ts.map +0 -1
  198. package/dest/public/avm/index.d.ts +0 -2
  199. package/dest/public/avm/index.d.ts.map +0 -1
  200. package/dest/public/avm/index.js +0 -1
  201. package/dest/public/avm/opcodes/accrued_substate.d.ts +0 -75
  202. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +0 -1
  203. package/dest/public/avm/opcodes/accrued_substate.js +0 -255
  204. package/dest/public/avm/opcodes/addressing_mode.d.ts +0 -31
  205. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +0 -1
  206. package/dest/public/avm/opcodes/addressing_mode.js +0 -94
  207. package/dest/public/avm/opcodes/arithmetic.d.ts +0 -49
  208. package/dest/public/avm/opcodes/arithmetic.d.ts.map +0 -1
  209. package/dest/public/avm/opcodes/arithmetic.js +0 -97
  210. package/dest/public/avm/opcodes/bitwise.d.ts +0 -42
  211. package/dest/public/avm/opcodes/bitwise.d.ts.map +0 -1
  212. package/dest/public/avm/opcodes/bitwise.js +0 -99
  213. package/dest/public/avm/opcodes/comparators.d.ts +0 -25
  214. package/dest/public/avm/opcodes/comparators.d.ts.map +0 -1
  215. package/dest/public/avm/opcodes/comparators.js +0 -43
  216. package/dest/public/avm/opcodes/contract.d.ts +0 -20
  217. package/dest/public/avm/opcodes/contract.d.ts.map +0 -1
  218. package/dest/public/avm/opcodes/contract.js +0 -65
  219. package/dest/public/avm/opcodes/control_flow.d.ts +0 -41
  220. package/dest/public/avm/opcodes/control_flow.d.ts.map +0 -1
  221. package/dest/public/avm/opcodes/control_flow.js +0 -107
  222. package/dest/public/avm/opcodes/conversion.d.ts +0 -18
  223. package/dest/public/avm/opcodes/conversion.d.ts.map +0 -1
  224. package/dest/public/avm/opcodes/conversion.js +0 -333
  225. package/dest/public/avm/opcodes/ec_add.d.ts +0 -19
  226. package/dest/public/avm/opcodes/ec_add.d.ts.map +0 -1
  227. package/dest/public/avm/opcodes/ec_add.js +0 -93
  228. package/dest/public/avm/opcodes/environment_getters.d.ts +0 -28
  229. package/dest/public/avm/opcodes/environment_getters.d.ts.map +0 -1
  230. package/dest/public/avm/opcodes/environment_getters.js +0 -77
  231. package/dest/public/avm/opcodes/external_calls.d.ts +0 -59
  232. package/dest/public/avm/opcodes/external_calls.d.ts.map +0 -1
  233. package/dest/public/avm/opcodes/external_calls.js +0 -210
  234. package/dest/public/avm/opcodes/hashing.d.ts +0 -36
  235. package/dest/public/avm/opcodes/hashing.d.ts.map +0 -1
  236. package/dest/public/avm/opcodes/hashing.js +0 -119
  237. package/dest/public/avm/opcodes/index.d.ts +0 -16
  238. package/dest/public/avm/opcodes/index.d.ts.map +0 -1
  239. package/dest/public/avm/opcodes/index.js +0 -15
  240. package/dest/public/avm/opcodes/instruction.d.ts +0 -74
  241. package/dest/public/avm/opcodes/instruction.d.ts.map +0 -1
  242. package/dest/public/avm/opcodes/instruction.js +0 -95
  243. package/dest/public/avm/opcodes/instruction_impl.d.ts +0 -19
  244. package/dest/public/avm/opcodes/instruction_impl.d.ts.map +0 -1
  245. package/dest/public/avm/opcodes/instruction_impl.js +0 -30
  246. package/dest/public/avm/opcodes/memory.d.ts +0 -74
  247. package/dest/public/avm/opcodes/memory.d.ts.map +0 -1
  248. package/dest/public/avm/opcodes/memory.js +0 -257
  249. package/dest/public/avm/opcodes/misc.d.ts +0 -18
  250. package/dest/public/avm/opcodes/misc.d.ts.map +0 -1
  251. package/dest/public/avm/opcodes/misc.js +0 -73
  252. package/dest/public/avm/opcodes/storage.d.ts +0 -24
  253. package/dest/public/avm/opcodes/storage.d.ts.map +0 -1
  254. package/dest/public/avm/opcodes/storage.js +0 -68
  255. package/dest/public/avm/revert_reason.d.ts +0 -18
  256. package/dest/public/avm/revert_reason.d.ts.map +0 -1
  257. package/dest/public/avm/revert_reason.js +0 -39
  258. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -26
  259. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +0 -1
  260. package/dest/public/avm/serialization/buffer_cursor.js +0 -99
  261. package/dest/public/avm/serialization/bytecode_serialization.d.ts +0 -17
  262. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +0 -1
  263. package/dest/public/avm/serialization/bytecode_serialization.js +0 -336
  264. package/dest/public/avm/serialization/instruction_serialization.d.ts +0 -114
  265. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +0 -1
  266. package/dest/public/avm/serialization/instruction_serialization.js +0 -261
  267. package/dest/public/avm/test_utils.d.ts +0 -15
  268. package/dest/public/avm/test_utils.d.ts.map +0 -1
  269. package/dest/public/avm/test_utils.js +0 -44
  270. package/dest/public/debug_fn_name.d.ts +0 -18
  271. package/dest/public/debug_fn_name.d.ts.map +0 -1
  272. package/dest/public/debug_fn_name.js +0 -35
  273. package/dest/public/fixtures/custom_bytecode_tests.d.ts +0 -12
  274. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +0 -1
  275. package/dest/public/fixtures/custom_bytecode_tests.js +0 -174
  276. package/dest/public/fixtures/minimal_public_tx.d.ts +0 -4
  277. package/dest/public/fixtures/minimal_public_tx.d.ts.map +0 -1
  278. package/dest/public/fixtures/minimal_public_tx.js +0 -19
  279. package/dest/public/fixtures/opcode_spammer.d.ts +0 -123
  280. package/dest/public/fixtures/opcode_spammer.d.ts.map +0 -1
  281. package/dest/public/fixtures/opcode_spammer.js +0 -1681
  282. package/dest/public/hinting_db_sources.d.ts +0 -80
  283. package/dest/public/hinting_db_sources.d.ts.map +0 -1
  284. package/dest/public/hinting_db_sources.js +0 -355
  285. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +0 -18
  286. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +0 -1
  287. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +0 -98
  288. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +0 -53
  289. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +0 -1
  290. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +0 -132
  291. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +0 -42
  292. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +0 -1
  293. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +0 -86
  294. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +0 -30
  295. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +0 -1
  296. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +0 -171
  297. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +0 -22
  298. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +0 -1
  299. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +0 -31
  300. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +0 -1
  301. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +0 -51
  302. package/dest/public/public_tx_simulator/public_tx_context.d.ts +0 -130
  303. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +0 -1
  304. package/dest/public/public_tx_simulator/public_tx_context.js +0 -300
  305. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +0 -21
  306. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +0 -1
  307. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +0 -415
  308. package/dest/public/side_effect_trace.d.ts +0 -87
  309. package/dest/public/side_effect_trace.d.ts.map +0 -1
  310. package/dest/public/side_effect_trace.js +0 -199
  311. package/dest/public/side_effect_trace_interface.d.ts +0 -22
  312. package/dest/public/side_effect_trace_interface.d.ts.map +0 -1
  313. package/dest/public/side_effect_trace_interface.js +0 -1
  314. package/dest/public/state_manager/index.d.ts +0 -2
  315. package/dest/public/state_manager/index.d.ts.map +0 -1
  316. package/dest/public/state_manager/index.js +0 -1
  317. package/dest/public/state_manager/nullifiers.d.ts +0 -61
  318. package/dest/public/state_manager/nullifiers.d.ts.map +0 -1
  319. package/dest/public/state_manager/nullifiers.js +0 -92
  320. package/dest/public/state_manager/public_storage.d.ts +0 -66
  321. package/dest/public/state_manager/public_storage.d.ts.map +0 -1
  322. package/dest/public/state_manager/public_storage.js +0 -145
  323. package/dest/public/state_manager/state_manager.d.ts +0 -164
  324. package/dest/public/state_manager/state_manager.d.ts.map +0 -1
  325. package/dest/public/state_manager/state_manager.js +0 -395
  326. package/src/public/avm/avm_context.ts +0 -61
  327. package/src/public/avm/avm_contract_call_result.ts +0 -67
  328. package/src/public/avm/avm_execution_environment.ts +0 -46
  329. package/src/public/avm/avm_gas.ts +0 -183
  330. package/src/public/avm/avm_machine_state.ts +0 -169
  331. package/src/public/avm/avm_memory_types.ts +0 -436
  332. package/src/public/avm/avm_simulator.ts +0 -276
  333. package/src/public/avm/avm_simulator_interface.ts +0 -8
  334. package/src/public/avm/errors.ts +0 -177
  335. package/src/public/avm/fixtures/avm_simulation_tester.ts +0 -116
  336. package/src/public/avm/fixtures/initializers.ts +0 -102
  337. package/src/public/avm/index.ts +0 -1
  338. package/src/public/avm/opcodes/accrued_substate.ts +0 -288
  339. package/src/public/avm/opcodes/addressing_mode.ts +0 -111
  340. package/src/public/avm/opcodes/arithmetic.ts +0 -129
  341. package/src/public/avm/opcodes/bitwise.ts +0 -113
  342. package/src/public/avm/opcodes/comparators.ts +0 -55
  343. package/src/public/avm/opcodes/contract.ts +0 -75
  344. package/src/public/avm/opcodes/control_flow.ts +0 -123
  345. package/src/public/avm/opcodes/conversion.ts +0 -104
  346. package/src/public/avm/opcodes/ec_add.ts +0 -105
  347. package/src/public/avm/opcodes/environment_getters.ts +0 -87
  348. package/src/public/avm/opcodes/external_calls.ts +0 -261
  349. package/src/public/avm/opcodes/hashing.ts +0 -151
  350. package/src/public/avm/opcodes/index.ts +0 -15
  351. package/src/public/avm/opcodes/instruction.ts +0 -136
  352. package/src/public/avm/opcodes/instruction_impl.ts +0 -36
  353. package/src/public/avm/opcodes/memory.ts +0 -293
  354. package/src/public/avm/opcodes/misc.ts +0 -102
  355. package/src/public/avm/opcodes/storage.ts +0 -87
  356. package/src/public/avm/revert_reason.ts +0 -58
  357. package/src/public/avm/serialization/buffer_cursor.ts +0 -118
  358. package/src/public/avm/serialization/bytecode_serialization.ts +0 -215
  359. package/src/public/avm/serialization/instruction_serialization.ts +0 -249
  360. package/src/public/avm/test_utils.ts +0 -64
  361. package/src/public/debug_fn_name.ts +0 -50
  362. package/src/public/fixtures/custom_bytecode_tests.ts +0 -228
  363. package/src/public/fixtures/minimal_public_tx.ts +0 -26
  364. package/src/public/fixtures/opcode_spammer.ts +0 -1725
  365. package/src/public/hinting_db_sources.ts +0 -607
  366. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +0 -121
  367. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +0 -208
  368. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +0 -132
  369. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +0 -237
  370. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +0 -105
  371. package/src/public/public_tx_simulator/public_tx_context.ts +0 -477
  372. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +0 -63
  373. package/src/public/side_effect_trace.ts +0 -290
  374. package/src/public/side_effect_trace_interface.ts +0 -28
  375. package/src/public/state_manager/index.ts +0 -1
  376. package/src/public/state_manager/nullifiers.ts +0 -103
  377. package/src/public/state_manager/public_storage.ts +0 -174
  378. package/src/public/state_manager/state_manager.ts +0 -546
@@ -1,249 +0,0 @@
1
- import { Fr } from '@aztec/foundation/curves/bn254';
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/curves/bn254';
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
- }
@@ -1,50 +0,0 @@
1
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
- import { FunctionSelector } from '@aztec/stdlib/abi';
3
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
-
5
- import type { PublicContractsDBInterface } from './db_interfaces.js';
6
-
7
- export async function getPublicFunctionDebugName(
8
- db: PublicContractsDBInterface,
9
- contractAddress: AztecAddress,
10
- calldata: Fr[],
11
- ): Promise<string> {
12
- // Public function is dispatched and therefore the target function is passed in the first argument.
13
- if (!calldata[0]) {
14
- return `<calldata[0] undefined> (Contract Address: ${contractAddress})`;
15
- }
16
- const fallbackName = `<calldata[0]:${calldata[0].toString()}> (Contract Address: ${contractAddress})`;
17
- const selector = FunctionSelector.fromFieldOrUndefined(calldata[0]);
18
- if (!selector) {
19
- return fallbackName;
20
- }
21
- return (await db.getDebugFunctionName(contractAddress, selector)) ?? fallbackName;
22
- }
23
-
24
- /**
25
- * Get the function selector and optional debug name for a public function.
26
- * Returns the selector and name separately, with name only populated if a debug name is available.
27
- * @param db - The contracts database
28
- * @param contractAddress - The contract address
29
- * @param calldata - The calldata (selector is in calldata[0])
30
- * @returns An object with functionSelector (always if calldata[0] exists) and functionName (only if debug name found)
31
- */
32
- export async function getPublicFunctionSelectorAndName(
33
- db: PublicContractsDBInterface,
34
- contractAddress: AztecAddress,
35
- calldata: Fr[],
36
- ): Promise<{ functionSelector?: FunctionSelector; functionName?: string }> {
37
- // Public function is dispatched and therefore the target function is passed in the first argument.
38
- if (!calldata[0]) {
39
- return {};
40
- }
41
- const selector = FunctionSelector.fromFieldOrUndefined(calldata[0]);
42
- if (!selector) {
43
- return {};
44
- }
45
- const debugName = await db.getDebugFunctionName(contractAddress, selector);
46
- return {
47
- functionSelector: selector,
48
- functionName: debugName ?? undefined,
49
- };
50
- }
@@ -1,228 +0,0 @@
1
- import { strict as assert } from 'assert';
2
-
3
- import { TypeTag } from '../avm/avm_memory_types.js';
4
- import { Addressing, AddressingMode } from '../avm/opcodes/addressing_mode.js';
5
- import { Add, CalldataCopy, Jump, Return, Set } from '../avm/opcodes/index.js';
6
- import { encodeToBytecode } from '../avm/serialization/bytecode_serialization.js';
7
- import {
8
- MAX_OPCODE_VALUE,
9
- Opcode,
10
- OperandType,
11
- getOperandSize,
12
- } from '../avm/serialization/instruction_serialization.js';
13
- import { deployAndExecuteCustomBytecode } from './custom_bytecode_tester.js';
14
- import { PublicTxSimulationTester } from './public_tx_simulation_tester.js';
15
-
16
- // First instruction resolved a base address (offset 0) which is uninitialized and therefore
17
- // of invalid tag (FF). This will trigger an exceptional halt.
18
- export async function addressingWithBaseTagIssueTest(isIndirect: boolean, tester: PublicTxSimulationTester) {
19
- const addressingMode = Addressing.fromModes([
20
- isIndirect ? AddressingMode.INDIRECT_RELATIVE : AddressingMode.RELATIVE,
21
- AddressingMode.DIRECT,
22
- AddressingMode.DIRECT,
23
- ]);
24
-
25
- const bytecode = encodeToBytecode([
26
- new CalldataCopy(/*addressing_mode=*/ addressingMode.toWire(), /*copySize=*/ 1, /*cdOffset=*/ 0, /*dstOffset=*/ 0),
27
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
28
- ]);
29
-
30
- const txLabel = isIndirect ? 'AddressingWithBaseTagInvalidIndirect' : 'AddressingWithBaseTagInvalidDirect';
31
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
32
- }
33
-
34
- // First instruction sets a value with tag U64 at offset 0. Then a CalldataCopy instruction
35
- // uses INDIRECT addressing to read from offset 0, which should fail because the value at
36
- // offset 0 has tag U64 (not U32), making it an invalid address tag.
37
- export async function addressingWithIndirectTagIssueTest(tester: PublicTxSimulationTester) {
38
- // Set a U64 value at offset 0 - this will be used as an indirect address
39
- const addressingMode = Addressing.fromModes([
40
- AddressingMode.INDIRECT, // First operand (cdOffset) uses indirect addressing
41
- AddressingMode.DIRECT,
42
- AddressingMode.DIRECT,
43
- ]);
44
-
45
- const bytecode = encodeToBytecode([
46
- // Set a U64 value at offset 0 - this has the wrong tag for an address (should be U32)
47
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT64, /*value=*/ 100n).as(
48
- Opcode.SET_64,
49
- Set.wireFormat64,
50
- ),
51
- // Try to use indirect addressing: read from offset 0, which contains a U64 value
52
- // This should fail because U64 is not a valid address tag (must be U32)
53
- new CalldataCopy(/*addressing_mode=*/ addressingMode.toWire(), /*copySize=*/ 1, /*cdOffset=*/ 0, /*dstOffset=*/ 1),
54
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
55
- ]);
56
-
57
- const txLabel = 'AddressingWithIndirectTagInvalid';
58
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
59
- }
60
-
61
- // First instruction sets a value 10 with tag U32 at offset 1 (direct, no relative).
62
- // Then an ADD_16 instruction uses INDIRECT addressing for the first operand (offset 1)
63
- // and RELATIVE addressing for the second operand (offset 2). The indirect addressing
64
- // succeeds (reads U32 value 10 from offset 1, uses it as address), but the relative
65
- // addressing fails because the base address at offset 0 has the wrong tag (uninitialized/invalid).
66
- export async function addressingWithIndirectThenRelativeTagIssueTest(tester: PublicTxSimulationTester) {
67
- const addressingMode = Addressing.fromModes([
68
- AddressingMode.INDIRECT, // First operand (aOffset) uses indirect addressing, no relative
69
- AddressingMode.RELATIVE, // Second operand (bOffset) uses relative addressing
70
- AddressingMode.DIRECT, // Third operand (dstOffset) uses direct addressing
71
- ]);
72
-
73
- const bytecode = encodeToBytecode([
74
- // Set a U32 value 10 at offset 1 - this will be used as an indirect address
75
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 1, TypeTag.UINT32, /*value=*/ 10).as(
76
- Opcode.SET_32,
77
- Set.wireFormat32,
78
- ),
79
- // ADD_16: first operand uses indirect addressing (reads from offset 1, gets value 10, uses as address - succeeds)
80
- // second operand uses relative addressing (tries to read base from offset 0, but offset 0 has wrong tag - fails)
81
- new Add(/*addressing_mode=*/ addressingMode.toWire(), /*aOffset=*/ 1, /*bOffset=*/ 2, /*dstOffset=*/ 3).as(
82
- Opcode.ADD_16,
83
- Add.wireFormat16,
84
- ),
85
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
86
- ]);
87
-
88
- const txLabel = 'AddressingWithIndirectThenRelativeTagInvalid';
89
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
90
- }
91
-
92
- // First instruction sets UINT32_MAX at offset 0 (base address) with tag U32.
93
- // Then an ADD_8 instruction uses INDIRECT_RELATIVE addressing for the first operand (offset 1)
94
- // and INDIRECT addressing for the second operand (offset 2). The relative addressing
95
- // for the first operand will overflow (UINT32_MAX + 1 >= MAX_MEMORY_SIZE), causing the instruction to fail.
96
- // The second operand will also fail (indirect addressing from offset 2 which is uninitialized with tag FF).
97
- export async function addressingWithRelativeOverflowAndIndirectTagIssueTest(tester: PublicTxSimulationTester) {
98
- const addressingMode = Addressing.fromModes([
99
- AddressingMode.INDIRECT_RELATIVE, // First operand (aOffset) uses both indirect and relative addressing
100
- AddressingMode.INDIRECT, // Second operand (bOffset) uses indirect addressing only
101
- AddressingMode.DIRECT, // Third operand (dstOffset) uses direct addressing
102
- ]);
103
-
104
- // UINT32_MAX = 2^32 - 1 = 4294967295
105
- const UINT32_MAX = 0xffffffff;
106
-
107
- const bytecode = encodeToBytecode([
108
- // Set UINT32_MAX at offset 0 as base address - this will cause overflow when adding relative offset 1
109
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT32, /*value=*/ UINT32_MAX).as(
110
- Opcode.SET_32,
111
- Set.wireFormat32,
112
- ),
113
- new Add(/*addressing_mode=*/ addressingMode.toWire(), /*aOffset=*/ 1, /*bOffset=*/ 2, /*dstOffset=*/ 3).as(
114
- Opcode.ADD_8,
115
- Add.wireFormat8,
116
- ),
117
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
118
- ]);
119
-
120
- const txLabel = 'AddressingWithRelativeOverflowAndIndirectTagInvalid';
121
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
122
- }
123
-
124
- export async function pcOutOfRangeTest(tester: PublicTxSimulationTester) {
125
- const bytecode = encodeToBytecode([
126
- new Jump(/*jumpOffset=*/ 123), // Jump to out-of-range pc offset.
127
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
128
- ]);
129
-
130
- const txLabel = 'PcOutOfRange';
131
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
132
- }
133
-
134
- export async function invalidOpcodeTest(tester: PublicTxSimulationTester) {
135
- let bytecode = encodeToBytecode([
136
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT32, /*value=*/ 0).as(Opcode.SET_8, Set.wireFormat8),
137
- ]);
138
-
139
- const offsetReturnOpcodeByte = bytecode.length;
140
-
141
- bytecode = Buffer.concat([
142
- bytecode,
143
- encodeToBytecode([new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0)]),
144
- ]);
145
-
146
- // Manipulate the Return opcode to make the opcode invalid (out of range).
147
- bytecode[offsetReturnOpcodeByte] = MAX_OPCODE_VALUE + 1; // opcode is invalid.
148
-
149
- const txLabel = 'InvalidOpcode';
150
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
151
- }
152
-
153
- // Single invalid byte in the bytecode.
154
- export async function invalidByteTest(tester: PublicTxSimulationTester) {
155
- const invalidOpcode = MAX_OPCODE_VALUE + 7;
156
- assert(invalidOpcode < 256, 'Invalid opcode must fit in a single byte');
157
- const bytecode = Buffer.from([invalidOpcode]);
158
-
159
- const txLabel = 'InvalidByte';
160
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
161
- }
162
-
163
- // Truncate the last instruction in the bytecode.
164
- export async function instructionTruncatedTest(tester: PublicTxSimulationTester) {
165
- let bytecode = encodeToBytecode([
166
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT32, /*value=*/ 0).as(Opcode.SET_8, Set.wireFormat8),
167
- ]);
168
-
169
- // Truncate the bytecode.
170
- bytecode = bytecode.subarray(0, -1);
171
-
172
- const txLabel = 'InstructionTruncated';
173
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
174
- }
175
-
176
- // Invalid tag value byte in an instruction.
177
- export async function invalidTagValueTest(tester: PublicTxSimulationTester) {
178
- const bytecode = encodeToBytecode([
179
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT32, /*value=*/ 0).as(Opcode.SET_8, Set.wireFormat8),
180
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 0),
181
- ]);
182
-
183
- const tagOffset = getTagOffsetInInstruction(Set.wireFormat8);
184
- assert(bytecode[tagOffset].valueOf() == TypeTag.UINT32.valueOf(), 'Set instruction tag should be UINT32 in test');
185
- bytecode[tagOffset] = TypeTag.INVALID;
186
-
187
- const txLabel = 'InvalidTagValue';
188
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
189
- }
190
-
191
- // Combine an invalid tag in the last instruction that is truncated.
192
- export async function invalidTagValueAndInstructionTruncatedTest(tester: PublicTxSimulationTester) {
193
- let bytecode = encodeToBytecode([
194
- // Important: value argument must be a bigint otherwise a type error will be thrown.
195
- new Set(/*addressing_mode=*/ 0, /*dstOffset=*/ 0, TypeTag.UINT128, /*value=*/ 0n).as(
196
- Opcode.SET_128,
197
- Set.wireFormat128,
198
- ),
199
- ]);
200
-
201
- // Truncate the bytecode.
202
- bytecode = bytecode.subarray(0, -5);
203
- const tagOffset = getTagOffsetInInstruction(Set.wireFormat128);
204
- assert(bytecode[tagOffset].valueOf() == TypeTag.UINT128.valueOf(), 'Set instruction tag should be UINT128 in test');
205
- bytecode[tagOffset] = 0x6f; // Invalid tag value.
206
-
207
- const txLabel = 'InvalidTagValueAndInstructionTruncated';
208
- return await deployAndExecuteCustomBytecode(bytecode, tester, txLabel);
209
- }
210
-
211
- /**
212
- * Returns the offset of the tag in an instruction.
213
- * @details Loops over the wire format operand type entries until it finds the tag.
214
- * Returns the byte offset of the tag based on each operand size that is passed.
215
- *
216
- * @param wireFormat array of operand types
217
- * @returns byte offset of the tag
218
- */
219
- function getTagOffsetInInstruction(wireFormat: OperandType[]): number {
220
- let offset = 0;
221
- for (const operand of wireFormat) {
222
- if (operand === OperandType.TAG) {
223
- break;
224
- }
225
- offset += getOperandSize(operand);
226
- }
227
- return offset;
228
- }
@@ -1,26 +0,0 @@
1
- import type { PublicTxResult } from '@aztec/stdlib/avm';
2
- import { ProtocolContracts } from '@aztec/stdlib/tx';
3
-
4
- import { TypeTag } from '../avm/avm_memory_types.js';
5
- import { Add, Return, Set } from '../avm/opcodes/index.js';
6
- import { encodeToBytecode } from '../avm/serialization/bytecode_serialization.js';
7
- import { Opcode } from '../avm/serialization/instruction_serialization.js';
8
- import { deployAndExecuteCustomBytecode } from './custom_bytecode_tester.js';
9
- import { PublicTxSimulationTester } from './public_tx_simulation_tester.js';
10
-
11
- export async function executeAvmMinimalPublicTx(tester: PublicTxSimulationTester): Promise<PublicTxResult> {
12
- const minimalBytecode = encodeToBytecode([
13
- new Set(/*indirect*/ 0, /*dstOffset*/ 0, TypeTag.UINT32, /*value*/ 1).as(Opcode.SET_8, Set.wireFormat8),
14
- new Set(/*indirect*/ 0, /*dstOffset*/ 1, TypeTag.UINT32, /*value*/ 2).as(Opcode.SET_8, Set.wireFormat8),
15
- new Add(/*addressing_mode=*/ 0, /*aOffset=*/ 0, /*bOffset=*/ 1, /*dstOffset=*/ 2).as(Opcode.ADD_8, Add.wireFormat8),
16
- new Return(/*addressing_mode=*/ 0, /*copySizeOffset=*/ 0, /*returnOffset=*/ 2),
17
- ]);
18
-
19
- const result = await deployAndExecuteCustomBytecode(minimalBytecode, tester, 'MinimalTx', 'AvmMinimalContract');
20
-
21
- // Modify the protocol contracts to be all zeros
22
- result.hints!.protocolContracts = ProtocolContracts.empty();
23
- result.publicInputs!.protocolContracts = ProtocolContracts.empty();
24
-
25
- return result;
26
- }