@gangfun/cli 0.8.0 → 0.9.1

package/README.md

@@ -2,7 +2,9 @@
 
 Operate [gang.fun](https://gang.fun) from a Binance **Agentic Wallet**. Curve buys/creates require a SPACE ID `.ai` Agent ID. This CLI builds calldata; `baw` signs — no keys in this package.
 
-**Create path (0.2.1+):** LaunchpadV2 only (`0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E`). Soft / LaunchpadU / LaunchpadS: **no new create** — buy/sell/claim existing tokens only. New tokens graduate at ≈ **15 BNB** (PoolCheck). Soft archive tokens still graduate at 20 BNB on-chain.
+**`gang create` (0.2.1+):** LaunchpadV2 only (`0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E`). Soft / LaunchpadU / LaunchpadS: **no new create** — buy/sell/claim existing tokens only. New tokens graduate at ≈ **15 BNB** (PoolCheck). Soft archive tokens still graduate at 20 BNB on-chain.
+
+**V3 tax tokens and 打新 (0.9.0+):** `gang v3` / `gang fair` on GangLaunchpad, live on BSC mainnet since 2026-10-27 (pad `0x15CFD2dc8278Fb87a1783ef42111618E20874365`, GangRouter `0xE040445690Aa56C8b68B7f7038C7b2562B5079C4`, both built in); `--testnet` uses BSC testnet set 10.
 
 ## Install
 
@@ -53,6 +55,26 @@ gang follow <note tx> --bnb <n> [--slippage 1] [--note …]   # buy the token a
 gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1] [--note … [--conf …] [--reveal-after …]]
 gang upload-logo (--file ./avatar.png | --url <image URL>)   # → https://gang.fun/api/logos/<id>.png
 gang create --name <n> --symbol <s> [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--taxed] [--quote 0x… --ref-pool 0x…] [--note … [--conf …] [--reveal-after …]]
