@aztec/end-to-end 0.0.0-test.1 → 0.0.1-commit.0b941701

package/dest/fixtures/utils.js

@@ -1,553 +1,5 @@
-import { SchnorrAccountContractArtifact } from '@aztec/accounts/schnorr';
-import { deployFundedSchnorrAccounts, generateSchnorrAccounts, getDeployedTestAccounts, getDeployedTestAccountsWallets } from '@aztec/accounts/testing';
-import { createArchiver } from '@aztec/archiver';
-import { AztecNodeService, getConfigEnvVars } from '@aztec/aztec-node';
-import { AnvilTestWatcher, BatchCall, CheatCodes, FeeJuicePaymentMethod, SignerlessWallet, createAztecNodeClient, createLogger, createPXEClient, deployL1Contracts, makeFetch, waitForPXE } from '@aztec/aztec.js';
-import { deployInstance, registerContractClass } from '@aztec/aztec.js/deployment';
-import { createBlobSinkClient } from '@aztec/blob-sink/client';
-import { createBlobSinkServer } from '@aztec/blob-sink/server';
-import { FEE_JUICE_INITIAL_MINT, GENESIS_ARCHIVE_ROOT, GENESIS_BLOCK_HASH } from '@aztec/constants';
-import { ForwarderContract, NULL_KEY, createL1Clients, getL1ContractsConfigEnvVars, isAnvilTestChain, l1Artifacts } from '@aztec/ethereum';
-import { DelayedTxUtils, EthCheatCodesWithState, startAnvil } from '@aztec/ethereum/test';
-import { randomBytes } from '@aztec/foundation/crypto';
-import { EthAddress } from '@aztec/foundation/eth-address';
-import { Fr } from '@aztec/foundation/fields';
-import { retryUntil } from '@aztec/foundation/retry';
-import { TestDateProvider } from '@aztec/foundation/timer';
-import { FeeJuiceContract } from '@aztec/noir-contracts.js/FeeJuice';
-import { getVKTreeRoot } from '@aztec/noir-protocol-circuits-types/vk-tree';
-import { ProtocolContractAddress, protocolContractTreeRoot } from '@aztec/protocol-contracts';
-import { createProverNode } from '@aztec/prover-node';
-import { createPXEService, getPXEServiceConfig } from '@aztec/pxe/server';
-import { getContractClassFromArtifact } from '@aztec/stdlib/contract';
-import { Gas } from '@aztec/stdlib/gas';
-import { getConfigEnvVars as getTelemetryConfig, initTelemetryClient } from '@aztec/telemetry-client';
-import { BenchmarkTelemetryClient } from '@aztec/telemetry-client/bench';
-import { getGenesisValues } from '@aztec/world-state/testing';
-import fs from 'fs/promises';
-import getPort from 'get-port';
-import { tmpdir } from 'os';
-import * as path from 'path';
-import { inspect } from 'util';
-import { getContract } from 'viem';
-import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
-import { foundry } from 'viem/chains';
-import { MNEMONIC, 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';
-export { deployAndInitializeTokenAndBridgeContracts } from '../shared/cross_chain_test_harness.js';
-export { startAnvil };
-const { PXE_URL = '' } = process.env;
-const getAztecUrl = ()=>PXE_URL;
-let telemetry = undefined;
-function getTelemetryClient(partialConfig = {}) {
-    if (!telemetry) {
-        const config = {
-            ...getTelemetryConfig(),
-            ...partialConfig
-        };
-        telemetry = config.benchmark ? new BenchmarkTelemetryClient() : initTelemetryClient(config);
-    }
-    return telemetry;
-}
-if (typeof afterAll === 'function') {
-    afterAll(async ()=>{
-        await telemetry?.stop();
-    });
-}
-export const getPrivateKeyFromIndex = (index)=>{
-    const hdAccount = mnemonicToAccount(MNEMONIC, {
-        addressIndex: index
-    });
-    const privKeyRaw = hdAccount.getHdKey().privateKey;
-    return privKeyRaw === null ? null : Buffer.from(privKeyRaw);
-};
-export const setupL1Contracts = async (l1RpcUrls, account, logger, args = {}, chain = foundry)=>{
-    const l1Data = await deployL1Contracts(l1RpcUrls, account, chain, logger, {
-        l2FeeJuiceAddress: ProtocolContractAddress.FeeJuice.toField(),
-        vkTreeRoot: getVKTreeRoot(),
-        protocolContractTreeRoot,
-        genesisArchiveRoot: args.genesisArchiveRoot ?? new Fr(GENESIS_ARCHIVE_ROOT),
-        genesisBlockHash: args.genesisBlockHash ?? new Fr(GENESIS_BLOCK_HASH),
-        salt: args.salt,
-        initialValidators: args.initialValidators,
-        ...getL1ContractsConfigEnvVars(),
-        ...args
-    });
-    return l1Data;
-};
-/**
- * Sets up Private eXecution Environment (PXE).
- * @param aztecNode - An instance of Aztec Node.
- * @param opts - Partial configuration for the PXE service.
- * @param firstPrivKey - The private key of the first account to be created.
- * @param logger - The logger to be used.
- * @param useLogSuffix - Whether to add a randomly generated suffix to the PXE debug logs.
- * @param proofCreator - An optional proof creator to use
- * @returns Private eXecution Environment (PXE), accounts, wallets and logger.
- */ export async function setupPXEService(aztecNode, opts = {}, logger = getLogger(), useLogSuffix = false, proofCreator) {
-    const pxeServiceConfig = {
-        ...getPXEServiceConfig(),
-        ...opts
-    };
-    // If no data directory provided, create a temp directory and clean up afterwards
-    const configuredDataDirectory = pxeServiceConfig.dataDirectory;
-    if (!configuredDataDirectory) {
-        pxeServiceConfig.dataDirectory = path.join(tmpdir(), randomBytes(8).toString('hex'));
-    }
-    const pxe = await createPXEService(aztecNode, pxeServiceConfig, useLogSuffix, proofCreator);
-    const teardown = async ()=>{
-        if (!configuredDataDirectory) {
-            try {
-                await fs.rm(pxeServiceConfig.dataDirectory, {
-                    recursive: true,
-                    force: true,
-                    maxRetries: 3
-                });
-            } catch (err) {
-                logger.warn(`Failed to delete tmp PXE data directory ${pxeServiceConfig.dataDirectory}: ${err}`);
-            }
-        }
-    };
-    return {
-        pxe,
-        logger,
-        teardown
-    };
-}
-/**
- * Function to setup the test against a remote deployment. It is assumed that L1 contract are already deployed
- * @param account - The account for use in create viem wallets.
- * @param config - The aztec Node Configuration
- * @param logger - The logger to be used
- * @param numberOfAccounts - The number of new accounts to be created once the PXE is initiated.
- * (will create extra accounts if the environment doesn't already have enough accounts)
- * @returns Private eXecution Environment (PXE) client, viem wallets, contract addresses etc.
- */ async function setupWithRemoteEnvironment(account, config, logger, numberOfAccounts) {
-    // we are setting up against a remote environment, l1 contracts are already deployed
-    const aztecNodeUrl = getAztecUrl();
-    logger.verbose(`Creating Aztec Node client to remote host ${aztecNodeUrl}`);
-    const aztecNode = createAztecNodeClient(aztecNodeUrl);
-    logger.verbose(`Creating PXE client to remote host ${PXE_URL}`);
-    const pxeClient = createPXEClient(PXE_URL, {}, makeFetch([
-        1,
-        2,
-        3
-    ], true));
-    await waitForPXE(pxeClient, logger);
-    logger.verbose('JSON RPC client connected to PXE');
-    logger.verbose(`Retrieving contract addresses from ${PXE_URL}`);
-    const l1Contracts = (await pxeClient.getNodeInfo()).l1ContractAddresses;
-    const { walletClient, publicClient } = createL1Clients(config.l1RpcUrls, account, foundry);
-    const deployL1ContractsValues = {
-        l1ContractAddresses: l1Contracts,
-        walletClient,
-        publicClient
-    };
-    const cheatCodes = await CheatCodes.create(config.l1RpcUrls, pxeClient);
-    const teardown = ()=>Promise.resolve();
-    await setupCanonicalFeeJuice(pxeClient);
-    logger.verbose('Constructing available wallets from already registered accounts...');
-    const initialFundedAccounts = await getDeployedTestAccounts(pxeClient);
-    const wallets = await getDeployedTestAccountsWallets(pxeClient);
-    if (wallets.length < numberOfAccounts) {
-        throw new Error(`Required ${numberOfAccounts} accounts. Found ${wallets.length}.`);
-    // Deploy new accounts if there's a test that requires more funded accounts in the remote environment.
-    }
-    return {
-        aztecNode,
-        sequencer: undefined,
-        proverNode: undefined,
-        pxe: pxeClient,
-        deployL1ContractsValues,
-        accounts: await pxeClient.getRegisteredAccounts(),
-        config,
-        initialFundedAccounts,
-        wallet: wallets[0],
-        wallets: wallets.slice(0, numberOfAccounts),
-        logger,
-        cheatCodes,
-        watcher: undefined,
-        dateProvider: undefined,
-        blobSink: undefined,
-        telemetryClient: 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 = {
-    customForwarderContractAddress: EthAddress.ZERO
-}, pxeOpts = {}, chain = foundry) {
-    const config = {
-        ...getConfigEnvVars(),
-        ...opts
-    };
-    config.peerCheckIntervalMS = TEST_PEER_CHECK_INTERVAL_MS;
-    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;
-    }
-    let anvil;
-    if (!config.l1RpcUrls?.length) {
-        if (!isAnvilTestChain(chain.id)) {
-            throw new Error(`No ETHEREUM_HOSTS set but non anvil chain requested`);
-        }
-        if (PXE_URL) {
-            throw new Error(`PXE_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
-        });
-        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 ethCheatCodes = new EthCheatCodesWithState(config.l1RpcUrls);
-    if (opts.stateLoad) {
-        await ethCheatCodes.loadChainState(opts.stateLoad);
-    }
-    if (opts.l1StartTime) {
-        await ethCheatCodes.warp(opts.l1StartTime);
-    }
-    let publisherPrivKey = undefined;
-    let publisherHdAccount = undefined;
-    if (config.publisherPrivateKey && config.publisherPrivateKey != NULL_KEY) {
-        publisherHdAccount = privateKeyToAccount(config.publisherPrivateKey);
-    } 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;
-        publisherPrivKey = publisherPrivKeyRaw === null ? null : Buffer.from(publisherPrivKeyRaw);
-        config.publisherPrivateKey = `0x${publisherPrivKey.toString('hex')}`;
-    }
-    // Made as separate values such that keys can change, but for test they will be the same.
-    config.validatorPrivateKey = config.publisherPrivateKey;
-    if (PXE_URL) {
-        // we are setting up against a remote environment, l1 contracts are assumed to already be deployed
-        return await setupWithRemoteEnvironment(publisherHdAccount, config, logger, numberOfAccounts);
-    }
-    // Blob sink service - blobs get posted here and served from here
-    const blobSinkPort = await getPort();
-    const blobSink = await createBlobSinkServer({
-        port: blobSinkPort
-    });
-    await blobSink.start();
-    config.blobSinkUrl = `http://localhost:${blobSinkPort}`;
-    const initialFundedAccounts = opts.initialFundedAccounts ?? await generateSchnorrAccounts(opts.numberOfInitialFundedAccounts ?? numberOfAccounts);
-    const { genesisBlockHash, genesisArchiveRoot, prefilledPublicData } = await getGenesisValues(initialFundedAccounts.map((a)=>a.address), opts.initialAccountFeeJuice, opts.genesisPublicData);
-    const deployL1ContractsValues = opts.deployL1ContractsValues ?? await setupL1Contracts(config.l1RpcUrls, publisherHdAccount, logger, {
-        ...opts,
-        genesisArchiveRoot,
-        genesisBlockHash
-    }, chain);
-    config.l1Contracts = deployL1ContractsValues.l1ContractAddresses;
-    if (opts.fundRewardDistributor) {
-        // Mints block rewards for 10000 blocks to the rewardDistributor contract
-        const rewardDistributor = getContract({
-            address: deployL1ContractsValues.l1ContractAddresses.rewardDistributorAddress.toString(),
-            abi: l1Artifacts.rewardDistributor.contractAbi,
-            client: deployL1ContractsValues.publicClient
-        });
-        const blockReward = await rewardDistributor.read.BLOCK_REWARD();
-        const mintAmount = 10_000n * blockReward;
-        const feeJuice = getContract({
-            address: deployL1ContractsValues.l1ContractAddresses.feeJuiceAddress.toString(),
-            abi: l1Artifacts.feeAsset.contractAbi,
-            client: deployL1ContractsValues.walletClient
-        });
-        const rewardDistributorMintTxHash = await feeJuice.write.mint([
-            rewardDistributor.address,
-            mintAmount
-        ], {});
-        await deployL1ContractsValues.publicClient.waitForTransactionReceipt({
-            hash: rewardDistributorMintTxHash
-        });
-        logger.info(`Funding rewardDistributor in ${rewardDistributorMintTxHash}`);
-    }
-    if (opts.l2StartTime) {
-        // This should only be used in synching test or when you need to have a stable
-        // timestamp for the first l2 block.
-        await ethCheatCodes.warp(opts.l2StartTime);
-    }
-    const dateProvider = new TestDateProvider();
-    const watcher = new AnvilTestWatcher(new EthCheatCodesWithState(config.l1RpcUrls), deployL1ContractsValues.l1ContractAddresses.rollupAddress, deployL1ContractsValues.publicClient, dateProvider);
-    await watcher.start();
-    logger.verbose('Creating and synching an aztec node...');
-    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;
-    }
-    config.l1PublishRetryIntervalMS = 100;
-    const telemetry = getTelemetryClient(opts.telemetryConfig);
-    const blobSinkClient = createBlobSinkClient(config);
-    const aztecNode = await AztecNodeService.createAndSync(config, {
-        dateProvider,
-        blobSinkClient
-    }, {
-        prefilledPublicData
-    });
-    const sequencer = aztecNode.getSequencer();
-    if (sequencer) {
-        const publisher = sequencer.sequencer.publisher;
-        publisher.l1TxUtils = DelayedTxUtils.fromL1TxUtils(publisher.l1TxUtils, config.ethereumSlotDuration);
-    }
-    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')}`;
-        proverNode = await createAndSyncProverNode(proverNodePrivateKeyHex, config, aztecNode, path.join(directoryToCleanup, randomBytes(8).toString('hex')));
-    }
-    logger.verbose('Creating a pxe...');
-    const { pxe, teardown: pxeTeardown } = await setupPXEService(aztecNode, pxeOpts, logger);
-    if (!config.skipProtocolContracts) {
-        logger.verbose('Setting up Fee Juice...');
-        await setupCanonicalFeeJuice(pxe);
-    }
-    const accountManagers = await deployFundedSchnorrAccounts(pxe, initialFundedAccounts.slice(0, numberOfAccounts));
-    const wallets = await Promise.all(accountManagers.map((account)=>account.getWallet()));
-    if (initialFundedAccounts.length < numberOfAccounts) {
-        // TODO: Create (numberOfAccounts - initialFundedAccounts.length) wallets without funds.
-        throw new Error(`Unable to deploy ${numberOfAccounts} accounts. Only ${initialFundedAccounts.length} accounts were funded.`);
-    }
-    const cheatCodes = await CheatCodes.create(config.l1RpcUrls, pxe);
-    const teardown = async ()=>{
-        await pxeTeardown();
-        if (aztecNode instanceof AztecNodeService) {
-            await aztecNode?.stop();
-        }
-        if (proverNode) {
-            await proverNode.stop();
-        }
-        if (acvmConfig?.cleanup) {
-            // remove the temp directory created for the acvm
-            logger.verbose(`Cleaning up ACVM state`);
-            await acvmConfig.cleanup();
-        }
-        if (bbConfig?.cleanup) {
-            // remove the temp directory created for the acvm
-            logger.verbose(`Cleaning up BB state`);
-            await bbConfig.cleanup();
-        }
-        await anvil?.stop().catch((err)=>getLogger().error(err));
-        await watcher.stop();
-        await blobSink?.stop();
-        if (directoryToCleanup) {
-            try {
-                logger.verbose(`Cleaning up data directory at ${directoryToCleanup}`);
-                await fs.rm(directoryToCleanup, {
-                    recursive: true,
-                    force: true,
-                    maxRetries: 3
-                });
-            } catch (err) {
-                logger.warn(`Failed to delete data directory at ${directoryToCleanup}: ${err}`);
-            }
-        }
-    };
-    return {
-        aztecNode,
-        blobSink,
-        cheatCodes,
-        config,
-        dateProvider,
-        deployL1ContractsValues,
-        initialFundedAccounts,
-        logger,
-        proverNode,
-        pxe,
-        sequencer,
-        teardown,
-        telemetryClient: telemetry,
-        wallet: wallets[0],
-        wallets,
-        watcher
-    };
-}
 /**
- * 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.
- * @param sender - Wallet to send the deployment tx.
- * @param accountsToDeploy - Which accounts to publicly deploy.
- */ // docs:start:public_deploy_accounts
-export async function ensureAccountsPubliclyDeployed(sender, accountsToDeploy) {
-    // We have to check whether the accounts are already deployed. This can happen if the test runs against
-    // the sandbox and the test accounts exist
-    const accountsAndAddresses = await Promise.all(accountsToDeploy.map(async (account)=>{
-        const address = account.getAddress();
-        return {
-            address,
-            deployed: (await sender.getContractMetadata(address)).isContractPubliclyDeployed
-        };
-    }));
-    const instances = (await Promise.all(accountsAndAddresses.filter(({ deployed })=>!deployed).map(({ address })=>sender.getContractMetadata(address)))).map((contractMetadata)=>contractMetadata.contractInstance);
-    const contractClass = await getContractClassFromArtifact(SchnorrAccountContractArtifact);
-    if (!(await sender.getContractClassMetadata(contractClass.id, true)).isContractClassPubliclyRegistered) {
-        await (await registerContractClass(sender, SchnorrAccountContractArtifact)).send().wait();
-    }
-    const requests = await Promise.all(instances.map(async (instance)=>(await deployInstance(sender, instance)).request()));
-    const batch = new BatchCall(sender, [
-        ...requests
-    ]);
-    await batch.send().wait();
-}
-// docs:end:public_deploy_accounts
-/**
- * Sets the timestamp of the next block.
- * @param rpcUrl - rpc url of the blockchain instance to connect to
- * @param timestamp - the timestamp for the next block
- */ export async function setNextBlockTimestamp(rpcUrl, timestamp) {
-    const params = `[${timestamp}]`;
-    await fetch(rpcUrl, {
-        body: `{"jsonrpc":"2.0", "method": "evm_setNextBlockTimestamp", "params": ${params}, "id": 1}`,
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json'
-        }
-    });
-}
-/** 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.
- * @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);
-}
-export function getBalancesFn(symbol, method, 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()));
-        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);
-}
-/**
- * Deploy the protocol contracts to a running instance.
- */ export async function setupCanonicalFeeJuice(pxe) {
-    // "deploy" the Fee Juice as it contains public functions
-    const feeJuicePortalAddress = (await pxe.getNodeInfo()).l1ContractAddresses.feeJuicePortalAddress;
-    const wallet = new SignerlessWallet(pxe);
-    const feeJuice = await FeeJuiceContract.at(ProtocolContractAddress.FeeJuice, wallet);
-    try {
-        const paymentMethod = new FeeJuicePaymentMethod(ProtocolContractAddress.FeeJuice);
-        await feeJuice.methods.initialize(feeJuicePortalAddress, FEE_JUICE_INITIAL_MINT).send({
-            fee: {
-                paymentMethod,
-                gasSettings: {
-                    teardownGasLimits: Gas.empty()
-                }
-            }
-        }).wait();
-        getLogger().info(`Fee Juice successfully setup. Portal address: ${feeJuicePortalAddress}`);
-    } catch (error) {
-        getLogger().warn(`Fee Juice might have already been setup. Got error: ${inspect(error)}.`);
-    }
-}
-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 async function createAndSyncProverNode(proverNodePrivateKey, aztecNodeConfig, aztecNode, dataDirectory, prefilledPublicData = []) {
-    // Disable stopping the aztec node as the prover coordination test will kill it otherwise
-    // This is only required when stopping the prover node for testing
-    const aztecNodeWithoutStop = {
-        getTxByHash: aztecNode.getTxByHash.bind(aztecNode),
-        getTxsByHash: aztecNode.getTxsByHash.bind(aztecNode),
-        stop: ()=>Promise.resolve()
-    };
-    const blobSinkClient = createBlobSinkClient(aztecNodeConfig);
-    // Creating temp store and archiver for simulated prover node
-    const archiverConfig = {
-        ...aztecNodeConfig,
-        dataDirectory
-    };
-    const archiver = await createArchiver(archiverConfig, blobSinkClient, {
-        blockUntilSync: true
-    });
-    // Prover node config is for simulated proofs
-    const proverConfig = {
-        ...aztecNodeConfig,
-        proverCoordinationNodeUrl: undefined,
-        dataDirectory: undefined,
-        realProofs: false,
-        proverAgentCount: 2,
-        publisherPrivateKey: proverNodePrivateKey,
-        proverNodeMaxPendingJobs: 10,
-        proverNodeMaxParallelBlocksPerEpoch: 32,
-        proverNodePollingIntervalMs: 200,
-        txGatheringTimeoutMs: 60000,
-        txGatheringIntervalMs: 1000,
-        txGatheringMaxParallelRequests: 100
-    };
-    const l1TxUtils = createDelayedL1TxUtils(aztecNodeConfig, proverNodePrivateKey, 'prover-node');
-    const proverNode = await createProverNode(proverConfig, {
-        aztecNodeTxProvider: aztecNodeWithoutStop,
-        archiver: archiver,
-        l1TxUtils
-    }, {
-        prefilledPublicData
-    });
-    getLogger().info(`Created and synced prover node`, {
-        publisherAddress: l1TxUtils.walletClient.account.address
-    });
-    proverNode.start();
-    return proverNode;
-}
-function createDelayedL1TxUtils(aztecNodeConfig, privateKey, logName) {
-    const { publicClient, walletClient } = createL1Clients(aztecNodeConfig.l1RpcUrls, privateKey, foundry);
-    const log = createLogger(logName);
-    const l1TxUtils = new DelayedTxUtils(publicClient, walletClient, log, aztecNodeConfig);
-    l1TxUtils.enableDelayer(aztecNodeConfig.ethereumSlotDuration);
-    return l1TxUtils;
-}
-export async function createForwarderContract(aztecNodeConfig, privateKey, rollupAddress) {
-    const { walletClient, publicClient } = createL1Clients(aztecNodeConfig.l1RpcUrls, privateKey, foundry);
-    const forwarderContract = await ForwarderContract.create(walletClient.account.address, walletClient, publicClient, createLogger('forwarder'), rollupAddress);
-    return forwarderContract;
-}
+ * Re-exports from the unified setup module for backward compatibility.
+ * Tests that previously used utils.ts should continue to work.
+ */ export { createAndSyncProverNode, deployAccounts, ensureAccountContractsPublished, expectMapping, expectMappingDelta, getBalancesFn, getLogger, getPrivateKeyFromIndex, getSponsoredFPCAddress, getSponsoredFPCInstance, publicDeployAccounts, registerSponsoredFPC, setup, setupPXEAndGetWallet, setupSharedBlobStorage, setupSponsoredFPC, startAnvil, teardown, waitForProvenChain } from './setup.js';
+export { deployAndInitializeTokenAndBridgeContracts } from '../shared/cross_chain_test_harness.js';

package/dest/fixtures/web3signer.d.ts

@@ -0,0 +1,5 @@
+export declare function createWeb3SignerKeystore(dir: string, ...privateKeys: string[]): Promise<void>;
+export declare function refreshWeb3Signer(url: string, ...expectedAddresses: string[]): Promise<void>;
+export declare function getWeb3SignerTestKeystoreDir(): string;
+export declare function getWeb3SignerUrl(): string;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2ViM3NpZ25lci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ZpeHR1cmVzL3dlYjNzaWduZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBU0Esd0JBQXNCLHdCQUF3QixDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsR0FBRyxXQUFXLEVBQUUsTUFBTSxFQUFFLGlCQWNuRjtBQUVELHdCQUFzQixpQkFBaUIsQ0FBQyxHQUFHLEVBQUUsTUFBTSxFQUFFLEdBQUcsaUJBQWlCLEVBQUUsTUFBTSxFQUFFLGlCQW9CbEY7QUFFRCx3QkFBZ0IsNEJBQTRCLElBQUksTUFBTSxDQU9yRDtBQUVELHdCQUFnQixnQkFBZ0IsSUFBSSxNQUFNLENBTXpDIn0=

package/dest/fixtures/web3signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3signer.d.ts","sourceRoot":"","sources":["../../src/fixtures/web3signer.ts"],"names":[],"mappings":"AASA,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,iBAcnF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,MAAM,EAAE,iBAoBlF;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAOrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC"}

package/dest/fixtures/web3signer.js

@@ -0,0 +1,53 @@
+import { randomBytes } from '@aztec/foundation/crypto/random';
+import { retryUntil } from '@aztec/foundation/retry';
+import { sleep } from '@aztec/foundation/sleep';
+import { RemoteSigner } from '@aztec/node-keystore';
+import { mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function createWeb3SignerKeystore(dir, ...privateKeys) {
+    const yaml = privateKeys.map((pk)=>`\
+type: file-raw
+keyType: SECP256K1
+privateKey: ${pk}`).join('\n---\n');
+    // NOTE: nodejs stdlib can only create temp directories, not temp files!
+    // this write uses wx (write-exclusive) so it'll throw if the file already exists
+    const path = join(dir, `keystore-${randomBytes(4).toString('hex')}.yaml`);
+    await writeFile(path, yaml, {
+        flag: 'wx'
+    });
+}
+export async function refreshWeb3Signer(url, ...expectedAddresses) {
+    await fetch(new URL('reload', url), {
+        method: 'POST'
+    });
+    if (expectedAddresses.length > 0) {
+        await retryUntil(async ()=>{
+            try {
+                await RemoteSigner.validateAccess(url, expectedAddresses);
+                return true;
+            } catch  {
+                return false;
+            }
+        }, 'web3signer refresh', 10, 0.5);
+    } else {
+        await sleep(1000);
+    }
+}
+export function getWeb3SignerTestKeystoreDir() {
+    if (process.env.WEB3_SIGNER_TEST_KEYSTORE_DIR) {
+        mkdirSync(process.env.WEB3_SIGNER_TEST_KEYSTORE_DIR, {
+            recursive: true
+        });
+        return process.env.WEB3_SIGNER_TEST_KEYSTORE_DIR;
+    } else {
+        throw new Error('Web3signer not running');
+    }
+}
+export function getWeb3SignerUrl() {
+    if (process.env.WEB3_SIGNER_URL) {
+        return process.env.WEB3_SIGNER_URL;
+    } else {
+        throw new Error('Web3signer not running');
+    }
+}

package/dest/fixtures/with_telemetry_utils.d.ts

@@ -1,3 +1,3 @@
 import { type TelemetryClient } from '@aztec/telemetry-client';
-export declare function getEndToEndTestTelemetryClient(metricsPort?: number): TelemetryClient;
-//# sourceMappingURL=with_telemetry_utils.d.ts.map
+export declare function getEndToEndTestTelemetryClient(metricsPort?: number): Promise<TelemetryClient>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2l0aF90ZWxlbWV0cnlfdXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9maXh0dXJlcy93aXRoX3RlbGVtZXRyeV91dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQ0wsS0FBSyxlQUFlLEVBSXJCLE1BQU0seUJBQXlCLENBQUM7QUFHakMsd0JBQXNCLDhCQUE4QixDQUFDLFdBQVcsQ0FBQyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsZUFBZSxDQUFDLENBTW5HIn0=

package/dest/fixtures/with_telemetry_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with_telemetry_utils.d.ts","sourceRoot":"","sources":["../../src/fixtures/with_telemetry_utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,yBAAyB,CAAC;AAGjC,wBAAgB,8BAA8B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAMpF"}
+{"version":3,"file":"with_telemetry_utils.d.ts","sourceRoot":"","sources":["../../src/fixtures/with_telemetry_utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,yBAAyB,CAAC;AAGjC,wBAAsB,8BAA8B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMnG"}

package/dest/fixtures/with_telemetry_utils.js

@@ -1,14 +1,14 @@
 import { levels, registerLoggingStream } from '@aztec/foundation/log';
 import { getConfigEnvVars as getTelemetryConfig, initTelemetryClient } from '@aztec/telemetry-client';
 import { OTelPinoStream } from '@aztec/telemetry-client/otel-pino-stream';
-export function getEndToEndTestTelemetryClient(metricsPort) {
+export async function getEndToEndTestTelemetryClient(metricsPort) {
     if (metricsPort) {
         const otelStream = new OTelPinoStream({
             levels
         });
         registerLoggingStream(otelStream);
     }
-    return initTelemetryClient(getEndToEndTestTelemetryConfig(metricsPort));
+    return await initTelemetryClient(getEndToEndTestTelemetryConfig(metricsPort));
 }
 /**
  * Utility functions for setting up end-to-end tests with telemetry.

package/dest/index.d.ts

@@ -1,2 +1,2 @@
 export * from './shared/index.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxjQUFjLG1CQUFtQixDQUFDIn0=