@aztec/foundation 0.0.0-test.0 → 0.0.1-commit.0208eb9

package/src/config/env_var.ts

@@ -1,7 +1,9 @@
 export type EnvVar =
+  | 'REGISTRY_CONTRACT_ADDRESS'
+  | 'FEE_ASSET_HANDLER_CONTRACT_ADDRESS'
+  | 'SLASH_FACTORY_CONTRACT_ADDRESS'
   | 'ACVM_BINARY_PATH'
   | 'ACVM_WORKING_DIRECTORY'
-  | 'GOVERNANCE_CONTRACT_ADDRESS'
   | 'API_KEY'
   | 'API_PREFIX'
   | 'ARCHIVER_MAX_LOGS'
@@ -9,80 +11,100 @@ export type EnvVar =
   | 'ARCHIVER_URL'
   | 'ARCHIVER_VIEM_POLLING_INTERVAL_MS'
   | 'ARCHIVER_BATCH_SIZE'
-  | 'ASSUME_PROVEN_THROUGH_BLOCK_NUMBER'
+  | 'AZTEC_ADMIN_PORT'
+  | 'AZTEC_NODE_ADMIN_URL'
   | 'AZTEC_NODE_URL'
   | 'AZTEC_PORT'
   | 'BB_BINARY_PATH'
   | 'BB_SKIP_CLEANUP'
   | 'BB_WORKING_DIRECTORY'
+  | 'BB_NUM_IVC_VERIFIERS'
+  | 'BB_IVC_CONCURRENCY'
   | 'BOOTSTRAP_NODES'
-  | 'BLOB_SINK_ARCHIVE_API_URL'
-  | 'BLOB_SINK_PORT'
-  | 'BLOB_SINK_URL'
+  | 'BLOB_ARCHIVE_API_URL'
+  | 'BLOB_FILE_STORE_URLS'
+  | 'BLOB_FILE_STORE_UPLOAD_URL'
+  | 'BLOB_HEALTHCHECK_UPLOAD_INTERVAL_MINUTES'
   | 'BOT_DA_GAS_LIMIT'
   | 'BOT_FEE_PAYMENT_METHOD'
+  | 'BOT_MIN_FEE_PADDING'
   | 'BOT_FLUSH_SETUP_TRANSACTIONS'
   | 'BOT_FOLLOW_CHAIN'
   | 'BOT_L2_GAS_LIMIT'
   | 'BOT_MAX_PENDING_TXS'
   | 'BOT_NO_START'
-  | 'BOT_NO_WAIT_FOR_TRANSFERS'
   | 'BOT_L1_MNEMONIC'
   | 'BOT_L1_PRIVATE_KEY'
+  | 'BOT_L1_TO_L2_TIMEOUT_SECONDS'
   | 'BOT_PRIVATE_KEY'
+  | 'BOT_ACCOUNT_SALT'
   | 'BOT_PRIVATE_TRANSFERS_PER_TX'
   | 'BOT_PUBLIC_TRANSFERS_PER_TX'
-  | 'BOT_PXE_URL'
   | 'BOT_RECIPIENT_ENCRYPTION_SECRET'
-  | 'BOT_SKIP_PUBLIC_SIMULATION'
   | 'BOT_TOKEN_CONTRACT'
   | 'BOT_TOKEN_SALT'
   | 'BOT_TX_INTERVAL_SECONDS'
   | 'BOT_TX_MINED_WAIT_SECONDS'
   | 'BOT_MAX_CONSECUTIVE_ERRORS'
   | 'BOT_STOP_WHEN_UNHEALTHY'
+  | 'BOT_AMM_TXS'
   | 'COINBASE'
+  | 'CRS_PATH'
   | 'DATA_DIRECTORY'
   | 'DATA_STORE_MAP_SIZE_KB'
+  | 'ARCHIVER_STORE_MAP_SIZE_KB'
+  | 'BLOB_SINK_MAP_SIZE_KB'
+  | 'P2P_STORE_MAP_SIZE_KB'
+  | 'PROVER_BROKER_STORE_MAP_SIZE_KB'
+  | 'WS_DB_MAP_SIZE_KB'
+  | 'ARCHIVE_TREE_MAP_SIZE_KB'
+  | 'NULLIFIER_TREE_MAP_SIZE_KB'
+  | 'NOTE_HASH_TREE_MAP_SIZE_KB'
+  | 'MESSAGE_TREE_MAP_SIZE_KB'
+  | 'PUBLIC_DATA_TREE_MAP_SIZE_KB'
   | 'DEBUG'
   | 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY'
