@aztec/end-to-end 5.0.0-rc.1 → 5.0.0

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 (257) hide show
  1. package/README.md +215 -27
  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 +17 -24
  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 +22 -28
  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 +1 -1
  25. package/dest/bench/client_flows/benchmark.d.ts.map +1 -1
  26. package/dest/bench/client_flows/benchmark.js +3 -1
  27. package/dest/bench/client_flows/client_flows_benchmark.d.ts +4 -4
  28. package/dest/bench/client_flows/client_flows_benchmark.d.ts.map +1 -1
  29. package/dest/bench/client_flows/client_flows_benchmark.js +25 -10
  30. package/dest/bench/utils.d.ts +1 -1
  31. package/dest/composed/ha/ha_full_setup.d.ts +77 -0
  32. package/dest/composed/ha/ha_full_setup.d.ts.map +1 -0
  33. package/dest/composed/ha/ha_full_setup.js +383 -0
  34. package/dest/composed/web3signer/multi_validator_keystore_utils.d.ts +12 -0
  35. package/dest/composed/web3signer/multi_validator_keystore_utils.d.ts.map +1 -0
  36. package/dest/fixtures/e2e_prover_test.d.ts +10 -7
  37. package/dest/fixtures/e2e_prover_test.d.ts.map +1 -1
  38. package/dest/fixtures/e2e_prover_test.js +33 -14
  39. package/dest/fixtures/fixtures.d.ts +8 -5
  40. package/dest/fixtures/fixtures.d.ts.map +1 -1
  41. package/dest/fixtures/fixtures.js +12 -4
  42. package/dest/fixtures/ha_setup.d.ts +3 -3
  43. package/dest/fixtures/ha_setup.d.ts.map +1 -1
  44. package/dest/fixtures/ha_setup.js +4 -1
  45. package/dest/fixtures/index.d.ts +2 -1
  46. package/dest/fixtures/index.d.ts.map +1 -1
  47. package/dest/fixtures/index.js +1 -0
  48. package/dest/fixtures/setup.d.ts +35 -9
  49. package/dest/fixtures/setup.d.ts.map +1 -1
  50. package/dest/fixtures/setup.js +175 -142
  51. package/dest/fixtures/setup_p2p_test.d.ts +1 -1
  52. package/dest/fixtures/setup_p2p_test.d.ts.map +1 -1
  53. package/dest/fixtures/setup_p2p_test.js +3 -3
  54. package/dest/fixtures/standard_contracts_genesis.d.ts +16 -0
  55. package/dest/fixtures/standard_contracts_genesis.d.ts.map +1 -0
  56. package/dest/fixtures/standard_contracts_genesis.js +25 -0
  57. package/dest/fixtures/timing.d.ts +42 -0
  58. package/dest/fixtures/timing.d.ts.map +1 -0
  59. package/dest/fixtures/timing.js +72 -0
  60. package/dest/fixtures/token_utils.d.ts +22 -4
  61. package/dest/fixtures/token_utils.d.ts.map +1 -1
  62. package/dest/fixtures/token_utils.js +21 -1
  63. package/dest/fixtures/wait_helpers.d.ts +135 -0
  64. package/dest/fixtures/wait_helpers.d.ts.map +1 -0
  65. package/dest/fixtures/wait_helpers.js +154 -0
  66. package/dest/forward-compatibility/wallet_service.js +1 -1
  67. package/dest/multi-node/block-production/setup.d.ts +97 -0
  68. package/dest/multi-node/block-production/setup.d.ts.map +1 -0
  69. package/dest/multi-node/block-production/setup.js +158 -0
  70. package/dest/multi-node/governance/setup.d.ts +67 -0
  71. package/dest/multi-node/governance/setup.d.ts.map +1 -0
  72. package/dest/multi-node/governance/setup.js +126 -0
  73. package/dest/multi-node/multi_node_test_context.d.ts +212 -0
  74. package/dest/multi-node/multi_node_test_context.d.ts.map +1 -0
  75. package/dest/multi-node/multi_node_test_context.js +347 -0
  76. package/dest/multi-node/slashing/inactivity_setup.d.ts +27 -0
  77. package/dest/multi-node/slashing/inactivity_setup.d.ts.map +1 -0
  78. package/dest/multi-node/slashing/inactivity_setup.js +111 -0
  79. package/dest/multi-node/slashing/setup.d.ts +167 -0
  80. package/dest/multi-node/slashing/setup.d.ts.map +1 -0
  81. package/dest/multi-node/slashing/setup.js +275 -0
  82. package/dest/{e2e_p2p → p2p}/p2p_network.d.ts +10 -2
  83. package/dest/p2p/p2p_network.d.ts.map +1 -0
  84. package/dest/{e2e_p2p → p2p}/p2p_network.js +36 -9
  85. package/dest/p2p/reqresp/utils.d.ts +19 -0
  86. package/dest/p2p/reqresp/utils.d.ts.map +1 -0
  87. package/dest/{e2e_p2p → p2p}/reqresp/utils.js +4 -15
  88. package/dest/p2p/shared.d.ts +72 -0
  89. package/dest/p2p/shared.d.ts.map +1 -0
  90. package/dest/p2p/shared.js +212 -0
  91. package/dest/shared/cross_chain_test_harness.d.ts +3 -3
  92. package/dest/shared/cross_chain_test_harness.d.ts.map +1 -1
  93. package/dest/shared/cross_chain_test_harness.js +24 -16
  94. package/dest/shared/gas_portal_test_harness.d.ts +1 -1
  95. package/dest/shared/gas_portal_test_harness.d.ts.map +1 -1
  96. package/dest/shared/gas_portal_test_harness.js +8 -5
  97. package/dest/shared/submit-transactions.d.ts +1 -1
  98. package/dest/shared/submit-transactions.d.ts.map +1 -1
  99. package/dest/shared/submit-transactions.js +12 -5
  100. package/dest/shared/timing_env.d.js +5 -0
  101. package/dest/shared/timing_env.js +365 -0
  102. package/dest/shared/wait_for_l1_to_l2_message.js +1 -1
  103. package/dest/simulators/lending_simulator.js +1 -1
  104. package/dest/single-node/cross-chain/cross_chain_messaging_test.d.ts +75 -0
  105. package/dest/single-node/cross-chain/cross_chain_messaging_test.d.ts.map +1 -0
  106. package/dest/{e2e_cross_chain_messaging → single-node/cross-chain}/cross_chain_messaging_test.js +77 -27
  107. package/dest/single-node/cross-chain/message_test_helpers.d.ts +38 -0
  108. package/dest/single-node/cross-chain/message_test_helpers.d.ts.map +1 -0
  109. package/dest/single-node/cross-chain/message_test_helpers.js +70 -0
  110. package/dest/{e2e_fees → single-node/fees}/bridging_race.notest.d.ts +1 -1
  111. package/dest/single-node/fees/bridging_race.notest.d.ts.map +1 -0
  112. package/dest/{e2e_fees → single-node/fees}/bridging_race.notest.js +17 -4
  113. package/dest/single-node/fees/fees_test.d.ts +95 -0
  114. package/dest/single-node/fees/fees_test.d.ts.map +1 -0
  115. package/dest/{e2e_fees → single-node/fees}/fees_test.js +124 -46
  116. package/dest/single-node/l1-reorgs/setup.d.ts +42 -0
  117. package/dest/single-node/l1-reorgs/setup.d.ts.map +1 -0
  118. package/dest/single-node/l1-reorgs/setup.js +57 -0
  119. package/dest/single-node/partial-proofs/setup.d.ts +5 -0
  120. package/dest/single-node/partial-proofs/setup.d.ts.map +1 -0
  121. package/dest/single-node/partial-proofs/setup.js +5 -0
  122. package/dest/single-node/proving/setup.d.ts +5 -0
  123. package/dest/single-node/proving/setup.d.ts.map +1 -0
  124. package/dest/single-node/proving/setup.js +5 -0
  125. package/dest/single-node/recovery/setup.d.ts +5 -0
  126. package/dest/single-node/recovery/setup.d.ts.map +1 -0
  127. package/dest/single-node/recovery/setup.js +5 -0
  128. package/dest/single-node/setup.d.ts +49 -0
  129. package/dest/single-node/setup.d.ts.map +1 -0
  130. package/dest/single-node/setup.js +56 -0
  131. package/dest/single-node/single_node_test_context.d.ts +373 -0
  132. package/dest/single-node/single_node_test_context.d.ts.map +1 -0
  133. package/dest/single-node/single_node_test_context.js +845 -0
  134. package/dest/spartan/setup_test_wallets.d.ts +1 -1
  135. package/dest/spartan/setup_test_wallets.d.ts.map +1 -1
  136. package/dest/spartan/setup_test_wallets.js +18 -8
  137. package/dest/spartan/tx_metrics.d.ts +10 -1
  138. package/dest/spartan/tx_metrics.d.ts.map +1 -1
  139. package/dest/spartan/tx_metrics.js +32 -0
  140. package/dest/test-wallet/test_wallet.d.ts +23 -4
  141. package/dest/test-wallet/test_wallet.d.ts.map +1 -1
  142. package/dest/test-wallet/test_wallet.js +20 -4
  143. package/dest/test-wallet/utils.d.ts +36 -1
  144. package/dest/test-wallet/utils.d.ts.map +1 -1
  145. package/dest/test-wallet/utils.js +64 -4
  146. package/dest/test-wallet/wallet_worker_script.js +5 -2
  147. package/dest/test-wallet/worker_wallet.d.ts +5 -5
  148. package/dest/test-wallet/worker_wallet.d.ts.map +1 -1
  149. package/dest/test-wallet/worker_wallet.js +2 -2
  150. package/dest/test-wallet/worker_wallet_schema.js +2 -1
  151. package/package.json +41 -41
  152. package/src/automine/README.md +60 -0
  153. package/src/automine/automine_test_context.ts +153 -0
  154. package/src/automine/delivery/interactive_handshake_responder.ts +125 -0
  155. package/src/automine/delivery/onchain_delivery_harness.ts +213 -0
  156. package/src/{e2e_blacklist_token_contract → automine/token}/blacklist_token_contract_test.ts +19 -39
  157. package/src/{e2e_token_contract → automine/token}/token_contract_test.ts +24 -43
  158. package/src/automine/token/token_test_helpers.ts +138 -0
  159. package/src/bench/client_flows/benchmark.ts +3 -1
  160. package/src/bench/client_flows/client_flows_benchmark.ts +39 -12
  161. package/src/composed/ha/ha_full_setup.ts +466 -0
  162. package/src/fixtures/e2e_prover_test.ts +40 -23
  163. package/src/fixtures/fixtures.ts +14 -4
  164. package/src/fixtures/ha_setup.ts +7 -3
  165. package/src/fixtures/index.ts +1 -0
  166. package/src/fixtures/setup.ts +217 -146
  167. package/src/fixtures/setup_p2p_test.ts +3 -3
  168. package/src/fixtures/standard_contracts_genesis.ts +28 -0
  169. package/src/fixtures/timing.ts +97 -0
  170. package/src/fixtures/token_utils.ts +39 -4
  171. package/src/fixtures/wait_helpers.ts +333 -0
  172. package/src/forward-compatibility/wallet_service.ts +2 -2
  173. package/src/guides/up_quick_start.sh +5 -0
  174. package/src/infra/README.md +12 -0
  175. package/src/multi-node/README.md +96 -0
  176. package/src/multi-node/block-production/setup.ts +272 -0
  177. package/src/multi-node/governance/setup.ts +172 -0
  178. package/src/multi-node/multi_node_test_context.ts +447 -0
  179. package/src/multi-node/slashing/inactivity_setup.ts +139 -0
  180. package/src/multi-node/slashing/setup.ts +433 -0
  181. package/src/p2p/README.md +78 -0
  182. package/src/{e2e_p2p → p2p}/p2p_network.ts +36 -7
  183. package/src/{e2e_p2p → p2p}/reqresp/utils.ts +5 -14
  184. package/src/p2p/shared.ts +329 -0
  185. package/src/shared/cross_chain_test_harness.ts +22 -13
  186. package/src/shared/gas_portal_test_harness.ts +13 -5
  187. package/src/shared/submit-transactions.ts +13 -5
  188. package/src/shared/timing_env.d.mts +39 -0
  189. package/src/shared/timing_env.mjs +363 -0
  190. package/src/shared/wait_for_l1_to_l2_message.ts +1 -1
  191. package/src/simulators/lending_simulator.ts +1 -1
  192. package/src/single-node/README.md +66 -0
  193. package/src/{e2e_cross_chain_messaging → single-node/cross-chain}/cross_chain_messaging_test.ts +110 -39
  194. package/src/single-node/cross-chain/message_test_helpers.ts +125 -0
  195. package/src/{e2e_fees → single-node/fees}/bridging_race.notest.ts +19 -5
  196. package/src/{e2e_fees → single-node/fees}/fees_test.ts +141 -48
  197. package/src/single-node/l1-reorgs/setup.ts +93 -0
  198. package/src/single-node/partial-proofs/setup.ts +8 -0
  199. package/src/single-node/proving/setup.ts +15 -0
  200. package/src/single-node/recovery/setup.ts +8 -0
  201. package/src/single-node/setup.ts +63 -0
  202. package/src/single-node/single_node_test_context.ts +1054 -0
  203. package/src/spartan/setup_test_wallets.ts +23 -8
  204. package/src/spartan/tx_metrics.ts +26 -0
  205. package/src/test-wallet/test_wallet.ts +28 -6
  206. package/src/test-wallet/utils.ts +102 -5
  207. package/src/test-wallet/wallet_worker_script.ts +6 -3
  208. package/src/test-wallet/worker_wallet.ts +5 -9
  209. package/src/test-wallet/worker_wallet_schema.ts +1 -1
  210. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts +0 -56
  211. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts.map +0 -1
  212. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts +0 -58
  213. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts.map +0 -1
  214. package/dest/e2e_deploy_contract/deploy_test.d.ts +0 -36
  215. package/dest/e2e_deploy_contract/deploy_test.d.ts.map +0 -1
  216. package/dest/e2e_deploy_contract/deploy_test.js +0 -42
  217. package/dest/e2e_epochs/epochs_test.d.ts +0 -137
  218. package/dest/e2e_epochs/epochs_test.d.ts.map +0 -1
  219. package/dest/e2e_epochs/epochs_test.js +0 -485
  220. package/dest/e2e_fees/bridging_race.notest.d.ts.map +0 -1
  221. package/dest/e2e_fees/fees_test.d.ts +0 -89
  222. package/dest/e2e_fees/fees_test.d.ts.map +0 -1
  223. package/dest/e2e_l1_publisher/write_json.d.ts +0 -11
  224. package/dest/e2e_l1_publisher/write_json.d.ts.map +0 -1
  225. package/dest/e2e_l1_publisher/write_json.js +0 -56
  226. package/dest/e2e_multi_validator/utils.d.ts +0 -12
  227. package/dest/e2e_multi_validator/utils.d.ts.map +0 -1
  228. package/dest/e2e_nested_contract/nested_contract_test.d.ts +0 -22
  229. package/dest/e2e_nested_contract/nested_contract_test.d.ts.map +0 -1
  230. package/dest/e2e_nested_contract/nested_contract_test.js +0 -40
  231. package/dest/e2e_p2p/inactivity_slash_test.d.ts +0 -31
  232. package/dest/e2e_p2p/inactivity_slash_test.d.ts.map +0 -1
  233. package/dest/e2e_p2p/inactivity_slash_test.js +0 -138
  234. package/dest/e2e_p2p/p2p_network.d.ts.map +0 -1
  235. package/dest/e2e_p2p/reqresp/utils.d.ts +0 -22
  236. package/dest/e2e_p2p/reqresp/utils.d.ts.map +0 -1
  237. package/dest/e2e_p2p/shared.d.ts +0 -75
  238. package/dest/e2e_p2p/shared.d.ts.map +0 -1
  239. package/dest/e2e_p2p/shared.js +0 -217
  240. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts +0 -2
  241. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts.map +0 -1
  242. package/dest/e2e_storage_proof/fixtures/storage_proof_fixture.d.ts.map +0 -1
  243. package/dest/e2e_token_contract/token_contract_test.d.ts +0 -44
  244. package/dest/e2e_token_contract/token_contract_test.d.ts.map +0 -1
  245. package/src/e2e_deploy_contract/deploy_test.ts +0 -73
  246. package/src/e2e_epochs/epochs_test.ts +0 -596
  247. package/src/e2e_l1_publisher/write_json.ts +0 -77
  248. package/src/e2e_nested_contract/nested_contract_test.ts +0 -51
  249. package/src/e2e_p2p/inactivity_slash_test.ts +0 -181
  250. package/src/e2e_p2p/shared.ts +0 -332
  251. /package/dest/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fetcher.js +0 -0
  252. /package/dest/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fixture.js +0 -0
  253. /package/dest/{e2e_multi_validator/utils.js → composed/web3signer/multi_validator_keystore_utils.js} +0 -0
  254. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof.json +0 -0
  255. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fetcher.ts +0 -0
  256. /package/src/{e2e_storage_proof → automine/contracts}/fixtures/storage_proof_fixture.ts +0 -0
  257. /package/src/{e2e_multi_validator/utils.ts → composed/web3signer/multi_validator_keystore_utils.ts} +0 -0
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Runs `fn` with every {@link testSpan} inside its async call tree attributed to `owner` instead of the
3
+ * currently running test. Use a non-test sentinel owner (e.g. `other:mempool-feeder`) to keep a
4
+ * background producer's spans out of the per-test view.
5
+ */
6
+ export declare function withTestSpanOwner<T>(owner: string, fn: () => Promise<T>): Promise<T>;
7
+ /** One recorded span occurrence on the process-wide `performance.now()` clock. */
8
+ export type TimingSpan = {
9
+ /** Full name of the test running when the span started, or `null` if inside a beforeAll/afterAll hook. */
10
+ owner: string | null;
11
+ /** Stable `category:label` tag, aggregated across occurrences (e.g. `wait:checkpoint`, `setup:node`). */
12
+ name: string;
13
+ /** `performance.now()` at span start. */
14
+ start: number;
15
+ /** `performance.now()` at span end. */
16
+ end: number;
17
+ };
18
+ /**
19
+ * The collector shared by the timing environment on `globalThis.__e2eTimings`. `current` is the full
20
+ * name of the test currently running (`null` during beforeAll/afterAll); the environment sets it. The
21
+ * `spans` array accumulates every recorded span until the environment folds it into the per-test /
22
+ * per-suite JSONL line at flush.
23
+ */
24
+ export type SpanCollector = {
25
+ /** Full name of the running test, or `null` during a beforeAll/afterAll hook. */
26
+ current: string | null;
27
+ /** All recorded spans, drained by the timing environment at flush time. */
28
+ spans: TimingSpan[];
29
+ };
30
+ /**
31
+ * Times `fn` and records a span tagged `name`, attributed to the test (or suite) running when it
32
+ * started. The span is recorded even when `fn` throws. Pure passthrough: when no collector is
33
+ * installed (i.e. `TEST_TIMING_FILE` is unset) this calls `fn()` directly with zero overhead.
34
+ *
35
+ * Use stable `category:label` tags and prefer wrapping at the leaf wait/setup/tx level — labels are
36
+ * forever aggregation keys, and leaf-level tagging keeps spans additive. See `SPEEDUP_FOLLOWUPS` and
37
+ * the A-1179 design doc for the tag taxonomy.
38
+ */
39
+ export declare function testSpan<T>(name: string, fn: () => Promise<T>): Promise<T>;
40
+ /** Synchronous variant of {@link testSpan} for non-async helpers. Same zero-cost guarantee when unset. */
41
+ export declare function testSpanSync<T>(name: string, fn: () => T): T;
42
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltaW5nLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZml4dHVyZXMvdGltaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQXNCQTs7OztHQUlHO0FBQ0gsd0JBQWdCLGlCQUFpQixDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxNQUFNLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBRXBGO0FBRUQsa0ZBQWtGO0FBQ2xGLE1BQU0sTUFBTSxVQUFVLEdBQUc7SUFDdkIsMEdBQTBHO0lBQzFHLEtBQUssRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUFDO0lBQ3JCLHlHQUF5RztJQUN6RyxJQUFJLEVBQUUsTUFBTSxDQUFDO0lBQ2IseUNBQXlDO0lBQ3pDLEtBQUssRUFBRSxNQUFNLENBQUM7SUFDZCx1Q0FBdUM7SUFDdkMsR0FBRyxFQUFFLE1BQU0sQ0FBQztDQUNiLENBQUM7QUFFRjs7Ozs7R0FLRztBQUNILE1BQU0sTUFBTSxhQUFhLEdBQUc7SUFDMUIsaUZBQWlGO0lBQ2pGLE9BQU8sRUFBRSxNQUFNLEdBQUcsSUFBSSxDQUFDO0lBQ3ZCLDJFQUEyRTtJQUMzRSxLQUFLLEVBQUUsVUFBVSxFQUFFLENBQUM7Q0FDckIsQ0FBQztBQU1GOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQXNCLFFBQVEsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsTUFBTSxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQVloRjtBQUVELDBHQUEwRztBQUMxRyx3QkFBZ0IsWUFBWSxDQUFDLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLEVBQUUsRUFBRSxNQUFNLENBQUMsR0FBRyxDQUFDLENBWTVEIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/fixtures/timing.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEpF;AAED,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACvB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yGAAyG;IACzG,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,iFAAiF;IACjF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYhF;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAY5D"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * E2e span instrumentation. Wrapping a shared test helper in {@link testSpan} / {@link testSpanSync}
3
+ * records how long it ran, attributed to the test (or suite) that was executing, so a full CI run can
4
+ * be aggregated into a ranked list of where the suite spends wall-clock (setup, protocol waits, client
5
+ * proving, warp scans, ...). See the A-1178 timing environment in `shared/timing_env.mjs`.
6
+ *
7
+ * Everything here is gated on the collector installed by that environment, which only exists when
8
+ * `TEST_TIMING_FILE` is set. When it is unset, {@link testSpan} calls `fn()` directly with no extra work
9
+ * and no clock reads — instrumentation is exactly zero-cost and cannot change a test's behavior or
10
+ * timing.
11
+ */ import { AsyncLocalStorage } from 'node:async_hooks';
12
+ /**
13
+ * Async-context owner override. A span normally attributes itself to the running test
14
+ * (`collector.current`), but a background producer (e.g. the mempool feeder) runs interleaved with
15
+ * arbitrary tests, so its spans would smear across whichever test happened to be current when each
16
+ * round fired. Running such work inside {@link withTestSpanOwner} pins every span in that async call
17
+ * tree to a fixed owner instead — isolated by async context from concurrent test-body spans.
18
+ */ const ownerOverride = new AsyncLocalStorage();
19
+ /**
20
+ * Runs `fn` with every {@link testSpan} inside its async call tree attributed to `owner` instead of the
21
+ * currently running test. Use a non-test sentinel owner (e.g. `other:mempool-feeder`) to keep a
22
+ * background producer's spans out of the per-test view.
23
+ */ export function withTestSpanOwner(owner, fn) {
24
+ return ownerOverride.run(owner, fn);
25
+ }
26
+ function getCollector() {
27
+ return globalThis.__e2eTimings;
28
+ }
29
+ /**
30
+ * Times `fn` and records a span tagged `name`, attributed to the test (or suite) running when it
31
+ * started. The span is recorded even when `fn` throws. Pure passthrough: when no collector is
32
+ * installed (i.e. `TEST_TIMING_FILE` is unset) this calls `fn()` directly with zero overhead.
33
+ *
34
+ * Use stable `category:label` tags and prefer wrapping at the leaf wait/setup/tx level — labels are
35
+ * forever aggregation keys, and leaf-level tagging keeps spans additive. See `SPEEDUP_FOLLOWUPS` and
36
+ * the A-1179 design doc for the tag taxonomy.
37
+ */ export async function testSpan(name, fn) {
38
+ const collector = getCollector();
39
+ if (!collector) {
40
+ return fn();
41
+ }
42
+ const owner = ownerOverride.getStore() ?? collector.current;
43
+ const start = performance.now();
44
+ try {
45
+ return await fn();
46
+ } finally{
47
+ collector.spans.push({
48
+ owner,
49
+ name,
50
+ start,
51
+ end: performance.now()
52
+ });
53
+ }
54
+ }
55
+ /** Synchronous variant of {@link testSpan} for non-async helpers. Same zero-cost guarantee when unset. */ export function testSpanSync(name, fn) {
56
+ const collector = getCollector();
57
+ if (!collector) {
58
+ return fn();
59
+ }
60
+ const owner = ownerOverride.getStore() ?? collector.current;
61
+ const start = performance.now();
62
+ try {
63
+ return fn();
64
+ } finally{
65
+ collector.spans.push({
66
+ owner,
67
+ name,
68
+ start,
69
+ end: performance.now()
70
+ });
71
+ }
72
+ }
@@ -2,11 +2,29 @@ import type { AztecAddress } from '@aztec/aztec.js/addresses';
2
2
  import type { Logger } from '@aztec/aztec.js/log';
