@aztec/end-to-end 0.0.1-commit.b655e406 → 0.0.1-commit.c2595eba

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 (209) hide show
  1. package/dest/bench/client_flows/benchmark.d.ts +3 -2
  2. package/dest/bench/client_flows/benchmark.d.ts.map +1 -1
  3. package/dest/bench/client_flows/benchmark.js +21 -1
  4. package/dest/bench/client_flows/client_flows_benchmark.d.ts +21 -15
  5. package/dest/bench/client_flows/client_flows_benchmark.d.ts.map +1 -1
  6. package/dest/bench/client_flows/client_flows_benchmark.js +129 -119
  7. package/dest/bench/client_flows/config.d.ts +1 -1
  8. package/dest/bench/client_flows/data_extractor.d.ts +1 -1
  9. package/dest/bench/client_flows/data_extractor.js +7 -27
  10. package/dest/bench/utils.d.ts +8 -7
  11. package/dest/bench/utils.d.ts.map +1 -1
  12. package/dest/bench/utils.js +27 -18
  13. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts +6 -7
  14. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts.map +1 -1
  15. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.js +96 -112
  16. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts +19 -13
  17. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts.map +1 -1
  18. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.js +91 -70
  19. package/dest/e2e_deploy_contract/deploy_test.d.ts +5 -4
  20. package/dest/e2e_deploy_contract/deploy_test.d.ts.map +1 -1
  21. package/dest/e2e_deploy_contract/deploy_test.js +18 -13
  22. package/dest/e2e_epochs/epochs_test.d.ts +17 -9
  23. package/dest/e2e_epochs/epochs_test.d.ts.map +1 -1
  24. package/dest/e2e_epochs/epochs_test.js +48 -23
  25. package/dest/e2e_fees/bridging_race.notest.d.ts +1 -1
  26. package/dest/e2e_fees/bridging_race.notest.js +5 -7
  27. package/dest/e2e_fees/fees_test.d.ts +20 -16
  28. package/dest/e2e_fees/fees_test.d.ts.map +1 -1
  29. package/dest/e2e_fees/fees_test.js +127 -139
  30. package/dest/e2e_l1_publisher/write_json.d.ts +4 -3
  31. package/dest/e2e_l1_publisher/write_json.d.ts.map +1 -1
  32. package/dest/e2e_l1_publisher/write_json.js +18 -19
  33. package/dest/e2e_multi_validator/utils.d.ts +1 -1
  34. package/dest/e2e_multi_validator/utils.js +1 -1
  35. package/dest/e2e_nested_contract/nested_contract_test.d.ts +6 -9
  36. package/dest/e2e_nested_contract/nested_contract_test.d.ts.map +1 -1
  37. package/dest/e2e_nested_contract/nested_contract_test.js +31 -38
  38. package/dest/e2e_p2p/inactivity_slash_test.d.ts +3 -3
  39. package/dest/e2e_p2p/inactivity_slash_test.d.ts.map +1 -1
  40. package/dest/e2e_p2p/inactivity_slash_test.js +7 -6
  41. package/dest/e2e_p2p/p2p_network.d.ts +225 -18
  42. package/dest/e2e_p2p/p2p_network.d.ts.map +1 -1
  43. package/dest/e2e_p2p/p2p_network.js +121 -110
  44. package/dest/e2e_p2p/shared.d.ts +11 -11
  45. package/dest/e2e_p2p/shared.d.ts.map +1 -1
  46. package/dest/e2e_p2p/shared.js +15 -21
  47. package/dest/e2e_token_contract/token_contract_test.d.ts +16 -9
  48. package/dest/e2e_token_contract/token_contract_test.d.ts.map +1 -1
  49. package/dest/e2e_token_contract/token_contract_test.js +89 -91
  50. package/dest/fixtures/e2e_prover_test.d.ts +12 -18
  51. package/dest/fixtures/e2e_prover_test.d.ts.map +1 -1
  52. package/dest/fixtures/e2e_prover_test.js +101 -109
  53. package/dest/fixtures/fixtures.d.ts +2 -3
  54. package/dest/fixtures/fixtures.d.ts.map +1 -1
  55. package/dest/fixtures/fixtures.js +2 -3
  56. package/dest/fixtures/get_acvm_config.d.ts +1 -1
  57. package/dest/fixtures/get_acvm_config.js +1 -1
  58. package/dest/fixtures/get_bb_config.d.ts +1 -1
  59. package/dest/fixtures/get_bb_config.d.ts.map +1 -1
  60. package/dest/fixtures/index.d.ts +1 -1
  61. package/dest/fixtures/l1_to_l2_messaging.d.ts +4 -3
  62. package/dest/fixtures/l1_to_l2_messaging.d.ts.map +1 -1
  63. package/dest/fixtures/l1_to_l2_messaging.js +2 -2
  64. package/dest/fixtures/logging.d.ts +1 -1
  65. package/dest/fixtures/setup.d.ts +218 -0
  66. package/dest/fixtures/setup.d.ts.map +1 -0
  67. package/dest/fixtures/setup.js +695 -0
  68. package/dest/fixtures/setup_p2p_test.d.ts +6 -7
  69. package/dest/fixtures/setup_p2p_test.d.ts.map +1 -1
  70. package/dest/fixtures/setup_p2p_test.js +41 -28
  71. package/dest/fixtures/token_utils.d.ts +5 -2
  72. package/dest/fixtures/token_utils.d.ts.map +1 -1
  73. package/dest/fixtures/token_utils.js +13 -7
  74. package/dest/fixtures/utils.d.ts +5 -192
  75. package/dest/fixtures/utils.d.ts.map +1 -1
  76. package/dest/fixtures/utils.js +4 -648
  77. package/dest/fixtures/web3signer.d.ts +1 -1
  78. package/dest/fixtures/web3signer.js +1 -1
  79. package/dest/fixtures/with_telemetry_utils.d.ts +2 -2
  80. package/dest/fixtures/with_telemetry_utils.d.ts.map +1 -1
  81. package/dest/fixtures/with_telemetry_utils.js +2 -2
  82. package/dest/index.d.ts +1 -1
  83. package/dest/quality_of_service/grafana_client.d.ts +41 -0
  84. package/dest/quality_of_service/grafana_client.d.ts.map +1 -0
  85. package/dest/quality_of_service/{alert_checker.js → grafana_client.js} +1 -1
  86. package/dest/quality_of_service/prometheus_client.d.ts +38 -0
  87. package/dest/quality_of_service/prometheus_client.d.ts.map +1 -0
  88. package/dest/quality_of_service/prometheus_client.js +67 -0
  89. package/dest/shared/cross_chain_test_harness.d.ts +7 -6
  90. package/dest/shared/cross_chain_test_harness.d.ts.map +1 -1
  91. package/dest/shared/cross_chain_test_harness.js +14 -14
  92. package/dest/shared/gas_portal_test_harness.d.ts +2 -2
  93. package/dest/shared/gas_portal_test_harness.d.ts.map +1 -1
  94. package/dest/shared/gas_portal_test_harness.js +2 -2
  95. package/dest/shared/index.d.ts +2 -2
  96. package/dest/shared/index.d.ts.map +1 -1
  97. package/dest/shared/jest_setup.d.ts +1 -1
  98. package/dest/shared/submit-transactions.d.ts +3 -3
  99. package/dest/shared/submit-transactions.d.ts.map +1 -1
  100. package/dest/shared/submit-transactions.js +9 -11
  101. package/dest/shared/uniswap_l1_l2.d.ts +3 -27
  102. package/dest/shared/uniswap_l1_l2.d.ts.map +1 -1
  103. package/dest/shared/uniswap_l1_l2.js +55 -35
  104. package/dest/simulators/index.d.ts +1 -1
  105. package/dest/simulators/lending_simulator.d.ts +2 -2
  106. package/dest/simulators/lending_simulator.d.ts.map +1 -1
  107. package/dest/simulators/lending_simulator.js +6 -4
  108. package/dest/simulators/token_simulator.d.ts +1 -1
  109. package/dest/simulators/token_simulator.d.ts.map +1 -1
  110. package/dest/spartan/setup_test_wallets.d.ts +8 -5
  111. package/dest/spartan/setup_test_wallets.d.ts.map +1 -1
  112. package/dest/spartan/setup_test_wallets.js +85 -23
  113. package/dest/spartan/tx_metrics.d.ts +88 -0
  114. package/dest/spartan/tx_metrics.d.ts.map +1 -0
  115. package/dest/spartan/tx_metrics.js +422 -0
  116. package/dest/spartan/utils/bot.d.ts +27 -0
  117. package/dest/spartan/utils/bot.d.ts.map +1 -0
  118. package/dest/spartan/utils/bot.js +141 -0
  119. package/dest/spartan/utils/chaos.d.ts +79 -0
  120. package/dest/spartan/utils/chaos.d.ts.map +1 -0
  121. package/dest/spartan/utils/chaos.js +142 -0
  122. package/dest/spartan/utils/clients.d.ts +39 -0
  123. package/dest/spartan/utils/clients.d.ts.map +1 -0
  124. package/dest/spartan/utils/clients.js +90 -0
  125. package/dest/spartan/utils/config.d.ts +36 -0
  126. package/dest/spartan/utils/config.d.ts.map +1 -0
  127. package/dest/spartan/utils/config.js +20 -0
  128. package/dest/spartan/utils/health.d.ts +63 -0
  129. package/dest/spartan/utils/health.d.ts.map +1 -0
  130. package/dest/spartan/utils/health.js +202 -0
  131. package/dest/spartan/utils/helm.d.ts +15 -0
  132. package/dest/spartan/utils/helm.d.ts.map +1 -0
  133. package/dest/spartan/utils/helm.js +47 -0
  134. package/dest/spartan/utils/index.d.ts +9 -0
  135. package/dest/spartan/utils/index.d.ts.map +1 -0
  136. package/dest/spartan/utils/index.js +18 -0
  137. package/dest/spartan/utils/k8s.d.ts +126 -0
  138. package/dest/spartan/utils/k8s.d.ts.map +1 -0
  139. package/dest/spartan/utils/k8s.js +375 -0
  140. package/dest/spartan/utils/nodes.d.ts +41 -0
  141. package/dest/spartan/utils/nodes.d.ts.map +1 -0
  142. package/dest/spartan/utils/nodes.js +455 -0
  143. package/dest/spartan/utils/scripts.d.ts +16 -0
  144. package/dest/spartan/utils/scripts.d.ts.map +1 -0
  145. package/dest/spartan/utils/scripts.js +66 -0
  146. package/dest/spartan/utils.d.ts +2 -218
  147. package/dest/spartan/utils.d.ts.map +1 -1
  148. package/dest/spartan/utils.js +1 -749
  149. package/package.json +43 -40
  150. package/src/bench/client_flows/benchmark.ts +24 -2
  151. package/src/bench/client_flows/client_flows_benchmark.ts +152 -170
  152. package/src/bench/client_flows/data_extractor.ts +6 -28
  153. package/src/bench/utils.ts +30 -20
  154. package/src/e2e_blacklist_token_contract/blacklist_token_contract_test.ts +104 -142
  155. package/src/e2e_cross_chain_messaging/cross_chain_messaging_test.ts +140 -124
  156. package/src/e2e_deploy_contract/deploy_test.ts +22 -15
  157. package/src/e2e_epochs/epochs_test.ts +96 -56
  158. package/src/e2e_fees/bridging_race.notest.ts +5 -11
  159. package/src/e2e_fees/fees_test.ts +180 -219
  160. package/src/e2e_l1_publisher/write_json.ts +20 -19
  161. package/src/e2e_multi_validator/utils.ts +1 -1
  162. package/src/e2e_nested_contract/nested_contract_test.ts +33 -55
  163. package/src/e2e_p2p/inactivity_slash_test.ts +10 -9
  164. package/src/e2e_p2p/p2p_network.ts +181 -180
  165. package/src/e2e_p2p/shared.ts +35 -29
  166. package/src/e2e_token_contract/token_contract_test.ts +103 -118
  167. package/src/fixtures/e2e_prover_test.ts +112 -150
  168. package/src/fixtures/fixtures.ts +2 -5
  169. package/src/fixtures/get_acvm_config.ts +1 -1
  170. package/src/fixtures/l1_to_l2_messaging.ts +4 -2
  171. package/src/fixtures/setup.ts +1017 -0
  172. package/src/fixtures/setup_p2p_test.ts +38 -29
  173. package/src/fixtures/token_utils.ts +8 -7
  174. package/src/fixtures/utils.ts +27 -947
  175. package/src/fixtures/web3signer.ts +1 -1
  176. package/src/fixtures/with_telemetry_utils.ts +2 -2
  177. package/src/guides/up_quick_start.sh +1 -1
  178. package/src/quality_of_service/{alert_checker.ts → grafana_client.ts} +1 -1
  179. package/src/quality_of_service/prometheus_client.ts +113 -0
  180. package/src/shared/cross_chain_test_harness.ts +19 -36
  181. package/src/shared/gas_portal_test_harness.ts +3 -3
  182. package/src/shared/index.ts +1 -1
  183. package/src/shared/submit-transactions.ts +9 -15
  184. package/src/shared/uniswap_l1_l2.ts +65 -86
  185. package/src/simulators/lending_simulator.ts +7 -5
  186. package/src/spartan/DEVELOP.md +7 -0
  187. package/src/spartan/setup_test_wallets.ts +119 -28
  188. package/src/spartan/tx_metrics.ts +376 -0
  189. package/src/spartan/utils/bot.ts +185 -0
  190. package/src/spartan/utils/chaos.ts +253 -0
  191. package/src/spartan/utils/clients.ts +100 -0
  192. package/src/spartan/utils/config.ts +26 -0
  193. package/src/spartan/utils/health.ts +255 -0
  194. package/src/spartan/utils/helm.ts +84 -0
  195. package/src/spartan/utils/index.ts +64 -0
  196. package/src/spartan/utils/k8s.ts +527 -0
  197. package/src/spartan/utils/nodes.ts +535 -0
  198. package/src/spartan/utils/scripts.ts +63 -0
  199. package/src/spartan/utils.ts +1 -942
  200. package/dest/fixtures/setup_l1_contracts.d.ts +0 -6
  201. package/dest/fixtures/setup_l1_contracts.d.ts.map +0 -1
  202. package/dest/fixtures/setup_l1_contracts.js +0 -17
  203. package/dest/fixtures/snapshot_manager.d.ts +0 -95
  204. package/dest/fixtures/snapshot_manager.d.ts.map +0 -1
  205. package/dest/fixtures/snapshot_manager.js +0 -505
  206. package/dest/quality_of_service/alert_checker.d.ts +0 -41
  207. package/dest/quality_of_service/alert_checker.d.ts.map +0 -1
  208. package/src/fixtures/setup_l1_contracts.ts +0 -26
  209. package/src/fixtures/snapshot_manager.ts +0 -665
