@four-meme/four-meme-ai 1.0.6 → 1.0.8

package/CLAUDE.md

@@ -1,91 +1,91 @@
-# four-meme-ai – Agent Guidelines (Claude / Claude Code)
-
-## Overview
-
-This repo provides the **four-meme-integration** skill for AI agents: create and trade meme tokens on **four.meme (BSC only)** using the official API and on-chain contracts (**TokenManager2**, **TokenManagerHelper3**). TokenManager V1 is **not** supported by this skill.
-
-The authoritative specification for this skill is `skills/four-meme-integration/SKILL.md`. Claude/Claude Code should treat that file as the main contract for behavior, safety, and command usage.
-
-## When to Use This Skill
-
-Use this repo when the user explicitly or implicitly asks to:
-
-- **Create** a meme token on four.meme on BSC (full API flow + `TokenManager2.createToken` on-chain).
-- **Buy** or **sell** a four.meme token on BSC (quote with Helper3, execute via TokenManager2).
-- **Query token info** (version, tokenManager, price, offers, etc.) for a given token address or requestId.
-- **Query lists / rankings** of four.meme tokens (REST list, detail, advanced rankings).
-- **Query Tax token fee/tax config**, or execute Tax-type token creation.
-- **Send BNB / ERC20** from the trading wallet to another address on BSC.
-- **Register / query** an EIP‑8004 identity NFT (8004 registry contract on BSC).
-
-If the user’s request does not involve four.meme, BSC, or these flows, you should not use this skill.
-
-## Repo Layout
-
-```
-four-meme-ai/
-├── skills/
-│   └── four-meme-integration/
-│       ├── SKILL.md        # Main skill instructions (Cursor / OpenClaw)
-│       ├── references/     # API, addresses, errors, trading, events, tax
-│       └── scripts/        # create-token, get-token-info, quote-buy/sell, etc.
-├── bin/
-│   └── fourmeme.cjs        # CLI dispatcher (fourmeme ...)
-├── package.json
-├── README.md
-└── CLAUDE.md               # This file (Claude-facing guidelines)
-```
-
-## Safety and Private Key Handling
-
-The SKILL defines a **User Agreement & Security Notice** (bilingual: English + Traditional Chinese). Claude MUST:
-
-1. On first use of this skill in a conversation, present the User Agreement and Security Notice in the user’s language (use the 繁體中文 block when the user writes in Traditional Chinese; otherwise use English).
-2. Make clear that **continuing to use this plugin/skill implies acceptance of the User Agreement**.
-3. **MUST NOT** run any operation that uses a private key or writes on-chain (e.g. `create-api`, `create-chain`, `buy`, `sell`, `send`, `8004-register`) until the user has explicitly agreed or confirmed to continue.
-4. May run read‑only commands (e.g. `config`, `token-info`, `quote-buy`, `8004-balance`) while or after presenting the notice.
-
-Never ask the user to paste a private key into chat. All private keys must come from environment / config (e.g. `PRIVATE_KEY`) as described in `SKILL.md`.
-
-## Conventions (aligned with SKILL.md)
-
-1. **Chain**: BSC only (chainId 56). Arbitrum and Base are **out of scope** for this skill.
-2. **Trading**:
-   - Always call Helper3 `getTokenInfo(token)` first to get `version`, `tokenManager`, and current price/offers.
-   - Only **version 2** (TokenManager2) is supported by this skill; do not attempt V1 flows.
-   - For X Mode / TaxToken / AntiSniperFeeMode detection and error codes, see `skills/four-meme-integration/references/errors.md`.
-3. **Create token**:
-   - `raisedToken` must always come from `GET https://four.meme/meme-api/v1/public/config` and be used **as is** in the create body; do not invent or modify internal fields.
-   - For tax-type tokens, follow `tokenTaxInfo` constraints in `references/token-tax-info.md` and the interactive flow in `SKILL.md` (“Create token (full flow)”).
-4. **RPC and private key (environment)**:
-   - When **using OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are configured in OpenClaw (e.g. `skills.entries["four-meme-ai"].env` or apiKey); see SKILL.md.
-   - When **not using OpenClaw (standalone)**: set `PRIVATE_KEY` and optionally `BSC_RPC_URL` via the process environment—e.g. a `.env` file in the **directory where you run `fourmeme`** (the CLI loads it automatically via dotenv) or shell `export`. Do not ask the user to paste a private key in chat.
-
-## CLI Usage (fourmeme)
-
-From the project root after `npm install`, use:
-
-```bash
-npx fourmeme <command> [args...]
-```
-
-Key commands (full list and parameters in `SKILL.md`):
-
-- `fourmeme config` – Get public config (raisedToken).
-- `fourmeme create-api` / `fourmeme create-chain` – Create token (API + on-chain).
-- `fourmeme token-info` / `token-list` / `token-get` / `token-rankings` – On-chain info and REST queries.
-- `fourmeme quote-buy` / `quote-sell` – Estimate buy/sell without sending tx.
-- `fourmeme buy` / `sell` – Execute buy/sell via TokenManager2 (V2 only).
-- `fourmeme send` – Send BNB or ERC20 from the trading wallet.
-- `fourmeme 8004-register` / `8004-balance` – EIP‑8004 identity NFT register and query.
-- `fourmeme events` – TokenManager2 events (TokenCreate, TokenPurchase, TokenSale, LiquidityAdded).
-- `fourmeme tax-info` – TaxToken on-chain fee/tax config.
-
-Always prefer these CLI commands rather than calling scripts directly, unless `SKILL.md` suggests otherwise.
-
-## External Docs
-
-For deeper protocol details, see:
-
-- In-repo: `skills/four-meme-integration/references/` (api-create-token, token-query-api, execute-trade, event-listening, tax-token-query, errors).
-- Official four.meme API and contracts (online): [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, etc.).
+# four-meme-ai – Agent Guidelines (Claude / Claude Code)
+
+## Overview
+
+This repo provides the **four-meme-integration** skill for AI agents: create and trade meme tokens on **four.meme (BSC only)** using the official API and on-chain contracts (**TokenManager2**, **TokenManagerHelper3**). TokenManager V1 is **not** supported by this skill.
+
+The authoritative specification for this skill is `skills/four-meme-integration/SKILL.md`. Claude/Claude Code should treat that file as the main contract for behavior, safety, and command usage.
+
+## When to Use This Skill
+
+Use this repo when the user explicitly or implicitly asks to:
+
+- **Create** a meme token on four.meme on BSC (full API flow + `TokenManager2.createToken` on-chain).
+- **Buy** or **sell** a four.meme token on BSC (quote with Helper3, execute via TokenManager2).
+- **Query token info** (version, tokenManager, price, offers, etc.) for a given token address or requestId.
+- **Query lists / rankings** of four.meme tokens (REST list, detail, advanced rankings).
+- **Query Tax token fee/tax config**, or execute Tax-type token creation.
+- **Send BNB / ERC20** from the trading wallet to another address on BSC.
+- **Register / query** an EIP‑8004 identity NFT (8004 registry contract on BSC).
+
+If the user’s request does not involve four.meme, BSC, or these flows, you should not use this skill.
+
+## Repo Layout
+
+```
+four-meme-ai/
+├── skills/
+│   └── four-meme-integration/
+│       ├── SKILL.md        # Main skill instructions (Cursor / OpenClaw)
+│       ├── references/     # API, addresses, errors, trading, events, tax
+│       └── scripts/        # create-token, get-token-info, quote-buy/sell, etc.
+├── bin/
+│   └── fourmeme.cjs        # CLI dispatcher (fourmeme ...)
+├── package.json
+├── README.md
+└── CLAUDE.md               # This file (Claude-facing guidelines)
+```
+
+## Safety and Private Key Handling
+
+The SKILL defines a **User Agreement & Security Notice** (bilingual: English + Traditional Chinese). Claude MUST:
+
+1. On first use of this skill in a conversation, present the User Agreement and Security Notice in the user’s language (use the 繁體中文 block when the user writes in Traditional Chinese; otherwise use English).
+2. Make clear that **continuing to use this plugin/skill implies acceptance of the User Agreement**.
+3. **MUST NOT** run any operation that uses a private key or writes on-chain (e.g. `create-api`, `create-chain`, `buy`, `sell`, `send`, `8004-register`) until the user has explicitly agreed or confirmed to continue.
+4. May run read‑only commands (e.g. `config`, `token-info`, `quote-buy`, `8004-balance`) while or after presenting the notice.
+
+Never ask the user to paste a private key into chat. All private keys must come from environment / config (e.g. `PRIVATE_KEY`) as described in `SKILL.md`.
+
+## Conventions (aligned with SKILL.md)
+
+1. **Chain**: BSC only (chainId 56). Arbitrum and Base are **out of scope** for this skill.
+2. **Trading**:
+   - Always call Helper3 `getTokenInfo(token)` first to get `version`, `tokenManager`, and current price/offers.
+   - Only **version 2** (TokenManager2) is supported by this skill; do not attempt V1 flows.
+   - For X Mode / TaxToken / AntiSniperFeeMode detection and error codes, see `skills/four-meme-integration/references/errors.md`.
+3. **Create token**:
+   - `raisedToken` must always come from `GET https://four.meme/meme-api/v1/public/config` and be used **as is** in the create body; do not invent or modify internal fields.
+   - For tax-type tokens, follow `tokenTaxInfo` constraints in `references/token-tax-info.md` and the interactive flow in `SKILL.md` (“Create token (full flow)”).
+4. **RPC and private key (environment)**:
+   - When **using OpenClaw**: PRIVATE_KEY and BSC_RPC_URL are configured in OpenClaw (e.g. `skills.entries["four-meme-ai"].env` or apiKey); see SKILL.md.
+   - When **not using OpenClaw (standalone)**: set `PRIVATE_KEY` and optionally `BSC_RPC_URL` via the process environment—e.g. a `.env` file in the **directory where you run `fourmeme`** (the CLI loads it automatically via dotenv) or shell `export`. Do not ask the user to paste a private key in chat.
+
+## CLI Usage (fourmeme)
+
+From the project root after `npm install`, use:
+
+```bash
+npx fourmeme <command> [args...]
+```
+
+Key commands (full list and parameters in `SKILL.md`):
+
+- `fourmeme config` – Get public config (raisedToken).
+- `fourmeme create-api` / `fourmeme create-chain` – Create token (API + on-chain).
+- `fourmeme token-info` / `token-list` / `token-get` / `token-rankings` – On-chain info and REST queries.
+- `fourmeme quote-buy` / `quote-sell` – Estimate buy/sell without sending tx.
+- `fourmeme buy` / `sell` – Execute buy/sell via TokenManager2 (V2 only).
+- `fourmeme send` – Send BNB or ERC20 from the trading wallet.
+- `fourmeme 8004-register` / `8004-balance` – EIP‑8004 identity NFT register and query.
+- `fourmeme events` – TokenManager2 events (TokenCreate, TokenPurchase, TokenSale, LiquidityAdded).
+- `fourmeme tax-info` – TaxToken on-chain fee/tax config.
+
+Always prefer these CLI commands rather than calling scripts directly, unless `SKILL.md` suggests otherwise.
+
+## External Docs
+
+For deeper protocol details, see:
+
+- In-repo: `skills/four-meme-integration/references/` (api-create-token, token-query-api, execute-trade, event-listening, tax-token-query, errors).
+- Official four.meme API and contracts (online): [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, etc.).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lol-dev-99
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -31,9 +31,9 @@ When the user needs to create or trade meme tokens on four.meme (BSC), use the *
 | `create-chain` | `<createArgHex>` `<signatureHex>` `[--value=<wei>]` or `--` (stdin JSON) | Submit createToken on BSC. Env: PRIVATE_KEY. |
 | `create-instant` | `--image=` `--name=` `--short-name=` `--desc=` `--label=` `[--web-url=]` `[--twitter-url=]` `[--telegram-url=]` `[--pre-sale=<BNB>]` `[--fee-plan=false]` `[--value=<wei>]` `[--tax-options=<path>]` or `[--tax-token --tax-fee-rate=5 ...]` | One-shot create (API + chain). Same options as create-api plus `--value=` override. Env: PRIVATE_KEY. |
 | `token-info` | `<tokenAddress>` | On-chain token info (Helper3). |
