.env.example

# Network: mainnet or testnet
NETWORK=testnet

# Wallet spending limit (default-on safety rail) ------------------------------
# Every outbound spend (transfer_stx, transfer_btc, x402/L402 auto-payments) is
# metered against a cumulative per-session AND per-day cap. A spend that would
# exceed the cap is blocked and reports the remaining budget. Defaults are
# conservative (~10 STX + ~50k sats/day). Uncomment to override, or disable.
# SPEND_LIMIT_ENABLED=false        # set false to turn the limiter off entirely
# SPEND_LIMIT_DAILY_USTX=10000000  # 10 STX/day (micro-STX)
# SPEND_LIMIT_SESSION_USTX=10000000
# SPEND_LIMIT_DAILY_SATS=50000     # ~$30 BTC/day (sats)
# SPEND_LIMIT_SESSION_SATS=50000

# ⚠️  WALLET KEYS — RECOMMENDED: do NOT put a seed phrase here.
# Use managed encrypted wallets instead: run wallet_create or wallet_import.
# They store an AES-256-GCM-encrypted keystore in ~/.aibtc/ (outside this repo),
# so a plaintext seed never lives in a file that can be committed.
#
# CLIENT_MNEMONIC below is a power-user escape hatch ONLY. A seed in a plaintext
# file is one `git add` away from being burned forever. If you must use it,
# keep it out of version control — .gitignore already blocks .env / .env.*.
# CLIENT_MNEMONIC="do-not-paste-a-real-seed-here-use-wallet_create"

# x402 API base URL
API_URL=https://x402.biwas.xyz

# Pillar API
PILLAR_API_URL=https://api.pillar.fi
PILLAR_API_KEY=

# Hiro API Key (optional)
# Improves rate limits for Stacks blockchain queries
# Get your key at: https://platform.hiro.so/
HIRO_API_KEY=

# Sponsor Relay API Key (optional)
# Enables gasless transactions for ERC-8004 and sBTC
# Get your key at: https://x402-relay.aibtc.com
SPONSOR_API_KEY=

# AIBTC Trading Competition API
# Endpoint that indexes agent trade activity and scores competition P&L.
# Defaults to https://aibtc.com/api/competition
AIBTC_CAMPAIGN_API_URL=

# Unisat Open API key (optional but recommended)
# Recommended for reliable inscription/rune-aware UTXO classification on BTC spends.
# Used on both mainnet and testnet — testnet flows now route through the same indexer.
# Without a key, requests share a 5 req/s public rate limit and may be throttled.
# Get a key at: https://docs.unisat.io/
UNISAT_API_KEY=