1.4.1

docs(cooking): worked examples, platform matrix, TradeParam, anti-mev-mode fix

docs/cli-usage.md

@@ -739,7 +739,7 @@ gmgn-cli cooking create \
   [--website <url>] [--twitter <url>] [--telegram <url>] \
   [--fee <amount>] [--priority-fee <sol>] [--tip-fee <amount>] [--gas-price <amount>] \
   [--max-fee-per-gas <amount>] [--max-priority-fee-per-gas <amount>] \
-  [--anti-mev] [--anti-mev-mode <normal|secure>] \
+  [--anti-mev] [--anti-mev-mode <off|normal|secure>] \
   [--raised-token <symbol>] \
   [--dev-wallet-bps <n>] [--dev-gas <amount>] [--dev-priority <amount>] [--dev-tip <amount>] [--dev-max-fee-per-gas <amount>] \
   [--approve-vision <v1|v2>] [--source <source>] \
@@ -776,7 +776,7 @@ gmgn-cli cooking create \
 | `--max-fee-per-gas` | No | Max fee per gas in wei (**EVM only**) |
 | `--max-priority-fee-per-gas` | No | Max priority fee per gas in wei (**EVM only**) |
 | `--anti-mev` | No | Enable anti-MEV protection (**SOL only**) |
-| `--anti-mev-mode` | No | Anti-MEV mode: `normal` / `secure` (**SOL only**) |
+| `--anti-mev-mode` | No | Anti-MEV mode: `off` / `normal` / `secure` (**SOL only**) |
 | `--raised-token` | No | Raise token symbol: `pump`→`USDC`; `bonk`→`USD1`; `fourmeme`→`USDT`/`USD1`; omit for native |
 | `--dev-wallet-bps` | No | Dev wallet fee share in basis points (100 = 1%) |
 | `--dev-gas` | No | Dev gas amount |
@@ -788,7 +788,7 @@ gmgn-cli cooking create \
 | `--is-mayhem` | No | Enable Mayhem mode (**Pump.fun only**) |
 | `--is-cashback` | No | Enable Cashback (**Pump.fun only**) |
 | `--is-buy-back` | No | Enable Agent Auto Buyback (**Pump.fun only**) |