+# 打新 (fair mint) and V3 share one pad (GangLaunchpad). Mainnet by default (address built in); --testnet = BSC testnet set 10
+gang fair create --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60] [--mint-fee 1] [--exit-fee 1] [--shares 1] [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
+#   --cap 0.25–1% of supply per wallet (1% → at least 50 wallets), --hold 60–90% (the hold line)
+gang fair mint --token <addr> --shares <n> [--testnet]           # + the sale's mint fee (1–3%, the platform's)
+gang fair withdraw --token <addr> (--shares <n> | --all) [--testnet]
+gang fair buy --token <addr> --amount <n> [--use-quote | --pay-bnb] [--testnet]        # after launch: PancakeSwap via GangRouter
+gang fair sell --token <addr> (--amount <tokens> | --all) [--to-bnb] [--confirm-out] [--testnet]  # after launch; past sellableBeforeOut needs --confirm-out
+gang fair status --token <addr> [--testnet]                      # shares; after launch: reward on / out, sellable, to claim
+gang fair claim --token <addr> [--testnet]
+gang fair info --token <addr> | gang fair list [--status minting|launched|all] | gang fair tx --hash <0x..>  # lookups ([--testnet])
+# LaunchpadV3 tax token (own buy / sell tax 1–5%, pool only, paid to the creator itself or a whitelisted recipient, in the quote) — same pad as 打新
+gang v3 create --name <n> --symbol <s> --buy-tax 2 --sell-tax 2 [--dividend 0] --recipient 0x… [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
+gang v3 buy --token <addr> --amount <quote> [--testnet]           # includes the 1% curve fee (no tax on the curve; the tax is pool-only)
+gang v3 sell --token <addr> (--amount <tokens> | --all) [--to-bnb] [--testnet]  # graduated: buy / sell go to PancakeSwap via GangRouter
+gang v3 info --token <addr> [--testnet]                           # tax setting, recipient, what is still owed to it
+gang v3 status --token <addr> [--testnet]                         # my balance and dividend: claimable now + credited, not sold yet
+gang v3 claim --token <addr> [--testnet]                          # claim my dividend (in the quote token)
+gang v3 release --token <addr> [--testnet]                        # push a payment that failed earlier
+gang v3 income --recipient 0x…                                  # a recipient's income per token (gang.fun)
+gang v3 list [--status curve|graduated|all] | gang v3 tx --hash <0x..>  # lookups ([--testnet])
 gang execute --request-id <id>
 gang tx --hash <0x..>
 ```
@@ -162,7 +184,13 @@ gang agents --window 30d --sort follow
 - **New** creates → ≈15 BNB graduation (LaunchpadV2 / PoolCheck) → PancakeSwap V2, LP burned.
 - Soft legacy (archive): 20 BNB graduation; buy/sell only — no Soft create from this CLI.
 - Before graduation: no transfers, curve only.
-- Graduated: trade on PancakeSwap (`pair` from `gang token`).
+- Graduated: `gang buy` / `gang sell` (and `gang v3 buy|sell`, `gang fair buy|sell` after launch) trade in the PancakeSwap
+  pool through GangRouter: approve this amount only first, then `poolBuy` / `poolBuyBNB` / `poolSell` / `poolSellForBNB`
+  with a minimum from `getAmountsOut` (buy, less the buy tax) or the tax handler's `previewSellNextBlock` (sell), less
+  `--slippage`. `--use-quote` / `--pay-bnb` pick what a buy pays with, `--to-bnb` sells for BNB. A taxed sell needs about
+  700k gas (it also sells one chunk of the held tax): let the wallet estimate, or give at least 750k.
+  The router is checked first (a GangRouter with pool trades, never Pancake or an old router); `--from` works only on
+  these pool trades. Details: `references/v3.md` ("Pool trades").
 
 ## Env
 
@@ -175,7 +203,10 @@ gang agents --window 30d --sort follow
 | `GANG_NOTES_DIR` | Local note queue, one file per note: salt and send status, kept 24h (default `~/.gang/notes`); `previews/` in it records what each trade preview carried (note, follow) for `gang execute`, also kept 24h |
 | `GANG_UPDATE_CHECK` | `0` turns off the once-a-day check for a newer CLI on npm (cached in `~/.gang/update.json`) |
 | `GANG_UPDATE_URL` | Where that check asks, default `https://registry.npmjs.org/@gangfun/cli/latest`; set an npm mirror's `…/@gangfun/cli/latest` if npmjs is slow or blocked |
+| `GANG_PAD` / `GANG_TESTNET_PAD` | Override the merged GangLaunchpad (mainnet / testnet) behind both `gang v3` and `gang fair` (defaults: mainnet `0x15CF…4365`, testnet set 10 `0xFebF…5BB1`). Old names `GANG_V3_PAD` / `GANG_FAIR_PAD`, `GANG_V3_TESTNET_PAD` / `GANG_FAIR_TESTNET_PAD` still work as aliases |
+| `GANG_TESTNET_RPC_URL` | Testnet RPC; old names `GANG_V3_TESTNET_RPC_URL` / `GANG_FAIR_TESTNET_RPC_URL` still work |
+| `GANG_ROUTER` / `GANG_TESTNET_ROUTER` | GangRouter proxy (native-BNB V3 buys / mints, and every PancakeSwap trade of a graduated token); old name `GANG_ROUTER_TESTNET` still works. Defaults: mainnet `0xE040…79C4`, testnet set 10 `0x6bB6…C9F6` |
 
 ## Version
 
-`0.8.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
+`0.9.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main` (0.9.0 not yet: npm has 0.8.0)

package/README.zh-CN.md

@@ -2,7 +2,9 @@
 
 用 Binance **Agentic Wallet** 操作 [gang.fun](https://gang.fun)。内盘买入/发币需要 SPACE ID `.ai` Agent ID。本 CLI 只组 calldata，签名走 `baw`，不持有私钥。
 
-**发币路径（0.2.1+）：** 仅 LaunchpadV2（`0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E`）。Soft / LaunchpadU / LaunchpadS：**禁止新 create**，仅存量 buy/sell/claim。新币毕业 ≈ **15 BNB**（PoolCheck）。Soft 存量链上仍为 20 BNB 毕业。
+**`gang create`（0.2.1+）：** 仅 LaunchpadV2（`0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E`）。Soft / LaunchpadU / LaunchpadS：**禁止新 create**，仅存量 buy/sell/claim。新币毕业 ≈ **15 BNB**（PoolCheck）。Soft 存量链上仍为 20 BNB 毕业。
+
+**V3 税收币和打新（0.9.0+）：** `gang v3` / `gang fair` 走 GangLaunchpad，2026-10-27 起在 BSC 主网运行（内盘 `0x15CFD2dc8278Fb87a1783ef42111618E20874365`，GangRouter `0xE040445690Aa56C8b68B7f7038C7b2562B5079C4`，都已内置）；`--testnet` 走 BSC 测试网第 10 套。
 
 ## 安装
 
@@ -43,6 +45,26 @@ gang follow <附言 tx> --bnb <n> [--slippage 1] [--note …]   # 跟单：买
 gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1] [--note … [--conf …] [--reveal-after …]]
 gang upload-logo (--file ./avatar.png | --url <图片地址>)
 gang create --name <n> --symbol <s> [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--taxed] [--quote 0x… --ref-pool 0x…] [--note … [--conf …] [--reveal-after …]]
+# 打新和 V3 共用一个内盘合约（GangLaunchpad）。默认走主网（地址已内置）；--testnet 走 BSC 测试网第 10 套
+gang fair create --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60] [--mint-fee 1] [--exit-fee 1] [--shares 1] [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
+#   --cap 单地址上限 0.25–1%（1% 时至少 50 个地址），--hold 出局线 60–90%
+gang fair mint --token <addr> --shares <n> [--testnet]           # 另收该币的打新费（1–3%，归平台、不退）
+gang fair withdraw --token <addr> (--shares <n> | --all) [--testnet]
+gang fair buy --token <addr> --amount <数量> [--use-quote | --pay-bnb] [--testnet]     # 发射后：经 GangRouter 在 PancakeSwap 买
+gang fair sell --token <addr> (--amount <枚数> | --all) [--to-bnb] [--confirm-out] [--testnet]  # 发射后；卖过 sellableBeforeOut 须加 --confirm-out
+gang fair status --token <addr> [--testnet]                      # 份数；发射后：是否出局、还能卖多少、待领奖励
+gang fair claim --token <addr> [--testnet]
+gang fair info --token <addr> | gang fair list [--status minting|launched|all] | gang fair tx --hash <0x..>  # 查询（可加 --testnet）
+# LaunchpadV3 税收币（买 / 卖税各 1–5%，只在外盘收，用报价币打给接收地址：发币人自己，或白名单里的合作方）— 和打新同一个内盘合约
+gang v3 create --name <n> --symbol <s> --buy-tax 2 --sell-tax 2 [--dividend 0] --recipient 0x… [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
+gang v3 buy --token <addr> --amount <报价币数量> [--testnet]      # 含内盘 1% 手续费（内盘不收税，税只在外盘收）
+gang v3 sell --token <addr> (--amount <枚数> | --all) [--to-bnb] [--testnet]  # 已毕业：buy / sell 经 GangRouter 走 PancakeSwap
+gang v3 info --token <addr> [--testnet]                           # 税率、接收地址、还欠接收地址多少
+gang v3 status --token <addr> [--testnet]                         # 我的持仓和分红：现在可领 + 已记账、还没卖出的部分
+gang v3 claim --token <addr> [--testnet]                          # 领取分红（以报价币到账）
+gang v3 release --token <addr> [--testnet]                        # 补转之前打款失败的税
+gang v3 income --recipient 0x…                                  # 接收地址按币统计的到账（读 gang.fun）
+gang v3 list [--status curve|graduated|all] | gang v3 tx --hash <0x..>  # 查询（可加 --testnet）
 gang execute --request-id <id>
 gang tx --hash <0x..>
 ```
@@ -138,7 +160,10 @@ gang agents --window 30d --sort follow
 
 - 内盘每钱包 1%；多付同笔退回。
 - **新**发币 ≈15 BNB 毕业（LaunchpadV2）。Soft 存量归档：20 BNB，仅买卖。
-- 毕业前不可转账；毕业后走 PancakeSwap。
+- 毕业前不可转账；毕业后走 PancakeSwap：`gang buy` / `gang sell`（以及 `gang v3 buy|sell`、发射后的 `gang fair buy|sell`）
+  经 GangRouter 在外盘成交。先只授权本次用量，再发 `poolBuy` / `poolBuyBNB` / `poolSell` / `poolSellForBNB`；最少到手：买入按
+  `getAmountsOut` 扣买入税，卖出按税 handler 的 `previewSellNextBlock`，再扣 `--slippage`。`--use-quote` / `--pay-bnb` 选买入用什么付，
+  `--to-bnb` 卖成 BNB。带税的卖出约需 70 万 gas（会顺带换一块税）：让钱包自动估算，或者至少给 75 万。生成任何步骤前先核对路由是带外盘功能的 GangRouter（不会是 Pancake 或旧路由）；`--from` 只对外盘交易生效。详见 `references/v3.md`「Pool trades」。
 
 ## 环境变量
 
@@ -151,7 +176,10 @@ gang agents --window 30d --sort follow
 | `GANG_NOTES_DIR` | 附言的本地队列，每条一个文件，记着 salt 和提交状态，保留 24 小时（默认 `~/.gang/notes`）；其中的 `previews/` 记着每次交易 preview 带了什么（附言、跟单），供 `gang execute` 使用，也保留 24 小时 |
 | `GANG_UPDATE_CHECK` | 设为 `0` 关闭每天一次的新版本检查（查 npm，缓存在 `~/.gang/update.json`） |
 | `GANG_UPDATE_URL` | 新版本检查查询的地址，默认 `https://registry.npmjs.org/@gangfun/cli/latest`；npmjs 慢或打不开时，可以换成 npm 镜像的 `…/@gangfun/cli/latest` |
+| `GANG_PAD` / `GANG_TESTNET_PAD` | 覆盖合并后的内盘合约 GangLaunchpad（主网 / 测试网），`gang v3` 和 `gang fair` 共用（默认：主网 `0x15CF…4365`，测试网第 10 套 `0xFebF…5BB1`）。旧名 `GANG_V3_PAD` / `GANG_FAIR_PAD`、`GANG_V3_TESTNET_PAD` / `GANG_FAIR_TESTNET_PAD` 仍可用（别名） |
+| `GANG_TESTNET_RPC_URL` | 测试网 RPC；旧名 `GANG_V3_TESTNET_RPC_URL` / `GANG_FAIR_TESTNET_RPC_URL` 仍可用 |
+| `GANG_ROUTER` / `GANG_TESTNET_ROUTER` | GangRouter 代理（用原生 BNB 买 V3 / 打新，以及已毕业币的所有外盘买卖）；旧名 `GANG_ROUTER_TESTNET` 仍可用。默认：主网 `0xE040…79C4`，测试网第 10 套 `0x6bB6…C9F6` |
 
 ## 版本
 
-`0.8.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
+`0.9.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)（0.9.0 还没发布，npm 上是 0.8.0）

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gangfun/cli",
-  "version": "0.8.0",
-  "description": "Gang launchpad CLI (LaunchpadV2-only create + legacy Soft/U/S trade) for Binance Agentic Wallet agents.",
+  "version": "0.9.1",
+  "description": "Gang launchpad CLI for Binance Agentic Wallet agents: LaunchpadV2 create / trade, V3 tax tokens, 打新 fair mint, PancakeSwap pool trades, legacy Soft/U/S trade.",
   "type": "module",
   "bin": {
     "gang": "./src/index.js"

package/src/abi.js

@@ -62,6 +62,23 @@ export const V2_ABI = [
   ] },
 ]
 
