@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
@@ -9,9 +9,6 @@ import { timesAsync } from '@aztec/foundation/collection';
9
9
  import { retryUntil } from '@aztec/foundation/retry';
10
10
 
11
11
  import { expect, jest } from '@jest/globals';
12
- import fs from 'fs';
13
- import os from 'os';
14
- import path from 'path';
15
12
 
16
13
  import { getBootNodeUdpPort, shouldCollectMetrics } from '../../fixtures/fixtures.js';
17
14
  import { createNodes } from '../../fixtures/setup_p2p_test.js';
@@ -23,8 +20,6 @@ export const NUM_VALIDATORS = 6;
23
20
  export const NUM_TXS_PER_NODE = 4;
24
21
  export const BOOT_NODE_UDP_PORT = getBootNodeUdpPort();
25
22
 
26
- export const createReqrespDataDir = () => fs.mkdtempSync(path.join(os.tmpdir(), 'reqresp-'));
27
-
28
23
  type ReqrespOptions = {
29
24
  disableStatusHandshake?: boolean;
30
25
  };
@@ -39,7 +34,7 @@ export async function createReqrespTest(options: ReqrespOptions = {}): Promise<P
39
34
  // To collect metrics - run in aztec-packages `docker compose --profile metrics up`
40
35
  metricsPort: shouldCollectMetrics(),
41
36
  initialConfig: {
42
- ethereumSlotDuration: 8,
37
+ ethereumSlotDuration: 12,
43
38
  aztecSlotDuration: 36,
44
39
  blockDurationMs: 6000,
45
40
  minTxsPerBlock: 1,
@@ -58,25 +53,21 @@ export async function createReqrespTest(options: ReqrespOptions = {}): Promise<P
58
53
  return t;
59
54
  }
60
55
 
