@aztec/end-to-end 0.0.1-commit.1142ef1 → 0.0.1-commit.1bea0213

package/dest/spartan/utils/chaos.d.ts

@@ -0,0 +1,79 @@
+import type { Logger } from '@aztec/foundation/log';
+export declare function uninstallChaosMesh(instanceName: string, namespace: string, log: Logger): Promise<void>;
+/**
+ * Installs a Helm chart with the given parameters.
+ * @param instanceName - The name of the Helm chart instance.
+ * @param targetNamespace - The namespace with the resources to be affected by the Helm chart.
+ * @param valuesFile - The values file to use for the Helm chart.
+ * @param chaosMeshNamespace - The namespace to install the Helm chart in.
+ * @param timeout - The timeout for the Helm command.
+ * @param clean - Whether to clean up the Helm chart before installing it.
+ * @returns The stdout of the Helm command.
+ * @throws If the Helm command fails.
+ *
+ * Example usage:
+ * ```typescript
+ * const stdout = await installChaosMeshChart({ instanceName: 'force-reorg', targetNamespace: 'smoke', valuesFile: 'prover-failure.yaml'});
+ * console.log(stdout);
+ * ```
+ */
+export declare function installChaosMeshChart({ instanceName, targetNamespace, valuesFile, helmChartDir, timeout, clean, values, logger: log }: {
+    instanceName: string;
+    targetNamespace: string;
+    valuesFile: string;
+    helmChartDir: string;
+    chaosMeshNamespace?: string;
+    timeout?: string;
+    clean?: boolean;
+    values?: Record<string, string | number>;
+    logger: Logger;
+}): Promise<string>;
+export declare function applyProverFailure({ namespace, spartanDir, durationSeconds, logger: log }: {
+    namespace: string;
+    spartanDir: string;
+    durationSeconds: number;
+    logger: Logger;
+}): Promise<string>;
+export declare function applyValidatorFailure({ namespace, spartanDir, logger: log, values, instanceName }: {
+    namespace: string;
+    spartanDir: string;
+    logger: Logger;
+    values?: Record<string, string | number>;
+    instanceName?: string;
+}): Promise<string>;
+export declare function applyProverKill({ namespace, spartanDir, logger: log, values }: {
+    namespace: string;
+    spartanDir: string;
+    logger: Logger;
+    values?: Record<string, string | number>;
+}): Promise<string>;
+export declare function applyProverBrokerKill({ namespace, spartanDir, logger: log, values }: {
+    namespace: string;
+    spartanDir: string;
+    logger: Logger;
+    values?: Record<string, string | number>;
+}): Promise<string>;
+export declare function applyBootNodeFailure({ instanceName, namespace, spartanDir, durationSeconds, logger: log, values }: {
+    instanceName?: string;
+    namespace: string;
+    spartanDir: string;
+    durationSeconds: number;
+    logger: Logger;
+    values?: Record<string, string | number>;
+}): Promise<string>;
+export declare function applyValidatorKill({ instanceName, namespace, spartanDir, logger: log, values, clean }: {
+    instanceName?: string;
+    namespace: string;
+    spartanDir: string;
+    logger: Logger;
+    values?: Record<string, string | number>;
+    clean?: boolean;
+}): Promise<string>;
+export declare function applyNetworkShaping({ instanceName, valuesFile, namespace, spartanDir, logger: log }: {
+    instanceName?: string;
+    valuesFile: string;
+    namespace: string;
+    spartanDir: string;
+    logger: Logger;
+}): Promise<string>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhb3MuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zcGFydGFuL3V0aWxzL2NoYW9zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBVXBELHdCQUFzQixrQkFBa0IsQ0FBQyxZQUFZLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLE1BQU0saUJBd0I1RjtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsd0JBQXNCLHFCQUFxQixDQUFDLEVBQzFDLFlBQVksRUFDWixlQUFlLEVBQ2YsVUFBVSxFQUNWLFlBQVksRUFDWixPQUFlLEVBQ2YsS0FBWSxFQUNaLE1BQVcsRUFDWCxNQUFNLEVBQUUsR0FBRyxFQUNaLEVBQUU7SUFDRCxZQUFZLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLGVBQWUsRUFBRSxNQUFNLENBQUM7SUFDeEIsVUFBVSxFQUFFLE1BQU0sQ0FBQztJQUNuQixZQUFZLEVBQUUsTUFBTSxDQUFDO0lBQ3JCLGtCQUFrQixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQzVCLE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNqQixLQUFLLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDaEIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsTUFBTSxDQUFDLENBQUM7SUFDekMsTUFBTSxFQUFFLE1BQU0sQ0FBQztDQUNoQixtQkFhQTtBQUVELHdCQUFnQixrQkFBa0IsQ0FBQyxFQUNqQyxTQUFTLEVBQ1QsVUFBVSxFQUNWLGVBQWUsRUFDZixNQUFNLEVBQUUsR0FBRyxFQUNaLEVBQUU7SUFDRCxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLFVBQVUsRUFBRSxNQUFNLENBQUM7SUFDbkIsZUFBZSxFQUFFLE1BQU0sQ0FBQztJQUN4QixNQUFNLEVBQUUsTUFBTSxDQUFDO0NB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