+/**
+ * LaunchpadS (stocks track): the V2 trade functions, but its Curve has 9 fields — no `taxed` (every S token is a
+ * TaxLaunchToken: 1% pool tax both ways) — and its Created event carries no logoURI / taxed / refPair.
+ */
+export const S_ABI = V2_ABI.filter((x) => !(x.name === 'curves' || (x.type === 'event' && x.name === 'Created'))).concat([
+  { type: 'function', name: 'curves', stateMutability: 'view', inputs: [{ name: 'token', type: 'address' }], outputs: [
+    { name: 'creator', type: 'address' }, { name: 'quote', type: 'address' }, { name: 'realQuote', type: 'uint128' }, { name: 'sold', type: 'uint128' },
+    { name: 'gradAmt', type: 'uint128' }, { name: 'virtualQuote', type: 'uint128' }, { name: 'graduated', type: 'bool' },
+    { name: 'pair', type: 'address' }, { name: 'refPair', type: 'address' },
+  ] },
+  { 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 },
+    { name: 'quote', type: 'address', indexed: true }, { name: 'gradAmt', 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' }] },

package/src/chain.js

@@ -1,6 +1,6 @@
 import { createPublicClient, http, formatEther, formatUnits, parseEther, encodeFunctionData, decodeEventLog, decodeErrorResult, isAddress, zeroAddress } from 'viem'
 import { bsc } from 'viem/chains'
-import { SOFT_ABI, V2_ABI, ERC20_ABI, WBNB_ABI } from './abi.js'
+import { SOFT_ABI, V2_ABI, S_ABI, ERC20_ABI, WBNB_ABI } from './abi.js'
 
 export const ADDR = {
   v2: '0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E',
@@ -41,7 +41,7 @@ const PADS = [
   { id: 'v2', address: ADDR.v2, kind: 'v2', abi: V2_ABI },
   { id: 'soft', address: ADDR.soft, kind: 'soft', abi: SOFT_ABI },
   { id: 'u', address: ADDR.u, kind: 'v2', abi: V2_ABI },
-  { id: 's', address: ADDR.s, kind: 'v2', abi: V2_ABI },
+  { id: 's', address: ADDR.s, kind: 'v2', abi: S_ABI }, // 9-field Curve (no taxed): see S_ABI
 ]
 
 /** Resolve which pad hosts `token` by probing curves(token).creator != 0. */
@@ -71,9 +71,18 @@ function v2InfoFromCurve(c) {
   return { kind: 'v2', creator, raised: realQuote, sold, graduated, pair, quote, gradAmt, taxed, virtualQuote, refPair }
 }
 
+/** LaunchpadS: no `taxed` field — every S token is a TaxLaunchToken (1% pool tax). */
+function sInfoFromCurve(c) {
+  const [creator, quote, realQuote, sold, gradAmt, virtualQuote, graduated, pair, refPair] = c
+  return { kind: 'v2', creator, raised: realQuote, sold, graduated, pair, quote, gradAmt, taxed: true, virtualQuote, refPair }
+}
+
+/** The curve of a resolved pad in one shape, whatever the pad's layout. */
+const curveInfo = (pad) => (pad.kind === 'soft' ? softInfoFromCurve(pad.curve) : pad.id === 's' ? sInfoFromCurve(pad.curve) : v2InfoFromCurve(pad.curve))
+
 export async function tokenInfo(token, me) {
   const pad = await resolvePad(token)
-  const base = pad.kind === 'soft' ? softInfoFromCurve(pad.curve) : v2InfoFromCurve(pad.curve)
+  const base = curveInfo(pad)
   const [name, symbol] = await Promise.all([erc(token, 'name'), erc(token, 'symbol')])
   let locked = null
   try { locked = await erc(token, 'locked') } catch { /* */ }
@@ -211,7 +220,7 @@ export async function quoteBuy(token, buyer, amountHuman) {
       quotePath: 'onchain-quoteBuy' }
   }
   // Unique path: LaunchpadV2.sol _prepBuy / _tokensOut / _quoteInFor (no on-chain quoteBuy view).
-  const base = v2InfoFromCurve(pad.curve)
+  const base = curveInfo(pad)
   let room = null
   try { room = await read(pad.address, pad.abi, 'walletRoom', [token, buyer]) } catch { /* */ }
   const q = v2QuoteBuyFromCurve(base, gross, room)
@@ -229,7 +238,7 @@ export async function quoteSell(token, tokensIn) {
       tokensInFmt: fmtTok(tokensIn), outFmt: fmt(bnbToUser), feeFmt: fmt(fee), unit: 'BNB',
       quotePath: 'onchain-quoteSell' }
   }
-  const base = v2InfoFromCurve(pad.curve)
+  const base = curveInfo(pad)
   const q = v2QuoteSellFromCurve(base, tokensIn)
   return { kind: 'v2', pad: pad.id, padAddress: pad.address, quote: base.quote, tokensIn, out: q.out, fee: q.fee,
     tokensInFmt: fmtTok(tokensIn), outFmt: fmt(q.out), feeFmt: fmt(q.fee), unit: 'quote',