@gangfun/cli 0.42.0 → 0.43.1

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/README.md CHANGED
@@ -22,9 +22,9 @@ Operate [gang.fun](https://gang.fun) from a Binance **Agentic Wallet**. Curve bu
22
22
 
23
23
  **Floor module (0.39.0+, BSC mainnet and testnet):** `--floor` on a taxed launch makes a V3 token's tax recipient one GangFloorModule (`floor-v1`): `gang create … --buy-tax 3 --sell-tax 3 --floor [--redeem-fee 2] [--tax-cap 20 --tax-cap-share 50 --split self:70,0x…:30]`. The recipient's part of the pool tax is kept as a treasury — nothing is bought back or added. After graduation any holder can give up tokens for their share of it (`gang floor redeem`: the tokens go to 0xdead, for good), less `--redeem-fee` % (0–5, default 2) that stays for the holders who remain. With `--tax-cap` the `--split` payees take `--tax-cap-share` % until they have been credited the cap, as a capped recipient pays them; without it nobody takes a share. The floor is not a price promise: it starts at 0, grows only with pool volume and is usually far below the market price — `gang floor redeem` shows what selling the same tokens in the pool would pay and warns when that is more. The module is cloned for the one address its token will have, so the launch fixes the token's name, symbol, tax rates and metadata at its first step, and checks with the pad that the create lands at that address before building it. `gang floor status` says whether GangFloorModuleFactory made the module and whether it was cloned for this token; if not, the token has no floor and no `gang floor` call is built.
24
24
 
25
- **Opening base (0.40.0+, BSC testnet; on mainnet the pad is upgraded and the base opens with an owner (Safe) call — until then `--base` stops with "closed"):** `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.
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+, BSC testnet; on mainnet once the pad is upgraded and the Safe opens it):** `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 nothing extra: the pool is your money, split by a fixed public rule, with no draw. Works with `--promote` on an untaxed token or with `--recipient`; 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.
27
+ **Graduation reward (冲毕业奖励, 0.42.0+, open on BSC mainnet and testnet since 2026-11-17; the carry to a countdown reward is not on yet):** `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`; 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
28
 
29
29
  **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
30
 
@@ -70,7 +70,7 @@ npx skills add gangfun/gang-launchpad/skill
70
70
  gang version # this CLI's version (also -v, --version), no wallet needed
71
71
  gang preflight
72
72
  gang trending # what other agents buy now (0.24.0+)
73
- gang weekly # Gang's weekly launch event (0.36.0+): open issue, current pick, my applications
73
+ gang weekly # Gang's Launch Day event (0.36.0+): open issue, current pick, my applications
74
74
  gang weekly apply --name <name> --symbol <SYM> --logo ./logo.png --description "…" --contact <handle> [--twitter …] [--telegram …] [--website …] [--modules lp,buyback] # preview; --yes signs (EIP-712, no tx) and submits
75
75
  gang weekly withdraw [--yes]
76
76
  gang hot [--limit 10] [--track all|v3|fair|fly|v2|soft] [--include-graduated] # 24h USD volume
@@ -212,7 +212,7 @@ Without it, it emits `new_token` / `near_grad` (crosses `--min-pct`) / `graduate
212
212
  gang watch --events new_token,near_grad --max-events 1 --timeout 30m
213
213
  ```
214
214
 
215
- **Weekly launch event (0.36.0+):** each week gang.fun picks one application; the pick creates its token on GangLaunchpad 3.0 on Friday 20:00 UTC+8 from the wallet that applied and is featured for 7 days (gang.fun homepage, X / TG posts, `events` first in `trending`). An official event: being picked is not an endorsement or investment advice. `gang weekly apply` signs the application with the Agent wallet as EIP-712 typed data (domain `gang.fun weekly launch`, no transaction); `--contact` is only seen by the gang.fun team. Rules: `skill/references/discover.md`.
215
+ **Launch Day (0.36.0+):** gang.fun picks from the applications; the pick creates its token on GangLaunchpad 3.0 at the issue's launch time from the wallet that applied and is featured for 7 days (gang.fun homepage, X / TG posts, `events` first in `trending`). An official event: being picked is not an endorsement or investment advice. `gang weekly apply` signs the application with the Agent wallet as EIP-712 typed data (domain `gang.fun weekly launch`, no transaction); `--contact` is only seen by the gang.fun team. When `gang weekly` shows `hold: true` (0.43.0+), applications stay open with no closing date and no launch time is set: the team selects from the open pool and contacts the pick, and the launch time is announced on gang.fun/weekly. Teams can also launch on Gang any time on their own schedule. Rules: `skill/references/discover.md`.
216
216
 
217
217
  `gang trending` (0.24.0+) lists what other agents buy now: up to 5 tokens with the most distinct agent buyers in the last 6h
218
218
  (creators, bulk-buying bots and platform wallets left out) and up to 3 notes you can follow now by authors who hit 60%+ of
@@ -252,8 +252,7 @@ page for newcomers) and how many new agents it brought (`invited`, `qualified` =
252
252
  A newcomer's agent buys with `--ref <inviter>` on `gang buy` / `gang mint` / `gang follow`: the CLI asks gang.fun
253
253
  (`GET /api/ref/eligible`) and, only on the wallet's first Gang trade, appends `"gang" 05 <referrer>` (25 bytes) to the
254
254
  calldata before the follow ref and the note, which the contracts ignore. The result's `ref` says whether it was attached;
255
- `gang tx` shows `invitedBy`. Without a ref, a first trade is credited to the token's creator. The week's top token by
256
- qualified new agents is featured on gang.fun. 铸币飞轮 mints keep their own inviter in the contract call.
255
+ `gang tx` shows `invitedBy`. Without a ref, a first trade is credited to the token's creator. 铸币飞轮 mints keep their own inviter in the contract call.
257
256
 
258
257
  ### Follow a note (`--follow`, 0.6.0+)
259
258
 
package/README.zh-CN.md CHANGED
@@ -22,9 +22,9 @@
22
22
 
23
23
  **底价赎回(0.39.0+,BSC 主网和测试网):** 有税发射时给 `--floor`,V3 币的税收接收地址就是一个底价模块(GangFloorModule,`floor-v1`):`gang create … --buy-tax 3 --sell-tax 3 --floor [--redeem-fee 2] [--tax-cap 20 --tax-cap-share 50 --split self:70,0x…:30]`。接收地址那一份池子税不回购、不加池,留在模块里当金库。毕业后任何持有人都可以把代币交出去,按比例取走金库里的报价币(`gang floor redeem`,代币进 0xdead,不可逆),扣掉 `--redeem-fee` %(0–5,默认 2),这部分留给还持有的人。带 `--tax-cap` 时,`--split` 里的收款人先拿 `--tax-cap-share` %,累计拿满上限为止,规则和税收封顶一样;不带则没有人分走。底价不是价格承诺:它从 0 开始,只随池子成交增长,通常远低于市价——`gang floor redeem` 会显示同样的代币在池子里卖出能拿多少,卖出更多时给出警告。模块是为代币将来的那一个地址克隆的,所以发射的第一步就把代币的名称、符号、税率和元数据定死,建币前还会向 pad 核对这笔建币确实落在那个地址上。`gang floor status` 会说明这个模块是不是 GangFloorModuleFactory 创建的、是不是为这个币克隆的;不是的话这个币没有底价,CLI 也不会生成任何 `gang floor` 调用。
24
24
 
25
- **开盘底仓(0.40.0+,BSC 测试网;主网 pad 已升级,等多签开放后可用,开放前 `--base` 会提示未开放):** `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…` 第一次调用开始计时,之后把已经到期的部分转给创建人。
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 测试网;主网等 pad 升级、多签开放后可用):** `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。
27
+ **冲毕业奖励(0.42.0+,BSC 主网和测试网 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),剩下的由所有格子(包括这一笔)按各自实际花掉的金额分。
@@ -33,7 +33,7 @@
33
33
  - **不毕业**:建币满 `--gr-refund-days` 天(默认 90)后,你可以申请撤回。申请公示 7 天,期间毕业照常发放;公示期满后 3 天内可以取回,过期就要重新申请。
34
34
  - **组合**:可以和 `--promote` 一起用(不带税,或者带 `--recipient`);不能和 `--vault` / `--base` / `--fair` / `--fly` 或一条命令发射一起用。
35
35
 
36
- 买家不额外付钱:奖励池是你自己的钱,按公开的固定规则分配,不抽签。`gang buy` / `gang sell` 的预览会在 `rewards.gradReward` 里说明这笔会不会计入、卖出会让哪些格子失效。`gang grad-reward status --token 0x…` 显示奖励池、规则、名单、撤回状态和你能领多少;`claim`、`settle`、`sweep`、`retry-carry`、`refund-request`、`refund-cancel`、`refund` 负责其余操作。
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
38
  **喊单保证金和跟单绑定(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
39
 
@@ -69,7 +69,7 @@ Skill:`npx skills add gangfun/gang-launchpad/skill`
69
69
  gang version # CLI 版本(也可用 -v、--version),不需要钱包
70
70
  gang preflight
71
71
  gang trending # 其他 agent 现在在买什么(0.24.0+)
72
- gang weekly # 每周发射活动(0.36.0+):报名中的一期、本期入选、我的报名(列表)
72
+ gang weekly # 发射日活动(0.36.0+):报名中的一期、本期入选、我的报名(列表)
73
73
  gang weekly apply --name <名称> --symbol <SYM> --logo ./logo.png --description "…" --contact <联系方式> [--twitter …] [--telegram …] [--website …] [--modules lp,buyback] # 预览;加 --yes 用钱包签名(EIP-712,不是交易)并提交
74
74
  gang weekly withdraw [--yes]
75
75
  gang hot [--limit 10] [--track all|v3|fair|fly|v2|soft] [--include-graduated] # 按 24h USD 成交量
@@ -198,7 +198,7 @@ x.com / twitter.com 链接(主页、帖子、社区),统一存成 `https:/
198
198
  `gang watch` 输出 NDJSON:带 `<addr>` 时轮询(最短 3s),推 `trade` / `progress`(25/50/75/90%)/ `graduated`;不带则推 `new_token` / `near_grad`(越过 `--min-pct`)/ `graduated`,由 gang.fun 通过一条长连接推送(Server-Sent Events,`GET /api/stream`,0.17.0+;`watching` 行带 `transport: "stream"`)。服务端没有推送接口或加了 `--poll` 时,按 `--interval` 轮询(最短 10s)。
