@aztec/cli 2.0.3-rc.3 → 2.0.3-rc.31

package/dest/cmds/l1/deploy_l1_contracts.d.ts

@@ -1,4 +1,4 @@
 import { type EthAddress } from '@aztec/aztec.js';
 import type { LogFn, Logger } from '@aztec/foundation/log';
-export declare function deployL1Contracts(rpcUrls: string[], chainId: number, privateKey: string | undefined, mnemonic: string, mnemonicIndex: number, salt: number | undefined, testAccounts: boolean, sponsoredFPC: boolean, acceleratedTestDeployments: boolean, json: boolean, createVerificationJson: string | false, initialValidators: EthAddress[], realVerifier: boolean, log: LogFn, debugLogger: Logger): Promise<void>;
+export declare function deployL1Contracts(rpcUrls: string[], chainId: number, privateKey: string | undefined, mnemonic: string, mnemonicIndex: number, salt: number | undefined, testAccounts: boolean, sponsoredFPC: boolean, acceleratedTestDeployments: boolean, json: boolean, createVerificationJson: string | false, initialValidators: EthAddress[], realVerifier: boolean, existingToken: EthAddress | undefined, log: LogFn, debugLogger: Logger): Promise<void>;
 //# sourceMappingURL=deploy_l1_contracts.d.ts.map