-  | 'DEPLOY_AZTEC_CONTRACTS_SALT'
-  | 'DEPLOY_AZTEC_CONTRACTS'
-  | 'ENFORCE_FEES'
   | 'ETHEREUM_HOSTS'
-  | 'FEE_JUICE_CONTRACT_ADDRESS'
-  | 'FEE_JUICE_PORTAL_CONTRACT_ADDRESS'
+  | 'ETHEREUM_DEBUG_HOSTS'
+  | 'ETHEREUM_ALLOW_NO_DEBUG_HOSTS'
   | 'FEE_RECIPIENT'
   | 'FORCE_COLOR'
-  | 'GOVERNANCE_PROPOSER_CONTRACT_ADDRESS'
   | 'GOVERNANCE_PROPOSER_PAYLOAD_ADDRESS'
-  | 'INBOX_CONTRACT_ADDRESS'
+  | 'KEY_STORE_DIRECTORY'
   | 'L1_CHAIN_ID'
-  | 'L1_CONSENSUS_HOST_URL'
-  | 'L1_CONSENSUS_HOST_API_KEY'
-  | 'L1_CONSENSUS_HOST_API_KEY_HEADER'
-  | 'L1_PRIVATE_KEY'
+  | 'L1_CONSENSUS_HOST_URLS'
+  | 'L1_CONSENSUS_HOST_API_KEYS'
+  | 'L1_CONSENSUS_HOST_API_KEY_HEADERS'
   | 'LOG_JSON'
   | 'LOG_MULTILINE'
+  | 'LOG_NO_COLOR_PER_ACTOR'
   | 'LOG_LEVEL'
   | 'MNEMONIC'
-  | 'NETWORK_NAME'
   | 'NETWORK'
+  | 'NETWORK_CONFIG_LOCATION'
   | 'NO_PXE'
-  | 'COIN_ISSUER_CONTRACT_ADDRESS'
   | 'USE_GCLOUD_LOGGING'
   | 'OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'
   | 'OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'
   | 'OTEL_EXPORTER_OTLP_LOGS_ENDPOINT'
   | 'OTEL_COLLECT_INTERVAL_MS'
   | 'OTEL_EXCLUDE_METRICS'
+  | 'OTEL_INCLUDE_METRICS'
   | 'OTEL_EXPORT_TIMEOUT_MS'
-  | 'OUTBOX_CONTRACT_ADDRESS'
+  | 'PUBLIC_OTEL_EXPORTER_OTLP_METRICS_ENDPOINT'
+  | 'PUBLIC_OTEL_INCLUDE_METRICS'
+  | 'PUBLIC_OTEL_COLLECT_FROM'
+  | 'PUBLIC_OTEL_OPT_OUT'
+  | 'P2P_BATCH_TX_REQUESTER_SMART_PARALLEL_WORKER_COUNT'
+  | 'P2P_BATCH_TX_REQUESTER_DUMB_PARALLEL_WORKER_COUNT'
+  | 'P2P_BATCH_TX_REQUESTER_TX_BATCH_SIZE'
+  | 'P2P_BATCH_TX_REQUESTER_BAD_PEER_THRESHOLD'
   | 'P2P_BLOCK_CHECK_INTERVAL_MS'
   | 'P2P_BLOCK_REQUEST_BATCH_SIZE'
   | 'P2P_BOOTSTRAP_NODE_ENR_VERSION_CHECK'
   | 'P2P_BOOTSTRAP_NODES_AS_FULL_PEERS'
   | 'P2P_ENABLED'
+  | 'P2P_DISCOVERY_DISABLED'
   | 'P2P_GOSSIPSUB_D'
   | 'P2P_GOSSIPSUB_DHI'
   | 'P2P_GOSSIPSUB_DLO'
@@ -91,6 +113,7 @@ export type EnvVar =
   | 'P2P_GOSSIPSUB_INTERVAL_MS'
   | 'P2P_GOSSIPSUB_MCACHE_GOSSIP'
   | 'P2P_GOSSIPSUB_MCACHE_LENGTH'
