@aztec/cli 2.0.3-rc.17 → 2.0.3-rc.19

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

@@ -22,11 +22,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,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;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;AA6CJ,eAAO,MAAM,4BAA4B,EAAE,aA8E1C,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,aAkDxC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,aAqDlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aA8EnC,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,iBA+F/E"}

package/dest/config/chain_l2_config.js

@@ -1,10 +1,13 @@
 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,
@@ -25,11 +28,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,
@@ -87,11 +98,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,
@@ -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,
@@ -168,38 +182,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: [],
+    registryAddress: '',
+    slashFactoryAddress: '',
+    feeAssetHandlerAddress: '',
+    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 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,
+    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,
+    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 +272,10 @@ export async function getL2ChainConfig(networkName, cacheDir) {
         config = {
             ...stagingIgnitionL2ChainConfig
         };
+    } else if (networkName === 'ignition') {
+        config = {
+            ...ignitionL2ChainConfig
+        };
     }
     if (!config) {
         return undefined;
@@ -226,21 +287,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 +311,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());
     }

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());
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/cli",
-  "version": "2.0.3-rc.17",
+  "version": "2.0.3-rc.19",
   "type": "module",
   "exports": {
     "./contracts": "./dest/cmds/contracts/index.js",
@@ -70,17 +70,17 @@
     ]
   },
   "dependencies": {
-    "@aztec/archiver": "2.0.3-rc.17",
-    "@aztec/aztec.js": "2.0.3-rc.17",
-    "@aztec/constants": "2.0.3-rc.17",
-    "@aztec/entrypoints": "2.0.3-rc.17",
-    "@aztec/ethereum": "2.0.3-rc.17",
-    "@aztec/foundation": "2.0.3-rc.17",
-    "@aztec/l1-artifacts": "2.0.3-rc.17",
-    "@aztec/node-lib": "2.0.3-rc.17",
-    "@aztec/p2p": "2.0.3-rc.17",
-    "@aztec/stdlib": "2.0.3-rc.17",
-    "@aztec/world-state": "2.0.3-rc.17",
+    "@aztec/archiver": "2.0.3-rc.19",
+    "@aztec/aztec.js": "2.0.3-rc.19",
+    "@aztec/constants": "2.0.3-rc.19",
+    "@aztec/entrypoints": "2.0.3-rc.19",
+    "@aztec/ethereum": "2.0.3-rc.19",
+    "@aztec/foundation": "2.0.3-rc.19",
+    "@aztec/l1-artifacts": "2.0.3-rc.19",
+    "@aztec/node-lib": "2.0.3-rc.19",
+    "@aztec/p2p": "2.0.3-rc.19",
+    "@aztec/stdlib": "2.0.3-rc.19",
+    "@aztec/world-state": "2.0.3-rc.19",
     "@iarna/toml": "^2.2.5",
     "@libp2p/peer-id-factory": "^3.0.4",
     "commander": "^12.1.0",
@@ -92,8 +92,8 @@
     "viem": "2.23.7"
   },
   "devDependencies": {
-    "@aztec/accounts": "2.0.3-rc.17",
-    "@aztec/protocol-contracts": "2.0.3-rc.17",
+    "@aztec/accounts": "2.0.3-rc.19",
+    "@aztec/protocol-contracts": "2.0.3-rc.19",
     "@jest/globals": "^30.0.0",
     "@types/jest": "^30.0.0",
     "@types/lodash.chunk": "^4.2.9",
@@ -109,15 +109,15 @@
     "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "@aztec/accounts": "2.0.3-rc.17",
-    "@aztec/bb-prover": "2.0.3-rc.17",
-    "@aztec/ethereum": "2.0.3-rc.17",
-    "@aztec/l1-artifacts": "2.0.3-rc.17",
-    "@aztec/noir-contracts.js": "2.0.3-rc.17",
-    "@aztec/noir-protocol-circuits-types": "2.0.3-rc.17",
-    "@aztec/noir-test-contracts.js": "2.0.3-rc.17",
-    "@aztec/protocol-contracts": "2.0.3-rc.17",
-    "@aztec/stdlib": "2.0.3-rc.17"
+    "@aztec/accounts": "2.0.3-rc.19",
+    "@aztec/bb-prover": "2.0.3-rc.19",
+    "@aztec/ethereum": "2.0.3-rc.19",
+    "@aztec/l1-artifacts": "2.0.3-rc.19",
+    "@aztec/noir-contracts.js": "2.0.3-rc.19",
+    "@aztec/noir-protocol-circuits-types": "2.0.3-rc.19",
+    "@aztec/noir-test-contracts.js": "2.0.3-rc.19",
+    "@aztec/protocol-contracts": "2.0.3-rc.19",
+    "@aztec/stdlib": "2.0.3-rc.19"
   },
   "files": [
     "dest",

package/src/config/cached_fetch.ts

@@ -0,0 +1,67 @@
+import { createLogger } from '@aztec/aztec.js';
+
+import { mkdir, readFile, stat, writeFile } from 'fs/promises';
+import { dirname } from 'path';
+
+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 async function cachedFetch<T = any>(
+  url: string,
+  options: CachedFetchOptions,
+  fetch = globalThis.fetch,
+  log = createLogger('cached_fetch'),
+): Promise<T | undefined> {
+  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/src/config/chain_l2_config.ts

@@ -5,10 +5,14 @@ import type { SharedNodeConfig } from '@aztec/node-lib/config';
 import type { P2PConfig } from '@aztec/p2p/config';
 import type { SlasherConfig } from '@aztec/stdlib/interfaces/server';
 
-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
 
 export type L2ChainConfig = L1ContractsConfig &
   Pick<P2PConfig, 'txPoolDeleteTxsAfterReorg'> &
@@ -32,6 +36,14 @@ export type L2ChainConfig = L1ContractsConfig &
     publicMetricsCollectorUrl?: string;
     publicMetricsCollectFrom?: string[];
 
+    // Setting the dbMapSize provides the default for every DB in the node.
+    // Then we explicitly override the sizes for the archiver and the larger trees.
+    dbMapSizeKb: number;
+    archiverStoreMapSizeKb: number;
+    noteHashTreeMapSizeKb: number;
+    nullifierTreeMapSizeKb: number;
+    publicDataTreeMapSizeKb: number;
+
     // Control whether sentinel is enabled or not. Needed for slashing
     sentinelEnabled: boolean;
   };
@@ -63,11 +75,20 @@ const DefaultSlashConfig = {
   slashProposeInvalidAttestationsPenalty: DefaultL1ContractsConfig.slashAmountLarge,
   slashAttestDescendantOfInvalidPenalty: DefaultL1ContractsConfig.slashAmountLarge,
   slashUnknownPenalty: DefaultL1ContractsConfig.slashAmountSmall,
-  slashBroadcastedInvalidBlockPenalty: DefaultL1ContractsConfig.slashAmountMedium,
+  slashBroadcastedInvalidBlockPenalty: 0n, // DefaultL1ContractsConfig.slashAmountSmall // Disabled until further testing
   slashMaxPayloadSize: 50,
   slashGracePeriodL2Slots: 32 * 2, // Two epochs from genesis
   slashOffenseExpirationRounds: 8,
   sentinelEnabled: true,
+  slashExecuteRoundsLookBack: 4,
+} satisfies Partial<L2ChainConfig>;
+
+const DefaultNetworkDBMapSizeConfig = {
+  dbMapSizeKb: defaultDBMapSizeKb,
+  archiverStoreMapSizeKb: tbMapSizeKb,
+  noteHashTreeMapSizeKb: tbMapSizeKb,
+  nullifierTreeMapSizeKb: tbMapSizeKb,
+  publicDataTreeMapSizeKb: tbMapSizeKb,
 } satisfies Partial<L2ChainConfig>;
 
 export const stagingIgnitionL2ChainConfig: L2ChainConfig = {
@@ -140,11 +161,14 @@ export const stagingIgnitionL2ChainConfig: L2ChainConfig = {
   slashProposeInvalidAttestationsPenalty: 50_000n * 10n ** 18n,
   slashAttestDescendantOfInvalidPenalty: 50_000n * 10n ** 18n,
   slashUnknownPenalty: 2_000n * 10n ** 18n,
-  slashBroadcastedInvalidBlockPenalty: 10_000n * 10n ** 18n,
+  slashBroadcastedInvalidBlockPenalty: 0n, // 10_000n * 10n ** 18n, Disabled for now until further testing
   slashMaxPayloadSize: 50,
   slashGracePeriodL2Slots: 32 * 4, // One round from genesis
   slashOffenseExpirationRounds: 8,
   sentinelEnabled: true,
+  slashExecuteRoundsLookBack: 4,
+
+  ...DefaultNetworkDBMapSizeConfig,
 };
 
 export const stagingPublicL2ChainConfig: L2ChainConfig = {
@@ -195,6 +219,8 @@ export const stagingPublicL2ChainConfig: L2ChainConfig = {
   exitDelaySeconds: DefaultL1ContractsConfig.exitDelaySeconds,
 
   ...DefaultSlashConfig,
+
+  ...DefaultNetworkDBMapSizeConfig,
 };
 
 export const testnetL2ChainConfig: L2ChainConfig = {
@@ -248,42 +274,100 @@ export const testnetL2ChainConfig: L2ChainConfig = {
   slashPrunePenalty: 0n,
   slashDataWithholdingPenalty: 0n,
   slashInactivityPenalty: DefaultL1ContractsConfig.slashAmountMedium,
+
+  ...DefaultNetworkDBMapSizeConfig,
+};
+
+export const ignitionL2ChainConfig: L2ChainConfig = {
+  l1ChainId: 1,
+  testAccounts: false,
+  sponsoredFPC: false,
+  p2pEnabled: true,
+  p2pBootstrapNodes: [],
+  registryAddress: '',
+  slashFactoryAddress: '',
+  feeAssetHandlerAddress: '',
+  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, // 100MB
+  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 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,
+  slashAmountSmall: 2_000n * 10n ** 18n,
+  slashAmountMedium: 10_000n * 10n ** 18n,
+  slashAmountLarge: 50_000n * 10n ** 18n,
+  slashingOffsetInRounds: 2,
+  slasherFlavor: 'tally',
+  slashingVetoer: EthAddress.ZERO, // TODO TMNT-329
+
+  /** 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,
+
+  governanceProposerRoundSize: 300, // TODO TMNT-322
+  governanceProposerQuorum: 151, // TODO TMNT-322
+
+  // Node slashing config
+  // TODO TMNT-330
+  slashMinPenaltyPercentage: 0.5,
+  slashMaxPenaltyPercentage: 2.0,
+  slashInactivityTargetPercentage: 0.7,
+  slashInactivityConsecutiveEpochThreshold: 2,
+  slashInactivityPenalty: 2_000n * 10n ** 18n,
+  slashPrunePenalty: 0n, // 2_000n * 10n ** 18n, We disable slashing for prune offenses right now
+  slashDataWithholdingPenalty: 0n, // 2_000n * 10n ** 18n, We disable slashing for data withholding offenses right now
+  slashProposeInvalidAttestationsPenalty: 50_000n * 10n ** 18n,
+  slashAttestDescendantOfInvalidPenalty: 50_000n * 10n ** 18n,
+  slashUnknownPenalty: 2_000n * 10n ** 18n,
+  slashBroadcastedInvalidBlockPenalty: 0n, // 10_000n * 10n ** 18n, Disabled for now until further testing
+  slashMaxPayloadSize: 50,
+  slashGracePeriodL2Slots: 32 * 4, // One round from genesis
+  slashOffenseExpirationRounds: 8,
+  sentinelEnabled: true,
+  slashExecuteRoundsLookBack: 4,
+
+  ...DefaultNetworkDBMapSizeConfig,
 };
 
 const BOOTNODE_CACHE_DURATION_MS = 60 * 60 * 1000; // 1 hour;
 
 export async function getBootnodes(networkName: NetworkNames, cacheDir?: string) {
-  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
-  }
+  const data = await cachedFetch(url, {
+    cacheDurationMs: BOOTNODE_CACHE_DURATION_MS,
+    cacheFile: cacheDir ? join(cacheDir, networkName, 'bootnodes.json') : undefined,
+  });
 
-  return json['bootnodes'];
+  return data?.bootnodes;
 }
 
 export async function getL2ChainConfig(
@@ -297,6 +381,8 @@ export async function getL2ChainConfig(
     config = { ...testnetL2ChainConfig };
   } else if (networkName === 'staging-ignition') {
     config = { ...stagingIgnitionL2ChainConfig };
+  } else if (networkName === 'ignition') {
+    config = { ...ignitionL2ChainConfig };
   }
   if (!config) {
     return undefined;
@@ -309,23 +395,6 @@ export async function getL2ChainConfig(
   return config;
 }
 
-function enrichVar(envVar: EnvVar, value: string | undefined) {
-  // Don't override
-  if (process.env[envVar] || value === undefined) {
-    return;
-  }
-  process.env[envVar] = value;
-}
-
-function enrichEthAddressVar(envVar: EnvVar, value: string) {
-  // EthAddress doesn't like being given empty strings
-  if (value === '') {
-    enrichVar(envVar, EthAddress.ZERO.toString());
-    return;
-  }
-  enrichVar(envVar, value);
-}
-
 function getDefaultDataDir(networkName: NetworkNames): string {
   return path.join(process.env.HOME || '~', '.aztec', networkName, 'data');
 }
@@ -355,6 +424,12 @@ export async function enrichEnvironmentWithChainConfig(networkName: NetworkNames
   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());
   }

package/src/config/enrich_env.ts

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

package/src/config/index.ts

@@ -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/src/config/network_config.ts

@@ -0,0 +1,102 @@
+import { type NetworkConfig, NetworkConfigMapSchema, type NetworkNames } 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: NetworkNames,
+  cacheDir?: string,
+): Promise<NetworkConfig | undefined> {
+  let url: URL | undefined;
+  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: any;
+
+    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: NetworkNames) {
+  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());
+  }
+}