env.example

# Dexalot SDK Configuration
# Copy this file to .env and adjust values as needed.

# --- Connection Settings ---
# Environment configuration (e.g., fuji-multi, production-multi)
# Default: fuji-multi
PARENTENV=fuji-multi

# Wallet Private Key (optional — only needed for signing transactions)
PRIVATE_KEY=your_private_key_here_starting_with_0x

# Optional: Override API URLs (Auto-detected based on PARENTENV usually)
# API_BASE_URL_MAINNET=https://api.dexalot.com
# API_BASE_URL_TESTNET=https://api.dexalot-test.com

# Connection Pool Settings
# Total connection pool size across all hosts
# Default: 100
DEXALOT_CONNECTION_POOL_LIMIT=100

# Maximum connections per individual host
# Default: 30
DEXALOT_CONNECTION_POOL_LIMIT_PER_HOST=30

# --- Logging Settings ---
# Logging Level: debug, info, warn, error
# Default: info
DEXALOT_LOG_LEVEL=info

# Logging Format: console, json
# Default: console
DEXALOT_LOG_FORMAT=console

# --- Cache Settings ---
# Enable/Disable all caching
# Default: true
DEXALOT_ENABLE_CACHE=true

# Cache Time-To-Live (TTL) in seconds
DEXALOT_CACHE_TTL_STATIC=3600       # Environments, Deployments (Default: 1h)
DEXALOT_CACHE_TTL_SEMI_STATIC=900   # Tokens, Pairs (Default: 15m)
DEXALOT_CACHE_TTL_BALANCE=10        # Portfolio/Wallet Balances (Default: 10s)
DEXALOT_CACHE_TTL_ORDERBOOK=1       # Orderbook Snapshots (Default: 1s)

# --- Retry Settings ---
# Enable/Disable automatic retry with exponential backoff
# Default: true
DEXALOT_RETRY_ENABLED=true

# Maximum number of retry attempts (including initial attempt)
# Default: 3
DEXALOT_RETRY_MAX_ATTEMPTS=3

# Initial delay in seconds before first retry
# Default: 1.0
DEXALOT_RETRY_INITIAL_DELAY=1.0

# Maximum delay in seconds between retries (caps exponential backoff)
# Default: 10.0
DEXALOT_RETRY_MAX_DELAY=10.0

# Exponential backoff multiplier for HTTP retries
# Default: 2.0
DEXALOT_RETRY_EXPONENTIAL_BASE=2.0

# --- HTTP client timeouts (REST API) ---
# Connect and read timeouts in seconds (axios uses read timeout as the request cap).
# Default: 5 / 30
# DEXALOT_TIMEOUT_CONNECT=5
# DEXALOT_TIMEOUT_READ=30

# --- Rate Limiting Settings ---
# Enable/Disable rate limiting for API and RPC calls
# Default: true
DEXALOT_RATE_LIMIT_ENABLED=true

# Maximum API requests per second
# Default: 5.0
DEXALOT_RATE_LIMIT_REQUESTS_PER_SECOND=5.0

# Maximum RPC calls per second
# Default: 10.0
DEXALOT_RATE_LIMIT_RPC_PER_SECOND=10.0

# --- WebSocket Settings ---
# Enable/Disable WebSocket Manager (persistent connections)
# Required for subscribe_to_events(); when false, subscription calls raise RuntimeError
# Default: false (disabled by default)
DEXALOT_WS_MANAGER_ENABLED=false

# Ping interval in seconds (heartbeat)
# Default: 30
DEXALOT_WS_PING_INTERVAL=30

# Ping timeout in seconds (wait for pong before reconnecting)
# Default: 10
DEXALOT_WS_PING_TIMEOUT=10

# Initial reconnect delay in seconds
# Default: 1.0
DEXALOT_WS_RECONNECT_INITIAL_DELAY=1.0

# Maximum reconnect delay in seconds (caps exponential backoff)
# Default: 60.0
DEXALOT_WS_RECONNECT_MAX_DELAY=60.0

# Exponential backoff multiplier for reconnection delays
# Default: 2.0
DEXALOT_WS_RECONNECT_EXPONENTIAL_BASE=2.0