+  | 'P2P_GOSSIPSUB_SEEN_TTL'
   | 'P2P_GOSSIPSUB_TX_INVALID_MESSAGE_DELIVERIES_DECAY'
   | 'P2P_GOSSIPSUB_TX_INVALID_MESSAGE_DELIVERIES_WEIGHT'
   | 'P2P_GOSSIPSUB_TX_TOPIC_WEIGHT'
@@ -100,108 +123,220 @@ export type EnvVar =
   | 'P2P_PEER_PENALTY_VALUES'
   | 'P2P_QUERY_FOR_IP'
   | 'P2P_REQRESP_INDIVIDUAL_REQUEST_TIMEOUT_MS'
+  | 'P2P_REQRESP_DIAL_TIMEOUT_MS'
   | 'P2P_REQRESP_OVERALL_REQUEST_TIMEOUT_MS'
+  | 'P2P_DISABLE_STATUS_HANDSHAKE'
+  | 'P2P_ALLOW_ONLY_VALIDATORS'
+  | 'P2P_MAX_AUTH_FAILED_ATTEMPTS_ALLOWED'
+  | 'P2P_REQRESP_OPTIMISTIC_NEGOTIATION'
   | 'P2P_DOUBLE_SPEND_SEVERE_PEER_PENALTY_WINDOW'
-  | 'P2P_TCP_LISTEN_ADDR'
-  | 'P2P_TCP_ANNOUNCE_ADDR'
-  | 'P2P_TX_POOL_KEEP_PROVEN_FOR'
-  | 'P2P_ATTESTATION_POOL_KEEP_FOR'
-  | 'P2P_UDP_ANNOUNCE_ADDR'
-  | 'P2P_UDP_LISTEN_ADDR'
+  | 'P2P_LISTEN_ADDR'
+  | 'P2P_PORT'
+  | 'P2P_BROADCAST_PORT'
+  | 'P2P_IP'
   | 'P2P_ARCHIVED_TX_LIMIT'
+  | 'P2P_TRUSTED_PEERS'
+  | 'P2P_PRIVATE_PEERS'
+  | 'P2P_PREFERRED_PEERS'
+  | 'P2P_MAX_PENDING_TX_COUNT'
+  | 'P2P_SEEN_MSG_CACHE_SIZE'
+  | 'P2P_DROP_TX'
+  | 'P2P_DROP_TX_CHANCE'
+  | 'P2P_TX_POOL_DELETE_TXS_AFTER_REORG'
+  | 'DEBUG_P2P_INSTRUMENT_MESSAGES'
   | 'PEER_ID_PRIVATE_KEY'
-  | 'PROVER_AGENT_CONCURRENCY'
+  | 'PEER_ID_PRIVATE_KEY_PATH'
   | 'PROVER_AGENT_COUNT'
   | 'PROVER_AGENT_PROOF_TYPES'
   | 'PROVER_AGENT_POLL_INTERVAL_MS'
   | 'PROVER_BROKER_HOST'
-  | 'PROVER_BROKER_ENABLED'
   | 'PROVER_BROKER_JOB_TIMEOUT_MS'
   | 'PROVER_BROKER_POLL_INTERVAL_MS'
   | 'PROVER_BROKER_JOB_MAX_RETRIES'
   | 'PROVER_BROKER_BATCH_INTERVAL_MS'
   | 'PROVER_BROKER_BATCH_SIZE'
   | 'PROVER_BROKER_MAX_EPOCHS_TO_KEEP_RESULTS_FOR'
-  | 'PROVER_COORDINATION_NODE_URL'
+  | 'PROVER_BROKER_DEBUG_REPLAY_ENABLED'
+  | 'PROVER_CANCEL_JOBS_ON_STOP'
+  | 'PROVER_COORDINATION_NODE_URLS'
+  | 'PROVER_PROOF_STORE'
   | 'PROVER_FAILED_PROOF_STORE'
+  | 'PROVER_NODE_FAILED_EPOCH_STORE'
+  | 'PROVER_NODE_DISABLE_PROOF_PUBLISH'
   | 'PROVER_ID'
-  | 'PROVER_JOB_TIMEOUT_MS'
   | 'PROVER_NODE_POLLING_INTERVAL_MS'
   | 'PROVER_NODE_MAX_PENDING_JOBS'
   | 'PROVER_NODE_MAX_PARALLEL_BLOCKS_PER_EPOCH'