package/dest/cmds/l1/deploy_l1_contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy_l1_contracts.d.ts","sourceRoot":"","sources":["../../../src/cmds/l1/deploy_l1_contracts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAM,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM3D,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,EACrB,0BAA0B,EAAE,OAAO,EACnC,IAAI,EAAE,OAAO,EACb,sBAAsB,EAAE,MAAM,GAAG,KAAK,EACtC,iBAAiB,EAAE,UAAU,EAAE,EAC/B,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,KAAK,EACV,WAAW,EAAE,MAAM,iBA6DpB"}
+{"version":3,"file":"deploy_l1_contracts.d.ts","sourceRoot":"","sources":["../../../src/cmds/l1/deploy_l1_contracts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAM,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM3D,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,OAAO,EACrB,YAAY,EAAE,OAAO,EACrB,0BAA0B,EAAE,OAAO,EACnC,IAAI,EAAE,OAAO,EACb,sBAAsB,EAAE,MAAM,GAAG,KAAK,EACtC,iBAAiB,EAAE,UAAU,EAAE,EAC/B,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,UAAU,GAAG,SAAS,EACrC,GAAG,EAAE,KAAK,EACV,WAAW,EAAE,MAAM,iBA8DpB"}

package/dest/cmds/l1/deploy_l1_contracts.js

@@ -5,7 +5,7 @@ import { SecretValue } from '@aztec/foundation/config';
 import { getGenesisValues } from '@aztec/world-state/testing';
 import { deployAztecContracts } from '../../utils/aztec.js';
 import { getSponsoredFPCAddress } from '../../utils/setup_contracts.js';
-export async function deployL1Contracts(rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, testAccounts, sponsoredFPC, acceleratedTestDeployments, json, createVerificationJson, initialValidators, realVerifier, log, debugLogger) {
+export async function deployL1Contracts(rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, testAccounts, sponsoredFPC, acceleratedTestDeployments, json, createVerificationJson, initialValidators, realVerifier, existingToken, log, debugLogger) {
     const config = getL1ContractsConfigEnvVars();
     const initialAccounts = testAccounts ? await getInitialTestAccounts() : [];
     const sponsoredFPCAddress = sponsoredFPC ? await getSponsoredFPCAddress() : [];
@@ -16,7 +16,7 @@ export async function deployL1Contracts(rpcUrls, chainId, privateKey, mnemonic,
             withdrawer: a,
             bn254SecretKey: new SecretValue(Fr.random().toBigInt())
         }));
-    const { l1ContractAddresses } = await deployAztecContracts(rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, initialValidatorOperators, genesisArchiveRoot, fundingNeeded, acceleratedTestDeployments, config, realVerifier, createVerificationJson, debugLogger);
+    const { l1ContractAddresses } = await deployAztecContracts(rpcUrls, chainId, privateKey, mnemonic, mnemonicIndex, salt, initialValidatorOperators, genesisArchiveRoot, fundingNeeded, acceleratedTestDeployments, config, existingToken, realVerifier, createVerificationJson, debugLogger);
     if (json) {
         log(JSON.stringify(Object.fromEntries(Object.entries(l1ContractAddresses).map(([k, v])=>[
                 k,

package/dest/cmds/l1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmds/l1/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAcjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa3D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAghB/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmds/l1/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAcjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAa3D,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAkhB/E"}

package/dest/cmds/l1/index.js

@@ -8,10 +8,10 @@ const l1RpcUrlsOption = new Option('--l1-rpc-urls <string>', 'List of Ethereum h
 ]).makeOptionMandatory(true).argParser((arg)=>arg.split(',').map((url)=>url.trim()));
 const networkOption = new Option('--network <string>', 'Network to execute against').env('NETWORK');
 export function injectCommands(program, log, debugLogger) {
-    program.command('deploy-l1-contracts').description('Deploys all necessary Ethereum contracts for Aztec.').addOption(l1RpcUrlsOption).option('-pk, --private-key <string>', 'The private key to use for deployment', PRIVATE_KEY).option('--validators <string>', 'Comma separated list of validators').option('-m, --mnemonic <string>', 'The mnemonic to use in deployment', 'test test test test test test test test test test test junk').option('-i, --mnemonic-index <number>', 'The index of the mnemonic to use in deployment', (arg)=>parseInt(arg), 0).addOption(l1ChainIdOption).option('--salt <number>', 'The optional salt to use in deployment', (arg)=>parseInt(arg)).option('--json', 'Output the contract addresses in JSON format').option('--test-accounts', 'Populate genesis state with initial fee juice for test accounts').option('--sponsored-fpc', 'Populate genesis state with a testing sponsored FPC contract').option('--accelerated-test-deployments', 'Fire and forget deployment transactions, use in testing only', false).option('--real-verifier', 'Deploy the real verifier', false).option('--create-verification-json [path]', 'Create JSON file for etherscan contract verification', false).action(async (options)=>{
+    program.command('deploy-l1-contracts').description('Deploys all necessary Ethereum contracts for Aztec.').addOption(l1RpcUrlsOption).option('-pk, --private-key <string>', 'The private key to use for deployment', PRIVATE_KEY).option('--validators <string>', 'Comma separated list of validators').option('-m, --mnemonic <string>', 'The mnemonic to use in deployment', 'test test test test test test test test test test test junk').option('-i, --mnemonic-index <number>', 'The index of the mnemonic to use in deployment', (arg)=>parseInt(arg), 0).addOption(l1ChainIdOption).option('--salt <number>', 'The optional salt to use in deployment', (arg)=>parseInt(arg)).option('--json', 'Output the contract addresses in JSON format').option('--test-accounts', 'Populate genesis state with initial fee juice for test accounts').option('--sponsored-fpc', 'Populate genesis state with a testing sponsored FPC contract').option('--accelerated-test-deployments', 'Fire and forget deployment transactions, use in testing only', false).option('--real-verifier', 'Deploy the real verifier', false).option('--existing-token <address>', 'Use an existing ERC20 for both fee and staking', parseEthereumAddress).option('--create-verification-json [path]', 'Create JSON file for etherscan contract verification', false).action(async (options)=>{
         const { deployL1Contracts } = await import('./deploy_l1_contracts.js');
         const initialValidators = options.validators?.split(',').map((validator)=>EthAddress.fromString(validator)) || [];
-        await deployL1Contracts(options.l1RpcUrls, options.l1ChainId, options.privateKey, options.mnemonic, options.mnemonicIndex, options.salt, options.testAccounts, options.sponsoredFpc, options.acceleratedTestDeployments, options.json, options.createVerificationJson, initialValidators, options.realVerifier, log, debugLogger);
+        await deployL1Contracts(options.l1RpcUrls, options.l1ChainId, options.privateKey, options.mnemonic, options.mnemonicIndex, options.salt, options.testAccounts, options.sponsoredFpc, options.acceleratedTestDeployments, options.json, options.createVerificationJson, initialValidators, options.realVerifier, options.existingToken, log, debugLogger);
     });
     program.command('deploy-new-rollup').description('Deploys a new rollup contract and adds it to the registry (if you are the owner).').requiredOption('-r, --registry-address <string>', 'The address of the registry contract', parseEthereumAddress).addOption(l1RpcUrlsOption).option('-pk, --private-key <string>', 'The private key to use for deployment', PRIVATE_KEY).option('--validators <string>', 'Comma separated list of validators').option('-m, --mnemonic <string>', 'The mnemonic to use in deployment', MNEMONIC ?? 'test test test test test test test test test test test junk').option('-i, --mnemonic-index <number>', 'The index of the mnemonic to use in deployment', (arg)=>parseInt(arg), 0).addOption(l1ChainIdOption).option('--salt <number>', 'The optional salt to use in deployment', (arg)=>parseInt(arg)).option('--json', 'Output the contract addresses in JSON format').option('--test-accounts', 'Populate genesis state with initial fee juice for test accounts').option('--sponsored-fpc', 'Populate genesis state with a testing sponsored FPC contract').option('--real-verifier', 'Deploy the real verifier', false).action(async (options)=>{
         const { deployNewRollup } = await import('./deploy_new_rollup.js');

package/dest/config/cached_fetch.d.ts

@@ -0,0 +1,18 @@
+export interface CachedFetchOptions {
+    /** Cache duration in milliseconds */
+    cacheDurationMs: number;
+    /** The cache file */
+    cacheFile?: string;
+}
+/**
+ * Fetches data from a URL with file-based caching support.
+ * This utility can be used by both remote config and bootnodes fetching.
+ *
+ * @param url - The URL to fetch from
+ * @param networkName - Network name for cache directory structure
+ * @param options - Caching and error handling options
+ * @param cacheDir - Optional cache directory (defaults to no caching)
+ * @returns The fetched and parsed JSON data, or undefined if fetch fails and throwOnError is false
+ */
+export declare function cachedFetch<T = any>(url: string, options: CachedFetchOptions, fetch?: typeof globalThis.fetch, log?: import("@aztec/aztec.js").Logger): Promise<T | undefined>;
+//# sourceMappingURL=cached_fetch.d.ts.map

package/dest/config/cached_fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached_fetch.d.ts","sourceRoot":"","sources":["../../src/config/cached_fetch.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,GAAG,EACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,kBAAkB,EAC3B,KAAK,0BAAmB,EACxB,GAAG,mCAA+B,GACjC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAuCxB"}

package/dest/config/cached_fetch.js

@@ -0,0 +1,54 @@
+import { createLogger } from '@aztec/aztec.js';
+import { mkdir, readFile, stat, writeFile } from 'fs/promises';
+import { dirname } from 'path';
+/**
+ * Fetches data from a URL with file-based caching support.
+ * This utility can be used by both remote config and bootnodes fetching.
+ *
+ * @param url - The URL to fetch from
+ * @param networkName - Network name for cache directory structure
+ * @param options - Caching and error handling options
+ * @param cacheDir - Optional cache directory (defaults to no caching)
+ * @returns The fetched and parsed JSON data, or undefined if fetch fails and throwOnError is false
+ */ export async function cachedFetch(url, options, fetch = globalThis.fetch, log = createLogger('cached_fetch')) {
+    const { cacheDurationMs, cacheFile } = options;
+    // Try to read from cache first
+    try {
+        if (cacheFile) {
+            const info = await stat(cacheFile);
+            if (info.mtimeMs + cacheDurationMs > Date.now()) {
+                const cachedData = JSON.parse(await readFile(cacheFile, 'utf-8'));
+                return cachedData;
+            }
+        }
+    } catch  {
+        log.trace('Failed to read data from cache');
+    }
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            log.warn(`Failed to fetch from ${url}: ${response.status} ${response.statusText}`);
+            return undefined;
+        }
+        const data = await response.json();
+        try {
+            if (cacheFile) {
+                await mkdir(dirname(cacheFile), {
+                    recursive: true
+                });
+                await writeFile(cacheFile, JSON.stringify(data), 'utf-8');
+            }
+        } catch (err) {
+            log.warn('Failed to cache data on disk: ' + cacheFile, {
+                cacheFile,
+                err
+            });
+        }
+        return data;
+    } catch (err) {
+        log.warn(`Failed to fetch from ${url}`, {
+            err
+        });
+        return undefined;
+    }
+}

package/dest/config/chain_l2_config.d.ts

@@ -9,9 +9,6 @@ export type L2ChainConfig = L1ContractsConfig & Pick<P2PConfig, 'txPoolDeleteTxs
     sponsoredFPC: boolean;
     p2pEnabled: boolean;
     p2pBootstrapNodes: string[];
-    registryAddress: string;
-    slashFactoryAddress: string;
-    feeAssetHandlerAddress: string;
     seqMinTxsPerBlock: number;
     seqMaxTxsPerBlock: number;
     realProofs: boolean;
@@ -22,11 +19,17 @@ export type L2ChainConfig = L1ContractsConfig & Pick<P2PConfig, 'txPoolDeleteTxs
     publicIncludeMetrics?: string[];
     publicMetricsCollectorUrl?: string;
     publicMetricsCollectFrom?: string[];
+    dbMapSizeKb: number;
+    archiverStoreMapSizeKb: number;
+    noteHashTreeMapSizeKb: number;
+    nullifierTreeMapSizeKb: number;
+    publicDataTreeMapSizeKb: number;
     sentinelEnabled: boolean;
 };
 export declare const stagingIgnitionL2ChainConfig: L2ChainConfig;
 export declare const stagingPublicL2ChainConfig: L2ChainConfig;
 export declare const testnetL2ChainConfig: L2ChainConfig;
+export declare const ignitionL2ChainConfig: L2ChainConfig;
 export declare function getBootnodes(networkName: NetworkNames, cacheDir?: string): Promise<any>;
 export declare function getL2ChainConfig(networkName: NetworkNames, cacheDir?: string): Promise<L2ChainConfig | undefined>;
 export declare function enrichEnvironmentWithChainConfig(networkName: NetworkNames): Promise<void>;

package/dest/config/chain_l2_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain_l2_config.d.ts","sourceRoot":"","sources":["../../src/config/chain_l2_config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAOrE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,GAC5C,IAAI,CAAC,aAAa,EAAE,sBAAsB,GAAG,uBAAuB,CAAC,GAAG;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpC,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAoCJ,eAAO,MAAM,4BAA4B,EAAE,aA2E1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,aAgDxC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,aAmDlC,CAAC;AAIF,wBAAsB,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,gBAgC9E;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAkBpC;AAuBD,wBAAsB,gCAAgC,CAAC,WAAW,EAAE,YAAY,iBAyF/E"}
+{"version":3,"file":"chain_l2_config.d.ts","sourceRoot":"","sources":["../../src/config/chain_l2_config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAWrE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,GAC5C,IAAI,CAAC,aAAa,EAAE,sBAAsB,GAAG,uBAAuB,CAAC,GAAG;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IAIpC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAGhC,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AA+CJ,eAAO,MAAM,4BAA4B,EAAE,aA+E1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,aAmDxC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,aAsDlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aA+EnC,CAAC;AAIF,wBAAsB,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,gBAQ9E;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAoBpC;AAMD,wBAAsB,gCAAgC,CAAC,WAAW,EAAE,YAAY,iBA4F/E"}

package/dest/config/chain_l2_config.js

@@ -1,16 +1,20 @@
 import { DefaultL1ContractsConfig } from '@aztec/ethereum';
 import { EthAddress } from '@aztec/foundation/eth-address';
-import { mkdir, readFile, stat, writeFile } from 'fs/promises';
-import path, { dirname, join } from 'path';
+import path, { join } from 'path';
 import publicIncludeMetrics from '../../public_include_metric_prefixes.json' with {
     type: 'json'
 };
+import { cachedFetch } from './cached_fetch.js';
+import { enrichEthAddressVar, enrichVar } from './enrich_env.js';
+const defaultDBMapSizeKb = 128 * 1_024 * 1_024; // 128 GB
+const tbMapSizeKb = 1_024 * 1_024 * 1_024; // 1 TB
 const DefaultSlashConfig = {
     /** Tally-style slashing */ slasherFlavor: 'tally',
     /** Allow one round for vetoing */ slashingExecutionDelayInRounds: 1,
     /** How long for a slash payload to be executed */ slashingLifetimeInRounds: 5,
     /** Allow 2 rounds to discover faults */ slashingOffsetInRounds: 2,
     /** No slash vetoer */ slashingVetoer: EthAddress.ZERO,
+    /** Use default disable duration */ slashingDisableDuration: DefaultL1ContractsConfig.slashingDisableDuration,
     /** Use default slash amounts */ slashAmountSmall: DefaultL1ContractsConfig.slashAmountSmall,
     slashAmountMedium: DefaultL1ContractsConfig.slashAmountMedium,
     slashAmountLarge: DefaultL1ContractsConfig.slashAmountLarge,
@@ -25,11 +29,19 @@ const DefaultSlashConfig = {
     slashProposeInvalidAttestationsPenalty: DefaultL1ContractsConfig.slashAmountLarge,
     slashAttestDescendantOfInvalidPenalty: DefaultL1ContractsConfig.slashAmountLarge,
     slashUnknownPenalty: DefaultL1ContractsConfig.slashAmountSmall,
-    slashBroadcastedInvalidBlockPenalty: DefaultL1ContractsConfig.slashAmountMedium,
+    slashBroadcastedInvalidBlockPenalty: 0n,
     slashMaxPayloadSize: 50,
     slashGracePeriodL2Slots: 32 * 2,
     slashOffenseExpirationRounds: 8,
-    sentinelEnabled: true
+    sentinelEnabled: true,
+    slashExecuteRoundsLookBack: 4
+};
+const DefaultNetworkDBMapSizeConfig = {
+    dbMapSizeKb: defaultDBMapSizeKb,
+    archiverStoreMapSizeKb: tbMapSizeKb,
+    noteHashTreeMapSizeKb: tbMapSizeKb,
+    nullifierTreeMapSizeKb: tbMapSizeKb,
+    publicDataTreeMapSizeKb: tbMapSizeKb
 };
 export const stagingIgnitionL2ChainConfig = {
     l1ChainId: 11155111,
@@ -37,9 +49,6 @@ export const stagingIgnitionL2ChainConfig = {
     sponsoredFPC: false,
     p2pEnabled: true,
     p2pBootstrapNodes: [],
-    registryAddress: '0x6c04b1c116ec1ea0f918e3cc91e87b0af3e23b73',
-    slashFactoryAddress: '',
-    feeAssetHandlerAddress: '',
     seqMinTxsPerBlock: 0,
     seqMaxTxsPerBlock: 0,
     realProofs: true,
@@ -57,11 +66,13 @@ export const stagingIgnitionL2ChainConfig = {
     /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */ aztecSlotDuration: 72,
     /** How many L2 slots an epoch lasts. */ aztecEpochDuration: 32,
     /** The target validator committee size. */ aztecTargetCommitteeSize: 24,
+    /** The number of epochs to lag behind the current epoch for validator selection. */ lagInEpochs: 2,
     /** The number of epochs after an epoch ends that proofs are still accepted. */ aztecProofSubmissionEpochs: 1,
     /** How many sequencers must agree with a slash for it to be executed. */ slashingQuorum: 65,
     slashingRoundSizeInEpochs: 4,
     slashingLifetimeInRounds: 40,
     slashingExecutionDelayInRounds: 28,
+    slashingDisableDuration: 5 * 24 * 60 * 60,
     slashAmountSmall: 2_000n * 10n ** 18n,
     slashAmountMedium: 10_000n * 10n ** 18n,
     slashAmountLarge: 50_000n * 10n ** 18n,
@@ -73,6 +84,7 @@ export const stagingIgnitionL2ChainConfig = {
     /** The proving cost per mana */ provingCostPerMana: 0n,
     ejectionThreshold: 100_000n * 10n ** 18n,
     activationThreshold: 200_000n * 10n ** 18n,
+    localEjectionThreshold: 196_000n * 10n ** 18n,
     governanceProposerRoundSize: 300,
     governanceProposerQuorum: 151,
     // Node slashing config
@@ -87,11 +99,13 @@ export const stagingIgnitionL2ChainConfig = {
     slashProposeInvalidAttestationsPenalty: 50_000n * 10n ** 18n,
     slashAttestDescendantOfInvalidPenalty: 50_000n * 10n ** 18n,
     slashUnknownPenalty: 2_000n * 10n ** 18n,
-    slashBroadcastedInvalidBlockPenalty: 10_000n * 10n ** 18n,
+    slashBroadcastedInvalidBlockPenalty: 0n,
     slashMaxPayloadSize: 50,
     slashGracePeriodL2Slots: 32 * 4,
     slashOffenseExpirationRounds: 8,
-    sentinelEnabled: true
+    sentinelEnabled: true,
+    slashExecuteRoundsLookBack: 4,
+    ...DefaultNetworkDBMapSizeConfig
 };
 export const stagingPublicL2ChainConfig = {
     l1ChainId: 11155111,
@@ -99,9 +113,6 @@ export const stagingPublicL2ChainConfig = {
     sponsoredFPC: true,
     p2pEnabled: true,
     p2pBootstrapNodes: [],
-    registryAddress: '0x2e48addca360da61e4d6c21ff2b1961af56eb83b',
-    slashFactoryAddress: '0xe19410632fd00695bc5a08dd82044b7b26317742',
-    feeAssetHandlerAddress: '0xb46dc3d91f849999330b6dd93473fa29fc45b076',
     seqMinTxsPerBlock: 0,
     seqMaxTxsPerBlock: 20,
     realProofs: true,
@@ -120,6 +131,8 @@ export const stagingPublicL2ChainConfig = {
     /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */ aztecSlotDuration: 36,
     /** How many L2 slots an epoch lasts. */ aztecEpochDuration: 32,
     /** The target validator committee size. */ aztecTargetCommitteeSize: 48,
+    /** The number of epochs to lag behind the current epoch for validator selection. */ lagInEpochs: DefaultL1ContractsConfig.lagInEpochs,
+    /** The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup */ localEjectionThreshold: DefaultL1ContractsConfig.localEjectionThreshold,
     /** The number of epochs after an epoch ends that proofs are still accepted. */ aztecProofSubmissionEpochs: 1,
     /** The deposit amount for a validator */ activationThreshold: DefaultL1ContractsConfig.activationThreshold,
     /** The minimum stake for a validator. */ ejectionThreshold: DefaultL1ContractsConfig.ejectionThreshold,
@@ -128,7 +141,8 @@ export const stagingPublicL2ChainConfig = {
     /** The mana target for the rollup */ manaTarget: DefaultL1ContractsConfig.manaTarget,
     /** The proving cost per mana */ provingCostPerMana: DefaultL1ContractsConfig.provingCostPerMana,
     /** Exit delay for stakers */ exitDelaySeconds: DefaultL1ContractsConfig.exitDelaySeconds,
-    ...DefaultSlashConfig
+    ...DefaultSlashConfig,
+    ...DefaultNetworkDBMapSizeConfig
 };
 export const testnetL2ChainConfig = {
     l1ChainId: 11155111,
@@ -136,9 +150,6 @@ export const testnetL2ChainConfig = {
     sponsoredFPC: true,
     p2pEnabled: true,
     p2pBootstrapNodes: [],
-    registryAddress: '0xc2f24280f5c7f4897370dfdeb30f79ded14f1c81',
-    slashFactoryAddress: '0x76291684ae928d6e5bcff348e36917f4cc532db8',
-    feeAssetHandlerAddress: '0x50513c3713ffd33301e85f30d86ab764df421fe9',
     seqMinTxsPerBlock: 0,
     seqMaxTxsPerBlock: 20,
     realProofs: true,
@@ -157,9 +168,11 @@ export const testnetL2ChainConfig = {
     /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */ aztecSlotDuration: 36,
     /** How many L2 slots an epoch lasts. */ aztecEpochDuration: 32,
     /** The target validator committee size. */ aztecTargetCommitteeSize: 48,
+    /** The number of epochs to lag behind the current epoch for validator selection. */ lagInEpochs: 2,
     /** The number of epochs after an epoch ends that proofs are still accepted. */ aztecProofSubmissionEpochs: 1,
     /** The deposit amount for a validator */ activationThreshold: DefaultL1ContractsConfig.activationThreshold,
     /** The minimum stake for a validator. */ ejectionThreshold: DefaultL1ContractsConfig.ejectionThreshold,
+    /** The local ejection threshold for a validator. Stricter than ejectionThreshold but local to a specific rollup */ localEjectionThreshold: DefaultL1ContractsConfig.localEjectionThreshold,
     /** The slashing round size */ slashingRoundSizeInEpochs: DefaultL1ContractsConfig.slashingRoundSizeInEpochs,
     /** Governance proposing round size */ governanceProposerRoundSize: DefaultL1ContractsConfig.governanceProposerRoundSize,
     /** The mana target for the rollup */ manaTarget: DefaultL1ContractsConfig.manaTarget,
@@ -168,38 +181,81 @@ export const testnetL2ChainConfig = {
     ...DefaultSlashConfig,
     slashPrunePenalty: 0n,
     slashDataWithholdingPenalty: 0n,
-    slashInactivityPenalty: DefaultL1ContractsConfig.slashAmountMedium
+    slashInactivityPenalty: DefaultL1ContractsConfig.slashAmountMedium,
+    ...DefaultNetworkDBMapSizeConfig
+};
+export const ignitionL2ChainConfig = {
+    l1ChainId: 1,
+    testAccounts: false,
+    sponsoredFPC: false,
+    p2pEnabled: true,
+    p2pBootstrapNodes: [],
+    seqMinTxsPerBlock: 0,
+    seqMaxTxsPerBlock: 0,
+    realProofs: true,
+    snapshotsUrl: 'https://storage.googleapis.com/aztec-testnet/snapshots/ignition/',
+    autoUpdate: 'notify',
+    autoUpdateUrl: 'https://storage.googleapis.com/aztec-testnet/auto-update/ignition.json',
+    maxTxPoolSize: 100_000_000,
+    publicIncludeMetrics,
+    publicMetricsCollectorUrl: 'https://telemetry.alpha-testnet.aztec-labs.com/v1/metrics',
+    publicMetricsCollectFrom: [
+        'sequencer'
+    ],
+    txPoolDeleteTxsAfterReorg: false,
+    /** How many seconds an L1 slot lasts. */ ethereumSlotDuration: 12,
+    /** How many seconds an L2 slots lasts (must be multiple of ethereum slot duration). */ aztecSlotDuration: 72,
+    /** How many L2 slots an epoch lasts. */ aztecEpochDuration: 32,
+    /** The target validator committee size. */ aztecTargetCommitteeSize: 24,
+    /** The number of epochs to lag behind the current epoch for validator selection. */ lagInEpochs: 2,
+    /** The number of epochs after an epoch ends that proofs are still accepted. */ aztecProofSubmissionEpochs: 1,
+    /** How many sequencers must agree with a slash for it to be executed. */ slashingQuorum: 65,
+    slashingRoundSizeInEpochs: 4,
+    slashingLifetimeInRounds: 40,
+    slashingExecutionDelayInRounds: 28,
+    slashingDisableDuration: 5 * 24 * 60 * 60,
+    slashAmountSmall: 2_000n * 10n ** 18n,
+    slashAmountMedium: 10_000n * 10n ** 18n,
+    slashAmountLarge: 50_000n * 10n ** 18n,
+    slashingOffsetInRounds: 2,
+    slasherFlavor: 'tally',
+    slashingVetoer: EthAddress.ZERO,
+    /** The mana target for the rollup */ manaTarget: 0n,
+    exitDelaySeconds: 5 * 24 * 60 * 60,
+    /** The proving cost per mana */ provingCostPerMana: 0n,
+    ejectionThreshold: 100_000n * 10n ** 18n,
+    activationThreshold: 200_000n * 10n ** 18n,
+    localEjectionThreshold: 196_000n * 10n ** 18n,
+    governanceProposerRoundSize: 300,
+    governanceProposerQuorum: 151,
+    // Node slashing config
+    // TODO TMNT-330
+    slashMinPenaltyPercentage: 0.5,
+    slashMaxPenaltyPercentage: 2.0,
+    slashInactivityTargetPercentage: 0.7,
+    slashInactivityConsecutiveEpochThreshold: 2,
+    slashInactivityPenalty: 2_000n * 10n ** 18n,
+    slashPrunePenalty: 0n,
+    slashDataWithholdingPenalty: 0n,
+    slashProposeInvalidAttestationsPenalty: 50_000n * 10n ** 18n,
+    slashAttestDescendantOfInvalidPenalty: 50_000n * 10n ** 18n,
+    slashUnknownPenalty: 2_000n * 10n ** 18n,
+    slashBroadcastedInvalidBlockPenalty: 0n,
+    slashMaxPayloadSize: 50,
+    slashGracePeriodL2Slots: 32 * 4,
+    slashOffenseExpirationRounds: 8,
+    sentinelEnabled: true,
+    slashExecuteRoundsLookBack: 4,
+    ...DefaultNetworkDBMapSizeConfig
 };
 const BOOTNODE_CACHE_DURATION_MS = 60 * 60 * 1000; // 1 hour;
 export async function getBootnodes(networkName, cacheDir) {
-    const cacheFile = cacheDir ? join(cacheDir, networkName, 'bootnodes.json') : undefined;
-    try {
-        if (cacheFile) {
-            const info = await stat(cacheFile);
-            if (info.mtimeMs + BOOTNODE_CACHE_DURATION_MS > Date.now()) {
-                return JSON.parse(await readFile(cacheFile, 'utf-8'))['bootnodes'];
-            }
-        }
-    } catch  {
-    // no-op. Get the remote-file
-    }
     const url = `http://static.aztec.network/${networkName}/bootnodes.json`;
-    const response = await fetch(url);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch basic contract addresses from ${url}. Check you are using a correct network name.`);
-    }
-    const json = await response.json();
-    try {
-        if (cacheFile) {
-            await mkdir(dirname(cacheFile), {
-                recursive: true
-            });
-            await writeFile(cacheFile, JSON.stringify(json), 'utf-8');
-        }
-    } catch  {
-    // no-op
-    }
-    return json['bootnodes'];
+    const data = await cachedFetch(url, {
+        cacheDurationMs: BOOTNODE_CACHE_DURATION_MS,
+        cacheFile: cacheDir ? join(cacheDir, networkName, 'bootnodes.json') : undefined
+    });
+    return data?.bootnodes;
 }
 export async function getL2ChainConfig(networkName, cacheDir) {
     let config;
@@ -215,6 +271,10 @@ export async function getL2ChainConfig(networkName, cacheDir) {
         config = {
             ...stagingIgnitionL2ChainConfig
         };
+    } else if (networkName === 'ignition') {
+        config = {
+            ...ignitionL2ChainConfig
+        };
     }
     if (!config) {
         return undefined;
@@ -226,21 +286,6 @@ export async function getL2ChainConfig(networkName, cacheDir) {
     }
     return config;
 }
-function enrichVar(envVar, value) {
-    // Don't override
-    if (process.env[envVar] || value === undefined) {
-        return;
-    }
-    process.env[envVar] = value;
-}
-function enrichEthAddressVar(envVar, value) {
-    // EthAddress doesn't like being given empty strings
-    if (value === '') {
-        enrichVar(envVar, EthAddress.ZERO.toString());
-        return;
-    }
-    enrichVar(envVar, value);
-}
 function getDefaultDataDir(networkName) {
     return path.join(process.env.HOME || '~', '.aztec', networkName, 'data');
 }
@@ -265,6 +310,11 @@ export async function enrichEnvironmentWithChainConfig(networkName) {
     enrichVar('PXE_PROVER_ENABLED', config.realProofs.toString());
     enrichVar('SYNC_SNAPSHOTS_URL', config.snapshotsUrl);
     enrichVar('P2P_MAX_TX_POOL_SIZE', config.maxTxPoolSize.toString());
+    enrichVar('DATA_STORE_MAP_SIZE_KB', config.dbMapSizeKb.toString());
+    enrichVar('ARCHIVER_STORE_MAP_SIZE_KB', config.archiverStoreMapSizeKb.toString());
+    enrichVar('NOTE_HASH_TREE_MAP_SIZE_KB', config.noteHashTreeMapSizeKb.toString());
+    enrichVar('NULLIFIER_TREE_MAP_SIZE_KB', config.nullifierTreeMapSizeKb.toString());
+    enrichVar('PUBLIC_DATA_TREE_MAP_SIZE_KB', config.publicDataTreeMapSizeKb.toString());
     if (config.autoUpdate) {
         enrichVar('AUTO_UPDATE', config.autoUpdate?.toString());
     }
@@ -280,9 +330,6 @@ export async function enrichEnvironmentWithChainConfig(networkName) {
     if (config.publicMetricsCollectFrom) {
         enrichVar('PUBLIC_OTEL_COLLECT_FROM', config.publicMetricsCollectFrom.join(','));
     }
-    enrichEthAddressVar('REGISTRY_CONTRACT_ADDRESS', config.registryAddress);
-    enrichEthAddressVar('SLASH_FACTORY_CONTRACT_ADDRESS', config.slashFactoryAddress);
-    enrichEthAddressVar('FEE_ASSET_HANDLER_CONTRACT_ADDRESS', config.feeAssetHandlerAddress);
     // Deployment stuff
     enrichVar('ETHEREUM_SLOT_DURATION', config.ethereumSlotDuration.toString());
     enrichVar('AZTEC_SLOT_DURATION', config.aztecSlotDuration.toString());
@@ -291,6 +338,7 @@ export async function enrichEnvironmentWithChainConfig(networkName) {
     enrichVar('AZTEC_PROOF_SUBMISSION_EPOCHS', config.aztecProofSubmissionEpochs.toString());
     enrichVar('AZTEC_ACTIVATION_THRESHOLD', config.activationThreshold.toString());
     enrichVar('AZTEC_EJECTION_THRESHOLD', config.ejectionThreshold.toString());
+    enrichVar('AZTEC_LOCAL_EJECTION_THRESHOLD', config.localEjectionThreshold.toString());
     enrichVar('AZTEC_SLASHING_QUORUM', config.slashingQuorum?.toString());
     enrichVar('AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS', config.slashingRoundSizeInEpochs.toString());
     enrichVar('AZTEC_GOVERNANCE_PROPOSER_QUORUM', config.governanceProposerQuorum?.toString());

package/dest/config/enrich_env.d.ts

@@ -0,0 +1,4 @@
+import type { EnvVar } from '@aztec/foundation/config';
+export declare function enrichVar(envVar: EnvVar, value: string | undefined): void;
+export declare function enrichEthAddressVar(envVar: EnvVar, value: string): void;
+//# sourceMappingURL=enrich_env.d.ts.map

package/dest/config/enrich_env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich_env.d.ts","sourceRoot":"","sources":["../../src/config/enrich_env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,QAMlE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAGhE"}

package/dest/config/enrich_env.js

@@ -0,0 +1,12 @@
+import { EthAddress } from '@aztec/aztec.js';
+export function enrichVar(envVar, value) {
+    // Don't override
+    if (process.env[envVar] || value === undefined) {
+        return;
+    }
+    process.env[envVar] = value;
+}
+export function enrichEthAddressVar(envVar, value) {
+    // EthAddress doesn't like being given empty strings
+    enrichVar(envVar, value || EthAddress.ZERO.toString());
+}

package/dest/config/index.d.ts

@@ -1,3 +1,5 @@
+export * from './cached_fetch.js';
 export * from './chain_l2_config.js';
 export * from './get_l1_config.js';
+export * from './network_config.js';
 //# sourceMappingURL=index.d.ts.map

package/dest/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dest/config/index.js

@@ -1,2 +1,4 @@
+export * from './cached_fetch.js';
 export * from './chain_l2_config.js';
 export * from './get_l1_config.js';
+export * from './network_config.js';

package/dest/config/network_config.d.ts

@@ -0,0 +1,19 @@
+import { type NetworkConfig, type NetworkNames } from '@aztec/foundation/config';
+/**
+ * Fetches remote network configuration from GitHub with caching support.
+ * Uses the reusable cachedFetch utility.
+ *
+ * @param networkName - The network name to fetch config for
+ * @param cacheDir - Optional cache directory for storing fetched config
+ * @returns Remote configuration for the specified network, or undefined if not found/error
+ */
+export declare function getNetworkConfig(networkName: NetworkNames, cacheDir?: string): Promise<NetworkConfig | undefined>;
+/**
+ * Enriches environment variables with remote network configuration.
+ * This function is called before node config initialization to set env vars
+ * from the remote config, following the same pattern as enrichEnvironmentWithChainConfig().
+ *
+ * @param networkName - The network name to fetch remote config for
+ */
+export declare function enrichEnvironmentWithNetworkConfig(networkName: NetworkNames): Promise<void>;
+//# sourceMappingURL=network_config.d.ts.map

package/dest/config/network_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network_config.d.ts","sourceRoot":"","sources":["../../src/config/network_config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA0B,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYzG;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAiDpC;AAED;;;;;;GAMG;AACH,wBAAsB,kCAAkC,CAAC,WAAW,EAAE,YAAY,iBAoBjF"}

package/dest/config/network_config.js

@@ -0,0 +1,79 @@
+import { NetworkConfigMapSchema } from '@aztec/foundation/config';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { cachedFetch } from './cached_fetch.js';
+import { enrichEthAddressVar, enrichVar } from './enrich_env.js';
+const DEFAULT_CONFIG_URL = 'https://raw.githubusercontent.com/AztecProtocol/networks/refs/heads/main/network_config.json';
+const NETWORK_CONFIG_CACHE_DURATION_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Fetches remote network configuration from GitHub with caching support.
+ * Uses the reusable cachedFetch utility.
+ *
+ * @param networkName - The network name to fetch config for
+ * @param cacheDir - Optional cache directory for storing fetched config
+ * @returns Remote configuration for the specified network, or undefined if not found/error
+ */ export async function getNetworkConfig(networkName, cacheDir) {
+    let url;
+    const configLocation = process.env.NETWORK_CONFIG_LOCATION || DEFAULT_CONFIG_URL;
+    if (!configLocation) {
+        return undefined;
+    }
+    try {
+        if (configLocation.includes('://')) {
+            url = new URL(configLocation);
+        } else {
+            url = new URL(`file://${configLocation}`);
+        }
+    } catch  {
+    /* no-op */ }
+    if (!url) {
+        return undefined;
+    }
+    try {
+        let rawConfig;
+        if (url.protocol === 'http:' || url.protocol === 'https:') {
+            rawConfig = await cachedFetch(url.href, {
+                cacheDurationMs: NETWORK_CONFIG_CACHE_DURATION_MS,
+                cacheFile: cacheDir ? join(cacheDir, networkName, 'network_config.json') : undefined
+            });
+        } else if (url.protocol === 'file:') {
+            rawConfig = JSON.parse(await readFile(url.pathname, 'utf-8'));
+        } else {
+            throw new Error('Unsupported Aztec network config protocol: ' + url.href);
+        }
+        if (!rawConfig) {
+            return undefined;
+        }
+        const networkConfigMap = NetworkConfigMapSchema.parse(rawConfig);
+        if (networkName in networkConfigMap) {
+            return networkConfigMap[networkName];
+        } else {
+            return undefined;
+        }
+    } catch  {
+        return undefined;
+    }
+}
+/**
+ * Enriches environment variables with remote network configuration.
+ * This function is called before node config initialization to set env vars
+ * from the remote config, following the same pattern as enrichEnvironmentWithChainConfig().
+ *
+ * @param networkName - The network name to fetch remote config for
+ */ export async function enrichEnvironmentWithNetworkConfig(networkName) {
+    if (networkName === 'local') {
+        return; // No remote config for local development
+    }
+    const cacheDir = process.env.DATA_DIRECTORY ? join(process.env.DATA_DIRECTORY, 'cache') : undefined;
+    const networkConfig = await getNetworkConfig(networkName, cacheDir);
+    if (!networkConfig) {
+        return;
+    }
+    enrichVar('BOOTSTRAP_NODES', networkConfig.bootnodes.join(','));
+    enrichVar('L1_CHAIN_ID', String(networkConfig.l1ChainId));
+    enrichVar('SYNC_SNAPSHOTS_URL', networkConfig.snapshots.join(','));
+    enrichEthAddressVar('REGISTRY_CONTRACT_ADDRESS', networkConfig.registryAddress.toString());
+    if (networkConfig.feeAssetHandlerAddress) {
+        enrichEthAddressVar('FEE_ASSET_HANDLER_CONTRACT_ADDRESS', networkConfig.feeAssetHandlerAddress.toString());
+    }
+}