package/dest/spartan/utils/chaos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chaos.d.ts","sourceRoot":"","sources":["../../../src/spartan/utils/chaos.ts"],"names":[],"mappings":"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"}

package/dest/spartan/utils/chaos.js

@@ -0,0 +1,142 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { execHelmCommand } from './helm.js';
+import { deleteResourceByLabel, getChartDir } from './k8s.js';
+const execAsync = promisify(exec);
+export async function uninstallChaosMesh(instanceName, namespace, log) {
+    // uninstall the helm chart if it exists
+    log.info(`Uninstalling helm chart ${instanceName}`);
+    await execAsync(`helm uninstall ${instanceName} --namespace ${namespace} --wait --ignore-not-found`);
+    // and delete the chaos-mesh resources created by this release
+    const deleteByLabel = async (resource)=>{
+        const args = {
+            resource,
+            namespace: namespace,
+            label: `app.kubernetes.io/instance=${instanceName}`
+        };
+        log.info(`Deleting ${resource} resources for release ${instanceName}`);
+        await deleteResourceByLabel(args).catch((e)=>{
+            log.error(`Error deleting ${resource}: ${e}`);
+            log.info(`Force deleting ${resource}`);
+            return deleteResourceByLabel({
+                ...args,
+                force: true
+            });
+        });
+    };
+    await deleteByLabel('podchaos');
+    await deleteByLabel('networkchaos');
+    await deleteByLabel('podnetworkchaos');
+    await deleteByLabel('workflows');
+    await deleteByLabel('workflownodes');
+}
+/**
+ * Installs a Helm chart with the given parameters.
+ * @param instanceName - The name of the Helm chart instance.
+ * @param targetNamespace - The namespace with the resources to be affected by the Helm chart.
+ * @param valuesFile - The values file to use for the Helm chart.
+ * @param chaosMeshNamespace - The namespace to install the Helm chart in.
+ * @param timeout - The timeout for the Helm command.
+ * @param clean - Whether to clean up the Helm chart before installing it.
+ * @returns The stdout of the Helm command.
+ * @throws If the Helm command fails.
+ *
+ * Example usage:
+ * ```typescript
+ * const stdout = await installChaosMeshChart({ instanceName: 'force-reorg', targetNamespace: 'smoke', valuesFile: 'prover-failure.yaml'});
+ * console.log(stdout);
+ * ```
+ */ export async function installChaosMeshChart({ instanceName, targetNamespace, valuesFile, helmChartDir, timeout = '10m', clean = true, values = {}, logger: log }) {
+    if (clean) {
+        await uninstallChaosMesh(instanceName, targetNamespace, log);
+    }
+    return execHelmCommand({
+        instanceName,
+        helmChartDir,
+        namespace: targetNamespace,
+        valuesFile,
+        timeout,
+        values: {
+            ...values,
+            'global.targetNamespace': targetNamespace
+        }
+    });
+}
+export function applyProverFailure({ namespace, spartanDir, durationSeconds, logger: log }) {
+    return installChaosMeshChart({
+        instanceName: 'prover-failure',
+        targetNamespace: namespace,
+        valuesFile: 'prover-failure.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        values: {
+            'proverFailure.duration': `${durationSeconds}s`
+        },
+        logger: log
+    });
+}
+export function applyValidatorFailure({ namespace, spartanDir, logger: log, values, instanceName }) {
+    return installChaosMeshChart({
+        instanceName: instanceName ?? 'validator-failure',
+        targetNamespace: namespace,
+        valuesFile: 'validator-failure.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        values,
+        logger: log
+    });
+}
+export function applyProverKill({ namespace, spartanDir, logger: log, values }) {
+    return installChaosMeshChart({
+        instanceName: 'prover-kill',
+        targetNamespace: namespace,
+        valuesFile: 'prover-kill.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        chaosMeshNamespace: namespace,
+        clean: true,
+        logger: log,
+        values
+    });
+}
+export function applyProverBrokerKill({ namespace, spartanDir, logger: log, values }) {
+    return installChaosMeshChart({
+        instanceName: 'prover-broker-kill',
+        targetNamespace: namespace,
+        valuesFile: 'prover-broker-kill.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        clean: true,
+        logger: log,
+        values
+    });
+}
+export function applyBootNodeFailure({ instanceName = 'boot-node-failure', namespace, spartanDir, durationSeconds, logger: log, values }) {
+    return installChaosMeshChart({
+        instanceName,
+        targetNamespace: namespace,
+        valuesFile: 'boot-node-failure.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        values: {
+            'bootNodeFailure.duration': `${durationSeconds}s`,
+            ...values ?? {}
+        },
+        logger: log
+    });
+}
+export function applyValidatorKill({ instanceName = 'validator-kill', namespace, spartanDir, logger: log, values, clean = true }) {
+    return installChaosMeshChart({
+        instanceName: instanceName ?? 'validator-kill',
+        targetNamespace: namespace,
+        valuesFile: 'validator-kill.yaml',
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        clean,
+        logger: log,
+        values
+    });
+}
+export function applyNetworkShaping({ instanceName = 'network-shaping', valuesFile, namespace, spartanDir, logger: log }) {
+    return installChaosMeshChart({
+        instanceName,
+        targetNamespace: namespace,
+        valuesFile,
+        helmChartDir: getChartDir(spartanDir, 'aztec-chaos-scenarios'),
+        logger: log
+    });
+}