-  | 'PROVER_NODE_TX_GATHERING_TIMEOUT_MS'
   | 'PROVER_NODE_TX_GATHERING_INTERVAL_MS'
-  | 'PROVER_NODE_TX_GATHERING_MAX_PARALLEL_REQUESTS'
-  | 'PROVER_PUBLISH_RETRY_INTERVAL_MS'
+  | 'PROVER_NODE_TX_GATHERING_BATCH_SIZE'
+  | 'PROVER_NODE_TX_GATHERING_MAX_PARALLEL_REQUESTS_PER_NODE'
+  | 'PROVER_NODE_TX_GATHERING_TIMEOUT_MS'
   | 'PROVER_PUBLISHER_PRIVATE_KEY'
+  | 'PROVER_PUBLISHER_PRIVATE_KEYS'
+  | 'PROVER_PUBLISHER_ADDRESSES'
+  | 'PROVER_PUBLISHER_ALLOW_INVALID_STATES'
+  | 'PROVER_PUBLISHER_FORWARDER_ADDRESS'
   | 'PROVER_REAL_PROOFS'
   | 'PROVER_TEST_DELAY_FACTOR'
   | 'PROVER_TEST_DELAY_MS'
   | 'PROVER_TEST_DELAY_TYPE'
-  | 'PXE_L2_STARTING_BLOCK'
+  | 'PROVER_TEST_VERIFICATION_DELAY_MS'
+  | 'PXE_L2_BLOCK_BATCH_SIZE'
   | 'PXE_PROVER_ENABLED'
-  | 'REGISTRY_CONTRACT_ADDRESS'
-  | 'ROLLUP_CONTRACT_ADDRESS'
-  | 'SEQ_ALLOWED_SETUP_FN'
+  | 'PXE_SYNC_CHAIN_TIP'
+  | 'RPC_MAX_BATCH_SIZE'
+  | 'RPC_MAX_BODY_SIZE'
+  | 'RPC_SIMULATE_PUBLIC_MAX_GAS_LIMIT'
+  | 'RPC_SIMULATE_PUBLIC_MAX_DEBUG_LOG_MEMORY_READS'
+  | 'SENTINEL_ENABLED'
+  | 'SENTINEL_HISTORY_LENGTH_IN_EPOCHS'
+  | 'SENTINEL_HISTORIC_PROVEN_PERFORMANCE_LENGTH_IN_EPOCHS'
   | 'SEQ_MAX_BLOCK_SIZE_IN_BYTES'
   | 'SEQ_MAX_TX_PER_BLOCK'
   | 'SEQ_MIN_TX_PER_BLOCK'
+  | 'SEQ_PUBLISH_TXS_WITH_PROPOSALS'
   | 'SEQ_MAX_DA_BLOCK_GAS'
   | 'SEQ_MAX_L2_BLOCK_GAS'
-  | 'SEQ_PUBLISH_RETRY_INTERVAL_MS'
   | 'SEQ_PUBLISHER_PRIVATE_KEY'
-  | 'SEQ_TX_POLLING_INTERVAL_MS'
+  | 'SEQ_PUBLISHER_PRIVATE_KEYS'
+  | 'SEQ_PUBLISHER_ADDRESSES'
+  | 'SEQ_PUBLISHER_ALLOW_INVALID_STATES'
+  | 'SEQ_PUBLISHER_FORWARDER_ADDRESS'
+  | 'SEQ_POLLING_INTERVAL_MS'
   | 'SEQ_ENFORCE_TIME_TABLE'
