@aztec-labs/ethereum 6.0.0-nightly.20260829

package/README.md

@@ -0,0 +1,3 @@
+# Ethereum
+
+This package provides configuration and code for common chain operations such as contract deployment etc.

package/dest/account.d.ts

@@ -0,0 +1,2 @@
+export declare function getAddressFromPrivateKey(privateKey: `0x${string}`): `0x${string}`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2FjY291bnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsd0JBQWdCLHdCQUF3QixDQUFDLFVBQVUsRUFBRSxLQUFLLE1BQU0sRUFBRSxHQUFHLEtBQUssTUFBTSxFQUFFLENBRWpGIn0=

package/dest/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAEA,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,CAEjF"}

package/dest/account.js

@@ -0,0 +1,4 @@
+import { privateKeyToAccount } from 'viem/accounts';
+export function getAddressFromPrivateKey(privateKey) {
+    return privateKeyToAccount(privateKey).address;
+}

package/dest/chain.d.ts

@@ -0,0 +1,25 @@
+import type { Chain } from 'viem';
+/**
+ * Interface containing the connection and chain properties to interact with a blockchain.
+ */
+export interface EthereumChain {
+    /**
+     * An instance of the viem chain data.
+     */
+    chainInfo: Chain;
+    /**
+     * The list of actual urls to be used.
+     */
+    rpcUrls: string[];
+}
+/**
+ * Helper function to create an instance of Aztec Chain from an rpc url and chain id.
+ * @param rpcUrls - The rpc url of the chain or a chain identifier (e.g. 'http://localhost:8545')
+ * @param chainId - The chain id of the chain or a chain identifier (e.g. 1337)
+ */
+export declare function createEthereumChain(rpcUrls: string[], _chainId: number | string): EthereumChain;
+/**
+ * Helper function to determine if a chain id is an instance of Anvil
+ */
+export declare function isAnvilTestChain(_chainId: number | string): boolean;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhaW4uZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jaGFpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFLbEM7O0dBRUc7QUFDSCxNQUFNLFdBQVcsYUFBYTtJQUM1Qjs7T0FFRztJQUNILFNBQVMsRUFBRSxLQUFLLENBQUM7SUFFakI7O09BRUc7SUFDSCxPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7Q0FDbkI7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRSxRQUFRLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxhQUFhLENBK0IvRjtBQUVEOztHQUVHO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLFFBQVEsRUFBRSxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sQ0FTbkUifQ==

package/dest/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAKlC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CA+B/F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CASnE"}

package/dest/chain.js

@@ -0,0 +1,53 @@
+import { foundry } from 'viem/chains';
+import { AZTEC_TEST_CHAIN_ID } from './constants.js';
+/**
+ * Helper function to create an instance of Aztec Chain from an rpc url and chain id.
+ * @param rpcUrls - The rpc url of the chain or a chain identifier (e.g. 'http://localhost:8545')
+ * @param chainId - The chain id of the chain or a chain identifier (e.g. 1337)
+ */ export function createEthereumChain(rpcUrls, _chainId) {
+    let chainId;
+    if (typeof _chainId === 'string') {
+        chainId = +_chainId;
+    } else {
+        chainId = _chainId;
+    }
+    if (chainId) {
+        return {
+            chainInfo: {
+                id: chainId,
+                name: 'Ethereum',
+                rpcUrls: {
+                    default: {
+                        http: rpcUrls
+                    }
+                },
+                nativeCurrency: {
+                    decimals: 18,
+                    name: 'Ether',
+                    symbol: 'ETH'
+                }
+            },
+            rpcUrls
+        };
+    } else {
+        return {
+            chainInfo: foundry,
+            rpcUrls
+        };
+    }
+}
+/**
+ * Helper function to determine if a chain id is an instance of Anvil
+ */ export function isAnvilTestChain(_chainId) {
+    let chainId;
+    if (typeof _chainId === 'string') {
+        chainId = +_chainId;
+    } else {
+        chainId = _chainId;
+    }
+    const testChains = [
+        foundry.id,
+        AZTEC_TEST_CHAIN_ID
+    ];
+    return testChains.includes(chainId);
+}

package/dest/client.d.ts

