.env.example

# Provider URLs
PROVIDER_URL_MAINNET=https://eth-mainnet.g.alchemy.com/v2/your-api-key
PROVIDER_URL_POLYGON=https://polygon-mainnet.g.alchemy.com/v2/your-api-key
PROVIDER_URL_ARBITRUM=https://arb-mainnet.g.alchemy.com/v2/your-api-key
PROVIDER_URL_OPTIMISM=https://opt-mainnet.g.alchemy.com/v2/your-api-key
PROVIDER_URL_BASE=https://base-mainnet.g.alchemy.com/v2/your-api-key
PROVIDER_URL_KATANA=https://katana.gateway.tenderly.co

# Fallback Providers
PROVIDER_URL_MAINNET_1=https://rpc.ankr.com/eth
PROVIDER_URL_POLYGON_1=https://polygon-rpc.com
PROVIDER_URL_ARBITRUM_1=https://arb1.arbitrum.io/rpc
PROVIDER_URL_OPTIMISM_1=https://mainnet.optimism.io
PROVIDER_URL_BASE_1=https://mainnet.base.org
PROVIDER_URL_KATANA_1=https://rpc.katanarpc.com

# Yearn large TVL env vars
ENVIO_GRAPHQL_URL=""

# Telegram API credentials
TELEGRAM_BOT_TOKEN_DEFAULT=your-default-bot-token
TELEGRAM_CHAT_ID_DEFAULT=your-default-chat-id

# Test override: when set, EVERY alert (all protocols) is routed to this single
# chat via the DEFAULT bot, with a [protocol] label prefix and no topic
# threading. Use it to send the whole fleet to one dummy group for a comparison
# run; leave unset/empty in production to restore normal per-protocol routing.
# The DEFAULT bot must be a member of the dummy group.
# TELEGRAM_TEST_CHAT_ID=your-dummy-group-chat-id


# Telegram Topics (forum-style group) — single group with per-protocol topics
# TELEGRAM_CHAT_ID_TOPICS=your-topics-group-chat-id
# TELEGRAM_TOPIC_ID_AAVE=123
# TELEGRAM_TOPIC_ID_COMPOUND=456
# TELEGRAM_TOPIC_ID_YEARN_TIMELOCK=789

# Dedicated errors channel — operational errors/diagnostics (GraphQL/fetch
# failures, retries, script crashes) are routed here instead of the per-protocol
# alert groups, so transient noise doesn't spam them. Each message is prefixed
# with a [protocol] label. Configure EITHER a topic in the topics group OR a
# standalone chat (with TELEGRAM_TOPIC_ID_ERRORS taking precedence). If neither
# is set, errors fall back to the originating protocol's own channel so nothing
# is lost.
# TELEGRAM_TOPIC_ID_ERRORS=321
# TELEGRAM_CHAT_ID_ERRORS=your-errors-chat-id
# TELEGRAM_BOT_TOKEN_ERRORS=your-errors-bot-token  # optional; falls back to DEFAULT bot

# Protocol-specific Telegram settings (legacy per-protocol chats)
TELEGRAM_BOT_TOKEN_AAVE=your-aave-bot-token
TELEGRAM_CHAT_ID_AAVE=your-aave-chat-id

# Yearn timelock internal chat — mirrors every YEARN_TIMELOCK alert that goes to
# the timelock topic into a separate standalone chat.
# TELEGRAM_BOT_TOKEN_YEARN_TIMELOCK_INTERNAL=your-bot-token
# TELEGRAM_CHAT_ID_YEARN_TIMELOCK_INTERNAL=your-internal-chat-id

# Protocol-specific threshold settings
AAVE_ALERT_THRESHOLD=0.95
AAVE_CRITICAL_THRESHOLD=0.98
AAVE_ENABLE_NOTIFICATIONS=true

# Safe (two keys rotated to stay within API rate limits)
SAFE_API_KEY=your-api-key
SAFE_API_KEY_2=your-second-api-key

# Tenderly (for transaction simulation)
TENDERLY_API_KEY=your-tenderly-api-key
TENDERLY_ACCOUNT=yearn
TENDERLY_PROJECT=sam

# Etherscan v2 multichain API key (for AI explainer source context)
# Single key works across mainnet, optimism, polygon, arbitrum, base, etc.
ETHERSCAN_TOKEN=your-etherscan-api-key

# LLM provider for AI transaction explanations
# Supported: venice (default), openai, anthropic, or any OpenAI-compatible provider
LLM_PROVIDER=venice
LLM_API_KEY=your-llm-api-key
# LLM_BASE_URL=https://api.venice.ai/api/v1  # auto-set for known providers
# LLM_MODEL=deepseek-v4-flash  # auto-set for known providers
WAVEY_GIST_API_KEY=your-wavey-gist-api-key

# Dune (hourly large-transfer monitor)
DUNE_API_KEY=your-dune-api-key
DUNE_LARGE_TRANSFERS_QUERY_ID=1234567
# DUNE_LARGE_TRANSFER_THRESHOLD=5000000

# Global settings
LOG_LEVEL=INFO  # DEBUG, INFO, WARNING, ERROR (DEBUG skips Telegram sends)
REQUEST_TIMEOUT=30
RETRY_COUNT=3
BACKOFF_FACTOR=1.0