@aztec/ethereum 0.0.0-test.1 → 0.0.1-commit.017a351

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

@@ -22,4 +22,4 @@ export declare function createEthereumChain(rpcUrls: string[], _chainId: number
  * Helper function to determine if a chain id is an instance of Anvil
  */
 export declare function isAnvilTestChain(_chainId: number | string): boolean;
-//# sourceMappingURL=chain.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhaW4uZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jaGFpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSxNQUFNLENBQUM7QUFLbEM7O0dBRUc7QUFDSCxNQUFNLFdBQVcsYUFBYTtJQUM1Qjs7T0FFRztJQUNILFNBQVMsRUFBRSxLQUFLLENBQUM7SUFFakI7O09BRUc7SUFDSCxPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7Q0FDbkI7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRSxRQUFRLEVBQUUsTUFBTSxHQUFHLE1BQU0sR0FBRyxhQUFhLENBK0IvRjtBQUVEOztHQUVHO0FBQ0gsd0JBQWdCLGdCQUFnQixDQUFDLFFBQVEsRUFBRSxNQUFNLEdBQUcsTUFBTSxHQUFHLE9BQU8sQ0FTbkUifQ==

package/dest/client.d.ts

@@ -1,16 +1,40 @@
 import type { Logger } from '@aztec/foundation/log';
-import type { ViemPublicClient } from './types.js';
+import { type Chain, type FallbackTransport, type HDAccount, type HttpTransport, type LocalAccount, type PrivateKeyAccount } from 'viem';
+import type { ExtendedViemWalletClient, ViemPublicClient } from './types.js';
 type Config = {
-    /** The RPC Url of the ethereum host. */
+    /** 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 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 {};
-//# sourceMappingURL=client.d.ts.map
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBSXBELE9BQU8sRUFDTCxLQUFLLEtBQUssRUFDVixLQUFLLGlCQUFpQixFQUN0QixLQUFLLFNBQVMsRUFFZCxLQUFLLGFBQWEsRUFDbEIsS0FBSyxZQUFZLEVBQ2pCLEtBQUssaUJBQWlCLEVBTXZCLE1BQU0sTUFBTSxDQUFDO0FBS2QsT0FBTyxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFFN0UsS0FBSyxNQUFNLEdBQUc7SUFDWiwwRkFBMEY7SUFDMUYsU0FBUyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ3BCLHlDQUF5QztJQUN6QyxTQUFTLEVBQUUsTUFBTSxDQUFDO0lBQ2xCLDJDQUEyQztJQUMzQyxxQkFBcUIsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUMvQiwwREFBMEQ7SUFDMUQsZUFBZSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQzFCLENBQUM7QUFFRixZQUFZLEVBQUUsTUFBTSxJQUFJLG9CQUFvQixFQUFFLENBQUM7QUFFL0MseUZBQXlGO0FBQ3pGLHFCQUFhLFVBQVcsU0FBUSxLQUFLO0lBQ25DLFlBQVksT0FBTyxFQUFFLE1BQU0sRUFBRSxPQUFPLENBQUMsRUFBRSxZQUFZLEVBR2xEO0NBQ0Y7QUFFRCx3RUFBd0U7QUFDeEUsd0JBQWdCLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFBRSxJQUFJLENBQUMsRUFBRTtJQUFFLE9BQU8sQ0FBQyxFQUFFLE1BQU0sQ0FBQTtDQUFFLHNDQUVqRjtBQUVELHVGQUF1RjtBQUN2Rix3QkFBZ0Isa0JBQWtCLENBQUMsR0FBRyxFQUFFLE9BQU8sR0FBRyxNQUFNLEdBQUcsU0FBUyxDQUVuRTtBQUVELHNGQUFzRjtBQUN0Rix3QkFBZ0IsaUJBQWlCLENBQUMsR0FBRyxFQUFFLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FFdkU7QUFrQkQ7Ozs7R0FJRztBQUNILHdCQUFnQixvQkFBb0IsQ0FBQyxNQUFNLEVBQUUsZ0JBQWdCLEdBQUcsTUFBTSxFQUFFLENBV3ZFO0FBSUQsd0RBQXdEO0FBQ3hELHdCQUFnQixlQUFlLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxnQkFBZ0IsQ0FPaEU7QUFFRCwwRkFBMEY7QUFDMUYsd0JBQXNCLG1CQUFtQixDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUlwRztBQXlCRCx3QkFBZ0Isc0JBQXNCLENBQ3BDLE9BQU8sRUFBRSxNQUFNLEVBQUUsRUFDakIsK0JBQStCLEVBQUUsTUFBTSxHQUFHLFNBQVMsR0FBRyxpQkFBaUIsR0FBRyxZQUFZLEVBQ3RGLEtBQUssR0FBRSxLQUFlLEVBQ3RCLGlCQUFpQixDQUFDLEVBQUUsTUFBTSxFQUMxQixZQUFZLENBQUMsRUFBRSxNQUFNLEVBQ3JCLElBQUksQ0FBQyxFQUFFO0lBQUUsYUFBYSxDQUFDLEVBQUUsTUFBTSxDQUFBO0NBQUUsR0FDaEMsd0JBQXdCLENBZ0IxQiJ9

package/dest/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,KAAK,MAAM,GAAG;IACZ,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAIF,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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,OAAO,EACL,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAEd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAMvB,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;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

@@ -1,12 +1,68 @@
 import { retryUntil } from '@aztec/foundation/retry';
-import { createPublicClient, fallback, http } from 'viem';
+import { getErrorCause } from '@aztec/foundation/types';
+import { HttpRequestError, 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;
+}
+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: fallback(config.l1RpcUrls.map((url)=>http(url))),
+        transport: makeL1HttpTransport(config.l1RpcUrls, {
+            timeout: config.l1HttpTimeoutMS
+        }),
         pollingInterval: config.viemPollingIntervalMS
     });
 }
@@ -20,7 +76,7 @@ async function waitForRpc(client, config, logger) {
         let chainId = 0;
         try {
             chainId = await client.getChainId();
-        } catch (err) {
+        } catch  {
             logger?.warn(`Failed to connect to Ethereum node at ${config.l1RpcUrls.join(', ')}. Retrying...`);
         }
         return chainId;
@@ -29,3 +85,17 @@ async function waitForRpc(client, config, logger) {
         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

@@ -1,5 +1,14 @@
 import { type ConfigMappingsType } from '@aztec/foundation/config';
-import { type L1TxUtilsConfig } from './l1_tx_utils.js';
+import { EthAddress } from '@aztec/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;
@@ -9,31 +18,69 @@ export type L1ContractsConfig = {
     aztecEpochDuration: number;
     /** The target validator committee size. */
     aztecTargetCommitteeSize: number;
-    /** The number of L2 slots that we can wait for a proof of an epoch to be produced. */
-    aztecProofSubmissionWindow: 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 checkpoints to lag in the inbox (prevents sequencer DOS attacks). */
+    inboxLag: 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. */
-    minimumStake: bigint;
-    /** The slashing quorum */
-    slashingQuorum: number;
-    /** The slashing round size */
-    slashingRoundSize: number;
-    /** Governance proposing quorum */
-    governanceProposerQuorum: number;
+    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;
 } & L1TxUtilsConfig;
-export declare const DefaultL1ContractsConfig: {
-    ethereumSlotDuration: number;
-    aztecSlotDuration: number;
-    aztecEpochDuration: number;
-    aztecTargetCommitteeSize: number;
-    aztecProofSubmissionWindow: number;
-    minimumStake: bigint;
-    slashingQuorum: number;
-    slashingRoundSize: number;
-    governanceProposerQuorum: number;
-    governanceProposerRoundSize: number;
-};
+/**
+ * Config mappings for L1ContractsConfig.
+ * Default values come from generated l1-contracts-defaults.json (source: defaults.yml).
+ * 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: spartan/environments/defaults.yml -> defaults.l1-contracts
+ */
+export declare const DefaultL1ContractsConfig: L1ContractsConfig;
+export declare const genesisStateConfigMappings: ConfigMappingsType<GenesisStateConfig>;
 export declare function getL1ContractsConfigEnvVars(): L1ContractsConfig;
-//# sourceMappingURL=config.d.ts.map
+export declare function getGenesisStateConfigEnvVars(): GenesisStateConfig;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxLQUFLLGtCQUFrQixFQVF4QixNQUFNLDBCQUEwQixDQUFDO0FBQ2xDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUczRCxPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQTJCLE1BQU0seUJBQXlCLENBQUM7QUFFeEYsTUFBTSxNQUFNLGtCQUFrQixHQUFHO0lBQy9CLHlGQUF5RjtJQUN6RixZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLHlGQUF5RjtJQUN6RixZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLGdFQUFnRTtJQUNoRSxnQkFBZ0IsRUFBRSxNQUFNLEVBQUUsQ0FBQztDQUM1QixDQUFDO0FBRUYsTUFBTSxNQUFNLGlCQUFpQixHQUFHO0lBQzlCLHlDQUF5QztJQUN6QyxvQkFBb0IsRUFBRSxNQUFNLENBQUM7SUFDN0IsdUZBQXVGO0lBQ3ZGLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUMxQix3Q0FBd0M7SUFDeEMsa0JBQWtCLEVBQUUsTUFBTSxDQUFDO0lBQzNCLDJDQUEyQztJQUMzQyx3QkFBd0IsRUFBRSxNQUFNLENBQUM7SUFDakMsb0ZBQW9GO0lBQ3BGLDBCQUEwQixFQUFFLE1BQU0sQ0FBQztJQUNuQyxpRkFBaUY7SUFDakYsb0JBQW9CLEVBQUUsTUFBTSxDQUFDO0lBQzdCLHNGQUFzRjtJQUN0RixRQUFRLEVBQUUsTUFBTSxDQUFDO0lBQ2pCLCtFQUErRTtJQUMvRSwwQkFBMEIsRUFBRSxNQUFNLENBQUM7SUFDbkMseUNBQXlDO0lBQ3pDLG1CQUFtQixFQUFFLE1BQU0sQ0FBQztJQUM1Qix5Q0FBeUM7SUFDekMsaUJBQWlCLEVBQUUsTUFBTSxDQUFDO0lBQzFCLG1IQUFtSDtJQUNuSCxzQkFBc0IsRUFBRSxNQUFNLENBQUM7SUFDL0Isd0tBQXdLO0lBQ3hLLGNBQWMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUN4Qiw0RUFBNEU7SUFDNUUseUJBQXlCLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLGdHQUFnRztJQUNoRyx3QkFBd0IsRUFBRSxNQUFNLENBQUM7SUFDakMseUdBQXlHO0lBQ3pHLDhCQUE4QixFQUFFLE1BQU0sQ0FBQztJQUN2Qyx5RUFBeUU7SUFDekUsY0FBYyxFQUFFLFVBQVUsQ0FBQztJQUMzQiw0SUFBNEk7SUFDNUksc0JBQXNCLEVBQUUsTUFBTSxDQUFDO0lBQy9CLCtFQUErRTtJQUMvRSx1QkFBdUIsRUFBRSxNQUFNLENBQUM7SUFDaEMsMkNBQTJDO0lBQzNDLGNBQWMsRUFBRSxPQUFPLENBQUM7SUFDeEIseUNBQXlDO0lBQ3pDLGdCQUFnQixFQUFFLE1BQU0sQ0FBQztJQUN6Qiw2QkFBNkI7SUFDN0IsaUJBQWlCLEVBQUUsTUFBTSxDQUFDO0lBQzFCLG1EQUFtRDtJQUNuRCxnQkFBZ0IsRUFBRSxNQUFNLENBQUM7SUFDekIsZ0VBQWdFO0lBQ2hFLHdCQUF3QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLHNDQUFzQztJQUN0QywyQkFBMkIsRUFBRSxNQUFNLENBQUM7SUFDcEMsMkZBQTJGO0lBQzNGLHdCQUF3QixDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2xDLHFDQUFxQztJQUNyQyxVQUFVLEVBQUUsTUFBTSxDQUFDO0lBQ25CLGdDQUFnQztJQUNoQyxrQkFBa0IsRUFBRSxNQUFNLENBQUM7SUFDM0IsZ0VBQWdFO0lBQ2hFLHFCQUFxQixFQUFFLE1BQU0sQ0FBQztJQUM5QixnREFBZ0Q7SUFDaEQsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0NBQzFCLEdBQUcsZUFBZSxDQUFDO0FBRXBCOzs7O0dBSUc7QUFDSCxlQUFPLE1BQU0seUJBQXlCLEVBQUUsa0JBQWtCLENBQUMsaUJBQWlCLENBc0ozRSxDQUFDO0FBRUY7OztHQUdHO0FBQ0gsZUFBTyxNQUFNLHdCQUF3QixtQkFBOEMsQ0FBQztBQUVwRixlQUFPLE1BQU0sMEJBQTBCLEVBQUUsa0JBQWtCLENBQUMsa0JBQWtCLENBcUI3RSxDQUFDO0FBRUYsd0JBQWdCLDJCQUEyQixJQUFJLGlCQUFpQixDQUUvRDtBQUVELHdCQUFnQiw0QkFBNEIsSUFBSSxrQkFBa0IsQ0FFakUifQ==

package/dest/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,kBAAkB,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,wBAAwB,EAAE,MAAM,CAAC;IACjC,sFAAsF;IACtF,0BAA0B,EAAE,MAAM,CAAC;IACnC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,sCAAsC;IACtC,2BAA2B,EAAE,MAAM,CAAC;CACrC,GAAG,eAAe,CAAC;AAEpB,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAWR,CAAC;AAE9B,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,iBAAiB,CAqD3E,CAAC;AAEF,wBAAgB,2BAA2B,IAAI,iBAAiB,CAE/D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAQxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,yBAAyB,CAAC;AAExF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yFAAyF;IACzF,YAAY,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,YAAY,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,wBAAwB,EAAE,MAAM,CAAC;IACjC,oFAAoF;IACpF,0BAA0B,EAAE,MAAM,CAAC;IACnC,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,0BAA0B,EAAE,MAAM,CAAC;IACnC,yCAAyC;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mHAAmH;IACnH,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wKAAwK;IACxK,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,yBAAyB,EAAE,MAAM,CAAC;IAClC,gGAAgG;IAChG,wBAAwB,EAAE,MAAM,CAAC;IACjC,yGAAyG;IACzG,8BAA8B,EAAE,MAAM,CAAC;IACvC,yEAAyE;IACzE,cAAc,EAAE,UAAU,CAAC;IAC3B,4IAA4I;IAC5I,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,uBAAuB,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sCAAsC;IACtC,2BAA2B,EAAE,MAAM,CAAC;IACpC,2FAA2F;IAC3F,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,eAAe,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAAkB,CAAC,iBAAiB,CAsJ3E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mBAA8C,CAAC;AAEpF,eAAO,MAAM,0BAA0B,EAAE,kBAAkB,CAAC,kBAAkB,CAqB7E,CAAC;AAEF,wBAAgB,2BAA2B,IAAI,iBAAiB,CAE/D;AAED,wBAAgB,4BAA4B,IAAI,kBAAkB,CAEjE"}

package/dest/config.js

@@ -1,70 +1,187 @@
-import { bigintConfigHelper, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
-import { l1TxUtilsConfigMappings } from './l1_tx_utils.js';
-export const DefaultL1ContractsConfig = {
-    ethereumSlotDuration: 12,
-    aztecSlotDuration: 24,
-    aztecEpochDuration: 16,
-    aztecTargetCommitteeSize: 48,
-    aztecProofSubmissionWindow: 31,
-    minimumStake: BigInt(100e18),
-    slashingQuorum: 6,
-    slashingRoundSize: 10,
-    governanceProposerQuorum: 6,
-    governanceProposerRoundSize: 10
-};
-export const l1ContractsConfigMappings = {
+import { bigintConfigHelper, booleanConfigHelper, getConfigFromMappings, getDefaultConfig, numberConfigHelper, omitConfigMappings, optionalNumberConfigHelper } from '@aztec/foundation/config';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { l1ContractsDefaultEnv } from './generated/l1-contracts-defaults.js';
+import { l1TxUtilsConfigMappings } from './l1_tx_utils/config.js';
+/**
+ * Config mappings for L1ContractsConfig.
+ * Default values come from generated l1-contracts-defaults.json (source: defaults.yml).
+ * 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(DefaultL1ContractsConfig.ethereumSlotDuration)
+        ...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(DefaultL1ContractsConfig.aztecSlotDuration)
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_SLOT_DURATION)
     },
     aztecEpochDuration: {
         env: 'AZTEC_EPOCH_DURATION',
-        description: `How many L2 slots an epoch lasts (maximum AZTEC_MAX_EPOCH_DURATION).`,
-        ...numberConfigHelper(DefaultL1ContractsConfig.aztecEpochDuration)
+        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(DefaultL1ContractsConfig.aztecTargetCommitteeSize)
+        ...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)
     },
-    aztecProofSubmissionWindow: {
-        env: 'AZTEC_PROOF_SUBMISSION_WINDOW',
-        description: 'The number of L2 slots that a proof for an epoch can be submitted in, starting from the beginning of the epoch.',
-        ...numberConfigHelper(DefaultL1ContractsConfig.aztecProofSubmissionWindow)
+    inboxLag: {
+        env: 'AZTEC_INBOX_LAG',
+        description: 'The number of checkpoints to lag in the inbox (prevents sequencer DOS attacks).',
+        ...numberConfigHelper(l1ContractsDefaultEnv.AZTEC_INBOX_LAG)
     },
-    minimumStake: {
-        env: 'AZTEC_MINIMUM_STAKE',
+    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(DefaultL1ContractsConfig.minimumStake)
+        ...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',
-        ...numberConfigHelper(DefaultL1ContractsConfig.slashingQuorum)
+        ...optionalNumberConfigHelper()
     },
-    slashingRoundSize: {
-        env: 'AZTEC_SLASHING_ROUND_SIZE',
+    slashingRoundSizeInEpochs: {
+        env: 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS',
         description: 'The slashing round size',
-        ...numberConfigHelper(DefaultL1ContractsConfig.slashingRoundSize)
+        ...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',
-        ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerQuorum)
+        ...optionalNumberConfigHelper()
     },
     governanceProposerRoundSize: {
         env: 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE',
         description: 'The governance proposing round size',
-        ...numberConfigHelper(DefaultL1ContractsConfig.governanceProposerRoundSize)
+        ...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))
     },
-    ...l1TxUtilsConfigMappings
+    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)
+    },
+    ...omitConfigMappings(l1TxUtilsConfigMappings, [
+        'ethereumSlotDuration'
+    ])
+};
+/**
+ * Default L1 contracts configuration derived from l1ContractsConfigMappings.
+ * Source of truth: spartan/environments/defaults.yml -> defaults.l1-contracts
+ */ export const DefaultL1ContractsConfig = getDefaultConfig(l1ContractsConfigMappings);
+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

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

package/dest/contracts/chain_state_override.d.ts

@@ -0,0 +1,78 @@
+import type { CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import type { Buffer32 } from '@aztec/foundation/buffer';
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import type { StateOverride } from 'viem';
+import { type FeeHeader, RollupContract } from './rollup.js';
+/**
+ * Override values for the pending checkpoint that the simulation should treat as already applied.
+ * Every field is optional at plan-building time so callers can populate them incrementally; whatever
+ * is present at translation time is forwarded to the partial `tempCheckpointLogs` helper so the
+ * load-bearing `slotNumber` can land even if other fields could not be derived locally.
+ */
+export type PendingCheckpointOverrideState = {
+    archive?: Fr;
+    feeHeader?: FeeHeader;
+    headerHash?: Fr;
+    outHash?: Fr;
+    payloadDigest?: Buffer32;
+    slotNumber?: SlotNumber;
+};
+export type ChainTipsOverride = {
+    pending?: CheckpointNumber;
+    proven?: CheckpointNumber;
+};
+/** Describes the simulated L1 rollup state that downstream calls should observe. */
+export type SimulationOverridesPlan = {
+    chainTipsOverride?: ChainTipsOverride;
+    pendingCheckpointState?: PendingCheckpointOverrideState;
+    disableBlobCheck?: boolean;
+};
+/** Builds a single-checkpoint simulation plan before it is translated into a viem state override. */
+export declare class SimulationOverridesBuilder {
+    private chainTipsOverride?;
+    private pendingCheckpointState?;
+    private disableBlobCheck;
+    /** Starts from an existing plan so callers can extend or specialize it. */
+    static from(plan: SimulationOverridesPlan | undefined): SimulationOverridesBuilder;
+    /**
+     * Merges another plan into this builder. Later values win on a per-half basis for chain tips,
+     * but explicit `undefined` fields in the incoming plan are ignored so they cannot erase a
+     * previously-set value.
+     */
+    merge(plan: SimulationOverridesPlan | undefined): this;
+    /**
+     * Sets the pending and/or proven checkpoint number overrides. Subsequent calls merge into the existing
+     * override on a per-half basis, so callers can set pending in one call and proven in another without
+     * clobbering each other.
+     */
+    withChainTips(override: ChainTipsOverride): this;
+    /** Overrides the archive root for the configured pending checkpoint. */
+    withPendingArchive(archive: Fr): this;
+    /** Overrides the fee header for the configured pending checkpoint. */
+    withPendingFeeHeader(feeHeader: FeeHeader): this;
+    /**
+     * Overrides one or more `tempCheckpointLogs` cell fields for the configured pending checkpoint.
+     * Fields are independent: any subset can be provided. The translator (`makeTempCheckpointLogOverride`)
+     * emits a stateDiff entry per field actually set, so unspecified fields stay at their on-chain
+     * values.
+     *
+     * `slotNumber` is load-bearing for `STFLib.canPruneAtTime`: when the simulation overrides `pending`
+     * to a checkpoint that has no on-chain `tempCheckpointLogs` entry yet, the missing slotNumber falls
+     * back to 0 and the contract treats the pending tip as belonging to epoch 0, triggering a phantom
+     * prune that silently undoes the `pending` override.
+     */
+    withPendingTempCheckpointLogFields(fields: {
+        headerHash?: Fr;
+        outHash?: Fr;
+        payloadDigest?: Buffer32;
+        slotNumber?: SlotNumber;
+    }): this;
+    /** Disables blob checking for simulations that cannot provide DA inputs. */
+    withoutBlobCheck(): this;
+    /** Builds the final plan, or `undefined` when no overrides were configured. */
+    build(): SimulationOverridesPlan | undefined;
+    private assertPendingCheckpointNumber;
+}
+/** Translates a simulation plan into the viem state override shape expected by rollup calls. */
+export declare function buildSimulationOverridesStateOverride(rollup: RollupContract, plan: SimulationOverridesPlan | undefined): Promise<StateOverride>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hhaW5fc3RhdGVfb3ZlcnJpZGUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdHMvY2hhaW5fc3RhdGVfb3ZlcnJpZGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDcEYsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFFekQsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFekQsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBRTFDLE9BQU8sRUFBRSxLQUFLLFNBQVMsRUFBRSxjQUFjLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFN0Q7Ozs7O0dBS0c7QUFDSCxNQUFNLE1BQU0sOEJBQThCLEdBQUc7SUFDM0MsT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDO0lBQ2IsU0FBUyxDQUFDLEVBQUUsU0FBUyxDQUFDO0lBQ3RCLFVBQVUsQ0FBQyxFQUFFLEVBQUUsQ0FBQztJQUNoQixPQUFPLENBQUMsRUFBRSxFQUFFLENBQUM7SUFDYixhQUFhLENBQUMsRUFBRSxRQUFRLENBQUM7SUFDekIsVUFBVSxDQUFDLEVBQUUsVUFBVSxDQUFDO0NBQ3pCLENBQUM7QUFFRixNQUFNLE1BQU0saUJBQWlCLEdBQUc7SUFDOUIsT0FBTyxDQUFDLEVBQUUsZ0JBQWdCLENBQUM7SUFDM0IsTUFBTSxDQUFDLEVBQUUsZ0JBQWdCLENBQUM7Q0FDM0IsQ0FBQztBQUVGLG9GQUFvRjtBQUNwRixNQUFNLE1BQU0sdUJBQXVCLEdBQUc7SUFDcEMsaUJBQWlCLENBQUMsRUFBRSxpQkFBaUIsQ0FBQztJQUN0QyxzQkFBc0IsQ0FBQyxFQUFFLDhCQUE4QixDQUFDO0lBQ3hELGdCQUFnQixDQUFDLEVBQUUsT0FBTyxDQUFDO0NBQzVCLENBQUM7QUFFRixxR0FBcUc7QUFDckcscUJBQWEsMEJBQTBCO0lBQ3JDLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQyxDQUFvQjtJQUM5QyxPQUFPLENBQUMsc0JBQXNCLENBQUMsQ0FBaUM7SUFDaEUsT0FBTyxDQUFDLGdCQUFnQixDQUFTO0lBRWpDLDJFQUEyRTtJQUMzRSxPQUFjLElBQUksQ0FBQyxJQUFJLEVBQUUsdUJBQXVCLEdBQUcsU0FBUyxHQUFHLDBCQUEwQixDQUV4RjtJQUVEOzs7O09BSUc7SUFDSSxLQUFLLENBQUMsSUFBSSxFQUFFLHVCQUF1QixHQUFHLFNBQVMsR0FBRyxJQUFJLENBYzVEO0lBRUQ7Ozs7T0FJRztJQUNJLGFBQWEsQ0FBQyxRQUFRLEVBQUUsaUJBQWlCLEdBQUcsSUFBSSxDQUd0RDtJQUVELHdFQUF3RTtJQUNqRSxrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsRUFBRSxHQUFHLElBQUksQ0FJM0M7SUFFRCxzRUFBc0U7SUFDL0Qsb0JBQW9CLENBQUMsU0FBUyxFQUFFLFNBQVMsR0FBRyxJQUFJLENBSXREO0lBRUQ7Ozs7Ozs7Ozs7T0FVRztJQUNJLGtDQUFrQyxDQUFDLE1BQU0sRUFBRTtRQUNoRCxVQUFVLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDaEIsT0FBTyxDQUFDLEVBQUUsRUFBRSxDQUFDO1FBQ2IsYUFBYSxDQUFDLEVBQUUsUUFBUSxDQUFDO1FBQ3pCLFVBQVUsQ0FBQyxFQUFFLFVBQVUsQ0FBQztLQUN6QixHQUFHLElBQUksQ0FJUDtJQUVELDRFQUE0RTtJQUNyRSxnQkFBZ0IsSUFBSSxJQUFJLENBRzlCO0lBRUQsK0VBQStFO0lBQ3hFLEtBQUssSUFBSSx1QkFBdUIsR0FBRyxTQUFTLENBVWxEO0lBRUQsT0FBTyxDQUFDLDZCQUE2QjtDQUt0QztBQUVELGdHQUFnRztBQUNoRyx3QkFBc0IscUNBQXFDLENBQ3pELE1BQU0sRUFBRSxjQUFjLEVBQ3RCLElBQUksRUFBRSx1QkFBdUIsR0FBRyxTQUFTLEdBQ3hDLE9BQU8sQ0FBQyxhQUFhLENBQUMsQ0FpRHhCIn0=

package/dest/contracts/chain_state_override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain_state_override.d.ts","sourceRoot":"","sources":["../../src/contracts/chain_state_override.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EAAE,KAAK,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,CAAC,EAAE,EAAE,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,EAAE,CAAC;IACb,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,sBAAsB,CAAC,EAAE,8BAA8B,CAAC;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,qGAAqG;AACrG,qBAAa,0BAA0B;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,sBAAsB,CAAC,CAAiC;IAChE,OAAO,CAAC,gBAAgB,CAAS;IAEjC,2EAA2E;IAC3E,OAAc,IAAI,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,GAAG,0BAA0B,CAExF;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAc5D;IAED;;;;OAIG;IACI,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAGtD;IAED,wEAAwE;IACjE,kBAAkB,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAI3C;IAED,sEAAsE;IAC/D,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAItD;IAED;;;;;;;;;;OAUG;IACI,kCAAkC,CAAC,MAAM,EAAE;QAChD,UAAU,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,EAAE,CAAC;QACb,aAAa,CAAC,EAAE,QAAQ,CAAC;QACzB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,GAAG,IAAI,CAIP;IAED,4EAA4E;IACrE,gBAAgB,IAAI,IAAI,CAG9B;IAED,+EAA+E;IACxE,KAAK,IAAI,uBAAuB,GAAG,SAAS,CAUlD;IAED,OAAO,CAAC,6BAA6B;CAKtC;AAED,gGAAgG;AAChG,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,uBAAuB,GAAG,SAAS,GACxC,OAAO,CAAC,aAAa,CAAC,CAiDxB"}