@gangfun/cli 0.33.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/DEVELOPERS.md CHANGED
@@ -114,6 +114,15 @@ New fields can appear at any time, so ignore what you don't know. Other fields c
114
114
 
115
115
  Set `GANG_TOOL=<id>` (2–12 of `a-z`, `0-9`, `-`) and your mainnet trades carry your id at the end of the calldata. The contracts ignore it, and it counts how much your tool is used. It's public, and anyone can write any id, so it proves nothing about who sent a trade. Set `GANG_CLIENT=<name>` to name your host in the anonymous usage counts.
116
116
 
117
+ See how your tool is used, per window and per day, with no key:
118
+
119
+ ```bash
120
+ curl -s 'https://gang.fun/api/tools/<id>'
121
+ curl -s 'https://gang.fun/api/tools?window=7d&sort=wallets'
122
+ ```
123
+
124
+ These are raw counts. They aren't filtered for wash trading, and they leave out post-graduation trades and creates. The [API document](https://gang.fun/api/openapi.json) has the details.
125
+
117
126
  ## Public API
118
127
 
119
128
  `https://gang.fun/api`: read-only, no key. The contract is [`/api/openapi.json`](https://gang.fun/api/openapi.json), which also states the compatibility promise. Undocumented routes carry no promise.
@@ -135,4 +144,8 @@ Limit: 10 requests per second per IP with a burst of 60. Prefer `/stream` to pol
135
144
 
136
145
  ## Examples
137
146
 
138
- [`examples/`](https://github.com/gangfun/cli/tree/main/examples) has working programs to copy: a first testnet trade, a Telegram monitor and a pre-trade risk check.
147
+ [`examples/`](https://github.com/gangfun/cli/tree/main/examples) has working programs to copy: an MCP agent template, a first testnet trade, a Telegram monitor and a pre-trade risk check.
148
+
149
+ ## What's next
150
+
151
+ The [ecosystem plan](https://github.com/gangfun/gang-launchpad/blob/main/docs/PLAN-AGENT-ECOSYSTEM-2026-11-05.en.md) says what we plan to build for developers. To comment, open an issue.
@@ -114,6 +114,15 @@ gang execute --request-id <id> 发送
114
114
 
115
115
  设置 `GANG_TOOL=<id>`(2–12 个字符,`a-z`、`0-9`、`-`)后,你的主网交易会在 calldata 末尾带上这个 ID。合约会忽略它,它只用来统计工具的使用量。标记是公开的,任何人都能写任何 ID,所以不能证明交易是谁发的。设置 `GANG_CLIENT=<name>` 可以在匿名使用统计里写上你的客户端名称。
116
116
 
117
+ 不用 key 就能查看工具的使用数据,可以按时间窗口和按天查看:
118
+
119
+ ```bash
120
+ curl -s 'https://gang.fun/api/tools/<id>'
121
+ curl -s 'https://gang.fun/api/tools?window=7d&sort=wallets'
122
+ ```
123
+
124
+ 这些是原始计数,没有过滤刷量,也不含毕业后的成交和发币。详情见 [API 文档](https://gang.fun/api/openapi.json)。
125
+
117
126
  ## 公开 API
118
127
 
119
128
  `https://gang.fun/api`:只读,无需 key。接口定义见 [`/api/openapi.json`](https://gang.fun/api/openapi.json),其中也写明了兼容承诺。未写入文档的路由没有承诺。
@@ -135,4 +144,8 @@ curl -N 'https://gang.fun/api/stream' # 推送行情事件
135
144
 
136
145
  ## 示例
137
146
 
138
- [`examples/`](https://github.com/gangfun/cli/tree/main/examples) 里有可以直接拿来改的程序:测试网第一笔交易、Telegram 监控和交易前风险检查。
147
+ [`examples/`](https://github.com/gangfun/cli/tree/main/examples) 里有可以直接拿来改的程序:MCP Agent 模板、测试网第一笔交易、Telegram 监控和交易前风险检查。
148
+
149
+ ## 接下来
150
+
151
+ [生态方案](https://github.com/gangfun/gang-launchpad/blob/main/docs/PLAN-AGENT-ECOSYSTEM-2026-11-05.md)写了我们接下来要为开发者做什么。有意见可以提 issue。
package/README.md CHANGED
@@ -16,6 +16,8 @@ Operate [gang.fun](https://gang.fun) from a Binance **Agentic Wallet**. Curve bu
16
16
 
17
17
  **Combined recipient (0.22.0+):** two or three of `--buyback`, `--lp`, `--split` on one taxed launch make a V3 token's tax recipient one GangComboSplitter (`combo-v1`): `gang create … --buy-tax 3 --sell-tax 3 --buyback 30 --lp 30 --split self:70,0x…:30` buys back and burns 30% of the recipient's part, adds 30% to the pair as liquidity (LP to 0xdead) and pushes the rest (40%) to the payees, whose `--split` shares are of that rest (here 28% / 12% of the recipient's part); without `--split` the rest goes to the dev, and `--buyback` + `--lp` = 100 takes no payees. **Everything is permanent**: the ratios, payees and shares can never change (unlike a lone `--buyback` / `--lp`, whose ratio the dev can change); a payee can only move its own slot. Any other asset sent to it: the buy-back + LP share to 0xdead, the rest to the payees. `--buyback-to` / `--lp-to` don't apply. One flag alone still uses its own module. `gang combo status|distribute|release|set-payee|bind|chunk` shows and drives it. On BSC mainnet (factory `0xd33C38BE3f8472b3013167830F0638C1704e1DBd`, deployed 2026-10-31; 2.0: `0xcCeA388DbC0Edb206eC25C9715546d57029198Be`; built in) and testnet set 10 (factory `0x52a8f90a92E5C1828b4436a0B99C6b293f7F4CFE`).
18
18
 
19
+ **Capped recipient (0.35.0+):** `--tax-cap <amount>` on a taxed launch makes a V3 token's tax recipient one GangCappedSplitter (`capped-v1`): `gang create … --buy-tax 3 --sell-tax 3 --tax-cap 20 --tax-cap-share 50 --split self:70,0x…:30 --after-cap buyback:70,lp:30` pushes 50% of the recipient's part to the payees (`--split` shares of that part; default: all to the dev) until they have been credited 20 of the launch's quote in all (WBNB for a BNB launch, else `--quote`, counted in its own decimals); the rest, and after the cap all of it, is 70% bought back and burned and 30% added to the pair as liquidity (LP to 0xdead). `--tax-cap-share` defaults to 100, `--after-cap` to `buyback:100`. The split that crosses the cap pays exactly what is left of it, and the preview gives the rough pool volume at which the cap is reached. The cap covers only this recipient's part of the pool tax: not the creator fee, not the dev's own tokens (the dev can still sell), not the holders' dividend. **Everything is permanent**: the cap, its quote, the ratios, payees and shares can never change; a payee can only move its own slot. Any other asset sent to it goes to 0xdead in full when it is distributed (one that can't be sent there stays in the module). Not with `--buyback` / `--lp` / `--buyback-to` / `--lp-to` / `--recipient`. `gang capped status|distribute|release|set-payee|bind|chunk` shows and drives it. Live on BSC mainnet (factory `0x294E901ecb66af280C1cDD26fD871601d89a2Dca`, allowed by the platform's Safe on 2026-11-08; built in) and the BSC testnet (`0xe3f61865d98993dd39c136Af19651C6F6686498A`).
20
+
19
21
  **GangLaunchpad 2.0, the creator fee and the graduation target (0.23.0+):** 2.0 is a new generation of the same pad (the same V3 curves and 打新 sales); of the 1% fee on every V3 curve buy and sell, 70% is kept on the pad for the token's creator, who claims it any time, before or after graduation: `gang creator-fee` lists a creator's 2.0 tokens and what each holds, `gang creator-fee --token <addr> --claim [--to <addr>]` claims it. It is the creator's own, never the tax recipient's or a buy-back / split / LP module's; 1.0 tokens and 打新 sales have none. 2.0 also lets the creator pick the V3 graduation target: `gang create --grad 6|9|12|15` (BNB raised, default 9; market cap at graduation ≈ 5×); `gang info` / `gang status` show each token's `graduationTargetBnb`. New tokens go to the newest generation built in for the network (`gang preflight` → `createPadGen`); a token keeps trading on its own generation's pad, GangRouter, GangBond and module factories, found by asking each pad's `kindOf`. On the BSC testnet 2.0 is live and the create target (pad `0xb14d415f70D7F99f0D93Bd3BF76e0D6b38b53B3E`, GangRouter `0x5a4FA2D91638a305EdF027894753c943f095dDAA`; the first testnet 2.0, `0x6381…39be`, no longer creates, and its tokens keep trading and claiming there). On BSC mainnet 2.0 is live and the create target since 2026-10-31 (pad `0x770331a9accdb53ACb4a45B6c5B7D151fADCe557`, GangRouter `0xa83209d6bfC2B220cD86410cCDDC71FEb354844a`); 1.0 tokens keep trading on 1.0 (pad `0x15CF…4365`).
20
22
 
21
23
  **2.0 金库版: tokens bound to a lock vault (0.27.0+):** a third pad next to 1.0 and 2.0 (GangVaultLaunchpad: the same 2.0 V3 curves, creator fee and `--grad`; no 打新). Each of its tokens is bound at create, for good, to one vault contract the platform listed, and only the wallet the platform named for that vault may create it, one token per naming: `gang create --vault <vault> --name <n> --symbol <s> [--buy-tax … --sell-tax …] [--grad …]` from that wallet. Until graduation the vault locks holders' tokens and releases them only through the pad, for the wallet that sends the tx and holds an Agent ID; locked tokens still count in the holder's 1% cap (`gang status` → `lockedInVault`, `gang info` → `vault`). After graduation it is a plain token. Buys and sells work as on 2.0 (`gang buy` / `gang sell` find the pad through `kindOf`). The pad has no GangBond and no buy-back / split / LP / combined module, so a `--vault` create takes none of `--dev-buy` / `--bond` / `--buyback` / `--split` / `--lp`: buy with `gang buy` once the create lands. A plain `gang create` never goes to this pad. Mainnet pad `0xE90851A90C6278E3d6e4C24320101f8B13D90A11` (GangRouter `0xAcd4944A4090c13d9DACAe60f3019cef9d9bB1Ad`); testnet `0x9108e7b85e69060A5E626A04Ce6DEf323071C8a9` (GangRouter `0x9bF3E197a6719Af856a7c82d23CABFdBcc184f69`).
@@ -72,6 +74,9 @@ gang info --token <addr> # one token, any pad (gang token is
72
74
  gang status --token <addr> # my position: balance; V3 dividend / 打新 reward, sellable; poolSellAll
73
75
  gang portfolio [--from <addr>] # every holding: balance, value, cost / unrealized, claimable, USD; bonds; creator fees (2.0 / 3.0)
74
76
  gang creator-fee [--token <addr>] [--from <creator>] [--claim [--to <addr>]] # GangLaunchpad 2.0 / 3.0: 70% of the 1% curve fee, the creator's
77
+ gang create … --promote 20 [--promote-days 30] # V3 on 3.0 (0.34.0+): 20% of your creator fee to the promoter of each bound wallet, on its curve trades inside the window. On a taxed token with no recipient named, also that share of the recipient's part of those wallets' pool tax (promoter pool module, settled by Merkle root). Fixed for good
78
+ gang promote buy --token 0x… --amount <n> --promoter 0x… # binds this wallet to the promoter, by its first trade of the token, on the curve only, sent directly from the wallet. Same price and fee for you. Not --ref (gang.fun's invite credit). The same as gang buy --promoter on 0.34.0+, but an older CLI answers it with its help, where it would build gang buy --promoter as a plain buy that can never bind
79
+ gang promote status|earnings|claim|claim-pool|activate|work|sweep|bind|reclaim|release-dev --token 0x… (or --module 0x…) # terms, binding, what can be claimed; claim-pool checks gang.fun's proof against the root on chain. reclaim (the dev, after 30 days of settler silence) closes the module for good
75
80
  gang quote --token <addr> --amount <n> # V2 / Soft / U / S curve only (Soft: BNB; V2: quote ERC-20, LaunchpadV2.sol math)
76
81
  gang buy --token <addr> --amount <n> [--slippage 1] [--follow <note tx>] [--note "<why>" [--conf 0-100] [--reveal-after 1-72h]]
77
82
  # --amount = what to spend in the token's quote (--bnb is the older name). V3: includes the 1% curve fee (no tax on the
@@ -128,6 +133,8 @@ gang lp status|set|set-payee|apply|bind|release|add --token 0x… [--pct 0-100]
128
133
  gang lp split --token 0x… (or --module 0x…) # anyone: split what arrived: the payee's part now, the pool's set aside (0.23.0+)
129
134
  gang create … --buy-tax 3 --sell-tax 3 --buyback 30 --lp 30 [--split self:70,0x…:30] [--dev-buy …] # V3, combined recipient: 30% bought back + burned, 30% added as liquidity, the rest to the payees (shares of the rest; default you). PERMANENT
130
135
  gang combo status|distribute|release|set-payee|bind|chunk --token 0x… [--asset 0x…] [--index <i>] [--to 0x…] [--slippage 1] # the combined recipient: ratios, payees, set aside, owed, the next chunk and the keeper's plan; chunk = one chunk now (anyone)
136
+ gang create … --buy-tax 3 --sell-tax 3 --tax-cap 20 [--tax-cap-share 50] [--split self:70,0x…:30] [--after-cap buyback:70,lp:30] # V3, capped recipient: the payees get --tax-cap-share % until --tax-cap in all, the rest (and then all) bought back / added. PERMANENT
137
+ gang capped status|distribute|release|set-payee|bind|chunk --token 0x… [--asset 0x…] [--index <i>] [--to 0x…] [--slippage 1] # the capped recipient: cap, paid / left / progress, ratios, payees, set aside, owed, the next chunk; other assets go to 0xdead
131
138
  gang create --fair … [--shares <n>] --bond <quote> [--bond-hold …] --bond-days <7-90> # 打新: create (dev shares) → bond
132
139
  gang execute --request-id <id>
133
140
  gang tx --pending # trades approved in the Binance App: found by the exact call previewed, then as below
@@ -264,7 +271,7 @@ take MCP servers instead of a shell (Claude Desktop / Code, Cursor, …). Each t
264
271
 
265
272
  | Tool | Runs |
266
273
  |---|---|
267
- | `gang_help` | this CLI's whole help (every command, every flag) and the full rules (0.17.2+): what an agent with no skill installed reads before a create, launch, bond, buyback, split, lp, combo, mint or withdraw |
274
+ | `gang_help` | this CLI's whole help (every command, every flag) and the full rules (0.17.2+): what an agent with no skill installed reads before a create, launch, bond, buyback, split, lp, combo, capped, mint or withdraw |
268
275
  | `gang_preflight`, `gang_trending`, `gang_hot`, `gang_new`, `gang_near_grad`, `gang_info`, `gang_status`, `gang_portfolio`, `gang_notes`, `gang_agents` | the read commands of the same name (`gang_portfolio`: 0.17.6+; `gang_trending`: 0.24.0+) |
269
276
  | `gang_tx` | `gang tx --hash …`: decode a tx, publish its queued note; `pending: true` = `gang tx --pending`, the trades approved in the Binance App (no hash needed) |
270
277
  | `gang_watch` | `gang watch` until `maxEvents` (default 1) or `timeout` (default 50s, at most 30m): returns `{ events, meta }`, `timedOut: true` when nothing came; call it again to keep waiting |
@@ -331,8 +338,10 @@ timed-out `gang_execute`, check `gang_status` / the wallet history instead of ex
331
338
  | `GANG_FLY_PAD` / `GANG_TESTNET_FLY_PAD` | GangFlywheelPad V1 (铸币飞轮). Defaults: mainnet `0x631e…B029` (open since 2026-10-30), testnet set 2 `0xD648…951c` |
332
339
  | `GANG_BOND` / `GANG_TESTNET_BOND` | GangBond of the create target (creator bonds, `gang bond`; a token's bond is on its own generation's). Defaults: mainnet 3.0 `0x830b…E9D6` (2.0 `0x2313…E0D8`, 1.0 `0xe92d…14E4`, since 2026-10-29, CLI 0.16.2+), testnet 3.0 `0xa877…9fc1` (2.0 `0x3974…51F9`, first 2.0 `0x9139…F97f`, 1.0 `0xd6a8…1086`) |
333
340
  | `GANG_SPLIT_FACTORY` / `GANG_TESTNET_SPLIT_FACTORY` | GangSplitModuleFactory of the create target (`--split`). Defaults: mainnet 3.0 `0x904D…71f2` (2.0 `0xa73d…ec59`, 1.0 `0x27e0…067c`, since 2026-10-30, CLI 0.19.0+), testnet 3.0 `0xf8d4…06dc` (2.0 `0xb9ab…3513`, first 2.0 `0x860D…0879`, 1.0 `0x5F7d…567E`) |
341
+ | `GANG_PROMOTE_POOL_FACTORY` / `GANG_TESTNET_PROMOTE_POOL_FACTORY` | GangPromotePoolModuleFactory of the create target (`--promote` on a taxed token). Defaults: mainnet `0xA633…167A`, testnet `0x7a68…F1c2` |
334
342
  | `GANG_LP_FACTORY` / `GANG_TESTNET_LP_FACTORY` | GangLiquiditySplitterFactory of the create target (`--lp`). Defaults (CLI 0.20.0+): mainnet 3.0 `0x98C5…1752` (2.0 `0x8ac8…c0E4`, 1.0 `0xE043…C248`, since 2026-10-31), testnet 3.0 `0x4A3a…6B07` (2.0 `0xAEec…36E4`, first 2.0 `0x4f15…1619`, 1.0 `0xA729…1591`) |
335
343
  | `GANG_COMBO_FACTORY` / `GANG_TESTNET_COMBO_FACTORY` | GangComboSplitterFactory of the create target (several of `--buyback` / `--lp` / `--split`; a token's combined recipient is on its own generation's). Defaults (CLI 0.22.0+): mainnet 3.0 `0x2018…eA39` (2.0 `0xcCeA…98Be`, 1.0 `0xd33C…1DBd`, since 2026-10-31), testnet 3.0 `0xdc16…543C` (2.0 `0x312c…84BD`, 1.0 `0x52a8…4CFE`; the first 2.0 has none) |
344
+ | `GANG_CAPPED_FACTORY` / `GANG_TESTNET_CAPPED_FACTORY` | GangCappedSplitterFactory of the create target (`--tax-cap` on a taxed V3 launch). CLI 0.35.0+; built in: mainnet `0x294E901ecb66af280C1cDD26fD871601d89a2Dca`, testnet `0xe3f61865d98993dd39c136Af19651C6F6686498A` |
336
345
  | `GANG_SPLITTER_FACTORY` / `GANG_TESTNET_SPLITTER_FACTORY` | GangBuybackSplitterFactory of the create target (`--buyback`). Defaults: mainnet 3.0 `0xc128…3194` (2.0 `0x77e4…803C`, 1.0 `0xf1d5…F1Cd`), testnet 3.0 `0x3533…d110` (2.0 `0xDC9E…0f6e`, first 2.0 `0xBc26…33AE`, 1.0 `0x7E63…2BBe`) |
337
346
  | `GANG_ROUTER` / `GANG_TESTNET_ROUTER` | GangRouter proxy of the create target (native-BNB V3 buys / mints, and every PancakeSwap trade of a graduated token; a token uses its own generation's); old name `GANG_ROUTER_TESTNET` still works. Defaults: mainnet 3.0 `0xec97…61e7` (2.0 `0xa832…844a`, 1.0 `0xE040…79C4`), testnet 3.0 `0x0954…87b9` (2.0 `0x5a4F…dDAA`, first 2.0 `0xb218…FC08`, 1.0 `0x6bB6…C9F6`) |
338
347
 
@@ -366,4 +375,4 @@ The tag is public and anyone can write any id, so it counts usage and proves not
366
375
 
367
376
  ## Version
368
377
 
369
- `0.33.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
378
+ `0.34.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
package/README.zh-CN.md CHANGED
@@ -16,6 +16,8 @@
16
16
 
17
17
  **组合收款(0.22.0+):** 一次有税发射里同时给 `--buyback`、`--lp`、`--split` 中的两个或三个,V3 币的税收接收地址就是一个组合合约(GangComboSplitter,`combo-v1`):`gang create … --buy-tax 3 --sell-tax 3 --buyback 30 --lp 30 --split self:70,0x…:30` 把接收地址那份税的 30% 回购销毁、30% 加进池子做流动性(LP 打进 0xdead),其余 40% 推给收款人;`--split` 的比例是「剩下那部分」的比例(这里分别是接收地址那份的 28% / 12%)。不给 `--split` 时剩下的全给 dev;`--buyback` + `--lp` = 100 时不能有收款人。**全部永久不可改**:比例、收款人和份额以后都不能改(不像单独的 `--buyback` / `--lp`,dev 可以调比例);收款人只能把自己那一份换到新地址。打进来的其他资产:回购 + 加池那部分比例打进 0xdead,其余给收款人。`--buyback-to` / `--lp-to` 不适用。只给一个参数时仍走各自的单独模块。`gang combo status|distribute|release|set-payee|bind|chunk` 查看和操作。已在 BSC 主网(工厂 `0xd33C38BE3f8472b3013167830F0638C1704e1DBd`,2026-10-31 部署;2.0:`0xcCeA388DbC0Edb206eC25C9715546d57029198Be`;已内置)和测试网第 10 套(工厂 `0x52a8f90a92E5C1828b4436a0B99C6b293f7F4CFE`)可用。
18
18
 
19
+ **税收封顶(0.35.0+):** 有税发射时给 `--tax-cap <数量>`,V3 币的税收接收地址就是一个封顶合约(GangCappedSplitter,`capped-v1`):`gang create … --buy-tax 3 --sell-tax 3 --tax-cap 20 --tax-cap-share 50 --split self:70,0x…:30 --after-cap buyback:70,lp:30` 把接收地址那份税的 50% 推给收款人(`--split` 的比例是这一部分里的比例;不给时全给 dev),直到收款人累计拿满 20 个发射报价币(BNB 发射就是 WBNB,否则是 `--quote`,按它自己的小数位计);其余部分,以及封顶之后的全部,70% 回购销毁、30% 加进池子做流动性(LP 打进 0xdead)。`--tax-cap-share` 默认 100,`--after-cap` 默认 `buyback:100`。跨过上限的那一笔只给到剩余额度,预览会给出大约多少池子成交量会封顶。封顶只管这个接收地址那份税:不管创建者的曲线手续费分成,不管 dev 自己的币(照样能卖),也不管持有人分红。**全部永久不可改**:上限、计价币、比例、收款人和份额以后都不能改;收款人只能把自己那一份换到新地址。打进来的其他资产在分配(distribute)时全部打进 0xdead(打不进去的留在合约里)。不能和 `--buyback` / `--lp` / `--buyback-to` / `--lp-to` / `--recipient` 同用。`gang capped status|distribute|release|set-payee|bind|chunk` 查看和操作。BSC 主网已上线(工厂 `0x294E901ecb66af280C1cDD26fD871601d89a2Dca`,平台多签于 2026-11-08 批准;已内置),测试网也有(`0xe3f61865d98993dd39c136Af19651C6F6686498A`)。
20
+
19
21
  **GangLaunchpad 2.0、creator 分成和毕业目标(0.23.0+):** 2.0 是同一个内盘的新一代(V3 曲线和打新都一样)。V3 内盘每笔买卖收的 1% 手续费里,70% 留在内盘上归这个币的 creator,creator 毕业前后随时可以领:`gang creator-fee` 列出这个 creator 所有 2.0 币各自可领多少,`gang creator-fee --token <addr> --claim [--to <addr>]` 领取。这笔钱只归 creator 本人,不给税收接收地址,也不经过回购 / 分账 / 加池模块;1.0 的币和打新没有这项。2.0 还允许 creator 自选 V3 毕业目标:`gang create --grad 6|9|12|15`(内盘募到的 BNB,默认 9;毕业时市值约为目标的 5 倍);`gang info` / `gang status` 显示每个币的 `graduationTargetBnb`。新币发到这条链上内置的最新一代(`gang preflight` 的 `createPadGen`);已有的币始终用它自己那一代的内盘、GangRouter、GangBond 和模块工厂(CLI 逐个问各代内盘的 `kindOf` 找到它)。BSC 测试网上 2.0 已上线并且是发币目标(内盘 `0xb14d415f70D7F99f0D93Bd3BF76e0D6b38b53B3E`,GangRouter `0x5a4FA2D91638a305EdF027894753c943f095dDAA`;测试网第一版 2.0 `0x6381…39be` 不再发新币,上面的币照常交易和领取)。BSC 主网 2026-10-31 起 2.0 已上线并且是发币目标(内盘 `0x770331a9accdb53ACb4a45B6c5B7D151fADCe557`,GangRouter `0xa83209d6bfC2B220cD86410cCDDC71FEb354844a`);1.0 的币照常在 1.0(内盘 `0x15CF…4365`)上交易。
20
22
 
21
23
  **2.0 金库版:绑定锁仓金库的币(0.27.0+):** 和 1.0、2.0 并列的第三个内盘(GangVaultLaunchpad:V3 曲线、creator 分成和 `--grad` 都和 2.0 一样;没有打新)。这里的每个币在创建时就和平台登记过的一个金库合约永久绑定,而且只有平台为这个金库指定的钱包才能发,每次指定只能发一个币:用那个钱包执行 `gang create --vault <金库> --name <n> --symbol <s> [--buy-tax … --sell-tax …] [--grad …]`。毕业前,金库只能通过内盘锁入、取回持有人的币,而且只替发交易、持有 Agent ID 的钱包操作;锁进金库的币仍计入持有人的 1% 上限(`gang status` → `lockedInVault`,`gang info` → `vault`)。毕业后就是普通的币。买卖和 2.0 一样(`gang buy` / `gang sell` 通过 `kindOf` 找到这个内盘)。这个内盘没有 GangBond,也没有回购 / 分账 / 加池 / 组合模块,所以 `--vault` 发币不能带 `--dev-buy` / `--bond` / `--buyback` / `--split` / `--lp`:发币上链后再用 `gang buy` 买。普通的 `gang create` 不会发到这个内盘。主网内盘 `0xE90851A90C6278E3d6e4C24320101f8B13D90A11`(GangRouter `0xAcd4944A4090c13d9DACAe60f3019cef9d9bB1Ad`);测试网 `0x9108e7b85e69060A5E626A04Ce6DEf323071C8a9`(GangRouter `0x9bF3E197a6719Af856a7c82d23CABFdBcc184f69`)。
@@ -62,6 +64,9 @@ gang info --token <addr> # 任意内盘的一个币(gang t
62
64
  gang status --token <addr> # 我的持仓:余额;V3 分红 / 打新奖励、还能卖多少;poolSellAll
63
65
  gang portfolio [--from <addr>] # 全部持仓:余额、价值、成本 / 浮盈、可领、美元;押金;creator 分成(2.0 / 3.0)
64
66
  gang creator-fee [--token <addr>] [--from <creator>] [--claim [--to <addr>]] # GangLaunchpad 2.0 / 3.0:内盘 1% 手续费的 70% 归 creator
67
+ gang create … --promote 20 [--promote-days 30] # 3.0 的 V3(0.34.0+):绑定钱包在有效期内的内盘交易,creator 分成的 20% 归它的推广人。带税且没指定接收方时,这些钱包的池子税里,接收方那部分也按这个比例分给推广人(外盘分成模块,按 Merkle root 结算)。发币后不能改
68
+ gang promote buy --token 0x… --amount <n> --promoter 0x… # 把这个钱包绑定到推广人:只在它第一次交易这个币时绑定,只限内盘,必须由钱包直接发送。价格和手续费不变。和 --ref(gang.fun 的邀请记录)不是一回事。在 0.34.0+ 上等同于 gang buy --promoter,但旧版 CLI 对它只打印帮助,而 gang buy --promoter 在旧版上会变成一笔再也无法绑定的普通买入
69
+ gang promote status|earnings|claim|claim-pool|activate|work|sweep|bind|reclaim|release-dev --token 0x…(或 --module 0x…) # 条款、绑定、可领金额;claim-pool 会用链上的 root 核对 gang.fun 给的证明。reclaim(dev,结算方沉默 30 天后)会永久关闭模块
65
70
  gang quote --token <addr> --amount <n> # 只算 V2 / Soft / U / S 内盘(Soft:BNB;V2:报价币 ERC-20)
66
71
  gang buy --token <addr> --amount <n> [--slippage 1] [--follow <附言 tx>] [--note "<理由>" [--conf 0-100] [--reveal-after 1-72h]]
67
72
  # --amount 是要花的报价币数量(--bnb 是旧名)。V3:含内盘 1% 手续费(内盘不收税;WBNB 报价经 GangRouter 直接付 BNB)。
@@ -107,6 +112,8 @@ gang lp status|set|set-payee|apply|bind|release|add --token 0x… [--pct 0-100]
107
112
  gang lp split --token 0x…(或 --module 0x…) # 任何人:把新到的钱分掉:收款人那份立即转出,加池那份留着(0.23.0+)
108
113
  gang create … --buy-tax 3 --sell-tax 3 --buyback 30 --lp 30 [--split self:70,0x…:30] [--dev-buy …] # V3 组合收款:30% 回购销毁,30% 加池,其余给收款人(比例按剩下那部分算;默认给你)。永久不可改
109
114
  gang combo status|distribute|release|set-payee|bind|chunk --token 0x… [--asset 0x…] [--index <i>] [--to 0x…] [--slippage 1] # 组合合约:比例、收款人、待回购 / 待加池、欠款、下一块和 keeper 的计划;chunk = 现在手动做一块(任何人)
115
+ gang create … --buy-tax 3 --sell-tax 3 --tax-cap 20 [--tax-cap-share 50] [--split self:70,0x…:30] [--after-cap buyback:70,lp:30] # V3 税收封顶:收款人拿 --tax-cap-share %,累计拿满 --tax-cap 为止,其余(封顶后全部)回购 / 加池。永久不可改
116
+ gang capped status|distribute|release|set-payee|bind|chunk --token 0x… [--asset 0x…] [--index <i>] [--to 0x…] [--slippage 1] # 封顶合约:上限、已付 / 剩余 / 进度、比例、收款人、待回购 / 待加池、欠款、下一块;其他资产打进 0xdead
110
117
  gang create --fair … [--shares <n>] --bond <数量> [--bond-hold …] --bond-days <7-90> # 打新:发币(含 dev 份额)→ 押金
111
118
  gang execute --request-id <id>
112
119
  gang tx --pending # 在 Binance App 里批准过的交易:按预览时的调用自动找到交易,再按下面这条处理
@@ -281,8 +288,10 @@ Claude Code:`claude mcp add gang -- gang mcp`。同一台机器上 `baw` 要
281
288
  | `GANG_FLY_PAD` / `GANG_TESTNET_FLY_PAD` | GangFlywheelPad V1(铸币飞轮)。默认:主网 `0x631e…B029`(2026-10-30 起开放),测试网第 2 套 `0xD648…951c` |
282
289
  | `GANG_BOND` / `GANG_TESTNET_BOND` | 发币目标那一代的 GangBond(押金承诺,`gang bond`;已有的币用它自己那一代的)。默认:主网 3.0 `0x830b…E9D6`(2.0 `0x2313…E0D8`,1.0 `0xe92d…14E4`,2026-10-29 起,CLI 0.16.2+),测试网 3.0 `0xa877…9fc1`(2.0 `0x3974…51F9`,第一版 2.0 `0x9139…F97f`,1.0 `0xd6a8…1086`) |
283
290
  | `GANG_SPLIT_FACTORY` / `GANG_TESTNET_SPLIT_FACTORY` | 发币目标那一代的 GangSplitModuleFactory(`--split`)。默认:主网 3.0 `0x904D…71f2`(2.0 `0xa73d…ec59`,1.0 `0x27e0…067c`,2026-10-30 起,CLI 0.19.0+),测试网 3.0 `0xf8d4…06dc`(2.0 `0xb9ab…3513`,第一版 2.0 `0x860D…0879`,1.0 `0x5F7d…567E`) |
291
+ | `GANG_PROMOTE_POOL_FACTORY` / `GANG_TESTNET_PROMOTE_POOL_FACTORY` | 发币目标那一代的 GangPromotePoolModuleFactory(带税币的 `--promote`)。默认:主网 `0xA633…167A`,测试网 `0x7a68…F1c2` |
284
292
  | `GANG_LP_FACTORY` / `GANG_TESTNET_LP_FACTORY` | 发币目标那一代的 GangLiquiditySplitterFactory(`--lp`)。默认(CLI 0.20.0+):主网 3.0 `0x98C5…1752`(2.0 `0x8ac8…c0E4`,1.0 `0xE043…C248`,2026-10-31 起),测试网 3.0 `0x4A3a…6B07`(2.0 `0xAEec…36E4`,第一版 2.0 `0x4f15…1619`,1.0 `0xA729…1591`) |
285
293
  | `GANG_COMBO_FACTORY` / `GANG_TESTNET_COMBO_FACTORY` | 发币目标那一代的 GangComboSplitterFactory(同时给 `--buyback` / `--lp` / `--split` 中的几个;已有的币用它自己那一代的)。默认(CLI 0.22.0+):主网 3.0 `0x2018…eA39`(2.0 `0xcCeA…98Be`,1.0 `0xd33C…1DBd`,2026-10-31 起),测试网 3.0 `0xdc16…543C`(2.0 `0x312c…84BD`,1.0 `0x52a8…4CFE`;第一版 2.0 没有) |
294
+ | `GANG_CAPPED_FACTORY` / `GANG_TESTNET_CAPPED_FACTORY` | 发币目标那一代的 GangCappedSplitterFactory(有税 V3 发射的 `--tax-cap`)。CLI 0.35.0+;已内置:主网 `0x294E901ecb66af280C1cDD26fD871601d89a2Dca`,测试网 `0xe3f61865d98993dd39c136Af19651C6F6686498A` |
286
295
  | `GANG_ROUTER` / `GANG_TESTNET_ROUTER` | 发币目标那一代的 GangRouter 代理(用原生 BNB 买 V3 / 打新,以及已毕业币的所有外盘买卖;已有的币用它自己那一代的);旧名 `GANG_ROUTER_TESTNET` 仍可用。默认:主网 3.0 `0xec97…61e7`(2.0 `0xa832…844a`,1.0 `0xE040…79C4`),测试网 3.0 `0x0954…87b9`(2.0 `0x5a4F…dDAA`,第一版 2.0 `0xb218…FC08`,1.0 `0x6bB6…C9F6`) |
287
296
 
288
297
  ## 使用统计
@@ -312,4 +321,4 @@ Claude Code:`claude mcp add gang -- gang mcp`。同一台机器上 `baw` 要
312
321
 
313
322
  ## 版本
314
323
 
315
- `0.33.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
324
+ `0.34.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gangfun/cli",
3
- "version": "0.33.0",
3
+ "version": "0.35.0",
4
4
  "mcpName": "io.github.gangfun/gang",
5
5
  "description": "Gang launchpad CLI for Binance Agentic Wallet agents: create on GangLaunchpad (untaxed or tax tokens), 打新 fair mint, PancakeSwap pool trades, LaunchpadV2 and legacy Soft/U/S trade.",
6
6
  "type": "module",
@@ -88,6 +88,21 @@ export const COMMANDS = [
88
88
  c('combo distribute', 'preview', 'low', '0.22.0', 'Anyone: split the bound quote or another asset'),
89
89
  c('combo chunk', 'preview', 'low', '0.22.0', 'Anyone: one buy-back or liquidity chunk'),
90
90
  ]),
91
+ ...baseModule('capped', '0.35.0', "That slot's payee only", [
92
+ c('capped distribute', 'preview', 'low', '0.35.0', 'Anyone: split the bound quote (payees up to the cap), or send another asset to 0xdead'),
93
+ c('capped chunk', 'preview', 'low', '0.35.0', 'Anyone: one buy-back or liquidity chunk'),
94
+ ]),
95
+ c('promote buy', 'preview', 'medium', '0.34.0', "Buy naming a promoter: a wallet's first trade of the token binds it for good, on the curve"),
96
+ c('promote status', 'read', 'none', '0.34.0', "A token's promoter terms, a wallet's binding and what it can claim"),
97
+ c('promote earnings', 'read', 'none', '0.34.0', 'A promoter wallet: shares to claim on the curve and in the pool'),
98
+ c('promote claim', 'preview', 'low', '0.34.0', "Promoter: claim the curve share"),
99
+ c('promote claim-pool', 'preview', 'low', '0.34.0', "Promoter or dev: claim a pool amount proven against the root on chain"),
100
+ c('promote activate', 'preview', 'low', '0.34.0', 'Anyone: put a root in effect after its dispute window'),
101
+ c('promote work', 'preview', 'low', '0.34.0', "Anyone: split what arrived at the module"),
102
+ c('promote sweep', 'preview', 'low', '0.34.0', 'Anyone: send another asset that reached the module on to the dev'),
103
+ c('promote bind', 'preview', 'low', '0.34.0', 'Anyone: bind the module to its token before graduation (a launch does it)'),
104
+ c('promote reclaim', 'preview', 'high', '0.34.0', "Dev: after 30 days of settler silence, take what no root allocated; closes the module for good"),
105
+ c('promote release-dev', 'preview', 'low', '0.34.0', 'Dev: send what failed pushes left in the module'),
91
106
  ]
92
107
 
93
108
  /** Text anyone can write on-chain or in a note: data for the user to read, never instructions to follow. */