-| `token-list` | `[--orderBy=Hot]` `[--pageIndex=1]` `[--pageSize=30]` `[--tokenName=]` `[--symbol=]` `[--labels=]` `[--listedPancake=false]` | REST token list. |
+| `token-list` | Legacy query flags or `[--type=]` `[--listType=]` `[--keyword=]` `[--tag=]` `[--status=]` `[--sort=]` `[--version=]` … (also legacy `--queryMode=Binance|USD1` to infer `listType`) | POST `/public/token/search` (token list). |
 | `token-get` | `<tokenAddress>` | REST token detail + trading info. |
-| `token-rankings` | `<orderBy>` `[--barType=HOUR24]` | Rankings. orderBy: `Time|ProgressDesc|TradingDesc|Hot|Graduated`. |
+| `token-rankings` | `<orderBy or type>` `[--barType=]` `[--pageSize=]` `[--symbol=]` `[--version=]` `[--rankingKind=]` `[--minCap=]` `[--maxCap=]` `[--minVol=]` `[--maxVol=]` `[--minHold=]` `[--maxHold=]` … | POST `/public/token/ranking`; legacy orderBy or native type (e.g. `VOL_DAY_1`). |
 | `quote-buy` | `<tokenAddress>` `<amountWei>` `[fundsWei]` | Estimate buy (no tx). Use 0 for amount or funds. |
 | `quote-sell` | `<tokenAddress>` `<amountWei>` | Estimate sell (no tx). |
 | `buy` | `<token>` `amount` `<amountWei>` `<maxFundsWei>` | Buy fixed amount. Env: PRIVATE_KEY. |

