.env.example

# Universal Crypto MCP - Environment Variables
# Copy this file to .env and fill in your values

# ====================
# LOGGING
# ====================
# Log levels: DEBUG, INFO, WARN, ERROR
LOG_LEVEL=INFO

# ====================
# WALLET (Required for write operations)
# ====================
# Your private key for signing transactions (swaps, transfers, etc.)
# ⚠️ NEVER commit .env to git! Use a dedicated wallet for testing.
PRIVATE_KEY=your_private_key_here

# ====================
# SERVER CONFIGURATION
# ====================
# Port for HTTP/SSE server (default: 3001)
PORT=3001

# ====================
# MARKET DATA APIs
# ====================

# CoinGecko API Key (optional - has free tier)
# Get yours at: https://www.coingecko.com/en/api
# COINGECKO_API_KEY=CG-xxxxxxxxxxxxx

# CoinStats API Key (optional)
# Get yours at: https://coinstats.app/api
# COINSTATS_API_KEY=

# ====================
# SOCIAL & SENTIMENT
# ====================

# LunarCrush API Key (required for social metrics)
# Get yours at: https://lunarcrush.com/developers
# LUNARCRUSH_API_KEY=

# ====================
# NEWS
# ====================

# CryptoPanic API Key (required for news feed)
# Get yours at: https://cryptopanic.com/developers/api/
# CRYPTOPANIC_API_KEY=

# ====================
# CROSS-CHAIN / BRIDGES
# ====================

# Rubic API Key (optional - enhances cross-chain swap routes)
# Get yours at: https://rubic.exchange/
# RUBIC_API_KEY=

# ====================
# CUSTOM RPC ENDPOINTS (optional)
# ====================
# By default, public RPCs are used. For better reliability,
# use your own RPC endpoints from Infura, Alchemy, QuickNode, etc.

# ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_PROJECT_ID
# ARBITRUM_RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_API_KEY
# BASE_RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_API_KEY
# OPTIMISM_RPC_URL=https://opt-mainnet.g.alchemy.com/v2/YOUR_API_KEY
# POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY
# BSC_RPC_URL=https://bsc-dataseed1.binance.org
# AVALANCHE_RPC_URL=https://api.avax.network/ext/bc/C/rpc

# ====================
# NON-EVM CHAINS (optional)
# ====================

# XRP/Ripple
# XRP_RPC_URL=wss://s1.ripple.com
# XRP_PRIVATE_KEY=
# XRP_MNEMONIC=
# XRP_ADDRESS=

# TON (The Open Network)
# TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC
# TON_API_KEY=
# TON_MNEMONIC=
# TON_ADDRESS=

# THORChain
# THORCHAIN_MNEMONIC=

# ====================
# TECHNICAL INDICATORS (optional)
# ====================

# Exchange for OHLCV data (default: binance)
# EXCHANGE_NAME=binance

# ============================================================================
# 🔑 X402 PAYMENT PROTOCOL
# ============================================================================

# X402 private key for signing payments
# X402_PRIVATE_KEY=0x...

# EVM-specific private key (falls back to X402_PRIVATE_KEY)
# X402_EVM_PRIVATE_KEY=0x...

# Solana private key for x402 SVM payments
# X402_SVM_PRIVATE_KEY=...

# Default blockchain: arbitrum, base, polygon, ethereum, optimism
X402_CHAIN=base

# Maximum payment amount per transaction
X402_MAX_PAYMENT=100.00

# Minimum payment amount
X402_MIN_PAYMENT=0.0001

# Address to receive x402 payments
X402_PAY_TO=0x40252CFDF8B20Ed757D61ff157719F33Ec332402

# Network identifier (CAIP-2 format)
X402_NETWORK=eip155:8453

# Facilitator URL for payment verification
X402_FACILITATOR_URL=https://facilitator.x402.org

# Enable gasless transactions
X402_ENABLE_GASLESS=true

# Debug mode
X402_DEBUG=false

# Default payment token
X402_DEFAULT_TOKEN=USDC

# ============================================================================
# 🔌 API KEYS - BLOCKCHAIN EXPLORERS
# ============================================================================

# Block explorer API keys (for contract verification & data)
# ETHERSCAN_API_KEY=
# ARBISCAN_API_KEY=
# BASESCAN_API_KEY=
# POLYGONSCAN_API_KEY=
# BSCSCAN_API_KEY=

# ============================================================================
# 🔌 API KEYS - ADDITIONAL SERVICES
# ============================================================================

