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

package/dest/config/index.d.ts

@@ -1,16 +1,44 @@
+import { Fq, Fr } from '../curves/bn254/field.js';
 import type { EnvVar } from './env_var.js';
-export { type EnvVar } from './env_var.js';
-export interface ConfigMapping {
+import { type NetworkNames, getActiveNetworkName } from './network_name.js';
+import { SecretValue } from './secret_value.js';
+export { SecretValue, getActiveNetworkName };
+export type { EnvVar, NetworkNames };
+export type { NetworkConfig, NetworkConfigMap } from './network_config.js';
+export { NetworkConfigMapSchema, NetworkConfigSchema } from './network_config.js';
+export interface ConfigMapping<T> {
     env?: EnvVar;
-    parseEnv?: (val: string) => any;
-    defaultValue?: any;
+    /** Parse an env-var string into `T`. Throws on invalid input. */
+    parseEnv?: (val: string) => T;
+    defaultValue?: T;
     printDefault?: (val: any) => string;
     description: string;
     isBoolean?: boolean;
-    nested?: Record<string, ConfigMapping>;
+    fallback?: EnvVar[];
+    /**
+     * List of deprecated env vars that are still supported but will log a warning.
+     * These should also be included in the fallback array for parsing.
+     */
+    deprecatedFallback?: {
+        env: EnvVar;
+        message?: string;
+    }[];
 }
 export declare function isBooleanConfigValue<T>(obj: T, key: keyof T): boolean;
-export type ConfigMappingsType<T> = Record<keyof T, ConfigMapping>;
+export type ConfigMappingsType<T> = {
+    [K in keyof T]-?: ConfigMapping<Required<T>[K]>;
+};
+/**
+ * Shared utility function to get a value from environment variables with fallback support.
+ * This can be used by both getConfigFromMappings and CLI utilities.
+ *
+ * @param env - The primary environment variable name
+ * @param fallback - Optional array of fallback environment variable names
+ * @param parseFunc - Optional function to parse the environment variable value
+ * @param defaultValue - Optional default value to use if no environment variable is set
+ * @returns The parsed value from environment variables or the default value
+ */
+export declare function getValueFromEnvWithFallback<T>(env: EnvVar | undefined, parseFunc: ((val: string) => T) | undefined, defaultValue: T | undefined, fallback?: EnvVar[]): T | undefined;
 export declare function getConfigFromMappings<T>(configMappings: ConfigMappingsType<T>): T;
 /**
  * Filters out a service's config mappings to exclude certain keys.
@@ -24,27 +52,74 @@ export declare function omitConfigMappings<T, K extends keyof T>(configMappings:
  * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
  * @returns Object with parseEnv and default values for a numerical config value
  */
-export declare function numberConfigHelper(defaultVal: number): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'>;
+export declare function numberConfigHelper(defaultVal: number): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'>;
+/**
+ * Generates parseEnv and default values for a numerical config value.
+ * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
+ * @returns Object with parseEnv and default values for a numerical config value
+ */
+export declare function floatConfigHelper(defaultVal: number, validationFn?: (val: number) => void): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'>;
+/**
+ * Parses an environment variable to a 0-1 percentage value
+ */
+export declare function percentageConfigHelper(defaultVal: number): Pick<ConfigMapping<number>, 'parseEnv' | 'defaultValue'>;
 /**
  * Generates parseEnv and default values for a numerical config value.
  * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
  * @returns Object with parseEnv and default values for a numerical config value
  */
-export declare function bigintConfigHelper(defaultVal?: bigint): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'>;
+export declare function bigintConfigHelper(defaultVal: bigint): Pick<ConfigMapping<bigint>, 'parseEnv' | 'defaultValue'>;
+export declare function bigintConfigHelper(): Pick<ConfigMapping<bigint | undefined>, 'parseEnv' | 'defaultValue'>;
 /**
  * Generates parseEnv for an optional numerical config value.
+ * Empty strings are already handled by getValueFromEnvWithFallback.
  */
-export declare function optionalNumberConfigHelper(): Pick<ConfigMapping, 'parseEnv'>;
+export declare function optionalNumberConfigHelper(): Pick<ConfigMapping<number>, 'parseEnv'>;
+/** Generates parseEnv for an enum-like config value. */
+export declare function enumConfigHelper<T extends string>(values: T[], defaultValue: NoInfer<T>): Pick<ConfigMapping<T>, 'parseEnv' | 'defaultValue'>;
+export declare function enumConfigHelper<T extends string>(values: T[]): Pick<ConfigMapping<T | undefined>, 'parseEnv' | 'defaultValue'>;
 /**
  * Generates parseEnv and default values for a boolean config value.
  * @param defaultVal - The default value to use if the environment variable is not set or is invalid
  * @returns Object with parseEnv and default values for a boolean config value
  */
-export declare function booleanConfigHelper(defaultVal?: boolean): Required<Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+export declare function booleanConfigHelper(defaultVal?: boolean): Required<Pick<ConfigMapping<boolean>, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
     parseVal: (val: string) => boolean;
 }>;