61
- export async function cleanupReqrespTest(params: { t: P2PNetworkTest; nodes?: AztecNodeService[]; dataDir: string }) {
62
- const { t, nodes, dataDir } = params;
56
+ export async function cleanupReqrespTest(params: { t: P2PNetworkTest; nodes?: AztecNodeService[] }) {
57
+ const { t, nodes } = params;
63
58
  if (nodes) {
64
59
  await t.stopNodes(nodes);
65
60
  }
66
61
  await t.teardown();
67
- for (let i = 0; i < NUM_VALIDATORS; i++) {
68
- fs.rmSync(`${dataDir}-${i}`, { recursive: true, force: true, maxRetries: 3 });
69
- }
70
62
  }
71
63
 
72
64
  const getNodePort = (nodeIndex: number) => BOOT_NODE_UDP_PORT + 1 + nodeIndex;
73
65
 
74
66
  export async function runReqrespTxTest(params: {
75
67
  t: P2PNetworkTest;
76
- dataDir: string;
77
68
  disableStatusHandshake?: boolean;
78
69
  }): Promise<AztecNodeService[]> {
79
- const { t, dataDir, disableStatusHandshake = false } = params;
70
+ const { t, disableStatusHandshake = false } = params;
80
71
 
81
72
  if (!t.bootstrapNodeEnr) {
82
73
  throw new Error('Bootstrap node ENR is not available');
@@ -94,7 +85,7 @@ export async function runReqrespTxTest(params: {
94
85
  NUM_VALIDATORS,
95
86
  BOOT_NODE_UDP_PORT,
96
87
  t.genesis,
97
- dataDir,
88
+ t.dataDirFor('validator'),
98
89
  shouldCollectMetrics(),
99
90
  );
100
91
 
@@ -0,0 +1,329 @@
1
+ import type { InitialAccountData } from '@aztec/accounts/testing';
2
+ import type { Archiver } from '@aztec/archiver';
3
+ import type { AztecNodeService } from '@aztec/aztec-node';
4
+ import type { AztecAddress } from '@aztec/aztec.js/addresses';
5
+ import { NO_WAIT, getContractInstanceFromInstantiationParams } from '@aztec/aztec.js/contracts';
6
+ import { Fr } from '@aztec/aztec.js/fields';
7
+ import type { Logger } from '@aztec/aztec.js/log';
8
+ import { TxHash } from '@aztec/aztec.js/tx';
9
+ import { BlockNumber, CheckpointNumber } from '@aztec/foundation/branded-types';
10
+ import { timesAsync } from '@aztec/foundation/collection';
11
+ import { Signature } from '@aztec/foundation/eth-signature';
12
+ import { retryUntil } from '@aztec/foundation/retry';
13
+ import type { SpamContract } from '@aztec/noir-test-contracts.js/Spam';
14
+ import { TestContract, TestContractArtifact } from '@aztec/noir-test-contracts.js/Test';
15
+ import { getPXEConfig, getPXEConfig as getRpcConfig } from '@aztec/pxe/server';
16
+ import type { SequencerClient } from '@aztec/sequencer-client';
17
+ import { CheckpointAttestation, ConsensusPayload, type TopicType } from '@aztec/stdlib/p2p';
18
+
19
+ import { expect } from '@jest/globals';
20
+
21
+ import { shouldCollectMetrics } from '../fixtures/fixtures.js';
22
+ import { SchnorrHardcodedKeyAccountContract } from '../fixtures/schnorr_hardcoded_account_contract.js';
23
+ import { createNodes } from '../fixtures/setup_p2p_test.js';
24
+ import { waitForTxs } from '../fixtures/wait_helpers.js';
25
+ import { type AlertConfig, GrafanaClient } from '../quality_of_service/grafana_client.js';
26
+ import { submitTxsTo } from '../shared/submit-transactions.js';
27
+ import { TestWallet } from '../test-wallet/test_wallet.js';
28
+ import { type ProvenTx, proveInteraction } from '../test-wallet/utils.js';
29
+ import { type P2PNetworkTest, WAIT_FOR_TX_TIMEOUT } from './p2p_network.js';
30
+
31
+ /** One published checkpoint as returned by the archiver, including its attestations. */
32
+ type PublishedCheckpoint = Awaited<ReturnType<Archiver['getCheckpoints']>>[number];
33
+
34
+ // submits a set of transactions to the provided Private eXecution Environment (PXE)
35
+ export const submitComplexTxsTo = async (
36
+ logger: Logger,
37
+ from: AztecAddress,
38
+ spamContract: SpamContract,
39
+ numTxs: number,
40
+ opts: { callPublic?: boolean } = {},
41
+ ) => {
42
+ const txs: TxHash[] = [];
43
+
44
+ const seed = 1234n;
45
+ const spamCount = 15;
46
+ for (let i = 0; i < numTxs; i++) {
47
+ const method = spamContract.methods.spam(seed + BigInt(i * spamCount), spamCount, !!opts.callPublic);
48
+ const { txHash } = await method.send({ from, wait: NO_WAIT });
49
+ logger.info(`Tx sent with hash ${txHash.toString()}`);
50
+ txs.push(txHash);
51
+ }
52
+ return txs;
53
+ };
54
+
55
+ // creates a wallet and submit a given number of transactions through it.
56
+ export const submitTransactions = async (
57
+ logger: Logger,
58
+ node: AztecNodeService,
59
+ numTxs: number,
60
+ fundedAccount: InitialAccountData,
61
+ ): Promise<TxHash[]> => {
62
+ const rpcConfig = getRpcConfig();
63
+ rpcConfig.proverEnabled = false;
64
+ const wallet = await TestWallet.create(
65
+ node,
66
+ // Use checkpointed chain tip to avoid anchoring on provisional blocks that the archiver can prune
67
+ // when their slot ends without a checkpoint landing on L1.
68
+ { ...getPXEConfig(), proverEnabled: false, syncChainTip: 'checkpointed' },
69
+ { loggerActorLabel: 'pxe-tx' },
70
+ );
71
+ const contract = new SchnorrHardcodedKeyAccountContract();
72
+ const fundedAccountManager = await wallet.createAccount({
73
+ secret: fundedAccount.secret,
74
+ salt: fundedAccount.salt,
75
+ contract,
76
+ });
77
+ return submitTxsTo(wallet, fundedAccountManager.address, numTxs, logger);
78
+ };
79
+
80
+ export async function prepareTransactions(
81
+ logger: Logger,
82
+ node: AztecNodeService,
83
+ numTxs: number,
84
+ fundedAccount: InitialAccountData,
85
+ ): Promise<ProvenTx[]> {
86
+ const rpcConfig = getRpcConfig();
87
+ rpcConfig.proverEnabled = false;
88
+
89
+ const wallet = await TestWallet.create(
90
+ node,
91
+ { ...getPXEConfig(), proverEnabled: false, syncChainTip: 'checkpointed' },
92
+ { loggerActorLabel: 'pxe-tx' },
93
+ );
94
+ const accountContract = new SchnorrHardcodedKeyAccountContract();
95
+ const fundedAccountManager = await wallet.createAccount({
96
+ secret: fundedAccount.secret,
97
+ salt: fundedAccount.salt,
98
+ contract: accountContract,
99
+ });
100
+
101
+ const testContractInstance = await getContractInstanceFromInstantiationParams(TestContractArtifact, {
102
+ salt: Fr.random(),
103
+ });
104
+ await wallet.registerContract(testContractInstance, TestContractArtifact);
105
+ const contract = TestContract.at(testContractInstance.address, wallet);
106
+
107
+ return timesAsync(numTxs, async () => {
108
+ const tx = await proveInteraction(wallet, contract.methods.emit_nullifier(Fr.random()), {
109
+ from: fundedAccountManager.address,
110
+ });
111
+ logger.info(`Tx prepared with hash ${tx.getTxHash()}`);
112
+ return tx;
113
+ });
114
+ }
115
+
116
+ const CHECK_ALERTS = process.env.CHECK_ALERTS === 'true';
117
+
118
+ const qosAlerts: AlertConfig[] = [
119
+ {
120
+ alert: 'SequencerTimeToCollectAttestations',
121
+ expr: 'aztec_sequencer_time_to_collect_attestations > 3500',
122
+ labels: { severity: 'error' },
123
+ for: '10m',
124
+ annotations: {},
125
+ },
126
+ ];
127
+
128
+ /** Runs the shared p2p QoS Grafana alert check when CHECK_ALERTS=true; a no-op otherwise. */
129
+ export async function maybeCheckQosAlerts(logger: Logger): Promise<void> {
130
+ if (CHECK_ALERTS) {
131
+ const checker = new GrafanaClient(logger);
132
+ await checker.runAlertCheck(qosAlerts);
133
+ }
134
+ }
135
+
136
+ /** Waits until every node's synced block number reaches the initial node's current tip. */
137
+ export async function waitForNodesToSync(t: P2PNetworkTest, nodes: AztecNodeService[]): Promise<void> {
138
+ const targetBlock = await t.ctx.aztecNode.getBlockNumber();
139
+ t.logger.warn(`Waiting for all nodes to sync to block number ${targetBlock}`);
140
+ await retryUntil(
141
+ async () => {
142
+ const blockNumbers = await Promise.all(nodes.map(node => node.getBlockNumber()));
143
+ const checkpointNumber = (await t.monitor.run()).checkpointNumber;
144
+ t.logger.info(`Current block numbers ${blockNumbers} (checkpoint number on L1 is ${checkpointNumber})`);
145
+ return blockNumbers.every(bn => bn >= targetBlock);
146
+ },
147
+ `nodes to sync to block number ${targetBlock}`,
148
+ 30,
149
+ 0.5,
150
+ );
151
+ }
152
+
153
+ /** Reads the published checkpoint containing the block that mined the given tx. */
154
+ export async function getPublishedCheckpointForTx(
155
+ node: AztecNodeService,
156
+ txHash: TxHash,
157
+ ): Promise<PublishedCheckpoint> {
158
+ const receipt = await node.getTxReceipt(txHash);
159
+ const blockNumber = receipt.blockNumber!;
160
+ const dataStore = node.getBlockSource() as Archiver;
161
+ const blockData = await dataStore.getBlockData({ number: BlockNumber(blockNumber) });
162
+ const [publishedCheckpoint] = await dataStore.getCheckpoints({ from: blockData!.checkpointNumber, limit: 1 });
163
+ return publishedCheckpoint;
164
+ }
165
+
166
+ /** Polls until the archiver has indexed the first published checkpoint, then returns it. */
167
+ export async function waitForFirstPublishedCheckpoint(
168
+ t: P2PNetworkTest,
169
+ nodes: AztecNodeService[],
170
+ timeoutSeconds = 120,
171
+ ): Promise<PublishedCheckpoint> {
172
+ const dataStore = nodes[0].getBlockSource() as Archiver;
173
+ t.logger.warn('Waiting for first checkpoint to be published and indexed by the archiver');
174
+ return await retryUntil(
175
+ async () => {
176
+ const blockNumbers = await Promise.all(nodes.map(node => node.getBlockNumber()));
177
+ const checkpointNumber = (await t.monitor.run()).checkpointNumber;
178
+ t.logger.info(`Current block numbers ${blockNumbers} (checkpoint number on L1 is ${checkpointNumber})`);
179
+ const [checkpoint] = await dataStore.getCheckpoints({ from: CheckpointNumber(1), limit: 1 });
180
+ return checkpoint;
181
+ },
182
+ 'published checkpoint to be indexed',
183
+ timeoutSeconds,
184
+ 1,
185
+ );
186
+ }
187
+
188
+ /**
189
+ * Recovers the attestation signers from a published checkpoint and asserts each one belongs to the
190
+ * validator set formed by the given nodes. Returns the recovered signer addresses so callers can add
191
+ * scenario-specific assertions (e.g. an exact signer count).
192
+ */
193
+ export async function verifyAttestationSigners(
194
+ t: P2PNetworkTest,
195
+ nodes: AztecNodeService[],
196
+ publishedCheckpoint: PublishedCheckpoint,
197
+ ): Promise<string[]> {
198
+ const signatureContext = {
199
+ chainId: t.ctx.aztecNodeConfig.l1ChainId,
200
+ rollupAddress: t.ctx.deployL1ContractsValues.l1ContractAddresses.rollupAddress,
201
+ };
202
+ const payload = ConsensusPayload.fromCheckpoint(publishedCheckpoint.checkpoint, signatureContext);
203
+ const attestations = publishedCheckpoint.attestations
204
+ .filter(a => !a.signature.isEmpty())
205
+ .map(a => new CheckpointAttestation(payload, a.signature, Signature.empty()));
206
+ const signers = await Promise.all(attestations.map(att => att.getSender()!.toString()));
207
+ t.logger.info(`Attestation signers`, { signers });
208
+
209
+ // Check that the signers found are part of the proposer nodes to ensure the archiver fetched them right
210
+ const validatorAddresses = nodes.flatMap(node =>
211
+ (node.getSequencer() as SequencerClient).validatorAddresses?.map(a => a.toString()),
212
+ );
213
+ t.logger.info(`Validator addresses`, { addresses: validatorAddresses });
214
+ for (const signer of signers) {
215
+ expect(validatorAddresses).toContain(signer);
216
+ }
217
+ return signers;
218
+ }
219
+
220
+ /** Options that parameterize {@link runGossipScenario}. */
221
+ export interface GossipScenarioOptions {
222
+ /** The initialized P2P network test (setup() + validator registration already done). */
223
+ t: P2PNetworkTest;
224
+ /** Number of validator nodes forming the committee. */
225
+ numValidators: number;
226
+ /** Base UDP port for the validator nodes. */
227
+ bootNodePort: number;
228
+ /** Transactions submitted per validator node; 0 skips tx submission entirely (e.g. the oracle test). */
229
+ txsPerNode: number;
230
+ /** Submit tx batches sequentially instead of concurrently. */
231
+ submitSequentially?: boolean;
232
+ /** Overrides for the P2P mesh-connectivity wait; unset fields fall back to waitForP2PMeshConnectivity defaults. */
233
+ mesh?: {
234
+ expectedNodeCount?: number;
235
+ timeoutSeconds?: number;
236
+ checkIntervalSeconds?: number;
237
+ topics?: TopicType[];
238
+ minMeshPeerCount?: number;
239
+ };
240
+ /** Which published checkpoint the attestation signers are read from (defaults to the first tx's block). */
241
+ checkpointSource?: 'first-tx' | 'first-published';
242
+ /** Runs after validator registration but before the validator nodes are created. */
243
+ beforeCreateNodes?: () => Promise<void>;
244
+ /** Creates extra non-validator nodes (prover/monitor) once the validator nodes exist. */
245
+ createExtraNodes?: (nodes: AztecNodeService[]) => Promise<void>;
246
+ /** Runs after the account is registered but before txs are submitted (sync waits, checkpoint waits, sleeps). */
247
+ beforeSubmit?: (nodes: AztecNodeService[]) => Promise<void>;
248
+ /** Scenario-specific verification run after attestation-signer verification (proven block, price convergence). */
249
+ afterVerify?: (nodes: AztecNodeService[]) => Promise<void>;
250
+ }
251
+
252
+ /**
253
+ * Shared skeleton for the p2p gossip tests: create the validator nodes and any extra nodes, wait for
254
+ * the mesh to form, register the account, optionally submit and mine txs, then verify the attestation
255
+ * signers of a published checkpoint. Each varying part (validator registration, extra nodes, pre-submit
256
+ * waits, scenario-specific verification) is supplied via the callbacks in {@link GossipScenarioOptions}.
257
+ * Returns the validator nodes so the caller can track them for teardown.
258
+ */
259
+ export async function runGossipScenario(opts: GossipScenarioOptions): Promise<AztecNodeService[]> {
260
+ const { t, numValidators, bootNodePort, txsPerNode } = opts;
261
+
262
+ if (!t.bootstrapNodeEnr) {
263
+ throw new Error('Bootstrap node ENR is not available');
264
+ }
265
+
266
+ await opts.beforeCreateNodes?.();
267
+
268
+ t.logger.info('Creating validator nodes');
269
+ const nodes = await createNodes(
270
+ t.ctx.aztecNodeConfig,
271
+ t.ctx.dateProvider,
272
+ t.bootstrapNodeEnr,
273
+ numValidators,
274
+ bootNodePort,
275
+ t.genesis,
276
+ t.dataDirFor('validator'),
277
+ shouldCollectMetrics(),
278
+ );
279
+
280
+ await opts.createExtraNodes?.(nodes);
281
+
282
+ t.logger.info('Waiting for nodes to connect');
283
+ await t.waitForP2PMeshConnectivity(
284
+ nodes,
285
+ opts.mesh?.expectedNodeCount ?? numValidators,
286
+ opts.mesh?.timeoutSeconds,
287
+ opts.mesh?.checkIntervalSeconds,
288
+ opts.mesh?.topics,
289
+ opts.mesh?.minMeshPeerCount,
290
+ );
291
+
292
+ // We need to create the nodes before we setup the account, because those nodes form the committee
293
+ // and blocks cannot be built without them (targetCommitteeSize is set to the number of nodes).
294
+ await t.setupAccount();
295
+
296
+ await opts.beforeSubmit?.(nodes);
297
+
298
+ let firstTxHash: TxHash | undefined;
299
+ if (txsPerNode > 0) {
300
+ t.logger.info('Submitting transactions');
301
+ const submitOne = (node: AztecNodeService) => submitTransactions(t.logger, node, txsPerNode, t.fundedAccount);
302
+ // Each submitTransactions call builds its own wallet/PXE, so submissions are independent. When run
303
+ // concurrently, Promise.all preserves node order so submitted[i] stays aligned with nodes[i].
304
+ const submitted: TxHash[][] = [];
305
+ if (opts.submitSequentially) {
306
+ for (const node of nodes) {
307
+ submitted.push(await submitOne(node));
308
+ }
309
+ } else {
310
+ submitted.push(...(await Promise.all(nodes.map(submitOne))));
311
+ }
312
+ firstTxHash = submitted[0][0];
313
+
314
+ t.logger.info('Waiting for transactions to be mined');
315
+ await waitForTxs(nodes[0], submitted.flat(), { timeout: WAIT_FOR_TX_TIMEOUT });
316
+ t.logger.info('All transactions mined');
317
+ }
318
+
319
+ const publishedCheckpoint =
320
+ opts.checkpointSource === 'first-published'
321
+ ? await waitForFirstPublishedCheckpoint(t, nodes)
322
+ : await getPublishedCheckpointForTx(nodes[0], firstTxHash!);
323
+
324
+ await verifyAttestationSigners(t, nodes, publishedCheckpoint);
325
+
326
+ await opts.afterVerify?.(nodes);
327
+
328
+ return nodes;
329
+ }
@@ -24,6 +24,7 @@ import { TokenBridgeContract } from '@aztec/noir-contracts.js/TokenBridge';
24
24
 
25
25
  import { type Hex, getContract } from 'viem';
26
26
 
27
+ import { testSpan } from '../fixtures/timing.js';
27
28
  import { mintTokensToPrivate } from '../fixtures/token_utils.js';
28
29
  import { waitForL1ToL2MessageSeen } from './wait_for_l1_to_l2_message.js';
29
30
 
@@ -43,6 +44,7 @@ export async function deployAndInitializeTokenAndBridgeContracts(
43
44
  rollupRegistryAddress: EthAddress,
44
45
  owner: AztecAddress,
45
46
  underlyingERC20Address: EthAddress,
47
+ predeployedTokenPortalAddress?: EthAddress,
46
48
  ): Promise<{
47
49
  /**
48
50
  * The L2 token contract instance.
@@ -65,23 +67,26 @@ export async function deployAndInitializeTokenAndBridgeContracts(
65
67
  */
66
68
  underlyingERC20: any;
67
69
  }> {
68
- // deploy the token portal
69
- const { address: tokenPortalAddress } = await deployL1Contract(l1Client, TokenPortalAbi, TokenPortalBytecode);
70
+ // Deploy the token portal, unless it was already deployed before the node started (under automine).
71
+ const tokenPortalAddress =
72
+ predeployedTokenPortalAddress ?? (await deployL1Contract(l1Client, TokenPortalAbi, TokenPortalBytecode)).address;
70
73
  const tokenPortal = getContract({
71
74
  address: tokenPortalAddress.toString(),
72
75
  abi: TokenPortalAbi,
73
76
  client: l1Client,
74
77
  });
75
78
 
76
- // deploy l2 token
77
- const { contract: token } = await TokenContract.deploy(wallet, owner, 'TokenName', 'TokenSymbol', 18).send({
78
- from: owner,
79
- });
80
-
81
- // deploy l2 token bridge and attach to the portal
82
- const { contract: bridge } = await TokenBridgeContract.deploy(wallet, token.address, tokenPortalAddress).send({
83
- from: owner,
84
- });
79
+ // Deploy the L2 token and its bridge concurrently so they share a slot: the bridge takes the token
80
+ // address as a constructor arg, but that address is known deterministically before the token deploy
81
+ // mines, and the bridge's constructor only stores it without calling into the token.
82
+ const tokenDeploy = TokenContract.deploy(wallet, owner, 'TokenName', 'TokenSymbol', 18, { deployer: owner });
83
+ const tokenAddress = await tokenDeploy.getAddress();
84
+ const [{ contract: token }, { contract: bridge }] = await Promise.all([
85
+ testSpan('deploy:token', () => tokenDeploy.send({ from: owner })),
86
+ testSpan('deploy:bridge', () =>
87
+ TokenBridgeContract.deploy(wallet, tokenAddress, tokenPortalAddress).send({ from: owner }),
88
+ ),
89
+ ]);
85
90
 
86
91
  if ((await token.methods.get_admin().simulate({ from: owner })).result !== owner.toBigInt()) {
87
92
  throw new Error(`Token admin is not ${owner}`);
@@ -135,6 +140,7 @@ export class CrossChainTestHarness {
135
140
  ownerAddress: AztecAddress,
136
141
  logger: Logger,
137
142
  underlyingERC20Address: EthAddress,
143
+ predeployedTokenPortalAddress?: EthAddress,
138
144
  ): Promise<CrossChainTestHarness> {
139
145
  const ethAccount = EthAddress.fromString((await l1Client.getAddresses())[0]);
140
146
  const l1ContractAddresses = (await aztecNode.getNodeInfo()).l1ContractAddresses;
@@ -147,6 +153,7 @@ export class CrossChainTestHarness {
147
153
  l1ContractAddresses.registryAddress,
148
154
  ownerAddress,
149
155
  underlyingERC20Address,
156
+ predeployedTokenPortalAddress,
150
157
  );
151
158
  logger.info('Deployed and initialized token, portal and its bridge.');
152
159
 
@@ -237,11 +244,13 @@ export class CrossChainTestHarness {
237
244
 
238
245
  async mintTokensPublicOnL2(amount: bigint) {
239
246
  this.logger.info('Minting tokens on L2 publicly');
240
- await this.l2Token.methods.mint_to_public(this.ownerAddress, amount).send({ from: this.ownerAddress });
247
+ await testSpan('tx:mint', () =>
248
+ this.l2Token.methods.mint_to_public(this.ownerAddress, amount).send({ from: this.ownerAddress }),
249
+ );
241
250
  }
242
251
 
243
252
  async mintTokensPrivateOnL2(amount: bigint) {
244
- await mintTokensToPrivate(this.l2Token, this.ownerAddress, this.ownerAddress, amount);
253
+ await testSpan('tx:mint', () => mintTokensToPrivate(this.l2Token, this.ownerAddress, this.ownerAddress, amount));
245
254
  }
246
255
 
247
256
  async sendL2PublicTransfer(transferAmount: bigint, receiverAddress: AztecAddress) {
@@ -10,6 +10,7 @@ import { FeeJuiceContract } from '@aztec/noir-contracts.js/FeeJuice';
10
10
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
11
11
  import type { AztecNodeAdmin, AztecNodeDebug } from '@aztec/stdlib/interfaces/client';
12
12
 
13
+ import { testSpan } from '../fixtures/timing.js';
13
14
  import { waitForL1ToL2MessageSeen } from './wait_for_l1_to_l2_message.js';
14
15
 
15
16
  /** Aztec node that may expose the debug mining API in local e2e setups. */
@@ -159,11 +160,13 @@ export class GasBridgingTestHarness implements IGasBridgingTestHarness {
159
160
  }
160
161
 
161
162
  async bridgeFromL1ToL2(owner: AztecAddress, claimer: AztecAddress) {
162
- // Prepare the tokens on the L1 side
163
- const claim = await this.prepareTokensOnL1(owner);
163
+ await testSpan('setup:bridge', async () => {
164
+ // Prepare the tokens on the L1 side
165
+ const claim = await this.prepareTokensOnL1(owner);
164
166
 
165
- // Consume L1 -> L2 message and claim tokens privately on L2
166
- await this.consumeMessageOnAztecAndClaimPrivately(owner, claimer, claim);
167
+ // Consume L1 -> L2 message and claim tokens privately on L2
168
+ await this.consumeMessageOnAztecAndClaimPrivately(owner, claimer, claim);
169
+ });
167
170
  }
168
171
 
169
172
  private async advanceL2Block() {
@@ -181,7 +184,12 @@ export class GasBridgingTestHarness implements IGasBridgingTestHarness {
181
184
  }
182
185
 
183
186
  try {
184
- await retryUntil(async () => (await this.aztecNode.getBlockNumber()) >= initialBlockNumber + 1);
187
+ await retryUntil(
188
+ async () => (await this.aztecNode.getBlockNumber()) >= initialBlockNumber + 1,
189
+ 'gas portal block advance',
190
+ 0,
191
+ 0.25,
192
+ );
185
193
  } finally {
186
194
  if (this.aztecNodeAdmin && minTxsPerBlock !== undefined) {
187
195
  await this.aztecNodeAdmin.setConfig({ minTxsPerBlock });
@@ -1,9 +1,10 @@
1
1
  import { AztecAddress } from '@aztec/aztec.js/addresses';
2
- import { NO_WAIT } from '@aztec/aztec.js/contracts';
3
- import { Fr, GrumpkinScalar } from '@aztec/aztec.js/fields';
2
+ import { NO_WAIT, getContractInstanceFromInstantiationParams } from '@aztec/aztec.js/contracts';
3
+ import { Fr } from '@aztec/aztec.js/fields';
4
4
  import type { Logger } from '@aztec/aztec.js/log';
5
5
  import { TxHash, type TxReceipt, TxStatus } from '@aztec/aztec.js/tx';
6
6
  import { times } from '@aztec/foundation/collection';
7
+ import { TestContract, TestContractArtifact } from '@aztec/noir-test-contracts.js/Test';
7
8
 
8
9
  import type { TestWallet } from '../test-wallet/test_wallet.js';
9
10
 
@@ -14,12 +15,19 @@ export const submitTxsTo = async (
14
15
  numTxs: number,
15
16
  logger: Logger,
16
17
  ): Promise<TxHash[]> => {
18
+ // Register (without deploying) a single TestContract instance to source cheap throwaway txs from.
19
+ // emit_nullifier is #[noinitcheck], so it runs on a register-only instance — this avoids a full
20
+ // account-contract deployment per tx, which is all these callers were paying for a mined/gossiped tx.
21
+ const testContractInstance = await getContractInstanceFromInstantiationParams(TestContractArtifact, {
22
+ salt: Fr.random(),
23
+ });
24
+ await wallet.registerContract(testContractInstance, TestContractArtifact);
25
+ const contract = TestContract.at(testContractInstance.address, wallet);
26
+
17
27
  const txHashes: TxHash[] = [];
18
28
  await Promise.all(
19
29
  times(numTxs, async () => {
20
- const accountManager = await wallet.createSchnorrAccount(Fr.random(), Fr.random(), GrumpkinScalar.random());
21
- const deployMethod = await accountManager.getDeployMethod();
22
- const { txHash } = await deployMethod.send({ from: submitter, wait: NO_WAIT });
30
+ const { txHash } = await contract.methods.emit_nullifier(Fr.random()).send({ from: submitter, wait: NO_WAIT });
23
31
 
24
32
  logger.info(`Tx sent with hash ${txHash}`);
25
33
  const receipt: TxReceipt = await wallet.getTxReceipt(txHash);
@@ -0,0 +1,39 @@
1
+ /** A single recorded span occurrence on the shared `performance.now()` clock. */
2
+ export type TimingSpan = {
3
+ /** Full name of the test running when the span started, or `null` during a beforeAll/afterAll hook. */
4
+ owner?: string | null;
5
+ /** Stable `category:label` tag. */
6
+ name?: string;
7
+ /** Clock value at span start. */
8
+ start: number;
9
+ /** Clock value at span end. */
10
+ end: number;
11
+ };
12
+
13
+ /** Aggregate of one tag's occurrences. */
14
+ export type SpanAggregate = {
15
+ count: number;
16
+ totalMs: number;
17
+ busyMs: number;
18
+ maxMs: number;
19
+ };
20
+
21
+ /**
22
+ * Aggregates a list of `{ start, end }` spans of one tag into `{ count, totalMs, busyMs, maxMs }`.
23
+ * Does not mutate the input array.
24
+ */
25
+ export function aggregateSpans(spans: TimingSpan[]): SpanAggregate;
26
+
27
+ /**
28
+ * Groups `spans` by owner then tag, attaches a `spans` aggregate map to the matching record (or
29
+ * `suiteRecord` for `null`-owner spans), derives back-compat `setupFnMs` / `teardownFnMs`, drops spans
30
+ * whose owner matches no record, and returns the raw per-occurrence list (empty unless `emitSpanLines`).
31
+ */
32
+ export function foldSpansInto(
33
+ spans: TimingSpan[],
34
+ options: {
35
+ recordsByName: Map<string, Record<string, unknown>>;
36
+ suiteRecord: Record<string, unknown>;
37
+ emitSpanLines?: boolean;
38
+ },
39
+ ): { owner: string | null; name: string; ms: number }[];