# MCP Ledger Server Environment Configuration
# Copy this file to .env and fill in your API keys and custom endpoints

# =============================================================================
# REQUIRED API KEYS
# =============================================================================

# Dune Sim API Key (REQUIRED for token/NFT discovery)
# Get your free API key at: https://sim.dune.com
# This is required for SPL token discovery and ERC20/NFT functionality
DUNE_SIM_API_KEY=your_dune_sim_api_key_here

# =============================================================================
# OPTIONAL PERFORMANCE API KEYS (Recommended for production)
# =============================================================================

# Alchemy API Key (OPTIONAL - Enhanced RPC performance)
# Get your key at: https://alchemy.com
# Provides 2M+ requests/month free tier and improved reliability
# ALCHEMY_API_KEY=your_alchemy_api_key_here

# Etherscan API Key (OPTIONAL - Contract verification)
# Get your key at: https://etherscan.io/apis
# Provides 100k requests/day free tier for contract ABI verification
# ETHERSCAN_API_KEY=your_etherscan_api_key_here

# =============================================================================
# CUSTOM ETHEREUM RPC ENDPOINTS (Optional)
# =============================================================================
# Leave blank to use Alchemy (if configured) or public endpoints
# Custom endpoints useful for dedicated infrastructure or specific providers

# Ethereum Mainnet
# MAINNET_RPC_URL=https://your-custom-mainnet-rpc.com

# Ethereum Sepolia Testnet
# SEPOLIA_RPC_URL=https://your-custom-sepolia-rpc.com

# Polygon Mainnet
# POLYGON_RPC_URL=https://your-custom-polygon-rpc.com

# Arbitrum One
# ARBITRUM_RPC_URL=https://your-custom-arbitrum-rpc.com

# Optimism Mainnet
# OPTIMISM_RPC_URL=https://your-custom-optimism-rpc.com

# Base Mainnet
# BASE_RPC_URL=https://your-custom-base-rpc.com


# =============================================================================
# SERVER CONFIGURATION
# =============================================================================

# Server Port (default: 3000)
# PORT=3000

# Node Environment (development, production, test)
NODE_ENV=development

# Request Timeout in milliseconds (default: 30000 = 30 seconds)
REQUEST_TIMEOUT=30000

# Cache TTL in seconds (default: 300 = 5 minutes)
CACHE_TTL=300

# =============================================================================
# EXAMPLE CONFIGURATIONS FOR POPULAR PROVIDERS
# =============================================================================

# Example: QuickNode (Ethereum)
# MAINNET_RPC_URL=https://your-endpoint.ethereum.quiknode.pro/YOUR_TOKEN/

# Example: Alchemy
# ALCHEMY_API_KEY=your_alchemy_api_key_here

# =============================================================================
# CONFIGURATION NOTES
# =============================================================================

# Minimum Configuration:
# - DUNE_SIM_API_KEY is required for token discovery
# - All other settings are optional and will use defaults

# Recommended Production Configuration:
# - DUNE_SIM_API_KEY (required)
# - ALCHEMY_API_KEY or custom RPC endpoints for better performance

# Rate Limits:
# - Public endpoints: Often rate limited (1-10 RPS)
# - Alchemy Free: 300 RPS, 2M requests/month
# - QuickNode: Varies by plan

# Security:
# - Never commit your .env file to version control
# - Keep API keys secure and rotate them regularly
# - Use different keys for development and production