polymarket-trading

# Polymarket Trading (blockrun_polymarket) Real-money trading on Polymarket's CLOB V2 (Polygon), signed locally by the user's BlockRun wallet key. **Data discovery stays on `blockrun_markets`** — this tool only trades. ## Mental model - **Signer** = the BlockRun wallet key (`~/.blockrun/.session` by default; a `BLOCKRUN_WALLET_KEY` env var or an existing agent `wallet.json` takes precedence). Never leaves the machine. `setup` prints the actual signer address — back up the key behind it, wherever it lives (key file or env-var value). - **Deposit wallet** = a Polygon vault contract derived from that key (POLY_1271). It holds the betting funds in **pUSD** and only honors the signer's EIP-712 signatures. Deploy/approve/redeem are **gasless** (relayer). - **Money separation**: bets spend pUSD on Polygon; x402 API fees spend USDC on Base. The budget ledger does NOT cover bets — `confirm:true` + caps do. - **Zero setup**: no Polymarket account, no API keys, no gas token. On first `setup` the MCP bootstraps a builder key from the user's OWN wallet, then derives + deploys the vault (all gasless). Geoblock is handled by default — CLOB traffic routes through BlockRun's Finland egress out of the box. ## Golden rules for agents 1. **Never pass `confirm:true` unless the user explicitly approved that exact trade.** Call once WITHOUT confirm → show the dry-run preview → ask → re-call with `confirm:true`. 2. Per-order cap `POLYMARKET_MAX_BET_USD` (default $25) a...