-| `--pump-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"github","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
+| `--pump-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
 | `--flap-rate-conf` | No | Rate config as JSON object (**Flap only**) |
 | `--fourmeme-rate-conf` | No | Rate config as JSON object (**FourMeme only**) |
 | `--bags-fee-share-list` | No | Fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**BAGS only**) |

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "gmgn-cli",
-  "version": "1.3.9",
+  "version": "1.4.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "gmgn-cli",
-      "version": "1.3.9",
+      "version": "1.4.1",
       "license": "MIT",
       "dependencies": {
         "commander": "^12.1.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmgn-cli",
-  "version": "1.3.9",
+  "version": "1.4.1",
   "description": "GMGN OpenAPI CLI — call GMGN market, token, portfolio and swap APIs from the command line",
   "type": "module",
   "bin": {

skills/gmgn-cooking/SKILL.md

@@ -62,6 +62,16 @@ When the user names a platform colloquially (e.g. "pump.fun", "four.meme"), map
 
 **Anti-MEV** (`--anti-mev`) is only supported on `sol`. Passing it on `bsc` or `base` will return a 400 error.
 
+### Quote Token conversion (when `--raised-token` is set)
+
+`--buy-amt` is **always in native token units** (SOL / BNB / ETH), even when raising with a quote token like USDC / USD1 / USDT. If the user states the amount in the quote token, convert it to native yourself before passing it:
+
+```
+buy_amt_in_native = quote_amount × quote_price / native_price
+```
+
+This conversion applies to **`--buy-amt`, and the `buy_amt` field inside `--buy-wallets` and `--snip-buy-wallets`**. It does **not** apply to `--sell-configs` (`check_price` there is always a USD market cap, not a token amount). Round to the chain's native decimals. When `--raised-token` is empty/native, no conversion is needed.
+
 ## Prerequisites
 
 - `cooking stats`: Only `GMGN_API_KEY` required
@@ -151,7 +161,7 @@ gmgn-cli cooking stats [--raw]
 | `--max-fee-per-gas` | No | Max fee per gas in wei (**EVM only**) |
 | `--max-priority-fee-per-gas` | No | Max priority fee per gas in wei (**EVM only**) |
 | `--anti-mev` | No | Enable anti-MEV protection (**SOL only**; rejected on BSC / BASE) |
-| `--anti-mev-mode` | No | Anti-MEV mode: `normal` / `secure` (**SOL only**) |
+| `--anti-mev-mode` | No | Anti-MEV mode: `off` / `normal` / `secure` (**SOL only**) |
 | `--raised-token` | No | Raise token symbol. `pump`: `USDC`; `bonk`: `USD1`; `fourmeme`: `USDT` / `USD1`; omit or `""` for native |
 | `--dev-wallet-bps` | No | Dev wallet fee share in basis points (100 = 1%) |
 | `--dev-gas` | No | Dev gas amount |
@@ -163,7 +173,7 @@ gmgn-cli cooking stats [--raw]
 | `--is-mayhem` | No | Enable Mayhem mode (**Pump.fun only**) |
 | `--is-cashback` | No | Enable Cashback (**Pump.fun only**) |
 | `--is-buy-back` | No | Enable Agent Auto Buyback (**Pump.fun only**) |
-| `--pump-fee-share-list` | No | Pump.fun fee share list as JSON array: `[{"provider":"github","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
+| `--pump-fee-share-list` | No | Pump.fun fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**Pump.fun only**) |
 | `--flap-rate-conf` | No | Flap rate config as JSON object (**Flap only**) |
 | `--fourmeme-rate-conf` | No | FourMeme rate config as JSON object (**FourMeme only**) |
 | `--bags-fee-share-list` | No | BAGS fee share list as JSON array: `[{"provider":"twitter","username":"<handle>","basic_points":<n>}]` (**BAGS only**) |
@@ -181,6 +191,23 @@ gmgn-cli cooking stats [--raw]
 
 The structured flags (`--pump-fee-share-list`, `--bags-fee-share-list`, `--flap-rate-conf`, `--fourmeme-rate-conf`, `--buy-wallets`, `--snip-buy-wallets`, `--buy-trade-config`, `--sell-trade-config`, `--sell-configs`) each accept a **JSON string**. This section documents the exact JSON schema for each.
 
+### Platform capability matrix
+
+Which advanced features each platform supports. Do not send a field a platform does not support.
+
+| Platform | `--dex` | Chain | Platform-specific fields | Bundle (`--buy-wallets`) | Sniper (`--snip-buy-wallets`) | Cashback | Mayhem |
+|---|---|---|---|---|---|---|---|
+| Pump.fun | `pump` | SOL | `--pump-fee-share-list` / `--dev-wallet-bps` / `--is-buy-back` | ✅ up to 12 wallets | ✅ up to 10 | ✅ | ✅ |
+| Bonk | `bonk` | SOL | `--bonk-model` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| BAGS | `bags` | SOL | `--bags-fee-share-list` / `--dev-wallet-bps` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| FourMeme | `fourmeme` | BSC | `--fourmeme-rate-conf` | ✅ up to 3 wallets | ✅ up to 10 | ❌ | ❌ |
+| Flap | `flap` | BSC | `--flap-rate-conf` | ❌ | ✅ up to 10 | ❌ | ❌ |
+| Klik | `klik` | Base | — | ❌ | ✅ up to 10 | ❌ | ❌ |
+| Clanker | `clanker` | Base | — | ❌ | ✅ up to 10 | ❌ | ❌ |
+
+- `--is-cashback` / `--is-mayhem` are **Pump.fun only** — other platforms reject them.
+- Bundle/auto-sell (`--sell-configs`) and sniper (`--snip-buy-wallets`) are available where the matrix shows ✅.
+
 **Basis-points rule:** any field named `*_bps` / `basic_points` is in basis points (`100` = 1%). Where a section says the shares must sum, all entries must add up to exactly **10000** (FourMeme uses whole percents summing to **100** instead — see below).
 
 **Always talk to the user in percentages, never basis points.** When asking for or confirming any share, fee, or split, phrase it as a percentage (e.g. *"What % goes to this wallet?"* → user says `"50%"`). Convert to the field's unit yourself when building the JSON — never ask the user for a raw bps number:
@@ -206,11 +233,11 @@ Never set a fee-share split without the user's explicit instruction — it perma
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `provider` | string | Yes | `github` / `wallet` |
-| `username` | string | Yes | Username for `github`; a SOL address when `wallet` |
+| `provider` | string | Yes | `solana` / `twitter` / `github` |
+| `username` | string | Yes | Platform username; a SOL address when `provider` = `solana` |
 | `basic_points` | int | Yes | Share in bps — all entries must sum to **10000** |
 
-Example: `--pump-fee-share-list '[{"provider":"github","username":"handle","basic_points":10000}]'`
+Example: `--pump-fee-share-list '[{"provider":"twitter","username":"handle","basic_points":10000}]'`
 
 ### Bonk (`--dex bonk`)
 
@@ -298,6 +325,29 @@ The buy/sell execution params for these CondMarket orders (slippage, fees, anti-
 > - `wallet_addresses` may mix `from_address` and `buy_wallets` entries. The server creates `signal_cooking` for snipe wallets and `pending_sell` for main/bundle wallets automatically.
 > - A wallet can carry multiple strategies (e.g. delay-sell 50%, then limit-sell the rest); each applies independently.
 
+### TradeParam (`--buy-trade-config` / `--sell-trade-config`)
+
+These tune the **execution params for the CondMarket buy/sell orders** (bundle buys, sniper buys, and auto-sell). They do **not** affect the main creation transaction (the dev tx uses the outer-level `--dev-*` flags). When omitted, they fall back to the outer-level transaction flags.
+
+`--buy-trade-config` / `--sell-trade-config` each accept a single JSON object:
+
+| Field | Type | Description |
+|---|---|---|
+| `slippage` | number | Slippage; only sent when truthy |
+| `fee` | string | Base gas / fee; only sent when truthy |
+| `priority_fee` | string | Priority fee; only sent when truthy |
+| `tip_fee` | string | SOL Jito tip; only sent when truthy |
+| `gas_price` | string | Gas price in wei (EVM); only sent when truthy |
+| `max_priority_fee_per_gas` | string | EVM EIP-1559; only sent when truthy |
+| `max_fee_per_gas` | string | EVM EIP-1559; only sent when truthy |
+| `auto_slippage` | bool | Always sent |
+| `is_anti_mev` | bool | Always sent |
+| `anti_mev_mode` | string | `off` / `normal` / `secure`; always sent |
+
+Example: `--buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}'`
+
+> A standard launch with no `buyConfig` sends `{"is_anti_mev":false,"anti_mev_mode":"off"}` and an empty `buy_wallets` list.
+
 ## `cooking create` Response Fields
 
 | Field | Type | Description |
@@ -376,6 +426,57 @@ gmgn-cli cooking create \
   --sell-configs '[{"sell_type":"delay_sell","delay_sec":60,"sell_ratio":"0.5","wallet_addresses":["<wallet_address>"]}]'
 ```
 
+### Full worked examples
+
+These mirror real launch configurations end-to-end. Copy and adapt — every JSON flag below is a valid payload shape.
+
+**Pump.fun (SOL) — Bundle + Sniper + Auto-Sell + Agent Auto Buyback**
+
+```bash
+gmgn-cli cooking create \
+  --chain sol \
+  --dex pump \
+  --from DevWallet... \
+  --name "Demo Coin" \
+  --symbol DEMO \
+  --buy-amt 0.5 \
+  --image-url https://cdn.example.com/coin.png \
+  --twitter https://x.com/handle/status/123 \
+  --priority-fee 0.0005 \
+  --tip-fee 0.0001 \
+  --is-buy-back \
+  --buy-trade-config '{"slippage":50,"auto_slippage":false,"priority_fee":"0.0005","tip_fee":"0.0001","is_anti_mev":true,"anti_mev_mode":"secure"}' \
+  --buy-wallets '[{"from_address":"Wallet1...","buy_amt":"0.1"},{"from_address":"Wallet2...","buy_amt":"0.1"}]' \
+  --snip-buy-wallets '[{"from_address":"Sniper1...","buy_amt":"0.05"}]' \
+  --sell-configs '[{"sell_type":"delay_sell","sell_ratio":"1","wallet_addresses":["Wallet1..."],"delay_mili_sec":5000}]'
+```
+
+- `--is-buy-back` is the Agent Auto Buyback mode (the backend also sets the agent fee internally).
+- `buy_amt` values in `--buy-wallets` / `--snip-buy-wallets` are in native SOL.
+- Bundle wallets ≤ 12, sniper wallets ≤ 10 on Pump.fun (see capability matrix).
+
+**FourMeme (BSC) — user fee split + raise token USDT**
+
+```bash
+gmgn-cli cooking create \
+  --chain bsc \
+  --dex fourmeme \
+  --from 0xDev... \
+  --name "Demo BSC" \
+  --symbol DBSC \
+  --buy-amt 0.0123 \
+  --image-url https://cdn.example.com/coin.png \
+  --raised-token USDT \
+  --website https://demo.com \
+  --gas-price 1000000000 \
+  --auto-slippage \
+  --fourmeme-rate-conf '{"fee_rate":1,"recipient_rate":50,"burn_rate":20,"divide_rate":20,"liquidity_rate":10,"min_sharing":100000,"recipient_address":"0xDev..."}'
+```
+
+- `--buy-amt 0.0123` is **already converted to native BNB** from the USDT amount the user wanted (see Quote Token conversion). Do the conversion before building the command.
+- `--gas-price 1000000000` is wei (1 Gwei).
+- In `--fourmeme-rate-conf`, `recipient_rate + burn_rate + divide_rate + liquidity_rate` must sum to **100**.
+
 ## Output Format
 
 ### Pre-create Confirmation

src/client/OpenApiClient.ts

@@ -173,8 +173,8 @@ export interface TokenSignalGroup {
 }
 
 export interface PumpFeeShareInfo {
-  provider: string;       // "github" | "wallet"
-  username: string;       // username for github; a SOL address when wallet
+  provider: string;       // "solana" | "twitter" | "github"
+  username: string;       // platform username; a SOL address when provider = "solana"
   basic_points: number;
 }
 

src/commands/cooking.ts

@@ -41,7 +41,7 @@ export function registerCookingCommands(program: Command): void {
     .option("--max-fee-per-gas <amount>", "Max fee per gas in wei (EVM only)")
     .option("--max-priority-fee-per-gas <amount>", "Max priority fee per gas in wei (EVM only)")
     .option("--anti-mev", "Enable anti-MEV protection (SOL only)")
-    .option("--anti-mev-mode <mode>", "Anti-MEV mode: normal / secure (SOL only)")
+    .option("--anti-mev-mode <mode>", "Anti-MEV mode: off / normal / secure (SOL only)")
     .option("--raised-token <symbol>", "Raise token symbol: pump→USDC; bonk→USD1; fourmeme→USDT/USD1; leave empty for native")
     .option("--dev-wallet-bps <n>", "Dev wallet fee in basis points (100 = 1%)", parseInt)
     .option("--dev-gas <amount>", "Dev gas amount")