@@ -0,0 +1,42 @@
+import type { Logger } from '@aztec-labs/foundation/log';
+import { type Chain, type FallbackTransport, type HDAccount, type HttpTransport, type LocalAccount, type PrivateKeyAccount } from 'viem';
+import type { ExtendedViemWalletClient, ViemPublicClient } from './types.js';
+type Config = {
+    /** List of URLs of Ethereum RPC nodes that services will connect to (comma separated). */
+    l1RpcUrls: string[];
+    /** The chain ID of the ethereum host. */
+    l1ChainId: number;
+    /** The polling interval viem uses in ms */
+    viemPollingIntervalMS?: number;
+    /** Timeout for HTTP requests to the L1 RPC node in ms. */
+    l1HttpTimeoutMS?: number;
+};
+export type { Config as EthereumClientConfig };
+/** Error exposed by L1 RPC transports without including provider URLs in its message. */
+export declare class L1RpcError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Creates a viem fallback HTTP transport for the given L1 RPC URLs. */
+export declare function makeL1HttpTransport(rpcUrls: string[], opts?: {
+    timeout?: number;
+}): FallbackTransport<HttpTransport[]>;
+/** Returns the HTTP status from an L1 RPC error's cause chain, if one is available. */
+export declare function getL1RpcHttpStatus(err: unknown): number | undefined;
+/** Returns true when an L1 RPC error's cause chain contains the given HTTP status. */
+export declare function isL1RpcHttpStatus(err: unknown, status: number): boolean;
+/** Returns the JSON-RPC error code reported by the L1 node, if the error's cause chain carries one. */
+export declare function getL1RpcErrorCode(err: unknown): number | undefined;
+/**
+ * Returns the individual RPC URLs underlying a viem public client that was constructed with a
+ * fallback HTTP transport (see {@link makeL1HttpTransport}). Returns an empty array if the
+ * transport shape is not recognized (e.g. mock clients in tests, or non-fallback transports).
+ */
+export declare function getRpcUrlsFromClient(client: ViemPublicClient): string[];
+/** Returns a viem public client given the L1 config. */
+export declare function getPublicClient(config: Config): ViemPublicClient;
+/** Returns a viem public client after waiting for the L1 RPC node to become available. */
+export declare function waitForPublicClient(config: Config, logger?: Logger): Promise<ViemPublicClient>;
+export declare function createExtendedL1Client(rpcUrls: string[], mnemonicOrPrivateKeyOrHdAccount: string | HDAccount | PrivateKeyAccount | LocalAccount, chain?: Chain, pollingIntervalMS?: number, addressIndex?: number, opts?: {
+    httpTimeoutMS?: number;
+}): ExtendedViemWalletClient;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBR3pELE9BQU8sRUFDTCxLQUFLLEtBQUssRUFDVixLQUFLLGlCQUFpQixFQUN0QixLQUFLLFNBQVMsRUFFZCxLQUFLLGFBQWEsRUFDbEIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssaUJBQWlCLEVBT3ZCLE1BQU0sTUFBTSxDQUFDO0FBS2QsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFN0UsS0FBSyxNQUFNLEdBQUc7SUFDWiwwRkFBMEY7SUFDMUYsU0FBUyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ3BCLHlDQUF5QztJQUN6QyxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLDJDQUEyQztJQUMzQyxxQkFBcUIsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUMvQiwwREFBMEQ7SUFDMUQsZUFBZSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQzFCLENBQUM7QUFFRixZQUFZLEVBQUUsTUFBTSxJQUFJLG9CQUFvQixFQUFFLENBQUM7QUFFL0MseUZBQXlGO0FBQ3pGLHFCQUFhLFVBQVcsU0FBUSxLQUFLO0lBQ25DLFlBQVksT0FBTyxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQUMsRUFBRSxZQUFZLEVBR2xEO0NBQ0Y7QUFFRCx3RUFBd0U7QUFDeEUsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRSxJQUFJLENBQUMsRUFBRTtJQUFFLE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQTtDQUFFLHNDQUVqRjtBQUVELHVGQUF1RjtBQUN2Rix3QkFBZ0Isa0JBQWtCLENBQUMsR0FBRyxFQUFFLE9BQU8sR0FBRyxNQUFNLEdBQUcsU0FBUyxDQUVuRTtBQUVELHNGQUFzRjtBQUN0Rix3QkFBZ0IsaUJBQWlCLENBQUMsR0FBRyxFQUFFLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FFdkU7QUFFRCx1R0FBdUc7QUFDdkcsd0JBQWdCLGlCQUFpQixDQUFDLEdBQUcsRUFBRSxPQUFPLEdBQUcsTUFBTSxHQUFHLFNBQVMsQ0FFbEU7QUFrQkQ7Ozs7R0FJRztBQUNILHdCQUFnQixvQkFBb0IsQ0FBQyxNQUFNLEVBQUUsZ0JBQWdCLEdBQUcsTUFBTSxFQUFFLENBV3ZFO0FBSUQsd0RBQXdEO0FBQ3hELHdCQUFnQixlQUFlLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxnQkFBZ0IsQ0FPaEU7QUFFRCwwRkFBMEY7QUFDMUYsd0JBQXNCLG1CQUFtQixDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUlwRztBQXlCRCx3QkFBZ0Isc0JBQXNCLENBQ3BDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFDakIsK0JBQStCLEVBQUUsTUFBTSxHQUFHLFNBQVMsR0FBRyxpQkFBaUIsR0FBRyxZQUFZLEVBQ3RGLEtBQUssR0FBRSxLQUFlLEVBQ3RCLGlCQUFpQixDQUFDLEVBQUUsTUFBTSxFQUMxQixZQUFZLENBQUMsRUFBRSxNQUFNLEVBQ3JCLElBQUksQ0FBQyxFQUFFO0lBQUUsYUFBYSxDQUFDLEVBQUUsTUFBTSxDQUFBO0NBQUUsR0FDaEMsd0JBQXdCLENBZ0IxQiJ9

