Overview

This section documents all configuration options for NCN Network v2 components.

---

Configuration Methods

NCN Network components can be configured through:

1. Environment Variables - Primary method

2. Configuration Files - For complex settings (e.g., .env files)

3. Command Line Arguments - For runtime overrides

Priority Order

Command Line Args > Environment Variables > Config Files > Defaults

---

Configuration Guides

Gateway Configuration

Complete gateway configuration:

• Wallet settings

• Network addresses

• Blockchain configuration

• Payment settings

Compute Node Configuration

Compute node configuration:

• Sandbox settings

• Resource limits

• Model paths

• Execution settings

Registry Configuration

P2P Registry configuration:

• P2P network settings

• Validator settings

• Storage settings

Environment Variables Reference

Complete reference of all environment variables across all components.

Network Configuration

Network-specific configurations:

• Local development

• Forknet testnet

• Sepolia testnet

• Mainnet

---

Quick Reference

Gateway Node

# Required
GATEWAY_WALLET_PRIVATE_KEY=0x...
RPC_URL=http://127.0.0.1:8545
CONTRACT_ADDRESS=0x4361...
REGISTRY_GRPC_ADDR=http://127.0.0.1:50050

# Optional
GRPC_ADDR=127.0.0.1:50051
HTTP_ADDR=127.0.0.1:8080
WS_ADDR=127.0.0.1:9000
SUBNET_ID=1

Compute Node

# Command line
--gateway-addr http://127.0.0.1:50051
--model-path ./models

# Environment
COMPUTE_NODE_PRIVATE_KEY=0x...
SANDBOX_MODE=strict
EXECUTION_TIMEOUT_SECS=300
MAX_MEMORY_MB=4096

P2P Registry

# Command line
--p2p-listen-addr /ip4/0.0.0.0/tcp/8828
--grpc-listen-addr 127.0.0.1:50050

# Environment
VALIDATOR_PRIVATE_KEY=0x...
VALIDATOR_SYNC_ENABLED=true

---

Network Configurations

Local Development

# Gateway
RPC_URL=http://127.0.0.1:8545
NETWORK=local
REGISTRY_GRPC_ADDR=http://127.0.0.1:50050

# Features disabled for development
REQUIRE_PAYMENT=false
SANDBOX_MODE=disabled

Forknet Testnet

# Gateway
RPC_URL=https://forknet-rpc.neuralgpu.online
NETWORK=forknet
CONTRACT_ADDRESS=0x4361115359E5C0a25c9b2f8Bb71184F010b768ea

# Compute
SANDBOX_MODE=strict
REQUIRE_PAYMENT=true

Production (Mainnet)

# Gateway
RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
NETWORK=mainnet
CONTRACT_ADDRESS=0x...

# Security
SANDBOX_MODE=strict
REQUIRE_PAYMENT=true
REQUIRED_CONFIRMATIONS=12

---

Configuration Files

Gateway .env File

Location: gateway_node/.env

# ============================================================================
# REQUIRED: Wallet Configuration
# ============================================================================
GATEWAY_WALLET_PRIVATE_KEY=0x...
GATEWAY_WALLET_ADDRESS=0x...

# ============================================================================
# Blockchain Configuration
# ============================================================================
CONTRACT_ADDRESS=0x4361115359E5C0a25c9b2f8Bb71184F010b768ea
RPC_URL=http://127.0.0.1:8545
NETWORK=forknet

# ============================================================================
# Network Configuration
# ============================================================================
SUBNET_ID=1
GRPC_ADDR=127.0.0.1:50051
HTTP_ADDR=127.0.0.1:8080
WS_ADDR=127.0.0.1:9000
REGISTRY_GRPC_ADDR=http://127.0.0.1:50050

# ============================================================================
# Transaction Configuration
# ============================================================================
GAS_LIMIT=500000
GAS_PRICE_MULTIPLIER=1.1
REQUIRED_CONFIRMATIONS=1

Subnet Configuration

Location: Custom (used with subnet-cli)

{
  "gateway_address": "0x...",
  "models": [
    {
      "name": "bark_semantic",
      "download_url": "https://huggingface.co/suno/bark/...",
      "executor_script": "...",
      "file_size_bytes": 2000000000
    }
  ]
}

---

Security Recommendations

Private Keys

# DON'T commit .env files with real keys
# .gitignore should include:
.env
*.env.local
*.env.production

# DO use environment variables or secrets management
export GATEWAY_WALLET_PRIVATE_KEY="$SECRET_FROM_VAULT"

Network Exposure

# Development (bind to localhost)
GRPC_ADDR=127.0.0.1:50051
HTTP_ADDR=127.0.0.1:8080

# Production (bind to all interfaces behind firewall)
GRPC_ADDR=0.0.0.0:50051
HTTP_ADDR=0.0.0.0:8080

Sandbox Mode

# Development only
SANDBOX_MODE=disabled

# Testing
SANDBOX_MODE=permissive

# Production (always)
SANDBOX_MODE=strict

---

Validation

Check Configuration

# Gateway: verify wallet loads
cargo run --bin gateway_node -- --dry-run

# Compute: verify sandbox
cargo run --bin compute_node -- --check-sandbox

# Subnet CLI: validate config
subnet-cli validate -c my_subnet.json

Required vs Optional

Component	Required	Recommended	Optional
Gateway	Wallet, RPC, Contract, Registry	TLS, Metrics	Debug settings
Compute	Gateway addr	Wallet, Sandbox	Fallback
Registry	Listen addresses	Validator key	Sync settings

---

Next Steps

• Gateway Configuration - Full gateway options

• Compute Configuration - Compute node options

• Environment Variables - Complete reference