> For the complete documentation index, see [llms.txt](https://docs.neurochain.ai/nc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neurochain.ai/nc/neurochainai-guides/configuration/environment-vars.md). # Environment Variables Complete reference of all environment variables across NCN Network v2 components. *** ## Gateway Node ### Required | Variable | Description | Example | | ---------------------------- | --------------------------------- | ------------------------ | | `GATEWAY_WALLET_PRIVATE_KEY` | Gateway wallet private key | `0xabcd...` | | `RPC_URL` | Blockchain RPC endpoint | `http://127.0.0.1:8545` | | `CONTRACT_ADDRESS` | InferencePayment contract address | `0x4361...` | | `REGISTRY_GRPC_ADDR` | P2P Registry gRPC address | `http://127.0.0.1:50050` | ### Optional | Variable | Default | Description | | ----------------------------- | ----------------- | --------------------------------- | | `GATEWAY_WALLET_ADDRESS` | Derived | Wallet address (derived from key) | | `GRPC_ADDR` | `127.0.0.1:50051` | gRPC listen address | | `HTTP_ADDR` | `127.0.0.1:8080` | HTTP listen address | | `WS_ADDR` | `127.0.0.1:9000` | WebSocket listen address | | `SUBNET_ID` | `1` | Gateway's subnet ID | | `NETWORK` | `forknet` | Network name | | `GAS_LIMIT` | `500000` | Default gas limit | | `GAS_PRICE_MULTIPLIER` | `1.1` | Gas price multiplier | | `REQUIRED_CONFIRMATIONS` | `1` | Required tx confirmations | | `CONFIRMATION_TIMEOUT_SECS` | `300` | Confirmation timeout | | `ENABLE_PAYMENT_VERIFICATION` | `true` | Enable payment verification | | `REQUIRE_PAYMENT` | `false` | Require payment for requests | *** ## Compute Node ### Required | Variable | Description | Example | | -------------- | ---------------------------- | ------------------------ | | `GATEWAY_ADDR` | Gateway address (or CLI arg) | `http://127.0.0.1:50051` | ### Optional | Variable | Default | Description | | --------------------------- | ------------------ | ------------------------------------------------ | | `COMPUTE_NODE_PRIVATE_KEY` | Auto-generated | Node wallet private key | | `NODE_WALLET_ADDRESS` | Derived | Node wallet address | | `MODEL_PATH` | `./models` | Model files directory | | `SANDBOX_MODE` | `strict` | Sandbox mode: `strict`, `permissive`, `disabled` | | `EXECUTION_TIMEOUT_SECS` | `300` | Max execution time (seconds) | | `MAX_MEMORY_MB` | `4096` | Max memory per execution (MB) | | `MAX_CPU_CORES` | All | Max CPU cores per execution | | `ENABLE_EXECUTION_FALLBACK` | `false` | Enable fallback execution | | `REQUIRE_PAYMENT` | `false` | Require payment validation | | `PYTHON_EXECUTOR_PATH` | `python_executors` | Path to Python executors | | `PYTHON_PATH` | `python3` | Python interpreter path | | `PYTHON_VENV_PATH` | None | Python virtual environment | ### Sandbox-specific | Variable | Default | Description | | ----------------------- | ------- | ------------------------ | | `SANDBOX_ALLOW_NETWORK` | `false` | Allow network in sandbox | | `SANDBOX_ALLOWED_PATHS` | `/tmp` | Additional allowed paths | | `SANDBOX_MAX_PROCESSES` | `10` | Max processes in sandbox | | `SANDBOX_MAX_FDS` | `1024` | Max file descriptors | *** ## P2P Registry Node ### Required | Variable | Description | Example | | -------- | ----------------- | ------- | | None | All have defaults | - | ### Optional | Variable | Default | Description | | ------------------------------ | ----------------------- | ----------------------------- | | `P2P_LISTEN_ADDR` | `/ip4/0.0.0.0/tcp/8828` | P2P listen address | | `GRPC_LISTEN_ADDR` | `127.0.0.1:50050` | gRPC listen address | | `VALIDATOR_PRIVATE_KEY` | Auto-generated | Validator signing key | | `VALIDATOR_SYNC_ENABLED` | `true` | Enable blockchain sync | | `VALIDATOR_SYNC_INTERVAL` | `60` | Sync interval (seconds) | | `VALIDATOR_SYNC_ACTIVE_ONLY` | `false` | Sync only active validators | | `VALIDATOR_REGISTRY_CONTRACT` | None | On-chain validator registry | | `FORKNET_RPC_URL` | None | Blockchain RPC URL | | `CHAIN_ID` | `828` | Blockchain chain ID | | `MIN_VALIDATORS_FOR_CONSENSUS` | `3` | Minimum validators for M-of-N | | `MAX_VALIDATORS_TO_SELECT` | `5` | Maximum validators to select | | `MIN_REPUTATION_THRESHOLD` | `20` | Minimum validator reputation | *** ## Test Client ### Required | Variable | Description | Example | | -------- | ------------------------ | ------- | | None | All configurable via CLI | - | ### Optional | Variable | Default | Description | | -------------------- | ------------------------ | ------------------------- | | `GATEWAY_ADDR` | `http://127.0.0.1:50051` | Gateway gRPC address | | `CLIENT_PRIVATE_KEY` | None | Client wallet private key | | `NETWORK` | `local` | Network name | *** ## Smart Contracts (Foundry) ### Deployment | Variable | Description | Example | | ------------------- | -------------------- | ----------------------- | | `PRIVATE_KEY` | Deployer private key | `0xabcd...` | | `RPC_URL` | RPC endpoint | `http://127.0.0.1:8545` | | `ETHERSCAN_API_KEY` | For verification | `ABC123...` | *** ## Logging ### All Components | Variable | Default | Description | | ---------------- | ------- | ------------------------------------------------------ | | `RUST_LOG` | `info` | Log level filter | | `RUST_BACKTRACE` | `0` | Enable backtraces (`1` for basic, `full` for detailed) | ### Log Level Examples ```bash # Basic info export RUST_LOG=info # Debug all export RUST_LOG=debug # Debug specific component export RUST_LOG=gateway_node=debug,compute_node=info # Trace specific module export RUST_LOG=gateway_node::payment=trace # Multiple filters export RUST_LOG=info,gateway_node=debug,libp2p=warn ``` *** ## Docker Environment ### Docker Compose Variables Create `.env` file in project root: ```bash # Blockchain RPC_URL=http://localhost:8545 CONTRACT_ADDRESS=0x4361115359E5C0a25c9b2f8Bb71184F010b768ea CHAIN_ID=828 # Gateway GATEWAY_PRIVATE_KEY=0x... GATEWAY_WALLET_ADDRESS=0x... # Compute COMPUTE_PRIVATE_KEY=0x... SANDBOX_MODE=disabled # Registry VALIDATOR_PRIVATE_KEY=0x... VALIDATOR_SYNC_ENABLED=true # General RUST_LOG=info ``` *** ## Security Notes ### Sensitive Variables **NEVER commit these to version control:** * `*_PRIVATE_KEY` * `*_SECRET` * API keys ### Best Practices ```bash # Use environment variables export GATEWAY_WALLET_PRIVATE_KEY="$SECRET_FROM_VAULT" # Or use .env file (add to .gitignore) echo ".env" >> .gitignore # Use secrets manager in production # (AWS Secrets Manager, HashiCorp Vault, etc.) ``` *** ## Quick Setup Templates ### Development ```bash # Development mode - no payment, no sandbox export RUST_LOG=debug export REQUIRE_PAYMENT=false export SANDBOX_MODE=disabled export ENABLE_EXECUTION_FALLBACK=true ``` ### Testing ```bash # Testing mode - permissive sandbox export RUST_LOG=info export REQUIRE_PAYMENT=false export SANDBOX_MODE=permissive export ENABLE_EXECUTION_FALLBACK=true ``` ### Production ```bash # Production mode - strict security export RUST_LOG=info export REQUIRE_PAYMENT=true export SANDBOX_MODE=strict export ENABLE_EXECUTION_FALLBACK=false export REQUIRED_CONFIRMATIONS=12 ``` *** ## Variable Priority Configuration priority (highest to lowest): 1. Command line arguments 2. Environment variables 3. `.env` file 4. Default values ```bash # CLI overrides environment variable export GRPC_ADDR=127.0.0.1:50051 cargo run --bin gateway_node -- --grpc-addr 0.0.0.0:50051 # Uses 0.0.0.0:50051 ```