-  | 'SEQ_MAX_L1_TX_INCLUSION_TIME_INTO_SLOT'
-  | 'SLASH_FACTORY_CONTRACT_ADDRESS'
-  | 'STAKING_ASSET_CONTRACT_ADDRESS'
-  | 'REWARD_DISTRIBUTOR_CONTRACT_ADDRESS'
+  | 'SEQ_L1_PUBLISHING_TIME_ALLOWANCE_IN_SLOT'
+  | 'SEQ_ATTESTATION_PROPAGATION_TIME'
+  | 'SEQ_BLOCK_DURATION_MS'
+  | 'SEQ_BUILD_CHECKPOINT_IF_EMPTY'
+  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_COMMITTEE_MEMBER'
+  | 'SEQ_SECONDS_BEFORE_INVALIDATING_BLOCK_AS_NON_COMMITTEE_MEMBER'
+  | 'SLASH_MIN_PENALTY_PERCENTAGE'
+  | 'SLASH_MAX_PENALTY_PERCENTAGE'
+  | 'SLASH_VALIDATORS_ALWAYS'
+  | 'SLASH_VALIDATORS_NEVER'
+  | 'SLASH_PRUNE_PENALTY'
+  | 'SLASH_DATA_WITHHOLDING_PENALTY'
+  | 'SLASH_INACTIVITY_PENALTY'
+  | 'SLASH_INACTIVITY_TARGET_PERCENTAGE'
+  | 'SLASH_INACTIVITY_CONSECUTIVE_EPOCH_THRESHOLD'
+  | 'SLASH_INVALID_BLOCK_PENALTY'
+  | 'SLASH_OVERRIDE_PAYLOAD'
+  | 'SLASH_PROPOSE_INVALID_ATTESTATIONS_PENALTY'
+  | 'SLASH_ATTEST_DESCENDANT_OF_INVALID_PENALTY'
+  | 'SLASH_UNKNOWN_PENALTY'
+  | 'SLASH_GRACE_PERIOD_L2_SLOTS'
+  | 'SLASH_OFFENSE_EXPIRATION_ROUNDS'
+  | 'SLASH_MAX_PAYLOAD_SIZE'
+  | 'SLASH_EXECUTE_ROUNDS_LOOK_BACK'
+  | 'SYNC_MODE'
+  | 'SYNC_SNAPSHOTS_URLS'
+  | 'SYNC_SNAPSHOTS_URL'
   | 'TELEMETRY'
   | 'TEST_ACCOUNTS'
-  | 'TX_GOSSIP_VERSION'
+  | 'SPONSORED_FPC'
+  | 'TX_COLLECTION_FAST_NODES_TIMEOUT_BEFORE_REQ_RESP_MS'
+  | 'TX_COLLECTION_SLOW_NODES_INTERVAL_MS'
+  | 'TX_COLLECTION_SLOW_REQ_RESP_INTERVAL_MS'
+  | 'TX_COLLECTION_SLOW_REQ_RESP_TIMEOUT_MS'
+  | 'TX_COLLECTION_RECONCILE_INTERVAL_MS'
+  | 'TX_COLLECTION_DISABLE_SLOW_DURING_FAST_REQUESTS'
+  | 'TX_COLLECTION_FAST_NODE_INTERVAL_MS'
+  | 'TX_COLLECTION_FAST_MAX_PARALLEL_REQUESTS_PER_NODE'
+  | 'TX_COLLECTION_NODE_RPC_MAX_BATCH_SIZE'
+  | 'TX_COLLECTION_NODE_RPC_URLS'
+  | 'TX_COLLECTION_PROPOSAL_TX_COLLECTOR_TYPE'
+  | 'TX_FILE_STORE_URL'
+  | 'TX_FILE_STORE_DOWNLOAD_URL'
+  | 'TX_FILE_STORE_UPLOAD_CONCURRENCY'
+  | 'TX_FILE_STORE_MAX_QUEUE_SIZE'
+  | 'TX_FILE_STORE_ENABLED'
+  | 'TX_PUBLIC_SETUP_ALLOWLIST'
   | 'TXE_PORT'
+  | 'TRANSACTIONS_DISABLED'
   | 'VALIDATOR_ATTESTATIONS_POLLING_INTERVAL_MS'
   | 'VALIDATOR_DISABLED'
+  | 'VALIDATOR_PRIVATE_KEYS'
   | 'VALIDATOR_PRIVATE_KEY'
   | 'VALIDATOR_REEXECUTE'
-  | 'VERSION'
+  | 'VALIDATOR_ADDRESSES'
+  | 'ROLLUP_VERSION'
   | 'WS_BLOCK_CHECK_INTERVAL_MS'
-  | 'WS_PROVEN_BLOCKS_ONLY'
   | 'WS_BLOCK_REQUEST_BATCH_SIZE'
-  | 'VERIFIER_VIEM_POLLING_INTERVAL_MS'
   | 'L1_READER_VIEM_POLLING_INTERVAL_MS'