# Binance exchange credentials
# BINANCE_API_KEY=
# BINANCE_API_SECRET=

# Alchemy (blockchain data & RPC)
# ALCHEMY_API_KEY=

# AI/LLM APIs
# OPENAI_API_KEY=
# ANTHROPIC_API_KEY=
# GROQ_API_KEY=

# IPFS/Pinata for NFT metadata
# PINATA_API_KEY=
# PINATA_SECRET_KEY=

# GitHub (for repo tools)
# GITHUB_TOKEN=

# ============================================================================
# 💾 DATABASE CONFIGURATION
# ============================================================================

# Full database connection string (overrides individual settings)
# DATABASE_URL=postgres://user:password@localhost:5432/mcp_hosting

# Database type: postgres, mysql, sqlite
DB_TYPE=postgres

# Enable database connection
DB_ENABLED=false

# Individual database settings (used if DATABASE_URL not set)
DB_HOST=localhost
DB_PORT=5432
DB_NAME=defi_mcp
DB_USER=postgres
DB_PASSWORD=
DB_SSL=false

# ============================================================================
# 🔴 REDIS CONFIGURATION
# ============================================================================

# Full Redis connection URL
# REDIS_URL=redis://localhost:6379

# Enable Redis connection
REDIS_ENABLED=false

# Individual Redis settings
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
REDIS_TLS=false
REDIS_PREFIX=ucmcp:

# ============================================================================
# 🔒 SECURITY & AUTHENTICATION
# ============================================================================

# JWT secret [CHANGE IN PRODUCTION!]
JWT_SECRET=your-super-secret-jwt-key-change-in-production

# API key authentication
AUTH_API_KEY_ENABLED=false
AUTH_API_KEY_REQUIRED=false
AUTH_API_KEY_HEADER=X-API-Key

# Encryption key for wallet storage
# ENCRYPTION_KEY=
# MASTER_PASSWORD=

# ============================================================================
# 📊 RATE LIMITING
# ============================================================================

# Enable rate limiting
RATE_LIMIT_ENABLED=true

# Requests per window
RATE_LIMIT_MAX=100

# Window duration (seconds)
RATE_LIMIT_WINDOW=60

# ============================================================================
# 📈 MONITORING & LOGGING
# ============================================================================

# Log format: json, pretty
LOG_FORMAT=json

# Enable Prometheus metrics
METRICS_ENABLED=true
METRICS_PATH=/metrics

# Health check
HEALTH_ENABLED=true
HEALTH_PATH=/health

# ============================================================================
# 💳 STRIPE PAYMENTS (for hosting subscriptions)
# ============================================================================

# Stripe API keys [REQUIRED for Stripe features]
# STRIPE_SECRET_KEY=sk_...
# STRIPE_WEBHOOK_SECRET=whsec_...

# Stripe price IDs
STRIPE_PRICE_PRO=price_pro_monthly
STRIPE_PRICE_BUSINESS=price_business_monthly
STRIPE_PRICE_ENTERPRISE=price_enterprise_monthly

# ============================================================================
# 📧 EMAIL CONFIGURATION
# ============================================================================

# Email service (choose one)
# RESEND_API_KEY=
# SENDGRID_API_KEY=

# From address
EMAIL_FROM=noreply@agenti.cash

# ============================================================================
# 🔗 NOTIFICATION WEBHOOKS
# ============================================================================

# Alert notifications
# ALERT_WEBHOOK_URL=
# DISCORD_WEBHOOK_URL=
# TELEGRAM_BOT_TOKEN=
# TELEGRAM_CHAT_ID=

# ============================================================================
# ⚙️ CORS & NETWORKING
# ============================================================================

# Allowed origins (comma-separated, or * for all)
ALLOWED_ORIGINS=*

# Allow credentials
CORS_CREDENTIALS=true

# ============================================================================
# 🤖 SOLANA CONFIGURATION
# ============================================================================

# Network: mainnet-beta, devnet, testnet
SOLANA_NETWORK=mainnet-beta

# Solana RPC URL
# SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# Commitment level: processed, confirmed, finalized
SOLANA_COMMITMENT=confirmed

# ============================================================================
# 🔧 ADVANCED CONFIGURATION
# ============================================================================

# Upstream timeout (ms)
UPSTREAM_TIMEOUT=30000

# Upstream retries
UPSTREAM_RETRIES=3

# Test mode
TEST_MODE=false

# MCP Server settings
MCP_SERVER_NAME=universal-crypto-mcp
MCP_SERVER_VERSION=1.0.0
MCP_TRANSPORT=stdio