-/** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */
-export declare function parseBooleanEnv(val: string | undefined): boolean;
+export declare function secretValueConfigHelper<T>(parse: (val: string | undefined) => T): Pick<ConfigMapping<SecretValue<T>>, 'parseEnv' | 'defaultValue'> & {
+    parseVal: (val: string) => SecretValue<T>;
+};
+export { parseBooleanEnv } from './parse-env.js';
+export declare function secretStringConfigHelper(): {
+    parseEnv: (val: string) => SecretValue<string>;
+    parseVal: (val: string) => SecretValue<string>;
+    defaultValue: undefined;
+};
+export declare function secretStringConfigHelper(defaultValue: string): {
+    parseEnv: (val: string) => SecretValue<string>;
+    parseVal: (val: string) => SecretValue<string>;
+    defaultValue: SecretValue<string>;
+};
+export declare function secretFrConfigHelper(): {
+    parseEnv: (val: string) => SecretValue<Fr>;
+    parseVal: (val: string) => SecretValue<Fr>;
+    defaultValue: undefined;
+};
+export declare function secretFrConfigHelper(defaultValue: Fr): {
+    parseEnv: (val: string) => SecretValue<Fr>;
+    parseVal: (val: string) => SecretValue<Fr>;
+    defaultValue: SecretValue<Fr>;
+};
+export declare function secretFqConfigHelper(): {
+    parseEnv: (val: string) => SecretValue<Fq>;
+    parseVal: (val: string) => SecretValue<Fq>;
+    defaultValue: undefined;
+};
+export declare function secretFqConfigHelper(defaultValue: Fq): {
+    parseEnv: (val: string) => SecretValue<Fq>;
+    parseVal: (val: string) => SecretValue<Fq>;
+    defaultValue: SecretValue<Fq>;
+};
 /**
  * Picks specific keys from the given configuration mappings.
  *
@@ -63,4 +138,4 @@ export declare function pickConfigMappings<T, K extends keyof T>(configMappings:
  * @returns {T} - The configuration object with default values.
  */
 export declare function getDefaultConfig<T>(configMappings: ConfigMappingsType<T>): T;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb25maWcvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUVsRCxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDM0MsT0FBTyxFQUFFLEtBQUssWUFBWSxFQUFFLG9CQUFvQixFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFFNUUsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRWhELE9BQU8sRUFBRSxXQUFXLEVBQUUsb0JBQW9CLEVBQUUsQ0FBQztBQUM3QyxZQUFZLEVBQUUsTUFBTSxFQUFFLFlBQVksRUFBRSxDQUFDO0FBQ3JDLFlBQVksRUFBRSxhQUFhLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUMzRSxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVsRixNQUFNLFdBQVcsYUFBYSxDQUFDLENBQUM7SUFDOUIsR0FBRyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2IsaUVBQWlFO0lBQ2pFLFFBQVEsQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLE1BQU0sS0FBSyxDQUFDLENBQUM7SUFDOUIsWUFBWSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ2pCLFlBQVksQ0FBQyxFQUFFLENBQUMsR0FBRyxFQUFFLEdBQUcsS0FBSyxNQUFNLENBQUM7SUFDcEMsV0FBVyxFQUFFLE1BQU0sQ0FBQztJQUNwQixTQUFTLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDcEIsUUFBUSxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUM7SUFDcEI7OztPQUdHO0lBQ0gsa0JBQWtCLENBQUMsRUFBRTtRQUFFLEdBQUcsRUFBRSxNQUFNLENBQUM7UUFBQyxPQUFPLENBQUMsRUFBRSxN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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAChC,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO,CAErE;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAkBjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACrD,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACrC,YAAY,EAAE,CAAC,EAAE,GAChB,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAIhC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CAAC,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CAAC,CAUxG;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAU5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,UAAQ,GACjB,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC,GAAG;IAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC,CAQnH;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE;AAcD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EACrD,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACrC,IAAI,EAAE,CAAC,EAAE,GACR,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAEhC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAU5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dest/config/index.js

