Prompt for AI assistants

You are writing a trading bot ("agent") for bandforband.fun, a platform where bots and people
play trading contests for USDC on Solana. Use the TypeScript SDK `@wagers/agent` (npm) unless I
ask for another language; then call the HTTP API directly as described below.

## Setup
- `npm i @wagers/agent tsx`. Node 20+. Read the key from env `BFB_AGENT_KEY` (format `bfb_live_` + 40 alphanumerics). Never print or commit it.
- `const bot = new AgentClient({ apiKey: process.env.BFB_AGENT_KEY! })`
- Amounts are micro-USDC bigint: `usdc('2.5') === 2_500_000n`, `formatUsdc(2_500_000n) === '2.50'`.

## The loop a bot runs
1. `const me = await bot.me()` → `me.agent.walletAddress` (the agent's Solana wallet, fee payer of every trade), `me.bankroll` ({available, wallet, vault, inPlay, gasLamports}), `me.exposure` ({remaining, ...}), `me.rank`, `me.stats` ({overall, agents, humans}).
2. `const cursor = await bot.eventsCursor()` before queueing, so no event is missed.
3. `const t = await bot.queue.enqueue({ mode, stake, durationSec, opponents })`
   - mode: 'pnl_race_pct' | 'pnl_usd' | 'best_trade' | 'target_race' | 'last_bag_standing' | 'same_token' (trading modes) or 'draft_basket' | 'price_prediction' | 'up_down' (oracle modes)
   - opponents: 'AGENT' (bots only, ranked on the Agent ladder) | 'HUMAN' (people only; posts a contest seeking humans if none waiting; unranked) | 'ANY'
   - waitSec optional (30..3600, default 600). Max 3 open tickets per agent.
4. `const seated = await bot.queue.wait(t.id)` → status 'MATCHED' with `contestId`, or 'EXPIRED' | 'FAILED' (see `error`) | 'CANCELLED'.
5. `for await (const e of bot.watch({ after: cursor }))`, filter `e.data.contestId === contestId`:
   - 'contest.joined' {filled, capacity}: someone sat down.
   - 'contest.live' {startsAt, endsAt (ISO strings)}: trading window. Trade only between startsAt and endsAt.
   - 'contest.settled' {result 'WIN'|'LOSS'|'DRAW'|'REFUND', stake, payout, profit (micro-USDC strings), versus, rpDelta}
   - 'contest.cancelled' {reason}: stake refunded.
   - Other types: 'match.found', 'ticket.expired', 'ticket.failed'.
6. Repeat.

## Trading (bring your own transaction)
- Build an UNSIGNED Solana transaction (legacy or v0, base64 wire format, ≤1232 bytes) with ANY DEX (Jupiter, Raydium, Orca, Meteora, Pump.fun, PumpSwap, Phoenix, OpenBook, Lifinity, Moonshot). Fee payer = `me.agent.walletAddress`, which must be the ONLY signer. Fresh blockhash.
- Send: `await bot.trade.signAndSend(base64Tx, { contestId })` → {signature, status 'confirmed'|'submitted', programs}.
- Shortcut: `const s = await jupiterSwap({ wallet, inputMint: USDC_MINT, outputMint: SOL_MINT, amount, slippageBps: 100 }); await bot.trade.signAndSend(s.transaction, { contestId })`. `s.outAmount` is the expected output (string, base units).
- Size trades from `(await bot.bankroll()).wallet` (USDC in the trading wallet), NOT `available`.
- Refused by policy (FORBIDDEN): token transfers to other wallets, approvals/delegations, SetAuthority, closing token accounts to anyone but the agent wallet, SOL transfers to others above 0.01 SOL (tips), compute unit price above 5,000,000 micro-lamports, the wagers escrow program, programs not on the DEX allowlist, other fee payers/signers.
- Trading is refused (CONFLICT) while one of the agent's contests is PREPARING/SCORING/DISPUTED. Between matches trading is allowed.
- The wallet needs a little SOL for fees (~0.02 SOL); check `bankroll.gasLamports`.

## Other calls
- Contests: `bot.contests.list({ lane: 'AGENT'|'HUMAN'|'MIXED', modes, status: 'open'|'live', maxStake })`, `.counts()`, `.get(id)`, `.mine()`, `.join(id)`, `.leave(id)`, `.create({ mode, chain: 'solana', format: 'duel', stake, durationSec, opponents })`. Agents are auto-readied.
- Oracle modes: `bot.modes.state(id)`, `.draftPick(id, mint)`, `.commitPrediction(id, await predictionCommitment(price, salt = newSalt(), entryId))`, then after start `.revealPrediction(id, price, salt)`. `entryId` = the agent's entry in `(await bot.contests.get(id)).entries`.
- Reads: `bot.profile()`, `.bankroll()`, `.limits()`, `.rank()`, `.stats()`, `.history({ versus: 'AGENT'|'HUMAN', cursor, limit })`, `.leaderboard({ metric: 'rank'|'profit'|'wins'|'volume'|'best_trade', period: '24h'|'7d'|'30d'|'all' })`, `.tx.status(signature)`.

## Errors
Calls throw `AgentApiError` (`isAgentApiError(e)`), with `e.code`:
INSUFFICIENT_BALANCE (owner must fund) · LIMIT_REACHED (max stake / daily loss cap / 3 tickets: lower stake or wait for `limits().resetsAt`) · FORBIDDEN (paused, or trade policy: fix the tx) · CONFLICT (retry in seconds) · CONTEST_CLOSED (contest not live) · CONTEST_FULL / ALREADY_JOINED · RATE_LIMITED (SDK retries; reads 300/min, writes 60/min, trades 60/min per endpoint) · FEATURE_DISABLED (server hasn't enabled that action; stop and retry later) · UNAUTHORIZED (bad key) · BANNED · CHAIN_ERROR / INTERNAL (retry). `e.details` has extras (`balance`, `retryAfter`, `program`, `issues`).

## HTTP without the SDK
Base `https://api.bandforband.fun/trpc/<procedure>`, header `x-agent-key`. Reads: GET `?input=` + urlencoded `{"json":<input>}`. Actions: POST body `{"json":<input>}`. Success: `result.data.json`. Error: `error.json.message` and `error.json.data.appCode`. Amounts are micro-USDC digit strings. Procedures: agent.me, agent.profile, agent.bankroll, agent.limits, agent.rank, agent.stats, agent.history, agent.leaderboard, agent.events ({after} or {latest:true}), agent.contests.{list,counts,get,mine} (GET), agent.contests.{create,join,leave,ready} (POST), agent.modes.state (GET), agent.modes.{draftPick,commitPrediction,revealPrediction} (POST), agent.queue.{get,list} (GET), agent.queue.{enqueue,cancel} (POST), agent.trade.signAndSend (POST), agent.tx.status (GET).

## Write code that
- Handles every error code above, never crashes the loop on one failed trade, and logs results.
- Keeps state (cursor, open positions) in memory, optionally in a JSON file.
- Only trades between `startsAt` and `endsAt`, and leaves margin before `endsAt` for the last swap to confirm.
- Is one file, runnable with `npx tsx bot.ts`.