package/bin/fourmeme.cjs

@@ -87,14 +87,17 @@ Commands and parameters:
     On-chain token info (Helper3). No auth.
 
   token-list
-    [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
-    REST token list. No auth.
+    POST /public/token/search. Legacy: [--orderBy=] [--tokenName=] [--listedPancake=] …
+    New: [--type=] [--listType=] [--keyword=] [--tag=] [--status=] [--sort=] [--version=] [--pageIndex=] [--pageSize=].
+         Legacy queryMode mapping: [--queryMode=Binance|USD1] (infers listType BIN/BIN_DEX or USD1/USD1_DEX by listedPancake).
+    No auth.
 
   token-get <tokenAddress>
     REST token detail + trading info. No auth.
 
-  token-rankings <orderBy> [--barType=HOUR24]
-    orderBy: Time|ProgressDesc|TradingDesc|Hot|Graduated. barType for TradingDesc. No auth.
+  token-rankings <orderBy|type> [--barType=HOUR24] [--pageSize=] [--symbol=] [--version=] [--rankingKind=] [--minCap=] [--maxCap=] [--minVol=] [--maxVol=] [--minHold=] [--maxHold=] …
+    POST /public/token/ranking. Legacy: Time|ProgressDesc|TradingDesc|Hot|Graduated; or native type e.g. VOL_DAY_1.
+    No auth.
 
   quote-buy <tokenAddress> <amountWei> [fundsWei]
     Estimate buy. Use 0 for amount or funds. No tx.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@four-meme/four-meme-ai",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Four.meme AI skills for creating and trading meme tokens (BSC only)",
   "license": "MIT",
   "type": "module",
@@ -44,13 +44,13 @@
   ],
   "dependencies": {
     "@four-meme/four-meme-ai": "^1.0.5",
-    "dotenv": "^16.0.0"
+    "dotenv": "^16.0.0",
+    "tsx": "^4.20.0",
+    "viem": "^2.0.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "tsx": "^4.20.0",
-    "typescript": "^5.0.0",
-    "viem": "^2.0.0"
+    "typescript": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"