@gangfun/cli 0.0.0-stage → 0.1.3

package/README.md

@@ -1,3 +1,87 @@
-# Temporary Holding Version
+# Gang CLI (`gang`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Operate [gang.fun](https://gang.fun) from a Binance **Agentic Wallet**. Curve buys require a SPACE ID `.ai` Agent ID. This CLI builds calldata; `baw` signs — no keys in this package.
+
+Not an open-source product dump: install and run steps only.
+
+## Install
+
+Node ≥ 18. Also install Binance Agentic Wallet CLI (`baw`):
+
+```bash
+npm i -g @binance/agentic-wallet
+npm i -g @gangfun/cli@0.1.3 --registry=https://npm.pkg.github.com
+```
+
+Package: [GitHub Packages `@gangfun/cli`](https://github.com/gangfun/cli/pkgs/npm/cli). GitHub Packages needs auth — one-liner: `npm login --registry=https://npm.pkg.github.com` (use a token with `read:packages`). Or put the token in `~/.npmrc` (or `NODE_AUTH_TOKEN`):
+
+```ini
+@gangfun:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+```
+
+Then you can omit the `--registry` flag: `npm i -g @gangfun/cli@0.1.3`.
+
+**Alternate** (no Packages token; installs from the public git repo `main` tip = `@gangfun/cli@0.1.3` / Launchpad v4.1):
+
+```bash
+npm i -g github:gangfun/cli
+# or one-shot:
+npx --yes github:gangfun/cli preflight
+```
+
+If a previous global is stale, clear it then reinstall:
+
+```bash
+npm uninstall -g @gangfun/cli
+npm i -g github:gangfun/cli
+```
+
+After install, run `gang preflight` — Launchpad must be `0x315Ba2e8952D06094CC636b2B84229FA32fb23A7` (v4.1). If you still see `0x86854…dDcc`, the old global is still in use; uninstall and reinstall.
+
+Skill install (Claude Code / Cursor / Codex / OpenClaw / Binance AI Pro):
+
+```bash
+npx skills add gangfun/gang-launchpad/skill
+```
+
+## Setup
+
+1. Binance App → Wallet → Agentic Wallet → create; claim a `.ai` Agent ID.
+2. Enable **Developer Mode** and **Trade all tokens**.
+3. `baw auth signin` → confirm in the App.
+4. `gang preflight`
+
+## Commands
+
+```bash
+gang preflight
+gang list
+gang token --token <addr>
+gang quote --token <addr> --bnb <n>
+gang buy --token <addr> --bnb <n> [--slippage 1]
+gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1]
+gang create --name <n> --symbol <s>
+gang execute --request-id <id>
+gang tx --hash <0x..>
+```
+
+Buy / sell / create: **preview → you confirm → execute**. `requestId` expires in ~5 minutes. Sells may need App confirmation.
+
+## Rules (short)
+
+- 1% per-wallet cap on the curve; excess BNB refunded in-tx.
+- 20 BNB → graduate to PancakeSwap V2, LP burned.
+- Before graduation: no transfers, curve only.
+- Graduated: trade on PancakeSwap (`pair` from `gang token`).
+
+## Env
+
+| Var | Meaning |
+|---|---|
+| `GANG_LAUNCHPAD` | Launchpad address (default v4.1 `0x315Ba2e8952D06094CC636b2B84229FA32fb23A7`; override via env) |
+| `GANG_RPC_URL` | BSC HTTP RPC |
+
+## Version
+
+`0.1.3` · repo [gangfun/cli](https://github.com/gangfun/cli) · distribute via [GitHub Packages](https://github.com/gangfun/cli/pkgs/npm/cli) (not npmjs)

package/README.zh-CN.md

@@ -0,0 +1,87 @@
+# Gang CLI（`gang`）
+
+用 Binance **Agentic Wallet** 操作 [gang.fun](https://gang.fun)。内盘买入需要 SPACE ID `.ai` Agent ID。本 CLI 只组 calldata，签名走 `baw`，不持有私钥。
+
+这里只写操作步骤，不是开源说明书。
+
+## 安装
+
+Node ≥ 18。另需安装 Binance Agentic Wallet CLI（`baw`）：
+
+```bash
+npm i -g @binance/agentic-wallet
+npm i -g @gangfun/cli@0.1.3 --registry=https://npm.pkg.github.com
+```
+
+包地址：[GitHub Packages `@gangfun/cli`](https://github.com/gangfun/cli/pkgs/npm/cli)。GitHub Packages 需要登录——一句：`npm login --registry=https://npm.pkg.github.com`（token 需带 `read:packages`）。或把 token 写进 `~/.npmrc`（或环境变量 `NODE_AUTH_TOKEN`）：
+
+```ini
+@gangfun:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+```
+
+配好后可省略 `--registry`：`npm i -g @gangfun/cli@0.1.3`。
+
+**备选**（不需要 Packages token；从公开 git 仓 `main` tip 装 = `@gangfun/cli@0.1.3` / Launchpad v4.1）：
+
+```bash
+npm i -g github:gangfun/cli
+# 或一次性：
+npx --yes github:gangfun/cli preflight
+```
+
+若之前装过旧全局包，先卸再装：
+
+```bash
+npm uninstall -g @gangfun/cli
+npm i -g github:gangfun/cli
+```
+
+装完跑 `gang preflight`——Launchpad 必须是 `0x315Ba2e8952D06094CC636b2B84229FA32fb23A7`（v4.1）。若仍看到 `0x86854…dDcc`，说明旧全局还在，卸掉重装。
+
+Skill（Claude Code / Cursor / Codex / OpenClaw / Binance AI Pro）：
+
+```bash
+npx skills add gangfun/gang-launchpad/skill
+```
+
+## 准备
+
+1. Binance App → 钱包 → Agentic Wallet → 创建；领取 `.ai` Agent ID。
+2. 打开 **Developer Mode** 和 **Trade all tokens**。
+3. `baw auth signin`，在 App 确认。
+4. `gang preflight`
+
+## 命令
+
+```bash
+gang preflight
+gang list
+gang token --token <addr>
+gang quote --token <addr> --bnb <n>
+gang buy --token <addr> --bnb <n> [--slippage 1]
+gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1]
+gang create --name <n> --symbol <s>
+gang execute --request-id <id>
+gang tx --hash <0x..>
+```
+
+买 / 卖 / 发币：**预览 → 你确认 → execute**。`requestId` 约 5 分钟过期。卖出可能要在 App 里点确认。
+
+## 规则（短）
+
+- 内盘每钱包 1% 上限；多付的 BNB 同笔退回。
+- 筹满 20 BNB → 毕业到 PancakeSwap V2，LP 销毁。
+- 毕业前不可转账，只能走曲线。
+- 已毕业：去 PancakeSwap（`gang token` 里的 `pair`）。
+
+## 环境变量
+
+| 变量 | 含义 |
+|---|---|
+| `GANG_LAUNCHPAD` | Launchpad 地址（默认 v4.1 `0x315Ba2e8952D06094CC636b2B84229FA32fb23A7`；可用环境变量覆盖） |
+| `GANG_RPC_URL` | BSC HTTP RPC |
+
+## 版本
+
+`0.1.3` · 仓库 [gangfun/cli](https://github.com/gangfun/cli) · 分发走 [GitHub Packages](https://github.com/gangfun/cli/pkgs/npm/cli)（不上 npmjs）

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@gangfun/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.3",
+  "description": "Gang launchpad CLI for Binance Agentic Wallet agents: list, quote, buy, sell, create on the agent-only bonding curve.",
+  "type": "module",
+  "bin": {
+    "gang": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gangfun/cli.git"
+  },
+  "homepage": "https://gang.fun",
+  "bugs": {
+    "url": "https://github.com/gangfun/cli/issues"
+  },
+  "keywords": [
+    "gang",
+    "gang.fun",
+    "bnb",
+    "bsc",
+    "launchpad",
+    "bonding-curve",
+    "binance",
+    "agentic-wallet",
+    "agent-id"
+  ],
+  "dependencies": {
+    "viem": "^2.0.0"
+  }
+}

package/src/abi.js

@@ -0,0 +1,30 @@
+export const LAUNCHPAD_ABI = [
+  { type: 'function', name: 'create', stateMutability: 'nonpayable', inputs: [{ name: 'name', type: 'string' }, { name: 'symbol', type: 'string' }], outputs: [{ type: 'address' }] },
+  { type: 'function', name: 'buy', stateMutability: 'payable', inputs: [{ name: 'token', type: 'address' }, { name: 'minTokensOut', type: 'uint256' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'withdraw', stateMutability: 'nonpayable', inputs: [], outputs: [] },
+  { type: 'function', name: 'pendingWithdrawals', stateMutability: 'view', inputs: [{ type: 'address' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'sell', stateMutability: 'nonpayable', inputs: [{ name: 'token', type: 'address' }, { name: 'tokensIn', type: 'uint256' }, { name: 'minBnbOut', type: 'uint256' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'quoteBuy', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }, { name: 'buyer', type: 'address' }, { name: 'bnbGross', type: 'uint256' }], outputs: [{ name: 'tokensOut', type: 'uint256' }, { name: 'bnbIn', type: 'uint256' }, { name: 'fee', type: 'uint256' }, { name: 'refund', type: 'uint256' }] },
+  { type: 'function', name: 'quoteSell', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }, { name: 'tokensIn', type: 'uint256' }], outputs: [{ name: 'bnbToUser', type: 'uint256' }, { name: 'fee', type: 'uint256' }] },
+  { type: 'function', name: 'curves', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }], outputs: [{ name: 'creator', type: 'address' }, { name: 'realBnb', type: 'uint128' }, { name: 'sold', type: 'uint128' }, { name: 'graduated', type: 'bool' }, { name: 'pair', type: 'address' }] },
+  { type: 'function', name: 'allTokens', stateMutability: 'view', inputs: [{ type: 'uint256' }], outputs: [{ type: 'address' }] },
+  { type: 'function', name: 'tokenCount', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'spotPrice', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'isAgent', stateMutability: 'view', inputs: [{ name: 'account', type: 'address' }], outputs: [{ type: 'bool' }] },
+  { type: 'function', name: 'walletRoom', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }, { name: 'buyer', type: 'address' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'GRADUATION_BNB', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'MAX_PER_WALLET', stateMutability: 'view', inputs: [], outputs: [{ type: 'uint256' }] },
+  { type: 'event', name: 'Created', inputs: [{ name: 'token', type: 'address', indexed: true }, { name: 'creator', type: 'address', indexed: true }, { name: 'name', type: 'string', indexed: false }, { name: 'symbol', type: 'string', indexed: false }] },
+  { type: 'event', name: 'Buy', inputs: [{ name: 'token', type: 'address', indexed: true }, { name: 'buyer', type: 'address', indexed: true }, { name: 'bnbIn', type: 'uint256', indexed: false }, { name: 'fee', type: 'uint256', indexed: false }, { name: 'tokensOut', type: 'uint256', indexed: false }, { name: 'realBnb', type: 'uint256', indexed: false }] },
+  { type: 'event', name: 'Sell', inputs: [{ name: 'token', type: 'address', indexed: true }, { name: 'seller', type: 'address', indexed: true }, { name: 'tokensIn', type: 'uint256', indexed: false }, { name: 'fee', type: 'uint256', indexed: false }, { name: 'bnbOut', type: 'uint256', indexed: false }, { name: 'realBnb', type: 'uint256', indexed: false }] },
+  { type: 'event', name: 'Graduated', inputs: [{ name: 'token', type: 'address', indexed: true }, { name: 'pair', type: 'address', indexed: true }, { name: 'tokenAmount', type: 'uint256', indexed: false }, { name: 'bnbAmount', type: 'uint256', indexed: false }] },
+]
+
+export const ERC20_ABI = [
+  { type: 'function', name: 'name', stateMutability: 'view', inputs: [], outputs: [{ type: 'string' }] },
+  { type: 'function', name: 'symbol', stateMutability: 'view', inputs: [], outputs: [{ type: 'string' }] },
+  { type: 'function', name: 'balanceOf', stateMutability: 'view', inputs: [{ type: 'address' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'allowance', stateMutability: 'view', inputs: [{ type: 'address' }, { type: 'address' }], outputs: [{ type: 'uint256' }] },
+  { type: 'function', name: 'approve', stateMutability: 'nonpayable', inputs: [{ type: 'address' }, { type: 'uint256' }], outputs: [{ type: 'bool' }] },
+  { type: 'function', name: 'locked', stateMutability: 'view', inputs: [], outputs: [{ type: 'bool' }] },
+]

package/src/baw.js

@@ -0,0 +1,41 @@
+import { execFileSync } from 'node:child_process'
+
+/** Run a `baw` command and parse its --json output. Throws with the CLI's error payload on failure. */
+export function baw(args) {
+  let out
+  try {
+    out = execFileSync('baw', [...args, '--json'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], maxBuffer: 8 << 20 })
+  } catch (e) {
+    const text = (e.stdout || '') + (e.stderr || '')
+    try { return JSON.parse(e.stdout) } catch { throw new Error(`baw ${args[0]} failed: ${text.trim() || e.message}`) }
+  }
+  return JSON.parse(out)
+}
+
+export function bawAddress(chainId = '56') {
+  const r = baw(['wallet', 'address'])
+  if (!r.success) throw new Error(JSON.stringify(r.error))
+  const a = r.data.addresses.find((x) => x.binanceChainId === chainId)
+  if (!a) throw new Error(`Agentic Wallet has no address on chain ${chainId}`)
+  return a.address
+}
+
+export function bawSettings() {
+  const r = baw(['wallet', 'settings'])
+  if (!r.success) throw new Error(JSON.stringify(r.error))
+  return r.data
+}
+
+export function bawStatus() {
+  const r = baw(['wallet', 'status'])
+  return r.success ? r.data.status : 'UNCONNECTED'
+}
+
+/** Preview an external contract call through Binance's risk engine. */
+export function bawPreview({ from, to, value = 0n, data = '0x', chainId = '56' }) {
+  return baw(['contract-call', 'preview', '--binanceChainId', chainId, '--from', from, '--to', to, '--value', value.toString(), '--inputData', data])
+}
+
+export function bawExecute(requestId) {
+  return baw(['contract-call', 'execute', '--requestId', requestId])
+}

package/src/chain.js

@@ -0,0 +1,89 @@
+import { createPublicClient, http, formatEther, parseEther, encodeFunctionData, decodeEventLog } from 'viem'
+import { bsc } from 'viem/chains'
+import { LAUNCHPAD_ABI, ERC20_ABI } from './abi.js'
+
+export const CONFIG = {
+  rpc: process.env.GANG_RPC_URL || 'https://bsc-dataseed.binance.org',
+  launchpad: process.env.GANG_LAUNCHPAD || '0x315Ba2e8952D06094CC636b2B84229FA32fb23A7',
+  chainId: '56',
+}
+
+export const client = createPublicClient({ chain: bsc, transport: http(CONFIG.rpc) })
+const pad = (functionName, args = []) => client.readContract({ address: CONFIG.launchpad, abi: LAUNCHPAD_ABI, functionName, args })
+const erc = (address, functionName, args = []) => client.readContract({ address, abi: ERC20_ABI, functionName, args })
+
+export const fmt = (wei) => formatEther(wei)
+export const fmtTok = (units) => Number(formatEther(units)).toLocaleString('en-US', { maximumFractionDigits: 2 })
+export { parseEther, encodeFunctionData }
+
+export async function tokenInfo(token, me) {
+  const [c, name, symbol, locked, grad, cap] = await Promise.all([
+    pad('curves', [token]), erc(token, 'name'), erc(token, 'symbol'), erc(token, 'locked'),
+    pad('GRADUATION_BNB'), pad('MAX_PER_WALLET'),
+  ])
+  const [creator, realBnb, sold, graduated, pair] = c
+  if (creator === '0x0000000000000000000000000000000000000000') {
+    throw new Error(
+      `not a Gang token: ${token} (launchpad ${CONFIG.launchpad}). ` +
+      `Upgrade: npm i -g @gangfun/cli@0.1.3 --registry=https://npm.pkg.github.com  OR  ` +
+      `export GANG_LAUNCHPAD=0x315Ba2e8952D06094CC636b2B84229FA32fb23A7`
+    )
+  }
+  // curve end price (1e-7 BNB) for graduated tokens; live spot otherwise
+  const price = graduated ? 100000000000n : await pad('spotPrice', [token])
+  const info = {
+    token, name, symbol, creator, graduated, pair: graduated ? pair : null, locked,
+    priceBnb: Number(price) / 1e18,
+    fdvBnb: (Number(price) / 1e18) * 1e9,
+    raisedBnb: fmt(realBnb), graduationBnb: fmt(grad),
+    progressPct: Number((realBnb * 10000n) / grad) / 100,
+    soldTokens: fmtTok(sold), walletCapTokens: fmtTok(cap),
+  }
+  if (me) {
+    const [bal, room] = await Promise.all([erc(token, 'balanceOf', [me]), pad('walletRoom', [token, me])])
+    info.myBalance = fmtTok(bal); info.myBalanceRaw = bal.toString(); info.myRoomTokens = fmtTok(room); info.myRoomRaw = room.toString()
+  }
+  return info
+}
+
+export async function listTokens(me) {
+  const n = await pad('tokenCount')
+  const addrs = await Promise.all(Array.from({ length: Number(n) }, (_, i) => pad('allTokens', [BigInt(i)])))
+  return Promise.all(addrs.map((a) => tokenInfo(a, me)))
+}
+
+export async function quoteBuy(token, buyer, bnb) {
+  const gross = parseEther(bnb)
+  const [tokensOut, bnbIn, fee, refund] = await pad('quoteBuy', [token, buyer, gross])
+  return { bnbGross: bnb, tokensOut, bnbIn, fee, refund, tokensOutFmt: fmtTok(tokensOut), bnbInFmt: fmt(bnbIn), feeFmt: fmt(fee), refundFmt: fmt(refund) }
+}
+
+export async function quoteSell(token, tokensIn) {
+  const [bnbToUser, fee] = await pad('quoteSell', [token, tokensIn])
+  return { tokensIn, bnbToUser, fee, tokensInFmt: fmtTok(tokensIn), bnbToUserFmt: fmt(bnbToUser), feeFmt: fmt(fee) }
+}
+
+export const isAgent = (a) => pad('isAgent', [a])
+export const balanceOf = (token, a) => erc(token, 'balanceOf', [a])
+export const allowance = (token, a) => erc(token, 'allowance', [a, CONFIG.launchpad])
+
+export const calldata = {
+  buy: (token, minTokensOut) => encodeFunctionData({ abi: LAUNCHPAD_ABI, functionName: 'buy', args: [token, minTokensOut] }),
+  sell: (token, tokensIn, minBnbOut) => encodeFunctionData({ abi: LAUNCHPAD_ABI, functionName: 'sell', args: [token, tokensIn, minBnbOut] }),
+  approve: (amount) => encodeFunctionData({ abi: ERC20_ABI, functionName: 'approve', args: [CONFIG.launchpad, amount] }),
+  create: (name, symbol) => encodeFunctionData({ abi: LAUNCHPAD_ABI, functionName: 'create', args: [name, symbol] }),
+}
+
+export async function decodeTx(hash) {
+  const r = await client.waitForTransactionReceipt({ hash, timeout: 120_000 })
+  const events = []
+  for (const log of r.logs) {
+    if (log.address.toLowerCase() !== CONFIG.launchpad.toLowerCase()) continue
+    try {
+      const ev = decodeEventLog({ abi: LAUNCHPAD_ABI, data: log.data, topics: log.topics })
+      const a = Object.fromEntries(Object.entries(ev.args).map(([k, v]) => [k, typeof v === 'bigint' ? (k.toLowerCase().includes('token') && k !== 'token' ? fmtTok(v) : fmt(v)) : v]))
+      events.push({ event: ev.eventName, ...a })
+    } catch { /* not ours */ }
+  }
+  return { hash, status: r.status, block: Number(r.blockNumber), events }
+}

package/src/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { CONFIG, listTokens, tokenInfo, quoteBuy, quoteSell, isAgent, balanceOf, allowance, calldata, decodeTx, parseEther, fmt, fmtTok } from './chain.js'
+import { bawAddress, bawSettings, bawStatus, bawPreview, bawExecute } from './baw.js'
+
+const args = process.argv.slice(2)
+const cmd = args[0]
+const opt = (name, def) => { const i = args.indexOf(`--${name}`); return i >= 0 ? args[i + 1] : def }
+const flag = (name) => args.includes(`--${name}`)
+const out = (o) => console.log(JSON.stringify(o, (_, v) => (typeof v === 'bigint' ? v.toString() : v), 2))
+const fail = (msg, extra = {}) => { out({ success: false, error: msg, ...extra }); process.exit(1) }
+
+const parseSlippage = (raw) => {
+  const s = Number(raw)
+  if (!Number.isFinite(s) || s < 0 || s > 50) fail('--slippage must be a number between 0 and 50', { got: raw })
+  return s
+}
+
+const HELP = `gang — agent-only launchpad on BNB Chain (Binance Agentic Wallet)
+
+  gang preflight                         check sign-in, Developer Mode, tradeAllTokens, Agent ID
+  gang list                              all tokens with price, progress, my balance
+  gang token --token <addr>              one token in detail
+  gang quote --token <addr> --bnb <n>    buy quote for my wallet (fee, cap, refund)
+  gang buy --token <addr> --bnb <n> [--slippage 1]      preview a buy  -> requestId
+  gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1]  preview approve or sell -> requestId
+  gang create --name <n> --symbol <s>    preview token creation -> requestId
+  gang execute --request-id <id>         broadcast a previewed call
+  gang tx --hash <0x..>                  wait for receipt and decode Gang events
+
+env: GANG_LAUNCHPAD (default ${CONFIG.launchpad}), GANG_RPC_URL`
+
+function summarizePreview(p, extra = {}) {
+  if (!p.success) return { success: false, step: extra.step, error: p.error }
+  const d = p.data
+  const changes = (d.simulationResult?.balanceChanges || []).map((b) => ({ token: b.contractAddress, type: b.tokenType, change: b.change }))
+  return {
+    success: true, ...extra,
+    requestId: d.requestId, expiresAt: d.expiresAt,
+    requireConfirmation: d.requireConfirmation,
+    risks: d.risks?.riskDetails || [],
+    simulatedChanges: changes,
+    next: `gang execute --request-id ${d.requestId}`,
+  }
+}
+
+async function main() {
+  switch (cmd) {
+    case 'preflight': {
+      const issues = []
+      const status = bawStatus()
+      if (status !== 'CONNECTED') issues.push({ code: 'NOT_SIGNED_IN', fix: 'Run `baw auth signin` and confirm in the Binance App.' })
+      let me = null, settings = null, agent = false
+      if (status === 'CONNECTED') {
+        me = bawAddress(); settings = bawSettings()
+        if (!settings.devMode?.enabled) issues.push({ code: 'DEV_MODE_OFF', fix: 'Enable Developer Mode in Binance App → Agentic Wallet settings.' })
+        if (!settings.tradeAllTokens) issues.push({ code: 'TRADE_ALL_TOKENS_OFF', fix: 'Enable "Trade all tokens" in Binance App → Agentic Wallet settings, otherwise SELLING Gang tokens is blocked by risk control (buying still works).' })
+        agent = await isAgent(me)
+        if (!agent) issues.push({ code: 'NO_AGENT_ID', fix: 'Claim a .ai Agent ID in Binance Wallet (Agent ID banner). Gang only lets Agent ID holders buy.' })
+      }
+      return out({ success: issues.length === 0, status, address: me, launchpad: CONFIG.launchpad, isAgent: agent, devMode: settings?.devMode?.enabled ?? null, tradeAllTokens: settings?.tradeAllTokens ?? null, issues })
+    }
+    case 'list': {
+      const me = bawStatus() === 'CONNECTED' ? bawAddress() : undefined
+      return out({ success: true, launchpad: CONFIG.launchpad, tokens: await listTokens(me) })
+    }
+    case 'token': {
+      const token = opt('token'); if (!token) fail('--token required')
+      const me = bawStatus() === 'CONNECTED' ? bawAddress() : undefined
+      return out({ success: true, ...(await tokenInfo(token, me)) })
+    }
+    case 'quote': {
+      const token = opt('token'), bnb = opt('bnb'); if (!token || !bnb) fail('--token and --bnb required')
+      const me = bawAddress()
+      const q = await quoteBuy(token, me, bnb)
+      return out({ success: true, token, buyer: me, tokensOut: q.tokensOutFmt, bnbSpent: q.bnbInFmt, fee: q.feeFmt, refund: q.refundFmt, note: q.refund > 0n ? 'Part of the BNB would be refunded (wallet 1% cap or graduation cap).' : undefined })
+    }
+    case 'buy': {
+      const token = opt('token'), bnb = opt('bnb'); if (!token || !bnb) fail('--token and --bnb required')
+      const slippage = parseSlippage(opt('slippage', '1'))
+      const me = bawAddress()
+      const info = await tokenInfo(token, me)
+      if (info.graduated) fail('token already graduated; trade it on PancakeSwap', { pair: info.pair })
+      if (!(await isAgent(me))) fail('this wallet holds no Agent ID (.ai); buying is gated', { address: me })
+      const q = await quoteBuy(token, me, bnb)
+      if (q.tokensOut === 0n) fail('wallet cap reached: this wallet already holds 1% of supply', { myBalance: info.myBalance })
+      const minOut = (q.tokensOut * BigInt(Math.round((100 - slippage) * 100))) / 10000n
+      const data = calldata.buy(token, minOut)
+      const p = bawPreview({ from: me, to: CONFIG.launchpad, value: parseEther(bnb), data })
+      return out(summarizePreview(p, { step: 'buy', token, symbol: info.symbol, bnbSent: bnb, expectTokens: q.tokensOutFmt, expectBnbSpent: q.bnbInFmt, fee: q.feeFmt, expectRefund: q.refundFmt, minTokensOut: fmtTok(minOut) }))
+    }
+    case 'sell': {
+      const token = opt('token'); if (!token) fail('--token required')
+      const me = bawAddress()
+      const info = await tokenInfo(token, me)
+      if (info.graduated) fail('token already graduated; sell on PancakeSwap', { pair: info.pair })
+      const bal = await balanceOf(token, me)
+      if (bal === 0n) fail('no balance to sell')
+      if (!flag('all') && !opt('amount')) fail('pass --amount <tokens> or --all (full sell is no longer the default)')
+      if (flag('all') && opt('amount')) fail('use either --all or --amount, not both')
+      const amount = flag('all') ? bal : parseEther(opt('amount'))
+      if (amount > bal) fail('amount exceeds balance', { balance: fmtTok(bal) })
+      const allow = await allowance(token, me)
+      if (allow < amount) {
+        const p = bawPreview({ from: me, to: token, data: calldata.approve(amount) })
+        return out(summarizePreview(p, { step: 'approve', token, symbol: info.symbol, amount: fmtTok(amount), note: 'Approve first. After it confirms on-chain, run the same `gang sell` again to preview the sell.' }))
+      }
+      const slippage = parseSlippage(opt('slippage', '1'))
+      const q = await quoteSell(token, amount)
+      const minOut = (q.bnbToUser * BigInt(Math.round((100 - slippage) * 100))) / 10000n
+      const p = bawPreview({ from: me, to: CONFIG.launchpad, data: calldata.sell(token, amount, minOut) })
+      return out(summarizePreview(p, { step: 'sell', token, symbol: info.symbol, amount: fmtTok(amount), expectBnb: q.bnbToUserFmt, fee: q.feeFmt, minBnbOut: fmt(minOut) }))
+    }
+    case 'create': {
+      const name = opt('name'), symbol = opt('symbol'); if (!name || !symbol) fail('--name and --symbol required')
+      const me = bawAddress()
+      const p = bawPreview({ from: me, to: CONFIG.launchpad, data: calldata.create(name, symbol) })
+      return out(summarizePreview(p, { step: 'create', name, symbol, note: 'No creation fee. The token address appears in the Created event: run `gang tx --hash <txHash>` after execute.' }))
+    }
+    case 'execute': {
+      const id = opt('request-id'); if (!id) fail('--request-id required')
+      const r = bawExecute(id)
+      if (!r.success) return out({ success: false, error: r.error })
+      const d = r.data
+      const pending = d.status === 'PENDING_CONFIRMATION'
+      return out({ success: true, status: d.status, txHash: d.txHash, orderId: d.orderId, pendingConfirmation: pending, next: pending ? 'Ask the user to approve this transaction in the Binance App, then poll `baw wallet tx-history --binanceChainId 56 --type confirmed --json` for the tx hash and run `gang tx --hash <hash>`.' : (d.txHash ? `gang tx --hash ${d.txHash}` : undefined) })
+    }
+    case 'tx': {
+      const hash = opt('hash'); if (!hash) fail('--hash required')
+      return out({ success: true, ...(await decodeTx(hash)) })
+    }
+    default:
+      console.log(HELP); process.exit(cmd ? 1 : 0)
+  }
+}
+
+main().catch((e) => fail(e.message))