@aztec/end-to-end 0.0.1-commit.4d79d1f2d → 0.0.1-commit.4d9804df

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 (343) hide show
  1. package/README.md +217 -14
  2. package/dest/automine/automine_test_context.d.ts +85 -0
  3. package/dest/automine/automine_test_context.d.ts.map +1 -0
  4. package/dest/automine/automine_test_context.js +98 -0
  5. package/dest/automine/contracts/fixtures/storage_proof_fetcher.d.ts +2 -0
  6. package/dest/automine/contracts/fixtures/storage_proof_fetcher.d.ts.map +1 -0
  7. package/dest/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fixture.d.ts +1 -1
  8. package/dest/automine/contracts/fixtures/storage_proof_fixture.d.ts.map +1 -0
  9. package/dest/automine/delivery/interactive_handshake_responder.d.ts +48 -0
  10. package/dest/automine/delivery/interactive_handshake_responder.d.ts.map +1 -0
  11. package/dest/automine/delivery/interactive_handshake_responder.js +76 -0
  12. package/dest/automine/delivery/onchain_delivery_harness.d.ts +19 -0
  13. package/dest/automine/delivery/onchain_delivery_harness.d.ts.map +1 -0
  14. package/dest/automine/delivery/onchain_delivery_harness.js +141 -0
  15. package/dest/automine/token/blacklist_token_contract_test.d.ts +49 -0
  16. package/dest/automine/token/blacklist_token_contract_test.d.ts.map +1 -0
  17. package/dest/{e2e_blacklist_token_contract → automine/token}/blacklist_token_contract_test.js +39 -52
  18. package/dest/automine/token/token_contract_test.d.ts +40 -0
  19. package/dest/automine/token/token_contract_test.d.ts.map +1 -0
  20. package/dest/{e2e_token_contract → automine/token}/token_contract_test.js +37 -52
  21. package/dest/automine/token/token_test_helpers.d.ts +73 -0
  22. package/dest/automine/token/token_test_helpers.d.ts.map +1 -0
  23. package/dest/automine/token/token_test_helpers.js +97 -0
  24. package/dest/bench/client_flows/benchmark.d.ts +15 -1
  25. package/dest/bench/client_flows/benchmark.d.ts.map +1 -1
  26. package/dest/bench/client_flows/benchmark.js +19 -0
  27. package/dest/bench/client_flows/client_flows_benchmark.d.ts +5 -5
  28. package/dest/bench/client_flows/client_flows_benchmark.d.ts.map +1 -1
  29. package/dest/bench/client_flows/client_flows_benchmark.js +62 -53
  30. package/dest/bench/client_flows/data_extractor.js +1 -0
  31. package/dest/bench/utils.d.ts +3 -3
  32. package/dest/bench/utils.d.ts.map +1 -1
  33. package/dest/bench/utils.js +102 -8
  34. package/dest/composed/ha/ha_full_setup.d.ts +77 -0
  35. package/dest/composed/ha/ha_full_setup.d.ts.map +1 -0
  36. package/dest/composed/ha/ha_full_setup.js +383 -0
  37. package/dest/composed/web3signer/multi_validator_keystore_utils.d.ts +12 -0
  38. package/dest/composed/web3signer/multi_validator_keystore_utils.d.ts.map +1 -0
  39. package/dest/fixtures/authwit_proxy.d.ts +15 -0
  40. package/dest/fixtures/authwit_proxy.d.ts.map +1 -0
  41. package/dest/fixtures/authwit_proxy.js +34 -0
  42. package/dest/fixtures/e2e_prover_test.d.ts +17 -13
  43. package/dest/fixtures/e2e_prover_test.d.ts.map +1 -1
  44. package/dest/fixtures/e2e_prover_test.js +82 -74
  45. package/dest/fixtures/elu_monitor.d.ts +21 -0
  46. package/dest/fixtures/elu_monitor.d.ts.map +1 -0
  47. package/dest/fixtures/elu_monitor.js +102 -0
  48. package/dest/fixtures/fixtures.d.ts +83 -1
  49. package/dest/fixtures/fixtures.d.ts.map +1 -1
  50. package/dest/fixtures/fixtures.js +86 -0
  51. package/dest/fixtures/get_bb_config.d.ts +1 -1
  52. package/dest/fixtures/get_bb_config.d.ts.map +1 -1
  53. package/dest/fixtures/get_bb_config.js +5 -5
  54. package/dest/fixtures/ha_setup.d.ts +4 -4
  55. package/dest/fixtures/ha_setup.d.ts.map +1 -1
  56. package/dest/fixtures/ha_setup.js +8 -3
  57. package/dest/fixtures/index.d.ts +2 -1
  58. package/dest/fixtures/index.d.ts.map +1 -1
  59. package/dest/fixtures/index.js +1 -0
  60. package/dest/fixtures/schnorr_hardcoded_account_contract.d.ts +25 -0
  61. package/dest/fixtures/schnorr_hardcoded_account_contract.d.ts.map +1 -0
  62. package/dest/fixtures/schnorr_hardcoded_account_contract.js +37 -0
  63. package/dest/fixtures/setup.d.ts +99 -48
  64. package/dest/fixtures/setup.d.ts.map +1 -1
  65. package/dest/fixtures/setup.js +319 -262
  66. package/dest/fixtures/setup_p2p_test.d.ts +14 -7
  67. package/dest/fixtures/setup_p2p_test.d.ts.map +1 -1
  68. package/dest/fixtures/setup_p2p_test.js +21 -18
  69. package/dest/fixtures/timing.d.ts +42 -0
  70. package/dest/fixtures/timing.d.ts.map +1 -0
  71. package/dest/fixtures/timing.js +72 -0
  72. package/dest/fixtures/token_utils.d.ts +22 -4
  73. package/dest/fixtures/token_utils.d.ts.map +1 -1
  74. package/dest/fixtures/token_utils.js +26 -8
  75. package/dest/fixtures/utils.d.ts +2 -2
  76. package/dest/fixtures/utils.d.ts.map +1 -1
  77. package/dest/fixtures/utils.js +1 -1
  78. package/dest/fixtures/wait_helpers.d.ts +135 -0
  79. package/dest/fixtures/wait_helpers.d.ts.map +1 -0
  80. package/dest/fixtures/wait_helpers.js +154 -0
  81. package/dest/forward-compatibility/wallet_rpc_client.d.ts +7 -0
  82. package/dest/forward-compatibility/wallet_rpc_client.d.ts.map +1 -0
  83. package/dest/forward-compatibility/wallet_rpc_client.js +15 -0
  84. package/dest/forward-compatibility/wallet_service.d.ts +3 -0
  85. package/dest/forward-compatibility/wallet_service.d.ts.map +1 -0
  86. package/dest/forward-compatibility/wallet_service.js +109 -0
  87. package/dest/install_legacy_contracts.d.cts +10 -0
  88. package/dest/install_legacy_contracts.d.cts.map +1 -0
  89. package/dest/legacy-jest-resolver.d.cts +3 -0
  90. package/dest/legacy-jest-resolver.d.cts.map +1 -0
  91. package/dest/multi-node/block-production/setup.d.ts +97 -0
  92. package/dest/multi-node/block-production/setup.d.ts.map +1 -0
  93. package/dest/multi-node/block-production/setup.js +158 -0
  94. package/dest/multi-node/governance/setup.d.ts +67 -0
  95. package/dest/multi-node/governance/setup.d.ts.map +1 -0
  96. package/dest/multi-node/governance/setup.js +126 -0
  97. package/dest/multi-node/multi_node_test_context.d.ts +212 -0
  98. package/dest/multi-node/multi_node_test_context.d.ts.map +1 -0
  99. package/dest/multi-node/multi_node_test_context.js +347 -0
  100. package/dest/multi-node/slashing/inactivity_setup.d.ts +27 -0
  101. package/dest/multi-node/slashing/inactivity_setup.d.ts.map +1 -0
  102. package/dest/multi-node/slashing/inactivity_setup.js +111 -0
  103. package/dest/multi-node/slashing/setup.d.ts +167 -0
  104. package/dest/multi-node/slashing/setup.d.ts.map +1 -0
  105. package/dest/multi-node/slashing/setup.js +275 -0
  106. package/dest/{e2e_p2p → p2p}/p2p_network.d.ts +21 -11
  107. package/dest/p2p/p2p_network.d.ts.map +1 -0
  108. package/dest/{e2e_p2p → p2p}/p2p_network.js +97 -37
  109. package/dest/p2p/reqresp/utils.d.ts +19 -0
  110. package/dest/p2p/reqresp/utils.d.ts.map +1 -0
  111. package/dest/{e2e_p2p → p2p}/reqresp/utils.js +67 -27
  112. package/dest/p2p/shared.d.ts +72 -0
  113. package/dest/p2p/shared.d.ts.map +1 -0
  114. package/dest/p2p/shared.js +212 -0
  115. package/dest/shared/cross_chain_test_harness.d.ts +6 -4
  116. package/dest/shared/cross_chain_test_harness.d.ts.map +1 -1
  117. package/dest/shared/cross_chain_test_harness.js +36 -31
  118. package/dest/shared/gas_portal_test_harness.d.ts +8 -5
  119. package/dest/shared/gas_portal_test_harness.d.ts.map +1 -1
  120. package/dest/shared/gas_portal_test_harness.js +26 -14
  121. package/dest/shared/index.d.ts +2 -1
  122. package/dest/shared/index.d.ts.map +1 -1
  123. package/dest/shared/index.js +1 -0
  124. package/dest/shared/jest_setup.js +41 -1
  125. package/dest/shared/mock_state_view.d.ts +86 -0
  126. package/dest/shared/mock_state_view.d.ts.map +1 -0
  127. package/dest/shared/mock_state_view.js +186 -0
  128. package/dest/shared/submit-transactions.d.ts +1 -1
  129. package/dest/shared/submit-transactions.d.ts.map +1 -1
  130. package/dest/shared/submit-transactions.js +12 -5
  131. package/dest/shared/timing_env.d.js +5 -0
  132. package/dest/shared/timing_env.js +365 -0
  133. package/dest/shared/uniswap_l1_l2.d.ts +1 -1
  134. package/dest/shared/uniswap_l1_l2.d.ts.map +1 -1
  135. package/dest/shared/uniswap_l1_l2.js +55 -45
  136. package/dest/shared/wait_for_l1_to_l2_message.d.ts +13 -0
  137. package/dest/shared/wait_for_l1_to_l2_message.d.ts.map +1 -0
  138. package/dest/shared/wait_for_l1_to_l2_message.js +10 -0
  139. package/dest/simulators/lending_simulator.d.ts +10 -3
  140. package/dest/simulators/lending_simulator.d.ts.map +1 -1
  141. package/dest/simulators/lending_simulator.js +27 -15
  142. package/dest/simulators/token_simulator.d.ts +1 -1
  143. package/dest/simulators/token_simulator.d.ts.map +1 -1
  144. package/dest/simulators/token_simulator.js +2 -2
  145. package/dest/single-node/cross-chain/cross_chain_messaging_test.d.ts +75 -0
  146. package/dest/single-node/cross-chain/cross_chain_messaging_test.d.ts.map +1 -0
  147. package/dest/single-node/cross-chain/cross_chain_messaging_test.js +209 -0
  148. package/dest/single-node/cross-chain/message_test_helpers.d.ts +38 -0
  149. package/dest/single-node/cross-chain/message_test_helpers.d.ts.map +1 -0
  150. package/dest/single-node/cross-chain/message_test_helpers.js +70 -0
  151. package/dest/{e2e_fees → single-node/fees}/bridging_race.notest.d.ts +1 -1
  152. package/dest/single-node/fees/bridging_race.notest.d.ts.map +1 -0
  153. package/dest/{e2e_fees → single-node/fees}/bridging_race.notest.js +17 -4
  154. package/dest/single-node/fees/fees_test.d.ts +93 -0
  155. package/dest/single-node/fees/fees_test.d.ts.map +1 -0
  156. package/dest/{e2e_fees → single-node/fees}/fees_test.js +89 -63
  157. package/dest/single-node/l1-reorgs/setup.d.ts +42 -0
  158. package/dest/single-node/l1-reorgs/setup.d.ts.map +1 -0
  159. package/dest/single-node/l1-reorgs/setup.js +57 -0
  160. package/dest/single-node/partial-proofs/setup.d.ts +5 -0
  161. package/dest/single-node/partial-proofs/setup.d.ts.map +1 -0
  162. package/dest/single-node/partial-proofs/setup.js +5 -0
  163. package/dest/single-node/proving/setup.d.ts +5 -0
  164. package/dest/single-node/proving/setup.d.ts.map +1 -0
  165. package/dest/single-node/proving/setup.js +5 -0
  166. package/dest/single-node/recovery/setup.d.ts +5 -0
  167. package/dest/single-node/recovery/setup.d.ts.map +1 -0
  168. package/dest/single-node/recovery/setup.js +5 -0
  169. package/dest/single-node/setup.d.ts +49 -0
  170. package/dest/single-node/setup.d.ts.map +1 -0
  171. package/dest/single-node/setup.js +56 -0
  172. package/dest/single-node/single_node_test_context.d.ts +360 -0
  173. package/dest/single-node/single_node_test_context.d.ts.map +1 -0
  174. package/dest/single-node/single_node_test_context.js +833 -0
  175. package/dest/spartan/setup_test_wallets.d.ts +11 -2
  176. package/dest/spartan/setup_test_wallets.d.ts.map +1 -1
  177. package/dest/spartan/setup_test_wallets.js +121 -46
  178. package/dest/spartan/tx_metrics.d.ts +27 -4
  179. package/dest/spartan/tx_metrics.d.ts.map +1 -1
  180. package/dest/spartan/tx_metrics.js +106 -21
  181. package/dest/spartan/utils/bot.d.ts +3 -2
  182. package/dest/spartan/utils/bot.d.ts.map +1 -1
  183. package/dest/spartan/utils/bot.js +2 -1
  184. package/dest/spartan/utils/config.d.ts +10 -30
  185. package/dest/spartan/utils/config.d.ts.map +1 -1
  186. package/dest/spartan/utils/config.js +3 -1
  187. package/dest/spartan/utils/index.d.ts +4 -2
  188. package/dest/spartan/utils/index.d.ts.map +1 -1
  189. package/dest/spartan/utils/index.js +5 -1
  190. package/dest/spartan/utils/k8s.d.ts +3 -1
  191. package/dest/spartan/utils/k8s.d.ts.map +1 -1
  192. package/dest/spartan/utils/k8s.js +6 -0
  193. package/dest/spartan/utils/nodes.d.ts +4 -5
  194. package/dest/spartan/utils/nodes.d.ts.map +1 -1
  195. package/dest/spartan/utils/nodes.js +11 -11
  196. package/dest/spartan/utils/pod_logs.d.ts +25 -0
  197. package/dest/spartan/utils/pod_logs.d.ts.map +1 -0
  198. package/dest/spartan/utils/pod_logs.js +74 -0
  199. package/dest/test-wallet/test_wallet.d.ts +48 -25
  200. package/dest/test-wallet/test_wallet.d.ts.map +1 -1
  201. package/dest/test-wallet/test_wallet.js +197 -91
  202. package/dest/test-wallet/utils.d.ts +38 -3
  203. package/dest/test-wallet/utils.d.ts.map +1 -1
  204. package/dest/test-wallet/utils.js +65 -10
  205. package/dest/test-wallet/wallet_worker_script.d.ts +2 -0
  206. package/dest/test-wallet/wallet_worker_script.d.ts.map +1 -0
  207. package/dest/test-wallet/wallet_worker_script.js +56 -0
  208. package/dest/test-wallet/worker_wallet.d.ts +53 -0
  209. package/dest/test-wallet/worker_wallet.d.ts.map +1 -0
  210. package/dest/test-wallet/worker_wallet.js +157 -0
  211. package/dest/test-wallet/worker_wallet_schema.d.ts +4 -0
  212. package/dest/test-wallet/worker_wallet_schema.d.ts.map +1 -0
  213. package/dest/test-wallet/worker_wallet_schema.js +23 -0
  214. package/package.json +50 -47
  215. package/src/automine/README.md +60 -0
  216. package/src/automine/automine_test_context.ts +153 -0
  217. package/src/automine/delivery/interactive_handshake_responder.ts +125 -0
  218. package/src/automine/delivery/onchain_delivery_harness.ts +213 -0
  219. package/src/{e2e_blacklist_token_contract → automine/token}/blacklist_token_contract_test.ts +44 -63
  220. package/src/{e2e_token_contract → automine/token}/token_contract_test.ts +43 -58
  221. package/src/automine/token/token_test_helpers.ts +138 -0
  222. package/src/bench/client_flows/benchmark.ts +21 -0
  223. package/src/bench/client_flows/client_flows_benchmark.ts +102 -64
  224. package/src/bench/client_flows/data_extractor.ts +1 -0
  225. package/src/bench/utils.ts +116 -7
  226. package/src/composed/ha/ha_full_setup.ts +466 -0
  227. package/src/fixtures/authwit_proxy.ts +54 -0
  228. package/src/fixtures/dumps/epoch_proof_result.json +1 -1
  229. package/src/fixtures/e2e_prover_test.ts +97 -93
  230. package/src/fixtures/elu_monitor.ts +126 -0
  231. package/src/fixtures/fixtures.ts +110 -0
  232. package/src/fixtures/get_bb_config.ts +7 -6
  233. package/src/fixtures/ha_setup.ts +14 -6
  234. package/src/fixtures/index.ts +1 -0
  235. package/src/fixtures/schnorr_hardcoded_account_contract.ts +49 -0
  236. package/src/fixtures/setup.ts +406 -351
  237. package/src/fixtures/setup_p2p_test.ts +23 -27
  238. package/src/fixtures/timing.ts +97 -0
  239. package/src/fixtures/token_utils.ts +42 -7
  240. package/src/fixtures/utils.ts +2 -3
  241. package/src/fixtures/wait_helpers.ts +333 -0
  242. package/src/forward-compatibility/wallet_rpc_client.ts +14 -0
  243. package/src/forward-compatibility/wallet_service.ts +106 -0
  244. package/src/guides/up_quick_start.sh +5 -2
  245. package/src/infra/README.md +12 -0
  246. package/src/install_legacy_contracts.cjs +75 -0
  247. package/src/legacy-jest-resolver.cjs +112 -0
  248. package/src/multi-node/README.md +95 -0
  249. package/src/multi-node/block-production/setup.ts +272 -0
  250. package/src/multi-node/governance/setup.ts +172 -0
  251. package/src/multi-node/multi_node_test_context.ts +447 -0
  252. package/src/multi-node/slashing/inactivity_setup.ts +139 -0
  253. package/src/multi-node/slashing/setup.ts +433 -0
  254. package/src/p2p/README.md +78 -0
  255. package/src/{e2e_p2p → p2p}/p2p_network.ts +116 -47
  256. package/src/{e2e_p2p → p2p}/reqresp/utils.ts +82 -26
  257. package/src/p2p/shared.ts +329 -0
  258. package/src/shared/cross_chain_test_harness.ts +42 -17
  259. package/src/shared/gas_portal_test_harness.ts +33 -15
  260. package/src/shared/index.ts +1 -0
  261. package/src/shared/jest_setup.ts +51 -1
  262. package/src/shared/mock_state_view.ts +188 -0
  263. package/src/shared/submit-transactions.ts +13 -5
  264. package/src/shared/timing_env.d.mts +39 -0
  265. package/src/shared/timing_env.mjs +363 -0
  266. package/src/shared/uniswap_l1_l2.ts +98 -54
  267. package/src/shared/wait_for_l1_to_l2_message.ts +23 -0
  268. package/src/simulators/lending_simulator.ts +33 -15
  269. package/src/simulators/token_simulator.ts +6 -2
  270. package/src/single-node/README.md +60 -0
  271. package/src/single-node/cross-chain/cross_chain_messaging_test.ts +302 -0
  272. package/src/single-node/cross-chain/message_test_helpers.ts +125 -0
  273. package/src/{e2e_fees → single-node/fees}/bridging_race.notest.ts +19 -5
  274. package/src/{e2e_fees → single-node/fees}/fees_test.ts +114 -70
  275. package/src/single-node/l1-reorgs/setup.ts +93 -0
  276. package/src/single-node/partial-proofs/setup.ts +8 -0
  277. package/src/single-node/proving/setup.ts +15 -0
  278. package/src/single-node/recovery/setup.ts +8 -0
  279. package/src/single-node/setup.ts +63 -0
  280. package/src/single-node/single_node_test_context.ts +1041 -0
  281. package/src/spartan/setup_test_wallets.ts +165 -41
  282. package/src/spartan/tx_metrics.ts +108 -24
  283. package/src/spartan/utils/bot.ts +4 -1
  284. package/src/spartan/utils/config.ts +2 -0
  285. package/src/spartan/utils/index.ts +7 -0
  286. package/src/spartan/utils/k8s.ts +8 -0
  287. package/src/spartan/utils/nodes.ts +17 -12
  288. package/src/spartan/utils/pod_logs.ts +99 -0
  289. package/src/test-wallet/test_wallet.ts +228 -107
  290. package/src/test-wallet/utils.ts +104 -11
  291. package/src/test-wallet/wallet_worker_script.ts +66 -0
  292. package/src/test-wallet/worker_wallet.ts +216 -0
  293. package/src/test-wallet/worker_wallet_schema.ts +14 -0
  294. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts +0 -55
  295. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts.map +0 -1
  296. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts +0 -47
  297. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts.map +0 -1
  298. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.js +0 -129
  299. package/dest/e2e_deploy_contract/deploy_test.d.ts +0 -37
  300. package/dest/e2e_deploy_contract/deploy_test.d.ts.map +0 -1
  301. package/dest/e2e_deploy_contract/deploy_test.js +0 -50
  302. package/dest/e2e_epochs/epochs_test.d.ts +0 -100
  303. package/dest/e2e_epochs/epochs_test.d.ts.map +0 -1
  304. package/dest/e2e_epochs/epochs_test.js +0 -367
  305. package/dest/e2e_fees/bridging_race.notest.d.ts.map +0 -1
  306. package/dest/e2e_fees/fees_test.d.ts +0 -88
  307. package/dest/e2e_fees/fees_test.d.ts.map +0 -1
  308. package/dest/e2e_l1_publisher/write_json.d.ts +0 -11
  309. package/dest/e2e_l1_publisher/write_json.d.ts.map +0 -1
  310. package/dest/e2e_l1_publisher/write_json.js +0 -56
  311. package/dest/e2e_multi_validator/utils.d.ts +0 -12
  312. package/dest/e2e_multi_validator/utils.d.ts.map +0 -1
  313. package/dest/e2e_nested_contract/nested_contract_test.d.ts +0 -26
  314. package/dest/e2e_nested_contract/nested_contract_test.d.ts.map +0 -1
  315. package/dest/e2e_nested_contract/nested_contract_test.js +0 -56
  316. package/dest/e2e_p2p/inactivity_slash_test.d.ts +0 -31
  317. package/dest/e2e_p2p/inactivity_slash_test.d.ts.map +0 -1
  318. package/dest/e2e_p2p/inactivity_slash_test.js +0 -136
  319. package/dest/e2e_p2p/p2p_network.d.ts.map +0 -1
  320. package/dest/e2e_p2p/reqresp/utils.d.ts +0 -22
  321. package/dest/e2e_p2p/reqresp/utils.d.ts.map +0 -1
  322. package/dest/e2e_p2p/shared.d.ts +0 -46
  323. package/dest/e2e_p2p/shared.d.ts.map +0 -1
  324. package/dest/e2e_p2p/shared.js +0 -181
  325. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts +0 -2
  326. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts.map +0 -1
  327. package/dest/e2e_storage_proof/fixtures/storage_proof_fixture.d.ts.map +0 -1
  328. package/dest/e2e_token_contract/token_contract_test.d.ts +0 -44
  329. package/dest/e2e_token_contract/token_contract_test.d.ts.map +0 -1
  330. package/src/e2e_cross_chain_messaging/cross_chain_messaging_test.ts +0 -193
  331. package/src/e2e_deploy_contract/deploy_test.ts +0 -85
  332. package/src/e2e_epochs/epochs_test.ts +0 -487
  333. package/src/e2e_l1_publisher/write_json.ts +0 -77
  334. package/src/e2e_nested_contract/nested_contract_test.ts +0 -73
  335. package/src/e2e_p2p/inactivity_slash_test.ts +0 -179
  336. package/src/e2e_p2p/shared.ts +0 -290
  337. /package/dest/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fetcher.js +0 -0
  338. /package/dest/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fixture.js +0 -0
  339. /package/dest/{e2e_multi_validator/utils.js → composed/web3signer/multi_validator_keystore_utils.js} +0 -0
  340. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof.json +0 -0
  341. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fetcher.ts +0 -0
  342. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fixture.ts +0 -0
  343. /package/src/{e2e_multi_validator/utils.ts → composed/web3signer/multi_validator_keystore_utils.ts} +0 -0