package/dest/spartan/utils/clients.d.ts

@@ -0,0 +1,39 @@
+import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
+import type { ViemPublicClient } from '@aztec/ethereum/types';
+import { createAztecNodeClient } from '@aztec/stdlib/interfaces/client';
+import type { ChildProcess } from 'child_process';
+import type { TestConfig } from './config.js';
+/**
+ * Returns a public viem client to the eth execution node.
+ * Tries external IP first, falls back to port-forward.
+ * If CREATE_ETH_DEVNET is false, uses the external RPC url from L1_RPC_URLS_JSON.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ * @returns URL, client, and optional process (if port-forward was used). Caller must kill process when done.
+ */
+export declare function getPublicViemClient(env: TestConfig, forcePortForward?: boolean): Promise<{
+    url: string;
+    client: ViemPublicClient;
+    process?: ChildProcess;
+}>;
+/**
+ * Queries an Aztec node for the L1 deployment addresses.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ */
+export declare function getL1DeploymentAddresses(env: TestConfig, forcePortForward?: boolean): Promise<L1ContractAddresses>;
+/**
+ * Returns a client to the RPC node.
+ * Tries external IP first, falls back to port-forward.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ */
+export declare function getNodeClient(env: TestConfig, forcePortForward?: boolean): Promise<{
+    node: ReturnType<typeof createAztecNodeClient>;
+    url: string;
+    process?: ChildProcess;
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50cy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3NwYXJ0YW4vdXRpbHMvY2xpZW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQ2pGLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFOUQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFeEUsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBR2xELE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUs5Qzs7Ozs7Ozs7R0FRRztBQUNILHdCQUFzQixtQkFBbUIsQ0FDdkMsR0FBRyxFQUFFLFVBQVUsRUFDZixnQkFBZ0IsQ0FBQyxFQUFFLE9BQU8sR0FDekIsT0FBTyxDQUFDO0lBQ1QsR0FBRyxFQUFFLE1BQU0sQ0FBQztJQUNaLE1BQU0sRUFBRSxnQkFBZ0IsQ0FBQztJQUN6QixPQUFPLENBQUMsRUFBRSxZQUFZLENBQUM7Q0FDeEIsQ0FBQyxDQW1CRDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQXNCLHdCQUF3QixDQUM1QyxHQUFHLEVBQUUsVUFBVSxFQUNmLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxHQUN6QixPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0FjOUI7QUFFRDs7Ozs7O0dBTUc7QUFDSCx3QkFBc0IsYUFBYSxDQUNqQyxHQUFHLEVBQUUsVUFBVSxFQUNmLGdCQUFnQixDQUFDLEVBQUUsT0FBTyxHQUN6QixPQUFPLENBQUM7SUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFDLE9BQU8scUJBQXFCLENBQUMsQ0FBQztJQUFDLEdBQUcsRUFBRSxNQUFNLENBQUM7SUFBQyxPQUFPLENBQUMsRUFBRSxZQUFZLENBQUE7Q0FBRSxDQUFDLENBYWxHIn0=

package/dest/spartan/utils/clients.d.ts.map

@@ -0,0 +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"}

package/dest/spartan/utils/clients.js

@@ -0,0 +1,90 @@
+import { createLogger } from '@aztec/aztec.js/log';
+import { makeBackoff, retry } from '@aztec/foundation/retry';
+import { createAztecNodeClient } from '@aztec/stdlib/interfaces/client';
+import { createPublicClient, fallback, http } from 'viem';
+import { getEthereumEndpoint, getRPCEndpoint } from './k8s.js';
+const logger = createLogger('e2e:k8s-utils');
+/**
+ * Returns a public viem client to the eth execution node.
+ * Tries external IP first, falls back to port-forward.
+ * If CREATE_ETH_DEVNET is false, uses the external RPC url from L1_RPC_URLS_JSON.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ * @returns URL, client, and optional process (if port-forward was used). Caller must kill process when done.
+ */ export async function getPublicViemClient(env, forcePortForward) {
+    const { NAMESPACE, CREATE_ETH_DEVNET, L1_RPC_URLS_JSON } = env;
+    if (CREATE_ETH_DEVNET) {
+        logger.info(`Connecting to eth execution node in namespace ${NAMESPACE}`);
+        const endpoint = await getEthereumEndpoint(NAMESPACE, forcePortForward);
+        const client = createPublicClient({
+            transport: fallback([
+                http(endpoint.url, {
+                    batch: false
+                })
+            ])
+        });
+        return {
+            url: endpoint.url,
+            client,
+            process: endpoint.process
+        };
+    } else {
+        logger.info(`Connecting to the eth execution node at ${L1_RPC_URLS_JSON}`);
+        if (!L1_RPC_URLS_JSON) {
+            throw new Error(`L1_RPC_URLS_JSON is not defined`);
+        }
+        const client = createPublicClient({
+            transport: fallback([
+                http(L1_RPC_URLS_JSON, {
+                    batch: false
+                })
+            ])
+        });
+        return {
+            url: L1_RPC_URLS_JSON,
+            client
+        };
+    }
+}
+/**
+ * Queries an Aztec node for the L1 deployment addresses.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ */ export async function getL1DeploymentAddresses(env, forcePortForward) {
+    let endpoint;
+    try {
+        endpoint = await getRPCEndpoint(env.NAMESPACE, forcePortForward);
+        const node = createAztecNodeClient(endpoint.url);
+        return await retry(()=>node.getNodeInfo().then((i)=>i.l1ContractAddresses), 'get node info', makeBackoff([
+            1,
+            3,
+            6
+        ]), logger);
+    } finally{
+        endpoint?.process?.kill();
+    }
+}
+/**
+ * Returns a client to the RPC node.
+ * Tries external IP first, falls back to port-forward.
+ *
+ * @param env - Test environment config
+ * @param forcePortForward - If true, skip external IP and use port-forward directly
+ */ export async function getNodeClient(env, forcePortForward) {
+    const namespace = env.NAMESPACE;
+    const endpoint = await getRPCEndpoint(namespace, forcePortForward);
+    await retry(()=>fetch(`${endpoint.url}/status`).then((res)=>res.status === 200), 'check RPC endpoint', makeBackoff([
+        1,
+        1,
+        2,
+        6
+    ]), logger, true);
+    const client = createAztecNodeClient(endpoint.url);
+    return {
+        node: client,
+        url: endpoint.url,
+        process: endpoint.process
+    };
+}

package/dest/spartan/utils/config.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+declare const testConfigSchema: z.ZodObject<{
+    NAMESPACE: z.ZodDefault<z.ZodString>;
+    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>]>>>;
+    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>]>>>;
+    L1_RPC_URLS_JSON: z.ZodOptional<z.ZodString>;
+    L1_ACCOUNT_MNEMONIC: z.ZodOptional<z.ZodString>;
+    AZTEC_SLOT_DURATION: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    AZTEC_EPOCH_DURATION: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    AZTEC_PROOF_SUBMISSION_WINDOW: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    NAMESPACE: string;
+    REAL_VERIFIER: boolean;
+    CREATE_ETH_DEVNET: boolean;
+    L1_RPC_URLS_JSON?: string | undefined;
+    L1_ACCOUNT_MNEMONIC?: string | undefined;
+    AZTEC_SLOT_DURATION: number;
+    AZTEC_EPOCH_DURATION: number;
+    AZTEC_PROOF_SUBMISSION_WINDOW: number;
+    AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: number;
+}, {
+    NAMESPACE?: string | undefined;
+    REAL_VERIFIER?: string | number | boolean | undefined;
+    CREATE_ETH_DEVNET?: string | number | boolean | undefined;
+    L1_RPC_URLS_JSON?: string | undefined;
+    L1_ACCOUNT_MNEMONIC?: string | undefined;
+    AZTEC_SLOT_DURATION?: number | undefined;
+    AZTEC_EPOCH_DURATION?: number | undefined;
+    AZTEC_PROOF_SUBMISSION_WINDOW?: number | undefined;
+    AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET?: number | undefined;
+}>;
+export type TestConfig = z.infer<typeof testConfigSchema>;
+export declare function setupEnvironment(env: unknown): TestConfig;
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3BhcnRhbi91dGlscy9jb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0EsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUl4QixRQUFBLE1BQU0sZ0JBQWdCOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFVcEIsQ0FBQztBQUVILE1BQU0sTUFBTSxVQUFVLEdBQUcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLGdCQUFnQixDQUFDLENBQUM7QUFFMUQsd0JBQWdCLGdCQUFnQixDQUFDLEdBQUcsRUFBRSxPQUFPLEdBQUcsVUFBVSxDQUl6RCJ9