3
3
  import type { Wallet } from '@aztec/aztec.js/wallet';
4
4
  import { TokenContract } from '@aztec/noir-contracts.js/Token';
5
+ import { TestTokenContract } from '@aztec/noir-test-contracts.js/TestToken';
6
+ /**
7
+ * Either token flavour. Canonical `TokenContract` uses constrained message delivery (production / docs
8
+ * source of truth); `TestTokenContract` is its codegen'd unconstrained-delivery sibling, used by tests
9
+ * where a token is just a unit-of-account vehicle. The two share an identical ABI, so helpers that only
10
+ * read balances or mint accept either.
11
+ */
12
+ export type AnyTokenContract = TokenContract | TestTokenContract;
5
13
  export declare function deployToken(wallet: Wallet, admin: AztecAddress, initialAdminBalance: bigint, logger: Logger): Promise<{
6
14
  contract: TokenContract;
7
15
  instance: import("@aztec/aztec.js/contracts").ContractInstanceWithAddress;
8
16
  }>;
9
- export declare function mintTokensToPrivate(token: TokenContract, minter: AztecAddress, recipient: AztecAddress, amount: bigint, additionalScopes?: AztecAddress[]): Promise<void>;
10
- export declare function expectTokenBalance(wallet: Wallet, token: TokenContract, owner: AztecAddress, expectedBalance: bigint, logger: Logger): Promise<void>;
11
- export declare function mintNotes(wallet: Wallet, minter: AztecAddress, recipient: AztecAddress, asset: TokenContract, noteAmounts: bigint[]): Promise<bigint>;
12
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9rZW5fdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9maXh0dXJlcy90b2tlbl91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU5RCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNsRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFL0Qsd0JBQXNCLFdBQVcsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxZQUFZLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNOzs7R0Fhakg7QUFFRCx3QkFBc0IsbUJBQW1CLENBQ3ZDLEtBQUssRUFBRSxhQUFhLEVBQ3BCLE1BQU0sRUFBRSxZQUFZLEVBQ3BCLFNBQVMsRUFBRSxZQUFZLEVBQ3ZCLE1BQU0sRUFBRSxNQUFNLEVBQ2QsZ0JBQWdCLENBQUMsRUFBRSxZQUFZLEVBQUUsaUJBR2xDO0FBRUQsd0JBQXNCLGtCQUFrQixDQUN0QyxNQUFNLEVBQUUsTUFBTSxFQUNkLEtBQUssRUFBRSxhQUFhLEVBQ3BCLEtBQUssRUFBRSxZQUFZLEVBQ25CLGVBQWUsRUFBRSxNQUFNLEVBQ3ZCLE1BQU0sRUFBRSxNQUFNLGlCQU9mO0FBRUQsd0JBQXNCLFNBQVMsQ0FDN0IsTUFBTSxFQUFFLE1BQU0sRUFDZCxNQUFNLEVBQUUsWUFBWSxFQUNwQixTQUFTLEVBQUUsWUFBWSxFQUN2QixLQUFLLEVBQUUsYUFBYSxFQUNwQixXQUFXLEVBQUUsTUFBTSxFQUFFLEdBQ3BCLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FXakIifQ==
17
+ /**
18
+ * Deploys the unconstrained-delivery `TestTokenContract`. Use this in tests where the token is a
19
+ * unit-of-account vehicle rather than the subject, so they don't pay constrained delivery's first-send
20
+ * handshake cost (which distorts step/log counts that benches assert on). Use {@link deployToken} when a
21
+ * test exercises canonical Token semantics or note discovery.
22
+ */
23
+ export declare function deployTestToken(wallet: Wallet, admin: AztecAddress, initialAdminBalance: bigint, logger: Logger): Promise<{
24
+ contract: TestTokenContract;
25
+ instance: import("@aztec/aztec.js/contracts").ContractInstanceWithAddress;
26
+ }>;
27
+ export declare function mintTokensToPrivate(token: AnyTokenContract, minter: AztecAddress, recipient: AztecAddress, amount: bigint, additionalScopes?: AztecAddress[]): Promise<void>;
28
+ export declare function expectTokenBalance(wallet: Wallet, token: AnyTokenContract, owner: AztecAddress, expectedBalance: bigint, logger: Logger): Promise<void>;
29
+ export declare function mintNotes(wallet: Wallet, minter: AztecAddress, recipient: AztecAddress, asset: AnyTokenContract, noteAmounts: bigint[]): Promise<bigint>;
30
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9rZW5fdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9maXh0dXJlcy90b2tlbl91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU5RCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNsRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDL0QsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFFNUU7Ozs7O0dBS0c7QUFDSCxNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsYUFBYSxHQUFHLGlCQUFpQixDQUFDO0FBRWpFLHdCQUFzQixXQUFXLENBQUMsTUFBTSxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsWUFBWSxFQUFFLG1CQUFtQixFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTTs7O0dBYWpIO0FBRUQ7Ozs7O0dBS0c7QUFDSCx3QkFBc0IsZUFBZSxDQUNuQyxNQUFNLEVBQUUsTUFBTSxFQUNkLEtBQUssRUFBRSxZQUFZLEVBQ25CLG1CQUFtQixFQUFFLE1BQU0sRUFDM0IsTUFBTSxFQUFFLE1BQU07OztHQWNmO0FBRUQsd0JBQXNCLG1CQUFtQixDQUN2QyxLQUFLLEVBQUUsZ0JBQWdCLEVBQ3ZCLE1BQU0sRUFBRSxZQUFZLEVBQ3BCLFNBQVMsRUFBRSxZQUFZLEVBQ3ZCLE1BQU0sRUFBRSxNQUFNLEVBQ2QsZ0JBQWdCLENBQUMsRUFBRSxZQUFZLEVBQUUsaUJBR2xDO0FBRUQsd0JBQXNCLGtCQUFrQixDQUN0QyxNQUFNLEVBQUUsTUFBTSxFQUNkLEtBQUssRUFBRSxnQkFBZ0IsRUFDdkIsS0FBSyxFQUFFLFlBQVksRUFDbkIsZUFBZSxFQUFFLE1BQU0sRUFDdkIsTUFBTSxFQUFFLE1BQU0saUJBT2Y7QUFFRCx3QkFBc0IsU0FBUyxDQUM3QixNQUFNLEVBQUUsTUFBTSxFQUNkLE1BQU0sRUFBRSxZQUFZLEVBQ3BCLFNBQVMsRUFBRSxZQUFZLEVBQ3ZCLEtBQUssRUFBRSxnQkFBZ0IsRUFDdkIsV0FBVyxFQUFFLE1BQU0sRUFBRSxHQUNwQixPQUFPLENBQUMsTUFBTSxDQUFDLENBV2pCIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"token_utils.d.ts","sourceRoot":"","sources":["../../src/fixtures/token_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;GAajH;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,YAAY,EAAE,iBAGlC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,iBAOf;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,CAWjB"}
1
+ {"version":3,"file":"token_utils.d.ts","sourceRoot":"","sources":["../../src/fixtures/token_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEjE,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;GAajH;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,MAAM;;;GAcf;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,YAAY,EAAE,iBAGlC;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,iBAOf;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,CAAC,CAWjB"}
@@ -1,5 +1,6 @@
1
1
  import { BatchCall } from '@aztec/aztec.js/contracts';
2
2
  import { TokenContract } from '@aztec/noir-contracts.js/Token';
3
+ import { TestTokenContract } from '@aztec/noir-test-contracts.js/TestToken';
3
4
  export async function deployToken(wallet, admin, initialAdminBalance, logger) {
4
5
  logger.info(`Deploying Token contract...`);
5
6
  const { contract, instance } = await TokenContract.deploy(wallet, admin, 'TokenName', 'TokenSymbol', 18).send({
@@ -14,6 +15,25 @@ export async function deployToken(wallet, admin, initialAdminBalance, logger) {
14
15
  instance
15
16
  };
16
17
  }
18
+ /**
19
+ * Deploys the unconstrained-delivery `TestTokenContract`. Use this in tests where the token is a
20
+ * unit-of-account vehicle rather than the subject, so they don't pay constrained delivery's first-send
21
+ * handshake cost (which distorts step/log counts that benches assert on). Use {@link deployToken} when a
22
+ * test exercises canonical Token semantics or note discovery.
23
+ */ export async function deployTestToken(wallet, admin, initialAdminBalance, logger) {
24
+ logger.info(`Deploying TestToken contract...`);
25
+ const { contract, instance } = await TestTokenContract.deploy(wallet, admin, 'TokenName', 'TokenSymbol', 18).send({
26
+ from: admin
27
+ });
28
+ if (initialAdminBalance > 0n) {
29
+ await mintTokensToPrivate(contract, admin, admin, initialAdminBalance);
30
+ }
31
+ logger.info('L2 contract deployed');
32
+ return {
33
+ contract,
34
+ instance
35
+ };
36
+ }
17
37
  export async function mintTokensToPrivate(token, minter, recipient, amount, additionalScopes) {
18
38
  await token.methods.mint_to_private(recipient, amount).send({
19
39
  from: minter,
@@ -22,7 +42,7 @@ export async function mintTokensToPrivate(token, minter, recipient, amount, addi
22
42
  }
23
43
  export async function expectTokenBalance(wallet, token, owner, expectedBalance, logger) {
24
44
  // Then check the balance
25
- const contractWithWallet = TokenContract.at(token.address, wallet);
45
+ const contractWithWallet = token.withWallet(wallet);
26
46
  const { result: balance } = await contractWithWallet.methods.balance_of_private(owner).simulate({
27
47
  from: owner
28
48
  });
@@ -0,0 +1,135 @@
1
+ import type { WaitOpts } from '@aztec/aztec.js/contracts';
2
+ import type { Fr } from '@aztec/aztec.js/fields';
3
+ import type { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
4
+ import type { Sequencer, SequencerState } from '@aztec/sequencer-client';
5
+ import type { L2BlockTag } from '@aztec/stdlib/block';
6
+ import type { AztecNode, CheckpointTag } from '@aztec/stdlib/interfaces/client';
7
+ import type { L2ToL1MembershipWitness } from '@aztec/stdlib/messaging';
8
+ import type { TxHash, TxReceipt, TxStatus } from '@aztec/stdlib/tx';
9
+ /** Options for the block-number polling helpers. */
10
+ export type WaitForBlockOpts = {
11
+ /** Which chain tip to read; defaults to 'proposed'. */
12
+ tag?: L2BlockTag;
13
+ /** How the node's block number must relate to `target`; defaults to `(actual, target) => actual >= target`. */
14
+ compare?: (actual: number, target: number) => boolean;
15
+ /** Seconds before the poll rejects; defaults to 60. */
16
+ timeout?: number;
17
+ /** Seconds between polls; defaults to 0.25. */
18
+ interval?: number;
19
+ };
20
+ /**
21
+ * Polls `node.getBlockNumber(tag)` until `opts.compare(actual, target)` holds (default `>=`). Replaces
22
+ * the ad-hoc `retryUntil(() => node.getBlockNumber(tag) <op> target)` polls scattered across the suite,
23
+ * where the node may sync forward or prune backward — the caller passes the comparator for whichever it
24
+ * expects.
25
+ * @returns The block number once the comparison holds.
26
+ */
27
+ export declare function waitForBlockNumber(node: AztecNode, target: number, opts?: WaitForBlockOpts): Promise<BlockNumber>;
28
+ /** Convenience for {@link waitForBlockNumber} on the proven tip. */
29
+ export declare function waitForProvenBlock(node: AztecNode, target: number, opts?: Omit<WaitForBlockOpts, 'tag'>): Promise<BlockNumber>;
30
+ /** Compares the node's checkpoint number against the target; defaults to `>=`. */
31
+ export type CheckpointComparator = (actual: number, target: number) => boolean;
32
+ /** Options for {@link waitForNodeCheckpoint}. */
33
+ export type WaitForCheckpointOpts = {
34
+ /** Which checkpoint tip to read; defaults to 'checkpointed'. */
35
+ tag?: CheckpointTag;
36
+ /** How the node's checkpoint number must relate to `target`; defaults to `(actual, target) => actual >= target`. */
37
+ compare?: CheckpointComparator;
38
+ /** Seconds before the poll rejects; defaults to 30. */
39
+ timeout?: number;
40
+ /** Seconds between polls; defaults to 0.5. */
41
+ interval?: number;
42
+ };
43
+ /**
44
+ * Polls a single node's checkpoint number until `opts.compare(actual, target)` holds. Replaces the
45
+ * `retryUntil(() => node.getChainTips().then(tips => tips.<tag>.checkpoint.number <op> target))` polls
46
+ * duplicated across the reorg/proving tests, where the node may sync forward, prune backward, or land
47
+ * exactly on a value — the caller passes the comparator lambda for whichever it expects.
48
+ * @returns The node's checkpoint number once the comparison holds.
49
+ */
50
+ export declare function waitForNodeCheckpoint(node: AztecNode, target: number, opts?: WaitForCheckpointOpts): Promise<CheckpointNumber>;
51
+ /** Convenience for {@link waitForNodeCheckpoint} on the proven tip. */
52
+ export declare function waitForNodeProvenCheckpoint(node: AztecNode, target: number, opts?: Omit<WaitForCheckpointOpts, 'tag'>): Promise<CheckpointNumber>;
53
+ /**
54
+ * Waits for all of `txHashes` to reach the desired status on `node`. The plural form of
55
+ * {@link waitForTx}; resolves with the receipts in input order.
56
+ */
57
+ export declare function waitForTxs(node: AztecNode, txHashes: TxHash[], opts?: WaitOpts): Promise<TxReceipt[]>;
58
+ /** Options for {@link waitForBlocksAtSlots}. */
59
+ export type WaitForBlocksAtSlotsOpts = {
60
+ /** Block number to start scanning from; defaults to the initial L2 block. */
61
+ from?: BlockNumber;
62
+ /** How many blocks to fetch per poll; defaults to 10. */
63
+ limit?: number;
64
+ /** Seconds before the poll rejects; defaults to 20. */
65
+ timeout?: number;
66
+ /** Seconds between polls; defaults to 0.25. */
67
+ interval?: number;
68
+ };
69
+ /**
70
+ * Polls `node.getBlocks` until every slot in `slots` is present among the fetched blocks' slot
71
+ * numbers. Replaces the hand-rolled `retryUntil` over `getBlocks(...).map(getSlot)` membership check.
72
+ */
73
+ export declare function waitForBlocksAtSlots(node: AztecNode, slots: SlotNumber[], opts?: WaitForBlocksAtSlotsOpts): Promise<void>;
74
+ /**
75
+ * Polls `node.getL2ToL1MembershipWitness(txHash, message)` until a witness is available, resolving
76
+ * with it. Wraps the `retryUntil` the cross-chain tests hand-roll while waiting for an L2-to-L1
77
+ * message's membership witness to become provable.
78
+ */
79
+ export declare function waitForL2ToL1Witness(node: AztecNode, txHash: TxHash, message: Fr, opts?: {
80
+ timeout?: number;
81
+ interval?: number;
82
+ }): Promise<L2ToL1MembershipWitness>;
83
+ /** Options for the tx-receipt polling helpers. */
84
+ export type WaitForTxReceiptOpts = {
85
+ /** Seconds before the poll rejects; defaults to 30. */
86
+ timeout?: number;
87
+ /** Seconds between polls; defaults to 0.25. */
88
+ interval?: number;
89
+ };
90
+ /**
91
+ * Polls `node.getTxReceipt(txHash)` until `predicate(receipt)` holds, resolving with the receipt.
92
+ * Wraps the `retryUntil` that the block-building reorg tests hand-roll while waiting for a tx to
93
+ * transition between statuses (pruned, re-included, ...).
94
+ * @returns The receipt once the predicate holds.
95
+ */
96
+ export declare function waitForTxReceipt(node: AztecNode, txHash: TxHash, predicate: (receipt: TxReceipt) => boolean, opts?: WaitForTxReceiptOpts): Promise<TxReceipt>;
97
+ /** Polls until `node.getTxReceipt(txHash).status === status`. Thin wrapper over {@link waitForTxReceipt}. */
98
+ export declare function waitForTxStatus(node: AztecNode, txHash: TxHash, status: TxStatus, opts?: WaitForTxReceiptOpts): Promise<TxReceipt>;
99
+ /** Compares the node's pending-tx count against the target; defaults to `>=`. */
100
+ export type PendingTxCountComparator = (actual: number, target: number) => boolean;
101
+ /** Options for {@link waitForPendingTxCount}. */
102
+ export type WaitForPendingTxCountOpts = {
103
+ /** How the node's pending-tx count must relate to `target`; defaults to `(actual, target) => actual >= target`. */
104
+ compare?: PendingTxCountComparator;
105
+ /** Seconds before the poll rejects; defaults to 30. */
106
+ timeout?: number;
107
+ /** Seconds between polls; defaults to 0.25. */
108
+ interval?: number;
109
+ };
110
+ /**
111
+ * Polls `node.getPendingTxCount()` until `opts.compare(actual, target)` holds (default `>=`).
112
+ * Replaces the hand-rolled mempool-size poll in the slashing tests.
113
+ * @returns The pending-tx count once the comparison holds.
114
+ */
115
+ export declare function waitForPendingTxCount(node: AztecNode, target: number, opts?: WaitForPendingTxCountOpts): Promise<number>;
116
+ /** Options for {@link waitForSequencerState}. */
117
+ export type WaitForSequencerStateOpts = {
118
+ /** Milliseconds before the wait rejects; defaults to 30000. */
119
+ timeout?: number;
120
+ /**
121
+ * Action to run after subscribing to the sequencer but before awaiting the transition. Subscribing
122
+ * first guarantees the state change the action triggers is not missed between the action and the
123
+ * listener attaching.
124
+ */
125
+ after?: () => unknown;
126
+ };
127
+ /**
128
+ * Resolves once `sequencer` reaches `state`. Subscribes to the `state-changed` event first, then (if
129
+ * `opts.after` is given) runs the action, then resolves immediately if the sequencer is already at
130
+ * `state`, otherwise waits for the transition. The listener is cleaned up on both resolve and timeout.
131
+ * Replaces the hand-rolled `state-changed` on/off subscriptions duplicated across the fee, cross-chain,
132
+ * and keystore-reload tests.
133
+ */
134
+ export declare function waitForSequencerState(sequencer: Sequencer, state: SequencerState, opts?: WaitForSequencerStateOpts): Promise<void>;
135
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FpdF9oZWxwZXJzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZml4dHVyZXMvd2FpdF9oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzFELE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBR2pELE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUdqRyxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQW1CLGNBQWMsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzFGLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ3RELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxhQUFhLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNoRixPQUFPLEtBQUssRUFBRSx1QkFBdUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZFLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFJcEUsb0RBQW9EO0FBQ3BELE1BQU0sTUFBTSxnQkFBZ0IsR0FBRztJQUM3Qix1REFBdUQ7SUFDdkQsR0FBRyxDQUFDLEVBQUUsVUFBVSxDQUFDO0lBQ2pCLCtHQUErRztJQUMvRyxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLE1BQU0sS0FBSyxPQUFPLENBQUM7SUFDdEQsdURBQXVEO0lBQ3ZELE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNqQiwrQ0FBK0M7SUFDL0MsUUFBUSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ25CLENBQUM7QUFFRjs7Ozs7O0dBTUc7QUFDSCx3QkFBZ0Isa0JBQWtCLENBQUMsSUFBSSxFQUFFLFNB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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait_helpers.d.ts","sourceRoot":"","sources":["../../src/fixtures/wait_helpers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,154 @@
1
+ import { waitForTx } from '@aztec/aztec.js/node';
2
+ import { INITIAL_L2_BLOCK_NUM } from '@aztec/aztec.js/protocol';
3
+ import { promiseWithResolvers } from '@aztec/foundation/promise';
4
+ import { retryUntil } from '@aztec/foundation/retry';
5
+ import { testSpan } from './timing.js';
6
+ /**
7
+ * Polls `node.getBlockNumber(tag)` until `opts.compare(actual, target)` holds (default `>=`). Replaces
8
+ * the ad-hoc `retryUntil(() => node.getBlockNumber(tag) <op> target)` polls scattered across the suite,
9
+ * where the node may sync forward or prune backward — the caller passes the comparator for whichever it
10
+ * expects.
11
+ * @returns The block number once the comparison holds.
12
+ */ export function waitForBlockNumber(node, target, opts = {}) {
13
+ const tag = opts.tag ?? 'proposed';
14
+ const compare = opts.compare ?? ((actual, target)=>actual >= target);
15
+ return testSpan(`wait:${tag}`, ()=>// Wrap the matched value: retryUntil treats any falsy return as "keep polling", so a legitimate
16
+ // match of block 0 (e.g. a freshly-pruned tip) would otherwise loop until timeout.
17
+ retryUntil(async ()=>{
18
+ const blockNumber = await node.getBlockNumber(tag);
19
+ return compare(blockNumber, target) ? {
20
+ blockNumber
21
+ } : undefined;
22
+ }, `block ${tag} ${compare} ${target}`, opts.timeout ?? 60, opts.interval ?? 0.25).then(({ blockNumber })=>blockNumber));
23
+ }
24
+ /** Convenience for {@link waitForBlockNumber} on the proven tip. */ export function waitForProvenBlock(node, target, opts = {}) {
25
+ return waitForBlockNumber(node, target, {
26
+ ...opts,
27
+ tag: 'proven'
28
+ });
29
+ }
30
+ /**
31
+ * Polls a single node's checkpoint number until `opts.compare(actual, target)` holds. Replaces the
32
+ * `retryUntil(() => node.getChainTips().then(tips => tips.<tag>.checkpoint.number <op> target))` polls
33
+ * duplicated across the reorg/proving tests, where the node may sync forward, prune backward, or land
34
+ * exactly on a value — the caller passes the comparator lambda for whichever it expects.
35
+ * @returns The node's checkpoint number once the comparison holds.
36
+ */ export function waitForNodeCheckpoint(node, target, opts = {}) {
37
+ const tag = opts.tag ?? 'checkpointed';
38
+ const compare = opts.compare ?? ((actual, target)=>actual >= target);
39
+ return testSpan(tag === 'proven' ? 'wait:proven-checkpoint' : 'wait:checkpoint', ()=>// Wrap the matched value: retryUntil treats any falsy return as "keep polling", so a legitimate
40
+ // match of checkpoint 0 (e.g. proven === 0 or checkpointed <= 1 after a prune) would otherwise
41
+ // loop until timeout instead of resolving.
42
+ retryUntil(async ()=>{
43
+ const checkpointNumber = await node.getCheckpointNumber(tag);
44
+ return compare(checkpointNumber, target) ? {
45
+ checkpointNumber
46
+ } : undefined;
47
+ }, `node checkpoint ${tag} ${compare} ${target}`, opts.timeout ?? 30, opts.interval ?? 0.5).then(({ checkpointNumber })=>checkpointNumber));
48
+ }
49
+ /** Convenience for {@link waitForNodeCheckpoint} on the proven tip. */ export function waitForNodeProvenCheckpoint(node, target, opts = {}) {
50
+ return waitForNodeCheckpoint(node, target, {
51
+ ...opts,
52
+ tag: 'proven'
53
+ });
54
+ }
55
+ /**
56
+ * Waits for all of `txHashes` to reach the desired status on `node`. The plural form of
57
+ * {@link waitForTx}; resolves with the receipts in input order.
58
+ */ export function waitForTxs(node, txHashes, opts) {
59
+ const optsWithInterval = {
60
+ ...opts,
61
+ interval: opts?.interval ?? 0.25
62
+ };
63
+ return testSpan('wait:tx-mined', ()=>Promise.all(txHashes.map((txHash)=>waitForTx(node, txHash, optsWithInterval))));
64
+ }
65
+ /**
66
+ * Polls `node.getBlocks` until every slot in `slots` is present among the fetched blocks' slot
67
+ * numbers. Replaces the hand-rolled `retryUntil` over `getBlocks(...).map(getSlot)` membership check.
68
+ */ export async function waitForBlocksAtSlots(node, slots, opts = {}) {
69
+ const from = opts.from ?? INITIAL_L2_BLOCK_NUM;
70
+ const limit = opts.limit ?? 10;
71
+ await testSpan('wait:block', ()=>retryUntil(async ()=>{
72
+ const blocks = await node.getBlocks(from, limit);
73
+ const foundSlots = blocks.map((block)=>block.header.getSlot());
74
+ return slots.every((slot)=>foundSlots.includes(slot)) || undefined;
75
+ }, `blocks at slots ${slots.join(', ')}`, opts.timeout ?? 20, opts.interval ?? 0.25));
76
+ }
77
+ /**
78
+ * Polls `node.getL2ToL1MembershipWitness(txHash, message)` until a witness is available, resolving
79
+ * with it. Wraps the `retryUntil` the cross-chain tests hand-roll while waiting for an L2-to-L1
80
+ * message's membership witness to become provable.
81
+ */ export function waitForL2ToL1Witness(node, txHash, message, opts = {}) {
82
+ return testSpan('wait:l2-to-l1-witness', ()=>retryUntil(()=>node.getL2ToL1MembershipWitness(txHash, message), `L2-to-L1 membership witness for ${txHash.toString()}`, opts.timeout ?? 30, opts.interval ?? 0.25));
83
+ }
84
+ /**
85
+ * Polls `node.getTxReceipt(txHash)` until `predicate(receipt)` holds, resolving with the receipt.
86
+ * Wraps the `retryUntil` that the block-building reorg tests hand-roll while waiting for a tx to
87
+ * transition between statuses (pruned, re-included, ...).
88
+ * @returns The receipt once the predicate holds.
89
+ */ export function waitForTxReceipt(node, txHash, predicate, opts = {}) {
90
+ return testSpan('wait:tx-mined', ()=>retryUntil(async ()=>{
91
+ const receipt = await node.getTxReceipt(txHash);
92
+ return predicate(receipt) ? {
93
+ receipt
94
+ } : undefined;
95
+ }, `tx receipt for ${txHash.toString()}`, opts.timeout ?? 30, opts.interval ?? 0.25).then(({ receipt })=>receipt));
96
+ }
97
+ /** Polls until `node.getTxReceipt(txHash).status === status`. Thin wrapper over {@link waitForTxReceipt}. */ export function waitForTxStatus(node, txHash, status, opts = {}) {
98
+ return waitForTxReceipt(node, txHash, (receipt)=>receipt.status === status, opts);
99
+ }
100
+ /**
101
+ * Polls `node.getPendingTxCount()` until `opts.compare(actual, target)` holds (default `>=`).
102
+ * Replaces the hand-rolled mempool-size poll in the slashing tests.
103
+ * @returns The pending-tx count once the comparison holds.
104
+ */ export function waitForPendingTxCount(node, target, opts = {}) {
105
+ const compare = opts.compare ?? ((actual, target)=>actual >= target);
106
+ return testSpan('wait:pending-tx', ()=>// Wrap the matched value: retryUntil treats any falsy return as "keep polling", so a legitimate
107
+ // match of 0 pending txs would otherwise loop until timeout instead of resolving.
108
+ retryUntil(async ()=>{
109
+ const count = await node.getPendingTxCount();
110
+ return compare(count, target) ? {
111
+ count
112
+ } : undefined;
113
+ }, `pending tx count ${compare} ${target}`, opts.timeout ?? 30, opts.interval ?? 0.25).then(({ count })=>count));
114
+ }
115
+ /**
116
+ * Resolves once `sequencer` reaches `state`. Subscribes to the `state-changed` event first, then (if
117
+ * `opts.after` is given) runs the action, then resolves immediately if the sequencer is already at
118
+ * `state`, otherwise waits for the transition. The listener is cleaned up on both resolve and timeout.
119
+ * Replaces the hand-rolled `state-changed` on/off subscriptions duplicated across the fee, cross-chain,
120
+ * and keystore-reload tests.
121
+ */ export function waitForSequencerState(sequencer, state, opts = {}) {
122
+ return testSpan('wait:sequencer-state', ()=>waitForSequencerStateInner(sequencer, state, opts));
123
+ }
124
+ async function waitForSequencerStateInner(sequencer, state, opts) {
125
+ const timeout = opts.timeout ?? 30000;
126
+ const { promise, resolve, reject } = promiseWithResolvers();
127
+ let settled = false;
128
+ const handler = (args)=>{
129
+ if (args.newState === state) {
130
+ finish(resolve);
131
+ }
132
+ };
133
+ const timer = setTimeout(()=>finish(()=>reject(new Error(`Timeout waiting for sequencer ${state} state`))), timeout);
134
+ function finish(complete) {
135
+ if (settled) {
136
+ return;
137
+ }
138
+ settled = true;
139
+ clearTimeout(timer);
140
+ sequencer.off('state-changed', handler);
141
+ complete();
142
+ }
143
+ sequencer.on('state-changed', handler);
144
+ try {
145
+ await opts.after?.();
146
+ if (sequencer.status().state === state) {
147
+ finish(resolve);
148
+ }
149
+ await promise;
150
+ } catch (err) {
151
+ finish(()=>{});
152
+ throw err;
153
+ }
154
+ }
@@ -27,7 +27,7 @@ async function main() {
27
27
  const extraAccountSecret = Fr.fromHexString('0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef');
28
28
  const extraAccountSalt = Fr.ZERO;
29
29
  const extraAccountSigningKey = GrumpkinScalar.random();
30
- const extraAccountAddress = await getSchnorrAccountContractAddress(extraAccountSecret, extraAccountSalt, extraAccountSigningKey);
30
+ const extraAccountAddress = await getSchnorrAccountContractAddress(extraAccountSigningKey, extraAccountSalt, extraAccountSecret);
31
31
  logger.info('Starting wallet service...', {
32
32
  l1RpcUrls
33
33
  });
@@ -0,0 +1,97 @@
1
+ import type { Archiver } from '@aztec/archiver';
2
+ import type { AztecNodeConfig, AztecNodeService } from '@aztec/aztec-node';
3
+ import { AztecAddress, EthAddress } from '@aztec/aztec.js/addresses';
4
+ import { NO_WAIT } from '@aztec/aztec.js/contracts';
5
+ import { generateClaimSecret } from '@aztec/aztec.js/ethereum';
6
+ import { Fr } from '@aztec/aztec.js/fields';
7
+ import type { Logger } from '@aztec/aztec.js/log';
8
+ import { isL1ToL2MessageReady } from '@aztec/aztec.js/messaging';
9
+ import { waitForTx } from '@aztec/aztec.js/node';
10
+ import { RollupContract } from '@aztec/ethereum/contracts';
11
+ import { waitUntilL1Timestamp } from '@aztec/ethereum/l1-tx-utils';
12
+ import { asyncMap } from '@aztec/foundation/async-map';
13
+ import { BlockNumber, CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
14
+ import { timesAsync } from '@aztec/foundation/collection';
15
+ import { retryUntil } from '@aztec/foundation/retry';
16
+ import { sleep } from '@aztec/foundation/sleep';
17
+ import { executeTimeout } from '@aztec/foundation/timer';
18
+ import { TestContract } from '@aztec/noir-test-contracts.js/Test';
19
+ import type { SequencerEvents } from '@aztec/sequencer-client';
20
+ import { getSlotAtTimestamp, getTimestampForSlot } from '@aztec/stdlib/epoch-helpers';
21
+ import { GasFees } from '@aztec/stdlib/gas';
22
+ import { TxStatus } from '@aztec/stdlib/tx';
23
+ import { jest } from '@jest/globals';
24
+ import { sendL1ToL2Message } from '../../fixtures/l1_to_l2_messaging.js';
25
+ import type { EndToEndContext } from '../../fixtures/utils.js';
26
+ import { waitForBlockNumber, waitForTxs } from '../../fixtures/wait_helpers.js';
27
+ import type { TestWallet } from '../../test-wallet/test_wallet.js';
28
+ import { proveInteraction } from '../../test-wallet/utils.js';
29
+ import { type BlockProposedEvent, MULTI_VALIDATOR_BLOCK_PRODUCTION_TIMING, MultiNodeTestContext, type MultiNodeTestOpts, type RegisteredValidator, type TrackedSequencerEvent, WIDE_SLOT_TIMING, buildMockGossipValidators } from '../multi_node_test_context.js';
30
+ export declare const NODE_COUNT = 4;
31
+ export declare const TX_COUNT = 10;
32
+ /** The validator cluster + context produced by {@link setupSimpleBlockProduction}. */
33
+ export type SimpleBlockProductionFixture = {
34
+ test: MultiNodeTestContext;
35
+ context: EndToEndContext;
36
+ logger: Logger;
37
+ validators: RegisteredValidator[];
38
+ nodes: AztecNodeService[];
39
+ from: AztecAddress;
40
+ };
41
+ /** State shared by the wide-slot `it`s (handles 4 validators + prover + a wallet pointed at node 0). */
42
+ export type BlockProductionWithProverFixture = {
43
+ test: MultiNodeTestContext;
44
+ context: EndToEndContext;
45
+ logger: Logger;
46
+ rollup: RollupContract;
47
+ archiver: Archiver;
48
+ validators: RegisteredValidator[];
49
+ nodes: AztecNodeService[];
50
+ contract: TestContract;
51
+ wallet: TestWallet;
52
+ from: AztecAddress;
53
+ failEvents: TrackedSequencerEvent[];
54
+ };
55
+ /**
56
+ * Stands up the `block-production` validator cluster shared by the `MULTI_VALIDATOR_BLOCK_PRODUCTION_TIMING` tests
57
+ * (`simple`, `high_tps`): builds `nodeCount` mock-gossip validators, sets up the context with the
58
+ * block-production timing profile, spawns one validator node per validator, and returns the cluster. The
59
+ * per-test divergence (`fakeProcessingDelayPerTxMs`, `txDelayerMaxInclusionTimeIntoSlot`,
60
+ * min/maxTxsPerBlock, whether sequencers start eagerly, contract type) passes through `opts`. Mirrors
61
+ * how {@link setupBlockProductionWithProver} factors out the prover-backed setup; the test still registers its own contract.
62
+ */
63
+ export declare function setupSimpleBlockProduction(opts: {
64
+ nodeCount: number;
65
+ setupOpts?: Partial<MultiNodeTestOpts>;
66
+ nodeOpts?: Partial<AztecNodeConfig> & {
67
+ dontStartSequencer?: boolean;
68
+ };
69
+ }): Promise<SimpleBlockProductionFixture>;
70
+ /**
71
+ * Creates validators and sets up a wide-slot test context with the pipelining timing profile and a prover
72
+ * node, then starts (paused) validator nodes and points the wallet at node 0. Mirrors the per-test
73
+ * setup from the dissolved `mbps.parallel` file. The blob-promotion and pipeline-prune suites layer their
74
+ * adverse-network shape on via `mockGossipSubNetworkLatency`, `maxTxsPerCheckpoint`, `clearInheritedCoinbase`,
75
+ * and `disableCheckpointPromotionOnFirstNode`.
76
+ */
77
+ export declare function setupBlockProductionWithProver(opts: {
78
+ syncChainTip: 'proposed' | 'checkpointed';
79
+ minTxsPerBlock?: number;
80
+ maxTxsPerBlock?: number;
81
+ maxTxsPerCheckpoint?: number;
82
+ buildCheckpointIfEmpty?: boolean;
83
+ skipPushProposedBlocksToArchiver?: boolean;
84
+ /** Injects artificial mock-gossip propagation latency (ms) to model adverse network conditions. */
85
+ mockGossipSubNetworkLatency?: number;
86
+ /** Clears each validator node's inherited coinbase so it derives one from its own attester key. */
87
+ clearInheritedCoinbase?: boolean;
88
+ /**
89
+ * Disables checkpoint promotion on node 0 (`skipPromoteProposedCheckpointDuringL1Sync`), so node 0 fetches
90
+ * blobs during L1 sync while its peers promote their own proposed checkpoints and skip the blob fetch.
91
+ */
92
+ disableCheckpointPromotionOnFirstNode?: boolean;
93
+ }): Promise<BlockProductionWithProverFixture>;
94
+ /** Waits until a specific multi-block checkpoint is proven, verifying that proving succeeds with multiple-blocks-per-slot. */
95
+ export declare function waitForProvenCheckpoint(fixture: BlockProductionWithProverFixture, targetCheckpoint: CheckpointNumber): Promise<void>;
96
+ export { type Archiver, type AztecNodeConfig, type AztecNodeService, AztecAddress, EthAddress, NO_WAIT, generateClaimSecret, Fr, type Logger, isL1ToL2MessageReady, waitForTx, RollupContract, waitUntilL1Timestamp, asyncMap, BlockNumber, CheckpointNumber, SlotNumber, timesAsync, retryUntil, sleep, executeTimeout, TestContract, type SequencerEvents, getSlotAtTimestamp, getTimestampForSlot, GasFees, TxStatus, jest, sendL1ToL2Message, type EndToEndContext, waitForBlockNumber, waitForTxs, type TestWallet, proveInteraction, type BlockProposedEvent, WIDE_SLOT_TIMING, MULTI_VALIDATOR_BLOCK_PRODUCTION_TIMING, MultiNodeTestContext, type RegisteredValidator, type TrackedSequencerEvent, buildMockGossipValidators, };
97
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2V0dXAuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9tdWx0aS1ub2RlL2Jsb2NrLXByb2R1Y3Rpb24vc2V0dXAudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDaEQsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLGdCQUFnQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDM0UsT0FBTyxFQUFFLFlBQVksRUFBRSxVQUFVLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNyRSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDcEQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDL0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQzVDLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNqRCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDM0QsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDbkUsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ3ZELE9BQU8sRUFBRSxXQUFXLEVBQUUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDNUYsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzFELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsS0FBSyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDaEQsT0FBTyxF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