-  | 'PROVER_VIEM_POLLING_INTERVAL_MS'
-  | 'SEQ_VIEM_POLLING_INTERVAL_MS'
-  | 'WS_DB_MAP_SIZE_KB'
   | 'WS_DATA_DIRECTORY'
   | 'WS_NUM_HISTORIC_BLOCKS'
   | 'ETHEREUM_SLOT_DURATION'
   | 'AZTEC_SLOT_DURATION'
   | 'AZTEC_EPOCH_DURATION'
   | 'AZTEC_TARGET_COMMITTEE_SIZE'
-  | 'AZTEC_PROOF_SUBMISSION_WINDOW'
-  | 'AZTEC_MINIMUM_STAKE'
+  | 'AZTEC_LAG_IN_EPOCHS_FOR_VALIDATOR_SET'
+  | 'AZTEC_LAG_IN_EPOCHS_FOR_RANDAO'
+  | 'AZTEC_INBOX_LAG'
+  | 'AZTEC_PROOF_SUBMISSION_EPOCHS'
+  | 'AZTEC_ACTIVATION_THRESHOLD'
+  | 'AZTEC_EJECTION_THRESHOLD'
+  | 'AZTEC_LOCAL_EJECTION_THRESHOLD'
+  | 'AZTEC_MANA_TARGET'
+  | 'AZTEC_PROVING_COST_PER_MANA'
+  | 'AZTEC_INITIAL_ETH_PER_FEE_ASSET'
   | 'AZTEC_SLASHING_QUORUM'
-  | 'AZTEC_SLASHING_ROUND_SIZE'
+  | 'AZTEC_SLASHING_ROUND_SIZE_IN_EPOCHS'
+  | 'AZTEC_SLASHING_LIFETIME_IN_ROUNDS'
+  | 'AZTEC_SLASHING_EXECUTION_DELAY_IN_ROUNDS'
+  | 'AZTEC_SLASHING_VETOER'
+  | 'AZTEC_SLASHING_OFFSET_IN_ROUNDS'
+  | 'AZTEC_SLASHING_DISABLE_DURATION'
+  | 'AZTEC_SLASH_AMOUNT_SMALL'
+  | 'AZTEC_SLASH_AMOUNT_MEDIUM'
+  | 'AZTEC_SLASH_AMOUNT_LARGE'
+  | 'AZTEC_SLASHER_FLAVOR'
   | 'AZTEC_GOVERNANCE_PROPOSER_QUORUM'
   | 'AZTEC_GOVERNANCE_PROPOSER_ROUND_SIZE'
+  | 'AZTEC_GOVERNANCE_VOTING_DURATION'
+  | 'AZTEC_EXIT_DELAY_SECONDS'
   | 'L1_GAS_LIMIT_BUFFER_PERCENTAGE'
-  | 'L1_GAS_PRICE_MIN'
   | 'L1_GAS_PRICE_MAX'
+  | 'L1_FEE_PER_GAS_GWEI_MAX'
   | 'L1_BLOB_FEE_PER_GAS_MAX'
+  | 'L1_BLOB_FEE_PER_GAS_GWEI_MAX'
   | 'L1_PRIORITY_FEE_BUMP_PERCENTAGE'
   | 'L1_PRIORITY_FEE_RETRY_BUMP_PERCENTAGE'
+  | 'L1_MINIMUM_PRIORITY_FEE_PER_GAS_GWEI'
   | 'L1_FIXED_PRIORITY_FEE_PER_GAS'
+  | 'L1_FIXED_PRIORITY_FEE_PER_GAS_GWEI'
   | 'L1_TX_MONITOR_MAX_ATTEMPTS'
   | 'L1_TX_MONITOR_CHECK_INTERVAL_MS'
   | 'L1_TX_MONITOR_STALL_TIME_MS'
   | 'L1_TX_MONITOR_TX_TIMEOUT_MS'