@@ -1,14 +1,10 @@
1
- import { SchnorrAccountContractArtifact } from '@aztec/accounts/schnorr';
2
1
  import { generateSchnorrAccounts } from '@aztec/accounts/testing';
3
- import { createArchiver } from '@aztec/archiver';
4
- import { AztecNodeService, getConfigEnvVars } from '@aztec/aztec-node';
5
- import { AztecAddress, EthAddress } from '@aztec/aztec.js/addresses';
6
- import { BatchCall, getContractClassFromArtifact, waitForProven } from '@aztec/aztec.js/contracts';
2
+ import { createAztecNodeService, getConfigEnvVars } from '@aztec/aztec-node';
3
+ import { EthAddress } from '@aztec/aztec.js/addresses';
7
4
  import { publishContractClass, publishInstance } from '@aztec/aztec.js/deployment';
8
5
  import { Fr } from '@aztec/aztec.js/fields';
9
6
  import { createLogger } from '@aztec/aztec.js/log';
10
- import { AnvilTestWatcher, CheatCodes } from '@aztec/aztec/testing';
11
- import { createBlobClientWithFileStores } from '@aztec/blob-client/client';
7
+ import { CheatCodes } from '@aztec/aztec/testing';
12
8
  import { SPONSORED_FPC_SALT } from '@aztec/constants';