# Maximum reconnection attempts (0 = infinite)
# Default: 10
DEXALOT_WS_RECONNECT_MAX_ATTEMPTS=10

# Clock skew compensation for private-topic signatures (milliseconds).
# Added to local timestamp when server clock differs. Use a negative value if local clock is ahead.
# Backend accepts timestamps within ±30 000 ms of server time. Default: 0
# DEXALOT_WS_TIME_OFFSET_MS=0

# --- Provider Failover Settings ---
# Enable/Disable RPC provider failover (automatic failover to backup providers)
# Default: true
DEXALOT_PROVIDER_FAILOVER_ENABLED=true

# Cooldown period in seconds before retrying a failed provider
# Default: 60
DEXALOT_PROVIDER_FAILOVER_COOLDOWN=60

# Maximum number of failures before marking a provider as unhealthy
# Default: 3
DEXALOT_PROVIDER_FAILOVER_MAX_FAILURES=3

# --- Nonce Manager Settings ---
# Enable/Disable per-(chain_id, address) nonce serialization for write operations
# Default: true
# DEXALOT_NONCE_MANAGER_ENABLED=true

# --- ERC20 Balance Concurrency ---
# Maximum number of concurrent balanceOf RPC calls when fetching wallet ERC20 balances.
# Increase to speed up balance fetches for chains with many tokens; decrease to reduce RPC load.
# Default: 10
# DEXALOT_ERC20_BALANCE_CONCURRENCY=10

# --- RPC Security Settings ---
# Allow plain http:// RPC endpoints. By default http:// URLs are rejected at provider setup time
# with an error. Set to true only for local development or trusted private networks.
# Default: false
# DEXALOT_ALLOW_INSECURE_RPC=false

# --- Auth Settings ---
# Enable timestamped auth signatures to prevent replay attacks.
# When true, signs "dexalot{ts}" and sends x-timestamp header.
# Requires backend support — keep false until backend confirms timestamp validation.
# Default: false
# DEXALOT_TIMESTAMPED_AUTH=false

# --- RPC Provider Override ---
# Override RPC endpoints for specific chains (comma-separated for multiple providers)
# Two formats are supported:
# 1. Chain ID format (preferred): DEXALOT_RPC_<CHAIN_ID>=url1,url2,url3
# 2. Native token symbol format: DEXALOT_RPC_<NATIVE_TOKEN_SYMBOL>=url1,url2,url3
# Chain ID takes precedence over native token symbol if both are set
# Examples:
# DEXALOT_RPC_43114=https://api.avax.network/ext/bc/C/rpc,https://avalanche.public-rpc.com
# DEXALOT_RPC_1=https://eth.llamarpc.com,https://ethereum.public-rpc.com
# DEXALOT_RPC_42161=https://arb1.arbitrum.io/rpc
# DEXALOT_RPC_432204=https://subnets.avax.network/dexalot/mainnet/rpc
# DEXALOT_RPC_AVAX=https://api.avax.network/ext/bc/C/rpc,https://avalanche.public-rpc.com
# DEXALOT_RPC_ETH=https://eth.llamarpc.com,https://ethereum.public-rpc.com
# DEXALOT_RPC_ALOT=https://subnets.avax.network/dexalot/mainnet/rpc


# --- Secrets Vault Settings ---
# These settings are only needed for an optional secrets-vault / MCP workflow.
# Plain SDK usage does not require them.
# Fernet encryption key for the secrets vault (Python tooling).
# If not set, an MCP server may prompt for it at startup (or start in read-only mode).
# DEXALOT_SECRETS_VAULT_KEY=your-fernet-key-here

# Skip the interactive terminal prompt in containerised / non-interactive deployments.
# Set to true when running in Docker or CI where stdin is not a terminal.
# DEXALOT_SECRETS_VAULT_NO_PROMPT=false

# Path to the encrypted secrets vault file.
# Default: ~/.dexalot/secrets_vault.json
# DEXALOT_SECRETS_VAULT_PATH=~/.dexalot/secrets_vault.json