.env.example

# API Keys for Skillware
# Copy to `.env` in the repository root. See docs/usage/api_keys.md for setup,
# security, cloud/CI patterns, and how skill env names relate to your deployment.

# Ethereum Interaction (Required for Wallet Screening)
# Get key: https://etherscan.io/apis
ETHERSCAN_API_KEY="your_etherscan_key_here"

# AI Models (At least one required for agent loops)
GOOGLE_API_KEY="your_gemini_key_here"
ANTHROPIC_API_KEY="sk-ant-..."
OPENAI_API_KEY="sk-..."
DEEPSEEK_API_KEY="your_deepseek_key_here"
# Optional — OpenAI-compatible hosts (e.g. examples/openai_compatible_host.py via Groq)
# GROQ_API_KEY="your_groq_key_here"
# GROQ_MODEL="llama-3.3-70b-versatile"

# GitHub (Optional — used by dev_tools/issue_resolver)
# Without this key the GitHub API applies an unauthenticated rate limit (60 req/hr per IP).
# With a token the limit rises to 5,000 req/hr. Required for private repositories.
# Create a fine-grained PAT with read-only Contents + Issues access:
# https://github.com/settings/personal-access-tokens/new
GITHUB_TOKEN="github_pat_..."

# DeFi / EVM agent wallet (defi/evm_tx_handler)
# Use a dedicated agent wallet with limited funds — never a personal or treasury wallet.
# Preview and dry-run before live transfers. Never commit real private keys.
# AGENT_WALLET_PRIVATE_KEY="0x..."   # preferred name for signing
# AGENT_PRIVATE_KEY="0x..."          # alias (also accepted by evm_tx_handler)
# ETHEREUM_RPC_URL="https://..."
# BASE_RPC_URL="https://..."
# BASESCAN_API_KEY="..."             # optional block explorer API (not used by skill core)
# COINGECKO_API_KEY="optional_for_usd_caps"

# EVM operator config (shared by defi skills — skillware evm init)
# Chain metadata lives in ~/.config/skillware/evm.yaml; RPC URLs stay here in .env.
# EVM_CONFIG_PATH="/path/to/evm.yaml"
# ARBITRUM_RPC_URL="https://..."   # when a custom chain uses rpc_env: ARBITRUM_RPC_URL

# Shared address book (mail + defi — skillware addressbook init)
# GMAIL_ADDRESSBOOK_PATH="/path/to/addressbook.yaml"
# EVM_ADDRESSBOOK_PATH="/path/to/addressbook.yaml"

# DeFi / Token Security Scanner (defi/token_security_scanner)
# Optional GoPlus Bearer credential for higher rate limits. Free Token Security
# calls work without a key: https://docs.gopluslabs.io/
# GOPLUS_APP_KEY="your_goplus_access_token_here"

# Finance / UK Companies House Handler (finance/uk_companies_house_handler)
# Get key: https://developer.company-information.service.gov.uk/
COMPANIES_HOUSE_API_KEY="your_companies_house_api_key_here"

# Office / Gmail Handler (office/gmail_handler)
# Create a NEW dedicated agent Gmail account for automation — the same way you would
# create a fresh agent wallet for defi/evm_tx_handler. Do NOT use your personal,
# work, or primary inbox. Fund/limit exposure to what the agent needs; revoke the
# App Password if the agent is retired.
# Enable IMAP in Gmail settings; create App Password after 2FA:
# https://myaccount.google.com/apppasswords
# GMAIL_ADDRESS="agent-mailbox@example.com"
# GMAIL_APP_PASSWORD="your-16-char-app-password"
# Optional overrides (writable paths recommended outside the repo):
# GMAIL_ADDRESSBOOK_PATH="/path/to/addressbook.yaml"
# GMAIL_SIGNATURE_PATH="/path/to/mail_signature.txt"
# GMAIL_SIGNATURE_HTML_PATH="/path/to/mail_signature.html"
# GMAIL_SIGNATURE_PLAIN="—\nSent by agent via Skillware"
# GMAIL_SIGNATURE_PROFILE="default"
# GMAIL_SCAN_STATE_PATH="/path/to/.gmail_scan_state.json"
# GMAIL_SEND_LEDGER_PATH="/path/to/send_ledger.json"