@gangfun/cli 0.12.0 → 0.14.0

package/README.md

@@ -74,6 +74,22 @@ gang create --fair --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60]
 gang v3 income --recipient 0x…               # a recipient's income per token (gang.fun)
 # aliases: gang v3 <list|info|status|create|buy|sell|claim|release|tx>, gang fair <list|info|status|create|mint|withdraw|buy|sell|claim|tx>
 #   run the same code (their results carry useInstead)
+# Creator bond (押金承诺, GangBond): from create on, the creator bonds quote that it keeps ≥ X tokens; T = graduation / launch + --days
+gang bond post --token <addr> --hold <tokens|N%> --days <7-90> (--amount <quote> | --cover 100) [--use-wbnb]  # creator, from create on (--cover once on the pair); WBNB quote: paid in BNB unless --use-wbnb
+gang bond topup --token <addr> (--amount <quote> | --cover <%>) | gang bond raise-hold --token <addr> --hold <tokens|N%>
+gang bond extend --token <addr> --days <n>                       # creator: bond only grows, X only rises, the commitment only gets longer
+gang bond status --token <addr>                                  # state, pending / running, X vs the creator's balance, coverage + tier, time left
+gang bond start --token <addr>                                   # anyone, once graduated / launched: start the --days clock
+gang bond report --token <addr>                                  # anyone, below X: 1% to you, the rest buys back and burns
+gang bond settle --token <addr>                                  # anyone, after T while X is held: the bond goes back to the creator
+gang bond refund --token <addr>                                  # creator: no pair 30 days after the post → ask, then 3 days later get it back
+gang bond burn --token <addr> | gang bond tx --hash <0x..>       # push one buy-back chunk / decode GangBond events
+#   A creator's gang sell (curve or pool) / gang withdraw below X is refused unless --break-bond (past T: --settle-first)
+# Launch in one command: one tx per run — execute it, run the very same command again, until launch.stage = done
+gang create … --dev-buy <quote> [--bond <quote> [--bond-hold <tokens|N%|all>] --bond-days <7-90>]  # V3: create → dev buy → bond
+gang create … --buy-tax 3 --sell-tax 3 --buyback 50 [--buyback-to 0x…] [--dev-buy …]  # V3: the recipient's part of the tax 50% bought back + burned, the rest to you (or --buyback-to)
+gang buyback status|set|set-payee|apply --token 0x… [--pct 0-100] [--to 0x…]  # the buy-back splitter: ratio (raise now, cut after 3 days), payee (at once), what waits
+gang create --fair … [--shares <n>] --bond <quote> [--bond-hold …] --bond-days <7-90>                 # 打新: create (dev shares) → bond
 gang execute --request-id <id>
 gang tx --hash <0x..> [--testnet]            # V2 / Soft and GangLaunchpad events (GangLaunchpad: units "raw", amounts in wei)
 ```
@@ -206,8 +222,9 @@ gang agents --window 30d --sort follow
 | `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 V3 and 打新 (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_BOND` / `GANG_TESTNET_BOND` | GangBond (creator bonds, `gang bond`). Testnet built in (`0xB034…EBE3`); mainnet not deployed yet |
 | `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.12.0` · repo [gangfun/cli](https://github.com/gangfun/cli) · published to [npm](https://www.npmjs.com/package/@gangfun/cli) on push to `main`
+`0.14.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

@@ -64,6 +64,22 @@ gang create --fair --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60]
 gang v3 income --recipient 0x…               # 接收地址按币统计的到账（读 gang.fun）
 # 别名：gang v3 <list|info|status|create|buy|sell|claim|release|tx>、gang fair <list|info|status|create|mint|withdraw|buy|sell|claim|tx>
 #   跑的是同一套代码（结果里带 useInstead）
