@aztec/end-to-end 4.0.0-nightly.20260114 → 4.0.0-nightly.20260116

package/dest/fixtures/setup.js

@@ -0,0 +1,684 @@
+import { SchnorrAccountContractArtifact } from '@aztec/accounts/schnorr';
+import { generateSchnorrAccounts, getInitialTestAccountsData } from '@aztec/accounts/testing';
+import { createArchiver } from '@aztec/archiver';
+import { AztecNodeService, getConfigEnvVars } from '@aztec/aztec-node';
+import { AztecAddress, EthAddress } from '@aztec/aztec.js/addresses';
+import { BatchCall, getContractClassFromArtifact, waitForProven } from '@aztec/aztec.js/contracts';
+import { publishContractClass, publishInstance } from '@aztec/aztec.js/deployment';
+import { Fr } from '@aztec/aztec.js/fields';
+import { createLogger } from '@aztec/aztec.js/log';
+import { createAztecNodeClient, waitForNode } from '@aztec/aztec.js/node';
+import { AnvilTestWatcher, CheatCodes } from '@aztec/aztec/testing';
+import { createBlobClientWithFileStores } from '@aztec/blob-client/client';
+import { SPONSORED_FPC_SALT } from '@aztec/constants';
+import { isAnvilTestChain } from '@aztec/ethereum/chain';
+import { createExtendedL1Client } from '@aztec/ethereum/client';
+import { getL1ContractsConfigEnvVars } from '@aztec/ethereum/config';
+import { NULL_KEY } from '@aztec/ethereum/constants';
+import { deployMulticall3 } from '@aztec/ethereum/contracts';
+import { deployAztecL1Contracts } from '@aztec/ethereum/deploy-aztec-l1-contracts';
+import { DelayedTxUtils, EthCheatCodes, EthCheatCodesWithState, createDelayedL1TxUtilsFromViemWallet, startAnvil } from '@aztec/ethereum/test';
+import { EpochNumber } from '@aztec/foundation/branded-types';
+import { SecretValue } from '@aztec/foundation/config';
+import { randomBytes } from '@aztec/foundation/crypto/random';
+import { tryRmDir } from '@aztec/foundation/fs';
+import { withLogNameSuffix } from '@aztec/foundation/log';
+import { retryUntil } from '@aztec/foundation/retry';
+import { sleep } from '@aztec/foundation/sleep';
+import { DateProvider, TestDateProvider } from '@aztec/foundation/timer';
+import { SponsoredFPCContract } from '@aztec/noir-contracts.js/SponsoredFPC';
+import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
+import { MockGossipSubNetwork, getMockPubSubP2PServiceFactory } from '@aztec/p2p/test-helpers';
+import { protocolContractsHash } from '@aztec/protocol-contracts';
+import { createProverNode } from '@aztec/prover-node';
+import { getPXEConfig } from '@aztec/pxe/server';
+import { getContractInstanceFromInstantiationParams } from '@aztec/stdlib/contract';
+import { tryStop } from '@aztec/stdlib/interfaces/server';
+import { getConfigEnvVars as getTelemetryConfig, initTelemetryClient } from '@aztec/telemetry-client';
+import { BenchmarkTelemetryClient } from '@aztec/telemetry-client/bench';
+import { TestWallet, deployFundedSchnorrAccounts } from '@aztec/test-wallet/server';
+import { getGenesisValues } from '@aztec/world-state/testing';
+import fs from 'fs/promises';
+import { tmpdir } from 'os';
+import path from 'path';
+import { generatePrivateKey, mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
+import { foundry } from 'viem/chains';
+import { MNEMONIC, TEST_MAX_PENDING_TX_POOL_COUNT, TEST_PEER_CHECK_INTERVAL_MS } from './fixtures.js';
+import { getACVMConfig } from './get_acvm_config.js';
+import { getBBConfig } from './get_bb_config.js';
+import { isMetricsLoggingRequested, setupMetricsLogger } from './logging.js';
+import { getEndToEndTestTelemetryClient } from './with_telemetry_utils.js';
+export { startAnvil };
+const { AZTEC_NODE_URL = '' } = process.env;
+const getAztecUrl = ()=>AZTEC_NODE_URL;
+let telemetry = undefined;
+async function getTelemetryClient(partialConfig = {}) {
+    if (!telemetry) {
+        const config = {
+            ...getTelemetryConfig(),
+            ...partialConfig
+        };
+        telemetry = config.benchmark ? new BenchmarkTelemetryClient() : await initTelemetryClient(config);
+    }
+    return telemetry;
+}
+export const getPrivateKeyFromIndex = (index)=>{
+    const hdAccount = mnemonicToAccount(MNEMONIC, {
+        addressIndex: index
+    });
+    const privKeyRaw = hdAccount.getHdKey().privateKey;
+    return privKeyRaw === null ? null : Buffer.from(privKeyRaw);
+};
+/**
+ * Sets up shared blob storage using FileStore in the data directory.
+ */ export async function setupSharedBlobStorage(config) {
+    const sharedBlobPath = path.join(config.dataDirectory, 'shared-blobs');
+    await fs.mkdir(sharedBlobPath, {
+        recursive: true
+    });
+    config.blobFileStoreUrls = [
+        `file://${sharedBlobPath}`
+    ];
+    config.blobFileStoreUploadUrl = `file://${sharedBlobPath}`;
+}
+/**
+ * Sets up Private eXecution Environment (PXE) and returns the corresponding test wallet.
+ * @param aztecNode - An instance of Aztec Node.
+ * @param opts - Partial configuration for the PXE.
+ * @param logger - The logger to be used.
+ * @param useLogSuffix - Whether to add a randomly generated suffix to the PXE debug logs.
+ * @returns A test wallet, logger and teardown function.
+ */ export async function setupPXEAndGetWallet(aztecNode, opts = {}, logger = getLogger(), useLogSuffix = false) {
+    const PXEConfig = {
+        ...getPXEConfig(),
+        ...opts
+    };
+    // For tests we only want proving enabled if specifically requested
+    PXEConfig.proverEnabled = !!opts.proverEnabled;
+    // If no data directory provided, create a temp directory and clean up afterwards
+    const configuredDataDirectory = PXEConfig.dataDirectory;
+    if (!configuredDataDirectory) {
+        PXEConfig.dataDirectory = path.join(tmpdir(), randomBytes(8).toString('hex'));
+    }
+    const teardown = configuredDataDirectory ? ()=>Promise.resolve() : ()=>tryRmDir(PXEConfig.dataDirectory);
+    const wallet = await TestWallet.create(aztecNode, PXEConfig, {
+        useLogSuffix
+    });
+    return {
+        wallet,
+        logger,
+        teardown
+    };
+}
+/**
+ * Function to setup the test against a remote deployment. It is assumed that L1 contract are already deployed
+ */ async function setupWithRemoteEnvironment(account, config, logger, numberOfAccounts) {
+    const aztecNodeUrl = getAztecUrl();
+    logger.verbose(`Creating Aztec Node client to remote host ${aztecNodeUrl}`);
+    const aztecNode = createAztecNodeClient(aztecNodeUrl);
+    await waitForNode(aztecNode, logger);
+    logger.verbose('JSON RPC client connected to Aztec Node');
+    logger.verbose(`Retrieving contract addresses from ${aztecNodeUrl}`);
+    const { l1ContractAddresses, rollupVersion } = await aztecNode.getNodeInfo();
+    const l1Client = createExtendedL1Client(config.l1RpcUrls, account, foundry);
+    const deployL1ContractsValues = {
+        l1ContractAddresses,
+        l1Client,
+        rollupVersion
+    };
+    const ethCheatCodes = new EthCheatCodes(config.l1RpcUrls, new DateProvider());
+    const wallet = await TestWallet.create(aztecNode);
+    const cheatCodes = await CheatCodes.create(config.l1RpcUrls, aztecNode, new DateProvider());
+    const teardown = ()=>Promise.resolve();
+    logger.verbose('Populating wallet from already registered accounts...');
+    const initialFundedAccounts = await getInitialTestAccountsData();
+    if (initialFundedAccounts.length < numberOfAccounts) {
+        throw new Error(`Required ${numberOfAccounts} accounts. Found ${initialFundedAccounts.length}.`);
+    }
+    const testAccounts = await Promise.all(initialFundedAccounts.slice(0, numberOfAccounts).map(async (account)=>{
+        const accountManager = await wallet.createSchnorrAccount(account.secret, account.salt, account.signingKey);
+        return accountManager.address;
+    }));
+    return {
+        anvil: undefined,
+        aztecNode,
+        aztecNodeService: undefined,
+        aztecNodeAdmin: undefined,
+        sequencer: undefined,
+        proverNode: undefined,
+        deployL1ContractsValues,
+        config,
+        aztecNodeConfig: config,
+        initialFundedAccounts,
+        wallet,
+        accounts: testAccounts,
+        logger,
+        cheatCodes,
+        ethCheatCodes,
+        prefilledPublicData: undefined,
+        mockGossipSubNetwork: undefined,
+        watcher: undefined,
+        dateProvider: undefined,
+        telemetryClient: undefined,
+        acvmConfig: undefined,
+        bbConfig: undefined,
+        directoryToCleanup: undefined,
+        teardown
+    };
+}
+/**
+ * Sets up the environment for the end-to-end tests.
+ * @param numberOfAccounts - The number of new accounts to be created once the PXE is initiated.
+ * @param opts - Options to pass to the node initialization and to the setup script.
+ * @param pxeOpts - Options to pass to the PXE initialization.
+ */ export async function setup(numberOfAccounts = 1, opts = {}, pxeOpts = {}, chain = foundry) {
+    let anvil;
+    try {
+        opts.aztecTargetCommitteeSize ??= 0;
+        opts.slasherFlavor ??= 'none';
+        const config = {
+            ...getConfigEnvVars(),
+            ...opts
+        };
+        // use initialValidators for the node config
+        config.validatorPrivateKeys = new SecretValue(opts.initialValidators?.map((v)=>v.privateKey) ?? []);
+        config.peerCheckIntervalMS = TEST_PEER_CHECK_INTERVAL_MS;
+        config.maxPendingTxCount = opts.maxPendingTxCount ?? TEST_MAX_PENDING_TX_POOL_COUNT;
+        // For tests we only want proving enabled if specifically requested
+        config.realProofs = !!opts.realProofs;
+        // Only enforce the time table if requested
+        config.enforceTimeTable = !!opts.enforceTimeTable;
+        config.listenAddress = '127.0.0.1';
+        const logger = getLogger();
+        // Create a temp directory for any services that need it and cleanup later
+        const directoryToCleanup = path.join(tmpdir(), randomBytes(8).toString('hex'));
+        await fs.mkdir(directoryToCleanup, {
+            recursive: true
+        });
+        if (!config.dataDirectory) {
+            config.dataDirectory = directoryToCleanup;
+        }
+        if (!config.l1RpcUrls?.length) {
+            if (!isAnvilTestChain(chain.id)) {
+                throw new Error(`No ETHEREUM_HOSTS set but non anvil chain requested`);
+            }
+            if (AZTEC_NODE_URL) {
+                throw new Error(`AZTEC_NODE_URL provided but no ETHEREUM_HOSTS set. Refusing to run, please set both variables so tests can deploy L1 contracts to the same Anvil instance`);
+            }
+            const res = await startAnvil({
+                l1BlockTime: opts.ethereumSlotDuration,
+                accounts: opts.anvilAccounts,
+                port: opts.anvilPort
+            });
+            anvil = res.anvil;
+            config.l1RpcUrls = [
+                res.rpcUrl
+            ];
+        }
+        // Enable logging metrics to a local file named after the test suite
+        if (isMetricsLoggingRequested()) {
+            const filename = path.join('log', getJobName() + '.jsonl');
+            logger.info(`Logging metrics to ${filename}`);
+            setupMetricsLogger(filename);
+        }
+        const dateProvider = new TestDateProvider();
+        const ethCheatCodes = new EthCheatCodesWithState(config.l1RpcUrls, dateProvider);
+        if (opts.stateLoad) {
+            await ethCheatCodes.loadChainState(opts.stateLoad);
+        }
+        if (opts.l1StartTime) {
+            await ethCheatCodes.warp(opts.l1StartTime, {
+                resetBlockInterval: true
+            });
+        }
+        let publisherPrivKeyHex = undefined;
+        let publisherHdAccount = undefined;
+        if (opts.l1PublisherKey && opts.l1PublisherKey.getValue() && opts.l1PublisherKey.getValue() != NULL_KEY) {
+            publisherPrivKeyHex = opts.l1PublisherKey.getValue();
+            publisherHdAccount = privateKeyToAccount(publisherPrivKeyHex);
+        } else if (config.publisherPrivateKeys && config.publisherPrivateKeys.length > 0 && config.publisherPrivateKeys[0].getValue() != NULL_KEY) {
+            publisherPrivKeyHex = config.publisherPrivateKeys[0].getValue();
+            publisherHdAccount = privateKeyToAccount(publisherPrivKeyHex);
+        } else if (!MNEMONIC) {
+            throw new Error(`Mnemonic not provided and no publisher private key`);
+        } else {
+            publisherHdAccount = mnemonicToAccount(MNEMONIC, {
+                addressIndex: 0
+            });
+            const publisherPrivKeyRaw = publisherHdAccount.getHdKey().privateKey;
+            const publisherPrivKey = publisherPrivKeyRaw === null ? null : Buffer.from(publisherPrivKeyRaw);
+            publisherPrivKeyHex = `0x${publisherPrivKey.toString('hex')}`;
+            config.publisherPrivateKeys = [
+                new SecretValue(publisherPrivKeyHex)
+            ];
+        }
+        if (config.coinbase === undefined) {
+            config.coinbase = EthAddress.fromString(publisherHdAccount.address);
+        }
+        if (AZTEC_NODE_URL) {
+            // we are setting up against a remote environment, l1 contracts are assumed to already be deployed
+            return await setupWithRemoteEnvironment(publisherHdAccount, config, logger, numberOfAccounts);
+        }
+        // Determine which addresses to fund in genesis
+        const initialFundedAccounts = opts.initialFundedAccounts ?? await generateSchnorrAccounts(opts.numberOfInitialFundedAccounts ?? Math.max(numberOfAccounts, 10));
+        const addressesToFund = initialFundedAccounts.map((a)=>a.address);
+        // Optionally fund the sponsored FPC
+        if (opts.fundSponsoredFPC) {
+            const sponsoredFPCAddress = await getSponsoredFPCAddress();
+            addressesToFund.push(sponsoredFPCAddress);
+        }
+        const { genesisArchiveRoot, prefilledPublicData, fundingNeeded } = await getGenesisValues(addressesToFund, opts.initialAccountFeeJuice, opts.genesisPublicData);
+        const wasAutomining = await ethCheatCodes.isAutoMining();
+        const enableAutomine = opts.automineL1Setup && !wasAutomining && isAnvilTestChain(chain.id);
+        if (enableAutomine) {
+            await ethCheatCodes.setAutomine(true);
+        }
+        const l1Client = createExtendedL1Client(config.l1RpcUrls, publisherHdAccount, chain);
+        // Deploy Multicall3 if running locally
+        await deployMulticall3(l1Client, logger);
+        // Force viem to refresh its nonce cache to avoid "nonce too low" errors in subsequent transactions
+        // This is necessary because deployMulticall3 sends multiple transactions and viem may cache a stale nonce
+        await l1Client.getTransactionCount({
+            address: l1Client.account.address
+        });
+        const deployL1ContractsValues = await deployAztecL1Contracts(config.l1RpcUrls[0], publisherPrivKeyHex, chain.id, {
+            ...getL1ContractsConfigEnvVars(),
+            ...opts,
+            ...opts.l1ContractsArgs,
+            vkTreeRoot: getVKTreeRoot(),
+            protocolContractsHash,
+            genesisArchiveRoot,
+            initialValidators: opts.initialValidators,
+            feeJuicePortalInitialBalance: fundingNeeded,
+            realVerifier: false
+        });
+        config.l1Contracts = deployL1ContractsValues.l1ContractAddresses;
+        config.rollupVersion = deployL1ContractsValues.rollupVersion;
+        if (enableAutomine) {
+            await ethCheatCodes.setAutomine(false);
+            await ethCheatCodes.setIntervalMining(config.ethereumSlotDuration);
+            dateProvider.setTime(await ethCheatCodes.timestamp() * 1000);
+        }
+        if (opts.l2StartTime) {
+            await ethCheatCodes.warp(opts.l2StartTime, {
+                resetBlockInterval: true
+            });
+        }
+        const watcher = new AnvilTestWatcher(new EthCheatCodesWithState(config.l1RpcUrls, dateProvider), deployL1ContractsValues.l1ContractAddresses.rollupAddress, deployL1ContractsValues.l1Client, dateProvider);
+        if (!opts.disableAnvilTestWatcher) {
+            await watcher.start();
+        }
+        // Use metricsPort-based telemetry if provided, otherwise use the regular telemetry client
+        const telemetryClient = opts.metricsPort ? await getEndToEndTestTelemetryClient(opts.metricsPort) : await getTelemetryClient(opts.telemetryConfig);
+        await setupSharedBlobStorage(config);
+        logger.verbose('Creating and synching an aztec node', config);
+        const acvmConfig = await getACVMConfig(logger);
+        if (acvmConfig) {
+            config.acvmWorkingDirectory = acvmConfig.acvmWorkingDirectory;
+            config.acvmBinaryPath = acvmConfig.acvmBinaryPath;
+        }
+        const bbConfig = await getBBConfig(logger);
+        if (bbConfig) {
+            config.bbBinaryPath = bbConfig.bbBinaryPath;
+            config.bbWorkingDirectory = bbConfig.bbWorkingDirectory;
+        }
+        let mockGossipSubNetwork;
+        let p2pClientDeps = undefined;
+        if (opts.mockGossipSubNetwork) {
+            mockGossipSubNetwork = new MockGossipSubNetwork();
+            p2pClientDeps = {
+                p2pServiceFactory: getMockPubSubP2PServiceFactory(mockGossipSubNetwork)
+            };
+        }
+        // Transactions built against the genesis state must be included in block 1, otherwise they are dropped.
+        // To avoid test failures from dropped transactions, we ensure progression beyond genesis before proceeding.
+        // For account deployments, we set minTxsPerBlock=1 and deploy accounts sequentially for guaranteed success.
+        // If no accounts need deployment, we await an empty block to confirm network progression.
+        const originalMinTxsPerBlock = config.minTxsPerBlock;
+        if (originalMinTxsPerBlock === undefined) {
+            throw new Error('minTxsPerBlock is undefined in e2e test setup');
+        }
+        // Only set minTxsPerBlock=1 if we're going to deploy accounts and need reliable block inclusion
+        const shouldDeployAccounts = numberOfAccounts > 0 && !opts.skipAccountDeployment;
+        // Only set minTxsPerBlock=0 if we need an empty block (no accounts at all, not skipped deployment)
+        const needsEmptyBlock = numberOfAccounts === 0 && !opts.skipAccountDeployment;
+        config.minTxsPerBlock = shouldDeployAccounts ? 1 : needsEmptyBlock ? 0 : originalMinTxsPerBlock;
+        config.p2pEnabled = opts.mockGossipSubNetwork || config.p2pEnabled;
+        config.p2pIp = opts.p2pIp ?? config.p2pIp ?? '127.0.0.1';
+        if (!config.disableValidator) {
+            if ((config.validatorPrivateKeys?.getValue().length ?? 0) === 0) {
+                config.validatorPrivateKeys = new SecretValue([
+                    generatePrivateKey()
+                ]);
+            }
+        }
+        const aztecNodeService = await AztecNodeService.createAndSync(config, {
+            dateProvider,
+            telemetry: telemetryClient,
+            p2pClientDeps,
+            logger: createLogger('node:MAIN-aztec-node')
+        }, {
+            prefilledPublicData
+        });
+        const sequencerClient = aztecNodeService.getSequencer();
+        if (sequencerClient) {
+            const publisher = sequencerClient.sequencer.publisher;
+            publisher.l1TxUtils = DelayedTxUtils.fromL1TxUtils(publisher.l1TxUtils, config.ethereumSlotDuration, l1Client);
+        }
+        let proverNode = undefined;
+        if (opts.startProverNode) {
+            logger.verbose('Creating and syncing a simulated prover node...');
+            const proverNodePrivateKey = getPrivateKeyFromIndex(2);
+            const proverNodePrivateKeyHex = `0x${proverNodePrivateKey.toString('hex')}`;
+            const proverNodeDataDirectory = path.join(directoryToCleanup, randomBytes(8).toString('hex'));
+            const proverNodeConfig = {
+                ...config.proverNodeConfig,
+                dataDirectory: proverNodeDataDirectory,
+                p2pEnabled: false
+            };
+            proverNode = await createAndSyncProverNode(proverNodePrivateKeyHex, config, proverNodeConfig, aztecNodeService, prefilledPublicData);
+        }
+        logger.verbose('Creating a pxe...');
+        const pxeConfig = {
+            ...getPXEConfig(),
+            ...pxeOpts
+        };
+        pxeConfig.dataDirectory = path.join(directoryToCleanup, randomBytes(8).toString('hex'));
+        // For tests we only want proving enabled if specifically requested
+        pxeConfig.proverEnabled = !!pxeOpts.proverEnabled;
+        const wallet = await TestWallet.create(aztecNodeService, pxeConfig);
+        const cheatCodes = await CheatCodes.create(config.l1RpcUrls, aztecNodeService, dateProvider);
+        if (opts.aztecTargetCommitteeSize && opts.aztecTargetCommitteeSize > 0 || opts.initialValidators && opts.initialValidators.length > 0) {
+            // We need to advance such that the committee is set up.
+            await cheatCodes.rollup.advanceToEpoch(EpochNumber.fromBigInt(BigInt(await cheatCodes.rollup.getEpoch()) + BigInt(config.lagInEpochsForValidatorSet + 1)));
+            await cheatCodes.rollup.setupEpoch();
+            await cheatCodes.rollup.debugRollup();
+        }
+        let accounts = [];
+        if (shouldDeployAccounts) {
+            logger.info(`${numberOfAccounts} accounts are being deployed. Reliably progressing past genesis by setting minTxsPerBlock to 1 and waiting for the accounts to be deployed`);
+            const accountsData = initialFundedAccounts.slice(0, numberOfAccounts);
+            const accountManagers = await deployFundedSchnorrAccounts(wallet, aztecNodeService, accountsData);
+            accounts = accountManagers.map((accountManager)=>accountManager.address);
+        } else if (needsEmptyBlock) {
+            logger.info('No accounts are being deployed, waiting for an empty block 1 to be mined');
+            while(await aztecNodeService.getBlockNumber() === 0){
+                await sleep(2000);
+            }
+        }
+        // If skipAccountDeployment is true, we don't deploy or wait - tests will handle account deployment later
+        // Now we restore the original minTxsPerBlock setting if we changed it.
+        if (sequencerClient && config.minTxsPerBlock !== originalMinTxsPerBlock) {
+            sequencerClient.getSequencer().updateConfig({
+                minTxsPerBlock: originalMinTxsPerBlock
+            });
+        }
+        if (initialFundedAccounts.length < numberOfAccounts) {
+            throw new Error(`Unable to deploy ${numberOfAccounts} accounts. Only ${initialFundedAccounts.length} accounts were funded.`);
+        }
+        const teardown = async ()=>{
+            try {
+                await tryStop(wallet, logger);
+                await tryStop(aztecNodeService, logger);
+                await tryStop(proverNode, logger);
+                if (acvmConfig?.cleanup) {
+                    await acvmConfig.cleanup();
+                }
+                if (bbConfig?.cleanup) {
+                    await bbConfig.cleanup();
+                }
+                await tryStop(watcher, logger);
+                await tryStop(anvil, logger);
+                await tryRmDir(directoryToCleanup, logger);
+            } catch (err) {
+                logger.error(`Error during e2e test teardown`, err);
+            } finally{
+                try {
+                    await telemetryClient?.stop();
+                } catch (err) {
+                    logger.error(`Error during telemetry client stop`, err);
+                }
+            }
+        };
+        return {
+            anvil,
+            aztecNode: aztecNodeService,
+            aztecNodeService,
+            aztecNodeAdmin: aztecNodeService,
+            cheatCodes,
+            ethCheatCodes,
+            config,
+            aztecNodeConfig: config,
+            dateProvider,
+            deployL1ContractsValues,
+            initialFundedAccounts,
+            logger,
+            mockGossipSubNetwork,
+            prefilledPublicData,
+            proverNode,
+            sequencer: sequencerClient,
+            teardown,
+            telemetryClient,
+            wallet,
+            accounts,
+            watcher,
+            acvmConfig,
+            bbConfig,
+            directoryToCleanup
+        };
+    } catch (err) {
+        await anvil?.stop();
+        throw err;
+    }
+}
+/** Returns the job name for the current test. */ function getJobName() {
+    return process.env.JOB_NAME ?? expect.getState().currentTestName?.split(' ')[0].replaceAll('/', '_') ?? 'unknown';
+}
+/**
+ * Returns a logger instance for the current test.
+ */ export function getLogger() {
+    const describeBlockName = expect.getState().currentTestName?.split(' ')[0].replaceAll('/', ':');
+    if (!describeBlockName) {
+        const name = expect.getState().testPath?.split('/').pop()?.split('.')[0] ?? 'unknown';
+        return createLogger('e2e:' + name);
+    }
+    return createLogger('e2e:' + describeBlockName);
+}
+/**
+ * Computes the address of the "canonical" SponsoredFPCContract.
+ */ export function getSponsoredFPCInstance() {
+    return Promise.resolve(getContractInstanceFromInstantiationParams(SponsoredFPCContract.artifact, {
+        salt: new Fr(SPONSORED_FPC_SALT)
+    }));
+}
+/**
+ * Computes the address of the "canonical" SponsoredFPCContract.
+ */ export async function getSponsoredFPCAddress() {
+    const sponsoredFPCInstance = await getSponsoredFPCInstance();
+    return sponsoredFPCInstance.address;
+}
+/**
+ * Deploy a sponsored FPC contract to a running instance.
+ */ export async function setupSponsoredFPC(wallet) {
+    const instance = await getContractInstanceFromInstantiationParams(SponsoredFPCContract.artifact, {
+        salt: new Fr(SPONSORED_FPC_SALT)
+    });
+    await wallet.registerContract(instance, SponsoredFPCContract.artifact);
+    getLogger().info(`SponsoredFPC: ${instance.address}`);
+    return instance;
+}
+/**
+ * Registers the SponsoredFPC in this PXE instance.
+ */ export async function registerSponsoredFPC(wallet) {
+    await wallet.registerContract(await getSponsoredFPCInstance(), SponsoredFPCContract.artifact);
+}
+export async function waitForProvenChain(node, targetBlock, timeoutSec = 60, intervalSec = 1) {
+    targetBlock ??= await node.getBlockNumber();
+    await retryUntil(async ()=>await node.getProvenBlockNumber() >= targetBlock, 'proven chain status', timeoutSec, intervalSec);
+}
+export function createAndSyncProverNode(proverNodePrivateKey, aztecNodeConfig, proverNodeConfig, aztecNode, prefilledPublicData = [], proverNodeDeps = {}) {
+    return withLogNameSuffix('prover-node', async ()=>{
+        const aztecNodeTxProvider = aztecNode && {
+            getTxByHash: aztecNode.getTxByHash.bind(aztecNode),
+            getTxsByHash: aztecNode.getTxsByHash.bind(aztecNode),
+            stop: ()=>Promise.resolve()
+        };
+        const blobClient = await createBlobClientWithFileStores(aztecNodeConfig, createLogger('blob-client:prover-node'));
+        const archiverConfig = {
+            ...aztecNodeConfig,
+            dataDirectory: proverNodeConfig.dataDirectory
+        };
+        const archiver = await createArchiver(archiverConfig, {
+            blobClient,
+            dateProvider: proverNodeDeps.dateProvider
+        }, {
+            blockUntilSync: true
+        });
+        const proverConfig = {
+            ...aztecNodeConfig,
+            txCollectionNodeRpcUrls: [],
+            realProofs: false,
+            proverAgentCount: 2,
+            publisherPrivateKeys: [
+                new SecretValue(proverNodePrivateKey)
+            ],
+            proverNodeMaxPendingJobs: 10,
+            proverNodeMaxParallelBlocksPerEpoch: 32,
+            proverNodePollingIntervalMs: 200,
+            txGatheringIntervalMs: 1000,
+            txGatheringBatchSize: 10,
+            txGatheringMaxParallelRequestsPerNode: 10,
+            txGatheringTimeoutMs: 24_000,
+            proverNodeFailedEpochStore: undefined,
+            proverId: EthAddress.fromNumber(1),
+            proverNodeEpochProvingDelayMs: undefined,
+            ...proverNodeConfig
+        };
+        const l1TxUtils = createDelayedL1TxUtils(aztecNodeConfig, proverNodePrivateKey, 'prover-node', proverNodeDeps.dateProvider);
+        const proverNode = await createProverNode(proverConfig, {
+            ...proverNodeDeps,
+            aztecNodeTxProvider,
+            archiver: archiver,
+            l1TxUtils
+        }, {
+            prefilledPublicData
+        });
+        getLogger().info(`Created and synced prover node`, {
+            publisherAddress: l1TxUtils.client.account.address
+        });
+        if (!proverNodeConfig.dontStart) {
+            await proverNode.start();
+        }
+        return proverNode;
+    });
+}
+function createDelayedL1TxUtils(aztecNodeConfig, privateKey, logName, dateProvider) {
+    const l1Client = createExtendedL1Client(aztecNodeConfig.l1RpcUrls, privateKey, foundry);
+    const log = createLogger(logName);
+    const l1TxUtils = createDelayedL1TxUtilsFromViemWallet(l1Client, log, dateProvider, aztecNodeConfig);
+    l1TxUtils.enableDelayer(aztecNodeConfig.ethereumSlotDuration);
+    return l1TxUtils;
+}
+export function getBalancesFn(symbol, method, from, logger) {
+    const balances = async (...addressLikes)=>{
+        const addresses = addressLikes.map((addressLike)=>'address' in addressLike ? addressLike.address : addressLike);
+        const b = await Promise.all(addresses.map((address)=>method(address).simulate({
+                from
+            })));
+        const debugString = `${symbol} balances: ${addresses.map((address, i)=>`${address}: ${b[i]}`).join(', ')}`;
+        logger.verbose(debugString);
+        return b;
+    };
+    return balances;
+}
+export async function expectMapping(fn, inputs, expectedOutputs) {
+    expect(inputs.length).toBe(expectedOutputs.length);
+    const outputs = await fn(...inputs);
+    expect(outputs).toEqual(expectedOutputs);
+}
+export async function expectMappingDelta(initialValues, fn, inputs, expectedDiffs) {
+    expect(inputs.length).toBe(expectedDiffs.length);
+    const outputs = await fn(...inputs);
+    const diffs = outputs.map((output, i)=>output - initialValues[i]);
+    expect(diffs).toEqual(expectedDiffs);
+}
+/**
+ * Registers the contract class used for test accounts and publicly deploys the instances requested.
+ * Use this when you need to make a public call to an account contract, such as for requesting a public authwit.
+ */ export async function ensureAccountContractsPublished(wallet, accountsToDeploy) {
+    const accountsAndAddresses = await Promise.all(accountsToDeploy.map(async (address)=>{
+        return {
+            address,
+            deployed: (await wallet.getContractMetadata(address)).isContractPublished
+        };
+    }));
+    const instances = (await Promise.all(accountsAndAddresses.filter(({ deployed })=>!deployed).map(({ address })=>wallet.getContractMetadata(address)))).map((contractMetadata)=>contractMetadata.instance);
+    const contractClass = await getContractClassFromArtifact(SchnorrAccountContractArtifact);
+    if (!(await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered) {
+        await (await publishContractClass(wallet, SchnorrAccountContractArtifact)).send({
+            from: accountsToDeploy[0]
+        }).wait();
+    }
+    const requests = instances.map((instance)=>publishInstance(wallet, instance));
+    const batch = new BatchCall(wallet, requests);
+    await batch.send({
+        from: accountsToDeploy[0]
+    }).wait();
+}
+/**
+ * Helper function to deploy accounts.
+ * Returns deployed account data that can be used by tests.
+ */ export const deployAccounts = (numberOfAccounts, logger)=>async ({ wallet, initialFundedAccounts })=>{
+        if (initialFundedAccounts.length < numberOfAccounts) {
+            throw new Error(`Cannot deploy more than ${initialFundedAccounts.length} initial accounts.`);
+        }
+        logger.verbose('Deploying accounts funded with fee juice...');
+        const deployedAccounts = initialFundedAccounts.slice(0, numberOfAccounts);
+        // Serial due to https://github.com/AztecProtocol/aztec-packages/issues/12045
+        for(let i = 0; i < deployedAccounts.length; i++){
+            const accountManager = await wallet.createSchnorrAccount(deployedAccounts[i].secret, deployedAccounts[i].salt, deployedAccounts[i].signingKey);
+            const deployMethod = await accountManager.getDeployMethod();
+            await deployMethod.send({
+                from: AztecAddress.ZERO,
+                skipClassPublication: i !== 0
+            }).wait();
+        }
+        return {
+            deployedAccounts
+        };
+    };
+/**
+ * Registers the contract class used for test accounts and publicly deploys the instances requested.
+ * Use this when you need to make a public call to an account contract, such as for requesting a public authwit.
+ */ export async function publicDeployAccounts(wallet, accountsToDeploy, waitUntilProven = false, node) {
+    const instances = (await Promise.all(accountsToDeploy.map((account)=>wallet.getContractMetadata(account)))).map((metadata)=>metadata.instance);
+    const contractClass = await getContractClassFromArtifact(SchnorrAccountContractArtifact);
+    const alreadyRegistered = (await wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered;
+    const calls = await Promise.all([
+        ...!alreadyRegistered ? [
+            publishContractClass(wallet, SchnorrAccountContractArtifact)
+        ] : [],
+        ...instances.map((instance)=>publishInstance(wallet, instance))
+    ]);
+    const batch = new BatchCall(wallet, calls);
+    const txReceipt = await batch.send({
+        from: accountsToDeploy[0]
+    }).wait();
+    if (waitUntilProven) {
+        if (!node) {
+            throw new Error('Need to provide an AztecNode to wait for proven.');
+        } else {
+            await waitForProven(node, txReceipt);
+        }
+    }
+}
+/**
+ * Destroys the current context.
+ */ export async function teardown(context) {
+    if (!context) {
+        return;
+    }
+    await context.teardown();
+}
+// Re-export for backward compatibility
+export { deployAndInitializeTokenAndBridgeContracts } from '../shared/cross_chain_test_harness.js';