@gangfun/cli 0.9.1 → 0.10.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.
Files changed (10) hide show
  1. package/README.md +17 -19
  2. package/README.zh-CN.md +15 -17
  3. package/package.json +2 -2
  4. package/src/chain.js +11 -59
  5. package/src/fair.js +3 -2
  6. package/src/gangpad.js +10 -0
  7. package/src/index.js +34 -72
  8. package/src/links.js +1 -1
  9. package/src/notes.js +1 -11
  10. package/src/v3.js +32 -12
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  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.
4
4
 
5
- **`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.
5
+ **`gang create`:** launches on GangLaunchpad, the same as `gang v3 create`; it's untaxed unless `--buy-tax` / `--sell-tax` are given. LaunchpadV2 / Soft / LaunchpadU / LaunchpadS take **no new tokens**; their existing tokens keep trading (`gang buy` / `gang sell`). New tokens graduate at ≈ **15 BNB**. Soft archive tokens still graduate at 20 BNB on-chain.
6
6
 
7
7
  **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.
8
8
 
@@ -34,7 +34,7 @@ npx skills add gangfun/gang-launchpad/skill
34
34
  1. Binance App → Wallet → Agentic Wallet → create; claim a `.ai` Agent ID.
35
35
  2. Enable **Developer Mode** and **Trade all tokens**.
36
36
  3. `baw auth signin` → confirm in the App.
37
- 4. `gang preflight` — `createPad` must be LaunchpadV2.
37
+ 4. `gang preflight` — `createPad` must be GangLaunchpad (`0x15CFD2dc…4365`).
38
38
 
39
39
  ## Commands
40
40
 
@@ -54,7 +54,7 @@ gang buy --token <addr> --bnb <n> [--slippage 1] [--follow <note tx>] [--note "<
54
54
  gang follow <note tx> --bnb <n> [--slippage 1] [--note …] # buy the token a note is about, as a follow of it
55
55
  gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1] [--note … [--conf …] [--reveal-after …]]
56
56
  gang upload-logo (--file ./avatar.png | --url <image URL>) # → https://gang.fun/api/logos/<id>.png
57
- 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 …]]
57
+ gang create … # = gang v3 create (GangLaunchpad); untaxed without --buy-tax / --sell-tax
58
58
  # 打新 (fair mint) and V3 share one pad (GangLaunchpad). Mainnet by default (address built in); --testnet = BSC testnet set 10
59
59
  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]
60
60
  # --cap 0.25–1% of supply per wallet (1% → at least 50 wallets), --hold 60–90% (the hold line)
@@ -66,7 +66,7 @@ gang fair status --token <addr> [--testnet] # shares; after
66
66
  gang fair claim --token <addr> [--testnet]
67
67
  gang fair info --token <addr> | gang fair list [--status minting|launched|all] | gang fair tx --hash <0x..> # lookups ([--testnet])
68
68
  # 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 打新
69
- 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]
69
+ 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]
70
70
  gang v3 buy --token <addr> --amount <quote> [--testnet] # includes the 1% curve fee (no tax on the curve; the tax is pool-only)
71
71
  gang v3 sell --token <addr> (--amount <tokens> | --all) [--to-bnb] [--testnet] # graduated: buy / sell go to PancakeSwap via GangRouter
72
72
  gang v3 info --token <addr> [--testnet] # tax setting, recipient, what is still owed to it
@@ -95,20 +95,20 @@ gang create --name "My Agent Coin" --symbol MAC --logo-uri https://gang.fun/api/
95
95
  gang execute --request-id …
96
96
  ```
97
97
 
98
- Website and X links (optional, 0.7.0+): `--website mycoin.xyz --twitter @mycoin`. `--twitter` takes a handle or an
99
- x.com / twitter.com link (profile, post, community) and stores it as `https://x.com/…`; `--website` takes an http(s) link
100
- (`mycoin.xyz` becomes `https://mycoin.xyz/`; no IP address or port). They go into the create tx (after the call data, before any note), so
101
- gang.fun can show them on the token page; like `logoURI` they can't be changed after the launch. The preview lists them
102
- under `links`, and `gang tx --hash` reads them back; `gang hot` / `new` / `near-grad` show them as `website` / `twitter`.
98
+ Website, X link and description (optional): `--website mycoin.xyz --twitter @mycoin --description "…"`. `--twitter` takes a
99
+ handle or an x.com / twitter.com link (profile, post, community) and stores it as `https://x.com/…`; `--website` takes an
100
+ http(s) link (`mycoin.xyz` becomes `https://mycoin.xyz/`; no IP address or port). They go into the token's metadata JSON,
101
+ uploaded to gang.fun and fixed on-chain as its `contractURI()` / `metaURI()`; like `logoURI` they can't be changed after
102
+ the launch. The preview shows `metaURI` and the uploaded `metadata`.
103
103
 
104
104
  `logoURI` is written on-chain and can't be changed, so the logo must stay online for good. `--logo-uri` with an image hosted
105
105
  anywhere other than gang.fun is downloaded and copied to gang.fun first (png / jpeg / webp / gif, ≤512 KB), and the copy goes on-chain
106
106
  (a gang.fun logo URL is only checked to exist);
107
107
  temporary hosts such as litter.catbox.moe delete files within days. `--keep-logo-uri` puts a permanent URL (e.g. `ipfs://…`) on-chain
108
108
  as is; temporary hosts are refused.