@@ -1,18 +1,64 @@
+import { Fq, Fr } from '../curves/bn254/field.js';
+import { createConsoleLogger } from '../log/console.js';
+import { getActiveNetworkName } from './network_name.js';
+import { parseBooleanEnv } from './parse-env.js';
+import { SecretValue } from './secret_value.js';
+export { SecretValue, getActiveNetworkName };
+export { NetworkConfigMapSchema, NetworkConfigSchema } from './network_config.js';
 export function isBooleanConfigValue(obj, key) {
     return typeof obj[key] === 'boolean';
 }
+/**
+ * Shared utility function to get a value from environment variables with fallback support.
+ * This can be used by both getConfigFromMappings and CLI utilities.
+ *
+ * @param env - The primary environment variable name
+ * @param fallback - Optional array of fallback environment variable names
+ * @param parseFunc - Optional function to parse the environment variable value
+ * @param defaultValue - Optional default value to use if no environment variable is set
+ * @returns The parsed value from environment variables or the default value
+ */ export function getValueFromEnvWithFallback(env, parseFunc, defaultValue, fallback) {
+    let value;
+    // Try primary env var
+    if (env) {
+        value = process.env[env];
+    }
+    // If primary not found, try fallbacks
+    if (value === undefined && fallback && fallback.length > 0) {
+        for (const fallbackEnv of fallback){
+            const fallbackVal = process.env[fallbackEnv];
+            if (fallbackVal !== undefined) {
+                value = fallbackVal;
+                break;
+            }
+        }
+    }
+    // Parse the value if needed. Empty strings are treated as "not set".
+    if (value !== undefined && value !== '') {
+        return parseFunc ? parseFunc(value) : value;
+    }
+    // Return default if no env var found
+    return defaultValue;
+}
 export function getConfigFromMappings(configMappings) {
     const config = {};
     for(const key in configMappings){
-        const { env, parseEnv, defaultValue: def, nested } = configMappings[key];
-        if (nested) {
-            config[key] = getConfigFromMappings(nested);
-        } else {
-            const val = env ? process.env[env] : undefined;
-            if (val !== undefined) {
-                config[key] = parseEnv ? parseEnv(val) : val;
-            } else if (def !== undefined) {
-                config[key] = def;
+        const { env, parseEnv, defaultValue, fallback, deprecatedFallback } = configMappings[key];
+        try {
+            config[key] = getValueFromEnvWithFallback(env, parseEnv, defaultValue, fallback);
+        } catch (e) {
+            throw new Error(`Failed to parse config '${key}' (env: ${env ?? 'none'}): ${e.message}`);
+        }
+        if (deprecatedFallback?.length) {
+            const userLog = createConsoleLogger('[DEPRECATED]');
+            for (const { env: deprecatedEnv, message } of deprecatedFallback){
+                if (process.env[deprecatedEnv]) {
+                    const warningMessage = message ?? `Environment variable ${deprecatedEnv} is deprecated. Please use ${env} instead.`;
+                    userLog(warningMessage, {
+                        deprecatedEnvVar: deprecatedEnv,
+                        newEnvVar: env
+                    });
+                }
             }
         }
     }
@@ -40,11 +86,47 @@ export function getConfigFromMappings(configMappings) {
  * Generates parseEnv and default values for a numerical config value.
  * @param defaultVal - The default numerical value to use if the environment variable is not set or is invalid
  * @returns Object with parseEnv and default values for a numerical config value
- */ export function bigintConfigHelper(defaultVal) {
+ */ export function floatConfigHelper(defaultVal, validationFn) {
+    return {
+        parseEnv: (val)=>{
+            const parsed = safeParseFloat(val, defaultVal);
+            validationFn?.(parsed);
+            return parsed;
+        },
+        defaultValue: defaultVal
+    };
+}
+/**
+ * Parses an environment variable to a 0-1 percentage value
+ */ export function percentageConfigHelper(defaultVal) {
     return {
         parseEnv: (val)=>{
-            if (val === '') {
-                return defaultVal;
+            const parsed = safeParseFloat(val, defaultVal);
+            if (parsed < 0 || parsed > 1) {
+                throw new TypeError(`Invalid percentage value: ${parsed} should be between 0 and 1`);
+            }
+            return parsed;
+        },
+        defaultValue: defaultVal
+    };
+}
+export function bigintConfigHelper(defaultVal) {
+    return {
+        parseEnv: (val)=>{
+            // Handle scientific notation (e.g. "1e+23", "2E23") which BigInt() doesn't accept directly.
+            // We parse it losslessly using bigint arithmetic instead of going through float64.
+            if (/[eE]/.test(val)) {
+                const match = val.match(/^(-?\d+(?:\.(\d+))?)[eE]([+-]?\d+)$/);
+                if (!match) {
+                    throw new Error(`Cannot convert '${val}' to a BigInt`);
+                }
+                const digits = match[1].replace('.', '');
+                const decimalPlaces = match[2]?.length ?? 0;
+                const exponent = parseInt(match[3], 10) - decimalPlaces;
+                if (exponent < 0) {
+                    throw new Error(`Cannot convert '${val}' to a BigInt: result is not an integer`);
+                }
+                return BigInt(digits) * 10n ** BigInt(exponent);
             }
             return BigInt(val);
         },
@@ -53,17 +135,30 @@ export function getConfigFromMappings(configMappings) {
 }
 /**
  * Generates parseEnv for an optional numerical config value.
+ * Empty strings are already handled by getValueFromEnvWithFallback.
  */ export function optionalNumberConfigHelper() {
     return {
         parseEnv: (val)=>{
-            if (val !== undefined && val.length > 0) {
-                const parsedValue = parseInt(val);
-                return Number.isSafeInteger(parsedValue) ? parsedValue : undefined;
+            const parsedValue = parseInt(val);
+            if (!Number.isSafeInteger(parsedValue)) {
+                throw new Error(`Invalid number: ${val}`);
             }
-            return undefined;
+            return parsedValue;
         }
     };
 }
+export function enumConfigHelper(values, defaultValue) {
+    return {
+        parseEnv: (val)=>{
+            const sanitizedVal = val.trim().toLowerCase();
+            if (values.some((v)=>v.toLowerCase() === sanitizedVal)) {
+                return values.find((v)=>v.toLowerCase() === sanitizedVal);
+            }
+            throw new Error(`Invalid config value '${val}' (must be one of ${values.join(', ')})`);
+        },
+        defaultValue
+    };
+}
 /**
  * Generates parseEnv and default values for a boolean config value.
  * @param defaultVal - The default value to use if the environment variable is not set or is invalid
@@ -77,12 +172,38 @@ export function getConfigFromMappings(configMappings) {
         isBoolean: true
     };
 }
-/** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */ export function parseBooleanEnv(val) {
-    return val !== undefined && [
-        '1',
-        'true',
-        'TRUE'
-    ].includes(val);
+export function secretValueConfigHelper(parse) {
+    const wrap = (val)=>new SecretValue(parse(val));
+    return {
+        parseEnv: wrap,
+        parseVal: wrap,
+        defaultValue: new SecretValue(parse(undefined))
+    };
+}
+export { parseBooleanEnv } from './parse-env.js';
+export function secretStringConfigHelper(defaultValue) {
+    const parse = (val)=>new SecretValue(val);
+    return {
+        parseEnv: parse,
+        parseVal: parse,
+        defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined
+    };
+}
+export function secretFrConfigHelper(defaultValue) {
+    const parse = (val)=>new SecretValue(Fr.fromHexString(val));
+    return {
+        parseEnv: parse,
+        parseVal: parse,
+        defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined
+    };
+}
+export function secretFqConfigHelper(defaultValue) {
+    const parse = (val)=>new SecretValue(Fq.fromHexString(val));
+    return {
+        parseEnv: parse,
+        parseVal: parse,
+        defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined
+    };
 }
 /**
  * Safely parses a number from a string.
@@ -94,6 +215,16 @@ export function getConfigFromMappings(configMappings) {
     const parsedValue = parseInt(value, 10);
     return Number.isSafeInteger(parsedValue) ? parsedValue : defaultValue;
 }
+/**
+ * Safely parses a floating point number from a string.
+ * If the value is not a number, the default value is returned.
+ * @param value - The string value to parse
+ * @param defaultValue - The default value to return
+ * @returns Either parsed value or default value
+ */ function safeParseFloat(value, defaultValue) {
+    const parsedValue = parseFloat(value);
+    return Number.isNaN(parsedValue) ? defaultValue : parsedValue;
+}
 /**
  * Picks specific keys from the given configuration mappings.
  *

package/dest/config/network_config.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const NetworkConfigSchema: z.ZodObject<{
+    bootnodes: z.ZodArray<z.ZodString>;
+    snapshots: z.ZodArray<z.ZodString>;
+    blobFileStoreUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    txCollectionFileStoreUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    registryAddress: z.ZodString;
+    feeAssetHandlerAddress: z.ZodOptional<z.ZodString>;
+    l1ChainId: z.ZodNumber;
+    blockDurationMs: z.ZodOptional<z.ZodNumber>;
+    txPublicSetupAllowListExtend: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export declare const NetworkConfigMapSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    bootnodes: z.ZodArray<z.ZodString>;
+    snapshots: z.ZodArray<z.ZodString>;
+    blobFileStoreUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    txCollectionFileStoreUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    registryAddress: z.ZodString;
+    feeAssetHandlerAddress: z.ZodOptional<z.ZodString>;
+    l1ChainId: z.ZodNumber;
+    blockDurationMs: z.ZodOptional<z.ZodNumber>;
+    txPublicSetupAllowListExtend: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>>;
+export type NetworkConfig = z.infer<typeof NetworkConfigSchema>;
+export type NetworkConfigMap = z.infer<typeof NetworkConfigMapSchema>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmV0d29ya19jb25maWcuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb25maWcvbmV0d29ya19jb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixlQUFPLE1BQU0sbUJBQW1COzs7Ozs7Ozs7OztpQkFhaEIsQ0FBQztBQUVqQixlQUFPLE1BQU0sc0JBQXNCOzs7Ozs7Ozs7OztrQkFBNEMsQ0FBQztBQUVoRixNQUFNLE1BQU0sYUFBYSxHQUFHLENBQUMsQ0FBQyxLQUFLLENBQUMsT0FBTyxtQkFBbUIsQ0FBQyxDQUFDO0FBQ2hFLE1BQU0sTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sc0JBQXNCLENBQUMsQ0FBQyJ9

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,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAahB,CAAC;AAEjB,eAAO,MAAM,sBAAsB;;;;;;;;;;;kBAA4C,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dest/config/network_config.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const NetworkConfigSchema = z.object({
+    bootnodes: z.array(z.string()),
+    snapshots: z.array(z.string()),
+    blobFileStoreUrls: z.array(z.string()).optional(),
+    txCollectionFileStoreUrls: z.array(z.string()).optional(),
+    registryAddress: z.string(),
+    feeAssetHandlerAddress: z.string().optional(),
+    l1ChainId: z.number(),
+    blockDurationMs: z.number().positive().optional(),
+    txPublicSetupAllowListExtend: z.string().optional(),
+    nodeVersion: z.string().optional()
+}).passthrough(); // Allow additional unknown fields to pass through
+export const NetworkConfigMapSchema = z.record(z.string(), NetworkConfigSchema);

package/dest/config/network_name.d.ts

@@ -0,0 +1,3 @@
+export type NetworkNames = 'local' | 'staging' | 'testnet' | 'mainnet' | 'next-net' | 'devnet' | `v${number}-devnet-${number}`;
+export declare function getActiveNetworkName(name?: string): NetworkNames;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmV0d29ya19uYW1lLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL25ldHdvcmtfbmFtZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLE1BQU0sWUFBWSxHQUNwQixPQUFPLEdBQ1AsU0FBUyxHQUNULFNBQVMsR0FDVCxTQUFTLEdBQ1QsVUFBVSxHQUNWLFFBQVEsR0FDUixJQUFJLE1BQU0sV0FBVyxNQUFNLEVBQUUsQ0FBQztBQUVsQyx3QkFBZ0Isb0JBQW9CLENBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxHQUFHLFlBQVksQ0FrQmhFIn0=

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

@@ -0,0 +1 @@
+{"version":3,"file":"network_name.d.ts","sourceRoot":"","sources":["../../src/config/network_name.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,QAAQ,GACR,IAAI,MAAM,WAAW,MAAM,EAAE,CAAC;AAElC,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAkBhE"}

package/dest/config/network_name.js

@@ -0,0 +1,19 @@
+export function getActiveNetworkName(name) {
+    const network = name || process.env.NETWORK;
+    if (!network || network === '' || network === 'local') {
+        return 'local';
+    } else if (network === 'staging') {
+        return network;
+    } else if (network === 'testnet' || network === 'alpha-testnet') {
+        return 'testnet';
+    } else if (network === 'mainnet') {
+        return 'mainnet';
+    } else if (network === 'next-net') {
+        return 'next-net';
+    } else if (network === 'devnet') {
+        return 'devnet';
+    } else if (/^v\d+-devnet-\d+$/.test(network)) {
+        return network;
+    }
+    throw new Error(`Unknown network: ${network}`);
+}

package/dest/config/parse-env.d.ts

@@ -0,0 +1,3 @@
+/** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */
+export declare function parseBooleanEnv(val: string | undefined): boolean;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2UtZW52LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL3BhcnNlLWVudi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxvRkFBb0Y7QUFDcEYsd0JBQWdCLGVBQWUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFNBQVMsR0FBRyxPQUFPLENBRWhFIn0=

package/dest/config/parse-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-env.d.ts","sourceRoot":"","sources":["../../src/config/parse-env.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE"}

package/dest/config/parse-env.js

@@ -0,0 +1,7 @@
+/** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */ export function parseBooleanEnv(val) {
+    return val !== undefined && [
+        '1',
+        'true',
+        'TRUE'
+    ].includes(val);
+}

package/dest/config/secret_value.d.ts

@@ -0,0 +1,28 @@
+import { inspect } from 'util';
+import type { ZodType } from 'zod';
+/**
+ * A class wrapping a secret value to protect it from accidently being leaked in logs
+ */
+export declare class SecretValue<T> {
+    #private;
+    private readonly redactedValue;
+    constructor(value: T, redactedValue?: string);
+    /**
+     * Returns the wrapped value
+     */
+    getValue(): T;
+    /**
+     * Returns a redacted string representation of the value
+     */
+    toString(): string;
+    /**
+     * Returns a redacted string representation of the value
+     */
+    toJSON(): string;
+    [inspect.custom](): string;
+    /**
+     * Returns a Zod schema
+     */
+    static schema<O>(valueSchema: ZodType<O, any>): ZodType<SecretValue<O>, any>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VjcmV0X3ZhbHVlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL3NlY3JldF92YWx1ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBQy9CLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLEtBQUssQ0FBQztBQUVuQzs7R0FFRztBQUNILHFCQUFhLFdBQVcsQ0FBQyxDQUFDOztJQU10QixPQUFPLENBQUMsUUFBUSxDQUFDLGFBQWE7SUFGaEMsWUFDRSxLQUFLLEVBQUUsQ0FBQyxFQUNTLGFBQWEsU0FBZSxFQUc5QztJQUVEOztPQUVHO0lBQ0ksUUFBUSxJQUFJLENBQUMsQ0FFbkI7SUFFRDs7T0FFRztJQUNJLFFBQVEsSUFBSSxNQUFNLENBRXhCO0lBRUQ7O09BRUc7SUFDSSxNQUFNLElBQUksTUFBTSxDQUV0QjtJQUVNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxXQUV0QjtJQUVEOztPQUVHO0lBQ0gsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLEVBQUUsV0FBVyxFQUFFLE9BQU8sQ0FBQyxDQUFDLEVBQUUsR0FBRyxDQUFDLEdBQUcsT0FBTyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FFM0U7Q0FDRiJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"secret_value.d.ts","sourceRoot":"","sources":["../../src/config/secret_value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC;;IAMtB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAFhC,YACE,KAAK,EAAE,CAAC,EACS,aAAa,SAAe,EAG9C;IAED;;OAEG;IACI,QAAQ,IAAI,CAAC,CAEnB;IAED;;OAEG;IACI,QAAQ,IAAI,MAAM,CAExB;IAED;;OAEG;IACI,MAAM,IAAI,MAAM,CAEtB;IAEM,CAAC,OAAO,CAAC,MAAM,CAAC,WAEtB;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAE3E;CACF"}

package/dest/config/secret_value.js

@@ -0,0 +1,36 @@
+var _computedKey;
+import { inspect } from 'util';
+_computedKey = inspect.custom;
+/**
+ * A class wrapping a secret value to protect it from accidently being leaked in logs
+ */ export class SecretValue {
+    redactedValue;
+    /** The secret value. Use a private member field so that it's not visible to the outside */ #value;
+    constructor(value, redactedValue = '[Redacted]'){
+        this.redactedValue = redactedValue;
+        this.#value = value;
+    }
+    /**
+   * Returns the wrapped value
+   */ getValue() {
+        return this.#value;
+    }
+    /**
+   * Returns a redacted string representation of the value
+   */ toString() {
+        return this.redactedValue;
+    }
+    /**
+   * Returns a redacted string representation of the value
+   */ toJSON() {
+        return this.redactedValue;
+    }
+    [_computedKey]() {
+        return this.toString();
+    }
+    /**
+   * Returns a Zod schema
+   */ static schema(valueSchema) {
+        return valueSchema.transform((value)=>new SecretValue(value));
+    }
+}

package/dest/crypto/aes128/index.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { Buffer } from 'buffer';
 /**
  * AES-128-CBC encryption/decryption.
@@ -12,7 +10,7 @@ export declare class Aes128 {
      * @param key - Key to encrypt with.
      * @returns Encrypted data.
      */
-    encryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array): Promise<Buffer>;
+    encryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array): Promise<Buffer<ArrayBuffer>>;
     /**
      * Decrypt a buffer using AES-128-CBC.
      * We keep the padding in the returned buffer.
@@ -28,7 +26,8 @@ export declare class Aes128 {
      * @param iv - AES initialization vector.
      * @param key - Key to decrypt with.
      * @returns Decrypted data.
+     * @throws If the decrypted buffer has invalid PKCS#7 padding.
      */
-    decryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array): Promise<Buffer>;
+    decryptBufferCBC(data: Uint8Array, iv: Uint8Array, key: Uint8Array): Promise<Buffer<ArrayBufferLike>>;
 }
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jcnlwdG8vYWVzMTI4L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFFaEM7O0dBRUc7QUFDSCxxQkFBYSxNQUFNO0lBQ2pCOzs7Ozs7T0FNRztJQUNVLGdCQUFnQixDQUFDLElBQUksRUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxHQUFHLEVBQUUsVUFBVSxnQ0FrQjlFO0lBRUQ7Ozs7Ozs7T0FPRztJQUNVLDJCQUEyQixDQUFDLElBQUksRUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxHQUFHLEVBQUUsVUFBVSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FVM0c7SUFFRDs7Ozs7OztPQU9HO0lBQ1UsZ0JBQWdCLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRSxFQUFFLEVBQUUsVUFBVSxFQUFFLEdBQUcsRUFBRSxVQUFVLG9DQVk5RTtDQUNGIn0=

package/dest/crypto/aes128/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crypto/aes128/index.ts"],"names":[],"mappings":";;AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,qBAAa,MAAM;IACjB;;;;;;OAMG;IACU,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU;IAe/E;;;;;;;OAOG;IACU,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ5G;;;;;;OAMG;IACU,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU;CAKhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crypto/aes128/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;GAEG;AACH,qBAAa,MAAM;IACjB;;;;;;OAMG;IACU,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,gCAkB9E;IAED;;;;;;;OAOG;IACU,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3G;IAED;;;;;;;OAOG;IACU,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,oCAY9E;CACF"}