-  | 'L1_TX_PROPAGATION_MAX_QUERY_ATTEMPTS'
-  | 'FAUCET_MNEMONIC_ACCOUNT_INDEX'
+  | 'L1_TX_MONITOR_CANCEL_TX_ON_TIMEOUT'
+  | 'L1_TX_MONITOR_TX_CANCELLATION_TIMEOUT_MS'
+  | 'L1_TX_MONITOR_TX_UNSEEN_CONSIDERED_DROPPED_MS'
+  | 'FAUCET_MNEMONIC_ADDRESS_INDEX'
   | 'FAUCET_ETH_AMOUNT'
   | 'FAUCET_INTERVAL_MS'
   | 'FAUCET_L1_ASSETS'
   | 'K8S_POD_NAME'
   | 'K8S_POD_UID'
   | 'K8S_NAMESPACE_NAME'
-  | 'CUSTOM_FORWARDER_CONTRACT_ADDRESS';
+  | 'VALIDATOR_REEXECUTE_DEADLINE_MS'
+  | 'AUTO_UPDATE'
+  | 'AUTO_UPDATE_URL'
+  | 'WEB3_SIGNER_URL'
+  | 'SKIP_ARCHIVER_INITIAL_SYNC'
+  | 'BLOB_ALLOW_EMPTY_SOURCES'
+  | 'FISHERMAN_MODE'
+  | 'MAX_ALLOWED_ETH_CLIENT_DRIFT_SECONDS'
+  | 'LEGACY_BLS_CLI'
+  | 'DEBUG_FORCE_TX_PROOF_VERIFICATION'
+  | 'VALIDATOR_HA_SIGNING_ENABLED'
+  | 'VALIDATOR_HA_NODE_ID'
+  | 'VALIDATOR_HA_POLLING_INTERVAL_MS'
+  | 'VALIDATOR_HA_SIGNING_TIMEOUT_MS'
+  | 'VALIDATOR_HA_MAX_STUCK_DUTIES_AGE_MS'
+  | 'VALIDATOR_HA_OLD_DUTIES_MAX_AGE_H'
+  | 'VALIDATOR_HA_DATABASE_URL'
+  | 'VALIDATOR_HA_RUN_MIGRATIONS'
+  | 'VALIDATOR_HA_POOL_MAX'
+  | 'VALIDATOR_HA_POOL_MIN'
+  | 'VALIDATOR_HA_POOL_IDLE_TIMEOUT_MS'
+  | 'VALIDATOR_HA_POOL_CONNECTION_TIMEOUT_MS';

package/src/config/index.ts

@@ -1,6 +1,14 @@
+import { Fq, Fr } from '../curves/bn254/field.js';
+import { createConsoleLogger } from '../log/console.js';
 import type { EnvVar } from './env_var.js';
+import { type NetworkNames, getActiveNetworkName } from './network_name.js';
+import { parseBooleanEnv } from './parse-env.js';
+import { SecretValue } from './secret_value.js';
 
-export { type EnvVar } from './env_var.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 {
   env?: EnvVar;