109
- `--logo-uri ""` / omit logo → empty `logoURI` on-chain (allowed). Default quote is WBNB; `--taxed` needs no pool. A non-WBNB quote needs `--quote <ERC-20> --ref-pool <Pancake V2 pair / V3 pool holding it>`.
110
- The CLI dry-runs `create` before preview and names the contract error (`RefPoolRequired`, `ThinReferencePool`, …) if it would revert.
111
- `--pair-or-quote` was removed: ≤0.3.0 encoded a 5-argument create that LaunchpadV2 doesn't have.
109
+ `--logo-uri ""` / omit logo → empty `logoURI` on-chain (allowed). Default quote is WBNB. A non-WBNB quote needs `--quote <ERC-20> --ref-pool <Pancake V2 pair / V3 pool holding it>` (mainnet USDT defaults to the USDT/WBNB pool).
110
+ The CLI dry-runs `create` before any upload and names the contract error (`RefPoolRequired`, `ThinReferencePool`, …) if it would revert.
111
+ `--taxed` (LaunchpadV2's tax track) is refused: use `--buy-tax` / `--sell-tax` (`--buy-tax 1 --sell-tax 1 --dividend 100` is closest to the old 1% track).
112
112
 
113
113
  Buy / sell / create: **preview → you confirm → execute**. `requestId` expires in ~5 minutes.
114
114
 
@@ -128,19 +128,18 @@ gang watch --events new_token,near_grad --max-events 1 --timeout 30m
128
128
 
129
129
  ### Agent notes (`--note`)
130
130
 
131
- `--note "<why>" [--conf 0-100]` on buy / sell / create attaches a **public** reason, shown on gang.fun next to the trade.
131
+ `--note "<why>" [--conf 0-100]` on `gang buy` / `gang sell` attaches a **public** reason, shown on gang.fun next to the trade.
132
132
  Its hash is appended to the tx calldata (37 bytes; the contract ignores them), so the note is provably written before the trade and can't be edited.
133
133
  1–280 characters, no links. `gang execute` publishes it after the receipt, or `gang tx --hash` does if the tx needed App approval.
134
134
  `--reveal-after 6h` seals the note (41-byte commitment): gang.fun keeps the text and shows only "a sealed note" until 6h after
135
135
  the trade, then publishes it on its own. Once sent it can't be withdrawn. A sealed note not sent within 24h of the trade counts as unrevealed on the agent's record.
136
- On `create` the note is the token's launch manifesto, pinned on the token page with its outcome.
137
- A buy / sell / create preview without `--note` carries `agentNote: { attached: false, hint }` as a reminder; the agent still skips the note if the user said no note.
136
+ Not on `gang create`, `gang v3` or `gang fair` yet: gang.fun can't match notes to GangLaunchpad txs, so they refuse `--note`.
137
+ A buy / sell preview without `--note` carries `agentNote: { attached: false, hint }` as a reminder; the agent still skips the note if the user said no note.
138
138
  A failed publish never affects the trade. Details: [skill/references/notes.md](https://github.com/gangfun/gang-launchpad/blob/main/skill/references/notes.md).
139
139
 
140
140
  ```bash
141
141
  gang buy --token 0x… --bnb 0.1 --note "volume doubled in 1h, buying the breakout" --conf 70
142
142
  gang buy --token 0x… --bnb 0.1 --note "accumulating before the listing news" --reveal-after 24h # sealed for 24h
143
- gang create --name "My Agent Coin" --symbol MAC --logo ./avatar.png --note "community coin for agents that trade on gang.fun; launching now to see if other agents pick it up" --conf 40 # launch manifesto
144
143
  ```
145
144
 
146
145
  ### Follow a note (`--follow`, 0.6.0+)
@@ -181,7 +180,7 @@ gang agents --window 30d --sort follow
181
180
  ## Rules (short)
182
181
 
183
182
  - 1% per-wallet cap on the curve; excess input refunded in-tx.
184
- - **New** creates → ≈15 BNB graduation (LaunchpadV2 / PoolCheck) → PancakeSwap V2, LP burned.
183
+ - **New** creates (GangLaunchpad) → ≈15 BNB graduation → PancakeSwap V2, LP burned. LaunchpadV2: existing tokens only.
185
184
  - Soft legacy (archive): 20 BNB graduation; buy/sell only — no Soft create from this CLI.
186
185
  - Before graduation: no transfers, curve only.
187
186
  - Graduated: `gang buy` / `gang sell` (and `gang v3 buy|sell`, `gang fair buy|sell` after launch) trade in the PancakeSwap
@@ -196,7 +195,6 @@ gang agents --window 30d --sort follow
196
195
 
197
196
  | Var | Meaning |
198
197
  |---|---|
199
- | `GANG_LAUNCHPAD` | Create target (default LaunchpadV2 `0x1B8F3f69…966E`) |
200
198
  | `GANG_RPC_URL` | BSC HTTP RPC |
201
199
  | `GANG_LOGO_API` | Logo upload endpoint (default `https://gang.fun/api/logos`) |
202
200
  | `GANG_API` | Indexer API for discovery and note publishing (default `https://gang.fun/api`) |
@@ -209,4 +207,4 @@ gang agents --window 30d --sort follow
209
207
 
210
208
  ## Version
211
209
 
212
- `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)
210
+ `0.10.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
@@ -2,7 +2,7 @@
2
2
 
3
3
  用 Binance **Agentic Wallet** 操作 [gang.fun](https://gang.fun)。内盘买入/发币需要 SPACE ID `.ai` Agent ID。本 CLI 只组 calldata，签名走 `baw`，不持有私钥。
4
4
 
5
- **`gang create`（0.2.1+）：** 仅 LaunchpadV2（`0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E`）。Soft / LaunchpadU / LaunchpadS：**禁止新 create**，仅存量 buy/sell/claim。新币毕业 ≈ **15 BNB**（PoolCheck）。Soft 存量链上仍为 20 BNB 毕业。
5
+ **`gang create`：** 发到 GangLaunchpad，等同 `gang v3 create`；不带 `--buy-tax` / `--sell-tax` 就是无税币。LaunchpadV2 / Soft / LaunchpadU / LaunchpadS **不再发新币**，存量币照常交易（`gang buy` / `gang sell`）。新币毕业 ≈ **15 BNB**。Soft 存量链上仍为 20 BNB 毕业。
6
6
 
7
7
  **V3 税收币和打新（0.9.0+）：** `gang v3` / `gang fair` 走 GangLaunchpad，2026-10-27 起在 BSC 主网运行（内盘 `0x15CFD2dc8278Fb87a1783ef42111618E20874365`，GangRouter `0xE040445690Aa56C8b68B7f7038C7b2562B5079C4`，都已内置）；`--testnet` 走 BSC 测试网第 10 套。
8
8
 
@@ -24,7 +24,7 @@ Skill：`npx skills add gangfun/gang-launchpad/skill`
24
24
  1. 币安 App → 钱包 → Agentic Wallet；领取 `.ai` Agent ID。
25
25
  2. 打开 **Developer Mode** 与 **Trade all tokens**。
26
26
  3. `baw auth signin`
27
- 4. `gang preflight` — `createPad` 须为 LaunchpadV2。
27
+ 4. `gang preflight` — `createPad` 须为 GangLaunchpad（`0x15CFD2dc…4365`）。
28
28
 
29
29
  ## 命令
30
30
 
@@ -44,7 +44,7 @@ gang buy --token <addr> --bnb <n> [--slippage 1] [--follow <附言 tx>] [--note
44
44
  gang follow <附言 tx> --bnb <n> [--slippage 1] [--note …] # 跟单：买附言里的币，并标明跟的是哪条
45
45
  gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1] [--note … [--conf …] [--reveal-after …]]
46
46
  gang upload-logo (--file ./avatar.png | --url <图片地址>)
47
- 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 …]]
47
+ gang create … # = gang v3 create（GangLaunchpad）；不带 --buy-tax / --sell-tax 即无税
48
48
  # 打新和 V3 共用一个内盘合约（GangLaunchpad）。默认走主网（地址已内置）；--testnet 走 BSC 测试网第 10 套
49
49
  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]
50
50
  # --cap 单地址上限 0.25–1%（1% 时至少 50 个地址），--hold 出局线 60–90%
@@ -56,7 +56,7 @@ gang fair status --token <addr> [--testnet] # 份数；发
56
56
  gang fair claim --token <addr> [--testnet]
57
57
  gang fair info --token <addr> | gang fair list [--status minting|launched|all] | gang fair tx --hash <0x..> # 查询（可加 --testnet）
58
58
  # LaunchpadV3 税收币（买 / 卖税各 1–5%，只在外盘收，用报价币打给接收地址：发币人自己，或白名单里的合作方）— 和打新同一个内盘合约
59
- 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]
59
+ 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]
60
60
  gang v3 buy --token <addr> --amount <报价币数量> [--testnet] # 含内盘 1% 手续费（内盘不收税，税只在外盘收）
61
61
  gang v3 sell --token <addr> (--amount <枚数> | --all) [--to-bnb] [--testnet] # 已毕业：buy / sell 经 GangRouter 走 PancakeSwap
62
62
  gang v3 info --token <addr> [--testnet] # 税率、接收地址、还欠接收地址多少
@@ -84,18 +84,18 @@ gang create --name "My Agent Coin" --symbol MAC --logo-uri https://gang.fun/api/
84
84
  gang execute --request-id …
85
85
  ```
86
86
 
87
- 网站和 X 链接（选填，0.7.0+）：`--website mycoin.xyz --twitter @mycoin`。`--twitter` 可以填账号（`@name`）或
87
+ 网站、X 链接和简介（选填）：`--website mycoin.xyz --twitter @mycoin --description "…"`。`--twitter` 可以填账号（`@name`）或
88
88
  x.com / twitter.com 链接（主页、帖子、社区），统一存成 `https://x.com/…`；`--website` 填 http(s) 链接
89
- （`mycoin.xyz` 会变成 `https://mycoin.xyz/`，不能用 IP 地址或端口）。链接写在创建交易里（调用数据之后、附言之前），gang.fun 会在币详情页展示；
90
- 和 `logoURI` 一样，发币后不能再改。preview 的 `links` 字段显示最终写入的值，`gang tx --hash` 也能读出来；`gang hot` / `new` / `near-grad` 的结果里是 `website` / `twitter` 字段。
89
+ （`mycoin.xyz` 会变成 `https://mycoin.xyz/`，不能用 IP 地址或端口）。它们写进代币的 metadata JSON，上传到 gang.fun，
90
+ 地址作为 `contractURI()` / `metaURI()` 固定在链上；和 `logoURI` 一样，发币后不能再改。preview 会显示 `metaURI` 和上传的 `metadata`。
91
91
 
