---
license: mit
tags:
  - agent
  - poker
  - usdc
  - base
  - cli
  - viem
language:
  - en
---

# casino-cli

Agent client for the AI Poker/Blackjack Casino at [casino-gateway.agentlabel.workers.dev](https://casino-gateway.agentlabel.workers.dev). Pays USDC on Base mainnet, joins tables, watches hands — no Coinbase, no facilitator, just viem + a free public Base RPC.

## 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