package/dest/spartan/utils/config.d.ts.map

@@ -0,0 +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"}

package/dest/spartan/utils/config.js

@@ -0,0 +1,20 @@
+import { createLogger } from '@aztec/aztec.js/log';
+import { schemas } from '@aztec/foundation/schemas';
+import { z } from 'zod';
+const logger = createLogger('e2e:k8s-utils');
+const testConfigSchema = z.object({
+    NAMESPACE: z.string().default('scenario'),
+    REAL_VERIFIER: schemas.Boolean.optional().default(true),
+    CREATE_ETH_DEVNET: schemas.Boolean.optional().default(false),
+    L1_RPC_URLS_JSON: z.string().optional(),
+    L1_ACCOUNT_MNEMONIC: z.string().optional(),
+    AZTEC_SLOT_DURATION: z.coerce.number().optional().default(24),
+    AZTEC_EPOCH_DURATION: z.coerce.number().optional().default(32),
+    AZTEC_PROOF_SUBMISSION_WINDOW: z.coerce.number().optional().default(5),
+    AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET: z.coerce.number().optional().default(2)
+});
+export function setupEnvironment(env) {
+    const config = testConfigSchema.parse(env);
+    logger.warn(`Loaded env config`, config);
+    return config;
+}

package/dest/spartan/utils/health.d.ts