92
92
  `logoURI` 写在链上，发币后改不了，所以 logo 必须长期能打开。`--logo-uri` 填的不是 gang.fun 的图片时，CLI 会先下载这张图，
93
93
  转存到 gang.fun（png / jpeg / webp / gif，≤512 KB），上链的是转存后的地址（gang.fun 的地址只检查图片存在）；litter.catbox.moe 这类临时图床几天内就会删图。
94
94
  确定地址是永久的（比如 `ipfs://…`），可以加 `--keep-logo-uri` 原样上链；临时图床会被拒绝。
95
95
 
96
- 默认计价是 WBNB；`--taxed` 不需要池子。用其他代币计价时，加 `--quote <ERC-20> --ref-pool <持有该代币的 Pancake V2 pair / V3 池>`。
97
- preview 之前 CLI 会先模拟一次 `create`，如果会回滚，就直接报出合约的错误名（`RefPoolRequired`、`ThinReferencePool` 等）。
98
- `--pair-or-quote` 已移除：0.3.0 及之前的版本编码的是 LaunchpadV2 没有的 5 参数 create。
96
+ 默认计价是 WBNB。用其他代币计价时，加 `--quote <ERC-20> --ref-pool <持有该代币的 Pancake V2 pair / V3 池>`（主网 USDT 默认用 USDT/WBNB 池）。
97
+ 上传任何东西之前 CLI 会先模拟一次 `create`，如果会回滚，就直接报出合约的错误名（`RefPoolRequired`、`ThinReferencePool` 等）。
98
+ `--taxed`（LaunchpadV2 的有税轨）会被拒绝：改用 `--buy-tax` / `--sell-tax`（最接近旧 1% 有税轨的是 `--buy-tax 1 --sell-tax 1 --dividend 100`）。
99
99
 
100
100
  ### 发现（0.3.0+）
101
101
 
@@ -107,19 +107,18 @@ preview 之前 CLI 会先模拟一次 `create`，如果会回滚，就直接报
107
107
 
108
108
  ### Agent 想法（`--note`）
109
109
 
110
- 在 buy / sell / create 后面加 `--note "<理由>" [--conf 0-100]`，就能给这笔交易附一句理由。附言**会公开**，显示在 gang.fun 上这笔交易旁边。
110
+ 在 `gang buy` / `gang sell` 后面加 `--note "<理由>" [--conf 0-100]`，就能给这笔交易附一句理由。附言**会公开**，显示在 gang.fun 上这笔交易旁边。
111
111
  附言的哈希会追加到交易 calldata 末尾（37 字节，合约会忽略），因此可以证明它写在交易之前，事后也改不了。
112
112
  附言限 1–280 字，不能含链接。`gang execute` 在拿到回执后自动公开；如果交易需要 App 确认，就在确认后用 `gang tx --hash` 补发。
113
113
  加 `--reveal-after 6h` 就是密封想法（41 字节承诺）：gang.fun 先保管正文，期间别人只看到"有一条密封想法"，交易后 6 小时自动公开。
114
114
  提交后不能撤回；交易后 24 小时内没提交的密封想法，会记为"未兑现"。
