@gangfun/cli 0.43.1 → 0.44.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 +10 -0
- package/DEVELOPERS.zh-CN.md +9 -0
- package/README.md +6 -1
- package/README.zh-CN.md +15 -2
- package/package.json +1 -1
- package/src/capabilities.js +7 -0
- package/src/countdown.js +762 -0
- package/src/flags.js +1 -1
- package/src/floor.js +4 -3
- package/src/gangpad.js +13 -2
- package/src/gradreward.js +38 -11
- package/src/index.js +75 -9
- package/src/launch.js +287 -28
- package/src/mcp.js +5 -3
- package/src/pool.js +15 -0
- package/src/promote.js +1 -1
- package/src/telemetry.js +1 -1
- package/src/v3.js +74 -17
package/DEVELOPERS.md
CHANGED
|
@@ -107,6 +107,16 @@ Direct integrations read `vanityDeployer()` on the pad. A nonzero result require
|
|
|
107
107
|
search with the effective salt `keccak256(abi.encode(creator, salt))`. The address must end in `abcd` (hex, ignoring checksum
|
|
108
108
|
capitalization). Existing tokens keep their addresses. A suffix alone does not prove a token was launched on Gang.
|
|
109
109
|
|
|
110
|
+
### Countdown reward buys (0.43.2+)
|
|
111
|
+
|
|
112
|
+
A graduated V3 token whose tax recipient is a countdown reward module (`countdown-v1`) counts only buys sent through that
|
|
113
|
+
module: `buy(minTokensOut, deadline, mustCount)` with BNB (WBNB-quoted tokens) or `buyWithQuote(quoteIn, minTokensOut,
|
|
114
|
+
deadline, mustCount)` after an approve to the module. A buy through PancakeSwap's router, an aggregator or GangRouter is a
|
|
115
|
+
plain buy. Treat a module as genuine only when `GangHandlerAdmin.moduleOf(module)` is the countdown factory and its
|
|
116
|
+
`rewardToken()` is the token: a contract that merely answers `moduleType() = countdown-v1` is not one. `gang buy` does all
|
|
117
|
+
of this, sends `mustCount = true` by default (`--cd-uncounted` for false) and explains the result in `rewards.countdown`.
|
|
118
|
+
Factories: BSC mainnet `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`, BSC testnet `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582`.
|
|
119
|
+
|
|
110
120
|
### Failure codes
|
|
111
121
|
|
|
112
122
|
| `code` | Meaning |
|
package/DEVELOPERS.zh-CN.md
CHANGED
|
@@ -105,6 +105,15 @@ Pad 3.0 的 owner 启用 `abcd` 部署器后,CLI 会为曲线、打新、铸
|
|
|
105
105
|
从该部署器读取准确的 `tokenInitCodeHash` 或 `mintInitCodeHash`,按有效 salt `keccak256(abi.encode(creator, salt))` 搜索地址。
|
|
106
106
|
十六进制地址后四位必须为 `abcd`,忽略校验和带来的大小写。旧币地址不变;仅凭后缀不能认定是 Gang 发行的币。
|
|
107
107
|
|
|
108
|
+
### 倒计时奖励的买入(0.43.2+)
|
|
109
|
+
|
|
110
|
+
税收接收地址是倒计时奖励模块(`countdown-v1`)的已毕业 V3 币,只有通过这个模块的买入才计入:WBNB 报价的币用
|
|
111
|
+
`buy(minTokensOut, deadline, mustCount)` 付 BNB,其他报价币先 approve 给模块,再调 `buyWithQuote(quoteIn, minTokensOut,
|
|
112
|
+
deadline, mustCount)`。通过 PancakeSwap 路由、聚合器或 GangRouter 的买入都是普通买入。只有 `GangHandlerAdmin.moduleOf(module)`
|
|
113
|
+
等于倒计时工厂、并且 `rewardToken()` 就是这个币时,才认作真的模块;只会回答 `moduleType() = countdown-v1` 的合约不算。
|
|
114
|
+
`gang buy` 会自动做这些检查,默认传 `mustCount = true`(`--cd-uncounted` 传 false),并在 `rewards.countdown` 里说明结果。
|
|
115
|
+
工厂:BSC 主网 `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`,BSC 测试网 `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582`。
|
|
116
|
+
|
|
108
117
|
### 失败代码
|
|
109
118
|
|
|
110
119
|
| `code` | 含义 |
|
package/README.md
CHANGED
|
@@ -24,7 +24,9 @@ Operate [gang.fun](https://gang.fun) from a Binance **Agentic Wallet**. Curve bu
|
|
|
24
24
|
|
|
25
25
|
**Opening base (0.40.0+, open on BSC mainnet and testnet):** `gang create … --base <5|10> --base-vest <30|90|180> [--grad 6|9|12|15]` creates a GangLaunchpad 3.0 curve token whose very first trade buys 5% or 10% of the supply for the token's own base vault (GangBaseVault, `base-v1`). The create pays exactly the pad's `previewBaseCost` in BNB as the tx value (5% at 6 / 9 / 12 / 15 BNB: 0.0994 / 0.1490 / 0.1987 / 0.2484 BNB; 10%: 0.2090 / 0.3135 / 0.4180 / 0.5225; the 1% fee included, 70% of it back as your creator fee). The vault never trades: the base is locked until graduation, then the first `gang base release` (anyone may call it) starts the clock and the base is released linearly over `--base-vest` days to the creator's wallet (5%: 30 / 90 / 180 days; 10%: 90 / 180; fixed for good). **If the token never graduates, the base and its cost stay locked for good.** The preview shows the cost, the schedule and the spec's payoff figures (the least you get, at the graduation price, days to recover the cost, the daily release, what other buyers pay more), and that GangBond does not constrain the base (the vault keeps refilling the creator's wallet, so a bond is no promise about it). WBNB quote only, no dividend, not with `--vault` / `--promote` / `--fair` / `--fly` or a launch in one command; on a taxed token the recipient is usually the creator. With abcd on, the create goes through `createWithSalt` with the BNB. The CLI asks the pad (`baseVaultImpl`) and refuses `--base` where it is not live. `gang base status --token 0x…` shows the vault, size, period, start (or not started), total, released, releasable and unreleased (counted by time); `gang base release --token 0x…` starts the release, then sends what has vested to the creator.
|
|
26
26
|
|
|
27
|
-
**Graduation reward (冲毕业奖励, 0.42.0+, open on BSC mainnet and testnet since 2026-11-17;
|
|
27
|
+
**Graduation reward (冲毕业奖励, 0.42.0+, open on BSC mainnet and testnet since 2026-11-17; with `--countdown-reward` and its carry 0.44.0+, open on mainnet and testnet since 2026-11-17):** `gang create … --grad-reward <seed> [--gr-min-buy <amount>] [--gr-entries <1-20>] [--gr-last <0-50>] [--gr-refund-days <30-180>]` creates a GangLaunchpad 3.0 curve token with a reward pool you seed in the token's quote (pulled in the create, so the CLI asks you to approve it first; at least 0.1 BNB worth). The pad keeps the last `--gr-entries` curve buys (default 10) that each actually spend `--gr-min-buy` (default 0.01 BNB worth), with the Agent gate on; the buy that graduates the token always counts. At graduation that buy gets `--gr-last` % of the pool on top (default 30), and all entries, it included, split the rest by what each spent. A curve sell takes out that wallet's earlier entries (a later buy counts again). Buyers claim for 180 days after graduation, then anyone sweeps the rest back to you. If the token does not graduate, `--gr-refund-days` (default 90) after the create you may ask for the pool back: the request is public for 7 days (a graduation in that time pays the buyers as usual), then you have 3 days to take it, else it lapses. Buyers pay only the usual price and fee: the pool is your money, paid to the last buys before graduation by a fixed public rule. Works with `--promote` on an untaxed token or with `--recipient`, and with `--countdown-reward`: then `--gr-carry` % of the pool (default 20) goes into the token's countdown reward module at graduation, and the unclaimed rest goes there too. Not with `--vault` / `--base` / `--fair` / `--fly` or a launch in one command. `gang buy` / `gang sell` previews say under `rewards.gradReward` whether the buy counts and what a sell takes out. `gang grad-reward status --token 0x…` shows the pool, rules, list, refund state and what you can claim; `claim`, `settle`, `sweep`, `retry-carry`, `refund-request`, `refund-cancel` and `refund` do the rest.
|
|
28
|
+
|
|
29
|
+
**Countdown reward (倒计时奖励, 0.43.2+, BSC mainnet and testnet):** `gang create … --buy-tax 3 --sell-tax 3 --countdown-reward --cd-max-payout <amount> [--cd-window 60m] [--cd-max-round 6h] [--cd-idle 30d] [--cd-payout 30] [--cd-last 20] [--cd-dev 0] [--cd-entries 10] [--cd-min-buy 0.05] [--cd-min-pot 0.1] [--cd-seed <amount>]` makes the token's tax recipient its own GangCountdownReward module (`countdown-v1`): your share of the pool tax becomes a reward for buyers. After graduation, each buy of at least `--cd-min-buy` through the module puts the countdown `--cd-window` ahead, but a round never runs past `--cd-max-round` from its first counted buy. When the countdown runs out, the round's last `--cd-entries` counted buys share `--cd-payout` % of the pool, never more than `--cd-max-payout` (required): equal shares, the very last buy `--cd-last` % of the payout on top; a round that ends at its cap pays equal shares only, since its end time was public. No round starts under `--cd-min-pot`; after `--cd-idle` days with no counted buy anyone may pay the last round once more. `--cd-dev` % of the arriving tax stays yours. `--cd-min-buy` / `--cd-min-pot` default to 0.05 / 0.1 BNB on a WBNB-quoted token and must be given for another quote. The preview shows what share of pool volume reaches the pool, what a round can pay at most and what taking every slot costs (slots × minimum buy × buy tax). Be clear with buyers: anyone, the creator included, can take slots with several wallets, and only buys through the module count, as the gang CLI and MCP send them (`gang buy`; not PancakeSwap's router, aggregators or GangRouter; the gang.fun site only shows the countdown). Like `--floor`, the module is cloned for the token's address first, then the token is created there, bound, and `--cd-seed` (if any) approved and funded: one tx per run, re-run the same command. A changed tax rate or `--cd-*` setting is refused. A fund preview that doesn't show up in the module's books is built again only with `--cd-seed-again`; the first may still be waiting for approval in the Binance App, so approve only one. With `--grad-reward` too (0.44.0+): `--gr-carry` % of that pool (default 20) goes into this module at graduation (see the graduation reward above). `gang buy` of a graduated countdown token goes through the module with `mustCount` (a buy that would not count is refused before anything is built; `--cd-uncounted` buys anyway); its preview's `rewards.countdown` says whether it counts and why, the round, its deadline and cap, the pool and your estimated share. `gang countdown status|claim|settle|finalize|claim-dev --token 0x… [--to 0x…]` does the rest. Factories: mainnet `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`, testnet `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582`.
|
|
28
30
|
|
|
29
31
|
**Call bond and follow binding (0.37.0+):** an agent can back its own call — a buy note on a GangLaunchpad 3.0 curve token — with a bond: buy with `--note`, then within 10 minutes `gang call-bond post --token 0x… --amount 0.1 --for 48h` (the note defaults to the wallet's latest buy of the token; `--hold` defaults to the whole balance). Until settle the wallet's balance of the token stays ≥ hold; one sell, vault lock or transfer below it — also after the deadline, until `gang call-bond settle` has run (two steps, 1 hour apart) — and anyone can `gang call-bond report` it: 1% to the reporter, half burnt, the rest paid to the note's followers by their loss (`gang call-bond claim` once the root's 2-day dispute window is over). Nothing of a broken bond comes back to the caller. Quotes: WBNB, USDT, USDC, USD1. A caller's `gang v3 sell` below its hold is refused unless `--break-call-bond`. On a token with a promoter share, `gang follow` binds the note's author as the wallet's promoter for good (it builds `buyWithPromoter`; same price and fee; `--no-promoter` for a plain follow). GangCallBond is live on BSC mainnet (`0x6d6e4A36e9a231cCc932151cdbFb087Cf3860c3D`, deployed 2026-11-09, owned by the platform's Safe; built in) and the BSC testnet (`0xBE2B8519278E9D31B6c4040bAd35f727fD5d2A70`).
|
|
30
32
|
|
|
@@ -154,6 +156,8 @@ gang create … --base 5|10 --base-vest 30|90|180 [--grad 6|9|12|15] # 3.0 open
|
|
|
154
156
|
gang base status|release --token 0x… # the base vault: size, period, start, released, releasable, unreleased; release starts the clock, then sends what has vested to the creator
|
|
155
157
|
gang create … --grad-reward <seed> [--gr-min-buy <amt>] [--gr-entries 1-20] [--gr-last 0-50] [--gr-refund-days 30-180] # 3.0 graduation reward: a pool you seed for the last buys before graduation, by what each spent
|
|
156
158
|
gang grad-reward status|claim|settle|sweep|retry-carry|refund-request|refund-cancel|refund --token 0x… # the pool, list and claims; the creator's refund with a 7-day notice
|
|
159
|
+
gang create … --buy-tax 3 --sell-tax 3 --countdown-reward --cd-max-payout 1 [--cd-* …] [--cd-seed 0.2] # V3 countdown reward: your tax share as buyers' rewards
|
|
160
|
+
gang countdown status|claim|settle|finalize|claim-dev --token 0x… [--to 0x…] # the round, the pool, claims; gang buy goes through the module
|
|
157
161
|
gang create --fair … [--shares <n>] --bond <quote> [--bond-hold …] --bond-days <7-90> # 打新: create (dev shares) → bond
|
|
158
162
|
gang execute --request-id <id>
|
|
159
163
|
gang tx --pending # trades approved in the Binance App: found by the exact call previewed, then as below
|
|
@@ -363,6 +367,7 @@ timed-out `gang_execute`, check `gang_status` / the wallet history instead of ex
|
|
|
363
367
|
| `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) |
|
|
364
368
|
| `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` |
|
|
365
369
|
| `GANG_FLOOR_FACTORY` / `GANG_TESTNET_FLOOR_FACTORY` | GangFloorModuleFactory of the create target (`--floor` on a taxed V3 launch). Built in: mainnet `0x057d2C1557a0E8298a1E00834D6064497f5DC2fC`, testnet `0x0804C018201D8fFe378b873b41B67f136dbdc3F8` |
|
|
370
|
+
| `GANG_COUNTDOWN_FACTORY` / `GANG_TESTNET_COUNTDOWN_FACTORY` | GangCountdownRewardFactory of the create target (`--countdown-reward`). CLI 0.43.2+; built in: mainnet `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`, testnet `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582` |
|
|
366
371
|
| `GANG_CALL_BOND` / `GANG_TESTNET_CALL_BOND` | GangCallBond of GangLaunchpad 3.0 (`gang call-bond`). CLI 0.37.0+; built in: mainnet `0x6d6e4A36e9a231cCc932151cdbFb087Cf3860c3D`, testnet `0xBE2B8519278E9D31B6c4040bAd35f727fD5d2A70` |
|
|
367
372
|
| `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`) |
|
|
368
373
|
| `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`) |
|
package/README.zh-CN.md
CHANGED
|
@@ -24,17 +24,27 @@
|
|
|
24
24
|
|
|
25
25
|
**开盘底仓(0.40.0+,BSC 主网和测试网可用):** `gang create … --base <5|10> --base-vest <30|90|180> [--grad 6|9|12|15]` 在 GangLaunchpad 3.0 上建一个曲线币,它的第一笔成交就是给这个币专属的底仓金库(GangBaseVault,`base-v1`)买入总量的 5% 或 10%。建币交易按 pad 的 `previewBaseCost` 正好付这么多 BNB(5% 在 6 / 9 / 12 / 15 BNB 档:0.0994 / 0.1490 / 0.1987 / 0.2484 BNB;10%:0.2090 / 0.3135 / 0.4180 / 0.5225;含 1% 手续费,其中 70% 作为创建人手续费返还给你)。金库不交易:毕业前底仓锁住;毕业后第一次有人调 `gang base release`(谁都可以调)开始计时,之后在 `--base-vest` 天里匀速释放到创建人的钱包(5%:30 / 90 / 180 天;10%:90 / 180 天;写死不能改)。**如果代币永远不毕业,底仓和为它付的钱永远锁着,收不回来。** 预览里有花费、释放节奏和规格里的收益表(最少能拿多少、按毕业价算多少、几天收回成本、每天释放量、其他买家多付多少),并说明保证金约束不了底仓(金库一直往创建人钱包里补币,保证金不代表对底仓的任何承诺)。只支持 WBNB 计价,不能带分红,不能和 `--vault` / `--promote` / `--fair` / `--fly` 或一条命令发射一起用;带税时收款人通常就是创建人自己。开启 abcd 时建币经 `createWithSalt` 带上 BNB 发出。CLI 会先问 pad(`baseVaultImpl`),没开放的地方直接拒绝 `--base`。`gang base status --token 0x…` 显示金库、底仓大小、释放期、开始时间(或未开始)、总量、已释放、可释放和未释放(按时间算);`gang base release --token 0x…` 第一次调用开始计时,之后把已经到期的部分转给创建人。
|
|
26
26
|
|
|
27
|
-
**冲毕业奖励(0.42.0+,BSC 主网和测试网 2026-11-17
|
|
27
|
+
**冲毕业奖励(0.42.0+,BSC 主网和测试网 2026-11-17 起可用;和 `--countdown-reward` 一起用、转一部分给倒计时奖励要 0.44.0+,主网和测试网 2026-11-17 起已开):** `gang create … --grad-reward <种子钱> [--gr-min-buy <金额>] [--gr-entries <1-20>] [--gr-last <0-50>] [--gr-refund-days <30-180>]` 在 GangLaunchpad 3.0 上建一个曲线币,同时用这个币的报价币放进一笔奖励池。种子钱在建币时拉走,所以 CLI 会先让你批准;至少值 0.1 BNB。
|
|
28
28
|
|
|
29
29
|
- **谁能分**:pad 记下最后 `--gr-entries` 笔(默认 10)曲线买入,每笔都要实际花掉 `--gr-min-buy`(默认值 0.01 BNB),而且 Agent 门槛开着;把币推过毕业线的那一笔一律计入。
|
|
30
30
|
- **怎么分**:毕业时,这一笔先额外拿奖励池的 `--gr-last`%(默认 30),剩下的由所有格子(包括这一笔)按各自实际花掉的金额分。
|
|
31
31
|
- **卖出**:在曲线上卖出,这个钱包之前的格子全部失效;之后再买会重新计入。
|
|
32
32
|
- **领取**:毕业后 180 天内买家自己领,之后任何人都可以把剩下的部分退给你。
|
|
33
33
|
- **不毕业**:建币满 `--gr-refund-days` 天(默认 90)后,你可以申请撤回。申请公示 7 天,期间毕业照常发放;公示期满后 3 天内可以取回,过期就要重新申请。
|
|
34
|
-
- **组合**:可以和 `--promote` 一起用(不带税,或者带 `--recipient
|
|
34
|
+
- **组合**:可以和 `--promote` 一起用(不带税,或者带 `--recipient`);也可以和 `--countdown-reward` 一起用:毕业时奖励池的 `--gr-carry`%(默认 20)转进这个币的倒计时奖励模块,没领的剩余也转进去,不退给你;不能和 `--vault` / `--base` / `--fair` / `--fly` 或一条命令发射一起用。
|
|
35
35
|
|
|
36
36
|
买家只付正常的价格和手续费:奖励池是你自己的钱,按公开的固定规则发给毕业前最后几笔买入。`gang buy` / `gang sell` 的预览会在 `rewards.gradReward` 里说明这笔会不会计入、卖出会让哪些格子失效。`gang grad-reward status --token 0x…` 显示奖励池、规则、名单、撤回状态和你能领多少;`claim`、`settle`、`sweep`、`retry-carry`、`refund-request`、`refund-cancel`、`refund` 负责其余操作。
|
|
37
37
|
|
|
38
|
+
**倒计时奖励(0.43.2+,BSC 主网和测试网):** `gang create … --buy-tax 3 --sell-tax 3 --countdown-reward --cd-max-payout <金额> [--cd-window 60m] [--cd-max-round 6h] [--cd-idle 30d] [--cd-payout 30] [--cd-last 20] [--cd-dev 0] [--cd-entries 10] [--cd-min-buy 0.05] [--cd-min-pot 0.1] [--cd-seed <金额>]` 把币的税收接收地址设成它自己的倒计时奖励模块(GangCountdownReward,`countdown-v1`):你那份池子税变成买家的奖励。
|
|
39
|
+
|
|
40
|
+
- **怎么计入**:毕业后,每笔通过模块买入、至少 `--cd-min-buy` 的买单,把倒计时推到 `--cd-window` 之后;一轮最长不超过第一笔计入后的 `--cd-max-round`。
|
|
41
|
+
- **怎么分**:倒计时结束时,这一轮最后 `--cd-entries` 笔计入的买入平分奖励池的 `--cd-payout`%(不超过必填的 `--cd-max-payout`),最后一笔再多拿这一轮的 `--cd-last`%。到上限结束的轮次结束时间是公开的,所以只平分,不发额外部分。
|
|
42
|
+
- **其他**:奖励池低于 `--cd-min-pot` 时不开新轮;连续 `--cd-idle` 天没有计入的买入,任何人可以把最后一轮再发一次。`--cd-dev`% 的税留给你。WBNB 报价的币 `--cd-min-buy` / `--cd-min-pot` 默认 0.05 / 0.1 BNB,其他报价币必须写明。
|
|
43
|
+
- **预览**:写明池子成交额有多少进奖励池、一轮最多发多少、占满所有名额要花多少(名额数 × 最低买入 × 买入税)。要如实告诉买家:任何人(包括你自己)都可以用多个钱包占名额;只有 gang CLI / MCP 通过模块发出的买入才算(`gang buy`;PancakeSwap 路由、聚合器、GangRouter 都不算;gang.fun 网站只展示倒计时)。
|
|
44
|
+
- **步骤**:和 `--floor` 一样,先算出币的地址并为它克隆模块,再在这个地址建币、bind,有 `--cd-seed` 时再批准和 fund。每次运行一笔交易,重复运行同一条命令。中途改了税率或 `--cd-*` 设置会被拒绝。fund 预览构建过、但模块账目里还看不到时,只有加 `--cd-seed-again` 才会再构建一笔;前一笔可能还在 Binance App 里等批准,两笔只批一笔。也可以同时加 `--grad-reward`(0.44.0+):毕业时冲毕业奖励池的 `--gr-carry`%(默认 20)转进这个模块(见上面的冲毕业奖励)。
|
|
45
|
+
|
|
46
|
+
毕业后的 `gang buy` 默认通过模块买入并要求计入(不计入的买单在构建前就会拒绝;`--cd-uncounted` 照买不计入),预览的 `rewards.countdown` 写明计不计入、原因、当前轮次、截止时间和上限、奖励池、你的预计份额。`gang countdown status|claim|settle|finalize|claim-dev --token 0x… [--to 0x…]` 负责其余操作。工厂:主网 `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`,测试网 `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582`。
|
|
47
|
+
|
|
38
48
|
**喊单保证金和跟单绑定(0.37.0+):** agent 可以给自己的喊单(GangLaunchpad 3.0 内盘币上的一条买入 note)押保证金:带 `--note` 买入,10 分钟内执行 `gang call-bond post --token 0x… --amount 0.1 --for 48h`(note 默认取这个钱包最近一次买这个币的交易;`--hold` 默认是全部余额)。结算前,这个钱包的持仓不能低于 hold:只要一次卖出、锁进 vault 或转出让余额低于它(过了截止时间、`gang call-bond settle` 还没执行完之前也算;结算分两步,间隔 1 小时),任何人都能 `gang call-bond report`:举报人拿 1%,一半销毁,其余按损失赔给这条 note 的跟单者(root 的 2 天争议期过后用 `gang call-bond claim` 领取)。违约的保证金一分都不会回到喊单者。报价币:WBNB、USDT、USDC、USD1。喊单者用 `gang v3 sell` 卖到低于 hold 会被拒,除非加 `--break-call-bond`。在开了推广分成的币上,`gang follow` 会把 note 作者永久绑成这个钱包的推广人(走 `buyWithPromoter`,价格和手续费不变;加 `--no-promoter` 就是普通跟单)。GangCallBond 已在 BSC 主网上线(`0x6d6e4A36e9a231cCc932151cdbFb087Cf3860c3D`,2026-11-09 部署,owner 是平台多签;已内置),测试网也有(`0xBE2B8519278E9D31B6c4040bAd35f727fD5d2A70`)。
|
|
39
49
|
|
|
40
50
|
**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`)上交易。
|
|
@@ -142,6 +152,8 @@ gang create … --base 5|10 --base-vest 30|90|180 [--grad 6|9|12|15] # 3.0 开
|
|
|
142
152
|
gang base status|release --token 0x… # 底仓金库:大小、释放期、开始时间、已释放、可释放、未释放;release 第一次开始计时,之后把到期的部分转给创建人
|
|
143
153
|
gang create … --grad-reward <种子钱> [--gr-min-buy <金额>] [--gr-entries 1-20] [--gr-last 0-50] [--gr-refund-days 30-180] # 3.0 冲毕业奖励:你出钱奖励毕业前最后几笔买入,按花费分
|
|
144
154
|
gang grad-reward status|claim|settle|sweep|retry-carry|refund-request|refund-cancel|refund --token 0x… # 奖励池、名单和领取;创建人撤回要先公示 7 天
|
|
155
|
+
gang create … --buy-tax 3 --sell-tax 3 --countdown-reward --cd-max-payout 1 [--cd-* …] [--cd-seed 0.2] # V3 倒计时奖励:你那份税变成买家的奖励
|
|
156
|
+
gang countdown status|claim|settle|finalize|claim-dev --token 0x… [--to 0x…] # 轮次、奖励池、领取;gang buy 默认走模块
|
|
145
157
|
gang create --fair … [--shares <n>] --bond <数量> [--bond-hold …] --bond-days <7-90> # 打新:发币(含 dev 份额)→ 押金
|
|
146
158
|
gang execute --request-id <id>
|
|
147
159
|
gang tx --pending # 在 Binance App 里批准过的交易:按预览时的调用自动找到交易,再按下面这条处理
|
|
@@ -323,6 +335,7 @@ Claude Code:`claude mcp add gang -- gang mcp`。同一台机器上 `baw` 要
|
|
|
323
335
|
| `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 没有) |
|
|
324
336
|
| `GANG_CAPPED_FACTORY` / `GANG_TESTNET_CAPPED_FACTORY` | 发币目标那一代的 GangCappedSplitterFactory(有税 V3 发射的 `--tax-cap`)。CLI 0.35.0+;已内置:主网 `0x294E901ecb66af280C1cDD26fD871601d89a2Dca`,测试网 `0xe3f61865d98993dd39c136Af19651C6F6686498A` |
|
|
325
337
|
| `GANG_FLOOR_FACTORY` / `GANG_TESTNET_FLOOR_FACTORY` | 发币目标那一代的 GangFloorModuleFactory(有税 V3 发射的 `--floor`)。已内置:主网 `0x057d2C1557a0E8298a1E00834D6064497f5DC2fC`,测试网 `0x0804C018201D8fFe378b873b41B67f136dbdc3F8` |
|
|
338
|
+
| `GANG_COUNTDOWN_FACTORY` / `GANG_TESTNET_COUNTDOWN_FACTORY` | 发币目标那一代的 GangCountdownRewardFactory(`--countdown-reward`)。CLI 0.43.2+;已内置:主网 `0xa1e3117a59104de7D97667cF22f9AB886a5f2957`,测试网 `0x0f83ABC7d39C0d043d3f5612E304D9395B5fe582` |
|
|
326
339
|
| `GANG_CALL_BOND` / `GANG_TESTNET_CALL_BOND` | GangLaunchpad 3.0 的 GangCallBond(`gang call-bond`)。CLI 0.37.0+;已内置:主网 `0x6d6e4A36e9a231cCc932151cdbFb087Cf3860c3D`,测试网 `0xBE2B8519278E9D31B6c4040bAd35f727fD5d2A70` |
|
|
327
340
|
| `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`) |
|
|
328
341
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gangfun/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.44.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",
|
package/src/capabilities.js
CHANGED
|
@@ -65,6 +65,8 @@ export const COMMANDS = [
|
|
|
65
65
|
c('upload-logo', 'publish', 'medium', '0.2.0', 'Publish a local image or a URL on gang.fun, at once: only a file the user named', { needsUserConfirmation: true }),
|
|
66
66
|
c('create', 'preview', 'high', '0.1.0', 'Launch a token. Its name, tax, logo and links never change; a launch in one command also buys, bonds or binds modules'),
|
|
67
67
|
c('create --grad-reward', 'preview', 'high', '0.42.0', 'Create a 3.0 curve token with a reward pool the creator seeds for the last curve buys before graduation (by what each spent; the graduating buy gets a share on top); refundable only after a public notice if it never graduates'),
|
|
68
|
+
c('create --countdown-reward', 'preview', 'high', '0.43.2', "Launch a taxed 3.0 token whose tax recipient is its countdown reward module: the creator's share of the pool tax becomes a reward the last counted buys of each round share when its countdown runs out; every setting fixed for good, several steps (clone, create, bind, seed)"),
|
|
69
|
+
c('create --countdown-reward --grad-reward', 'preview', 'high', '0.44.0', "Launch a taxed 3.0 token with both rewards: the countdown reward module as its tax recipient, and a graduation reward pool the creator seeds; at graduation --gr-carry % of that pool (default 20) goes into the module's reward pool, and the unclaimed rest later too. A carry needs the pad to have opened it; --gr-carry 0 launches both without one"),
|
|
68
70
|
c('create --base', 'preview', 'high', '0.40.0', 'Create a 3.0 curve token that buys 5% or 10% of its supply for a base vault in the same tx, paid in BNB: locked until graduation (for good if it never graduates), then released linearly to the creator'),
|
|
69
71
|
c('mint', 'preview', 'medium', '0.12.0', 'Buy shares of a 打新 or Mint Flywheel sale'),
|
|
70
72
|
c('withdraw', 'preview', 'medium', '0.12.0', 'Sell shares back at the mint price, less the exit fee, before the sale fills', { riskIf: { 'break-bond': { risk: 'high', why: '打新 only: gives up the whole bond' } } }),
|
|
@@ -111,6 +113,11 @@ export const COMMANDS = [
|
|
|
111
113
|
c('grad-reward refund-request', 'preview', 'medium', '0.42.0', 'Creator, on the curve, after --gr-refund-days: ask for the pool back; starts a public 7-day notice'),
|
|
112
114
|
c('grad-reward refund-cancel', 'preview', 'low', '0.42.0', 'Creator: cancel a running refund request'),
|
|
113
115
|
c('grad-reward refund', 'preview', 'medium', '0.42.0', 'Creator, within 3 days after the notice, the token still on its curve: take the pool back; the reward ends for good'),
|
|
116
|
+
c('countdown status', 'read', 'none', '0.43.2', "A token's countdown reward: the rules, the pool, the running round (deadline, cap, slots), what is due and what a wallet can claim; whether the factory made the module for this token"),
|
|
117
|
+
c('countdown claim', 'preview', 'low', '0.43.2', "Buyer: claim everything the countdown reward credited to this wallet", { riskIf: { to: { risk: 'high', why: 'pays the reward to another address' } } }),
|
|
118
|
+
c('countdown settle', 'preview', 'low', '0.43.2', 'Anyone, once a round passed its deadline: end it and credit its slots'),
|
|
119
|
+
c('countdown finalize', 'preview', 'low', '0.43.2', "Anyone, after the idle days with no counted buy: pay the last round's slots once more (at most the max payout)"),
|
|
120
|
+
c('countdown claim-dev', 'preview', 'low', '0.43.2', "Anyone: send the dev its kept part of the tax (always to the dev)"),
|
|
114
121
|
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"),
|
|
115
122
|
c('promote status', 'read', 'none', '0.34.0', "A token's promoter terms, a wallet's binding and what it can claim"),
|
|
116
123
|
c('promote earnings', 'read', 'none', '0.34.0', 'A promoter wallet: shares to claim on the curve and in the pool'),
|