13
9
  import { isAnvilTestChain } from '@aztec/ethereum/chain';
14
10
  import { createExtendedL1Client } from '@aztec/ethereum/client';
@@ -16,26 +12,28 @@ import { getL1ContractsConfigEnvVars } from '@aztec/ethereum/config';
16
12
  import { NULL_KEY } from '@aztec/ethereum/constants';
17
13
  import { deployMulticall3 } from '@aztec/ethereum/contracts';
18
14
  import { deployAztecL1Contracts } from '@aztec/ethereum/deploy-aztec-l1-contracts';
19
- import { DelayedTxUtils, EthCheatCodesWithState, createDelayedL1TxUtilsFromViemWallet, startAnvil } from '@aztec/ethereum/test';
15
+ import { EthCheatCodesWithState, startAnvil, warmBlobKzg } from '@aztec/ethereum/test';
20
16
  import { EpochNumber } from '@aztec/foundation/branded-types';
21
17
  import { SecretValue } from '@aztec/foundation/config';
22
18
  import { randomBytes } from '@aztec/foundation/crypto/random';
23
19
  import { tryRmDir } from '@aztec/foundation/fs';
24
20
  import { withLoggerBindings } from '@aztec/foundation/log/server';
25
21
  import { retryUntil } from '@aztec/foundation/retry';
26
- import { sleep } from '@aztec/foundation/sleep';
27
22
  import { TestDateProvider } from '@aztec/foundation/timer';
28
23
  import { SponsoredFPCContract } from '@aztec/noir-contracts.js/SponsoredFPC';
29
24
  import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