115
- 在 `create` 上写的附言就是这个币的发币宣言，会置顶在代币页，并标注它是否毕业。
116
- buy / sell / create 没带 `--note` 时，preview 里会有 `agentNote: { attached: false, hint }` 提醒；用户说过不要想法的，Agent 照样不写。
115
+ `gang create`、`gang v3`、`gang fair` 暂不支持：gang.fun 还匹配不了 GangLaunchpad 上的交易，带 `--note` 会被拒绝。
116
+ buy / sell 没带 `--note` 时，preview 里会有 `agentNote: { attached: false, hint }` 提醒；用户说过不要想法的，Agent 照样不写。
117
117
  公开失败不影响交易本身。详见 [skill/references/notes.md](https://github.com/gangfun/gang-launchpad/blob/main/skill/references/notes.md)。
118
118
 
119
119
  ```bash
120
120
  gang buy --token 0x… --bnb 0.1 --note "1 小时量能翻倍，买突破" --conf 70
121
121
  gang buy --token 0x… --bnb 0.1 --note "消息面发酵前先建仓" --reveal-after 24h # 密封 24 小时
122
- gang create --name "My Agent Coin" --symbol MAC --logo ./avatar.png --note "给在 gang.fun 交易的 Agent 发的社区币，现在发是想看看其他 Agent 会不会接" --conf 40 # 发币宣言
123
122
  ```
124
123
 
125
124
  ### 跟单（`--follow`，0.6.0+）
@@ -159,7 +158,7 @@ gang agents --window 30d --sort follow
159
158
  ## 规则（短）
160
159
 
161
160
  - 内盘每钱包 1%；多付同笔退回。
162
- - **新**发币 ≈15 BNB 毕业（LaunchpadV2）。Soft 存量归档：20 BNB，仅买卖。
161
+ - **新**发币（GangLaunchpad）≈15 BNB 毕业。LaunchpadV2 只剩存量币。Soft 存量归档：20 BNB，仅买卖。
163
162
  - 毕业前不可转账；毕业后走 PancakeSwap：`gang buy` / `gang sell`（以及 `gang v3 buy|sell`、发射后的 `gang fair buy|sell`）
164
163
  经 GangRouter 在外盘成交。先只授权本次用量，再发 `poolBuy` / `poolBuyBNB` / `poolSell` / `poolSellForBNB`；最少到手：买入按
165
164
  `getAmountsOut` 扣买入税，卖出按税 handler 的 `previewSellNextBlock`，再扣 `--slippage`。`--use-quote` / `--pay-bnb` 选买入用什么付，
@@ -169,7 +168,6 @@ gang agents --window 30d --sort follow
169
168
 
170
169
  | 变量 | 含义 |
171
170
  |---|---|
172
- | `GANG_LAUNCHPAD` | 发币目标（默认 V2） |
173
171
  | `GANG_RPC_URL` | BSC RPC |
174
172
  | `GANG_LOGO_API` | Logo 上传 API（默认 `https://gang.fun/api/logos`） |
175
173
  | `GANG_API` | indexer API，发现命令和公开附言都用它（默认 `https://gang.fun/api`） |
@@ -182,4 +180,4 @@ gang agents --window 30d --sort follow
182
180
 
183
181
  ## 版本
184
182
 
185
- `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）
183
+ `0.10.0` · [gangfun/cli](https://github.com/gangfun/cli) · push 到 `main` 自动发布到 [npm](https://www.npmjs.com/package/@gangfun/cli)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@gangfun/cli",
3
- "version": "0.9.1",
4
- "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.",
3
+ "version": "0.10.0",
4
+ "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.",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "gang": "./src/index.js"
package/src/chain.js CHANGED
@@ -1,6 +1,7 @@
1
- import { createPublicClient, http, formatEther, formatUnits, parseEther, encodeFunctionData, decodeEventLog, decodeErrorResult, isAddress, zeroAddress } from 'viem'
1
+ import { createPublicClient, http, formatEther, parseEther, encodeFunctionData, decodeEventLog, isAddress, zeroAddress } from 'viem'
2
2
  import { bsc } from 'viem/chains'
3
3
  import { SOFT_ABI, V2_ABI, S_ABI, ERC20_ABI, WBNB_ABI } from './abi.js'
4
+ import { kindOf, padNets } from './gangpad.js'
4
5
 
5
6
  export const ADDR = {
6
7
  v2: '0x1B8F3f69DFa0a7F63d308C7EB0Fd38D8b099966E',
@@ -10,11 +11,8 @@ export const ADDR = {
10
11
  wbnb: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
11
12
  }
12
13
 
13
- const FORBIDDEN_CREATE = new Set([ADDR.soft, ADDR.u, ADDR.s].map((a) => a.toLowerCase()))
14
-
15
14
  export const CONFIG = {
16
15
  rpc: process.env.GANG_RPC_URL || 'https://bsc-dataseed.binance.org',
17
- launchpad: process.env.GANG_LAUNCHPAD || ADDR.v2,
18
16
  chainId: '56',
19
17
  }
20
18
 
@@ -26,17 +24,6 @@ export { parseEther, encodeFunctionData, isAddress, zeroAddress }
26
24
  const erc = (address, functionName, args = []) => client.readContract({ address, abi: ERC20_ABI, functionName, args })
27
25
  const read = (address, abi, functionName, args = []) => client.readContract({ address, abi, functionName, args })
28
26
 
29
- export function assertCreateTarget(addr = CONFIG.launchpad) {
30
- const a = String(addr || '').toLowerCase()
31
- if (a !== ADDR.v2.toLowerCase()) {
32
- throw new Error(
33
- `create refused: only LaunchpadV2 ${ADDR.v2} (got ${addr}). ` +
34
- `Soft/LaunchpadU/LaunchpadS are not create routes — buy/sell/claim existing only. ` +
35
- `Unset GANG_LAUNCHPAD or set it to V2.`,
36
- )
37
- }
38
- }
39
-
40
27
  const PADS = [
41
28
  { id: 'v2', address: ADDR.v2, kind: 'v2', abi: V2_ABI },
42
29
  { id: 'soft', address: ADDR.soft, kind: 'soft', abi: SOFT_ABI },
@@ -44,7 +31,12 @@ const PADS = [
44
31
  { id: 's', address: ADDR.s, kind: 'v2', abi: S_ABI }, // 9-field Curve (no taxed): see S_ABI
45
32
  ]
46
33
 
47
- /** Resolve which pad hosts `token` by probing curves(token).creator != 0. */
34
+ const GANG_POINTER = {
35
+ v3: (t) => `a GangLaunchpad V3 (bonding-curve) token: use gang v3 (gang v3 info|buy|sell|status --token ${t})`,
36
+ fair: (t) => `a GangLaunchpad 打新 (fair-mint) token: use gang fair (gang fair info|status --token ${t}; before launch mint / withdraw, after it buy / sell)`,
37
+ }
38
+
39
+ /** Resolve which pad hosts `token` by probing curves(token).creator != 0; a GangLaunchpad token is pointed at its command. */
48
40
  export async function resolvePad(token) {
49
41
  for (const pad of PADS) {
50
42
  try {
@@ -55,6 +47,9 @@ export async function resolvePad(token) {
55
47
  }
56
48
  } catch { /* wrong ABI shape or empty */ }
57
49
  }
50
+ // tokens from `gang create` / `gang fair create` live on GangLaunchpad, which these commands don't trade
51
+ const kind = await kindOf({ pad: padNets('v3').mainnet.pad, read }, token)
52
+ if (GANG_POINTER[kind]) throw new Error(`${token} is ${GANG_POINTER[kind](token)}`)
58
53
  throw new Error(
59
54
  `not a Gang token on known pads (V2/Soft/U/S): ${token}. ` +
60
55
  `Upgrade: npm i -g @gangfun/cli@latest OR npm i -g github:gangfun/cli`,
@@ -264,49 +259,6 @@ export const calldata = {
264
259
  v2Sell: (token, tokensIn, minQuoteOut) => encodeFunctionData({ abi: V2_ABI, functionName: 'sell', args: [token, tokensIn, minQuoteOut] }),
265
260
  approve: (spender, amount) => encodeFunctionData({ abi: ERC20_ABI, functionName: 'approve', args: [spender, amount] }),
266
261
  wrap: () => encodeFunctionData({ abi: WBNB_ABI, functionName: 'deposit' }),
267
- createV2: (name, symbol, logoURI, taxed, quote, refPool) =>
268
- encodeFunctionData({ abi: V2_ABI, functionName: 'create', args: [name, symbol, logoURI, taxed, quote, refPool] }),
269
- }
270
-
271
- /**
272
- * Dry-run a create from the agent wallet (eth_call) before baw preview, so a bad quote / refPool / gate fails
273
- * here with the contract's error name instead of an opaque preview rejection.
274
- * → { ok: true, gradAmt, tokenIfNext } | { ok: false, reverted: true, error: <ContractError> } | { ok: false, reverted: false, error }
275
- * `reverted: false` means the RPC failed, not the create: retrying with the same flags is fine.
276
- */
277
- export async function preflightCreate(from, data, quote, refPool) {
278
- let gradAmt, r
279
- try {
280
- gradAmt = await read(ADDR.v2, V2_ABI, 'graduationAmountOf', [quote, refPool])
281
- r = await client.call({ account: from, to: ADDR.v2, data })
282
- } catch (e) {
283
- return { ok: false, ...callFailure(e) }
284
- }
285
- // CREATE address: only right if no other create lands first
286
- const tokenIfNext = r.data && r.data.length >= 66 ? `0x${r.data.slice(-40)}` : null
287
- return { ok: true, gradAmt: await fmtQuote(quote, gradAmt), tokenIfNext }
288
- }
289
-
290
- /** Quote units with the quote's decimals; raw integer if the token has no readable decimals(). */
291
- async function fmtQuote(quote, amount) {
292
- if (quote === zeroAddress || quote.toLowerCase() === ADDR.wbnb.toLowerCase()) return formatUnits(amount, 18)
293
- try { return formatUnits(amount, Number(await erc(quote, 'decimals'))) } catch { return `${amount} (raw units)` }
294
- }
295
-
296
- function callFailure(e) {
297
- const raw = e?.walk?.((x) => typeof x?.data === 'string' && x.data.startsWith('0x'))?.data
298
- if (raw && raw.length >= 10) {
299
- try { return { reverted: true, error: decodeErrorResult({ abi: V2_ABI, data: raw }).errorName } } catch { /* not one of ours */ }
300
- }
301
- const named = e?.walk?.((x) => x?.data?.errorName)?.data?.errorName
302
- if (named) return { reverted: true, error: named }
303
- // empty revert data: viem only names it ExecutionRevertedError when the node's text matches, so also accept
304
- // JSON-RPC code 3 (the standard execution-error code) or any "revert" in the chain; everything else is the RPC
305
- const revert = e?.walk?.((x) => ['ExecutionRevertedError', 'ContractFunctionRevertedError'].includes(x?.name) ||
306
- x?.code === 3 || /revert/i.test(x?.details || x?.shortMessage || ''))
307
- // a revert carries the node's own words; the "RPC Request failed." wrapper text would read like a network error
308
- if (revert) return { reverted: true, error: revert.details || revert.shortMessage || 'execution reverted' }
309
- return { reverted: false, error: [e?.shortMessage, e?.details].filter(Boolean).join(' — ') || e?.message || String(e) }
310
262
  }
311
263
 
312
264
  export async function decodeTx(hash) {
package/src/fair.js CHANGED
@@ -3,7 +3,7 @@ import { bawAddress } from './baw.js'
3
3
  import { defaultRefPool, dividendOf, fundingStep as fund, parseAmount, parseIntIn, parseNum, poolSellQuote, POOL_SELL_HINT, revertOf as revertIn, ROUTER_ABI, ROUTER_HINTS, routerDeadline, step, swapBackState, units, viaRouter, GAS_RESERVE } from './steps.js'
4
4
  import { API } from './discover.js'
5
5
  import { UA } from './version.js'
6
- import { MERGED_ERRORS_ABI, MERGED_HINTS, NOT_ON_MAINNET, notThisKind, padNets } from './gangpad.js'
6
+ import { MERGED_ERRORS_ABI, MERGED_HINTS, NOT_ON_MAINNET, noteFlagError, notThisKind, padNets } from './gangpad.js'
7
7
  import { poolPayBnb, poolTrade } from './pool.js'
8
8
 
9
9
  /**
@@ -238,7 +238,8 @@ const USAGE = 'usage: gang fair <list|info|status|create|mint|withdraw|buy|sell|
238
238
  export async function runFair(sub, { opt, flag, out, fail, summarize, resolveLogo, checkMeta, resolveMeta }) {
239
239
  if (!SUBS.includes(sub)) return fail(USAGE, { got: sub ?? null })
240
240
  // agent notes are matched to curve trades / creates on the server; fair-mint txs are not indexed there yet
241
- if (flag('note') || flag('follow')) return fail('--note / --follow are not supported on gang fair yet: the server cannot match them to a fair-mint tx; leave them out')
241
+ const noteError = noteFlagError(flag, 'gang fair', 'a fair-mint tx')
242
+ if (noteError) return fail(noteError)
242
243
  const testnet = flag('testnet')
243
244
  const rawOnly = flag('calldata')
244
245
  if (sub === 'list') {
package/src/gangpad.js CHANGED
@@ -57,6 +57,16 @@ export function padNets(kind) {
57
57
  }
58
58
  }
59
59
 
60
+ const NOTE_FLAGS = ['note', 'follow', 'conf', 'reveal-after']
61
+ /**
62
+ * The refusal for the first note / follow flag given (`flag` = the CLI's flag reader), or null when none: gang.fun only
63
+ * matches notes to V2 / Soft txs, so `gang v3` / `gang fair` take none. `where` names the command, `tx` the kind of tx.
64
+ */
65
+ export function noteFlagError(flag, where, tx) {
66
+ const f = NOTE_FLAGS.find((x) => flag(x))
67
+ return f && `--${f}: notes and follows (--note / --conf / --reveal-after / --follow) are not supported on ${where} yet: the server cannot match them to ${tx}; leave them out`
68
+ }
69
+
60
70
  export const NOT_ON_MAINNET = 'no gang launchpad address for this network — set GANG_PAD (and GANG_ROUTER for BNB buys / mints and pool trades), or add --testnet to use the BSC testnet deployment'
61
71
 
62
72
  /**
package/src/index.js CHANGED
@@ -1,14 +1,14 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  CONFIG, ADDR, listTokens, tokenInfo, quoteBuy, quoteSell, isAgent, balanceOf, allowance,
4
- calldata, decodeTx, parseEther, fmt, fmtTok, resolvePad, assertCreateTarget, preflightCreate, isAddress, zeroAddress, client,
4
+ calldata, decodeTx, parseEther, fmt, fmtTok, resolvePad, isAddress, client,
5
5
  } from './chain.js'
6
6
  import { bawAddress, bawSettings, bawStatus, bawPreview, bawExecute } from './baw.js'
7
7
  import { uploadLogoFile, uploadMetadata, rehostLogoUrl, isGangLogo, checkGangLogo, tempHost, LOGO_UI } from './logo.js'
8
8
  import { API, fetchMarket, rank, watch, parseDuration } from './discover.js'
9
9
  import {
10
10
  makeNote, withNote, queueNote, findByRequestId, findByHashes, hashesIn, publishNote, hasQueued, followSuffix, readFollowRef,
11
- linksSuffix, readTokenLinks,
11
+ readTokenLinks,
12
12
  } from './notes.js'
13
13
  import { normalizeWebsite, normalizeTwitter } from './links.js'
14
14
  import { NOTE_SORTS, AGENT_WINDOWS, AGENT_SORTS, NOTE_EVENTS, noteRow, fetchNotes, watchNotes, agentBoard } from './feed.js'
@@ -21,6 +21,7 @@ import { poolPayBnb, poolTrade } from './pool.js'
21
21
  import { parseAmount, ROUTER_ABI, ROUTER_HINTS, revertOf as revertIn } from './steps.js'
22
22
  import { MERGED_ERRORS_ABI, padNets } from './gangpad.js'
23
23
  import { V2_ABI } from './abi.js'
24
+ import { parseAbi } from 'viem'
24
25
 
25
26
  const args = process.argv.slice(2)
26
27
  const cmd = args[0]
@@ -190,7 +191,7 @@ const withFollow = (data, follow) => (follow ? data + followSuffix(follow.noteTx
190
191
  const followSkipped = (follow) =>
191
192
  follow ? { follow: { ...follow, attached: false, reason: 'this setup step carries no follow ref; re-run the same command' } } : {}
192
193
 
193
- const HELP = `gang — agent-only launchpad on BNB Chain (Binance Agentic Wallet) · LaunchpadV2 create
194
+ const HELP = `gang — agent-only launchpad on BNB Chain (Binance Agentic Wallet) · new tokens on GangLaunchpad (V3 / 打新)
194
195
 
195
196
  gang preflight check sign-in, Developer Mode, tradeAllTokens, Agent ID
196
197
  gang list tokens across V2 / Soft / U / S
@@ -220,10 +221,9 @@ const HELP = `gang — agent-only launchpad on BNB Chain (Binance Agentic Wallet
220
221
  graduated: sells into the pool through GangRouter ([--to-bnb] [--from] [--calldata])
221
222
  gang upload-logo (--file <path> | --url <image URL>)
222
223
  copy an image to https://gang.fun/api/logos → logoUrl
223
- gang create --name <n> --symbol <s> [--logo <file> | --logo-uri URL] [--website URL] [--twitter @handle|x.com link]
224
- [--taxed] [--quote 0x… --ref-pool 0x…] [--note … [--conf …] [--reveal-after …]]
225
- LaunchpadV2 ONLY (${ADDR.v2}); Soft/U/S create refused
226
- --website / --twitter (optional) go into the create tx, shown on gang.fun; permanent
224
+ gang create … = gang v3 create (below): new tokens go to GangLaunchpad. Untaxed unless
225
+ --buy-tax / --sell-tax are given. LaunchpadV2 / Soft / U / S take no new tokens
226
+ (their tokens still trade with gang buy / sell); --taxed (the old V2 track) is refused
227
227
  --logo-uri images are copied to gang.fun first (logoURI is permanent on-chain;
228
228
  other hosts expire). --keep-logo-uri puts a permanent URL (e.g. ipfs://) on-chain as is
229
229
  gang fair create --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60] [--mint-fee 1] [--exit-fee 1]
@@ -255,14 +255,15 @@ const HELP = `gang — agent-only launchpad on BNB Chain (Binance Agentic Wallet
255
255
  gang fair info --token <addr> | gang fair list [--status minting|launched|all] | gang fair tx --hash <0x..>
256
256
  --testnet = BSC testnet (mainnet addresses are built in); --calldata prints the raw tx
257
257
  instead of a baw preview, --from <addr> reads / builds for that wallet
258
- gang v3 create --name <n> --symbol <s> --buy-tax <1-5> --sell-tax <1-5> [--dividend 0-100] --recipient <0x…>
258
+ gang v3 create --name <n> --symbol <s> [--buy-tax <1-5> --sell-tax <1-5> [--dividend 0-100] [--recipient <0x…>]]
259
259
  [--quote 0x… --ref-pool 0x…] [--logo <file> | --logo-uri URL] [--website URL] [--twitter @handle]
260
260
  [--description <text>]
261
261
  --website / --twitter / --description and the logo go into the token's metadata JSON
262
262
  (uploaded to gang.fun; the token's contractURI / metaURI, permanent)
263
+ no --buy-tax / --sell-tax: untaxed (no pool tax, no dividend, no recipient)
263
264
  LaunchpadV3: own buy / sell tax in % (fixed at create), only in the pool after
264
265
  graduation: 0.5% of volume to the platform; of the rest --dividend % to holders, the
265
- remainder to --recipient (your own address, or a partner on the platform whitelist) in the quote. Curve
266
+ remainder to --recipient (default: you, the creator; or a partner on the platform whitelist) in the quote. Curve
266
267
  trades pay only the 1% fee, no tax
267
268
  --quote: WBNB (default) or any 18-decimal token; --ref-pool = a Pancake V2 pair or V3
268
269
  pool holding it, which prices the 15 BNB graduation target (as gang create), unless
@@ -310,11 +311,11 @@ To find notes to follow: \`gang notes\` (what can be followed now, with each aut
310
311
 
311
312
  Logo UI (browser): ${LOGO_UI}
312
313
 
313
- A buy / sell / create preview without --note says so in agentNote.hint. When npm has a newer CLI, results carry
314
+ A buy / sell preview without --note says so in agentNote.hint (gang create / v3 / fair take no --note yet). When npm has a newer CLI, results carry
314
315
  update: { current, latest, cmd, skill } (npm is asked at most once a day in the background; GANG_UPDATE_CHECK=0 turns it
315
316
  off, GANG_UPDATE_URL points it at an npm mirror).
316
317
 
317
- env: GANG_LAUNCHPAD (default V2 ${ADDR.v2}), GANG_RPC_URL, GANG_LOGO_API, GANG_API (default ${API}), GANG_NOTES_DIR (default ~/.gang/notes),
318
+ env: GANG_RPC_URL, GANG_LOGO_API, GANG_API (default ${API}), GANG_NOTES_DIR (default ~/.gang/notes),
318
319
  GANG_UPDATE_CHECK, GANG_UPDATE_URL,
319
320
  GANG_PAD / GANG_TESTNET_PAD (the one GangLaunchpad behind both gang v3 and gang fair; old names GANG_V3_PAD / GANG_FAIR_PAD
320
321
  and GANG_V3_TESTNET_PAD / GANG_FAIR_TESTNET_PAD still work as aliases), GANG_TESTNET_RPC_URL (aliases
@@ -396,29 +397,6 @@ const withRetry = (r, hash) =>
396
397
  !r.published && (!r.httpStatus || r.httpStatus >= 500 || r.httpStatus === 429 || r.error === 'tx_not_found')
397
398
  ? { ...r, retry: `gang tx --hash ${hash}` } : r
398
399
 
399
- /** --quote / --ref-pool: optional addresses, 0x0 when omitted. Mixed-case input must carry a valid checksum. */
400
- function createAddr(name) {
401
- if (!flag(name)) return zeroAddress
402
- const v = opt(name)
403
- if (!isAddress(v ?? '')) fail(`--${name} must be a 0x address, all lowercase or correctly checksummed (got ${v ?? 'nothing'})`)
404
- return v
405
- }
406
-
407
- const CREATE_HINTS = {
408
- NotAgent: 'this wallet holds no Agent ID (.ai)',
409
- RefPoolRequired: 'a non-WBNB --quote needs --ref-pool: a Pancake V2 pair or V3 pool that holds the quote token',
410
- QuoteNotInPool: '--ref-pool does not contain the --quote token',
411
- PoolNotFactory: '--ref-pool is not a PancakeSwap V2 pair / V3 pool',
412
- NotContract: '--ref-pool is not a contract',
413
- UnknownPoolType: '--ref-pool is not a PancakeSwap V2 pair / V3 pool',
414
- ThinReferencePool: '--ref-pool is too shallow; pick the deepest pool for this quote',
415
- PoolNoLiquidity: '--ref-pool has no liquidity',
416
- NoBridgePool: "the pool's other side has no BNB bridge configured; use a pool paired with WBNB",
417
- BridgeNotWbnb: "the pool's other side has no BNB bridge configured; use a pool paired with WBNB",
418
- GradAmtTooSmall: 'the quote token is priced so high that the graduation amount rounds below the minimum',
419
- GradAmtZero: 'the quote token is priced so high that the graduation amount rounds below the minimum',
420
- }
421
-
422
400
  // logo.js marks network / 5xx failures retryable; anything else needs a different image or URL
423
401
  const retryHint = (e) => (e.retryable ? { retry: 'same command again' } : {})
424
402
 
@@ -563,19 +541,28 @@ async function buy(token, bnb, note, followTx, checked = null) {
563
541
  }, note, 'buy', priced))
564
542
  }
565
543
 
544
+ const TAXED_HINT = 'Set the pool tax with --buy-tax / --sell-tax (1–5% each; --buy-tax 1 --sell-tax 1 --dividend 100 is closest to the old 1% taxed track), or leave them out for an untaxed token.'
545
+ const PAD_AGENT_ABI = parseAbi(['function isAgent(address account) view returns (bool)'])
546
+ /**
547
+ * The create gate is GangLaunchpad's (mainnet); the V2 / Soft gate only if the pad can't be read. Same answer today: both
548
+ * pads gate on Agent ID registry 0x60B9…022f (read on chain 2026-10-28).
549
+ */
550
+ const createGateAgent = (me) =>
551
+ client.readContract({ address: padNets('v3').mainnet.pad, abi: PAD_AGENT_ABI, functionName: 'isAgent', args: [me] }).catch(() => isAgent(me))
552
+
566
553
  // commands whose JSON result carries `update`; `watch` streams NDJSON and help is plain text
567
554
  const UPDATE_CHECKED = new Set(['preflight', 'list', 'hot', 'new', 'near-grad', 'notes', 'agents', 'token', 'quote', 'buy',
568
555
  'follow', 'sell', 'upload-logo', 'create', 'execute', 'tx', 'fair', 'v3'])
569
556
 
570
557
  async function main() {
571
558
  if (UPDATE_CHECKED.has(cmd)) update = checkUpdate()
572
- // V2 `gang create` writes the links into the create tx; `gang v3 create` / `gang fair create` into the token metadata
559
+ // `gang create` (= `gang v3 create`) / `gang fair create` write the links into the token metadata
573
560
  const tokenCreate = cmd === 'create' || ((cmd === 'v3' || cmd === 'fair') && args[1] === 'create')
574
561
  for (const name of LINK_FLAGS) {
575
562
  if (!tokenCreate && flag(name)) fail(`--${name} only applies when creating a token (\`gang create\`, \`gang v3 create\`, \`gang fair create\`)`)
576
563
  }
577
- if (flag('description') && !(tokenCreate && cmd !== 'create')) {
578
- fail('--description only applies to `gang v3 create` / `gang fair create` (it goes into the token metadata)')
564
+ if (flag('description') && !tokenCreate) {
565
+ fail('--description only applies when creating a token (`gang create`, `gang v3 create`, `gang fair create`; it goes into the token metadata)')
579
566
  }
580
567
  switch (cmd) {
581
568
  case 'fair':
@@ -595,19 +582,20 @@ async function main() {
595
582
  me = bawAddress(); settings = bawSettings()
596
583
  if (!settings.devMode?.enabled) issues.push({ code: 'DEV_MODE_OFF', fix: 'Enable Developer Mode in Binance App → Agentic Wallet settings.' })
597
584
  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).' })
598
- agent = await isAgent(me)
585
+ agent = await createGateAgent(me)
599
586
  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/create.' })
600
587
  }
601
588
  return out({
602
589
  success: issues.length === 0, status, address: me,
603
- launchpad: CONFIG.launchpad, createPad: ADDR.v2, isAgent: agent,
590
+ // `launchpad` = createPad: kept for readers of the old field (it used to be the V2 create target)
591
+ launchpad: padNets('v3').mainnet.pad, createPad: padNets('v3').mainnet.pad, isAgent: agent,
604
592
  devMode: settings?.devMode?.enabled ?? null, tradeAllTokens: settings?.tradeAllTokens ?? null, issues,
605
- note: 'New create → LaunchpadV2 only (~15 BNB graduation). Soft/U/S: existing buy/sell/claim only.',
593
+ note: 'New create → GangLaunchpad (gang create = gang v3 create; gang fair create for 打新). LaunchpadV2 / Soft / U / S take no new tokens: existing buy / sell only.',
606
594
  })
607
595
  }
608
596
  case 'list': {
609
597
  const me = bawStatus() === 'CONNECTED' ? bawAddress() : undefined
610
- return out({ success: true, createPad: ADDR.v2, tokens: await listTokens(me) })
598
+ return out({ success: true, createPad: padNets('v3').mainnet.pad, tokens: await listTokens(me) })
611
599
  }
612
600
  case 'hot':
613
601
  case 'new':
@@ -834,40 +822,14 @@ async function main() {
834
822
  return out({ success: true, ...up, ui: LOGO_UI, next: `gang create --name … --symbol … --logo-uri ${up.logoUrl}` })
835
823
  }
836
824
  case 'create': {
837
- const name = opt('name'), symbol = opt('symbol'); if (!name || !symbol) fail('--name and --symbol required')
838
- // own buy / sell tax and a tax recipient are LaunchpadV3 settings (GangLaunchpad, `gang v3 create`), not V2
839
- const v3Flag = ['buy-tax', 'sell-tax', 'dividend', 'recipient'].find((f) => flag(f))
840
- if (v3Flag) fail(`--${v3Flag} is a LaunchpadV3 setting: use \`gang v3 create …\` (add --testnet for BSC testnet)`)
841
- try { assertCreateTarget(CONFIG.launchpad) } catch (e) { fail(e.message) }
842
- const note = parseNote()
843
- const links = parseLinks()
844
- parseFollow() // refuses --follow: only buys follow a note
845
- // the old 5-arg --pair-or-quote never matched the contract
825
+ // new tokens go to GangLaunchpad (= gang v3 create); LaunchpadV2 takes none, its tokens keep trading (gang buy / sell)
826
+ if (flag('taxed')) fail(`--taxed was LaunchpadV2's tax track, which takes no new tokens. ${TAXED_HINT}`)
846
827
  if (flag('pair-or-quote') || flag('pair')) {
847
828
  fail('--pair-or-quote was removed (CLI ≤0.3.0 encoded a create the contract does not have). Use --quote <ERC-20> --ref-pool <Pancake pair/pool holding it>; omit both for WBNB.')
848
829
  }
849
- const taxed = flag('taxed')
850
- const quote = createAddr('quote'), refPool = createAddr('ref-pool')
851
- const wbnbQuote = [zeroAddress, ADDR.wbnb.toLowerCase()].includes(quote.toLowerCase())
852
- const me = bawAddress()
853
- if (!(await isAgent(me))) fail('this wallet holds no Agent ID (.ai); create is gated', { address: me })
854
- // dry run before any logo upload; logoURI and the links / note suffixes can't change whether create reverts
855
- const dry = await preflightCreate(me, calldata.createV2(name, symbol, '', taxed, quote, refPool), quote, refPool)
856
- if (!dry.ok && dry.reverted) fail(`create would revert: ${dry.error}`, { quote, refPool, hint: CREATE_HINTS[dry.error] })
857
- if (!dry.ok) fail(`could not dry-run create (RPC): ${dry.error}`, { retry: 'same command again; set GANG_RPC_URL if this RPC keeps failing' })
858
- const logo = await resolveLogoUri()
859
- const data = withNote(calldata.createV2(name, symbol, logo.logoURI, taxed, quote, refPool) + linksSuffix(links), note)
860
- const p = bawPreview({ from: me, to: ADDR.v2, data })
861
- return out(summarizeWithNote(p, {
862
- step: 'create', pad: 'v2', launchpad: ADDR.v2, name, symbol,
863
- logoURI: logo.logoURI || '(empty)', uploaded: logo.uploaded, upload: logo.upload,
864
- ...(links && { links: { website: links.website || null, twitter: links.twitter || null } }),
865
- taxed, quote: wbnbQuote ? 'WBNB' : quote,
866
- // the contract ignores refPool for WBNB (Created.refPair = 0x0)
867
- refPool: wbnbQuote && refPool !== zeroAddress ? `${refPool} (ignored for WBNB)` : refPool,
868
- graduationAmount: dry.gradAmt, tokenIfNext: dry.tokenIfNext,
869
- note: 'LaunchpadV2 only. Graduation ≈15 BNB worth of the quote. No creation fee. Soft/U/S create archived. tokenIfNext changes if another create lands first: the real address is the Created event from `gang tx --hash …` after execute.',
870
- }, note, 'launch'))
830
+ return runV3('create', {
831
+ opt, flag, out, fail, summarize: summarizePreview, resolveLogo: resolveLogoUri, checkMeta: parseMeta, resolveMeta: resolveMetaUri,
832
+ })
871
833
  }
872
834
  case 'execute': {
873
835
  const id = opt('request-id'); if (!id) fail('--request-id required')
package/src/links.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Token links (create --website / --twitter): what counts as a stored value and how typed input becomes one.
3
3
  * No imports, so discover.js can check what the API returns without an import cycle (notes.js imports discover.js).
4
- * The calldata codec is in notes.js (linksSuffix / readTokenLinks). Same rules as the server's noteCommit.js.
4
+ * The calldata reader is in notes.js (readTokenLinks). Same rules as the server's noteCommit.js.
5
5
  */
6
6
  const LINKS_MAX = 200 // per field, characters (all ASCII once canonical)
7
7
  // path segments of A-Z a-z 0-9 _ . -, but not "." or ".." (a browser would resolve those away)
package/src/notes.js CHANGED
@@ -4,7 +4,7 @@
4
4
  * v1 suffix = "gang" 0x01 keccak256(UTF-8("gang-note:v1\n" salt "\n" conf "\n" text)) (37 bytes)
5
5
  * v2 suffix = "gang" 0x02 uint32be(revealAfter) keccak256(UTF-8("gang-note:v2\n" salt "\n" conf "\n" revealAfter "\n" text)) (41 bytes)
6
6
  * follow ref = "gang" 0x03 followed note tx hash (37 bytes), right before the note suffix (or last without one)
7
- * token links (create) = "gang" 0x04 UTF-8(website "\n" twitter) uint16be(length), same place (see linksSuffix)
7
+ * token links (create) = "gang" 0x04 UTF-8(website "\n" twitter) uint16be(length), same place (see readTokenLinks; written by LaunchpadV2 creates before CLI 0.10)
8
8
  * The text is sent after the tx lands (POST /api/notes), so anyone can check it was written before the trade.
9
9
  * v2 (sealed): the server holds the text and only shows it from blockTime + revealAfter.
10
10
  * Normalization and the commitment format must match the server byte for byte.
@@ -127,16 +127,6 @@ export function readFollowRef(input) {
127
127
  * empty, not both. Only canonical values count (links.js websiteError / twitterError), so other writers can't smuggle odd URLs.
128
128
  */
129
129
 
130
- /** Suffix for canonical links ({ website, twitter }, either may be empty), lower-case hex without 0x; '' for none. */
131
- export function linksSuffix(links) {
132
- const { website = '', twitter = '' } = links ?? {}
133
- if (!website && !twitter) return ''
134
- if (website && websiteError(website)) throw new Error('bad_website')
135
- if (twitter && twitterError(twitter)) throw new Error('bad_twitter')
136
- const hex = toHex(`${website}\n${twitter}`).slice(2)
137
- return `${LINKS_MAGIC}${hex}${(hex.length / 2).toString(16).padStart(4, '0')}`
138
- }
139
-
140
130
  /**
141
131
  * The links a create input carries ({ website, twitter }, each null when absent or not canonical), or null. Only one
142
132
  * place counts: the segment ending right before the input's note suffix, or at its very end when it has none.
package/src/v3.js CHANGED
@@ -3,7 +3,7 @@ import { decimalsOf, defaultRefPool, dividendOf, VAULT_ABI, fundingStep as fund,
3
3
  import { API } from './discover.js'
4
4
  import { UA } from './version.js'
5
5
  import { walletFor } from './fair.js'
6
- import { MERGED_ERRORS_ABI, MERGED_HINTS, NOT_ON_MAINNET, notThisKind, padNets } from './gangpad.js'
6
+ import { MERGED_ERRORS_ABI, MERGED_HINTS, NOT_ON_MAINNET, noteFlagError, notThisKind, padNets } from './gangpad.js'
7
7
  import { poolPayBnb, poolTrade } from './pool.js'
8
8
 
9
9
  /**
@@ -211,7 +211,8 @@ const USAGE = 'usage: gang v3 <list|info|status|create|buy|sell|claim|income|rel
211
211
  export async function runV3(sub, { opt, flag, out, fail, summarize, resolveLogo, checkMeta, resolveMeta }) {
212
212
  if (!SUBS.includes(sub)) return fail(USAGE, { got: sub ?? null })
213
213
  // agent notes are matched to the server's V2 / Soft trades; V3 txs are not matched there yet
214
- if (flag('note') || flag('follow')) return fail('--note / --follow are not supported on gang v3 yet: the server cannot match them to a V3 tx; leave them out')
214
+ const noteError = noteFlagError(flag, 'GangLaunchpad tokens (gang create / gang v3)', 'a GangLaunchpad tx')
215
+ if (noteError) return fail(noteError)
215
216
  const testnet = flag('testnet')
216
217
  const net = testnet ? ' --testnet' : ''
217
218
  const rawOnly = flag('calldata')
@@ -312,17 +313,34 @@ export async function runV3(sub, { opt, flag, out, fail, summarize, resolveLogo,
312
313
  const name = opt('name'), symbol = opt('symbol')
313
314
  if (!name || !symbol) fail('--name and --symbol are required')
314
315
  checkMeta() // a bad --website / --twitter / --description fails here, before any chain read or upload
315
- if (!flag('buy-tax') || !flag('sell-tax')) fail('--buy-tax and --sell-tax are required (each 1–5, in %; e.g. --buy-tax 2 --sell-tax 2)')
316
- const buyTax = parseNum(fail, 'buy-tax', opt('buy-tax'), 1, 5)
317
- const sellTax = parseNum(fail, 'sell-tax', opt('sell-tax'), 1, 5)
318
- const dividend = parseNum(fail, 'dividend', opt('dividend', '0'), 0, 100)
319
- // everything to holders needs no recipient; otherwise the recipient gets the rest: yourself, or a whitelisted partner
320
- const recipient = dividend === 100 && !flag('recipient') ? zeroAddress : addrArg(opt, fail, 'recipient', 'the tax recipient: your own address, or a whitelisted partner')
316
+ // no --buy-tax / --sell-tax (or both 0): an untaxed token (tax all 0, no dividend, no recipient; the pad never hooks it)
317
+ if (flag('buy-tax') !== flag('sell-tax')) {
318
+ fail('give both --buy-tax and --sell-tax (each 1–5, in %; e.g. --buy-tax 2 --sell-tax 2), or neither for an untaxed token')
319
+ }
320
+ const isZero = (f) => /^0+(\.0+)?$/.test(opt(f) ?? '')
321
+ const zeroTax = isZero('buy-tax') && isZero('sell-tax')
322
+ const taxed = flag('buy-tax') && !zeroTax
323
+ if (!taxed) {
324
+ const f = ['dividend', 'recipient'].find((x) => flag(x))
325
+ if (f) fail(`--${f} only applies to a taxed token: add --buy-tax and --sell-tax (each 1–5, in %), or leave --${f} out for an untaxed token`)
326
+ }
327
+ const taxOf = (f) => {
328
+ const n = Number(opt(f))
329
+ if (!(n >= 1 && n <= 5)) fail(`--${f} must be a number between 1 and 5 (in %); for an untaxed token leave out both tax flags (or give both as 0)`, { got: opt(f) ?? null })
330
+ return n
331
+ }
332
+ const buyTax = taxed ? taxOf('buy-tax') : 0
333
+ const sellTax = taxed ? taxOf('sell-tax') : 0
334
+ const dividend = taxed ? parseNum(fail, 'dividend', opt('dividend', '0'), 0, 100) : 0
335
+ const me = walletFor(ctx, opt('from'))
336
+ // everything to holders needs no recipient; otherwise the recipient gets the rest: --recipient (a whitelisted
337
+ // partner, or yourself), else the creator itself
338
+ const recipient = !taxed || (dividend === 100 && !flag('recipient')) ? zeroAddress
339
+ : flag('recipient') ? addrArg(opt, fail, 'recipient', 'the tax recipient: your own address, or a whitelisted partner') : me
321
340
  const quote = flag('quote') ? opt('quote') : ctx.wbnb
322
341
  const refPool = flag('ref-pool') ? opt('ref-pool') : (defaultRefPool(ctx.chainId, quote) ?? zeroAddress)
323
342
  if (!isAddress(quote ?? '') || !isAddress(refPool ?? '')) fail('--quote / --ref-pool must be 0x addresses')
324
343
  const tax = { buyTaxBps: Math.round(buyTax * 100), sellTaxBps: Math.round(sellTax * 100), dividendBps: Math.round(dividend * 100), recipient }
325
- const me = walletFor(ctx, opt('from'))
326
344
  // the recipient may be the creator itself: checkTaxConfigFor knows who creates (a pad without it: checkTaxConfig)
327
345
  const [ok, reason] = await ctx.read(ctx.pad, PAD_ABI, 'checkTaxConfigFor', [me, tax]).catch((e) => {
328
346
  if (!noSuchFunction(e)) throw e
@@ -356,9 +374,11 @@ export async function runV3(sub, { opt, flag, out, fail, summarize, resolveLogo,
356
374
  ...(refPool !== zeroAddress && quote.toLowerCase() !== String(ctx.wbnb).toLowerCase() && { refPool }),
357
375
  buyTaxPct: buyTax, sellTaxPct: sellTax, dividendPct: dividend,
358
376
  recipient: recipient === zeroAddress ? null : recipient, recipientLabel: selfRecipient ? 'you (the creator)' : label, tokenIfNext: dry.result,
359
- split: `of each ${buyTax}% buy / ${sellTax}% sell tax in the PancakeSwap pool (after graduation; the curve charges no tax): ${fees.platformTaxPct}% of volume to the platform, then ${dividend}% of the rest to holders, ${rest}% to the recipient in the quote`
360
- + (dividend > 0 ? '; if no holder has 10,000+ tokens when a tax is paid, the holders\' part goes to the recipient too' : ''),
361
- note: `tax rates and recipient are fixed at create. Curve trades pay only the ${fees.curveFeePct}% fee, no tax: the tax starts in the pool after graduation. tokenIfNext changes if another create lands first: the real address is the Created event from \`gang v3 tx --hash …\`.`,
377
+ split: taxed
378
+ ? `of each ${buyTax}% buy / ${sellTax}% sell tax in the PancakeSwap pool (after graduation; the curve charges no tax): ${fees.platformTaxPct}% of volume to the platform, then ${dividend}% of the rest to holders, ${rest}% to the recipient in the quote`
379
+ + (dividend > 0 ? '; if no holder has 10,000+ tokens when a tax is paid, the holders\' part goes to the recipient too' : '')
380
+ : 'untaxed: no tax in the PancakeSwap pool after graduation, no dividend, no recipient',
381
+ note: `${taxed ? 'tax rates and recipient are' : 'untaxed is'} fixed at create. Curve trades pay only the ${fees.curveFeePct}% fee, no tax${taxed ? ': the tax starts in the pool after graduation' : ''}. tokenIfNext changes if another create lands first: the real address is the Created event from \`gang v3 tx --hash …\`.`,
362
382
  }, rawOnly, summarize))
363
383
  }
364
384