@aztec/simulator 0.0.0-test.1 → 0.0.1-fake-c83136db25

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 (466) hide show
  1. package/README.md +6 -0
  2. package/dest/client.d.ts +5 -3
  3. package/dest/client.d.ts.map +1 -1
  4. package/dest/client.js +4 -2
  5. package/dest/common/errors.d.ts +4 -7
  6. package/dest/common/errors.d.ts.map +1 -1
  7. package/dest/common/errors.js +51 -32
  8. package/dest/common/index.d.ts +0 -1
  9. package/dest/common/index.d.ts.map +1 -1
  10. package/dest/common/index.js +0 -1
  11. package/dest/private/acvm/acvm.d.ts +11 -5
  12. package/dest/private/acvm/acvm.d.ts.map +1 -1
  13. package/dest/private/acvm/acvm.js +10 -16
  14. package/dest/private/acvm/acvm_types.d.ts +1 -1
  15. package/dest/private/acvm/acvm_types.d.ts.map +1 -1
  16. package/dest/private/acvm/deserialize.d.ts +17 -18
  17. package/dest/private/acvm/deserialize.d.ts.map +1 -1
  18. package/dest/private/acvm/deserialize.js +31 -23
  19. package/dest/private/acvm/index.d.ts +0 -1
  20. package/dest/private/acvm/index.d.ts.map +1 -1
  21. package/dest/private/acvm/index.js +0 -1
  22. package/dest/private/acvm/serialize.d.ts +19 -2
  23. package/dest/private/acvm/serialize.d.ts.map +1 -1
  24. package/dest/private/acvm/serialize.js +53 -0
  25. package/dest/private/{providers/acvm_native.d.ts → acvm_native.d.ts} +9 -10
  26. package/dest/private/acvm_native.d.ts.map +1 -0
  27. package/dest/private/{providers/acvm_native.js → acvm_native.js} +11 -7
  28. package/dest/private/acvm_wasm.d.ts +15 -0
  29. package/dest/private/acvm_wasm.d.ts.map +1 -0
  30. package/dest/private/{providers/acvm_wasm.js → acvm_wasm.js} +22 -19
  31. package/dest/private/acvm_wasm_with_blobs.d.ts +20 -0
  32. package/dest/private/acvm_wasm_with_blobs.d.ts.map +1 -0
  33. package/dest/private/acvm_wasm_with_blobs.js +35 -0
  34. package/dest/private/circuit_recording/circuit_recorder.d.ts +108 -0
  35. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -0
  36. package/dest/private/circuit_recording/circuit_recorder.js +209 -0
  37. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +31 -0
  38. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -0
  39. package/dest/private/circuit_recording/file_circuit_recorder.js +135 -0
  40. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +5 -0
  41. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -0
  42. package/dest/private/circuit_recording/memory_circuit_recorder.js +9 -0
  43. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts +21 -0
  44. package/dest/private/circuit_recording/simulator_recorder_wrapper.d.ts.map +1 -0
  45. package/dest/private/circuit_recording/simulator_recorder_wrapper.js +44 -0
  46. package/dest/private/circuit_simulator.d.ts +35 -0
  47. package/dest/private/circuit_simulator.d.ts.map +1 -0
  48. package/dest/private/circuit_simulator.js +43 -0
  49. package/dest/private/factory.d.ts +12 -0
  50. package/dest/private/factory.d.ts.map +1 -0
  51. package/dest/private/{providers/factory.js → factory.js} +2 -2
  52. package/dest/public/avm/avm_context.d.ts +5 -5
  53. package/dest/public/avm/avm_context.d.ts.map +1 -1
  54. package/dest/public/avm/avm_contract_call_result.d.ts +4 -2
  55. package/dest/public/avm/avm_contract_call_result.d.ts.map +1 -1
  56. package/dest/public/avm/avm_contract_call_result.js +11 -7
  57. package/dest/public/avm/avm_execution_environment.d.ts +3 -1
  58. package/dest/public/avm/avm_execution_environment.d.ts.map +1 -1
  59. package/dest/public/avm/avm_execution_environment.js +7 -2
  60. package/dest/public/avm/avm_gas.d.ts +4 -20
  61. package/dest/public/avm/avm_gas.d.ts.map +1 -1
  62. package/dest/public/avm/avm_gas.js +27 -35
  63. package/dest/public/avm/avm_machine_state.d.ts +2 -0
  64. package/dest/public/avm/avm_machine_state.d.ts.map +1 -1
  65. package/dest/public/avm/avm_machine_state.js +2 -0
  66. package/dest/public/avm/avm_memory_types.d.ts +98 -87
  67. package/dest/public/avm/avm_memory_types.d.ts.map +1 -1
  68. package/dest/public/avm/avm_memory_types.js +17 -6
  69. package/dest/public/avm/avm_simulator.d.ts +4 -5
  70. package/dest/public/avm/avm_simulator.d.ts.map +1 -1
  71. package/dest/public/avm/avm_simulator.js +23 -35
  72. package/dest/public/avm/avm_simulator_interface.d.ts +9 -0
  73. package/dest/public/avm/avm_simulator_interface.d.ts.map +1 -0
  74. package/dest/public/avm/avm_simulator_interface.js +3 -0
  75. package/dest/public/avm/errors.d.ts +6 -30
  76. package/dest/public/avm/errors.d.ts.map +1 -1
  77. package/dest/public/avm/errors.js +7 -57
  78. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts +5 -4
  79. package/dest/public/avm/fixtures/avm_simulation_tester.d.ts.map +1 -1
  80. package/dest/public/avm/fixtures/avm_simulation_tester.js +12 -14
  81. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts +6 -4
  82. package/dest/public/avm/fixtures/base_avm_simulation_tester.d.ts.map +1 -1
  83. package/dest/public/avm/fixtures/base_avm_simulation_tester.js +37 -14
  84. package/dest/public/avm/fixtures/initializers.d.ts +43 -0
  85. package/dest/public/avm/fixtures/initializers.d.ts.map +1 -0
  86. package/dest/public/avm/fixtures/initializers.js +42 -0
  87. package/dest/public/avm/fixtures/utils.d.ts +38 -0
  88. package/dest/public/avm/fixtures/utils.d.ts.map +1 -0
  89. package/dest/public/avm/fixtures/utils.js +95 -0
  90. package/dest/public/avm/index.d.ts +0 -2
  91. package/dest/public/avm/index.d.ts.map +1 -1
  92. package/dest/public/avm/index.js +0 -2
  93. package/dest/public/avm/opcodes/accrued_substate.d.ts +2 -2
  94. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  95. package/dest/public/avm/opcodes/accrued_substate.js +28 -25
  96. package/dest/public/avm/opcodes/addressing_mode.d.ts +11 -7
  97. package/dest/public/avm/opcodes/addressing_mode.d.ts.map +1 -1
  98. package/dest/public/avm/opcodes/addressing_mode.js +46 -26
  99. package/dest/public/avm/opcodes/arithmetic.d.ts +11 -1
  100. package/dest/public/avm/opcodes/arithmetic.d.ts.map +1 -1
  101. package/dest/public/avm/opcodes/arithmetic.js +16 -2
  102. package/dest/public/avm/opcodes/bitwise.d.ts +5 -13
  103. package/dest/public/avm/opcodes/bitwise.d.ts.map +1 -1
  104. package/dest/public/avm/opcodes/bitwise.js +19 -26
  105. package/dest/public/avm/opcodes/comparators.d.ts.map +1 -1
  106. package/dest/public/avm/opcodes/comparators.js +3 -3
  107. package/dest/public/avm/opcodes/contract.d.ts +1 -2
  108. package/dest/public/avm/opcodes/contract.d.ts.map +1 -1
  109. package/dest/public/avm/opcodes/contract.js +9 -10
  110. package/dest/public/avm/opcodes/control_flow.d.ts.map +1 -1
  111. package/dest/public/avm/opcodes/control_flow.js +10 -8
  112. package/dest/public/avm/opcodes/conversion.d.ts +1 -0
  113. package/dest/public/avm/opcodes/conversion.d.ts.map +1 -1
  114. package/dest/public/avm/opcodes/conversion.js +267 -3
  115. package/dest/public/avm/opcodes/ec_add.d.ts.map +1 -1
  116. package/dest/public/avm/opcodes/ec_add.js +6 -6
  117. package/dest/public/avm/opcodes/environment_getters.d.ts +2 -2
  118. package/dest/public/avm/opcodes/environment_getters.d.ts.map +1 -1
  119. package/dest/public/avm/opcodes/environment_getters.js +17 -19
  120. package/dest/public/avm/opcodes/external_calls.d.ts +8 -7
  121. package/dest/public/avm/opcodes/external_calls.d.ts.map +1 -1
  122. package/dest/public/avm/opcodes/external_calls.js +39 -34
  123. package/dest/public/avm/opcodes/hashing.d.ts.map +1 -1
  124. package/dest/public/avm/opcodes/hashing.js +6 -6
  125. package/dest/public/avm/opcodes/instruction.d.ts +14 -10
  126. package/dest/public/avm/opcodes/instruction.d.ts.map +1 -1
  127. package/dest/public/avm/opcodes/instruction.js +23 -19
  128. package/dest/public/avm/opcodes/memory.d.ts +4 -4
  129. package/dest/public/avm/opcodes/memory.d.ts.map +1 -1
  130. package/dest/public/avm/opcodes/memory.js +37 -33
  131. package/dest/public/avm/opcodes/misc.d.ts +2 -1
  132. package/dest/public/avm/opcodes/misc.d.ts.map +1 -1
  133. package/dest/public/avm/opcodes/misc.js +41 -16
  134. package/dest/public/avm/opcodes/storage.d.ts.map +1 -1
  135. package/dest/public/avm/opcodes/storage.js +7 -5
  136. package/dest/public/avm/revert_reason.d.ts +18 -0
  137. package/dest/public/avm/revert_reason.d.ts.map +1 -0
  138. package/dest/public/avm/revert_reason.js +38 -0
  139. package/dest/public/avm/serialization/buffer_cursor.d.ts +0 -2
  140. package/dest/public/avm/serialization/buffer_cursor.d.ts.map +1 -1
  141. package/dest/public/avm/serialization/bytecode_serialization.d.ts +2 -6
  142. package/dest/public/avm/serialization/bytecode_serialization.d.ts.map +1 -1
  143. package/dest/public/avm/serialization/bytecode_serialization.js +70 -69
  144. package/dest/public/avm/serialization/instruction_serialization.d.ts +13 -4
  145. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  146. package/dest/public/avm/serialization/instruction_serialization.js +70 -35
  147. package/dest/public/avm/test_utils.d.ts +10 -13
  148. package/dest/public/avm/test_utils.d.ts.map +1 -1
  149. package/dest/public/avm/test_utils.js +16 -24
  150. package/dest/public/db_interfaces.d.ts +56 -0
  151. package/dest/public/db_interfaces.d.ts.map +1 -0
  152. package/dest/public/db_interfaces.js +3 -0
  153. package/dest/public/debug_fn_name.d.ts +5 -0
  154. package/dest/public/debug_fn_name.d.ts.map +1 -0
  155. package/dest/public/debug_fn_name.js +9 -0
  156. package/dest/public/executor_metrics.d.ts +10 -3
  157. package/dest/public/executor_metrics.d.ts.map +1 -1
  158. package/dest/public/executor_metrics.js +37 -6
  159. package/dest/public/executor_metrics_interface.d.ts +9 -0
  160. package/dest/public/executor_metrics_interface.d.ts.map +1 -0
  161. package/dest/public/executor_metrics_interface.js +1 -0
  162. package/dest/public/fixtures/amm_test.d.ts +10 -0
  163. package/dest/public/fixtures/amm_test.d.ts.map +1 -0
  164. package/dest/public/fixtures/amm_test.js +213 -0
  165. package/dest/public/fixtures/bulk_test.d.ts +6 -0
  166. package/dest/public/fixtures/bulk_test.d.ts.map +1 -0
  167. package/dest/public/fixtures/bulk_test.js +326 -0
  168. package/dest/public/fixtures/custom_bytecode_tester.d.ts +12 -0
  169. package/dest/public/fixtures/custom_bytecode_tester.d.ts.map +1 -0
  170. package/dest/public/fixtures/custom_bytecode_tester.js +29 -0
  171. package/dest/public/fixtures/custom_bytecode_tests.d.ts +9 -0
  172. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -0
  173. package/dest/public/fixtures/custom_bytecode_tests.js +109 -0
  174. package/dest/public/fixtures/index.d.ts +7 -0
  175. package/dest/public/fixtures/index.d.ts.map +1 -1
  176. package/dest/public/fixtures/index.js +7 -0
  177. package/dest/public/fixtures/minimal_public_tx.d.ts +10 -0
  178. package/dest/public/fixtures/minimal_public_tx.d.ts.map +1 -0
  179. package/dest/public/fixtures/minimal_public_tx.js +29 -0
  180. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +35 -13
  181. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  182. package/dest/public/fixtures/public_tx_simulation_tester.js +96 -71
  183. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.d.ts +6 -6
  184. package/dest/public/fixtures/simple_contract_data_source.d.ts.map +1 -0
  185. package/dest/public/{avm/fixtures → fixtures}/simple_contract_data_source.js +31 -10
  186. package/dest/public/fixtures/token_test.d.ts +8 -0
  187. package/dest/public/fixtures/token_test.d.ts.map +1 -0
  188. package/dest/public/fixtures/token_test.js +95 -0
  189. package/dest/public/fixtures/utils.d.ts +16 -3
  190. package/dest/public/fixtures/utils.d.ts.map +1 -1
  191. package/dest/public/fixtures/utils.js +100 -58
  192. package/dest/public/hinting_db_sources.d.ts +70 -0
  193. package/dest/public/hinting_db_sources.d.ts.map +1 -0
  194. package/dest/public/hinting_db_sources.js +297 -0
  195. package/dest/public/index.d.ts +4 -8
  196. package/dest/public/index.d.ts.map +1 -1
  197. package/dest/public/index.js +4 -7
  198. package/dest/public/public_db_sources.d.ts +30 -39
  199. package/dest/public/public_db_sources.d.ts.map +1 -1
  200. package/dest/public/public_db_sources.js +151 -67
  201. package/dest/public/public_errors.d.ts +12 -0
  202. package/dest/public/public_errors.d.ts.map +1 -0
  203. package/dest/public/public_errors.js +13 -0
  204. package/dest/public/public_processor/guarded_merkle_tree.d.ts +49 -0
  205. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -0
  206. package/dest/public/public_processor/guarded_merkle_tree.js +108 -0
  207. package/dest/public/public_processor/public_processor.d.ts +25 -30
  208. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  209. package/dest/public/public_processor/public_processor.js +141 -96
  210. package/dest/public/public_processor/public_processor_metrics.d.ts +2 -2
  211. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  212. package/dest/public/public_processor/public_processor_metrics.js +1 -1
  213. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +41 -0
  214. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -0
  215. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +89 -0
  216. package/dest/public/public_tx_simulator/index.d.ts +4 -0
  217. package/dest/public/public_tx_simulator/index.d.ts.map +1 -0
  218. package/dest/public/public_tx_simulator/index.js +2 -0
  219. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts +24 -0
  220. package/dest/public/public_tx_simulator/measured_public_tx_simulator.d.ts.map +1 -0
  221. package/dest/public/public_tx_simulator/measured_public_tx_simulator.js +51 -0
  222. package/dest/public/public_tx_simulator/public_tx_context.d.ts +19 -29
  223. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  224. package/dest/public/public_tx_simulator/public_tx_context.js +63 -91
  225. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +45 -47
  226. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  227. package/dest/public/public_tx_simulator/public_tx_simulator.js +209 -184
  228. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts +9 -0
  229. package/dest/public/public_tx_simulator/public_tx_simulator_interface.d.ts.map +1 -0
  230. package/dest/public/public_tx_simulator/public_tx_simulator_interface.js +1 -0
  231. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts +21 -0
  232. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.d.ts.map +1 -0
  233. package/dest/public/public_tx_simulator/telemetry_public_tx_simulator.js +39 -0
  234. package/dest/public/side_effect_errors.d.ts +41 -1
  235. package/dest/public/side_effect_errors.d.ts.map +1 -1
  236. package/dest/public/side_effect_errors.js +70 -1
  237. package/dest/public/side_effect_trace.d.ts +20 -65
  238. package/dest/public/side_effect_trace.d.ts.map +1 -1
  239. package/dest/public/side_effect_trace.js +71 -121
  240. package/dest/public/side_effect_trace_interface.d.ts +11 -22
  241. package/dest/public/side_effect_trace_interface.d.ts.map +1 -1
  242. package/dest/public/state_manager/index.d.ts +2 -0
  243. package/dest/public/state_manager/index.d.ts.map +1 -0
  244. package/dest/public/state_manager/index.js +1 -0
  245. package/dest/public/{avm/journal → state_manager}/nullifiers.d.ts +2 -5
  246. package/dest/public/state_manager/nullifiers.d.ts.map +1 -0
  247. package/dest/public/{avm/journal → state_manager}/nullifiers.js +3 -8
  248. package/dest/public/{avm/journal → state_manager}/public_storage.d.ts +2 -2
  249. package/dest/public/state_manager/public_storage.d.ts.map +1 -0
  250. package/dest/public/{avm/journal/journal.d.ts → state_manager/state_manager.d.ts} +42 -85
  251. package/dest/public/state_manager/state_manager.d.ts.map +1 -0
  252. package/dest/public/state_manager/state_manager.js +391 -0
  253. package/dest/public/test_executor_metrics.d.ts +54 -0
  254. package/dest/public/test_executor_metrics.d.ts.map +1 -0
  255. package/dest/public/test_executor_metrics.js +306 -0
  256. package/dest/public/unique_class_ids.d.ts.map +1 -1
  257. package/dest/public/utils.d.ts +2 -4
  258. package/dest/public/utils.d.ts.map +1 -1
  259. package/dest/public/utils.js +4 -21
  260. package/dest/server.d.ts +6 -3
  261. package/dest/server.d.ts.map +1 -1
  262. package/dest/server.js +5 -2
  263. package/dest/testing.d.ts +2 -0
  264. package/dest/testing.d.ts.map +1 -0
  265. package/dest/testing.js +1 -0
  266. package/package.json +36 -31
  267. package/src/client.ts +5 -3
  268. package/src/common/errors.ts +79 -44
  269. package/src/common/index.ts +0 -1
  270. package/src/private/acvm/acvm.ts +17 -32
  271. package/src/private/acvm/acvm_types.ts +1 -1
  272. package/src/private/acvm/deserialize.ts +35 -29
  273. package/src/private/acvm/index.ts +0 -1
  274. package/src/private/acvm/serialize.ts +63 -0
  275. package/src/private/{providers/acvm_native.ts → acvm_native.ts} +30 -15
  276. package/src/private/acvm_wasm.ts +72 -0
  277. package/src/private/acvm_wasm_with_blobs.ts +54 -0
  278. package/src/private/circuit_recording/circuit_recorder.ts +260 -0
  279. package/src/private/circuit_recording/file_circuit_recorder.ts +158 -0
  280. package/src/private/circuit_recording/memory_circuit_recorder.ts +11 -0
  281. package/src/private/circuit_recording/simulator_recorder_wrapper.ts +91 -0
  282. package/src/private/circuit_simulator.ts +90 -0
  283. package/src/private/{providers/factory.ts → factory.ts} +6 -6
  284. package/src/public/avm/avm_context.ts +4 -4
  285. package/src/public/avm/avm_contract_call_result.ts +17 -5
  286. package/src/public/avm/avm_execution_environment.ts +10 -1
  287. package/src/public/avm/avm_gas.ts +23 -35
  288. package/src/public/avm/avm_machine_state.ts +5 -0
  289. package/src/public/avm/avm_memory_types.ts +19 -6
  290. package/src/public/avm/avm_simulator.ts +44 -54
  291. package/src/public/avm/avm_simulator_interface.ts +8 -0
  292. package/src/public/avm/errors.ts +8 -77
  293. package/src/public/avm/fixtures/avm_simulation_tester.ts +23 -20
  294. package/src/public/avm/fixtures/base_avm_simulation_tester.ts +45 -12
  295. package/src/public/avm/fixtures/initializers.ts +104 -0
  296. package/src/public/avm/fixtures/utils.ts +150 -0
  297. package/src/public/avm/index.ts +0 -2
  298. package/src/public/avm/opcodes/accrued_substate.ts +64 -29
  299. package/src/public/avm/opcodes/addressing_mode.ts +56 -32
  300. package/src/public/avm/opcodes/arithmetic.ts +24 -2
  301. package/src/public/avm/opcodes/bitwise.ts +33 -29
  302. package/src/public/avm/opcodes/comparators.ts +6 -3
  303. package/src/public/avm/opcodes/contract.ts +10 -7
  304. package/src/public/avm/opcodes/control_flow.ts +19 -10
  305. package/src/public/avm/opcodes/conversion.ts +27 -3
  306. package/src/public/avm/opcodes/ec_add.ts +9 -6
  307. package/src/public/avm/opcodes/environment_getters.ts +27 -22
  308. package/src/public/avm/opcodes/external_calls.ts +61 -29
  309. package/src/public/avm/opcodes/hashing.ts +28 -8
  310. package/src/public/avm/opcodes/instruction.ts +31 -21
  311. package/src/public/avm/opcodes/memory.ts +71 -32
  312. package/src/public/avm/opcodes/misc.ts +60 -18
  313. package/src/public/avm/opcodes/storage.ts +22 -6
  314. package/src/public/avm/revert_reason.ts +55 -0
  315. package/src/public/avm/serialization/buffer_cursor.ts +4 -1
  316. package/src/public/avm/serialization/bytecode_serialization.ts +72 -74
  317. package/src/public/avm/serialization/instruction_serialization.ts +75 -34
  318. package/src/public/avm/test_utils.ts +24 -41
  319. package/src/public/db_interfaces.ts +61 -0
  320. package/src/{common → public}/debug_fn_name.ts +7 -7
  321. package/src/public/executor_metrics.ts +55 -6
  322. package/src/public/executor_metrics_interface.ts +14 -0
  323. package/src/public/fixtures/amm_test.ts +331 -0
  324. package/src/public/fixtures/bulk_test.ts +169 -0
  325. package/src/public/fixtures/custom_bytecode_tester.ts +49 -0
  326. package/src/public/fixtures/custom_bytecode_tests.ts +135 -0
  327. package/src/public/fixtures/index.ts +7 -0
  328. package/src/public/fixtures/minimal_public_tx.ts +36 -0
  329. package/src/public/fixtures/public_tx_simulation_tester.ts +158 -113
  330. package/src/public/{avm/fixtures → fixtures}/simple_contract_data_source.ts +36 -18
  331. package/src/public/fixtures/token_test.ts +140 -0
  332. package/src/public/fixtures/utils.ts +141 -68
  333. package/src/public/hinting_db_sources.ts +505 -0
  334. package/src/public/index.ts +9 -8
  335. package/src/public/public_db_sources.ts +196 -97
  336. package/src/public/public_errors.ts +14 -0
  337. package/src/public/public_processor/guarded_merkle_tree.ts +153 -0
  338. package/src/public/public_processor/public_processor.ts +191 -153
  339. package/src/public/public_processor/public_processor_metrics.ts +2 -2
  340. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +128 -0
  341. package/src/public/public_tx_simulator/index.ts +3 -0
  342. package/src/public/public_tx_simulator/measured_public_tx_simulator.ts +109 -0
  343. package/src/public/public_tx_simulator/public_tx_context.ts +160 -193
  344. package/src/public/public_tx_simulator/public_tx_simulator.ts +294 -220
  345. package/src/public/public_tx_simulator/public_tx_simulator_interface.ts +11 -0
  346. package/src/public/public_tx_simulator/telemetry_public_tx_simulator.ts +63 -0
  347. package/src/public/side_effect_errors.ts +91 -1
  348. package/src/public/side_effect_trace.ts +94 -320
  349. package/src/public/side_effect_trace_interface.ts +10 -58
  350. package/src/public/state_manager/index.ts +1 -0
  351. package/src/public/{avm/journal → state_manager}/nullifiers.ts +5 -11
  352. package/src/public/{avm/journal → state_manager}/public_storage.ts +2 -2
  353. package/src/public/state_manager/state_manager.ts +560 -0
  354. package/src/public/test_executor_metrics.ts +395 -0
  355. package/src/public/utils.ts +5 -21
  356. package/src/server.ts +6 -3
  357. package/src/testing.ts +1 -0
  358. package/dest/common/db_interfaces.d.ts +0 -80
  359. package/dest/common/db_interfaces.d.ts.map +0 -1
  360. package/dest/common/db_interfaces.js +0 -1
  361. package/dest/common/debug_fn_name.d.ts +0 -5
  362. package/dest/common/debug_fn_name.d.ts.map +0 -1
  363. package/dest/common/debug_fn_name.js +0 -6
  364. package/dest/common/message_load_oracle_inputs.d.ts +0 -15
  365. package/dest/common/message_load_oracle_inputs.d.ts.map +0 -1
  366. package/dest/common/message_load_oracle_inputs.js +0 -15
  367. package/dest/private/acvm/oracle/index.d.ts +0 -14
  368. package/dest/private/acvm/oracle/index.d.ts.map +0 -1
  369. package/dest/private/acvm/oracle/index.js +0 -2
  370. package/dest/private/acvm/oracle/oracle.d.ts +0 -49
  371. package/dest/private/acvm/oracle/oracle.d.ts.map +0 -1
  372. package/dest/private/acvm/oracle/oracle.js +0 -263
  373. package/dest/private/acvm/oracle/typed_oracle.d.ts +0 -83
  374. package/dest/private/acvm/oracle/typed_oracle.d.ts.map +0 -1
  375. package/dest/private/acvm/oracle/typed_oracle.js +0 -132
  376. package/dest/private/execution_data_provider.d.ts +0 -261
  377. package/dest/private/execution_data_provider.d.ts.map +0 -1
  378. package/dest/private/execution_data_provider.js +0 -14
  379. package/dest/private/execution_note_cache.d.ts +0 -93
  380. package/dest/private/execution_note_cache.d.ts.map +0 -1
  381. package/dest/private/execution_note_cache.js +0 -180
  382. package/dest/private/hashed_values_cache.d.ts +0 -28
  383. package/dest/private/hashed_values_cache.d.ts.map +0 -1
  384. package/dest/private/hashed_values_cache.js +0 -46
  385. package/dest/private/index.d.ts +0 -13
  386. package/dest/private/index.d.ts.map +0 -1
  387. package/dest/private/index.js +0 -12
  388. package/dest/private/pick_notes.d.ts +0 -85
  389. package/dest/private/pick_notes.d.ts.map +0 -1
  390. package/dest/private/pick_notes.js +0 -51
  391. package/dest/private/private_execution.d.ts +0 -25
  392. package/dest/private/private_execution.d.ts.map +0 -1
  393. package/dest/private/private_execution.js +0 -92
  394. package/dest/private/private_execution_oracle.d.ts +0 -215
  395. package/dest/private/private_execution_oracle.d.ts.map +0 -1
  396. package/dest/private/private_execution_oracle.js +0 -382
  397. package/dest/private/providers/acvm_native.d.ts.map +0 -1
  398. package/dest/private/providers/acvm_wasm.d.ts +0 -15
  399. package/dest/private/providers/acvm_wasm.d.ts.map +0 -1
  400. package/dest/private/providers/acvm_wasm_with_blobs.d.ts +0 -19
  401. package/dest/private/providers/acvm_wasm_with_blobs.d.ts.map +0 -1
  402. package/dest/private/providers/acvm_wasm_with_blobs.js +0 -32
  403. package/dest/private/providers/factory.d.ts +0 -12
  404. package/dest/private/providers/factory.d.ts.map +0 -1
  405. package/dest/private/providers/simulation_provider.d.ts +0 -19
  406. package/dest/private/providers/simulation_provider.d.ts.map +0 -1
  407. package/dest/private/providers/simulation_provider.js +0 -24
  408. package/dest/private/simulator.d.ts +0 -34
  409. package/dest/private/simulator.d.ts.map +0 -1
  410. package/dest/private/simulator.js +0 -76
  411. package/dest/private/unconstrained_execution.d.ts +0 -10
  412. package/dest/private/unconstrained_execution.d.ts.map +0 -1
  413. package/dest/private/unconstrained_execution.js +0 -27
  414. package/dest/private/unconstrained_execution_oracle.d.ts +0 -161
  415. package/dest/private/unconstrained_execution_oracle.d.ts.map +0 -1
  416. package/dest/private/unconstrained_execution_oracle.js +0 -258
  417. package/dest/public/avm/bytecode_utils.d.ts +0 -5
  418. package/dest/public/avm/bytecode_utils.d.ts.map +0 -1
  419. package/dest/public/avm/bytecode_utils.js +0 -17
  420. package/dest/public/avm/fixtures/index.d.ts +0 -84
  421. package/dest/public/avm/fixtures/index.d.ts.map +0 -1
  422. package/dest/public/avm/fixtures/index.js +0 -175
  423. package/dest/public/avm/fixtures/simple_contract_data_source.d.ts.map +0 -1
  424. package/dest/public/avm/journal/index.d.ts +0 -2
  425. package/dest/public/avm/journal/index.d.ts.map +0 -1
  426. package/dest/public/avm/journal/index.js +0 -1
  427. package/dest/public/avm/journal/journal.d.ts.map +0 -1
  428. package/dest/public/avm/journal/journal.js +0 -486
  429. package/dest/public/avm/journal/nullifiers.d.ts.map +0 -1
  430. package/dest/public/avm/journal/public_storage.d.ts.map +0 -1
  431. package/dest/public/bytecode_errors.d.ts +0 -4
  432. package/dest/public/bytecode_errors.d.ts.map +0 -1
  433. package/dest/public/bytecode_errors.js +0 -6
  434. package/dest/public/execution.d.ts +0 -108
  435. package/dest/public/execution.d.ts.map +0 -1
  436. package/dest/public/execution.js +0 -9
  437. package/dest/test/utils.d.ts +0 -13
  438. package/dest/test/utils.d.ts.map +0 -1
  439. package/dest/test/utils.js +0 -22
  440. package/src/common/db_interfaces.ts +0 -94
  441. package/src/common/message_load_oracle_inputs.ts +0 -15
  442. package/src/private/acvm/oracle/index.ts +0 -16
  443. package/src/private/acvm/oracle/oracle.ts +0 -455
  444. package/src/private/acvm/oracle/typed_oracle.ts +0 -259
  445. package/src/private/execution_data_provider.ts +0 -323
  446. package/src/private/execution_note_cache.ts +0 -217
  447. package/src/private/hashed_values_cache.ts +0 -55
  448. package/src/private/index.ts +0 -16
  449. package/src/private/pick_notes.ts +0 -141
  450. package/src/private/private_execution.ts +0 -151
  451. package/src/private/private_execution_oracle.ts +0 -614
  452. package/src/private/providers/acvm_wasm.ts +0 -63
  453. package/src/private/providers/acvm_wasm_with_blobs.ts +0 -50
  454. package/src/private/providers/simulation_provider.ts +0 -45
  455. package/src/private/simulator.ts +0 -147
  456. package/src/private/unconstrained_execution.ts +0 -50
  457. package/src/private/unconstrained_execution_oracle.ts +0 -373
  458. package/src/public/avm/bytecode_utils.ts +0 -17
  459. package/src/public/avm/fixtures/index.ts +0 -296
  460. package/src/public/avm/journal/index.ts +0 -1
  461. package/src/public/avm/journal/journal.ts +0 -742
  462. package/src/public/avm/opcodes/.eslintrc.cjs +0 -8
  463. package/src/public/bytecode_errors.ts +0 -6
  464. package/src/public/execution.ts +0 -140
  465. package/src/test/utils.ts +0 -36
  466. /package/dest/public/{avm/journal → state_manager}/public_storage.js +0 -0