30
25
  import { MockGossipSubNetwork, getMockPubSubP2PServiceFactory } from '@aztec/p2p/test-helpers';
31
26
  import { protocolContractsHash } from '@aztec/protocol-contracts';
32
- import { createProverNode } from '@aztec/prover-node';
33
27
  import { getPXEConfig } from '@aztec/pxe/server';
28
+ import { AuthRegistryArtifact, getStandardAuthRegistry } from '@aztec/standard-contracts/auth-registry';
29
+ import { HandshakeRegistryArtifact, getStandardHandshakeRegistry } from '@aztec/standard-contracts/handshake-registry';
30
+ import { PublicChecksArtifact, getStandardPublicChecks } from '@aztec/standard-contracts/public-checks';
31
+ import { ARTIFACT_VERSION_BEFORE_INJECTION } from '@aztec/stdlib/abi';
34
32
  import { getContractInstanceFromInstantiationParams } from '@aztec/stdlib/contract';
35
33
  import { tryStop } from '@aztec/stdlib/interfaces/server';
36
34
  import { getConfigEnvVars as getTelemetryConfig, initTelemetryClient } from '@aztec/telemetry-client';
37
35
  import { BenchmarkTelemetryClient } from '@aztec/telemetry-client/bench';
38
- import { deployFundedSchnorrAccounts } from '@aztec/wallets/testing';
36
+ import { createFundedInitializerlessAccounts } from '@aztec/wallets/testing';
39
37
  import { getGenesisValues } from '@aztec/world-state/testing';
40
38
  import fs from 'fs/promises';
41
39
  import { tmpdir } from 'os';
@@ -47,6 +45,7 @@ import { MNEMONIC, TEST_MAX_PENDING_TX_POOL_COUNT, TEST_PEER_CHECK_INTERVAL_MS }
47
45
  import { getACVMConfig } from './get_acvm_config.js';
48
46
  import { getBBConfig } from './get_bb_config.js';
49
47
  import { isMetricsLoggingRequested, setupMetricsLogger } from './logging.js';
48
+ import { testSpan } from './timing.js';
50
49
  import { getEndToEndTestTelemetryClient } from './with_telemetry_utils.js';
51
50
  export { startAnvil };
52
51
  let telemetry = undefined;