@@ -0,0 +1,63 @@
+import { CheckpointNumber } from '@aztec/foundation/branded-types';
+import type { Logger } from '@aztec/foundation/log';
+/**
+ * Snapshot of chain state captured during setup for comparison in teardown.
+ */
+export interface ChainHealthSnapshot {
+    blockNumber: number;
+    checkpointNumber: CheckpointNumber;
+    timestamp: number;
+}
+/**
+ * Pre-flight and post-flight health checks for the Aztec network.
+ *
+ * Use in beforeAll/afterAll to validate the chain is healthy before tests run
+ * and verify it continued progressing during the test.
+ *
+ * @example
+ * ```typescript
+ * const health = new ChainHealth(config.NAMESPACE, logger);
+ *
+ * beforeAll(async () => {
+ *   await health.setup();
+ * });
+ *
+ * afterAll(async () => {
+ *   await health.teardown();
+ * });
+ * ```
+ */
+export declare class ChainHealth {
+    private namespace;
+    private logger;
+    private snapshot?;
+    constructor(namespace: string, logger: Logger);
+    /**
+     * Pre-flight health check. Validates chain is in a testable state and captures
+     * initial state for comparison in teardown.
+     *
+     * Checks performed:
+     * - Node is reachable and returns valid info
+     * - ENR exists
+     * - L1 is accessible
+     * - At least 1 L2 block has been mined
+     * - Committee exists
+     * - At least 1 checkpoint has been reached
+     *
+     * @throws Error if any health check fails
+     */
+    setup(): Promise<void>;
+    /**
+     * Post-flight health check. Verifies the chain continued progressing during the test.
+     *
+     * For tests that ran longer than the threshold, checks:
+     * - Block number increased since setup
+     * - Checkpoint number increased since setup
+     *
+     * For shorter tests, skips the check.
+     *
+     * @throws Error if chain did not progress
+     */
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVhbHRoLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3BhcnRhbi91dGlscy9oZWFsdGgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDbkUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFNcEQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsbUJBQW1CO0lBQ2xDLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsZ0JBQWdCLEVBQUUsZ0JBQWdCLENBQUM7SUFDbkMsU0FBUyxFQUFFLE1BQU0sQ0FBQztDQUNuQjtBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrQkc7QUFDSCxxQkFBYSxXQUFXO0lBQ3RCLE9BQU8sQ0FBQyxTQUFTLENBQVM7SUFDMUIsT0FBTyxDQUFDLE1BQU0sQ0FBUztJQUN2QixPQUFPLENBQUMsUUFBUSxDQUFDLENBQXNCO0lBRXZDLFlBQVksU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUc1QztJQUVEOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDRyxLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQW1HM0I7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ0csUUFBUSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0E4RTlCO0NBQ0YifQ==

package/dest/spartan/utils/health.d.ts.map

@@ -0,0 +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"}