Initial commit: casino-cli

.env-example

@@ -0,0 +1,19 @@
+# Required: your Base-mainnet wallet private key (held by you, used to pay USDC into the casino)
+PRIVATE_KEY=0xYourPrivateKeyHere
+
+# Required: your shared-secret bearer token for this casino identity.
+# The server hashes it (sha256) and keys your balance by that hash.
+# Treat it like a password — anyone with it can cash out your balance.
+CASINO_TOKEN=my-agent-secret
+
+# Required: where the casino is running.
+CASINO_URL=http://localhost:8000
+
+# Optional: the OpenRouter (or other OpenAI-compatible) model your agent will play as.
+MODEL=openai/gpt-5-nano
+
+# Optional: OpenRouter API key passed to the server so our side can call your model during play.
+OPENROUTER_API_KEY=
+
+# Optional: on-chain wallet you want the cashout paid to (mocked in dev, real in prod).
+CASHOUT_WALLET=

.gitignore

@@ -0,0 +1,5 @@
+.env
+node_modules/
+bun.lock
+dist/
+*.log

README.md

@@ -0,0 +1,56 @@
+# casino-cli
+
+Agent client for the AI Poker/Blackjack Casino. Pays USDC on Base mainnet, joins tables, watches hands — no Coinbase, no facilitator, just viem + a free public Base RPC.
+
+Pattern inspired by [BankrBot's x402-cli-example](https://github.com/BankrBot/x402-cli-example).
+
+## Install
+
+**Recommended (bun, ~10× faster startup):**
+```bash
+curl -fsSL https://bun.sh/install | bash    # one-time, if you don't have bun
+bun install
+```
+
+**Fallback (npm + tsx, no install needed if you have node 18+):**
+```bash
+npm install
+# every command becomes:  npx tsx src/index.ts <cmd>
+```
+
+Then:
+```bash
+cp .env-example .env     # or just: bun src/index.ts wallet new (auto-creates .env)
+```
+
+## Commands
+
+```bash
+bun src/index.ts wallet new             # generate fresh burner → auto-saves to .env
+bun src/index.ts balance                # check your balance
+bun src/index.ts topup 0.01             # send 1¢ USDC → credited to your balance
+bun src/index.ts join MyAgent openai/gpt-5-nano
+bun src/index.ts state
+bun src/index.ts cashout 0xYourWallet
+bun src/index.ts watch                  # tail the table every 3s
+```
+
+(Substitute `npx tsx` for `bun` if you went the fallback route. ~1s slower per command.)
+
+## How it works
+
+1. `topup` asks the casino for payment instructions (`pay_to` address + USDC contract)
+2. Uses `viem` to sign a regular ERC20 `transfer()` with your `PRIVATE_KEY`
+3. Waits for 1 confirmation on Base
+4. POSTs the `tx_hash` back — server self-verifies via Base RPC, credits your balance
+
+No third-party escrow. No API key to Coinbase. Your private key never leaves this machine. The casino only ever sees the public `tx_hash`.
+
+## Costs
+
+- **Gas**: ~$0.0005 per USDC transfer on Base
+- **USDC**: whatever you topup (default $0.01)
+
+## License
+
+MIT

package-lock.json

@@ -0,0 +1,280 @@
+{
+  "name": "casino-cli",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "casino-cli",
+      "version": "0.1.0",
+      "license": "MIT",
+      "dependencies": {
+        "chalk": "^5.3.0",
+        "dotenv": "^16.4.5",
+        "viem": "^2.21.25"
+      },
+      "devDependencies": {
+        "@types/node": "^22.7.4",
+        "bun-types": "^1.1.7"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@adraffy/ens-normalize": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.11.1.tgz",
+      "integrity": "sha512-nhCBV3quEgesuf7c7KYfperqSS14T8bYuvJ8PcLJp6znkZpFc0AuW4qBtr8eKVyPPe/8RSr7sglCWPU5eaxwKQ==",
+      "license": "MIT"
+    },
+    "node_modules/@noble/ciphers": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@noble/ciphers/-/ciphers-1.3.0.tgz",
+      "integrity": "sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw==",
+      "license": "MIT",
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/curves": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.1.tgz",
+      "integrity": "sha512-k11yZxZg+t+gWvBbIswW0yoJlu8cHOC7dhunwOzoWH/mXGBiYyR4YY6hAEK/3EUs4UpB8la1RfdRpeGsFHkWsA==",
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.8.0"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
+      "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==",
+      "license": "MIT",
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.7.0.tgz",
+      "integrity": "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw==",
+      "license": "MIT",
+      "dependencies": {
+        "@noble/curves": "~1.9.0",
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip39": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.6.0.tgz",
+      "integrity": "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==",
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.19.17",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.17.tgz",
+      "integrity": "sha512-wGdMcf+vPYM6jikpS/qhg6WiqSV/OhG+jeeHT/KlVqxYfD40iYJf9/AE1uQxVWFvU7MipKRkRv8NSHiCGgPr8Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/abitype": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/abitype/-/abitype-1.2.3.tgz",
+      "integrity": "sha512-Ofer5QUnuUdTFsBRwARMoWKOH1ND5ehwYhJ3OJ/BQO+StkwQjHw0XyVh4vDttzHB7QOFhPHa/o413PJ82gU/Tg==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/wevm"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4",
+        "zod": "^3.22.0 || ^4.0.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/bun-types": {
+      "version": "1.3.13",
+      "resolved": "https://registry.npmjs.org/bun-types/-/bun-types-1.3.13.tgz",
+      "integrity": "sha512-QXKeHLlOLqQX9LgYaHJfzdBaV21T63HhFJnvuRCcjZiaUDpbs5ED1MgxbMra71CsryN/1dAoXuJJJwIv/2drVA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/eventemitter3": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz",
+      "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==",
+      "license": "MIT"
+    },
+    "node_modules/isows": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/isows/-/isows-1.0.7.tgz",
+      "integrity": "sha512-I1fSfDCZL5P0v33sVqeTDSpcstAg/N+wF5HS033mogOVIp4B+oHC7oOCsA3axAbBSGTJ8QubbNmnIRN/h8U7hg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peerDependencies": {
+        "ws": "*"
+      }
+    },
+    "node_modules/ox": {
+      "version": "0.14.17",
+      "resolved": "https://registry.npmjs.org/ox/-/ox-0.14.17.tgz",
+      "integrity": "sha512-jOzNb2Wlfzsr8z/GoCtd1bf6OSRuWuysvbhnHGD+7fV1WRbcBR6B0RYoe3xWnUedF7zp4l5APmS7CzAhUok/lA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@adraffy/ens-normalize": "^1.11.0",
+        "@noble/ciphers": "^1.3.0",
+        "@noble/curves": "1.9.1",
+        "@noble/hashes": "^1.8.0",
+        "@scure/bip32": "^1.7.0",
+        "@scure/bip39": "^1.6.0",
+        "abitype": "^1.2.3",
+        "eventemitter3": "5.0.1"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/viem": {
+      "version": "2.48.1",
+      "resolved": "https://registry.npmjs.org/viem/-/viem-2.48.1.tgz",
+      "integrity": "sha512-GJC3gKV1Hngeo1IB9YanJKHH2pcmoqDymyPxddmzDtG8boXA7eFw8qdnn1PSaToJ93f3LpOZPlLLJ9beAF/Lzg==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@noble/curves": "1.9.1",
+        "@noble/hashes": "1.8.0",
+        "@scure/bip32": "1.7.0",
+        "@scure/bip39": "1.6.0",
+        "abitype": "1.2.3",
+        "isows": "1.0.7",
+        "ox": "0.14.17",
+        "ws": "8.18.3"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.18.3",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz",
+      "integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

package.json

@@ -0,0 +1,32 @@
+{
+  "name": "casino-cli",
+  "version": "0.1.0",
+  "description": "CLI agent client for the AI Poker/Blackjack Casino. Pays USDC on Base mainnet, joins tables, watches hands.",
+  "main": "src/index.ts",
+  "type": "module",
+  "scripts": {
+    "start": "bun src/index.ts",
+    "balance": "bun src/index.ts balance",
+    "topup": "bun src/index.ts topup",
+    "join": "bun src/index.ts join",
+    "state": "bun src/index.ts state",
+    "cashout": "bun src/index.ts cashout",
+    "watch": "bun src/index.ts watch",
+    "wallet:new": "bun src/index.ts wallet new",
+    "tsx": "npx tsx src/index.ts"
+  },
+  "dependencies": {
+    "viem": "^2.21.25",
+    "chalk": "^5.3.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.4",
+    "bun-types": "^1.1.7"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["casino", "poker", "blackjack", "x402", "usdc", "base", "ai-agents"],
+  "license": "MIT"
+}

src/index.ts

@@ -0,0 +1,198 @@
+#!/usr/bin/env bun
+/**
+ * casino-cli — agent client for the AI Poker/Blackjack Casino.
+ *
+ * Uses viem to send USDC on Base mainnet (no Coinbase, no facilitator),
+ * then posts the tx_hash to the casino's /api/twitch/topup for credit.
+ *
+ * Commands:
+ *   bun start balance
+ *   bun start topup [usdc]                (default 0.01)
+ *   bun start join <name> <model>
+ *   bun start state
+ *   bun start cashout [wallet]
+ *   bun start watch                       (poll state every 3s)
+ */
+import { config } from "dotenv";
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+import chalk from "chalk";
+import { createWalletClient, createPublicClient, http, erc20Abi, parseUnits, type Hex } from "viem";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+
+config();
+
+const TOKEN     = process.env.CASINO_TOKEN || "";   // required for server calls; validated lazily
+const CASINO    = (process.env.CASINO_URL || "http://localhost:8000").replace(/\/$/, "");
+const MODEL     = process.env.MODEL || "openai/gpt-5-nano";
+const APIKEY    = process.env.OPENROUTER_API_KEY || "";
+const CASHOUT_WALLET = process.env.CASHOUT_WALLET || "";
+
+function mustEnv(name: string): string {
+    const v = process.env[name];
+    if (!v) { console.error(chalk.red(`Missing ${name} in .env`)); process.exit(1); }
+    return v;
+}
+
+function requireToken() { if (!TOKEN) { console.error(chalk.red("Missing CASINO_TOKEN in .env")); process.exit(1); } }
+
+async function api<T = any>(path: string, body?: any, method: "GET" | "POST" = body ? "POST" : "GET"): Promise<T> {
+    const url = CASINO + path + (method === "GET" && body ? "?" + new URLSearchParams(body).toString() : "");
+    const init: RequestInit = { method, headers: { "Content-Type": "application/json" } };
+    if (method !== "GET" && body) init.body = JSON.stringify(body);
+    const r = await fetch(url, init);
+    const text = await r.text();
+    try { return JSON.parse(text) as T; } catch { throw new Error(`Non-JSON ${r.status}: ${text.slice(0, 200)}`); }
+}
+
+async function cmdBalance() {
+    requireToken();
+    const r: any = await api("/api/twitch/balance", { token: TOKEN }, "GET");
+    console.log(chalk.cyan(JSON.stringify(r, null, 2)));
+}
+
+async function cmdTopup(usdc = 0.01) {
+    requireToken();
+    // Step 1 — get payment instructions
+    const quote: any = await api("/api/twitch/topup", { token: TOKEN, usdc });
+    const inst = quote.instructions;
+    if (!inst) { console.error(chalk.red("No instructions in 402:"), quote); return; }
+    console.log(chalk.yellow(`→ Pay ${usdc} USDC to ${inst.pay_to} on ${inst.network}`));
+
+    // Step 2 — send USDC ERC20 transfer
+    const pk = mustEnv("PRIVATE_KEY") as Hex;
+    const account = privateKeyToAccount(pk);
+    const walletClient = createWalletClient({ account, chain: base, transport: http() });
+    const publicClient = createPublicClient({ chain: base, transport: http() });
+
+    console.log(chalk.gray(`   from ${account.address} → sending transfer...`));
+    const txHash = await walletClient.writeContract({
+        address: inst.usdc_contract as Hex,
+        abi: erc20Abi,
+        functionName: "transfer",
+        args: [inst.pay_to as Hex, parseUnits(String(usdc), 6)],  // USDC has 6 decimals
+    });
+    console.log(chalk.green(`   sent: ${txHash}`));
+    console.log(chalk.gray("   waiting for 1 confirmation..."));
+
+    const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash, confirmations: 1 });
+    if (receipt.status !== "success") {
+        console.error(chalk.red(`tx reverted: ${txHash}`));
+        return;
+    }
+    console.log(chalk.green(`   confirmed in block ${receipt.blockNumber}`));
+
+    // Step 3 — post tx_hash to casino. RPC indexers lag a few seconds behind the block;
+    // retry with linear backoff before giving up.
+    let credit: any;
+    for (const delay of [0, 3000, 5000, 8000, 12000]) {
+        if (delay) await new Promise(r => setTimeout(r, delay));
+        credit = await api("/api/twitch/topup", { token: TOKEN, usdc, tx_hash: txHash });
+        if (credit.ok) break;
+        const reason = String(credit.reason || "");
+        if (!reason.includes("no result")) break;   // only retry RPC-propagation errors
+        console.log(chalk.gray(`   indexer lag, retrying in ${delay || 3000}ms...`));
+    }
+    if (credit?.ok) {
+        console.log(chalk.green.bold(`✓ credited ${credit.credited_mcents} mcents; balance ${credit.balance_mcents}`));
+    } else {
+        console.error(chalk.red("credit failed:"), credit);
+        console.error(chalk.gray(`   retry manually:  curl -X POST ${CASINO}/api/twitch/topup -H 'Content-Type: application/json' -d '{"token":"${TOKEN.slice(0,8)}...","usdc":${usdc},"tx_hash":"${txHash}"}'`));
+    }
+}
+
+async function cmdJoin(name: string, model = MODEL, buyIn = 10.0) {
+    requireToken();
+    if (!name) { console.error(chalk.red("usage: join <name> [model]")); process.exit(1); }
+    const r: any = await api("/api/twitch/join", {
+        name, model, api_key: APIKEY, buy_in_usdc: buyIn, token: TOKEN,
+    });
+    console.log(chalk.cyan(JSON.stringify(r, null, 2)));
+}
+
+async function cmdState() {
+    const s: any = await api("/api/twitch/state", undefined, "GET");
+    const me = (s.players || []).find((p: any) => p.name && p.name !== "—");
+    console.log(chalk.white(`hand #${s.hand_num}  street=${s.street}  pot=$${s.pot}`));
+    for (const p of (s.players || [])) {
+        console.log(`  seat ${p.seat}: ${p.name.padEnd(18)} stack=$${p.stack}  ${p.last_action || ""}`);
+    }
+    if (s.queue_names?.length) console.log(chalk.gray(`queue: ${s.queue_names.join(", ")}`));
+}
+
+async function cmdCashout(wallet = CASHOUT_WALLET) {
+    requireToken();
+    const r: any = await api("/api/twitch/cashout", { token: TOKEN, wallet });
+    console.log(chalk.cyan(JSON.stringify(r, null, 2)));
+}
+
+async function cmdWalletNew(force = false) {
+    // Offline — generates a fresh Base/EVM-compatible keypair + auto-saves to .env.
+    const envPath = path.resolve(process.cwd(), ".env");
+    const existing = fs.existsSync(envPath) ? fs.readFileSync(envPath, "utf8") : "";
+    const hasPK = /^PRIVATE_KEY=0x[0-9a-fA-F]{64}/m.test(existing);
+    if (hasPK && !force) {
+        console.error(chalk.red("✗ .env already has PRIVATE_KEY. Rerun with --force to overwrite (previous funds will be unreachable)."));
+        process.exit(1);
+    }
+    const pk = generatePrivateKey();
+    const acct = privateKeyToAccount(pk);
+
+    // Also auto-generate CASINO_TOKEN if missing (random 24-hex bearer)
+    const hasToken = /^CASINO_TOKEN=/m.test(existing);
+    const token = hasToken ? null : "bearer-" + crypto.randomBytes(12).toString("hex");
+
+    let next = existing;
+    next = next.replace(/^PRIVATE_KEY=.*$/m, "");   // strip old key
+    if (!next.endsWith("\n") && next.length) next += "\n";
+    next += `PRIVATE_KEY=${pk}\n`;
+    if (token) next += `CASINO_TOKEN=${token}\n`;
+    if (!/^CASINO_URL=/m.test(next)) next += "CASINO_URL=http://127.0.0.1:8000\n";
+    fs.writeFileSync(envPath, next, { mode: 0o600 });
+
+    console.log(chalk.green.bold("✓ Fresh burner wallet saved to .env"));
+    console.log();
+    console.log(chalk.white("  Address:  ") + chalk.green(acct.address));
+    if (token) console.log(chalk.white("  Token:    ") + chalk.cyan(token) + chalk.gray("  (keep secret — it owns your casino balance)"));
+    console.log();
+    console.log(chalk.yellow("Next:"));
+    console.log(chalk.gray(`  1. Send ≥0.05 USDC on Base to ${chalk.green(acct.address)} (from MetaMask/Coinbase/etc.)`));
+    console.log(chalk.gray("     Also send ~$0.001 worth of ETH for gas (or use a gas sponsor)."));
+    console.log(chalk.gray("  2. npx tsx src/index.ts topup 0.01"));
+}
+
+async function cmdWatch() {
+    while (true) {
+        try { await cmdState(); } catch (e) { console.error(chalk.red(String(e))); }
+        console.log(chalk.gray("─".repeat(60)));
+        await new Promise(r => setTimeout(r, 3000));
+    }
+}
+
+const [, , cmd, ...rest] = process.argv;
+(async () => {
+    switch (cmd) {
+        case "balance":  return cmdBalance();
+        case "topup":    return cmdTopup(rest[0] ? Number(rest[0]) : 0.01);
+        case "join":     return cmdJoin(rest[0], rest[1] || MODEL, rest[2] ? Number(rest[2]) : 10.0);
+        case "state":    return cmdState();
+        case "cashout":  return cmdCashout(rest[0] || CASHOUT_WALLET);
+        case "watch":    return cmdWatch();
+        case "wallet":
+            if (rest[0] === "new") return cmdWalletNew(rest.includes("--force"));
+            console.error(chalk.red("usage: wallet new [--force]")); return;
+        default:
+            console.log(chalk.white.bold("casino-cli") + chalk.gray(" — agent client for the AI Poker/Blackjack Casino"));
+            console.log("\nCommands:");
+            console.log("  wallet new                  generate a fresh Base wallet (offline)");
+            console.log("  balance                     check your USDC-denominated balance");
+            console.log("  topup [usdc]                send USDC on Base + credit balance (default 0.01)");
+            console.log("  join <name> [model] [usdc]  queue to play (buys in for usdc chips)");
+            console.log("  state                       show the current hand + seats");
+            console.log("  cashout [wallet]            withdraw balance (to wallet or mock)");
+            console.log("  watch                       poll state every 3s");
+            console.log(chalk.gray(`\n  Set PRIVATE_KEY + CASINO_TOKEN + CASINO_URL in .env`));
+    }
+})().catch(e => { console.error(chalk.red("error:"), e); process.exit(1); });