@@ -82,11 +81,13 @@ export const getPrivateKeyFromIndex = (index)=>{
82
81
  /**
83
82
  * Sets up Private eXecution Environment (PXE) and returns the corresponding test wallet.
84
83
  * @param aztecNode - An instance of Aztec Node.
84
+ * @param nodeDebug - The node's debug API, used to register public function signatures for named traces; pass
85
+ * `undefined` when the node does not expose it.
85
86
  * @param opts - Partial configuration for the PXE.
86
87
  * @param logger - The logger to be used.
87
88
  * @param actor - Actor label to include in log output (e.g., 'pxe-test').
88
89
  * @returns A test wallet, logger and teardown function.
89
- */ export async function setupPXEAndGetWallet(aztecNode, opts = {}, logger = getLogger(), actor) {
90
+ */ export async function setupPXEAndGetWallet(aztecNode, nodeDebug, opts = {}, logger = getLogger(), actor) {
90
91
  const PXEConfig = {
91
92
  ...getPXEConfig(),
92
93
  ...opts
@@ -100,7 +101,8 @@ export const getPrivateKeyFromIndex = (index)=>{
100
101
  }
101
102
  const teardown = configuredDataDirectory ? ()=>Promise.resolve() : ()=>tryRmDir(PXEConfig.dataDirectory);
102
103
  const wallet = await TestWallet.create(aztecNode, PXEConfig, {
103
- loggerActorLabel: actor
104
+ loggerActorLabel: actor,
105
+ nodeDebug
104
106
  });
105
107
  return {
106
108
  wallet,
@@ -108,16 +110,56 @@ export const getPrivateKeyFromIndex = (index)=>{
108
110
  teardown
109
111
  };
110
112
  }
113
+ /**
114
+ * When CONTRACT_ARTIFACTS_VERSION is set (backwards compatibility testing), asserts that the loaded artifact's
115
+ * aztecVersion matches the expected version. This is a sanity check verifying that the legacy artifact resolver
116
+ * actually swapped in the correct version.
117
+ */ function assertContractArtifactsVersion() {
118
+ const expected = process.env.CONTRACT_ARTIFACTS_VERSION;
119
+ if (!expected) {
120
+ return;
121
+ }
122
+ const { aztecVersion } = SponsoredFPCContract.artifact;
123
+ // TODO(F-557): Remove this bypass once pre-version artifacts are no longer tested.
124
+ if (aztecVersion === ARTIFACT_VERSION_BEFORE_INJECTION) {
125
+ createLogger('e2e:setup').info(`Skipping artifact version check: artifact predates version injection (CONTRACT_ARTIFACTS_VERSION=${expected})`);
126
+ return;
127
+ }
128
+ if (aztecVersion !== expected) {
129
+ throw new Error(`Artifact version mismatch: expected ${expected} but got ${aztecVersion}. ` + `The legacy artifact resolver may not have swapped in the correct version.`);
130
+ }
131
+ }
111
132
  /**
112
133
  * Sets up the environment for the end-to-end tests.
113
134
  * @param numberOfAccounts - The number of new accounts to be created once the PXE is initiated.
114
135
  * @param opts - Options to pass to the node initialization and to the setup script.
115
136
  * @param pxeOpts - Options to pass to the PXE initialization.
116
- */ export async function setup(numberOfAccounts = 1, opts = {}, pxeOpts = {}, chain = foundry) {
137
+ */ export function setup(numberOfAccounts = 1, opts = {}, pxeOpts = {}, chain = foundry) {
138
+ // Tag the top-level env spin-up with the prover mode (none → fake → real), the largest config-driven
139
+ // swing in setup cost, so the three factories are comparable on the span leaderboard. The internals
140
+ // (anvil / l1-deploy / sequencer-start / pxe / wallet:create) decompose this further.
141
+ const proverMode = opts.realProofs ? 'real' : opts.startProverNode ? 'fake' : 'none';
142
+ return testSpan(`setup:env:${proverMode}`, async ()=>{
143
+ const ctx = await setupInner(numberOfAccounts, opts, pxeOpts, chain);
144
+ if (process.env.EXIT_E2E_AFTER_SETUP) {
145
+ ctx.logger.info('EXIT_E2E_AFTER_SETUP is set; aborting before the test body runs');
146
+ throw new Error('EXIT_E2E_AFTER_SETUP');
147
+ }
148
+ return ctx;
149
+ });
150
+ }
151
+ async function setupInner(numberOfAccounts, opts, pxeOpts, chain) {
152
+ assertContractArtifactsVersion();
153
+ const logger = getLogger();
117
154
  let anvil;
118
155
  try {
119
156
  opts.aztecTargetCommitteeSize ??= 0;
120
- opts.slasherFlavor ??= 'none';
157
+ opts.slasherEnabled ??= false;
158
+ // Mine the L1 setup txs (Multicall3 + rollup contract deployment) immediately instead of
159
+ // waiting on anvil's block interval — this is the dominant cost of e2e setup. Suites that
160
+ // assert on genesis-relative L1 timing can opt out by passing `automineL1Setup: false`.
161
+ opts.automineL1Setup ??= true;
162
+ logger.trace('Starting e2e test setup');
121
163
  const config = {
122
164
  ...getConfigEnvVars(),
123
165
  ...opts
@@ -128,10 +170,10 @@ export const getPrivateKeyFromIndex = (index)=>{
128
170
  config.maxPendingTxCount = opts.maxPendingTxCount ?? TEST_MAX_PENDING_TX_POOL_COUNT;
129
171
  // For tests we only want proving enabled if specifically requested
130
172
  config.realProofs = !!opts.realProofs;
131
- // Only enforce the time table if requested
132
- config.enforceTimeTable = !!opts.enforceTimeTable;
173
+ // Enable the tx delayer for tests (default config has it disabled, so we force-enable it here)
174
+ config.enableDelayer = true;
133
175
  config.listenAddress = '127.0.0.1';
134
- const logger = getLogger();
176
+ config.minTxPoolAgeMs = opts.minTxPoolAgeMs ?? 0;
135
177
  // Create a temp directory for any services that need it and cleanup later
136
178
  const directoryToCleanup = path.join(tmpdir(), randomBytes(8).toString('hex'));
137
179
  await fs.mkdir(directoryToCleanup, {
@@ -140,27 +182,30 @@ export const getPrivateKeyFromIndex = (index)=>{
140
182
  if (!config.dataDirectory) {
141
183
  config.dataDirectory = directoryToCleanup;
142
184
  }
185
+ const dateProvider = new TestDateProvider();
143
186
  if (!config.l1RpcUrls?.length) {
144
187
  if (!isAnvilTestChain(chain.id)) {
145
188
  throw new Error(`No ETHEREUM_HOSTS set but non anvil chain requested`);
146
189
  }
147
- const res = await startAnvil({
148
- l1BlockTime: opts.ethereumSlotDuration,
149
- accounts: opts.anvilAccounts,
150
- port: opts.anvilPort ?? (process.env.ANVIL_PORT ? parseInt(process.env.ANVIL_PORT) : undefined)
151
- });
190
+ const res = await testSpan('setup:env:anvil', ()=>startAnvil({
191
+ l1BlockTime: opts.ethereumSlotDuration,
192
+ accounts: opts.anvilAccounts,
193
+ port: opts.anvilPort ?? (process.env.ANVIL_PORT ? parseInt(process.env.ANVIL_PORT) : undefined),
194
+ slotsInAnEpoch: opts.anvilSlotsInAnEpoch,
195
+ dateProvider
196
+ }));
152
197
  anvil = res.anvil;
153
198
  config.l1RpcUrls = [
154
199
  res.rpcUrl
155
200
  ];
156
201
  }
202
+ logger.trace('Started anvil and L1 RPC client');
157
203
  // Enable logging metrics to a local file named after the test suite
158
204
  if (isMetricsLoggingRequested()) {
159
205
  const filename = path.join('log', getJobName() + '.jsonl');
160
206
  logger.info(`Logging metrics to ${filename}`);
161
207
  setupMetricsLogger(filename);
162
208
  }
163
- const dateProvider = new TestDateProvider();
164
209
  const ethCheatCodes = new EthCheatCodesWithState(config.l1RpcUrls, dateProvider);
165
210
  if (opts.stateLoad) {
166
211
  await ethCheatCodes.loadChainState(opts.stateLoad);
@@ -170,13 +215,14 @@ export const getPrivateKeyFromIndex = (index)=>{
170
215
  resetBlockInterval: true
171
216
  });
172
217
  }
218
+ logger.trace('Initialized L1 cheat codes and applied state/time overrides');
173
219
  let publisherPrivKeyHex = undefined;
174
220
  let publisherHdAccount = undefined;
175
221
  if (opts.l1PublisherKey && opts.l1PublisherKey.getValue() && opts.l1PublisherKey.getValue() != NULL_KEY) {
176
222
  publisherPrivKeyHex = opts.l1PublisherKey.getValue();
177
223
  publisherHdAccount = privateKeyToAccount(publisherPrivKeyHex);
178
- } else if (config.publisherPrivateKeys && config.publisherPrivateKeys.length > 0 && config.publisherPrivateKeys[0].getValue() != NULL_KEY) {
179
- publisherPrivKeyHex = config.publisherPrivateKeys[0].getValue();
224
+ } else if (config.sequencerPublisherPrivateKeys && config.sequencerPublisherPrivateKeys.length > 0 && config.sequencerPublisherPrivateKeys[0].getValue() != NULL_KEY) {
225
+ publisherPrivKeyHex = config.sequencerPublisherPrivateKeys[0].getValue();
180
226
  publisherHdAccount = privateKeyToAccount(publisherPrivKeyHex);
181
227
  } else if (!MNEMONIC) {
182
228
  throw new Error(`Mnemonic not provided and no publisher private key`);
@@ -187,28 +233,42 @@ export const getPrivateKeyFromIndex = (index)=>{
187
233
  const publisherPrivKeyRaw = publisherHdAccount.getHdKey().privateKey;
188
234
  const publisherPrivKey = publisherPrivKeyRaw === null ? null : Buffer.from(publisherPrivKeyRaw);
189
235
  publisherPrivKeyHex = `0x${publisherPrivKey.toString('hex')}`;
190
- config.publisherPrivateKeys = [
236
+ config.sequencerPublisherPrivateKeys = [
191
237
  new SecretValue(publisherPrivKeyHex)
192
238
  ];
193
239
  }
194
240
  if (config.coinbase === undefined) {
195
241
  config.coinbase = EthAddress.fromString(publisherHdAccount.address);
196
242
  }
197
- // Determine which addresses to fund in genesis
198
- const initialFundedAccounts = opts.initialFundedAccounts ?? await generateSchnorrAccounts(opts.numberOfInitialFundedAccounts ?? Math.max(numberOfAccounts, 10));
199
- const addressesToFund = initialFundedAccounts.map((a)=>a.address);
243
+ logger.trace('Resolved L1 publisher account');
244
+ // The accounts setup creates itself: `numberOfAccounts` initializerless accounts, generated here and
245
+ // funded at genesis so they are immediately usable.
246
+ const defaultAccounts = await generateSchnorrAccounts(numberOfAccounts);
247
+ // Extra accounts the test wants funded at genesis but will create/deploy itself.
248
+ const additionallyFundedAccounts = opts.additionallyFundedAccounts ?? [];
249
+ const addressesToFund = [
250
+ ...defaultAccounts,
251
+ ...additionallyFundedAccounts
252
+ ].map((a)=>a.address);
200
253
  // Optionally fund the sponsored FPC
201
254
  if (opts.fundSponsoredFPC) {
202
255
  const sponsoredFPCAddress = await getSponsoredFPCAddress();
203
256
  addressesToFund.push(sponsoredFPCAddress);
204
257
  }
205
- const { genesisArchiveRoot, prefilledPublicData, fundingNeeded } = await getGenesisValues(addressesToFund, opts.initialAccountFeeJuice, opts.genesisPublicData);
258
+ logger.trace('Generated test accounts to fund at genesis');
259
+ const genesisTimestamp = BigInt(Math.floor(Date.now() / 1000));
260
+ const { genesisArchiveRoot, genesis, fundingNeeded } = await getGenesisValues(addressesToFund, opts.initialAccountFeeJuice, opts.genesisPublicData, genesisTimestamp);
261
+ logger.trace('Computed genesis values');
206
262
  const wasAutomining = await ethCheatCodes.isAutoMining();
207
263
  const enableAutomine = opts.automineL1Setup && !wasAutomining && isAnvilTestChain(chain.id);
208
264
  if (enableAutomine) {
209
265
  await ethCheatCodes.setAutomine(true);
210
266
  }
211
267
  const l1Client = createExtendedL1Client(config.l1RpcUrls, publisherHdAccount, chain);
268
+ // Warm both KZG trusted setups (ours + anvil's) in parallel
269
+ if (anvil && isAnvilTestChain(chain.id)) {
270
+ await warmBlobKzg(l1Client, logger);
271
+ }
212
272
  // Deploy Multicall3 if running locally
213
273
  await deployMulticall3(l1Client, logger);
214
274
  // Force viem to refresh its nonce cache to avoid "nonce too low" errors in subsequent transactions
@@ -216,68 +276,99 @@ export const getPrivateKeyFromIndex = (index)=>{
216
276
  await l1Client.getTransactionCount({
217
277
  address: l1Client.account.address
218
278
  });
219
- const deployL1ContractsValues = await deployAztecL1Contracts(config.l1RpcUrls[0], publisherPrivKeyHex, chain.id, {
220
- ...getL1ContractsConfigEnvVars(),
221
- ...opts,
222
- ...opts.l1ContractsArgs,
223
- vkTreeRoot: getVKTreeRoot(),
224
- protocolContractsHash,
225
- genesisArchiveRoot,
226
- initialValidators: opts.initialValidators,
227
- feeJuicePortalInitialBalance: fundingNeeded,
228
- realVerifier: false
229
- });
230
- config.l1Contracts = deployL1ContractsValues.l1ContractAddresses;
279
+ logger.trace('Deployed Multicall3');
280
+ const deployL1ContractsValues = await testSpan('setup:env:l1-deploy', ()=>deployAztecL1Contracts(config.l1RpcUrls[0], publisherPrivKeyHex, chain.id, {
281
+ ...getL1ContractsConfigEnvVars(),
282
+ ...opts,
283
+ ...opts.l1ContractsArgs,
284
+ vkTreeRoot: getVKTreeRoot(),
285
+ protocolContractsHash,
286
+ genesisArchiveRoot,
287
+ initialValidators: opts.initialValidators,
288
+ feeJuicePortalInitialBalance: fundingNeeded,
289
+ realVerifier: false
290
+ }));
291
+ Object.assign(config, deployL1ContractsValues.l1ContractAddresses);
231
292
  config.rollupVersion = deployL1ContractsValues.rollupVersion;
293
+ // Propagate L1-contracts-config overrides back to the node config so the archiver's
294
+ // `l1Constants` (and any other node-side consumer) agrees with what was actually deployed.
295
+ // Without this, a per-test override like `aztecEpochDuration: 4` lands on the rollup contract
296
+ // but the node config keeps the default (32), so `archiver.isEpochComplete(0)` computes
297
+ // `endSlot=31` and `EpochTestSettler`/`EpochMonitor` never fires — letting the
298
+ // `aztecProofSubmissionEpochs` window expire mid-test and prune the pending chain.
299
+ // Skip undefined values: callers (e.g. `P2PNetworkTest`) sometimes build `l1ContractsArgs`
300
+ // by spreading a partial `AztecNodeConfig`, which leaves unset fields (notably `dataDirectory`)
301
+ // as `undefined`. A blind Object.assign would then clobber the temp `dataDirectory` set earlier
302
+ // in this function and crash `setupSharedBlobStorage`.
303
+ if (opts.l1ContractsArgs) {
304
+ for (const [key, value] of Object.entries(opts.l1ContractsArgs)){
305
+ if (value !== undefined) {
306
+ config[key] = value;
307
+ }
308
+ }
309
+ }
310
+ // Deploy any test-specific L1 contracts while automine is still on and before the node starts,
311
+ // so they mine instantly rather than paying the L1 block interval once the sequencer is live.
312
+ let extraL1DeployResult = undefined;
313
+ if (opts.deployExtraL1Contracts) {
314
+ logger.trace('Running deployExtraL1Contracts hook');
315
+ extraL1DeployResult = await opts.deployExtraL1Contracts({
316
+ l1Client,
317
+ deployL1ContractsValues,
318
+ logger
319
+ });
320
+ // The hook reused `l1Client` to send deploy txs, so refresh viem's nonce cache to avoid a
321
+ // stale cached nonce for later transactions on the publisher account.
322
+ await l1Client.getTransactionCount({
323
+ address: l1Client.account.address
324
+ });
325
+ }
232
326
  if (enableAutomine) {
233
- await ethCheatCodes.setAutomine(false);
234
- await ethCheatCodes.setIntervalMining(config.ethereumSlotDuration);
235
- dateProvider.setTime(await ethCheatCodes.timestamp() * 1000);
327
+ await ethCheatCodes.startIntervalMiningWithFreshBlock(config.ethereumSlotDuration);
328
+ }
329
+ // In compose mode (no local anvil), sync dateProvider to L1 time since it may have drifted
330
+ // ahead of system time. When running with a local anvil, the dateProvider is kept in sync via
331
+ // the stdout listener.
332
+ if (!anvil) {
333
+ dateProvider.setTime(await ethCheatCodes.lastBlockTimestamp() * 1000);
236
334
  }
237
335
  if (opts.l2StartTime) {
238
336
  await ethCheatCodes.warp(opts.l2StartTime, {
239
337
  resetBlockInterval: true
240
338
  });
241
339
  }
242
- const watcher = new AnvilTestWatcher(new EthCheatCodesWithState(config.l1RpcUrls, dateProvider), deployL1ContractsValues.l1ContractAddresses.rollupAddress, deployL1ContractsValues.l1Client, dateProvider);
243
- if (!opts.disableAnvilTestWatcher) {
244
- await watcher.start();
245
- }
246
- // Use metricsPort-based telemetry if provided, otherwise use the regular telemetry client
247
- const telemetryClient = opts.metricsPort ? await getEndToEndTestTelemetryClient(opts.metricsPort) : await getTelemetryClient(opts.telemetryConfig);
248
- await setupSharedBlobStorage(config);
249
- logger.verbose('Creating and synching an aztec node', config);
250
- const acvmConfig = await getACVMConfig(logger);
340
+ logger.trace('Deployed L1 rollup contracts');
341
+ // These boot steps are independent and write disjoint config keys, so run them concurrently:
342
+ // telemetry returns a client (no config write), shared blob storage writes blobFileStore* keys,
343
+ // and the ACVM/BB config resolvers write their own acvm*/bb* keys.
344
+ const [telemetryClient, , acvmConfig, bbConfig] = await Promise.all([
345
+ // Use metricsPort-based telemetry if provided, otherwise use the regular telemetry client
346
+ opts.metricsPort ? getEndToEndTestTelemetryClient(opts.metricsPort) : getTelemetryClient(opts.telemetryConfig),
347
+ setupSharedBlobStorage(config),
348
+ getACVMConfig(logger),
349
+ getBBConfig(logger)
350
+ ]);
351
+ logger.trace('Created telemetry client');
352
+ logger.trace('Set up shared blob storage');
251
353
  if (acvmConfig) {
252
354
  config.acvmWorkingDirectory = acvmConfig.acvmWorkingDirectory;
253
355
  config.acvmBinaryPath = acvmConfig.acvmBinaryPath;
254
356
  }
255
- const bbConfig = await getBBConfig(logger);
357
+ logger.trace('Resolved ACVM config');
256
358
  if (bbConfig) {
257
359
  config.bbBinaryPath = bbConfig.bbBinaryPath;
258
360
  config.bbWorkingDirectory = bbConfig.bbWorkingDirectory;
259
361
  }
362
+ logger.trace('Resolved Barretenberg config');
363
+ logger.verbose('Creating and synching an aztec node', config);
260
364
  let mockGossipSubNetwork;
261
365
  let p2pClientDeps = undefined;
262
366
  if (opts.mockGossipSubNetwork) {
263
- mockGossipSubNetwork = new MockGossipSubNetwork();
367
+ mockGossipSubNetwork = new MockGossipSubNetwork(opts.mockGossipSubNetworkLatency);
264
368
  p2pClientDeps = {
265
369
  p2pServiceFactory: getMockPubSubP2PServiceFactory(mockGossipSubNetwork)
266
370
  };
267
371
  }
268
- // Transactions built against the genesis state must be included in block 1, otherwise they are dropped.
269
- // To avoid test failures from dropped transactions, we ensure progression beyond genesis before proceeding.
270
- // For account deployments, we set minTxsPerBlock=1 and deploy accounts sequentially for guaranteed success.
271
- // If no accounts need deployment, we await an empty block to confirm network progression.
272
- const originalMinTxsPerBlock = config.minTxsPerBlock;
273
- if (originalMinTxsPerBlock === undefined) {
274
- throw new Error('minTxsPerBlock is undefined in e2e test setup');
275
- }
276
- // Only set minTxsPerBlock=1 if we're going to deploy accounts and need reliable block inclusion
277
- const shouldDeployAccounts = numberOfAccounts > 0 && !opts.skipAccountDeployment;
278
- // Only set minTxsPerBlock=0 if we need an empty block (no accounts at all, not skipped deployment)
279
- const needsEmptyBlock = numberOfAccounts === 0 && !opts.skipAccountDeployment;
280
- config.minTxsPerBlock = shouldDeployAccounts ? 1 : needsEmptyBlock ? 0 : originalMinTxsPerBlock;
281
372
  config.p2pEnabled = opts.mockGossipSubNetwork || config.p2pEnabled;
282
373
  config.p2pIp = opts.p2pIp ?? config.p2pIp ?? '127.0.0.1';
283
374
  if (!config.disableValidator) {
@@ -287,37 +378,56 @@ export const getPrivateKeyFromIndex = (index)=>{
287
378
  ]);
288
379
  }
289
380
  }
290
- const aztecNodeService = await withLoggerBindings({
291
- actor: 'node-0'
292
- }, ()=>AztecNodeService.createAndSync(config, {
293
- dateProvider,
294
- telemetry: telemetryClient,
295
- p2pClientDeps
296
- }, {
297
- prefilledPublicData
298
- }));
381
+ // When skipInitialSequencer is set, the initial node is a lightweight RPC-only node.
382
+ // We apply these overrides to a copy so they don't leak into the returned config.
383
+ // Keep P2P enabled if mockGossipSubNetwork is used (needed for tx propagation to validators).
384
+ const initialNodeConfig = opts.skipInitialSequencer ? {
385
+ ...config,
386
+ disableValidator: true,
387
+ ...opts.mockGossipSubNetwork ? {} : {
388
+ p2pEnabled: false,
389
+ bootstrapNodes: []
390
+ }
391
+ } : config;
392
+ logger.trace('Prepared aztec node config');
393
+ const aztecNodeService = await testSpan('setup:env:sequencer-start', ()=>withLoggerBindings({
394
+ actor: 'node-0'
395
+ }, ()=>createAztecNodeService(initialNodeConfig, {
396
+ dateProvider,
397
+ telemetry: telemetryClient,
398
+ p2pClientDeps
399
+ }, {
400
+ genesis,
401
+ dontStartSequencer: opts.skipInitialSequencer
402
+ })));
299
403
  const sequencerClient = aztecNodeService.getSequencer();
300
- if (sequencerClient) {
301
- const publisher = sequencerClient.sequencer.publisher;
302
- publisher.l1TxUtils = DelayedTxUtils.fromL1TxUtils(publisher.l1TxUtils, config.ethereumSlotDuration, l1Client);
303
- }
404
+ logger.trace('Created and synced aztec node');
304
405
  let proverNode = undefined;
305
406
  if (opts.startProverNode) {
306
407
  logger.verbose('Creating and syncing a simulated prover node...');
307
408
  const proverNodePrivateKey = getPrivateKeyFromIndex(2);
308
409
  const proverNodePrivateKeyHex = `0x${proverNodePrivateKey.toString('hex')}`;
309
410
  const proverNodeDataDirectory = path.join(directoryToCleanup, randomBytes(8).toString('hex'));
310
- const proverNodeConfig = {
311
- ...config.proverNodeConfig,
312
- dataDirectory: proverNodeDataDirectory,
313
- p2pEnabled: !!mockGossipSubNetwork
411
+ const p2pClientDeps = {
412
+ p2pServiceFactory: mockGossipSubNetwork && getMockPubSubP2PServiceFactory(mockGossipSubNetwork),
413
+ rpcTxProviders: [
414
+ aztecNodeService
415
+ ]
314
416
  };
315
- proverNode = await createAndSyncProverNode(proverNodePrivateKeyHex, config, proverNodeConfig, aztecNodeService, prefilledPublicData, {
316
- p2pClientDeps: mockGossipSubNetwork ? {
317
- p2pServiceFactory: getMockPubSubP2PServiceFactory(mockGossipSubNetwork)
318
- } : undefined
319
- });
417
+ ({ proverNode } = await testSpan('setup:env:prover-node', ()=>createAndSyncProverNode(proverNodePrivateKeyHex, config, {
418
+ ...config.proverNodeConfig,
419
+ dataDirectory: proverNodeDataDirectory
420
+ }, {
421
+ dateProvider,
422
+ p2pClientDeps,
423
+ telemetry: telemetryClient
424
+ }, {
425
+ genesis
426
+ })));
427
+ logger.trace('Created prover node');
320
428
  }
429
+ const sequencerDelayer = sequencerClient?.getDelayer();
430
+ const proverDelayer = proverNode?.getProverNode()?.getDelayer();
321
431
  logger.verbose('Creating a pxe...');
322
432
  const pxeConfig = {
323
433
  ...getPXEConfig(),
@@ -326,65 +436,57 @@ export const getPrivateKeyFromIndex = (index)=>{
326
436
  pxeConfig.dataDirectory = path.join(directoryToCleanup, randomBytes(8).toString('hex'));
327
437
  // For tests we only want proving enabled if specifically requested
328
438
  pxeConfig.proverEnabled = !!pxeOpts.proverEnabled;
329
- const wallet = await TestWallet.create(aztecNodeService, pxeConfig, {
330
- loggerActorLabel: 'pxe-0'
331
- });
439
+ const wallet = await testSpan('setup:env:pxe', ()=>TestWallet.create(aztecNodeService, pxeConfig, {
440
+ loggerActorLabel: 'pxe-0',
441
+ // In-process node implements the debug API, so register public function signatures for named traces.
442
+ nodeDebug: aztecNodeService,
443
+ ...opts.pxeCreationOptions
444
+ }));
332
445
  if (opts.walletMinFeePadding !== undefined) {
333
446
  wallet.setMinFeePadding(opts.walletMinFeePadding);
334
447
  }
448
+ logger.trace('Created PXE and test wallet');
335
449
  const cheatCodes = await CheatCodes.create(config.l1RpcUrls, aztecNodeService, dateProvider);
450
+ logger.trace('Created cheat codes');
336
451
  if (opts.aztecTargetCommitteeSize && opts.aztecTargetCommitteeSize > 0 || opts.initialValidators && opts.initialValidators.length > 0) {
337
452
  // We need to advance such that the committee is set up.
338
453
  await cheatCodes.rollup.advanceToEpoch(EpochNumber.fromBigInt(BigInt(await cheatCodes.rollup.getEpoch()) + BigInt(config.lagInEpochsForValidatorSet + 1)));
339
454
  await cheatCodes.rollup.setupEpoch();
340
455
  await cheatCodes.rollup.debugRollup();
456
+ logger.trace('Advanced chain to set up validator committee');
341
457
  }
342
458
  let accounts = [];
343
- if (shouldDeployAccounts) {
344
- logger.info(`${numberOfAccounts} accounts are being deployed. Reliably progressing past genesis by setting minTxsPerBlock to 1 and waiting for the accounts to be deployed`);
345
- const accountsData = initialFundedAccounts.slice(0, numberOfAccounts);
346
- const accountManagers = await deployFundedSchnorrAccounts(wallet, accountsData);
347
- accounts = accountManagers.map((accountManager)=>accountManager.address);
348
- } else if (needsEmptyBlock) {
349
- logger.info('No accounts are being deployed, waiting for an empty block 1 to be mined');
350
- while(await aztecNodeService.getBlockNumber() === 0){
351
- await sleep(2000);
352
- }
459
+ // Create the default accounts. They are initializerless, so this is a PXE-side operation (registration
460
+ // + a simulated store call) with no on-chain tx, independent of the sequencer.
461
+ if (numberOfAccounts > 0) {
462
+ logger.info(`Creating ${numberOfAccounts} initializerless test accounts`);
463
+ await testSpan('wallet:create', ()=>createFundedInitializerlessAccounts(wallet, defaultAccounts));
464
+ accounts = defaultAccounts.map((a)=>a.address);
353
465
  }
354
- // If skipAccountDeployment is true, we don't deploy or wait - tests will handle account deployment later
355
- // Now we restore the original minTxsPerBlock setting if we changed it.
356
- if (sequencerClient && config.minTxsPerBlock !== originalMinTxsPerBlock) {
357
- sequencerClient.getSequencer().updateConfig({
358
- minTxsPerBlock: originalMinTxsPerBlock
359
- });
360
- }
361
- if (initialFundedAccounts.length < numberOfAccounts) {
362
- throw new Error(`Unable to deploy ${numberOfAccounts} accounts. Only ${initialFundedAccounts.length} accounts were funded.`);
363
- }
364
- const teardown = async ()=>{
365
- try {
366
- await tryStop(wallet, logger);
367
- await tryStop(aztecNodeService, logger);
368
- await tryStop(proverNode, logger);
369
- if (acvmConfig?.cleanup) {
370
- await acvmConfig.cleanup();
371
- }
372
- if (bbConfig?.cleanup) {
373
- await bbConfig.cleanup();
374
- }
375
- await tryStop(watcher, logger);
376
- await tryStop(anvil, logger);
377
- await tryRmDir(directoryToCleanup, logger);
378
- } catch (err) {
379
- logger.error(`Error during e2e test teardown`, err);
380
- } finally{
466
+ logger.trace('Created funded test accounts');
467
+ const teardown = ()=>testSpan('teardown:env', async ()=>{
381
468
  try {
382
- await telemetryClient.stop();
469
+ await tryStop(wallet, logger);
470
+ await tryStop(aztecNodeService, logger);
471
+ await tryStop(proverNode, logger);
472
+ if (acvmConfig?.cleanup) {
473
+ await acvmConfig.cleanup();
474
+ }
475
+ if (bbConfig?.cleanup) {
476
+ await bbConfig.cleanup();
477
+ }
478
+ await tryStop(anvil, logger);
479
+ await tryRmDir(directoryToCleanup, logger);
383
480
  } catch (err) {
384
- logger.error(`Error during telemetry client stop`, err);
481
+ logger.error(`Error during e2e test teardown`, err);
482
+ } finally{
483
+ try {
484
+ await telemetryClient.stop();
485
+ } catch (err) {
486
+ logger.error(`Error during telemetry client stop`, err);
487
+ }
385
488
  }
386
- }
387
- };
489
+ });
388
490
  return {
389
491
  anvil,
390
492
  aztecNode: aztecNodeService,
@@ -396,17 +498,19 @@ export const getPrivateKeyFromIndex = (index)=>{
396
498
  aztecNodeConfig: config,
397
499
  dateProvider,
398
500
  deployL1ContractsValues,
399
- initialFundedAccounts,
501
+ additionallyFundedAccounts,
400
502
  logger,
401
503
  mockGossipSubNetwork,
402
- prefilledPublicData,
504
+ genesis,
505
+ extraL1DeployResult,
403
506
  proverNode,
507
+ sequencerDelayer,
508
+ proverDelayer,
404
509
  sequencer: sequencerClient,
405
510
  teardown,
406
511
  telemetryClient,
407
512
  wallet,
408
513
  accounts,
409
- watcher,
410
514
  acvmConfig,
411
515
  bbConfig,
412
516
  directoryToCleanup
@@ -457,81 +561,45 @@ export const getPrivateKeyFromIndex = (index)=>{
457
561
  */ export async function registerSponsoredFPC(wallet) {
458
562
  await wallet.registerContract(await getSponsoredFPCInstance(), SponsoredFPCContract.artifact);
459
563
  }
460
- export async function waitForProvenChain(node, targetBlock, timeoutSec = 60, intervalSec = 1) {
564
+ export async function waitForProvenChain(node, targetBlock, timeoutSec = 60, intervalSec = 0.25) {
461
565
  targetBlock ??= await node.getBlockNumber();
462
- await retryUntil(async ()=>await node.getProvenBlockNumber() >= targetBlock, 'proven chain status', timeoutSec, intervalSec);
566
+ await retryUntil(async ()=>await node.getBlockNumber('proven') >= targetBlock, 'proven chain status', timeoutSec, intervalSec);
463
567
  }
464
- export function createAndSyncProverNode(proverNodePrivateKey, aztecNodeConfig, proverNodeConfig, aztecNode, prefilledPublicData = [], proverNodeDeps = {}) {
568
+ /**
569
+ * Creates an AztecNodeService with the prover node enabled as a subsystem.
570
+ * Returns both the aztec node service (for lifecycle management) and the prover node (for test internals access).
571
+ */ export function createAndSyncProverNode(proverNodePrivateKey, baseConfig, configOverrides, deps, options) {
465
572
  return withLoggerBindings({
466
573
  actor: 'prover-0'
467
574
  }, async ()=>{
468
- const aztecNodeTxProvider = aztecNode && {
469
- getTxByHash: aztecNode.getTxByHash.bind(aztecNode),
470
- getTxsByHash: aztecNode.getTxsByHash.bind(aztecNode),
471
- stop: ()=>Promise.resolve()
472
- };
473
- const blobClient = await createBlobClientWithFileStores(aztecNodeConfig, createLogger('blob-client:prover-node'));
474
- const archiverConfig = {
475
- ...aztecNodeConfig,
476
- dataDirectory: proverNodeConfig.dataDirectory
477
- };
478
- const archiver = await createArchiver(archiverConfig, {
479
- blobClient,
480
- dateProvider: proverNodeDeps.dateProvider
481
- }, {
482
- blockUntilSync: true
483
- });
484
- const proverConfig = {
485
- ...aztecNodeConfig,
486
- txCollectionNodeRpcUrls: [],
487
- realProofs: false,
488
- proverAgentCount: 2,
489
- publisherPrivateKeys: [
575
+ const proverNode = await createAztecNodeService({
576
+ ...baseConfig,
577
+ ...configOverrides,
578
+ p2pPort: 0,
579
+ enableProverNode: true,
580
+ disableValidator: true,
581
+ proverPublisherPrivateKeys: [
490
582
  new SecretValue(proverNodePrivateKey)
491
- ],
492
- proverNodeMaxPendingJobs: 10,
493
- proverNodeMaxParallelBlocksPerEpoch: 32,
494
- proverNodePollingIntervalMs: 200,
495
- txGatheringIntervalMs: 1000,
496
- txGatheringBatchSize: 10,
497
- txGatheringMaxParallelRequestsPerNode: 10,
498
- txGatheringTimeoutMs: 24_000,
499
- proverNodeFailedEpochStore: undefined,
500
- proverId: EthAddress.fromNumber(1),
501
- proverNodeEpochProvingDelayMs: undefined,
502
- ...proverNodeConfig
503
- };
504
- const l1TxUtils = createDelayedL1TxUtils(aztecNodeConfig, proverNodePrivateKey, 'prover-node', proverNodeDeps.dateProvider);
505
- const proverNode = await createProverNode(proverConfig, {
506
- ...proverNodeDeps,
507
- aztecNodeTxProvider,
508
- archiver: archiver,
509
- l1TxUtils
510
- }, {
511
- prefilledPublicData
583
+ ]
584
+ }, deps, {
585
+ genesis: options.genesis,
586
+ dontStartProverNode: options.dontStart
512
587
  });
513
- getLogger().info(`Created and synced prover node`, {
514
- publisherAddress: l1TxUtils.client.account.address
515
- });
516
- if (!proverNodeConfig.dontStart) {
517
- await proverNode.start();
588
+ if (!proverNode.getProverNode()) {
589
+ throw new Error('Prover node subsystem was not created despite enableProverNode being set');
518
590
  }
519
- return proverNode;
591
+ getLogger().info(`Created and synced prover node`);
592
+ return {
593
+ proverNode
594
+ };
520
595
  });
521
596
  }
522
- function createDelayedL1TxUtils(aztecNodeConfig, privateKey, logName, dateProvider) {
523
- const l1Client = createExtendedL1Client(aztecNodeConfig.l1RpcUrls, privateKey, foundry);
524
- const log = createLogger(logName);
525
- const l1TxUtils = createDelayedL1TxUtilsFromViemWallet(l1Client, log, dateProvider, aztecNodeConfig);
526
- l1TxUtils.enableDelayer(aztecNodeConfig.ethereumSlotDuration);
527
- return l1TxUtils;
528
- }
529
597
  export function getBalancesFn(symbol, method, logger) {
530
598
  const balances = async (...addressLikes)=>{
531
599
  const addresses = addressLikes.map((addressLike)=>'address' in addressLike ? addressLike.address : addressLike);
532
- const b = await Promise.all(addresses.map((address)=>method(address).simulate({
600
+ const b = await Promise.all(addresses.map(async (address)=>(await method(address).simulate({
533
601
  from: address
534
- })));
602
+ })).result));
535
603
  const debugString = `${symbol} balances: ${addresses.map((address, i)=>`${address}: ${b[i]}`).join(', ')}`;
536
604
  logger.verbose(debugString);
537
605
  return b;
@@ -550,74 +618,63 @@ export async function expectMappingDelta(initialValues, fn, inputs, expectedDiff
550
618
  expect(diffs).toEqual(expectedDiffs);
551
619
  }
552
620
  /**
553
- * Registers the contract class used for test accounts and publicly deploys the instances requested.
554
- * Use this when you need to make a public call to an account contract, such as for requesting a public authwit.
555
- */ export async function ensureAccountContractsPublished(wallet, accountsToDeploy) {
556
- const accountsAndAddresses = await Promise.all(accountsToDeploy.map(async (address)=>{
557
- return {
558
- address,
559
- deployed: (await wallet.getContractMetadata(address)).isContractPublished
560
- };
561
- }));
562
- const instances = (await Promise.all(accountsAndAddresses.filter(({ deployed })=>!deployed).map(({ address })=>wallet.getContractMetadata(address)))).map((contractMetadata)=>contractMetadata.instance);
563
- const contractClass = await getContractClassFromArtifact(SchnorrAccountContractArtifact);
621
+ * Registers the auth_registry contract class and publishes its standard instance if not already
622
+ * present, and registers the artifact with PXE. Publishing is required before exercising the public
623
+ * authwit path (which relies on the AVM's deployment-nullifier check); the PXE-side registration is
624
+ * required so revert messages from AuthRegistry calls can be enriched (otherwise assertion strings
625
+ * surface as generic "Assertion failed:" and tests that match on the real message fail).
626
+ */ export async function ensureAuthRegistryPublished(wallet, from) {
627
+ await testSpan('setup:auth-registry', async ()=>{
628
+ const { instance, contractClass } = await getStandardAuthRegistry();
629
+ if (!(await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered) {
630
+ await (await publishContractClass(wallet, AuthRegistryArtifact)).send({
631
+ from
632
+ });
633
+ }
634
+ if (!(await wallet.getContractMetadata(instance.address)).isContractPublished) {
635
+ await publishInstance(wallet, instance).send({
636
+ from
637
+ });
638
+ }
639
+ await wallet.registerContract(instance, AuthRegistryArtifact);
640
+ });
641
+ }
642
+ /**
643
+ * Registers the public_checks contract class and publishes its standard instance if not already
644
+ * present, and registers the artifact with PXE. Required for any contract that calls
645
+ * `privately_check_timestamp` / `privately_check_block_number` (which dispatch into the
646
+ * deployed PublicChecks contract via an enqueued public call).
647
+ */ export async function ensurePublicChecksPublished(wallet, from) {
648
+ const { instance, contractClass } = await getStandardPublicChecks();
564
649
  if (!(await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered) {
565
- await (await publishContractClass(wallet, SchnorrAccountContractArtifact)).send({
566
- from: accountsToDeploy[0]
650
+ await (await publishContractClass(wallet, PublicChecksArtifact)).send({
651
+ from
567
652
  });
568
653
  }
569
- const requests = instances.map((instance)=>publishInstance(wallet, instance));
570
- const batch = new BatchCall(wallet, requests);
571
- await batch.send({
572
- from: accountsToDeploy[0]
573
- });
654
+ if (!(await wallet.getContractMetadata(instance.address)).isContractPublished) {
655
+ await publishInstance(wallet, instance).send({
656
+ from
657
+ });
658
+ }
659
+ await wallet.registerContract(instance, PublicChecksArtifact);
574
660
  }
575
661
  /**
576
- * Helper function to deploy accounts.
577
- * Returns deployed account data that can be used by tests.
578
- */ export const deployAccounts = (numberOfAccounts, logger)=>async ({ wallet, initialFundedAccounts })=>{
579
- if (initialFundedAccounts.length < numberOfAccounts) {
580
- throw new Error(`Cannot deploy more than ${initialFundedAccounts.length} initial accounts.`);
581
- }
582
- logger.verbose('Deploying accounts funded with fee juice...');
583
- const deployedAccounts = initialFundedAccounts.slice(0, numberOfAccounts);
584
- // Serial due to https://github.com/AztecProtocol/aztec-packages/issues/12045
585
- for(let i = 0; i < deployedAccounts.length; i++){
586
- const accountManager = await wallet.createSchnorrAccount(deployedAccounts[i].secret, deployedAccounts[i].salt, deployedAccounts[i].signingKey);
587
- const deployMethod = await accountManager.getDeployMethod();
588
- await deployMethod.send({
589
- from: AztecAddress.ZERO,
590
- skipClassPublication: i !== 0
591
- });
592
- }
593
- return {
594
- deployedAccounts
595
- };
596
- };
597
- /**
598
- * Registers the contract class used for test accounts and publicly deploys the instances requested.
599
- * Use this when you need to make a public call to an account contract, such as for requesting a public authwit.
600
- */ export async function publicDeployAccounts(wallet, accountsToDeploy, waitUntilProven = false, node) {
601
- const instances = (await Promise.all(accountsToDeploy.map((account)=>wallet.getContractMetadata(account)))).map((metadata)=>metadata.instance);
602
- const contractClass = await getContractClassFromArtifact(SchnorrAccountContractArtifact);
603
- const alreadyRegistered = (await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered;
604
- const calls = await Promise.all([
605
- ...!alreadyRegistered ? [
606
- publishContractClass(wallet, SchnorrAccountContractArtifact)
607
- ] : [],
608
- ...instances.map((instance)=>publishInstance(wallet, instance))
609
- ]);
610
- const batch = new BatchCall(wallet, calls);
611
- const txReceipt = await batch.send({
612
- from: accountsToDeploy[0]
613
- });
614
- if (waitUntilProven) {
615
- if (!node) {
616
- throw new Error('Need to provide an AztecNode to wait for proven.');
617
- } else {
618
- await waitForProven(node, txReceipt);
619
- }
662
+ * Registers the handshake_registry contract class and publishes its standard instance if not
663
+ * already present, and registers the artifact with PXE. Required for constrained-delivery flows
664
+ * that call into the HandshakeRegistry at its well-known address.
665
+ */ export async function ensureHandshakeRegistryPublished(wallet, from) {
666
+ const { instance, contractClass } = await getStandardHandshakeRegistry();
667
+ if (!(await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered) {
668
+ await (await publishContractClass(wallet, HandshakeRegistryArtifact)).send({
669
+ from
670
+ });
671
+ }
672
+ if (!(await wallet.getContractMetadata(instance.address)).isContractPublished) {
673
+ await publishInstance(wallet, instance).send({
674
+ from
675
+ });
620
676
  }
677
+ await wallet.registerContract(instance, HandshakeRegistryArtifact);
621
678
  }
622
679
  /**
623
680
  * Destroys the current context.