@@ -0,0 +1,141 @@
1
+ import { sleep } from '@aztec/foundation/sleep';
2
+ import { exec } from 'child_process';
3
+ import { promisify } from 'util';
4
+ import { execHelmCommand, forceDeleteHelmReleaseRecord, getHelmReleaseStatus, hasDeployedHelmRelease } from './helm.js';
5
+ import { deleteResourceByLabel, getChartDir, waitForResourceByLabel } from './k8s.js';
6
+ const execAsync = promisify(exec);
7
+ export async function restartBot(namespace, log) {
8
+ log.info(`Restarting bot`);
9
+ await deleteResourceByLabel({
10
+ resource: 'pods',
11
+ namespace,
12
+ label: 'app.kubernetes.io/name=bot'
13
+ });
14
+ await sleep(10 * 1000);
15
+ // Some bot images may take time to report Ready due to heavy boot-time proving.
16
+ // Waiting for PodReadyToStartContainers ensures the pod is scheduled and starting without blocking on full readiness.
17
+ await waitForResourceByLabel({
18
+ resource: 'pods',
19
+ namespace,
20
+ label: 'app.kubernetes.io/name=bot',
21
+ condition: 'PodReadyToStartContainers'
22
+ });
23
+ log.info(`Bot restarted`);
24
+ }
25
+ /**
26
+ * Installs or upgrades the transfer bot Helm release for the given namespace.
27
+ * Intended for test setup to enable L2 traffic generation only when needed.
28
+ */ export async function installTransferBot({ namespace, spartanDir, logger: log, replicas = 1, txIntervalSeconds = 10, followChain = 'PENDING', mnemonic = process.env.LABS_INFRA_MNEMONIC ?? 'test test test test test test test test test test test junk', mnemonicStartIndex, botPrivateKey = process.env.BOT_TRANSFERS_L2_PRIVATE_KEY ?? '0xcafe01', nodeUrl, timeout = '15m', reuseValues = true, aztecSlotDuration = Number(process.env.AZTEC_SLOT_DURATION ?? 12) }) {
29
+ const instanceName = `${namespace}-bot-transfers`;
30
+ const helmChartDir = getChartDir(spartanDir, 'aztec-bot');
31
+ const resolvedNodeUrl = nodeUrl ?? `http://${namespace}-rpc-aztec-node.${namespace}.svc.cluster.local:8080`;
32
+ log.info(`Installing/upgrading transfer bot: replicas=${replicas}, followChain=${followChain}`);
33
+ const values = {
34
+ 'bot.replicaCount': replicas,
35
+ 'bot.txIntervalSeconds': txIntervalSeconds,
36
+ 'bot.followChain': followChain,
37
+ 'bot.botPrivateKey': botPrivateKey,
38
+ 'bot.nodeUrl': resolvedNodeUrl,
39
+ 'bot.mnemonic': mnemonic,
40
+ 'bot.feePaymentMethod': 'fee_juice',
41
+ 'aztec.slotDuration': aztecSlotDuration,
42
+ // Ensure bot can reach its own PXE started in-process (default rpc.port is 8080)
43
+ // Note: since aztec-bot depends on aztec-node with alias `bot`, env vars go under `bot.node.env`.
44
+ 'bot.node.env.BOT_PXE_URL': 'http://127.0.0.1:8080',
45
+ // Provide L1 execution RPC for bridging fee juice
46
+ 'bot.node.env.ETHEREUM_HOSTS': `http://${namespace}-eth-execution.${namespace}.svc.cluster.local:8545`,
47
+ // Provide L1 mnemonic for bridging (falls back to labs mnemonic)
48
+ 'bot.node.env.BOT_L1_MNEMONIC': mnemonic,
49
+ // The bot does not need Kubernetes API access. Disable RBAC + ServiceAccount creation so the chart
50
+ // can be installed by users without cluster-scoped RBAC permissions.
51
+ 'bot.rbac.create': false,
52
+ 'bot.serviceAccount.create': false,
53
+ 'bot.serviceAccount.name': 'default'
54
+ };
55
+ // Ensure we derive a funded L1 key (index 0 is funded on anvil default mnemonic)
56
+ if (mnemonicStartIndex === undefined) {
57
+ values['bot.mnemonicStartIndex'] = 0;
58
+ }
59
+ // Also pass a funded private key directly if available
60
+ if (process.env.FUNDING_PRIVATE_KEY) {
61
+ values['bot.node.env.BOT_L1_PRIVATE_KEY'] = process.env.FUNDING_PRIVATE_KEY;
62
+ }
63
+ // Align bot image with the running network image: prefer env var, else detect from a validator pod
64
+ let repositoryFromEnv;
65
+ let tagFromEnv;
66
+ const aztecDockerImage = process.env.AZTEC_DOCKER_IMAGE;
67
+ if (aztecDockerImage && aztecDockerImage.includes(':')) {
68
+ const lastColon = aztecDockerImage.lastIndexOf(':');
69
+ repositoryFromEnv = aztecDockerImage.slice(0, lastColon);
70
+ tagFromEnv = aztecDockerImage.slice(lastColon + 1);
71
+ }
72
+ let repository = repositoryFromEnv;
73
+ let tag = tagFromEnv;
74
+ if (!repository || !tag) {
75
+ try {
76
+ const { stdout } = await execAsync(`kubectl get pods -l app.kubernetes.io/name=validator -n ${namespace} -o jsonpath='{.items[0].spec.containers[?(@.name=="aztec")].image}' | cat`);
77
+ const image = stdout.trim().replace(/^'|'$/g, '');
78
+ if (image && image.includes(':')) {
79
+ const lastColon = image.lastIndexOf(':');
80
+ repository = image.slice(0, lastColon);
81
+ tag = image.slice(lastColon + 1);
82
+ }
83
+ } catch (err) {
84
+ log.warn(`Could not detect aztec image from validator pod: ${String(err)}`);
85
+ }
86
+ }
87
+ if (repository && tag) {
88
+ values['global.aztecImage.repository'] = repository;
89
+ values['global.aztecImage.tag'] = tag;
90
+ }
91
+ if (mnemonicStartIndex !== undefined) {
92
+ values['bot.mnemonicStartIndex'] = typeof mnemonicStartIndex === 'string' ? mnemonicStartIndex : Number(mnemonicStartIndex);
93
+ }
94
+ // If a previous install attempt left the release in a non-deployed state (e.g. FAILED),
95
+ // `helm upgrade --install` can error with "has no deployed releases".
96
+ // In that case, clear the release record and do a clean install.
97
+ const existingStatus = await getHelmReleaseStatus(instanceName, namespace);
98
+ if (existingStatus && existingStatus.toLowerCase() !== 'deployed') {
99
+ log.warn(`Transfer bot release ${instanceName} is in status '${existingStatus}'. Reinstalling cleanly.`);
100
+ await execAsync(`helm uninstall ${instanceName} --namespace ${namespace} --wait --ignore-not-found`).catch(()=>undefined);
101
+ // If helm left the release in `uninstalling`, force-delete the record so we can reinstall.
102
+ const afterUninstallStatus = await getHelmReleaseStatus(instanceName, namespace);
103
+ if (afterUninstallStatus?.toLowerCase() === 'uninstalling') {
104
+ await forceDeleteHelmReleaseRecord(instanceName, namespace, log);
105
+ }
106
+ }
107
+ // `--reuse-values` fails if the release has never successfully deployed (e.g. first install, or a previous failed install).
108
+ // Only reuse values when we have a deployed release to reuse from.
109
+ const effectiveReuseValues = reuseValues && await hasDeployedHelmRelease(instanceName, namespace);
110
+ await execHelmCommand({
111
+ instanceName,
112
+ helmChartDir,
113
+ namespace,
114
+ valuesFile: undefined,
115
+ timeout,
116
+ values: values,
117
+ reuseValues: effectiveReuseValues
118
+ });
119
+ if (replicas > 0) {
120
+ await waitForResourceByLabel({
121
+ resource: 'pods',
122
+ namespace,
123
+ label: 'app.kubernetes.io/name=bot',
124
+ condition: 'PodReadyToStartContainers'
125
+ });
126
+ }
127
+ }
128
+ /**
129
+ * Uninstalls the transfer bot Helm release from the given namespace.
130
+ * Intended for test teardown to clean up bot resources.
131
+ */ export async function uninstallTransferBot(namespace, log) {
132
+ const instanceName = `${namespace}-bot-transfers`;
133
+ log.info(`Uninstalling transfer bot release ${instanceName}`);
134
+ await execAsync(`helm uninstall ${instanceName} --namespace ${namespace} --wait --ignore-not-found`);
135
+ // Ensure any leftover pods are removed
136
+ await deleteResourceByLabel({
137
+ resource: 'pods',
138
+ namespace,
139
+ label: 'app.kubernetes.io/name=bot'
140
+ }).catch(()=>undefined);
141
+ }
@@ -0,0 +1,79 @@
1
+ import type { Logger } from '@aztec/foundation/log';
2
+ export declare function uninstallChaosMesh(instanceName: string, namespace: string, log: Logger): Promise<void>;
3
+ /**
4
+ * Installs a Helm chart with the given parameters.
5
+ * @param instanceName - The name of the Helm chart instance.
6
+ * @param targetNamespace - The namespace with the resources to be affected by the Helm chart.
7
+ * @param valuesFile - The values file to use for the Helm chart.
8
+ * @param chaosMeshNamespace - The namespace to install the Helm chart in.
9
+ * @param timeout - The timeout for the Helm command.
10
+ * @param clean - Whether to clean up the Helm chart before installing it.
11
+ * @returns The stdout of the Helm command.
12
+ * @throws If the Helm command fails.
13
+ *
14
+ * Example usage:
15
+ * ```typescript
16
+ * const stdout = await installChaosMeshChart({ instanceName: 'force-reorg', targetNamespace: 'smoke', valuesFile: 'prover-failure.yaml'});
17
+ * console.log(stdout);
18
+ * ```
19
+ */
20
+ export declare function installChaosMeshChart({ instanceName, targetNamespace, valuesFile, helmChartDir, timeout, clean, values, logger: log }: {
21
+ instanceName: string;
22
+ targetNamespace: string;
23
+ valuesFile: string;
24
+ helmChartDir: string;
25
+ chaosMeshNamespace?: string;
26
+ timeout?: string;
27
+ clean?: boolean;
28
+ values?: Record<string, string | number>;
29
+ logger: Logger;
30
+ }): Promise<string>;
31
+ export declare function applyProverFailure({ namespace, spartanDir, durationSeconds, logger: log }: {
32
+ namespace: string;
33
+ spartanDir: string;
34
+ durationSeconds: number;
35
+ logger: Logger;
36
+ }): Promise<string>;
37
+ export declare function applyValidatorFailure({ namespace, spartanDir, logger: log, values, instanceName }: {
38
+ namespace: string;
39
+ spartanDir: string;
40
+ logger: Logger;
41
+ values?: Record<string, string | number>;
42
+ instanceName?: string;
43
+ }): Promise<string>;
44
+ export declare function applyProverKill({ namespace, spartanDir, logger: log, values }: {
45
+ namespace: string;
46
+ spartanDir: string;
47
+ logger: Logger;
48
+ values?: Record<string, string | number>;
49
+ }): Promise<string>;
50
+ export declare function applyProverBrokerKill({ namespace, spartanDir, logger: log, values }: {
51
+ namespace: string;
52
+ spartanDir: string;
53
+ logger: Logger;
54
+ values?: Record<string, string | number>;
55
+ }): Promise<string>;
56
+ export declare function applyBootNodeFailure({ instanceName, namespace, spartanDir, durationSeconds, logger: log, values }: {
57
+ instanceName?: string;
58
+ namespace: string;
59
+ spartanDir: string;
60
+ durationSeconds: number;
61
+ logger: Logger;
62
+ values?: Record<string, string | number>;
63
+ }): Promise<string>;
64
+ export declare function applyValidatorKill({ instanceName, namespace, spartanDir, logger: log, values, clean }: {
65
+ instanceName?: string;
66
+ namespace: string;
67
+ spartanDir: string;
68
+ logger: Logger;
69
+ values?: Record<string, string | number>;
70
+ clean?: boolean;
71
+ }): Promise<string>;
72
+ export declare function applyNetworkShaping({ instanceName, valuesFile, namespace, spartanDir, logger: log }: {
73
+ instanceName?: string;
74
+ valuesFile: string;
75
+ namespace: string;
76
+ spartanDir: string;
77
+ logger: Logger;
78
+ }): Promise<string>;
79
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhb3MuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zcGFydGFuL3V0aWxzL2NoYW9zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBVXBELHdCQUFzQixrQkFBa0IsQ0FBQyxZQUFZLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLE1BQU0saUJBd0I1RjtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUFDLEVBQzFDLFlBQVksRUFDWixlQUFlLEVBQ2YsVUFBVSxFQUNWLFlBQVksRUFDWixPQUFlLEVBQ2YsS0FBWSxFQUNaLE1BQVcsRUFDWCxNQUFNLEVBQUUsR0FBRyxFQUNaLEVBQUU7SUFDRCxZQUFZLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLGVBQWUsRUFBRSxNQUFNLENBQUM7SUFDeEIsVUFBVSxFQUFFLE1BQU0sQ0FBQztJQUNuQixZQUFZLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLGtCQUFrQixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQzVCLE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNqQixLQUFLLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDaEIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUFDLENBQUM7SUFDekMsTUFBTSxFQUFFLE1BQU0sQ0FBQztDQUNoQixtQkFhQTtBQUVELHdCQUFnQixrQkFBa0IsQ0FBQyxFQUNqQyxTQUFTLEVBQ1QsVUFBVSxFQUNWLGVBQWUsRUFDZixNQUFNLEVBQUUsR0FBRyxFQUNaLEVBQUU7SUFDRCxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLFVBQVUsRUFBRSxNQUFNLENBQUM7SUFDbkIsZUFBZSxFQUFFLE1BQU0sQ0FBQztJQUN4QixNQUFNLEVBQUUsTUFBTSxDQUFDO0NB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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chaos.d.ts","sourceRoot":"","sources":["../../../src/spartan/utils/chaos.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,142 @@
1
+ import { exec } from 'child_process';
2
+ import { promisify } from 'util';
3
+ import { execHelmCommand } from './helm.js';
4
+ import { deleteResourceByLabel, getChartDir } from './k8s.js';
5
+ const execAsync = promisify(exec);
6
+ export async function uninstallChaosMesh(instanceName, namespace, log) {
7
+ // uninstall the helm chart if it exists
8
+ log.info(`Uninstalling helm chart ${instanceName}`);
9
+ await execAsync(`helm uninstall ${instanceName} --namespace ${namespace} --wait --ignore-not-found`);
10
+ // and delete the chaos-mesh resources created by this release
11
+ const deleteByLabel = async (resource)=>{
12
+ const args = {
13
+ resource,
14
+ namespace: namespace,
15
+ label: `app.kubernetes.io/instance=${instanceName}`
16
+ };
17
+ log.info(`Deleting ${resource} resources for release ${instanceName}`);
18
+ await deleteResourceByLabel(args).catch((e)=>{
19
+ log.error(`Error deleting ${resource}: ${e}`);
20
+ log.info(`Force deleting ${resource}`);
21
+ return deleteResourceByLabel({
22
+ ...args,
23
+ force: true
24
+ });
25
+ });
26
+ };
27
+ await deleteByLabel('podchaos');
28
+ await deleteByLabel('networkchaos');
29
+ await deleteByLabel('podnetworkchaos');
30
+ await deleteByLabel('workflows');
31
+ await deleteByLabel('workflownodes');
32
+ }
33
+ /**
34
+ * Installs a Helm chart with the given parameters.
35
+ * @param instanceName - The name of the Helm chart instance.
36
+ * @param targetNamespace - The namespace with the resources to be affected by the Helm chart.
37
+ * @param valuesFile - The values file to use for the Helm chart.
38
+ * @param chaosMeshNamespace - The namespace to install the Helm chart in.
39
+ * @param timeout - The timeout for the Helm command.
40
+ * @param clean - Whether to clean up the Helm chart before installing it.
41
+ * @returns The stdout of the Helm command.
42
+ * @throws If the Helm command fails.
43
+ *
44
+ * Example usage:
45
+ * ```typescript
46
+ * const stdout = await installChaosMeshChart({ instanceName: 'force-reorg', targetNamespace: 'smoke', valuesFile: 'prover-failure.yaml'});
47
+ * console.log(stdout);
48
+ * ```
49
+ */ export async function installChaosMeshChart({ instanceName, targetNamespace, valuesFile, helmChartDir, timeout = '10m', clean = true, values = {}, logger: log }) {
50
+ if (clean) {
51
+ await uninstallChaosMesh(instanceName, targetNamespace, log);
52
+ }
53
+ return execHelmCommand({
54
+ instanceName,
55
+ helmChartDir,
56
+ namespace: targetNamespace,
57
+ valuesFile,
58
+ timeout,
59
+ values: {
60
+ ...values,
61
+ 'global.targetNamespace': targetNamespace
62
+ }
63
+ });
64
+ }
65
+ export function applyProverFailure({ namespace, spartanDir, durationSeconds, logger: log }) {
66
+ return installChaosMeshChart({
67
+ instanceName: 'prover-failure',
68
+ targetNamespace: namespace,
69
+ valuesFile: 'prover-failure.yaml',
70
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
71
+ values: {
72
+ 'proverFailure.duration': `${durationSeconds}s`
73
+ },
74
+ logger: log
75
+ });
76
+ }
77
+ export function applyValidatorFailure({ namespace, spartanDir, logger: log, values, instanceName }) {
78
+ return installChaosMeshChart({
79
+ instanceName: instanceName ?? 'validator-failure',
80
+ targetNamespace: namespace,
81
+ valuesFile: 'validator-failure.yaml',
82
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
83
+ values,
84
+ logger: log
85
+ });
86
+ }
87
+ export function applyProverKill({ namespace, spartanDir, logger: log, values }) {
88
+ return installChaosMeshChart({
89
+ instanceName: 'prover-kill',
90
+ targetNamespace: namespace,
91
+ valuesFile: 'prover-kill.yaml',
92
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
93
+ chaosMeshNamespace: namespace,
94
+ clean: true,
95
+ logger: log,
96
+ values
97
+ });
98
+ }
99
+ export function applyProverBrokerKill({ namespace, spartanDir, logger: log, values }) {
100
+ return installChaosMeshChart({
101
+ instanceName: 'prover-broker-kill',
102
+ targetNamespace: namespace,
103
+ valuesFile: 'prover-broker-kill.yaml',
104
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
105
+ clean: true,
106
+ logger: log,
107
+ values
108
+ });
109
+ }
110
+ export function applyBootNodeFailure({ instanceName = 'boot-node-failure', namespace, spartanDir, durationSeconds, logger: log, values }) {
111
+ return installChaosMeshChart({
112
+ instanceName,
113
+ targetNamespace: namespace,
114
+ valuesFile: 'boot-node-failure.yaml',
115
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
116
+ values: {
117
+ 'bootNodeFailure.duration': `${durationSeconds}s`,
118
+ ...values ?? {}
119
+ },
120
+ logger: log
121
+ });
122
+ }
123
+ export function applyValidatorKill({ instanceName = 'validator-kill', namespace, spartanDir, logger: log, values, clean = true }) {
124
+ return installChaosMeshChart({
125
+ instanceName: instanceName ?? 'validator-kill',
126
+ targetNamespace: namespace,
127
+ valuesFile: 'validator-kill.yaml',
128
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
129
+ clean,
130
+ logger: log,
131
+ values
132
+ });
133
+ }
134
+ export function applyNetworkShaping({ instanceName = 'network-shaping', valuesFile, namespace, spartanDir, logger: log }) {
135
+ return installChaosMeshChart({
136
+ instanceName,
137
+ targetNamespace: namespace,
138
+ valuesFile,
139
+ helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
140
+ logger: log
141
+ });
142
+ }
@@ -0,0 +1,39 @@
1
+ import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
2
+ import type { ViemPublicClient } from '@aztec/ethereum/types';
3
+ import { createAztecNodeClient } from '@aztec/stdlib/interfaces/client';
4
+ import type { ChildProcess } from 'child_process';
5
+ import type { TestConfig } from './config.js';
6
+ /**
7
+ * Returns a public viem client to the eth execution node.
8
+ * Tries external IP first, falls back to port-forward.
9
+ * If CREATE_ETH_DEVNET is false, uses the external RPC url from L1_RPC_URLS_JSON.
10
+ *
11
+ * @param env - Test environment config
12
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
13
+ * @returns URL, client, and optional process (if port-forward was used). Caller must kill process when done.
14
+ */
15
+ export declare function getPublicViemClient(env: TestConfig, forcePortForward?: boolean): Promise<{
16
+ url: string;
17
+ client: ViemPublicClient;
18
+ process?: ChildProcess;
19
+ }>;
20
+ /**
21
+ * Queries an Aztec node for the L1 deployment addresses.
22
+ *
23
+ * @param env - Test environment config
24
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
25
+ */
26
+ export declare function getL1DeploymentAddresses(env: TestConfig, forcePortForward?: boolean): Promise<L1ContractAddresses>;
27
+ /**
28
+ * Returns a client to the RPC node.
29
+ * Tries external IP first, falls back to port-forward.
30
+ *
31
+ * @param env - Test environment config
32
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
33
+ */
34
+ export declare function getNodeClient(env: TestConfig, forcePortForward?: boolean): Promise<{
35
+ node: ReturnType<typeof createAztecNodeClient>;
36
+ url: string;
37
+ process?: ChildProcess;
38
+ }>;
39
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50cy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NwYXJ0YW4vdXRpbHMvY2xpZW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQ2pGLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFOUQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFeEUsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBR2xELE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUs5Qzs7Ozs7Ozs7R0FRRztBQUNILHdCQUFzQixtQkFBbUIsQ0FDdkMsR0FBRyxFQUFFLFVBQVUsRUFDZixnQkFBZ0IsQ0FBQyxFQUFFLE9BQU8sR0FDekIsT0FBTyxDQUFDO0lBQ1QsR0FBRyxFQUFFLE1BQU0sQ0FBQztJQUNaLE1BQU0sRUFBRSxnQkFBZ0IsQ0FBQztJQUN6QixPQUFPLENBQUMsRUFBRSxZQUFZLENBQUM7Q0FDeEIsQ0FBQyxDQW1CRDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQXNCLHdCQUF3QixDQUM1QyxHQUFHLEVBQUUsVUFBVSxFQUNmLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxHQUN6QixPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0FjOUI7QUFFRDs7Ozs7O0dBTUc7QUFDSCx3QkFBc0IsYUFBYSxDQUNqQyxHQUFHLEVBQUUsVUFBVSxFQUNmLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxHQUN6QixPQUFPLENBQUM7SUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFDLE9BQU8scUJBQXFCLENBQUMsQ0FBQztJQUFDLEdBQUcsRUFBRSxNQUFNLENBQUM7SUFBQyxPQUFPLENBQUMsRUFBRSxZQUFZLENBQUE7Q0FBRSxDQUFDLENBYWxHIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../../src/spartan/utils/clients.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC,CAmBD;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,UAAU,EACf,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAalG"}
@@ -0,0 +1,90 @@
1
+ import { createLogger } from '@aztec/aztec.js/log';
2
+ import { makeBackoff, retry } from '@aztec/foundation/retry';
3
+ import { createAztecNodeClient } from '@aztec/stdlib/interfaces/client';
4
+ import { createPublicClient, fallback, http } from 'viem';
5
+ import { getEthereumEndpoint, getRPCEndpoint } from './k8s.js';
6
+ const logger = createLogger('e2e:k8s-utils');
7
+ /**
8
+ * Returns a public viem client to the eth execution node.
9
+ * Tries external IP first, falls back to port-forward.
10
+ * If CREATE_ETH_DEVNET is false, uses the external RPC url from L1_RPC_URLS_JSON.
11
+ *
12
+ * @param env - Test environment config
13
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
14
+ * @returns URL, client, and optional process (if port-forward was used). Caller must kill process when done.
15
+ */ export async function getPublicViemClient(env, forcePortForward) {
16
+ const { NAMESPACE, CREATE_ETH_DEVNET, L1_RPC_URLS_JSON } = env;
17
+ if (CREATE_ETH_DEVNET) {
18
+ logger.info(`Connecting to eth execution node in namespace ${NAMESPACE}`);
19
+ const endpoint = await getEthereumEndpoint(NAMESPACE, forcePortForward);
20
+ const client = createPublicClient({
21
+ transport: fallback([
22
+ http(endpoint.url, {
23
+ batch: false
24
+ })
25
+ ])
26
+ });
27
+ return {
28
+ url: endpoint.url,
29
+ client,
30
+ process: endpoint.process
31
+ };
32
+ } else {
33
+ logger.info(`Connecting to the eth execution node at ${L1_RPC_URLS_JSON}`);
34
+ if (!L1_RPC_URLS_JSON) {
35
+ throw new Error(`L1_RPC_URLS_JSON is not defined`);
36
+ }
37
+ const client = createPublicClient({
38
+ transport: fallback([
39
+ http(L1_RPC_URLS_JSON, {
40
+ batch: false
41
+ })
42
+ ])
43
+ });
44
+ return {
45
+ url: L1_RPC_URLS_JSON,
46
+ client
47
+ };
48
+ }
49
+ }
50
+ /**
51
+ * Queries an Aztec node for the L1 deployment addresses.
52
+ *
53
+ * @param env - Test environment config
54
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
55
+ */ export async function getL1DeploymentAddresses(env, forcePortForward) {
56
+ let endpoint;
57
+ try {
58
+ endpoint = await getRPCEndpoint(env.NAMESPACE, forcePortForward);
59
+ const node = createAztecNodeClient(endpoint.url);
60
+ return await retry(()=>node.getNodeInfo().then((i)=>i.l1ContractAddresses), 'get node info', makeBackoff([
61
+ 1,
62
+ 3,
63
+ 6
64
+ ]), logger);
65
+ } finally{
66
+ endpoint?.process?.kill();
67
+ }
68
+ }
69
+ /**
70
+ * Returns a client to the RPC node.
71
+ * Tries external IP first, falls back to port-forward.
72
+ *
73
+ * @param env - Test environment config
74
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
75
+ */ export async function getNodeClient(env, forcePortForward) {
76
+ const namespace = env.NAMESPACE;
77
+ const endpoint = await getRPCEndpoint(namespace, forcePortForward);
78
+ await retry(()=>fetch(`${endpoint.url}/status`).then((res)=>res.status === 200), 'check RPC endpoint', makeBackoff([
79
+ 1,
80
+ 1,
81
+ 2,
82
+ 6
83
+ ]), logger, true);
84
+ const client = createAztecNodeClient(endpoint.url);
85
+ return {
86
+ node: client,
87
+ url: endpoint.url,
88
+ process: endpoint.process
89
+ };
90
+ }
@@ -0,0 +1,36 @@
1
+ import { z } from 'zod';
2
+ declare const testConfigSchema: z.ZodObject<{
3
+ NAMESPACE: z.ZodDefault<z.ZodString>;
4
+ REAL_VERIFIER: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodEffects<z.ZodEffects<z.ZodNumber, 0 | 1, number>, boolean, number>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, boolean, string>]>>>;
5
+ CREATE_ETH_DEVNET: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodEffects<z.ZodEffects<z.ZodNumber, 0 | 1, number>, boolean, number>, z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, boolean, string>]>>>;
6
+ L1_RPC_URLS_JSON: z.ZodOptional<z.ZodString>;
7
+ L1_ACCOUNT_MNEMONIC: z.ZodOptional<z.ZodString>;
8
+ AZTEC_SLOT_DURATION: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
9
+ AZTEC_EPOCH_DURATION: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
10
+ AZTEC_PROOF_SUBMISSION_WINDOW: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
11
+ AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
12
+ }, "strip", z.ZodTypeAny, {
13
+ NAMESPACE: string;
14
+ REAL_VERIFIER: boolean;
15
+ CREATE_ETH_DEVNET: boolean;
16
+ L1_RPC_URLS_JSON?: string | undefined;
17
+ L1_ACCOUNT_MNEMONIC?: string | undefined;
18
+ AZTEC_SLOT_DURATION: number;
19
+ AZTEC_EPOCH_DURATION: number;
20
+ AZTEC_PROOF_SUBMISSION_WINDOW: number;
21
+ AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: number;
22
+ }, {
23
+ NAMESPACE?: string | undefined;
24
+ REAL_VERIFIER?: string | number | boolean | undefined;
25
+ CREATE_ETH_DEVNET?: string | number | boolean | undefined;
26
+ L1_RPC_URLS_JSON?: string | undefined;
27
+ L1_ACCOUNT_MNEMONIC?: string | undefined;
28
+ AZTEC_SLOT_DURATION?: number | undefined;
29
+ AZTEC_EPOCH_DURATION?: number | undefined;
30
+ AZTEC_PROOF_SUBMISSION_WINDOW?: number | undefined;
31
+ AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET?: number | undefined;
32
+ }>;
33
+ export type TestConfig = z.infer<typeof testConfigSchema>;
34
+ export declare function setupEnvironment(env: unknown): TestConfig;
35
+ export {};
36
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3BhcnRhbi91dGlscy9jb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUl4QixRQUFBLE1BQU0sZ0JBQWdCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFVcEIsQ0FBQztBQUVILE1BQU0sTUFBTSxVQUFVLEdBQUcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLGdCQUFnQixDQUFDLENBQUM7QUFFMUQsd0JBQWdCLGdCQUFnQixDQUFDLEdBQUcsRUFBRSxPQUFPLEdBQUcsVUFBVSxDQUl6RCJ9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/spartan/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAIzD"}
@@ -0,0 +1,20 @@
1
+ import { createLogger } from '@aztec/aztec.js/log';
2
+ import { schemas } from '@aztec/foundation/schemas';
3
+ import { z } from 'zod';
4
+ const logger = createLogger('e2e:k8s-utils');
5
+ const testConfigSchema = z.object({
6
+ NAMESPACE: z.string().default('scenario'),
7
+ REAL_VERIFIER: schemas.Boolean.optional().default(true),
8
+ CREATE_ETH_DEVNET: schemas.Boolean.optional().default(false),
9
+ L1_RPC_URLS_JSON: z.string().optional(),
10
+ L1_ACCOUNT_MNEMONIC: z.string().optional(),
11
+ AZTEC_SLOT_DURATION: z.coerce.number().optional().default(24),
12
+ AZTEC_EPOCH_DURATION: z.coerce.number().optional().default(32),
13
+ AZTEC_PROOF_SUBMISSION_WINDOW: z.coerce.number().optional().default(5),
14
+ AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: z.coerce.number().optional().default(2)
15
+ });
16
+ export function setupEnvironment(env) {
17
+ const config = testConfigSchema.parse(env);
18
+ logger.warn(`Loaded env config`, config);
19
+ return config;
20
+ }
@@ -0,0 +1,63 @@
1
+ import { CheckpointNumber } from '@aztec/foundation/branded-types';
2
+ import type { Logger } from '@aztec/foundation/log';
3
+ /**
4
+ * Snapshot of chain state captured during setup for comparison in teardown.
5
+ */
6
+ export interface ChainHealthSnapshot {
7
+ blockNumber: number;
8
+ checkpointNumber: CheckpointNumber;
9
+ timestamp: number;
10
+ }
11
+ /**
12
+ * Pre-flight and post-flight health checks for the Aztec network.
13
+ *
14
+ * Use in beforeAll/afterAll to validate the chain is healthy before tests run
15
+ * and verify it continued progressing during the test.
16
+ *
17
+ * @example
18
+ * ```typescript
19
+ * const health = new ChainHealth(config.NAMESPACE, logger);
20
+ *
21
+ * beforeAll(async () => {
22
+ * await health.setup();
23
+ * });
24
+ *
25
+ * afterAll(async () => {
26
+ * await health.teardown();
27
+ * });
28
+ * ```
29
+ */
30
+ export declare class ChainHealth {
31
+ private namespace;
32
+ private logger;
33
+ private snapshot?;
34
+ constructor(namespace: string, logger: Logger);
35
+ /**
36
+ * Pre-flight health check. Validates chain is in a testable state and captures
37
+ * initial state for comparison in teardown.
38
+ *
39
+ * Checks performed:
40
+ * - Node is reachable and returns valid info
41
+ * - ENR exists
42
+ * - L1 is accessible
43
+ * - At least 1 L2 block has been mined
44
+ * - Committee exists
45
+ * - At least 1 checkpoint has been reached
46
+ *
47
+ * @throws Error if any health check fails
48
+ */
49
+ setup(): Promise<void>;
50
+ /**
51
+ * Post-flight health check. Verifies the chain continued progressing during the test.
52
+ *
53
+ * For tests that ran longer than the threshold, checks:
54
+ * - Block number increased since setup
55
+ * - Checkpoint number increased since setup
56
+ *
57
+ * For shorter tests, skips the check.
58
+ *
59
+ * @throws Error if chain did not progress
60
+ */
61
+ teardown(): Promise<void>;
62
+ }
63
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVhbHRoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3BhcnRhbi91dGlscy9oZWFsdGgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFNcEQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsbUJBQW1CO0lBQ2xDLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsZ0JBQWdCLEVBQUUsZ0JBQWdCLENBQUM7SUFDbkMsU0FBUyxFQUFFLE1BQU0sQ0FBQztDQUNuQjtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrQkc7QUFDSCxxQkFBYSxXQUFXO0lBQ3RCLE9BQU8sQ0FBQyxTQUFTLENBQVM7SUFDMUIsT0FBTyxDQUFDLE1BQU0sQ0FBUztJQUN2QixPQUFPLENBQUMsUUFBUSxDQUFDLENBQXNCO0lBRXZDLFlBQVksU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUc1QztJQUVEOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDRyxLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQW1HM0I7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ0csUUFBUSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0E4RTlCO0NBQ0YifQ==
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/spartan/utils/health.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAsB;IAEvC,YAAY,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAG5C;IAED;;;;;;;;;;;;;OAaG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmG3B;IAED;;;;;;;;;;OAUG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA8E9B;CACF"}