+# 押金承诺（GangBond）：发币后随时可押，创建者押一笔报价币，承诺创建地址至少持有 X 枚；T = 毕业 / 开盘时间 + --days
+gang bond post --token <addr> --hold <枚数|N%> --days <7-90> (--amount <报价币数量> | --cover 100) [--use-wbnb]  # 创建者，发币后随时可押（--cover 要等开盘）；WBNB 报价默认付 BNB，--use-wbnb 付 WBNB
+gang bond topup --token <addr> (--amount <数量> | --cover <%>) | gang bond raise-hold --token <addr> --hold <枚数|N%>
+gang bond extend --token <addr> --days <天数>                    # 创建者：押金只能加、X 只能提高、承诺期只能变长
+gang bond status --token <addr>                                  # 状态（待开始 / 计时中）、X 和创建者余额、覆盖率和档位、剩余时间
+gang bond start --token <addr>                                   # 任何人，毕业 / 开盘后开始计时
+gang bond report --token <addr>                                  # 任何人，余额低于 X 时举报：拿押金 1%，其余回购销毁
+gang bond settle --token <addr>                                  # 任何人，T 之后余额仍达标：押金退回创建者
+gang bond refund --token <addr>                                  # 创建者：押后 30 天仍未开盘，先申请，3 天公告期后再执行一次取回
+gang bond burn --token <addr> | gang bond tx --hash <0x..>       # 推进一块回购销毁 / 解析 GangBond 事件
+#   创建者用 gang sell（内盘或外盘）/ gang withdraw 卖到低于 X 会被拒，除非加 --break-bond（过了 T：--settle-first 先取回）
+# 一条命令发射：每次运行产出一笔交易，执行后再运行同一条命令，直到 launch.stage = done
+gang create … --dev-buy <报价币数量> [--bond <数量> [--bond-hold <枚数|N%|all>] --bond-days <7-90>]  # V3：发币 → dev 内盘买入 → 押金
+gang create … --buy-tax 3 --sell-tax 3 --buyback 50 [--buyback-to 0x…] [--dev-buy …]  # V3：接收地址那份税 50% 回购销毁，其余给你（或 --buyback-to 指定的地址）
+gang buyback status|set|set-payee|apply --token 0x… [--pct 0-100] [--to 0x…]  # 回购合约：比例（提高立即生效，下调 3 天后）、收款地址（立即生效）、待回购金额
+gang create --fair … [--shares <n>] --bond <数量> [--bond-hold …] --bond-days <7-90>                    # 打新：发币（含 dev 份额）→ 押金
 gang execute --request-id <id>
 gang tx --hash <0x..> [--testnet]            # 解析 V2 / Soft 和 GangLaunchpad 的事件（GangLaunchpad 的带 units "raw"，金额是 wei）
 ```
@@ -179,8 +195,9 @@ gang agents --window 30d --sort follow
 | `GANG_UPDATE_URL` | 新版本检查查询的地址，默认 `https://registry.npmjs.org/@gangfun/cli/latest`；npmjs 慢或打不开时，可以换成 npm 镜像的 `…/@gangfun/cli/latest` |
 | `GANG_PAD` / `GANG_TESTNET_PAD` | 覆盖合并后的内盘合约 GangLaunchpad（主网 / 测试网），V3 和打新共用（默认：主网 `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_BOND` / `GANG_TESTNET_BOND` | GangBond（押金承诺，`gang bond`）。测试网已内置（`0xB034…EBE3`）；主网尚未部署 |
 | `GANG_ROUTER` / `GANG_TESTNET_ROUTER` | GangRouter 代理（用原生 BNB 买 V3 / 打新，以及已毕业币的所有外盘买卖）；旧名 `GANG_ROUTER_TESTNET` 仍可用。默认：主网 `0xE040…79C4`，测试网第 10 套 `0x6bB6…C9F6` |
 
 ## 版本
 
-`0.12.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
+`0.14.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gangfun/cli",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "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.",
   "type": "module",
   "bin": {