@@ -10,6 +18,12 @@ export interface ConfigMapping {
   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 function isBooleanConfigValue<T>(obj: T, key: keyof T): boolean {
@@ -18,19 +32,70 @@ export function isBooleanConfigValue<T>(obj: T, key: keyof T): boolean {
 
 export type ConfigMappingsType<T> = Record<keyof T, ConfigMapping>;
 
+/**
+ * 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<T>(
+  env: EnvVar | undefined,
+  parseFunc: ((val: string) => T) | undefined,
+  defaultValue: T | undefined,
+  fallback?: EnvVar[],
+): T | undefined {
+  let value: string | undefined;
+
+  // 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
+  if (value !== undefined) {
+    return parseFunc ? parseFunc(value) : (value as unknown as T);
+  }
+
+  // Return default if no env var found
+  return defaultValue;
+}
+
 export function getConfigFromMappings<T>(configMappings: ConfigMappingsType<T>): T {
   const config = {} as T;
 
   for (const key in configMappings) {
-    const { env, parseEnv, defaultValue: def, nested } = configMappings[key];
+    const { env, parseEnv, defaultValue, nested, fallback, deprecatedFallback } = configMappings[key];
     if (nested) {
       (config as any)[key] = getConfigFromMappings(nested);
     } else {
-      const val = env ? process.env[env] : undefined;
-      if (val !== undefined) {
-        (config as any)[key] = parseEnv ? parseEnv(val) : val;
-      } else if (def !== undefined) {
-        (config as any)[key] = def;
+      // Use the shared utility function
+      (config as any)[key] = getValueFromEnvWithFallback(env, parseEnv, defaultValue, fallback);
+
+      // Check for deprecated env vars and warn if logger is set
+      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 });
+          }
+        }
       }
     }
   }
@@ -65,6 +130,42 @@ export function numberConfigHelper(defaultVal: number): Pick<ConfigMapping, 'par
   };
 }
 
+/**
+ * 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 floatConfigHelper(
+  defaultVal: number,
+  validationFn?: (val: number) => void,
+): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
+  return {
+    parseEnv: (val: string): number => {
+      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: number): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
+  return {
+    parseEnv: (val: string): number => {
+      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,
+  };
+}
+
 /**
  * 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
@@ -97,6 +198,26 @@ export function optionalNumberConfigHelper(): Pick<ConfigMapping, 'parseEnv'> {
   };
 }
 
+/** Generates parseEnv for an enum-like config value. */
+export function enumConfigHelper<T extends string>(
+  values: T[],
+  defaultValue?: NoInfer<T>,
+): Pick<ConfigMapping, 'parseEnv' | 'defaultValue'> {
+  return {
+    parseEnv: (val: string) => {
+      const sanitizedVal = (val ?? '').trim().toLowerCase();
+      if (values.includes(sanitizedVal as T)) {
+        return sanitizedVal as T;
+      }
+      if (!val && defaultValue) {
+        return defaultValue;
+      }
+      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
@@ -114,9 +235,92 @@ export function booleanConfigHelper(
   };
 }
 
-/** Parses an env var as boolean. Returns true only if value is 1, true, or TRUE. */
-export function parseBooleanEnv(val: string | undefined): boolean {
-  return val !== undefined && ['1', 'true', 'TRUE'].includes(val);
+export function secretValueConfigHelper<T>(parse: (val: string | undefined) => T): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<T>;
+  }
+> {
+  const wrap = (val: string) => new SecretValue(parse(val));
+  return {
+    parseEnv: wrap,
+    parseVal: wrap,
+    defaultValue: new SecretValue(parse(undefined)),
+    isBoolean: true,
+  };
+}
+
+export { parseBooleanEnv } from './parse-env.js';
+
+export function secretStringConfigHelper(): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<string | undefined>;
+  }
+>;
+export function secretStringConfigHelper(defaultValue: string): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<string>;
+  }
+>;
+export function secretStringConfigHelper(defaultValue?: string): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<string | typeof defaultValue>;
+  }
+> {
+  const parse = (val: string) => new SecretValue(val);
+  return {
+    parseEnv: parse,
+    parseVal: parse,
+    defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined,
+    isBoolean: true,
+  };
+}
+
+export function secretFrConfigHelper(): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fr | undefined>;
+  }
+>;
+export function secretFrConfigHelper(defaultValue: Fr): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fr>;
+  }
+>;
+export function secretFrConfigHelper(defaultValue?: Fr): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fr | typeof defaultValue>;
+  }
+> {
+  const parse = (val: string) => new SecretValue(Fr.fromHexString(val));
+  return {
+    parseEnv: parse,
+    parseVal: parse,
+    defaultValue: defaultValue !== undefined ? new SecretValue(defaultValue) : undefined,
+    isBoolean: true,
+  };
+}
+
+export function secretFqConfigHelper(defaultValue: Fq): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fq>;
+  }
+>;
+export function secretFqConfigHelper(): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fq | undefined>;
+  }
+>;
+export function secretFqConfigHelper(defaultValue?: Fq): Required<
+  Pick<ConfigMapping, 'parseEnv' | 'defaultValue' | 'isBoolean'> & {
+    parseVal: (val: string) => SecretValue<Fq | typeof defaultValue>;
+  }
+> {
+  const parse = (val: string) => new SecretValue(Fq.fromHexString(val));
+  return {
+    parseEnv: parse,
+    parseVal: parse,
+    defaultValue: typeof defaultValue !== 'undefined' ? new SecretValue(defaultValue) : undefined,
+    isBoolean: true,
+  };
 }
 
 /**
@@ -131,6 +335,18 @@ function safeParseNumber(value: string, defaultValue: number): number {
   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: string, defaultValue: number): number {
+  const parsedValue = parseFloat(value);
+  return Number.isNaN(parsedValue) ? defaultValue : parsedValue;
+}
+
 /**
  * Picks specific keys from the given configuration mappings.
  *