package/dest/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,EACL,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAEd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAOvB,MAAM,MAAM,CAAC;AAKd,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7E,KAAK,MAAM,GAAG;IACZ,0FAA0F;IAC1F,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,YAAY,EAAE,MAAM,IAAI,oBAAoB,EAAE,CAAC;AAE/C,yFAAyF;AACzF,qBAAa,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,sCAEjF;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEnE;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAElE;AAkBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAWvE;AAID,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAOhE;AAED,0FAA0F;AAC1F,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIpG;AAyBD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,EACjB,+BAA+B,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,YAAY,EACtF,KAAK,GAAE,KAAe,EACtB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,wBAAwB,CAgB1B"}

package/dest/client.js

@@ -0,0 +1,104 @@
+import { retryUntil } from '@aztec-labs/foundation/retry';
+import { getErrorCause } from '@aztec-labs/foundation/types';
+import { HttpRequestError, RpcRequestError, createPublicClient, createWalletClient, fallback, http, publicActions } from 'viem';
+import { mnemonicToAccount, privateKeyToAccount } from 'viem/accounts';
+import { foundry } from 'viem/chains';
+import { createEthereumChain } from './chain.js';
+/** Error exposed by L1 RPC transports without including provider URLs in its message. */ export class L1RpcError extends Error {
+    constructor(message, options){
+        super(message, options);
+        this.name = 'L1RpcError';
+    }
+}
+/** Creates a viem fallback HTTP transport for the given L1 RPC URLs. */ export function makeL1HttpTransport(rpcUrls, opts) {
+    return wrapL1RpcTransport(fallback(rpcUrls.map((url)=>http(url, {
+            batch: false,
+            timeout: opts?.timeout
+        }))));
+}
+/** Returns the HTTP status from an L1 RPC error's cause chain, if one is available. */ export function getL1RpcHttpStatus(err) {
+    return getErrorCause(err, HttpRequestError)?.status;
+}
+/** Returns true when an L1 RPC error's cause chain contains the given HTTP status. */ export function isL1RpcHttpStatus(err, status) {
+    return getL1RpcHttpStatus(err) === status;
+}
+/** Returns the JSON-RPC error code reported by the L1 node, if the error's cause chain carries one. */ export function getL1RpcErrorCode(err) {
+    return getErrorCause(err, RpcRequestError)?.code;
+}
+function wrapL1RpcTransport(transport) {
+    const wrappedTransport = (parameters)=>{
+        const fallbackTransport = transport(parameters);
+        const request = async (args)=>{
+            try {
+                return await fallbackTransport.request(args);
+            } catch (err) {
+                throw err instanceof L1RpcError ? err : new L1RpcError('L1 RPC request failed', {
+                    cause: err
+                });
+            }
+        };
+        return {
+            ...fallbackTransport,
+            request
+        };
+    };
+    return wrappedTransport;
+}
+/**
+ * Returns the individual RPC URLs underlying a viem public client that was constructed with a
+ * fallback HTTP transport (see {@link makeL1HttpTransport}). Returns an empty array if the
+ * transport shape is not recognized (e.g. mock clients in tests, or non-fallback transports).
+ */ export function getRpcUrlsFromClient(client) {
+    const transport = client.transport;
+    if (Array.isArray(transport?.transports)) {
+        return transport.transports.map((t)=>t?.value?.url).filter((url)=>typeof url === 'string');
+    }
+    const singleUrl = transport?.value?.url ?? transport?.url;
+    return typeof singleUrl === 'string' ? [
+        singleUrl
+    ] : [];
+}
+// TODO: Use these methods to abstract the creation of viem clients.
+/** Returns a viem public client given the L1 config. */ export function getPublicClient(config) {
+    const chain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
+    return createPublicClient({
+        chain: chain.chainInfo,
+        transport: makeL1HttpTransport(config.l1RpcUrls, {
+            timeout: config.l1HttpTimeoutMS
+        }),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+}
+/** Returns a viem public client after waiting for the L1 RPC node to become available. */ export async function waitForPublicClient(config, logger) {
+    const client = getPublicClient(config);
+    await waitForRpc(client, config, logger);
+    return client;
+}
+async function waitForRpc(client, config, logger) {
+    const l1ChainId = await retryUntil(async ()=>{
+        let chainId = 0;
+        try {
+            chainId = await client.getChainId();
+        } catch  {
+            logger?.warn(`Failed to connect to Ethereum node at ${config.l1RpcUrls.join(', ')}. Retrying...`);
+        }
+        return chainId;
+    }, `L1 RPC url at ${config.l1RpcUrls.join(', ')}`, 600, 1);
+    if (l1ChainId !== config.l1ChainId) {
+        throw new Error(`Ethereum node at ${config.l1RpcUrls.join(', ')} has chain ID ${l1ChainId} but expected ${config.l1ChainId}`);
+    }
+}
+export function createExtendedL1Client(rpcUrls, mnemonicOrPrivateKeyOrHdAccount, chain = foundry, pollingIntervalMS, addressIndex, opts) {
+    const hdAccount = typeof mnemonicOrPrivateKeyOrHdAccount === 'string' ? mnemonicOrPrivateKeyOrHdAccount.startsWith('0x') ? privateKeyToAccount(mnemonicOrPrivateKeyOrHdAccount) : mnemonicToAccount(mnemonicOrPrivateKeyOrHdAccount, {
+        addressIndex
+    }) : mnemonicOrPrivateKeyOrHdAccount;
+    const extendedClient = createWalletClient({
+        account: hdAccount,
+        chain,
+        transport: makeL1HttpTransport(rpcUrls, {
+            timeout: opts?.httpTimeoutMS
+        }),
+        pollingInterval: pollingIntervalMS
+    }).extend(publicActions);
+    return extendedClient;
+}

package/dest/config.d.ts

@@ -0,0 +1,103 @@
+import { type ConfigMappingsType } from '@aztec-labs/foundation/config';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type L1TxUtilsConfig } from './l1_tx_utils/config.js';
+export type GenesisStateConfig = {
+    /** Whether to populate the genesis state with initial fee juice for the test accounts */
+    testAccounts: boolean;
+    /** Whether to populate the genesis state with initial fee juice for the sponsored FPC */
+    sponsoredFPC: boolean;
+    /** Additional addresses to prefund with fee juice at genesis */
+    prefundAddresses: string[];
+};
+export type L1ContractsConfig = {
+    /** How many seconds an L1 slot lasts. */
+    ethereumSlotDuration: number;
+    /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */
+    aztecSlotDuration: number;
+    /** How many L2 slots an epoch lasts. */
+    aztecEpochDuration: number;
+    /** The target validator committee size. */
+    aztecTargetCommitteeSize: number;
+    /** The number of epochs to lag behind the current epoch for validator selection. */
+    lagInEpochsForValidatorSet: number;
+    /** The number of epochs to lag behind the current epoch for randao selection. */
+    lagInEpochsForRandao: number;
+    /** The number of epochs after an epoch ends that proofs are still accepted. */
+    aztecProofSubmissionEpochs: number;
+    /** The deposit amount for a validator */
+    activationThreshold: bigint;
+    /** The minimum stake for a validator. */
+    ejectionThreshold: bigint;
+    /** The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup */
+    localEjectionThreshold: bigint;
+    /** The slashing quorum, i.e. how many slots must signal for the same payload in a round for it to be submittable to the Slasher (defaults to slashRoundSize / 2 + 1) */
+    slashingQuorum?: number;
+    /** The slashing round size, i.e. how many epochs are in a slashing round */
+    slashingRoundSizeInEpochs: number;
+    /** The slashing lifetime in rounds. I.e., if 1, round N must be submitted before round N + 2 */
+    slashingLifetimeInRounds: number;
+    /** The slashing execution delay in rounds. I.e., if 1, round N may not be submitted until round N + 2 */
+    slashingExecutionDelayInRounds: number;
+    /** The slashing vetoer. May blacklist a payload from being submitted. */
+    slashingVetoer: EthAddress;
+    /** How many slashing rounds back we slash (ie when slashing in round N, we slash for offenses committed during epochs of round N-offset) */
+    slashingOffsetInRounds: number;
+    /** How long slashing can be disabled for in seconds when vetoer disables it */
+    slashingDisableDuration: number;
+    /** Whether to deploy a slasher proposer */
+    slasherEnabled: boolean;
+    /** Minimum amount that can be slashed */
+    slashAmountSmall: bigint;
+    /** Medium amount to slash */
+    slashAmountMedium: bigint;
+    /** Largest amount that can be slashed per round */
+    slashAmountLarge: bigint;
+    /** Governance proposing quorum (defaults to roundSize/2 + 1) */
+    governanceProposerQuorum?: number;
+    /** Governance proposing round size */
+    governanceProposerRoundSize: number;
+    /** Governance voting duration in seconds (only for local/devnet/next-net, default 3600) */
+    governanceVotingDuration?: number;
+    /** The mana target for the rollup */
+    manaTarget: bigint;
+    /** The proving cost per mana */
+    provingCostPerMana: bigint;
+    /** The initial ETH per fee asset price (with 1e12 precision) */
+    initialEthPerFeeAsset: bigint;
+    /** The number of seconds to wait for an exit */
+    exitDelaySeconds: number;
+    /** Validator set size at or below which the entry queue uses the bootstrap flush size. */
+    entryQueueBootstrapValidatorSetSize: number;
+    /** Number of validators admitted from the entry queue per flush during the bootstrap phase. */
+    entryQueueBootstrapFlushSize: number;
+    /** Minimum number of validators admitted from the entry queue per flush. */
+    entryQueueFlushSizeMin: number;
+    /** Divisor applied to the queue size to derive the normal per-flush admission count. */
+    entryQueueFlushSizeQuotient: number;
+    /** Maximum number of validators admitted from the entry queue per flush. */
+    entryQueueMaxFlushSize: number;
+} & L1TxUtilsConfig;
+/**
+ * Config mappings for L1ContractsConfig.
+ * Default values come from l1-contracts/scripts/network-defaults.json (published via @aztec/l1-artifacts).
+ * Real deployments use forge scripts which require explicit env vars (vm.envUint).
+ */
+export declare const l1ContractsConfigMappings: ConfigMappingsType<L1ContractsConfig>;
+/**
+ * Default L1 contracts configuration derived from l1ContractsConfigMappings.
+ * Source of truth: l1-contracts/scripts/network-defaults.json (published via @aztec/l1-artifacts).
+ */
+export declare const DefaultL1ContractsConfig: L1ContractsConfig;
+/**
+ * Validates that `ethereumSlotDuration` and `aztecSlotDuration` are positive and that the L2 slot is an exact
+ * multiple of the L1 slot. Every L2 slot boundary must land on an L1 slot boundary; a non-multiple pairing
+ * desyncs the epoch/checkpoint timing math throughout the sequencer, validator client, and timetables. Returns
+ * a list of error messages (empty when valid).
+ */
+export declare function validateSlotDurations(config: Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration'>): string[];
+/** Throws if {@link validateSlotDurations} reports any errors. */
+export declare function assertValidSlotDurations(config: Pick<L1ContractsConfig, 'ethereumSlotDuration' | 'aztecSlotDuration'>): void;
+export declare const genesisStateConfigMappings: ConfigMappingsType<GenesisStateConfig>;
+export declare function getL1ContractsConfigEnvVars(): L1ContractsConfig;
+export declare function getGenesisStateConfigEnvVars(): GenesisStateConfig;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFDTCxLQUFLLGtCQUFrQixFQVF4QixNQUFNLCtCQUErQixDQUFDO0FBQ3ZDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxvQ0FBb0MsQ0FBQztBQUVoRSxPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQTJCLE1BQU0seUJBQXlCLENBQUM7QUFFeEYsTUFBTSxNQUFNLGtCQUFrQixHQUFHO0lBQy9CLHlGQUF5RjtJQUN6RixZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLHlGQUF5RjtJQUN6RixZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLGdFQUFnRTtJQUNoRSxnQkFBZ0IsRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUM1QixDQUFDO0FBRUYsTUFBTSxNQUFNLGlCQUFpQixHQUFHO0lBQzlCLHlDQUF5QztJQUN6QyxvQkFBb0IsRUFBRSxNQUFNLENBQUM7SUFDN0IsdUZBQXVGO0lBQ3ZGLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUMxQix3Q0FBd0M7SUFDeEMsa0JBQWtCLEVBQUUsTUFBTSxDQUFDO0lBQzNCLDJDQUEyQztJQUMzQyx3QkFBd0IsRUFBRSxNQUFNLENBQUM7SUFDakMsb0ZBQW9GO0lBQ3BGLDBCQUEwQixFQUFFLE1BQU0sQ0FBQztJQUNuQyxpRkFBaUY7SUFDakYsb0JBQW9CLEVBQUUsTUFBTSxDQUFDO0lBQzdCLCtFQUErRTtJQUMvRSwwQkFBMEIsRUFBRSxNQUFNLENBQUM7SUFDbkMseUNBQXlDO0lBQ3pDLG1CQUFtQixFQUFFLE1BQU0sQ0FBQztJQUM1Qix5Q0FBeUM7SUFDekMsaUJBQWlCLEVBQUUsTUFBTSxDQUFDO0lBQzFCLG1IQUFtSDtJQUNuSCxzQkFBc0IsRUFBRSxNQUFNLENBQUM7SUFDL0Isd0tBQXdLO0lBQ3hLLGNBQWMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN4Qiw0RUFBNEU7SUFDNUUseUJBQXlCLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLGdHQUFnRztJQUNoRyx3QkFBd0IsRUFBRSxNQUFNLENBQUM7SUFDakMseUdBQXlHO0lBQ3pHLDhCQUE4QixFQUFFLE1BQU0sQ0FBQztJQUN2Qyx5RUFBeUU7SUFDekUsY0FBYyxFQUFFLFVBQVUsQ0FBQztJQUMzQiw0SUFBNEk7SUFDNUksc0JBQXNCLEVBQUUsTUFBTSxDQUFDO0lBQy9CLCtFQUErRTtJQUMvRSx1QkFBdUIsRUFBRSxNQUFNLENBQUM7SUFDaEMsMkNBQTJDO0lBQzNDLGNBQWMsRUFBRSxPQUFPLENBQUM7SUFDeEIseUNBQXlDO0lBQ3pDLGdCQUFnQixFQUFFLE1BQU0sQ0FBQztJQUN6Qiw2QkFBNkI7SUFDN0IsaUJBQWlCLEVBQUUsTUFBTSxDQUFDO0lBQzFCLG1EQUFtRDtJQUNuRCxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFDekIsZ0VBQWdFO0lBQ2hFLHdCQUF3QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLHNDQUFzQztJQUN0QywyQkFBMkIsRUFBRSxNQUFNLENBQUM7SUFDcEMsMkZBQTJGO0lBQzNGLHdCQUF3QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLHFDQUFxQztJQUNyQyxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLGdDQUFnQztJQUNoQyxrQkFBa0IsRUFBRSxNQUFNLENBQUM7SUFDM0IsZ0VBQWdFO0lBQ2hFLHFCQUFxQixFQUFFLE1BQU0sQ0FBQztJQUM5QixnREFBZ0Q7SUFDaEQsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0lBQ3pCLDBGQUEwRjtJQUMxRixtQ0FBbUMsRUFBRSxNQUFNLENBQUM7SUFDNUMsK0ZBQStGO0lBQy9GLDRCQUE0QixFQUFFLE1BQU0sQ0FBQztJQUNyQyw0RUFBNEU7SUFDNUUsc0JBQXNCLEVBQUUsTUFBTSxDQUFDO0lBQy9CLHdGQUF3RjtJQUN4RiwyQkFBMkIsRUFBRSxNQUFNLENBQUM7SUFDcEMsNEVBQTRFO0lBQzVFLHNCQUFzQixFQUFFLE1BQU0sQ0FBQztDQUNoQyxHQUFHLGVBQWUsQ0FBQztBQUVwQjs7OztHQUlHO0FBQ0gsZUFBTyxNQUFNLHlCQUF5QixFQUFFLGtCQUFrQixDQUFDLGlCQUFpQixDQTBLM0UsQ0FBQztBQUVGOzs7R0FHRztBQUNILGVBQU8sTUFBTSx3QkFBd0IsbUJBQThDLENBQUM7QUFFcEY7Ozs7O0dBS0c7QUFDSCx3QkFBZ0IscUJBQXFCLENBQ25DLE1BQU0sRUFBRSxJQUFJLENBQUMsaUJBQWlCLEVBQUUsc0JBQXNCLEdBQUcsbUJBQW1CLENBQUMsR0FDNUUsTUFBTSxFQUFFLENBZVY7QUFFRCxrRUFBa0U7QUFDbEUsd0JBQWdCLHdCQUF3QixDQUN0QyxNQUFNLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixFQUFFLHNCQUFzQixHQUFHLG1CQUFtQixDQUFDLEdBQzVFLElBQUksQ0FLTjtBQUVELGVBQU8sTUFBTSwwQkFBMEIsRUFBRSxrQkFBa0IsQ0FBQyxrQkFBa0IsQ0FxQjdFLENBQUM7QUFFRix3QkFBZ0IsMkJBQTJCLElBQUksaUJBQWlCLENBRS9EO0FBRUQsd0JBQWdCLDRCQUE0QixJQUFJLGtCQUFrQixDQUVqRSJ9

package/dest/config.d.ts.map

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

package/dest/config.js

@@ -0,0 +1,233 @@
+import l1ContractsDefaultEnv from '@aztec/l1-artifacts/network-defaults.json' with {
+    type: 'json'
+};
+import { bigintConfigHelper, booleanConfigHelper, getConfigFromMappings, getDefaultConfig, numberConfigHelper, omitConfigMappings, optionalNumberConfigHelper } from '@aztec-labs/foundation/config';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { l1TxUtilsConfigMappings } from './l1_tx_utils/config.js';
+/**
+ * Config mappings for L1ContractsConfig.
+ * Default values come from l1-contracts/scripts/network-defaults.json (published via @aztec/l1-artifacts).
+ * Real deployments use forge scripts which require explicit env vars (vm.envUint).
+ */ export const l1ContractsConfigMappings = {
+    ethereumSlotDuration: {
+        env: 'ETHEREUM_SLOT_DURATION',
+        description: 'How many seconds an L1 slot lasts.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.ETHEREUM_SLOT_DURATION)
+    },
+    aztecSlotDuration: {
+        env: 'AZTEC_SLOT_DURATION',
+        description: 'How many seconds an L2 slots lasts (must be multiple of ethereum slot duration).',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLOT_DURATION)
+    },
+    aztecEpochDuration: {
+        env: 'AZTEC_EPOCH_DURATION',
+        description: `How many L2 slots an epoch lasts (maximum MAX_CHECKPOINTS_PER_EPOCH).`,
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EPOCH_DURATION)
+    },
+    aztecTargetCommitteeSize: {
+        env: 'AZTEC_TARGET_COMMITTEE_SIZE',
+        description: 'The target validator committee size.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_TARGET_COMMITTEE_SIZE)
+    },
+    lagInEpochsForValidatorSet: {
+        env: 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET',
+        description: 'The number of epochs to lag behind the current epoch for validator selection.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET)
+    },
+    lagInEpochsForRandao: {
+        env: 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO',
+        description: 'The number of epochs to lag behind the current epoch for randao selection.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_LAG_IN_EPOCHS_FOR_RANDAO)
+    },
+    aztecProofSubmissionEpochs: {
+        env: 'AZTEC_PROOF_SUBMISSION_EPOCHS',
+        description: 'The number of epochs after an epoch ends that proofs are still accepted.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_PROOF_SUBMISSION_EPOCHS)
+    },
+    activationThreshold: {
+        env: 'AZTEC_ACTIVATION_THRESHOLD',
+        description: 'The deposit amount for a validator',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_ACTIVATION_THRESHOLD))
+    },
+    ejectionThreshold: {
+        env: 'AZTEC_EJECTION_THRESHOLD',
+        description: 'The minimum stake for a validator.',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_EJECTION_THRESHOLD))
+    },
+    localEjectionThreshold: {
+        env: 'AZTEC_LOCAL_EJECTION_THRESHOLD',
+        description: 'The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_LOCAL_EJECTION_THRESHOLD))
+    },
+    slashingOffsetInRounds: {
+        env: 'AZTEC_SLASHING_OFFSET_IN_ROUNDS',
+        description: 'How many slashing rounds back we slash (ie when slashing in round N, we slash for offenses committed during epochs of round N-offset)',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_OFFSET_IN_ROUNDS)
+    },
+    slasherEnabled: {
+        env: 'AZTEC_SLASHER_ENABLED',
+        description: 'Whether to deploy a slasher proposer',
+        ...booleanConfigHelper(true)
+    },
+    slashAmountSmall: {
+        env: 'AZTEC_SLASH_AMOUNT_SMALL',
+        description: 'Small slashing amount for light offenses',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_SMALL))
+    },
+    slashAmountMedium: {
+        env: 'AZTEC_SLASH_AMOUNT_MEDIUM',
+        description: 'Medium slashing amount for moderate offenses',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_MEDIUM))
+    },
+    slashAmountLarge: {
+        env: 'AZTEC_SLASH_AMOUNT_LARGE',
+        description: 'Large slashing amount for severe offenses',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_SLASH_AMOUNT_LARGE))
+    },
+    slashingQuorum: {
+        env: 'AZTEC_SLASHING_QUORUM',
+        description: 'The slashing quorum',
+        ...optionalNumberConfigHelper()
+    },
+    slashingRoundSizeInEpochs: {
+        env: 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS',
+        description: 'The slashing round size',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS)
+    },
+    slashingLifetimeInRounds: {
+        env: 'AZTEC_SLASHING_LIFETIME_IN_ROUNDS',
+        description: 'The slashing lifetime in rounds',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_LIFETIME_IN_ROUNDS)
+    },
+    slashingExecutionDelayInRounds: {
+        env: 'AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS',
+        description: 'The slashing execution delay in rounds',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS)
+    },
+    slashingVetoer: {
+        env: 'AZTEC_SLASHING_VETOER',
+        description: 'The slashing vetoer',
+        parseEnv: (val)=>EthAddress.fromString(val),
+        defaultValue: EthAddress.fromString(l1ContractsDefaultEnv.AZTEC_SLASHING_VETOER)
+    },
+    slashingDisableDuration: {
+        env: 'AZTEC_SLASHING_DISABLE_DURATION',
+        description: 'How long slashing can be disabled for in seconds when vetoer disables it',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLASHING_DISABLE_DURATION)
+    },
+    governanceProposerQuorum: {
+        env: 'AZTEC_GOVERNANCE_PROPOSER_QUORUM',
+        description: 'The governance proposing quorum',
+        ...optionalNumberConfigHelper()
+    },
+    governanceProposerRoundSize: {
+        env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
+        description: 'The governance proposing round size',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE)
+    },
+    governanceVotingDuration: {
+        env: 'AZTEC_GOVERNANCE_VOTING_DURATION',
+        description: 'Governance voting duration in seconds (only for local/devnet/next-net)',
+        ...numberConfigHelper(3600)
+    },
+    manaTarget: {
+        env: 'AZTEC_MANA_TARGET',
+        description: 'The mana target for the rollup',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_MANA_TARGET))
+    },
+    provingCostPerMana: {
+        env: 'AZTEC_PROVING_COST_PER_MANA',
+        description: 'The proving cost per mana',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_PROVING_COST_PER_MANA))
+    },
+    initialEthPerFeeAsset: {
+        env: 'AZTEC_INITIAL_ETH_PER_FEE_ASSET',
+        description: 'The initial ETH per fee asset price (with 1e12 precision)',
+        ...bigintConfigHelper(BigInt(l1ContractsDefaultEnv.AZTEC_INITIAL_ETH_PER_FEE_ASSET))
+    },
+    exitDelaySeconds: {
+        env: 'AZTEC_EXIT_DELAY_SECONDS',
+        description: 'The delay before a validator can exit the set',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_EXIT_DELAY_SECONDS)
+    },
+    entryQueueBootstrapValidatorSetSize: {
+        env: 'AZTEC_ENTRY_QUEUE_BOOTSTRAP_VALIDATOR_SET_SIZE',
+        description: 'Validator set size at or below which the entry queue uses the bootstrap flush size.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_ENTRY_QUEUE_BOOTSTRAP_VALIDATOR_SET_SIZE)
+    },
+    entryQueueBootstrapFlushSize: {
+        env: 'AZTEC_ENTRY_QUEUE_BOOTSTRAP_FLUSH_SIZE',
+        description: 'Number of validators admitted from the entry queue per flush during the bootstrap phase.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_ENTRY_QUEUE_BOOTSTRAP_FLUSH_SIZE)
+    },
+    entryQueueFlushSizeMin: {
+        env: 'AZTEC_ENTRY_QUEUE_FLUSH_SIZE_MIN',
+        description: 'Minimum number of validators admitted from the entry queue per flush.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_ENTRY_QUEUE_FLUSH_SIZE_MIN)
+    },
+    entryQueueFlushSizeQuotient: {
+        env: 'AZTEC_ENTRY_QUEUE_FLUSH_SIZE_QUOTIENT',
+        description: 'Divisor applied to the queue size to derive the normal per-flush admission count.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_ENTRY_QUEUE_FLUSH_SIZE_QUOTIENT)
+    },
+    entryQueueMaxFlushSize: {
+        env: 'AZTEC_ENTRY_QUEUE_MAX_FLUSH_SIZE',
+        description: 'Maximum number of validators admitted from the entry queue per flush.',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_ENTRY_QUEUE_MAX_FLUSH_SIZE)
+    },
+    ...omitConfigMappings(l1TxUtilsConfigMappings, [
+        'ethereumSlotDuration'
+    ])
+};
+/**
+ * Default L1 contracts configuration derived from l1ContractsConfigMappings.
+ * Source of truth: l1-contracts/scripts/network-defaults.json (published via @aztec/l1-artifacts).
+ */ export const DefaultL1ContractsConfig = getDefaultConfig(l1ContractsConfigMappings);
+/**
+ * Validates that `ethereumSlotDuration` and `aztecSlotDuration` are positive and that the L2 slot is an exact
+ * multiple of the L1 slot. Every L2 slot boundary must land on an L1 slot boundary; a non-multiple pairing
+ * desyncs the epoch/checkpoint timing math throughout the sequencer, validator client, and timetables. Returns
+ * a list of error messages (empty when valid).
+ */ export function validateSlotDurations(config) {
+    const errors = [];
+    if (config.ethereumSlotDuration <= 0) {
+        errors.push(`ethereumSlotDuration must be positive (got ${config.ethereumSlotDuration})`);
+    }
+    if (config.aztecSlotDuration <= 0) {
+        errors.push(`aztecSlotDuration must be positive (got ${config.aztecSlotDuration})`);
+    }
+    if (config.ethereumSlotDuration > 0 && config.aztecSlotDuration % config.ethereumSlotDuration !== 0) {
+        errors.push(`aztecSlotDuration (${config.aztecSlotDuration}s) must be a multiple of ethereumSlotDuration ` + `(${config.ethereumSlotDuration}s)`);
+    }
+    return errors;
+}
+/** Throws if {@link validateSlotDurations} reports any errors. */ export function assertValidSlotDurations(config) {
+    const errors = validateSlotDurations(config);
+    if (errors.length > 0) {
+        throw new Error(`Invalid slot duration configuration:\n${errors.map((e)=>`  - ${e}`).join('\n')}`);
+    }
+}
+export const genesisStateConfigMappings = {
+    testAccounts: {
+        env: 'TEST_ACCOUNTS',
+        description: 'Whether to populate the genesis state with initial fee juice for the test accounts.',
+        ...booleanConfigHelper(false)
+    },
+    sponsoredFPC: {
+        env: 'SPONSORED_FPC',
+        description: 'Whether to populate the genesis state with initial fee juice for the sponsored FPC.',
+        ...booleanConfigHelper(false)
+    },
+    prefundAddresses: {
+        env: 'PREFUND_ADDRESSES',
+        description: 'Comma-separated list of Aztec addresses to prefund with fee juice at genesis (local network only).',
+        parseEnv: (val)=>val.split(',').map((a)=>a.trim()).filter((a)=>a.length > 0),
+        defaultValue: []
+    }
+};
+export function getL1ContractsConfigEnvVars() {
+    return getConfigFromMappings(l1ContractsConfigMappings);
+}
+export function getGenesisStateConfigEnvVars() {
+    return getConfigFromMappings(genesisStateConfigMappings);
+}

package/dest/constants.d.ts

@@ -0,0 +1,4 @@
+import type { Hex } from 'viem';
+export declare const NULL_KEY: Hex;
+export declare const AZTEC_TEST_CHAIN_ID = 677692;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLEdBQUcsRUFBRSxNQUFNLE1BQU0sQ0FBQztBQUVoQyxlQUFPLE1BQU0sUUFBUSxFQUFFLEdBQStFLENBQUM7QUFDdkcsZUFBTyxNQUFNLG1CQUFtQixTQUFTLENBQUMifQ==

package/dest/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC,eAAO,MAAM,QAAQ,EAAE,GAA+E,CAAC;AACvG,eAAO,MAAM,mBAAmB,SAAS,CAAC"}

package/dest/constants.js

@@ -0,0 +1,2 @@
+export const NULL_KEY = `0x${'0000000000000000000000000000000000000000000000000000000000000000'}`;
+export const AZTEC_TEST_CHAIN_ID = 677692;