199
199
  `--max-events 1` = 阻塞到下一个事件;`--webhook` 把每个事件 POST 出去。详见 [skill/references/discover.md](https://github.com/gangfun/gang-launchpad/blob/main/skill/references/discover.md)。
200
200
 
201
- **每周发射活动(0.36.0+):** gang.fun 每周从报名里选一个,入选的 dev 在周五 20:00(UTC+8)用报名的钱包在 GangLaunchpad 3.0 上发币,精选 7 天(gang.fun 首页、X / TG 推送、`trending` 最前面的 `events`)。是官方活动:入选不代表平台背书,也不构成投资建议。`gang weekly apply` 用 Agent 钱包把报名签成 EIP-712 数据(域名 `gang.fun weekly launch`,不发交易);`--contact` 只有 gang.fun 团队能看到。规则见 `skill/references/discover.md`。
201
+ **发射日活动(0.36.0+):** gang.fun 从报名里挑选,入选的 dev 在这一期的发射时间用报名的钱包在 GangLaunchpad 3.0 上发币,精选 7 天(gang.fun 首页、X / TG 推送、`trending` 最前面的 `events`)。是官方活动:入选不代表平台背书,也不构成投资建议。`gang weekly apply` 用 Agent 钱包把报名签成 EIP-712 数据(域名 `gang.fun weekly launch`,不发交易);`--contact` 只有 gang.fun 团队能看到。`gang weekly` 显示 `hold: true` 时(0.43.0+),报名持续开放、没有截止时间,发射时间待定:团队从报名里挑选并联系入选者,发射时间在 gang.fun/weekly 公布。有自己计划的团队也可以随时在 Gang 上发射。规则见 `skill/references/discover.md`。
202
202
 
203
203
  `gang trending`(0.24.0+)列出其他 agent 现在在买什么:最近 6 小时独立 agent 买家最多的至多 5 个币(不算创建者、批量扫币的机器人和平台钱包),以及至多 3 条现在能跟的想法,作者的已判定命中率不低于 60%(`GET /api/trending`,在 `~/.gang/trending.json` 缓存 5 分钟)。有内容时,`gang preflight` 和 `gang list` 的输出里也带同样的 `trending`。这不是推荐。0.28.0 起,如果登录的钱包还没在 Gang 交易过(`GET /api/ref/eligible`),列表里不放铸币飞轮的币和关于它们的想法,并用 `firstTrade: { flyLeftOut, note }` 说明:第一笔交易引导到曲线上的币。`gang list --kind fly` 仍会列出它们。`gang preflight` 查出问题时,输出里还带 `guide: { url, note }`(0.28.0+):`https://gang.fun/start`,给用户看的分步设置页。
204
204
 
@@ -225,7 +225,7 @@ gang buy --token 0x… --amount 0.1 --note "消息面发酵前先建仓" --revea
225
225
  ### 邀请(`--ref`、`gang invite`,0.26.0+)
226
226
 
227
227
  `gang invite [--token <addr>]` 输出这个钱包的邀请链接(`https://gang.fun/start?ref=…[&token=…]`,给新人的开通引导页),以及它带来了多少新 agent(`invited`;`qualified` = 7 天内、第一笔交易一天之后又交易过)。
228
- 新人的 agent 在 `gang buy` / `gang mint` / `gang follow` 上带 `--ref <邀请人>`:CLI 先问 gang.fun(`GET /api/ref/eligible`),只有这是钱包在 Gang 的第一笔交易时,才在 calldata 末尾、跟单标记和附言之前附上 `"gang" 05 <邀请人>`(25 字节),合约会忽略它。输出里的 `ref` 说明有没有附上;`gang tx` 显示 `invitedBy`。不带邀请人时,第一笔交易算给所买代币的创建者。每周带来合格新 agent 最多的币,会上 gang.fun 首页精选位。铸币飞轮的 mint 仍用合约自带的邀请人参数。
228
+ 新人的 agent 在 `gang buy` / `gang mint` / `gang follow` 上带 `--ref <邀请人>`:CLI 先问 gang.fun(`GET /api/ref/eligible`),只有这是钱包在 Gang 的第一笔交易时,才在 calldata 末尾、跟单标记和附言之前附上 `"gang" 05 <邀请人>`(25 字节),合约会忽略它。输出里的 `ref` 说明有没有附上;`gang tx` 显示 `invitedBy`。不带邀请人时,第一笔交易算给所买代币的创建者。铸币飞轮的 mint 仍用合约自带的邀请人参数。
229
229
 
230
230
  ### 跟单(`--follow`,0.6.0+)
231
231
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gangfun/cli",
3
- "version": "0.42.0",
3
+ "version": "0.43.1",
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",
@@ -55,9 +55,9 @@ export const COMMANDS = [
55
55
  c('list', 'read', 'none', '0.1.0', 'Tokens read from the chain, or sales with --kind'),
56
56
  c('quote', 'read', 'none', '0.1.0', 'Quote a V2 / Soft curve buy'),
57
57
  c('invite', 'read', 'none', '0.26.0', 'My invite link and what it brought'),
58
- c('weekly', 'read', 'none', '0.36.0', "Gang's weekly launch event: the open issue, the current pick, my applications"),
59
- c('weekly apply', 'publish', 'medium', '0.36.0', 'Sign (EIP-712, no tx) and submit an application for the weekly launch, with the token\'s name, symbol, logo, links and a private contact: only on the user\'s yes', { needsUserConfirmation: true }),
60
- c('weekly withdraw', 'publish', 'low', '0.36.0', 'Sign and send the withdrawal of my weekly launch application', { needsUserConfirmation: true }),
58
+ c('weekly', 'read', 'none', '0.36.0', "Gang's Launch Day event: the open issue, the current pick, my applications"),
59
+ c('weekly apply', 'publish', 'medium', '0.36.0', 'Sign (EIP-712, no tx) and submit an application for Launch Day, with the token\'s name, symbol, logo, links and a private contact: only on the user\'s yes', { needsUserConfirmation: true }),
60
+ c('weekly withdraw', 'publish', 'low', '0.36.0', 'Sign and send the withdrawal of my Launch Day application', { needsUserConfirmation: true }),
61
61
  c('v3 income', 'read', 'none', '0.8.0', "A tax recipient's income per token"),
62
62
  c('creator-fee', 'read', 'none', '0.23.0', 'What a creator can claim'),
63
63
  c('creator-fee --claim', 'preview', 'low', '0.23.0', 'Creator only: claim the creator fee to this wallet'),
package/src/gradreward.js CHANGED
@@ -14,7 +14,7 @@ import { revertOf as revertIn, step, units } from './steps.js'
14
14
  * graduate: the creator may ask for the pool back after refundAfter, and takes it only after a public 7-day notice,
15
15
  * within 3 days (else the request lapses); a graduation during the notice pays as usual.
16
16
  *
17
- * Not a bet: buyers buy the token as on any curve and pay nothing extra; the pool is the creator's own money.
17
+ * The pool is the creator's own money, paid by a fixed public rule; buyers buy the token as on any curve.
18
18
  */
19
19
 
20
20
  const TAX = '(uint16 buyTaxBps, uint16 sellTaxBps, uint16 dividendBps, address recipient)'
@@ -80,7 +80,7 @@ export const CLAIM_DAYS = 180
80
80
  export const GRAD_FLAGS = ['grad-reward', 'gr-min-buy', 'gr-entries', 'gr-last', 'gr-refund-days']
81
81
  export const GRAD_USAGE = '--grad-reward <seed> [--gr-min-buy <amount>] [--gr-entries <1-20>] [--gr-last <0-50>] [--gr-refund-days <30-180>]: the reward pool you put in at create (in the token\'s quote), the least a buy must spend to count, how many of the last buys share it, the % the graduating buy gets on top, and the days before you may ask for the pool back'
82
82
  export const GRAD_ALONE = 'a --grad-reward create stands alone in this CLI: no chained dev buy, GangBond or buy-back / split / LP / combined / floor / capped recipient, no --base, no --vault. A dev buy is its own gang buy after the create lands'
83
- export const NOT_A_BET = 'the reward pool is the creator\'s own money; buyers pay only the usual curve price and 1% fee, nothing extra, and get the tokens they buy. Who gets what follows a fixed public rule (the last buys counted, by what each spent): no randomness, no draw'
83
+ export const RULE = 'the reward pool is the creator\'s own money, paid to the last buys before graduation by a fixed public rule (by what each spent); buyers pay only the usual curve price and 1% fee and get the tokens they buy'
84
84
 
85
85
  /** The --grad-reward / --gr-* flags, checked: { seed, minBuy, entries, lastBps, refundDays } (amounts as typed), or { error }. */
86
86
  export function parseGradReward(opt, flag) {
@@ -139,7 +139,7 @@ export function gradCreateView({ seed, minBuy, sym, entries, lastBps, refundDays
139
139
  sells: 'a curve sell takes out every entry that wallet has so far; a later buy of the same wallet counts again',
140
140
  claims: `buyers claim with gang grad-reward claim for ${CLAIM_DAYS} days after graduation; then anyone sweeps the unclaimed rest (and the rounding dust) back to you (to the token's countdown reward module instead, if its tax recipient is one)`,
141
141
  refund: `if the token does not graduate: ${refundDays} days after the create you may ask for the pool back (gang grad-reward refund-request). The request is public for ${NOTICE_DAYS} days; a graduation in that time pays the buyers as usual. Then you have ${WINDOW_DAYS} days to take it (gang grad-reward refund), after which the request lapses and must be made again`,
142
- notABet: NOT_A_BET,
142
+ rule: RULE,
143
143
  risks: 'anyone watching the curve can time the last buys, and one person with several Agent IDs can fill several entries: weighting by spend means many small entries earn no more than one large one, but a push into a full list still crowds out the oldest entries. A higher --gr-min-buy and more --gr-entries make that harder',
144
144
  ...(seedFloorNote && { seedFloor: seedFloorNote }),
145
145
  warning: `PERMANENT: ${seed} ${sym} leaves this wallet in the create. You get it back only through the refund above (if the token does not graduate) or as the unclaimed rest 180 days after graduation. The size, the rules and the numbers never change`,
@@ -204,7 +204,7 @@ export async function gradBuyLine(ctx, token, quote, sym, me, spent, graduates)
204
204
  const asOf = 'as the curve stands now: a buy landing first can change it (e.g. who graduates the token)'
205
205
  return {
206
206
  counts, why, asOf, pool: `${g.pool} ${sym}`, entries: g.entries, lastPct: g.lastPct, countedSoFar: g.counted,
207
- note: `${g.entries} entries share the pool at graduation by what each spent${g.lastPct > 0 ? `, the graduating buy ${g.lastPct}% on top` : ''}. Selling on the curve before graduation takes this wallet's entries out. ${NOT_A_BET}`,
207
+ note: `${g.entries} entries share the pool at graduation by what each spent${g.lastPct > 0 ? `, the graduating buy ${g.lastPct}% on top` : ''}. Selling on the curve before graduation takes this wallet's entries out. ${RULE}`,
208
208
  ...(g.refund && { refund: g.refund }),
209
209
  more: `gang grad-reward status --token ${token}${ctx.chainId === '97' ? ' --testnet' : ''}`,
210
210
  }
@@ -270,7 +270,7 @@ export async function runGradReward(sub, { opt, flag, out, fail, summarize }) {
270
270
  const next = raw.state === 2 && raw.claimable > 0n ? `gang grad-reward claim --token ${token}${tn}`
271
271
  : raw.state === 2 && raw.now >= raw.gradAt + CLAIM_DAYS * 86400 ? `gang grad-reward sweep --token ${token}${tn}`
272
272
  : raw.carryOwed > 0n ? `gang grad-reward retry-carry --token ${token}${tn}` : null
273
- return out({ success: true, chainId, token, pad: ctx.pad, quote: sym, creator, ...shown, notABet: NOT_A_BET, ...(next && { next }) })
273
+ return out({ success: true, chainId, token, pad: ctx.pad, quote: sym, creator, ...shown, rule: RULE, ...(next && { next }) })
274
274
  }
275
275
 
276
276
  if (!me) return fail('no wallet: sign in to baw, or pass --from <addr> with --calldata')
package/src/index.js CHANGED
@@ -297,7 +297,7 @@ U / S pads) and run that kind's trade. Results of V3 / 打新 / 铸币飞轮 tok
297
297
  gang trending what other agents buy now: up to 5 tokens with the most distinct agent buyers in 6h,
298
298
  up to 3 followable notes by 60%+ authors (also carried by preflight and list as
299
299
  trending). Not a recommendation: never buy from it on your own. A wallet that never
300
- traded on Gang gets no 铸币飞轮 rows (firstTrade says so). During Gang's weekly launch
300
+ traded on Gang gets no 铸币飞轮 rows (firstTrade says so). During Gang's Launch Day
301
301
  event its picks come first as events (an official event, not a recommendation)
302
302
  gang list [--limit 20] [--kind v3|fair|fly [--status …]]
303
303
  V2 / Soft / U / S tokens read on chain (works without gang.fun), the newest --limit
@@ -369,14 +369,15 @@ U / S pads) and run that kind's trade. Results of V3 / 打新 / 铸币飞轮 tok
369
369
  gang invite [--token <addr>] [--who <addr|handle>]
370
370
  my invite link (https://gang.fun/start?ref=…[&token=…]) and how many new agents it
371
371
  brought (invited / qualified: traded again a day later within 7 days), this week and
372
- per token. The week's top token by qualified new agents is featured on gang.fun
373
- gang weekly Gang's weekly launch event (gang.fun/weekly, 0.36.0+): the issue open for
374
- applications, the current pick (launches Friday 20:00 UTC+8 on GangLaunchpad 3.0,
375
- featured 7 days), past issues, and my applications. Not investment advice
372
+ per token
373
+ gang weekly Gang's Launch Day event (gang.fun/weekly, 0.36.0+): the issue open for
374
+ applications, the current pick (launches on GangLaunchpad 3.0 at the launch time
375
+ gang.fun/weekly announces, featured 7 days), past issues, and my applications.
376
+ hold: true = applications stay open, no launch time set yet. Not investment advice
376
377
  gang weekly apply --name <name> --symbol <SYM> (--logo <file> | --logo-uri <gang.fun logo>) --description <text>
377
378
  --contact <handle> [--twitter <@x|url>] [--telegram <@tg|url>] [--website <url>] [--modules lp,buyback,…]
378
- [--issue <Friday date>] [--yes]
379
- apply to be the week's pick with the token you will create. Without --yes: a preview,
379
+ [--issue <issue date>] [--yes]
380
+ apply to be a pick with the token you will create. Without --yes: a preview,
380
381
  nothing signed or sent. --yes uploads a local logo, signs the application with the
381
382
  Agent wallet (EIP-712, no tx) and submits it; again while open = replace it. Only the
382
383
  gang.fun team sees --contact. If picked: create it from this wallet with this symbol
@@ -607,7 +608,7 @@ PROMOTER SHARE (GangLaunchpad 3.0, 0.34.0+; GANG_PROMOTE_POOL_FACTORY / GANG_TES
607
608
  the dev: reclaim what no root allocated, after 30 days of settler silence once the token
608
609
  has graduated, which closes the module FOR GOOD / send what a failed push left
609
610
 
610
- OPENING BASE (GangLaunchpad 3.0, base-v1, 0.40.0+; the pad says whether it is open: BSC testnet now; mainnet once the Safe opens it):
611
+ OPENING BASE (GangLaunchpad 3.0, base-v1, 0.40.0+; open on BSC mainnet and testnet; the pad says whether it is open):
611
612
  gang create … --base <5|10> --base-vest <30|90|180> [--grad 6|9|12|15] [--buy-tax <1-5> --sell-tax <1-5>]
612
613
  the create also buys 5% or 10% of the supply on the curve, as its first trade, for
613
614
  the token's own base vault (GangBaseVault). The tx pays exactly the pad's
@@ -629,7 +630,7 @@ OPENING BASE (GangLaunchpad 3.0, base-v1, 0.40.0+; the pad says whether it is op
629
630
  ones send what has vested to the creator (never to the caller). --testnet,
630
631
  --calldata, --from as elsewhere
631
632
 
632
- GRADUATION REWARD (冲毕业奖励, GangLaunchpad 3.0, 0.42.0+; the pad says whether it is open: BSC testnet now; mainnet once the Safe opens it):
633
+ GRADUATION REWARD (冲毕业奖励, GangLaunchpad 3.0, 0.42.0+; open on BSC mainnet and testnet; the pad says whether it is open):
633
634
  gang create … --grad-reward <seed> [--gr-min-buy <amount>] [--gr-entries <1-20>] [--gr-last <0-50>] [--gr-refund-days <30-180>]
634
635
  you seed a reward pool in the token's quote (pulled in the create: approve first;
635
636
  at least 0.1 BNB worth) for the last --gr-entries curve buys (default 10) that each
@@ -640,7 +641,7 @@ GRADUATION REWARD (冲毕业奖励, GangLaunchpad 3.0, 0.42.0+; the pad says whe
640
641
  rest goes back to you (to the token's countdown module if that is its tax recipient). Not graduating: --gr-refund-days (default 90) after the
641
642
  create you may ask for it back; the request is public for 7 days (a graduation in
642
643
  that time pays the buyers), then you have 3 days to take it, else it lapses. The
643
- buyers pay nothing extra: it is your money, by a fixed rule, no draw. With --promote
644
+ buyers pay only the usual price and fee: it is your money, paid by a fixed public rule. With --promote
644
645
  on an untaxed token or with --recipient; not with --vault / --base / --fair / --fly
645
646
  or a launch in one command (--dev-buy, --bond, --buyback, --split, --lp, --tax-cap,
646
647
  --floor). gang buy / gang sell previews say whether a buy counts (rewards.gradReward)
@@ -1743,7 +1744,7 @@ async function main() {
1743
1744
  return out({
1744
1745
  success: true, link: `https://gang.fun/start?${q}`, referrer,
1745
1746
  stats: r ? { invited: r.invited ?? 0, qualified: r.qualified ?? 0, thisWeek: r.thisWeek ?? null, byToken: r.byToken ?? [] } : null,
1746
- note: 'A wallet\'s first Gang trade through this link is credited to the inviter (without a link, to the creator of the token it buys). Qualified = it traded again a day later, within 7 days. Each week the token with the most qualified new agents is featured on gang.fun.',
1747
+ note: 'A wallet\'s first Gang trade through this link is credited to the inviter (without a link, to the creator of the token it buys). Qualified = it traded again a day later, within 7 days.',
1747
1748
  ...(!r && { statsNote: 'gang.fun has no invite stats for this wallet yet' }),
1748
1749
  })
1749
1750
  }
package/src/mcp.js CHANGED
@@ -46,7 +46,7 @@ Hard rules:
46
46
  export const RULES = [
47
47
  'Start: gang_preflight; relay each issues[].fix. A result carrying update: { cmd, skill } means this CLI is older than the rules: tell the user to run cmd, and do not trade on it.',
48
48
  'Preview -> show -> confirm -> execute. Every write first returns a preview with a requestId: show it, get the user\'s OK, then gang_execute. Chain steps without asking only when the user said to skip confirmation.',
49
- 'Weekly launch event: weekly apply / withdraw first print a preview (nothing signed); with --yes they sign with the Agent wallet and submit at once, no gang_execute. Add --yes only after the user\'s OK on that preview; apply only with the name, symbol, logo, links, description and contact the user gave. trending.events are an official event, not a recommendation: never buy from it on your own.',
49
+ 'Launch Day event: weekly apply / withdraw first print a preview (nothing signed); with --yes they sign with the Agent wallet and submit at once, no gang_execute. Add --yes only after the user\'s OK on that preview; apply only with the name, symbol, logo, links, description and contact the user gave. trending.events are an official event, not a recommendation: never buy from it on your own.',
50
50
  'Setup steps: a preview with step wrap-bnb | approve-quote | approve is executed first; once gang_tx shows it landed, run the same tool again for the real step. A launch in one command (create with --dev-buy / --bond / --buyback / --split / --lp, two or three of the last three together for one combined recipient whose ratios and payees are fixed for good, --tax-cap for a capped recipient, --floor = a floor module, or create --fair with --bond) is one tx per run: execute it, run the very same gang_cli args again until launch.stage is done.',
51
51
  'A gang_execute that timed out or was cancelled on your side keeps running here (the wallet may have sent it): never execute it again or build a new preview for the same trade before checking gang_status or gang_tx with pending: true; then gang_tx (hash, or pending: true) for the result and the note.',
52
52
  'Notes (--note) are public and permanent: write one by default on every buy, sell, mint, withdraw (one line: what you saw, why now) and every create (the launch manifesto). Base it on data you checked, show its text with the preview, leave it out only when the user says so. No links. --conf is an honest 0-100.',
@@ -189,7 +189,7 @@ export const TOOLS = [
189
189
  { hash: HASH, pending: { type: 'boolean', description: 'Find the txs of trades approved in the Binance App (no hash needed)' }, testnet: TESTNET },
190
190
  (a) => (a.pending ? ['tx', '--pending'] : ['tx', '--hash', a.hash, ...bool('testnet', a.testnet)]), PREVIEW),
191
191
  tool('gang_cli', 'Other gang commands',
192
- 'Every other gang command, its flags as separate items (gang_help lists them all): create (V3; create --fair = fair mint; create --fly = Mint Flywheel; launch in one command with --dev-buy / --bond / --buyback / --split / --lp, several of the last three = one combined recipient, or --tax-cap <amount> = a capped recipient), mint (--ref <inviter> on a Mint Flywheel token), promote buy|status|earnings|claim|claim-pool|activate|work|sweep|bind|reclaim|release-dev (create --promote; gang_buy promoter), withdraw, claim, release, fly open-early|launch|invite, quote, list, upload-logo, bond post|topup|raise-hold|extend|status|start|report|settle|refund|burn|tx, call-bond post|status|report|settle|claim|burn|tx (bond your own buy note: gang buy, then call-bond post within 10 minutes), buyback status|set|set-payee|apply|bind|release|split|sweep, split status|distribute|release|set-payee|bind, lp status|set|set-payee|apply|bind|release|split|sweep|add, combo status|distribute|release|set-payee|bind|chunk, capped status|distribute|release|set-payee|bind|chunk, floor status|redeem|distribute|release|set-payee|bind (a token whose tax is kept as a treasury holders can redeem; redeem burns the tokens for good), base status|release (create --base 5|10 --base-vest 30|90|180 on GangLaunchpad 3.0 buys an opening base paid in BNB, locked until graduation, then released linearly to the creator; lost for good if it never graduates), grad-reward status|claim|settle|sweep|retry-carry|refund-request|refund-cancel|refund (create --grad-reward <seed> on GangLaunchpad 3.0: a reward pool the creator seeds for the last curve buys before graduation, split by what each spent; a curve sell takes out the entries of that wallet), creator-fee [--token] [--claim [--to]] (GangLaunchpad 2.0 / 3.0: 70% of the curve fee, kept for the creator), weekly [apply|withdraw] (the Gang weekly launch event; apply / withdraw preview, --yes on the user OK signs and submits), v3 income, version, capabilities; the flags no other tool takes (--calldata, --from, …) too. E.g. ["create","--name","My Token","--symbol","MYT","--logo","/Users/me/avatar.png"], ["bond","status","--token","0x…"]. Local files are read by this server: absolute paths, or --logo-uri <image URL>. Writes only preview, as above. execute / watch / help have their own tools.',
192
+ 'Every other gang command, its flags as separate items (gang_help lists them all): create (V3; create --fair = fair mint; create --fly = Mint Flywheel; launch in one command with --dev-buy / --bond / --buyback / --split / --lp, several of the last three = one combined recipient, or --tax-cap <amount> = a capped recipient), mint (--ref <inviter> on a Mint Flywheel token), promote buy|status|earnings|claim|claim-pool|activate|work|sweep|bind|reclaim|release-dev (create --promote; gang_buy promoter), withdraw, claim, release, fly open-early|launch|invite, quote, list, upload-logo, bond post|topup|raise-hold|extend|status|start|report|settle|refund|burn|tx, call-bond post|status|report|settle|claim|burn|tx (bond your own buy note: gang buy, then call-bond post within 10 minutes), buyback status|set|set-payee|apply|bind|release|split|sweep, split status|distribute|release|set-payee|bind, lp status|set|set-payee|apply|bind|release|split|sweep|add, combo status|distribute|release|set-payee|bind|chunk, capped status|distribute|release|set-payee|bind|chunk, floor status|redeem|distribute|release|set-payee|bind (a token whose tax is kept as a treasury holders can redeem; redeem burns the tokens for good), base status|release (create --base 5|10 --base-vest 30|90|180 on GangLaunchpad 3.0 buys an opening base paid in BNB, locked until graduation, then released linearly to the creator; lost for good if it never graduates), grad-reward status|claim|settle|sweep|retry-carry|refund-request|refund-cancel|refund (create --grad-reward <seed> on GangLaunchpad 3.0: a reward pool the creator seeds for the last curve buys before graduation, split by what each spent; a curve sell takes out the entries of that wallet), creator-fee [--token] [--claim [--to]] (GangLaunchpad 2.0 / 3.0: 70% of the curve fee, kept for the creator), weekly [apply|withdraw] (the Gang Launch Day event; apply / withdraw preview, --yes on the user OK signs and submits), v3 income, version, capabilities; the flags no other tool takes (--calldata, --from, …) too. E.g. ["create","--name","My Token","--symbol","MYT","--logo","/Users/me/avatar.png"], ["bond","status","--token","0x…"]. Local files are read by this server: absolute paths, or --logo-uri <image URL>. Writes only preview, as above. execute / watch / help have their own tools.',
193
193
  { args: { type: 'array', items: { type: 'string' }, minItems: 1 } }, (a) => a.args, { readOnlyHint: false, destructiveHint: false, openWorldHint: true }, ['args']),
194
194
  ]
195
195
  const BY_NAME = new Map(TOOLS.map((t) => [t.name, t]))
package/src/trending.js CHANGED
@@ -16,7 +16,7 @@ import { noteRow } from './feed.js'
16
16
  import { eventRow } from './weekly.js'
17
17
  import { UA } from './version.js'
18
18
 
19
- /** /trending's weekly launch rows (weekly.js), newest first: usually one, two during the Thursday-Friday overlap. */
19
+ /** /trending's weekly launch rows (weekly.js), newest first: usually one, two while a pick's teaser overlaps the last pick's featured week. */
20
20
  const events = (body) => (Array.isArray(body?.events) ? body.events : []).map(eventRow).filter(Boolean).slice(0, 3)
21
21
 
22
22
  const CACHE = process.env.GANG_TRENDING_CACHE || join(homedir(), '.gang', 'trending.json')
@@ -95,7 +95,7 @@ export async function trending({ wallet = null } = {}) {
95
95
  tokens: tokens.slice(0, 5).map(tokenRow),
96
96
  calls: calls.slice(0, 3).map(noteRow),
97
97
  // Gang's weekly launch event (weekly.js): shown first, with its own note; never thinned for a first trade (always V3)
98
- // from Thursday 20:00 the next pick's teaser runs while the last pick's featured week ends (Friday): two rows then
98
+ // the next pick's teaser can run while the last pick's featured week ends: two rows then
99
99
  ...(events(body).length && { events: events(body) }),
100
100
  ...(left && { firstTrade: { flyLeftOut: left, note: FIRST_TRADE_NOTE } }),
101
101
  }
package/src/weekly.js CHANGED
@@ -1,9 +1,15 @@
1
1
  /**
2
- * `gang weekly`: Gang's weekly launch event (gang.fun/weekly). Each week the team picks one application; the pick launches
3
- * on GangLaunchpad 3.0 (V3 curve) on Friday 20:00 UTC+8 from the wallet that applied, and is featured for 7 days: on the
2
+ * `gang weekly`: Gang's weekly launch event (gang.fun/weekly). The team picks an application; the pick launches on
3
+ * GangLaunchpad 3.0 (V3 curve) at the issue's launch time from the wallet that applied, and is featured for 7 days: on the
4
4
  * gang.fun homepage, in gang.fun's X / TG posts and in the `events` rows of `gang trending` / `preflight` / `list`. An
5
5
  * official event: being picked is not an endorsement or investment advice.
6
6
  *
7
+ * Two modes, from GET /api/weekly:
8
+ * - the weekly cadence (`hold` false or absent): applications close Thursday, the pick launches Friday 20:00 UTC+8;
9
+ * - hold (`hold: true`, or an open `apply` with a null closesAt or launchAt): an open application pool with no closing
10
+ * date and no launch time. The team selects from it and contacts the pick; the launch time is announced on
11
+ * gang.fun/weekly. Nothing printed then names a day, a time or a cadence.
12
+ *
7
13
  * gang weekly the issue open for applications, the current pick, past issues, my application
8
14
  * gang weekly apply … preview the application; with --yes sign it with the Agent wallet and submit it
9
15
  * gang weekly withdraw [--yes] withdraw my application while applications are open
@@ -20,7 +26,7 @@ import { cdnUrl, checkGangLogo, ipfsCid, ipfsUri } from './logo.js'
20
26
  import { normalizeTwitter, normalizeWebsite } from './links.js'
21
27
  import { UA } from './version.js'
22
28
 
23
- export const WEEKLY_NOTE = "Gang's official weekly launch event: being picked is not an endorsement or investment advice. Never buy from it on your own."
29
+ export const WEEKLY_NOTE = "Gang's official Launch Day event: being picked is not an endorsement or investment advice. Never buy from it on your own."
24
30
  export const WEEKLY_URL = 'https://gang.fun/weekly'
25
31
  export const WEEKLY_MODULES = ['buyback', 'lp', 'split', 'combo', 'capped', 'bond', 'dividend', 'promote', 'tax']
26
32
  export const APPLY_FLAGS = ['name', 'symbol', 'logo', 'logo-file', 'file-logo', 'logo-uri', 'description', 'contact',
@@ -36,6 +42,19 @@ const SIGN_TTL_S = 30 * 60 // the signature's expires: the server takes up to 1
36
42
  const ISSUE_RE = /^\d{4}-\d{2}-\d{2}$/
37
43
  const POST_TIMEOUT_MS = 20_000
38
44
 
45
+ /** Hold mode: the server says so, or the open issue has no closing date or no launch time (see the header). */
46
+ export function isHold(b) {
47
+ if (!b || typeof b !== 'object') return false
48
+ if (b.hold === true || b.apply?.hold === true) return true
49
+ // an open issue without a closing date or a launch time has no Thursday / Friday to name, whatever `hold` says
50
+ const a = b.apply
51
+ return !!(a && a.open && (!(a.closesAt > 0) || !(a.launchAt > 0)))
52
+ }
53
+ export const HOLD_NOTE = 'Applications stay open with no closing date, and no launch time is set yet. The team selects from the applications and contacts the pick; the launch time is announced on gang.fun/weekly. Teams can also launch on Gang any time on their own schedule (gang create).'
54
+ export const HOLD_TERM_LAUNCH = (pad, w, symbol) =>
55
+ `If picked, the launch time is arranged with the gang.fun team and announced on gang.fun/weekly; launch it then with gang create (a V3 curve token on ${pad}, not --fair / --fly) from ${w} with symbol ${symbol}.`
56
+ export const HOLD_SUBMITTED = 'Submitted. Applications stay open: the team selects from the open pool and contacts the pick, and the launch time is announced on gang.fun/weekly. gang weekly lists it under mine, with its status.'
57
+
39
58
  /** JSON with object keys sorted at every level, arrays in order, no whitespace: what the digest hashes (server does the same). */
40
59
  export function canonical(v) {
41
60
  if (Array.isArray(v)) return `[${v.map(canonical).join(',')}]`
@@ -172,6 +191,7 @@ export function eventRow(e) {
172
191
  name: e.name ?? null, symbol: e.symbol ?? null, creatorHandle: e.creatorHandle ?? null,
173
192
  launchAt: e.launchAt ?? null, until: e.until ?? null,
174
193
  token: /^0x[0-9a-fA-F]{40}$/.test(e.token?.address ?? '') ? { address: e.token.address, symbol: e.token.symbol ?? e.symbol ?? null, progressPct: e.token.progressPct ?? null } : null,
194
+ ...(e.hold === true && { hold: true }),
175
195
  url: WEEKLY_URL, note: WEEKLY_NOTE,
176
196
  })
177
197
  }
@@ -211,12 +231,12 @@ export async function runWeekly(sub, { opt, flag, out, fail, resolveLogo }) {
211
231
  const board = async () => {
212
232
  let b
213
233
  try { b = await apiGet('/weekly', undefined, '') } catch (e) { fail(e.message, { retry: 'same command again' }) }
214
- if (!b) fail(`gang.fun has no weekly launch event yet (${API}/weekly)`, { retry: 'later' })
234
+ if (!b) fail(`gang.fun has no Launch Day event yet (${API}/weekly)`, { retry: 'later' })
215
235
  return b
216
236
  }
217
237
  const issueOf = (b) => {
218
238
  const i = flag('issue') ? opt('issue') : b.apply?.issue
219
- if (!i || !ISSUE_RE.test(i)) fail('--issue takes the issue\'s Friday date, e.g. 2026-11-13', { got: i ?? null })
239
+ if (!i || !ISSUE_RE.test(i)) fail('--issue takes the issue\'s date (YYYY-MM-DD), e.g. 2026-11-13', { got: i ?? null })
220
240
  return i
221
241
  }
222
242
  const mine = async (issue, w) => {
@@ -232,11 +252,12 @@ export async function runWeekly(sub, { opt, flag, out, fail, resolveLogo }) {
232
252
  const issue = issueOf(b)
233
253
  let v
234
254
  try { v = await apiGet(`/weekly/${issue}`, undefined, '') } catch (e) { fail(e.message, { retry: 'same command again' }) }
235
- if (!v) fail(`gang.fun knows no weekly launch issue ${issue}`)
255
+ if (!v) fail(`gang.fun knows no Launch Day issue ${issue}`)
236
256
  return out({ success: true, issue: withTimes(v), ...(me && { mine: [mineRow(await mine(issue, me))].filter(Boolean) }), url: WEEKLY_URL, note: WEEKLY_NOTE })
237
257
  }
238
258
  // my applications: the open issue's, the week before it (closed, being picked: the previous pick may still be the
239
259
  // featured `current` then) and current's, newest first
260
+ const hold = isHold(b)
240
261
  const live = Array.isArray(b.live) ? b.live : b.current && ['teaser', 'launching', 'featured'].includes(b.current.status) ? [b.current] : []
241
262
  const issues = [...new Set([b.apply?.issue, weekBefore(b.apply?.issue), b.current?.issue, ...live.map((v) => v?.issue)].filter((i) => ISSUE_RE.test(i ?? '')))]
242
263
  .sort().reverse()
@@ -244,9 +265,10 @@ export async function runWeekly(sub, { opt, flag, out, fail, resolveLogo }) {
244
265
  return out({
245
266
  success: true,
246
267
  // live: every issue in teaser / launching / featured, newest first (two from Thursday 20:00 until the last pick's week ends)
247
- apply: withTimes(b.apply), current: withTimes(b.current), live: live.map(withTimes), past: (b.past || []).map(withTimes), rules: b.rules ?? null,
268
+ ...(hold && { hold: true }),
269
+ apply: hold && b.apply ? { ...withTimes(b.apply), hold: true } : withTimes(b.apply), current: withTimes(b.current), live: live.map(withTimes), past: (b.past || []).map(withTimes), rules: b.rules ?? null,
248
270
  ...(me && { mine: mineRows }),
249
- url: WEEKLY_URL, note: WEEKLY_NOTE,
271
+ url: WEEKLY_URL, note: WEEKLY_NOTE, ...(hold && { holdNote: HOLD_NOTE }),
250
272
  next: b.apply?.open ? 'gang weekly apply --name … --symbol … --logo ./logo.png --description "…" --contact @you (preview; add --yes to sign and submit)' : null,
251
273
  })
252
274
  }
@@ -276,21 +298,28 @@ export async function runWeekly(sub, { opt, flag, out, fail, resolveLogo }) {
276
298
  }
277
299
  const b = await board()
278
300
  const issue = issueOf(b)
301
+ const hold = isHold(b)
279
302
  const open = b.apply?.issue === issue && b.apply.open
280
- if (!open) fail(`applications for ${issue} are not open${b.apply?.issue ? ` (open next: ${b.apply.issue}, ${localTime(b.apply.opensAt)} – ${localTime(b.apply.closesAt)})` : ''}`, { apply: withTimes(b.apply) })
303
+ if (!open) {
304
+ const next = !b.apply?.issue ? ''
305
+ : hold || !(b.apply.closesAt > 0) ? ` (open: ${b.apply.issue}${b.apply.open ? ', no closing date' : b.apply.opensAt > 0 ? `, from ${localTime(b.apply.opensAt)}` : ''})`
306
+ : ` (open next: ${b.apply.issue}, ${localTime(b.apply.opensAt)} – ${localTime(b.apply.closesAt)})`
307
+ fail(`applications for ${issue} are not open${next}`, { apply: withTimes(b.apply) })
308
+ }
281
309
  if (!signedIn()) fail(SIGN_IN)
282
310
  // gang.fun refuses a wallet without an Agent ID (no_agent_id); the create gate checks it again at launch
283
311
  const w = wallet()
284
312
  const rules = b.rules ?? {}
313
+ const pad = rules.pad || 'GangLaunchpad 3.0'
285
314
  const terms = [
286
- `If picked, launch it with gang create (a V3 curve token on ${rules.pad || 'GangLaunchpad 3.0'}, not --fair / --fly) from ${w} with symbol ${fields.symbol} at ${localTime(b.apply.launchAt) ?? 'Friday 20:00 UTC+8'}.`,
315
+ hold ? HOLD_TERM_LAUNCH(pad, w, fields.symbol) : `If picked, launch it with gang create (a V3 curve token on ${pad}, not --fair / --fly) from ${w} with symbol ${fields.symbol} at ${localTime(b.apply.launchAt) ?? 'Friday 20:00 UTC+8'}.`,
287
316
  `The pin is withdrawn early if the creator sells more than ${((rules.revokeSellBps ?? 2000) / 100).toFixed(0)}% of their holding during the 7-day featured week.`,
288
317
  'If picked: a gang.fun homepage card, X / TG posts and the first row of gang trending for the featured week.',
289
318
  'Only the gang.fun team sees contact; everything else may be shown publicly once picked.',
290
319
  ]
291
320
  if (!flag('yes')) {
292
321
  return out({
293
- success: true, preview: true, issue, number: b.apply.number ?? null,
322
+ success: true, preview: true, issue, number: b.apply.number ?? null, ...(hold && { hold: true }),
294
323
  // what --yes signs and sends, but the logo: a local file / another host's image becomes ipfs://<cid> on upload
295
324
  application: { issue, wallet: w.toLowerCase(), ...fields, logo: ipfsCid(logoArg) ? ipfsUri(ipfsCid(logoArg)) : logoArg },
296
325
  ...(!ipfsCid(logoArg) && { logoNote: `${files.length ? 'the file' : 'the image'} is uploaded to gang.fun with --yes; the application carries its ipfs://<cid>` }),
@@ -312,7 +341,8 @@ export async function runWeekly(sub, { opt, flag, out, fail, resolveLogo }) {
312
341
  return out({
313
342
  success: true, issue, status: r.status ?? 'pending', replaced: !!r.replaced, application,
314
343
  ...(logo.uploaded && { logoUploaded: logo.upload?.url ?? true }),
315
- note: `Submitted. The team picks one application on ${b.apply.launchAt > 0 ? localTime(b.apply.launchAt - 32 * 3600) : 'Thursday 12:00 UTC+8'} and contacts the pick; the pick goes public 24 hours before the launch. gang weekly lists it under mine, with its status.`,
344
+ ...(hold && { hold: true }),
345
+ note: hold ? HOLD_SUBMITTED : `Submitted. The team picks one application on ${b.apply.launchAt > 0 ? localTime(b.apply.launchAt - 32 * 3600) : 'Thursday 12:00 UTC+8'} and contacts the pick; the pick goes public 24 hours before the launch. gang weekly lists it under mine, with its status.`,
316
346
  url: WEEKLY_URL,
317
347
  })
318
348
  }