Upload .env.example

.env.example

@@ -0,0 +1,71 @@
+# BuilderBrain Environment Configuration
+# Copy to .env and fill in real values for live mode
+
+# ────────────────────────────── Circle Gateway ──────────────────────────────
+# Get from https://developers.circle.com/
+# Required for: cross-chain USDC transfers, unified balance queries
+CIRCLE_API_KEY=sk_test_your_circle_api_key_here
+
+# Circle Gateway testnet (default)
+# GATEWAY_BASE_URL=https://gateway-api-testnet.circle.com
+
+# ────────────────────────────── Arc/Circle ──────────────────────────────
+# Arc Testnet RPC endpoint (from Arc docs: "Connect to Arc")
+ARC_RPC_URL=https://arc-testnet-rpc.example.com
+
+# Depositor wallet address on Arc (for Gateway balance queries)
+ARC_DEPOSITOR_ADDRESS=0xYourDepositorAddressHere
+
+# Arc domain ID for your chain (get from GET /gateway-info)
+ARC_DOMAIN_ID=0
+
+# ────────────────────────────── Polymarket ──────────────────────────────
+# Polymarket API key (for CLOB order submission)
+POLY_API_KEY=your_polymarket_api_key
+
+# Polymarket private key (for order signing)
+# WARNING: Use environment secrets, never commit to repo
+POLY_PRIVATE_KEY=0xYourPrivateKeyHere
+
+# Builder code (register at https://polymarket.com/settings?tab=builder)
+# Format: bytes32 hex string, e.g. 0x00000000000000000000000000000001
+POLY_BUILDER_CODE=0xYourBuilderCodeHere
+
+# ────────────────────────────── USYC (Yield) ──────────────────────────────
+# Arc Testnet USYC addresses (from Circle docs)
+USYC_TOKEN_ADDRESS=0xe9185F0c5F296Ed1797AaE4238D26CCaBEadb86C
+USYC_TELLER_ADDRESS=0x9fdF14c5B14173D74C08Af27AebFf39240dC105A
+USYC_ORACLE_ADDRESS=0x52b56c7642E71dc54714d879127d97cd0B3D4581
+USYC_ENTITLEMENTS_ADDRESS=0xcc205224862c7641930c87679e98999d23c26113
+
+# ────────────────────────────── ERC-4337 Paymaster ──────────────────────────────
+# Pimlico bundler RPC (Arc EntryPoint)
+PIMLICO_BUNDLER_URL=https://bundler.pimlico.io/v2/arc-testnet
+
+# Circle Paymaster address (if supported on Arc)
+# Currently using Arbitrum Sepolia: 0x31BE08D... (check latest docs)
+CIRCLE_PAYMASTER_ADDRESS=0x31BE08D...
+
+# ────────────────────────────── Wallets ──────────────────────────────
+# Circle Developer-Controlled Wallets
+CIRCLE_WALLET_API_KEY=your_circle_wallet_api_key
+CIRCLE_WALLET_SET_ID=your_wallet_set_uuid
+
+# ────────────────────────────── OpenAI / LLM ──────────────────────────────
+# For reasoning agent enrichment (optional)
+OPENAI_API_KEY=sk-your_openai_key
+
+# ────────────────────────────── Application ──────────────────────────────
+# Default bankroll for paper trading
+DEFAULT_BANKROLL_USD=10000
+
+# Paper trade mode (set to false for live trading)
+PAPER_TRADE=true
+
+# Kelly engine constraints
+MAX_LEVERAGE=2.0
+MAX_DRAWDOWN=0.20
+MIN_EDGE=0.03
+
+# Logging
+LOG_LEVEL=INFO