@@ -9,49 +9,57 @@ abstract class ExternalCall extends Instruction {
9
9
  // Informs (de)serialization. See Instruction.deserialize.
10
10
  static readonly wireFormat: OperandType[] = [
11
11
  OperandType.UINT8,
12
- OperandType.UINT8, // Indirect
13
- OperandType.UINT16,
14
- OperandType.UINT16,
15
- OperandType.UINT16,
16
- OperandType.UINT16,
12
+ OperandType.UINT16, // Indirect
13
+ OperandType.UINT16, // L2 gas offset
14
+ OperandType.UINT16, // DA gas offset
15
+ OperandType.UINT16, // Address offset
16
+ OperandType.UINT16, // Args offset
17
+ OperandType.UINT16, // Args size offset
17
18
  ];
18
19
 
19
20
  constructor(
20
21
  private indirect: number,
21
- private gasOffset: number,
22
+ private l2GasOffset: number,
23
+ private daGasOffset: number,
22
24
  private addrOffset: number,
23
- private argsOffset: number,
24
25
  private argsSizeOffset: number,
26
+ private argsOffset: number,
25
27
  ) {
26
28
  super();
27
29
  }
28
30
 
29
31
  public async execute(context: AvmContext) {
30
32
  const memory = context.machineState.memory;
31
- const operands = [this.gasOffset, this.addrOffset, this.argsOffset, this.argsSizeOffset];
32
- const addressing = Addressing.fromWire(this.indirect, operands.length);
33
- const [gasOffset, addrOffset, argsOffset, argsSizeOffset] = addressing.resolve(operands, memory);
34
- memory.checkTags(TypeTag.FIELD, gasOffset, gasOffset + 1);
33
+ const addressing = Addressing.fromWire(this.indirect);
34
+
35
+ context.machineState.consumeGas(
36
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
37
+ );
38
+
39
+ const operands = [this.l2GasOffset, this.daGasOffset, this.addrOffset, this.argsSizeOffset, this.argsOffset];
40
+ const [l2GasOffset, daGasOffset, addrOffset, argsSizeOffset, argsOffset] = addressing.resolve(operands, memory);
41
+
42
+ memory.checkTags(TypeTag.UINT32, l2GasOffset);
43
+ memory.checkTags(TypeTag.UINT32, daGasOffset);
35
44
  memory.checkTag(TypeTag.FIELD, addrOffset);
36
45
  memory.checkTag(TypeTag.UINT32, argsSizeOffset);
37
46
 
38
47
  const calldataSize = memory.get(argsSizeOffset).toNumber();
39
48
  const calldata = memory.getSlice(argsOffset, calldataSize).map(f => f.toFr());
40
- memory.checkTagsRange(TypeTag.FIELD, argsOffset, calldataSize);
41
49
 
42
50
  const callAddress = memory.getAs<Field>(addrOffset);
43
51
  // If we are already in a static call, we propagate the environment.
44
52
  const callType = context.environment.isStaticCall ? 'STATICCALL' : this.type;
45
53
 
46
- // First we consume the gas for this operation.
47
- context.machineState.consumeGas(this.gasCost(calldataSize));
48
- // Then we consume the gas allocated for the nested call. The excess will be refunded later.
54
+ // We consume the gas allocated for the nested call. The excess will be refunded later.
49
55
  // Gas allocation is capped by the amount of gas left in the current context.
50
56
  // We have to do some dancing here because the gas allocation is a field,
51
57
  // but in the machine state we track gas as a number.
52
- const allocatedL2Gas = Number(BigIntMin(memory.get(gasOffset).toBigInt(), BigInt(context.machineState.l2GasLeft)));
58
+ const allocatedL2Gas = Number(
59
+ BigIntMin(memory.get(l2GasOffset).toBigInt(), BigInt(context.machineState.l2GasLeft)),
60
+ );
53
61
  const allocatedDaGas = Number(
54
- BigIntMin(memory.get(gasOffset + 1).toBigInt(), BigInt(context.machineState.daGasLeft)),
62
+ BigIntMin(memory.get(daGasOffset).toBigInt(), BigInt(context.machineState.daGasLeft)),
55
63
  );
56
64
  const allocatedGas = { l2Gas: allocatedL2Gas, daGas: allocatedDaGas };
57
65
  context.machineState.consumeGas(allocatedGas);
@@ -70,6 +78,9 @@ abstract class ExternalCall extends Instruction {
70
78
  // Track the success status directly
71
79
  context.machineState.nestedCallSuccess = success;
72
80
 
81
+ // Account for all instructions executed in the nested call
82
+ context.machineState.instrCounter += nestedCallResults.totalInstructions;
83
+
73
84
  // If the nested call reverted, we try to save the reason and the revert data.
74
85
  // This will be used by the caller to try to reconstruct the call stack.
75
86
  // This is only a heuristic and may not always work. It is intended to work
@@ -124,15 +135,22 @@ export class SuccessCopy extends Instruction {
124
135
  OperandType.UINT16, // dstOffset (16-bit)
125
136
  ];
126
137
 
127
- constructor(private indirect: number, private dstOffset: number) {
138
+ constructor(
139
+ private indirect: number,
140
+ private dstOffset: number,
141
+ ) {
128
142
  super();
129
143
  }
130
144
 
131
145
  public async execute(context: AvmContext): Promise<void> {
132
146
  const memory = context.machineState.memory;
147
+ const addressing = Addressing.fromWire(this.indirect);
148
+
149
+ context.machineState.consumeGas(
150
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
151
+ );
133
152
 
134
153
  const operands = [this.dstOffset];
135
- const addressing = Addressing.fromWire(this.indirect, operands.length);
136
154
  const [dstOffset] = addressing.resolve(operands, memory);
137
155
 
138
156
  // Use the direct success tracking property
@@ -154,20 +172,27 @@ export class Return extends Instruction {
154
172
  OperandType.UINT16,
155
173
  ];
156
174
 
157
- constructor(private indirect: number, private returnOffset: number, private returnSizeOffset: number) {
175
+ constructor(
176
+ private indirect: number,
177
+ private returnSizeOffset: number,
178
+ private returnOffset: number,
179
+ ) {
158
180
  super();
159
181
  }
160
182
 
161
183
  public async execute(context: AvmContext): Promise<void> {
162
184
  const memory = context.machineState.memory;
185
+ const addressing = Addressing.fromWire(this.indirect);
163
186
 
164
- const operands = [this.returnOffset, this.returnSizeOffset];
165
- const addressing = Addressing.fromWire(this.indirect, operands.length);
166
- const [returnOffset, returnSizeOffset] = addressing.resolve(operands, memory);
187
+ context.machineState.consumeGas(
188
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
189
+ );
190
+
191
+ const operands = [this.returnSizeOffset, this.returnOffset];
192
+ const [returnSizeOffset, returnOffset] = addressing.resolve(operands, memory);
167
193
 
168
194
  memory.checkTag(TypeTag.UINT32, returnSizeOffset);
169
195
  const returnSize = memory.get(returnSizeOffset).toNumber();
170
- context.machineState.consumeGas(this.gasCost(returnSize));
171
196
 
172
197
  const output = memory.getSlice(returnOffset, returnSize).map(word => word.toFr());
173
198
 
@@ -196,20 +221,27 @@ export class Revert extends Instruction {
196
221
  OperandType.UINT16,
197
222
  ];
198
223
 
199
- constructor(private indirect: number, private returnOffset: number, private retSizeOffset: number) {
224
+ constructor(
225
+ private indirect: number,
226
+ private retSizeOffset: number,
227
+ private returnOffset: number,
228
+ ) {
200
229
  super();
201
230
  }
202
231
 
203
232
  public async execute(context: AvmContext): Promise<void> {
204
233
  const memory = context.machineState.memory;
234
+ const addressing = Addressing.fromWire(this.indirect);
235
+
236
+ context.machineState.consumeGas(
237
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
238
+ );
205
239
 
206
- const operands = [this.returnOffset, this.retSizeOffset];
207
- const addressing = Addressing.fromWire(this.indirect, operands.length);
208
- const [returnOffset, retSizeOffset] = addressing.resolve(operands, memory);
240
+ const operands = [this.retSizeOffset, this.returnOffset];
241
+ const [retSizeOffset, returnOffset] = addressing.resolve(operands, memory);
209
242
 
210
243
  memory.checkTag(TypeTag.UINT32, retSizeOffset);
211
244
  const retSize = memory.get(retSizeOffset).toNumber();
212
- context.machineState.consumeGas(this.gasCost(retSize));
213
245
  const output = memory.getSlice(returnOffset, retSize).map(word => word.toFr());
214
246
 
215
247
  context.machineState.revert(output);
@@ -19,16 +19,24 @@ export class Poseidon2 extends Instruction {
19
19
  OperandType.UINT16,
20
20
  ];
21
21
 
22
- constructor(private indirect: number, private inputStateOffset: number, private outputStateOffset: number) {
22
+ constructor(
23
+ private indirect: number,
24
+ private inputStateOffset: number,
25
+ private outputStateOffset: number,
26
+ ) {
23
27
  super();
24
28
  }
25
29
 
26
30
  public async execute(context: AvmContext): Promise<void> {
27
31
  const memory = context.machineState.memory;
28
- context.machineState.consumeGas(this.gasCost());
32
+ const addressing = Addressing.fromWire(this.indirect);
33
+
34
+ context.machineState.consumeGas(
35
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
36
+ );
29
37
 
30
38
  const operands = [this.inputStateOffset, this.outputStateOffset];
31
- const addressing = Addressing.fromWire(this.indirect, operands.length);
39
+
32
40
  const [inputOffset, outputOffset] = addressing.resolve(operands, memory);
33
41
 
34
42
  const inputState = memory.getSlice(inputOffset, Poseidon2.stateSize);
@@ -54,7 +62,11 @@ export class KeccakF1600 extends Instruction {
54
62
  OperandType.UINT16,
55
63
  ];
56
64
 
57
- constructor(private indirect: number, private dstOffset: number, private inputOffset: number) {
65
+ constructor(
66
+ private indirect: number,
67
+ private dstOffset: number,
68
+ private inputOffset: number,
69
+ ) {
58
70
  super();
59
71
  }
60
72
 
@@ -62,10 +74,14 @@ export class KeccakF1600 extends Instruction {
62
74
  public async execute(context: AvmContext): Promise<void> {
63
75
  const inputSize = 25;
64
76
  const memory = context.machineState.memory;
77
+ const addressing = Addressing.fromWire(this.indirect);
78
+
79
+ context.machineState.consumeGas(
80
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
81
+ );
82
+
65
83
  const operands = [this.dstOffset, this.inputOffset];
66
- const addressing = Addressing.fromWire(this.indirect, operands.length);
67
84
  const [dstOffset, inputOffset] = addressing.resolve(operands, memory);
68
- context.machineState.consumeGas(this.gasCost());
69
85
 
70
86
  const stateData = memory.getSlice(inputOffset, inputSize).map(word => word.toBigInt());
71
87
  memory.checkTagsRange(TypeTag.UINT64, inputOffset, inputSize);
@@ -104,12 +120,16 @@ export class Sha256Compression extends Instruction {
104
120
  const INPUTS_SIZE = 16;
105
121
 
106
122
  const memory = context.machineState.memory;
123
+ const addressing = Addressing.fromWire(this.indirect);
124
+
125
+ context.machineState.consumeGas(
126
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
127
+ );
128
+
107
129
  const operands = [this.outputOffset, this.stateOffset, this.inputsOffset];
108
- const addressing = Addressing.fromWire(this.indirect, operands.length);
109
130
  const [outputOffset, stateOffset, inputsOffset] = addressing.resolve(operands, memory);
110
131
 
111
132
  // Note: size of output is same as size of state
112
- context.machineState.consumeGas(this.gasCost());
113
133
  const inputs = Uint32Array.from(memory.getSlice(inputsOffset, INPUTS_SIZE).map(word => word.toNumber()));
114
134
  const state = Uint32Array.from(memory.getSlice(stateOffset, STATE_SIZE).map(word => word.toNumber()));
115
135
 
@@ -1,9 +1,10 @@
1
+ import type { Bufferable } from '@aztec/foundation/serialize';
2
+
1
3
  import { strict as assert } from 'assert';
2
4
 
3
5
  import type { AvmContext } from '../avm_context.js';
4
- import { type Gas, getBaseGasCost, getDynamicGasCost, mulGas, sumGas } from '../avm_gas.js';
6
+ import { type Gas, computeAddressingCost, getBaseGasCost, getDynamicGasCost, mulGas, sumGas } from '../avm_gas.js';
5
7
  import type { BufferCursor } from '../serialization/buffer_cursor.js';
6
- import type { Serializable } from '../serialization/bytecode_serialization.js';
7
8
  import { Opcode, type OperandType, deserialize, serializeAs } from '../serialization/instruction_serialization.js';
8
9
 
9
10
  type InstructionConstructor = {
@@ -35,6 +36,8 @@ export abstract class Instruction {
35
36
  * @returns Thee string representation.
36
37
  */
37
38
  public toString(): string {
39
+ // Note: we could have this be the actual wire opcode if `bytecode_serialization.ts` were to
40
+ // pass it into the class' static `Instruction.as(this, wireFormat)` method.
38
41
  let instructionStr = this.constructor.name + ': ';
39
42
  // assumes that all properties are flags or operands
40
43
  for (const prop of Object.getOwnPropertyNames(this) as (keyof Instruction)[]) {
@@ -44,19 +47,19 @@ export abstract class Instruction {
44
47
  }
45
48
 
46
49
  // Default deserialization which uses Class.opcode and Class.wireFormat.
47
- public static deserialize(
50
+ public static fromBuffer(
48
51
  this: InstructionConstructor & { wireFormat: OperandType[]; as: any },
49
52
  buf: BufferCursor | Buffer,
50
53
  ): Instruction {
51
- return this.as(this.wireFormat).deserialize(buf);
54
+ return this.as(this.wireFormat).fromBuffer(buf);
52
55
  }
53
56
 
54
57
  // Default serialization which uses Class.opcode and Class.wireFormat.
55
- public serialize(): Buffer {
58
+ public toBuffer(): Buffer {
56
59
  const klass = this.constructor as any;
57
60
  assert(klass.opcode !== undefined && klass.opcode !== null);
58
61
  assert(klass.wireFormat !== undefined && klass.wireFormat !== null);
59
- return this.as(klass.opcode, klass.wireFormat).serialize();
62
+ return this.as(klass.opcode, klass.wireFormat).toBuffer();
60
63
  }
61
64
 
62
65
  /**
@@ -65,8 +68,8 @@ export abstract class Instruction {
65
68
  * @param wireFormat The wire format of the instruction.
66
69
  * @returns The new instruction instance.
67
70
  */
68
- public as(opcode: Opcode, wireFormat: OperandType[]): Instruction & Serializable {
69
- return Object.defineProperty(this, 'serialize', {
71
+ public as(opcode: Opcode, wireFormat: OperandType[]): Instruction & Bufferable {
72
+ return Object.defineProperty(this, 'toBuffer', {
70
73
  value: (): Buffer => {
71
74
  return serializeAs(wireFormat, opcode, this);
72
75
  },
@@ -82,7 +85,7 @@ export abstract class Instruction {
82
85
  */
83
86
  public static as(this: InstructionConstructor, wireFormat: OperandType[]) {
84
87
  return Object.assign(this, {
85
- deserialize: (buf: BufferCursor | Buffer): Instruction => {
88
+ fromBuffer: (buf: BufferCursor | Buffer): Instruction => {
86
89
  const res = deserialize(buf, wireFormat);
87
90
  const args = res.slice(1); // Remove opcode.
88
91
  return new this(...args);
@@ -91,13 +94,20 @@ export abstract class Instruction {
91
94
  }
92
95
 
93
96
  /**
94
- * Computes gas cost for the instruction based on its base cost and memory operations.
95
- * @returns Gas cost.
97
+ * Returns the base gas cost for the instruction.
98
+ * @returns The base gas cost.
96
99
  */
97
- protected gasCost(dynMultiplier: number = 0): Gas {
98
- const baseGasCost = getBaseGasCost(this.opcode);
99
- const dynGasCost = mulGas(getDynamicGasCost(this.opcode), dynMultiplier);
100
- return sumGas(baseGasCost, dynGasCost);
100
+ protected baseGasCost(indirectOperandsCount: number, relativeOperandsCount: number): Gas {
101
+ return sumGas(getBaseGasCost(this.opcode), computeAddressingCost(indirectOperandsCount, relativeOperandsCount));
102
+ }
103
+
104
+ /**
105
+ * Computes the dynamic gas cost for the instruction
106
+ * @param dynMultiplier - The multiplier for the dynamic gas cost.
107
+ * @returns The dynamic gas cost.
108
+ */
109
+ protected dynamicGasCost(dynMultiplier: number = 0): Gas {
110
+ return mulGas(getDynamicGasCost(this.opcode), dynMultiplier);
101
111
  }
102
112
 
103
113
  /**
@@ -106,9 +116,7 @@ export abstract class Instruction {
106
116
  */
107
117
  public get type(): string {
108
118
  const type = 'type' in this.constructor && (this.constructor.type as string);
109
- if (!type) {
110
- throw new Error(`Instruction class ${this.constructor.name} does not have a static 'type' property defined.`);
111
- }
119
+ assert(!!type, `Instruction class ${this.constructor.name} does not have a static 'type' property defined.`);
112
120
  return type;
113
121
  }
114
122
 
@@ -118,9 +126,11 @@ export abstract class Instruction {
118
126
  */
119
127
  public get opcode(): Opcode {
120
128
  const opcode = 'opcode' in this.constructor ? (this.constructor.opcode as Opcode) : undefined;
121
- if (opcode === undefined || Opcode[opcode] === undefined) {
122
- throw new Error(`Instruction class ${this.constructor.name} does not have a static 'opcode' property defined.`);
123
- }
129
+ assert(
130
+ opcode !== undefined,
131
+ `Instruction class ${this.constructor.name} does not have a static 'opcode' property defined.`,
132
+ );
133
+ assert(Opcode[opcode] !== undefined, `Invalid opcode ${opcode} for instruction class ${this.constructor.name}.`);
124
134
  return opcode;
125
135
  }
126
136
  }
@@ -1,3 +1,7 @@
1
+ import { Fr } from '@aztec/foundation/fields';
2
+
3
+ import { strict as assert } from 'assert';
4
+
1
5
  import type { AvmContext } from '../avm_context.js';
2
6
  import { Field, TaggedMemory, TypeTag, Uint32 } from '../avm_memory_types.js';
3
7
  import { Opcode, OperandType } from '../serialization/instruction_serialization.js';
@@ -13,42 +17,42 @@ export class Set extends Instruction {
13
17
  OperandType.UINT8, // opcode
14
18
  OperandType.UINT8, // indirect
15
19
  OperandType.UINT8, // dstOffset
16
- OperandType.UINT8, // tag
20
+ OperandType.TAG, // tag
17
21
  OperandType.UINT8, // const (value)
18
22
  ];
19
23
  public static readonly wireFormat16: OperandType[] = [
20
24
  OperandType.UINT8, // opcode
21
25
  OperandType.UINT8, // indirect
22
26
  OperandType.UINT16, // dstOffset
23
- OperandType.UINT8, // tag
27
+ OperandType.TAG, // tag
24
28
  OperandType.UINT16, // const (value)
25
29
  ];
26
30
  public static readonly wireFormat32: OperandType[] = [
27
31
  OperandType.UINT8, // opcode
28
32
  OperandType.UINT8, // indirect
29
33
  OperandType.UINT16, // dstOffset
30
- OperandType.UINT8, // tag
34
+ OperandType.TAG, // tag
31
35
  OperandType.UINT32, // const (value)
32
36
  ];
33
37
  public static readonly wireFormat64: OperandType[] = [
34
38
  OperandType.UINT8, // opcode
35
39
  OperandType.UINT8, // indirect
36
40
  OperandType.UINT16, // dstOffset
37
- OperandType.UINT8, // tag
41
+ OperandType.TAG, // tag
38
42
  OperandType.UINT64, // const (value)
39
43
  ];
40
44
  public static readonly wireFormat128: OperandType[] = [
41
45
  OperandType.UINT8, // opcode
42
46
  OperandType.UINT8, // indirect
43
47
  OperandType.UINT16, // dstOffset
44
- OperandType.UINT8, // tag
48
+ OperandType.TAG, // tag
45
49
  OperandType.UINT128, // const (value)
46
50
  ];
47
51
  public static readonly wireFormatFF: OperandType[] = [
48
52
  OperandType.UINT8, // opcode
49
53
  OperandType.UINT8, // indirect
50
54
  OperandType.UINT16, // dstOffset
51
- OperandType.UINT8, // tag
55
+ OperandType.TAG, // tag
52
56
  OperandType.FF, // const (value)
53
57
  ];
54
58
 
@@ -59,7 +63,8 @@ export class Set extends Instruction {
59
63
  private value: bigint | number,
60
64
  ) {
61
65
  super();
62
- TaggedMemory.checkIsValidTag(inTag);
66
+ assert(this.value >= 0, `Value ${this.value} is negative`);
67
+ assert(this.value < Fr.MODULUS, `Value ${this.value} is larger than Fr.MODULUS`);
63
68
  }
64
69
 
65
70
  public async execute(context: AvmContext): Promise<void> {
@@ -67,10 +72,13 @@ export class Set extends Instruction {
67
72
  const res = TaggedMemory.buildFromTagTruncating(this.value, this.inTag);
68
73
 
69
74
  const memory = context.machineState.memory;
70
- context.machineState.consumeGas(this.gasCost());
75
+ const addressing = Addressing.fromWire(this.indirect);
76
+
77
+ context.machineState.consumeGas(
78
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
79
+ );
71
80
 
72
81
  const operands = [this.dstOffset];
73
- const addressing = Addressing.fromWire(this.indirect, operands.length);
74
82
  const [dstOffset] = addressing.resolve(operands, memory);
75
83
  memory.set(dstOffset, res);
76
84
  }
@@ -85,27 +93,34 @@ export class Cast extends Instruction {
85
93
  OperandType.UINT8,
86
94
  OperandType.UINT8,
87
95
  OperandType.UINT8,
88
- OperandType.UINT8,
96
+ OperandType.TAG,
89
97
  ];
90
98
  static readonly wireFormat16 = [
91
99
  OperandType.UINT8,
92
100
  OperandType.UINT8,
93
101
  OperandType.UINT16,
94
102
  OperandType.UINT16,
95
- OperandType.UINT8,
103
+ OperandType.TAG,
96
104
  ];
97
105
 
98
- constructor(private indirect: number, private srcOffset: number, private dstOffset: number, private dstTag: number) {
106
+ constructor(
107
+ private indirect: number,
108
+ private srcOffset: number,
109
+ private dstOffset: number,
110
+ private dstTag: number,
111
+ ) {
99
112
  super();
100
- TaggedMemory.checkIsValidTag(dstTag);
101
113
  }
102
114
 
103
115
  public async execute(context: AvmContext): Promise<void> {
104
116
  const memory = context.machineState.memory;
105
- context.machineState.consumeGas(this.gasCost());
117
+ const addressing = Addressing.fromWire(this.indirect);
118
+
119
+ context.machineState.consumeGas(
120
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
121
+ );
106
122
 
107
123
  const operands = [this.srcOffset, this.dstOffset];
108
- const addressing = Addressing.fromWire(this.indirect, operands.length);
109
124
  const [srcOffset, dstOffset] = addressing.resolve(operands, memory);
110
125
 
111
126
  const a = memory.get(srcOffset);
@@ -134,16 +149,23 @@ export class Mov extends Instruction {
134
149
  OperandType.UINT16,
135
150
  ];
136
151
 
137
- constructor(private indirect: number, private srcOffset: number, private dstOffset: number) {
152
+ constructor(
153
+ private indirect: number,
154
+ private srcOffset: number,
155
+ private dstOffset: number,
156
+ ) {
138
157
  super();
139
158
  }
140
159
 
141
160
  public async execute(context: AvmContext): Promise<void> {
142
161
  const memory = context.machineState.memory;
143
- context.machineState.consumeGas(this.gasCost());
162
+ const addressing = Addressing.fromWire(this.indirect);
163
+
164
+ context.machineState.consumeGas(
165
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
166
+ );
144
167
 
145
168
  const operands = [this.srcOffset, this.dstOffset];
146
- const addressing = Addressing.fromWire(this.indirect, operands.length);
147
169
  const [srcOffset, dstOffset] = addressing.resolve(operands, memory);
148
170
  const a = memory.get(srcOffset);
149
171
  memory.set(dstOffset, a);
@@ -164,8 +186,8 @@ export class CalldataCopy extends Instruction {
164
186
 
165
187
  constructor(
166
188
  private indirect: number,
167
- private cdStartOffset: number,
168
189
  private copySizeOffset: number,
190
+ private cdStartOffset: number,
169
191
  private dstOffset: number,
170
192
  ) {
171
193
  super();
@@ -173,14 +195,19 @@ export class CalldataCopy extends Instruction {
173
195
 
174
196
  public async execute(context: AvmContext): Promise<void> {
175
197
  const memory = context.machineState.memory;
176
- const operands = [this.cdStartOffset, this.copySizeOffset, this.dstOffset];
177
- const addressing = Addressing.fromWire(this.indirect, operands.length);
178
- const [cdStartOffset, copySizeOffset, dstOffset] = addressing.resolve(operands, memory);
198
+ const addressing = Addressing.fromWire(this.indirect);
199
+
200
+ context.machineState.consumeGas(
201
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
202
+ );
203
+
204
+ const operands = [this.copySizeOffset, this.cdStartOffset, this.dstOffset];
205
+ const [copySizeOffset, cdStartOffset, dstOffset] = addressing.resolve(operands, memory);
179
206
 
180
207
  memory.checkTags(TypeTag.UINT32, cdStartOffset, copySizeOffset);
181
208
  const cdStart = memory.get(cdStartOffset).toNumber();
182
209
  const copySize = memory.get(copySizeOffset).toNumber();
183
- context.machineState.consumeGas(this.gasCost(copySize));
210
+ context.machineState.consumeGas(this.dynamicGasCost(copySize));
184
211
 
185
212
  // Values which are out-of-range of the calldata array will be set with Field(0);
186
213
  const slice = context.environment.calldata.slice(cdStart, cdStart + copySize).map(f => new Field(f));
@@ -197,16 +224,23 @@ export class ReturndataSize extends Instruction {
197
224
  // Informs (de)serialization. See Instruction.deserialize.
198
225
  static readonly wireFormat: OperandType[] = [OperandType.UINT8, OperandType.UINT8, OperandType.UINT16];
199
226
 
200
- constructor(private indirect: number, private dstOffset: number) {
227
+ constructor(
228
+ private indirect: number,
229
+ private dstOffset: number,
230
+ ) {
201
231
  super();
202
232
  }
203
233
 
204
234
  public async execute(context: AvmContext): Promise<void> {
205
235
  const memory = context.machineState.memory;
236
+ const addressing = Addressing.fromWire(this.indirect);
237
+
238
+ context.machineState.consumeGas(
239
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
240
+ );
241
+
206
242
  const operands = [this.dstOffset];
207
- const addressing = Addressing.fromWire(this.indirect, operands.length);
208
243
  const [dstOffset] = addressing.resolve(operands, memory);
209
- context.machineState.consumeGas(this.gasCost());
210
244
 
211
245
  memory.set(dstOffset, new Uint32(context.machineState.nestedReturndata.length));
212
246
  }
@@ -226,8 +260,8 @@ export class ReturndataCopy extends Instruction {
226
260
 
227
261
  constructor(
228
262
  private indirect: number,
229
- private rdStartOffset: number,
230
263
  private copySizeOffset: number,
264
+ private rdStartOffset: number,
231
265
  private dstOffset: number,
232
266
  ) {
233
267
  super();
@@ -235,14 +269,19 @@ export class ReturndataCopy extends Instruction {
235
269
 
236
270
  public async execute(context: AvmContext): Promise<void> {
237
271
  const memory = context.machineState.memory;
238
- const operands = [this.rdStartOffset, this.copySizeOffset, this.dstOffset];
239
- const addressing = Addressing.fromWire(this.indirect, operands.length);
240
- const [rdStartOffset, copySizeOffset, dstOffset] = addressing.resolve(operands, memory);
272
+ const addressing = Addressing.fromWire(this.indirect);
273
+
274
+ context.machineState.consumeGas(
275
+ this.baseGasCost(addressing.indirectOperandsCount(), addressing.relativeOperandsCount()),
276
+ );
277
+
278
+ const operands = [this.copySizeOffset, this.rdStartOffset, this.dstOffset];
279
+ const [copySizeOffset, rdStartOffset, dstOffset] = addressing.resolve(operands, memory);
241
280
 
242
281
  memory.checkTags(TypeTag.UINT32, rdStartOffset, copySizeOffset);
243
- const rdStart = memory.get(rdStartOffset).toNumber();
244
282
  const copySize = memory.get(copySizeOffset).toNumber();
245
- context.machineState.consumeGas(this.gasCost(copySize));
283
+ const rdStart = memory.get(rdStartOffset).toNumber();
284
+ context.machineState.consumeGas(this.dynamicGasCost(copySize));
246
285
 
247
286
  // Values which are out-of-range of the returndata array will be set with Field(0);
248
287
  const slice = context.machineState.nestedReturndata.slice(rdStart, rdStart + copySize).map(f => new Field(f));