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

package/bin/fourmeme.cjs

@@ -1,128 +1,171 @@
-#!/usr/bin/env node
-/**
- * fourmeme CLI - dispatches to four-meme-integration scripts.
- * Usage: fourmeme <command> [args...]
- * Run "fourmeme --help" for commands.
- * Loads .env from current working directory (where you run fourmeme) if present.
- */
-const { spawnSync } = require('child_process');
-const path = require('path');
-
-// Load .env from cwd (e.g. your project dir) so PRIVATE_KEY, BSC_RPC_URL etc. work when running from a project
-require('dotenv').config({ path: path.join(process.cwd(), '.env') });
-
-const root = path.join(__dirname, '..');
-const scriptsDir = path.join(root, 'skills', 'four-meme-integration', 'scripts');
-
-const commands = {
-  config: 'get-public-config.ts',
-  'create-api': 'create-token-api.ts',
-  'create-chain': 'create-token-chain.ts',
-  'token-info': 'get-token-info.ts',
-  'token-list': 'token-list.ts',
-  'token-get': 'token-get.ts',
-  'token-rankings': 'token-rankings.ts',
-  'quote-buy': 'quote-buy.ts',
-  'quote-sell': 'quote-sell.ts',
-  buy: 'execute-buy.ts',
-  sell: 'execute-sell.ts',
-  send: 'send-token.ts',
-  '8004-register': '8004-register.ts',
-  '8004-balance': '8004-balance.ts',
-  events: 'get-recent-events.ts',
-  'tax-info': 'get-tax-token-info.ts',
-  verify: null, // special: run config + verify-events
-};
-
-function run(scriptName, args = []) {
-  const scriptPath = path.join(scriptsDir, scriptName);
-  const result = spawnSync('npx', ['tsx', scriptPath, ...args], {
-    stdio: 'inherit',
-    shell: true,
-    cwd: root,
-  });
-  process.exit(result.status ?? 1);
-}
-
-function printHelp() {
-  console.log(`fourmeme - Four.meme CLI (BSC only)
-
-Usage: npx fourmeme <command> [args...]
-
-(In project dir, use npx fourmeme; npm install does not add fourmeme to PATH.)
-
-Commands:
-  config                    Get public config (raisedToken). No auth.
-  create-api <img> <name> <symbol> <desc> <label> [tax.json]
-                            Create token API flow. Env: PRIVATE_KEY.
-  create-chain <createArgHex> <signatureHex>
-                            Submit createToken tx on BSC. Or: fourmeme create-chain -- (stdin JSON)
-  token-info <tokenAddress>
-                            Get token info from Helper3 (BSC, on-chain).
-  token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]
-                            Token list (REST API, filter/query).
-  token-get <tokenAddress>
-                            Token detail + trading info (REST API get/v2).
-  token-rankings <orderBy> [--barType=HOUR24]
-                            Rankings: orderBy=Time|ProgressDesc|TradingDesc|Hot|Graduated. barType only for TradingDesc.
-  quote-buy <token> <amountWei> [fundsWei]
-                            Estimate buy (no tx). Use 0 for amount or funds.
-  quote-sell <token> <amountWei>
-                            Estimate sell (no tx).
-  buy <token> amount <amountWei> <maxFundsWei>
-                            Execute buy: fixed token amount. Env: PRIVATE_KEY.
-  buy <token> funds <fundsWei> <minAmountWei>
-                            Execute buy: spend fixed quote (e.g. BNB). Env: PRIVATE_KEY.
-  sell <token> <amountWei> [minFundsWei]
-                            Execute sell. Env: PRIVATE_KEY.
-  send <toAddress> <amountWei> [tokenAddress]
-                            Send BNB or ERC20 to address. Omit tokenAddress for BNB. Env: PRIVATE_KEY.
-  8004-register <name> [imageUrl] [description]
-                            EIP-8004: register identity NFT. Env: PRIVATE_KEY.
-  8004-balance <ownerAddress>
-                            EIP-8004: query NFT balance of address (read-only).
-  events <fromBlock> [toBlock]
-                            TokenManager2 events (BSC). Default toBlock: latest.
-  tax-info <tokenAddress>
-                            TaxToken fee/tax config (BSC, creatorType 5 only).
-  verify                    Run config + events for last 50 blocks (read-only check).
-
-Env: PRIVATE_KEY, BSC_RPC_URL. See SKILL.md for full docs.
-`);
-}
-
-const argv = process.argv.slice(2);
-const cmd = argv[0];
-
-if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
-  printHelp();
-  process.exit(0);
-}
-
-if (cmd === 'verify') {
-  const r1 = spawnSync('npx', ['tsx', path.join(scriptsDir, 'get-public-config.ts')], {
-    stdio: 'inherit',
-    shell: true,
-    cwd: root,
-  });
-  if (r1.status !== 0) process.exit(r1.status ?? 1);
-  const r2 = spawnSync('npx', ['tsx', path.join(scriptsDir, 'verify-events.ts')], {
-    stdio: 'inherit',
-    shell: true,
-    cwd: root,
-  });
-  process.exit(r2.status ?? 1);
-}
-
-const script = commands[cmd];
-if (!script) {
-  console.error(`Unknown command: ${cmd}`);
-  printHelp();
-  process.exit(1);
-}
-
-if (cmd === 'events') {
-  run(script, ['56', ...argv.slice(1)]);
-} else {
-  run(script, argv.slice(1));
-}
+#!/usr/bin/env node
+/**
+ * fourmeme CLI - dispatches to four-meme-integration scripts.
+ * Usage: fourmeme <command> [args...]
+ * Run "fourmeme --help" for commands.
+ * Loads .env from current working directory (where you run fourmeme) if present.
+ */
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+// Load .env from cwd (e.g. your project dir) so PRIVATE_KEY, BSC_RPC_URL etc. work when running from a project
+require('dotenv').config({ path: path.join(process.cwd(), '.env') });
+
+const root = path.join(__dirname, '..');
+const scriptsDir = path.join(root, 'skills', 'four-meme-integration', 'scripts');
+
+const commands = {
+  config: 'get-public-config.ts',
+  'create-api': 'create-token-api.ts',
+  'create-chain': 'create-token-chain.ts',
+  'create-instant': 'create-token-instant.ts',
+  'token-info': 'get-token-info.ts',
+  'token-list': 'token-list.ts',
+  'token-get': 'token-get.ts',
+  'token-rankings': 'token-rankings.ts',
+  'quote-buy': 'quote-buy.ts',
+  'quote-sell': 'quote-sell.ts',
+  buy: 'execute-buy.ts',
+  sell: 'execute-sell.ts',
+  send: 'send-token.ts',
+  '8004-register': '8004-register.ts',
+  '8004-balance': '8004-balance.ts',
+  events: 'get-recent-events.ts',
+  'tax-info': 'get-tax-token-info.ts',
+  verify: null, // special: run config + verify-events
+};
+
+function run(scriptName, args = []) {
+  const scriptPath = path.join(scriptsDir, scriptName);
+  const result = spawnSync('npx', ['tsx', scriptPath, ...args], {
+    stdio: 'inherit',
+    shell: true,
+    cwd: root,
+  });
+  process.exit(result.status ?? 1);
+}
+
+function printHelp() {
+  console.log(`fourmeme - Four.meme CLI (BSC only)
+
+Usage: npx fourmeme <command> [args...]
+
+Commands and parameters:
+
+  config
+    (no args) Get public config (raisedToken). No auth.
+
+  create-api
+    Required: --image=<path> --name=<name> --short-name=<symbol> --desc=<text> --label=<label>
+    Optional: --web-url= --twitter-url= --telegram-url= (omit if empty)
+              --pre-sale=<BNB> (ether units, e.g. 0.001)
+              --fee-plan=false
+              --tax-options=<path>   OR  --tax-token --tax-fee-rate=5 --tax-burn-rate=0
+              --tax-divide-rate=0 --tax-liquidity-rate=100 --tax-recipient-rate=0
+              --tax-recipient-address= --tax-min-sharing=100000
+    Label: Meme|AI|Defi|Games|Infra|De-Sci|Social|Depin|Charity|Others
+    Env: PRIVATE_KEY.
+
+  create-chain
+    <createArgHex> <signatureHex>  [--value=<wei>]
+    Or: fourmeme create-chain -- (read createArg, signature, creationFeeWei from stdin JSON)
+    Env: PRIVATE_KEY, optional CREATION_FEE_WEI.
+
+  create-instant
+    Required: --image=<path> --name=<name> --short-name=<symbol> --desc=<text> --label=<label>
+    Optional: --web-url= --twitter-url= --telegram-url= (omit if empty)
+              --pre-sale=<BNB> (ether units, e.g. 0.001)
+              --fee-plan=false
+              --value=<wei> (override computed creation fee; default from API)
+              --tax-options=<path>   OR  --tax-token --tax-fee-rate=5 --tax-burn-rate=0
+              --tax-divide-rate=0 --tax-liquidity-rate=100 --tax-recipient-rate=0
+              --tax-recipient-address= --tax-min-sharing=100000
+    Label: Meme|AI|Defi|Games|Infra|De-Sci|Social|Depin|Charity|Others
+    One-shot: API + submit createToken. Env: PRIVATE_KEY.
+
+  token-info <tokenAddress>
+    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.
+
+  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.
+
+  quote-buy <tokenAddress> <amountWei> [fundsWei]
+    Estimate buy. Use 0 for amount or funds. No tx.
+
+  quote-sell <tokenAddress> <amountWei>
+    Estimate sell. No tx.
+
+  buy <tokenAddress> amount <amountWei> <maxFundsWei>
+    Buy fixed token amount. Env: PRIVATE_KEY.
+
+  buy <tokenAddress> funds <fundsWei> <minAmountWei>
+    Spend fixed quote (e.g. BNB). Env: PRIVATE_KEY.
+
+  sell <tokenAddress> <amountWei> [minFundsWei]
+    Execute sell. Env: PRIVATE_KEY.
+
+  send <toAddress> <amountWei> [tokenAddress]
+    Send BNB or ERC20. Omit tokenAddress for BNB. Env: PRIVATE_KEY.
+
+  8004-register <name> [imageUrl] [description]
+    EIP-8004 register identity NFT. Env: PRIVATE_KEY.
+
+  8004-balance <ownerAddress>
+    EIP-8004 query NFT balance. Read-only.
+
+  events <fromBlock> [toBlock]
+    TokenManager2 events (BSC). toBlock default: latest.
+
+  tax-info <tokenAddress>
+    TaxToken fee/tax config (creatorType 5). Read-only.
+
+  verify
+    (no args) Config + events last 50 blocks. Read-only.
+
+Env: PRIVATE_KEY (required for create-api, create-chain, create-instant, buy, sell, send, 8004-register).
+     BSC_RPC_URL, CREATION_FEE_WEI optional. See SKILL.md.
+`);
+}
+
+const argv = process.argv.slice(2);
+const cmd = argv[0];
+
+if (!cmd || cmd === '--help' || cmd === '-h' || cmd === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+if (cmd === 'verify') {
+  const r1 = spawnSync('npx', ['tsx', path.join(scriptsDir, 'get-public-config.ts')], {
+    stdio: 'inherit',
+    shell: true,
+    cwd: root,
+  });
+  if (r1.status !== 0) process.exit(r1.status ?? 1);
+  const r2 = spawnSync('npx', ['tsx', path.join(scriptsDir, 'verify-events.ts')], {
+    stdio: 'inherit',
+    shell: true,
+    cwd: root,
+  });
+  process.exit(r2.status ?? 1);
+}
+
+const script = commands[cmd];
+if (!script) {
+  console.error(`Unknown command: ${cmd}`);
+  printHelp();
+  process.exit(1);
+}
+
+if (cmd === 'events') {
+  run(script, ['56', ...argv.slice(1)]);
+} else {
+  run(script, argv.slice(1));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@four-meme/four-meme-ai",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Four.meme AI skills for creating and trading meme tokens (BSC only)",
   "license": "MIT",
   "type": "module",
@@ -43,6 +43,7 @@
     "openclaw"
   ],
   "dependencies": {
+    "@four-meme/four-meme-ai": "^1.0.5",
     "dotenv": "^16.0.0"
   },
   "devDependencies": {

package/skills/four-meme-integration/SKILL.md

@@ -1,25 +1,16 @@
 ---
 name: four-meme-ai
 description: |
-  CLI tool to create and trade meme tokens on four.meme (BSC only). Returns structured JSON for config, token info, quotes, events, and TaxToken tax info.
+  CLI tool for creating and trading meme tokens on Four.Meme (BSC), with structured JSON outputs for config, token details, pricing quotes, on-chain events, and TaxToken fee configuration.
 
-  **AGENT MUST**: On first response to any user request related to fourmeme or this skill, **you must first** present to the user, **in this order: User Agreement, then Security Notice** (User Agreement = plugin nature and limitation of liability). **Present them in the user’s language**: use the 繁體中文 block if the user writes in Traditional Chinese, otherwise use the English block (see the bilingual section below). State clearly that by choosing to continue, the user agrees to the User Agreement. Until the user explicitly agrees or confirms to continue, you **must not** run any private-key or on-chain write operations (e.g. create-api, create-chain, buy, sell, send, 8004-register). Read-only commands (e.g. config, token-info, quote-buy, 8004-balance) may run while or after presenting the notice.
+  
 
-  USE FOR:
-  - Creating meme tokens (API + chain) on BSC, including tax-type tokens
-  - Getting buy/sell quotes and token info via TokenManagerHelper3 (BSC only)
-  - Listening to TokenCreate, TokenPurchase, TokenSale, LiquidityAdded (TokenManager2, BSC)
-  - Querying TaxToken fee/tax config on-chain (BSC only)
-  - **Discover → detail → quote → execute**: use token-rankings / token-list / events to find tokens → token-get / token-info for details → quote-buy / quote-sell to estimate → buy / sell to execute (see "Agent workflow: buy/sell from rankings or events" below).
-
-  BSC only (Arbitrum/Base not supported). **Before use, the fourmeme CLI must be installed** (e.g. `npm install -g @four-meme/four-meme-ai@latest`). Create/chain need PRIVATE_KEY. TokenManager V1 not supported.
-  **OpenClaw**: Only **PRIVATE_KEY** is declared in registry metadata (`requires.env`) and is injected when this skill is **enabled**; **BSC_RPC_URL** is optional (set in global env or project `.env`). **Two steps required**: (1) Configure private key in the skill’s `apiKey` or `skills.entries["four-meme-ai"].env`; (2) **Enable this skill** so OpenClaw injects PRIVATE_KEY. See "PRIVATE_KEY and BSC_RPC_URL" and "Declared and optional environment variables" below.
 allowed-tools:
   - Bash(fourmeme *)
   - Bash(npx fourmeme *)
 license: MIT
 metadata:
-  {"author":"Four.meme AI Skill","version":"1.0.0","openclaw":{"requires":{"env":["PRIVATE_KEY"]},"primaryEnv":"PRIVATE_KEY","optionalEnv":["BSC_RPC_URL"]}}
+  {"author":"Four.meme AI Skill","version":"1.0.4","openclaw":{"requires":{"env":["PRIVATE_KEY"]},"primaryEnv":"PRIVATE_KEY","optionalEnv":["BSC_RPC_URL"]}}
 ---
 
 ## [Agent must follow] User agreement and security notice on first use
@@ -134,7 +125,7 @@ After collecting the above, execute in this order (handled by scripts or CLI):
 4. **Create (API)** — GET `/public/config` for raisedToken (do not modify); `POST /private/token/create` with name, shortName, desc, imgUrl, label, raisedToken, etc.; get createArg, signature.
 5. **Create (chain)** — Call `TokenManager2.createToken(createArg, sign)` on BSC to complete on-chain creation.
 
-Commands: first `fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]`, then `fourmeme create-chain <createArgHex> <signatureHex>`. Full API and parameters: [references/api-create-token.md](references/api-create-token.md); script flow and examples: [references/create-token-scripts.md](references/create-token-scripts.md); Tax token params: [references/token-tax-info.md](references/token-tax-info.md).
+Commands: first `fourmeme create-api --image= --name= --short-name= --desc= --label= [options]`, then `fourmeme create-chain <createArgHex> <signatureHex>`. Or one-shot: `fourmeme create-instant --image= ...`. Full API and parameters: [references/api-create-token.md](references/api-create-token.md); script flow and examples: [references/create-token-scripts.md](references/create-token-scripts.md); Tax token params: [references/token-tax-info.md](references/token-tax-info.md).
 
 ## Agent workflow: buy/sell from rankings or events
 
@@ -219,7 +210,7 @@ When the user asks to create a token, the Agent must ask in this order:
 
 1. **Tax token or not?**  
    Ask: “Do you want to create a tax (Tax) token? If not, it will be a normal token.”  
-   - If **no**: use `fourmeme create-api <imagePath> <name> <shortName> <desc> <label>` (no sixth argument, no TAX_* env vars).  
+   - If **no**: use `fourmeme create-api --image= --name= --short-name= --desc= --label=` (no --tax-options, no --tax-token).  
    - If **yes**: continue to step 2.
 
 2. **Tax parameters** (only when user chose tax token)  
@@ -230,8 +221,8 @@ When the user asks to create a token, the Agent must ask in this order:
    - **minSharing**: Minimum token balance to participate in dividends (in ether units, e.g. 100000, 1000000).
 
    Then either:  
-   - **Option A**: Write `{ "tokenTaxInfo": { ... } }` to a JSON file and call `fourmeme create-api ... <path/to/tax.json>`.  
-   - **Option B**: Set env vars TAX_TOKEN=1, TAX_FEE_RATE, TAX_BURN_RATE, TAX_DIVIDE_RATE, TAX_LIQUIDITY_RATE, TAX_RECIPIENT_RATE, TAX_RECIPIENT_ADDRESS (optional), TAX_MIN_SHARING, then run `fourmeme create-api <imagePath> <name> <shortName> <desc> <label>` (no sixth argument).
+   - **Option A**: Write `{ "tokenTaxInfo": { ... } }` to a JSON file and call `fourmeme create-api --image= ... --tax-options=<path>`.
+   - **Option B**: Run `fourmeme create-api --image= ... --tax-token --tax-fee-rate=5 ...` (and other --tax-* as needed).
 
 **Step 1 – Config (optional)**  
 ```bash
@@ -255,9 +246,9 @@ Requires `PRIVATE_KEY`. Outputs `createArg` and `signature` (hex).
 **Optional env vars** (defaults if omitted): `WEB_URL`, `TWITTER_URL`, `TELEGRAM_URL`; `PRE_SALE` (default `"0"`); `FEE_PLAN` (`"true"` = AntiSniperFeeMode, default `"false"`).
 
 ```bash
-fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]
-# Example: fourmeme create-api ./logo.png MyToken MTK "Description" AI
-# Tax: fourmeme create-api ./logo.png TaxToken TAX "Tax token" Meme tax.json
+fourmeme create-api --image=<path> --name= --short-name= --desc= --label= [--tax-options=path]
+# Example: fourmeme create-api --image=./logo.png --name=MyToken --short-name=MTK --desc="Description" --label=AI
+# Tax: fourmeme create-api --image=./logo.png --name=TaxToken --short-name=TAX --desc="Tax token" --label=Meme --tax-options=tax.json
 ```
 
 **Tax token**  
@@ -303,9 +294,9 @@ fourmeme create-chain <createArgHex> <signatureHex>
 To **create and submit on-chain in one go**, the Agent should:
 
 1. **Run create-api** to get signature data (same as Step 2 above; JSON with `createArg` and `signature`):  
-   ```bash
-   fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]
-   ```  
+   ```bash  
+   fourmeme create-api --image= --name= --short-name= --desc= --label= [--tax-options=path]
+   ```
    Parse stdout JSON for `createArg` and `signature` (already hex strings).
 
 2. **Run create-chain** with those two values:  
@@ -442,7 +433,8 @@ See [references/tax-token-query.md](references/tax-token-query.md).
 
 ## API and config reference
 
-- **Token detail (REST)**: `GET /private/token/get?address=<token>`, `GET /private/token/getById?id=<requestId>` (requestId from TokenCreate event). List/rankings: [references/token-query-api.md](references/token-query-api.md).
+- **Token detail (REST)**: `GET /private/token/get?address=<token>`, `GET /private/token/getById?id=<requestId>` (requestId from TokenCreate event). Response may include `data.aiCreator` (token created by Agent). List/rankings: [references/token-query-api.md](references/token-query-api.md).
+- **Agent Creator / Agent wallets**: On-chain — token template bit 85 for “created by agent”; AgentIdentifier contract (`isAgent(wallet)`) on BSC to identify agent wallets. See [references/agent-creator-and-wallets.md](references/agent-creator-and-wallets.md) and [references/contract-addresses.md](references/contract-addresses.md).
 - **raisedToken**: `GET https://four.meme/meme-api/v1/public/config` for current raisedToken; use as-is in create body; do not modify its fields.
 
 ## References
@@ -454,8 +446,9 @@ See [references/tax-token-query.md](references/tax-token-query.md).
 | [create-token-scripts.md](references/create-token-scripts.md) | Create token script flow and examples |
 | [token-tax-info.md](references/token-tax-info.md) | Tax token tokenTaxInfo parameters and constraints |
 | [token-query-api.md](references/token-query-api.md) | Token list / detail / rankings REST API |
-| [errors.md](references/errors.md) | buy/sell error codes; X Mode / TaxToken / AntiSniperFeeMode |
+| [errors.md](references/errors.md) | buy/sell error codes; X Mode / TaxToken / AntiSniperFeeMode; Agent Creator |
+| [agent-creator-and-wallets.md](references/agent-creator-and-wallets.md) | Token created by Agent Creator; AgentIdentifier contract and Agent wallets |
 | [execute-trade.md](references/execute-trade.md) | Execute buy/sell CLI and contract usage |
 | [event-listening.md](references/event-listening.md) | TokenManager2 event listening (V2) |
 | [tax-token-query.md](references/tax-token-query.md) | TaxToken on-chain fee/tax query (tax-info) |
-| **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. |
+| **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, AgentIdentifier, etc. |

package/skills/four-meme-integration/references/agent-creator-and-wallets.md

@@ -0,0 +1,87 @@
+# Agent Creator & Agent Wallets
+
+This document covers how to identify tokens created by an AI agent (Agent Creator) and how to identify agent wallets on-chain.
+
+---
+
+## How to Identify Token Created By Agent Creator
+
+Tokens created by AI agents can be identified via both on-chain template bits and off-chain API fields. This flag only marks that the token creator is an **Agent wallet** and **does not imply any new special trading mode or behavior** of the token itself.
+
+### On-chain method
+
+Read the token's `template` from TokenManager2:
+
+```solidity
+template = TokenManager2._tokenInfos[tokenAddress].template;
+bool isCreatedByAgent = (template & (1 << 85)) != 0;
+```
+
+- If `isCreatedByAgent` is `true`, the token was **created by an AI agent**.
+- If `isCreatedByAgent` is `false`, the token was **not** created by an AI agent.
+
+### Off-chain method
+
+Query token info via:
+
+- `GET https://four.meme/meme-api/v1/private/token/get?address=<token address>`
+- `GET https://four.meme/meme-api/v1/private/token/getById?id=<requestId>` (requestId from TokenCreate event)
+
+Check the `aiCreator` field in the response `data`:
+
+- If `aiCreator === true`, the token was **created by an AI agent**.
+- If `aiCreator === false`, the token was **not** created by an AI agent.
+
+**Example response:**
+
+```json
+{
+  "code": "0",
+  "data": {
+    "aiCreator": true,
+    ...
+  }
+}
+```
+
+---
+
+## How to Identify Agent Wallets
+
+You can determine whether a wallet address is an **Agent wallet** by calling the **AgentIdentifier** contract.
+
+### On-chain method
+
+**Contract (BSC)**
+
+- **Address**: `0x09B44A633de9F9EBF6FB9Bdd5b5629d3DD2cef13`
+- **ABI**: See official Four.meme API / Protocol Integration docs (`AgentIdentifier.abi`).
+
+**Interface**
+
+```solidity
+interface IAgentIdentifier {
+    function isAgent(address wallet) external view returns (bool);
+    function nftCount() external view returns (uint256);
+    function nftAt(uint256 index) external view returns (address);
+}
+```
+
+**Usage**
+
+Call `isAgent(wallet)` on the AgentIdentifier contract:
+
+```solidity
+IAgentIdentifier ai = IAgentIdentifier(0x09B44A633de9F9EBF6FB9Bdd5b5629d3DD2cef13);
+bool isAgent = ai.isAgent(wallet);
+```
+
+- Returns `true` if the wallet is an Agent wallet, otherwise `false`.
+- Logic: `isAgent(wallet)` is `true` when the wallet holds any Agent NFT (`balanceOf(wallet) > 0`).
+
+**Querying configured Agent NFTs**
+
+- `nftCount()` — number of Agent NFT contracts registered.
+- `nftAt(index)` — Agent NFT contract address at `index`.
+
+Tokens created by wallets with `isAgent == true` are marked as **Agent Creator** and can be identified as **Token Created By Agent Creator** using the methods above.

package/skills/four-meme-integration/references/api-create-token.md

@@ -1,55 +1,55 @@
-# Four.meme API – Create Token
-
-Base URL: `https://four.meme/meme-api/v1`
-
-## Endpoints (in order)
-
-| Step | Method | Path | Description |
-|------|--------|------|-------------|
-| 1 | POST | `/private/user/nonce/generate` | Get nonce |
-| 2 | POST | `/private/user/login/dex` | Login → access_token |
-| 3 | POST | `/private/token/upload` | Upload image → imgUrl |
-| 4 | POST | `/private/token/create` | Create → createArg, signature |
-
-## 1. Nonce
-
-- **URL**: `https://four.meme/meme-api/v1/private/user/nonce/generate`
-- **Body**: `{ "accountAddress": "<wallet>", "verifyType": "LOGIN", "networkCode": "BSC" }`
-- **Response**: `{ "code": "0", "data": "<nonce>" }`
-
-## 2. Login
-
-- **URL**: `https://four.meme/meme-api/v1/private/user/login/dex`
-- **Body**: Include `verifyInfo.signature` = sign(`You are sign in Meme {nonce}`) with wallet, `verifyInfo.address`, `verifyInfo.networkCode` ("BSC"), `verifyInfo.verifyType` ("LOGIN"), plus region, langType, walletName, etc.
-- **Response**: `{ "code": "0", "data": "<access_token>" }`
-
-## 3. Upload image
-
-- **URL**: `https://four.meme/meme-api/v1/private/token/upload`
-- **Headers**: `meme-web-access: <access_token>`, `Content-Type: multipart/form-data`
-- **Body**: `file` = image (jpeg/png/gif/bmp/webp)
-- **Response**: `{ "code": "0", "data": "<imgUrl>" }`
-
-## 4. Create token
-
-- **URL**: `https://four.meme/meme-api/v1/private/token/create`
-- **Headers**: `meme-web-access: <access_token>`, `Content-Type: application/json`
-- **Body**: **Required**: **raisedAmount** (raise amount; use 24 or raisedToken.totalBAmount from public config), **raisedToken** (from `GET /public/config`; do not modify). Customizable: name, shortName, desc, imgUrl, launchTime, label, lpTradingFee (0.0025), webUrl, twitterUrl, telegramUrl, preSale, onlyMPC, feePlan, tokenTaxInfo (optional).
-- **Response**: `{ "code": "0", "data": { "createArg": "...", "signature": "..." } }`
-
-Then call **TokenManager2.createToken(createArg, sign)** on BSC with these values (as bytes).
-
-## Labels
-
-Meme, AI, Defi, Games, Infra, De-Sci, Social, Depin, Charity, Others.
-
-## tokenTaxInfo (optional; Tax-type token)
-
-Omit to create a normal token; include to create a tax-type token.
-
-- **feeRate**: Trading fee; must be **1, 3, 5, or 10** (1%/3%/5%/10%).
-- **burnRate**, **divideRate**, **liquidityRate**, **recipientRate**: All percentages; **sum of the four must be 100**.
-- **recipientAddress**: Address that receives the recipient share; use `""` when not used, and **recipientRate = 0**.
-- **minSharing**: Min balance to participate in dividends (ether units); must satisfy **minSharing = d×10ⁿ**, n≥5, 1≤d≤9, e.g. 100000, 1000000.
-
-Full field description and examples: [token-tax-info.md](token-tax-info.md).
+# Four.meme API – Create Token
+
+Base URL: `https://four.meme/meme-api/v1`
+
+## Endpoints (in order)
+
+| Step | Method | Path | Description |
+|------|--------|------|-------------|
+| 1 | POST | `/private/user/nonce/generate` | Get nonce |
+| 2 | POST | `/private/user/login/dex` | Login → access_token |
+| 3 | POST | `/private/token/upload` | Upload image → imgUrl |
+| 4 | POST | `/private/token/create` | Create → createArg, signature |
+
+## 1. Nonce
+
+- **URL**: `https://four.meme/meme-api/v1/private/user/nonce/generate`
+- **Body**: `{ "accountAddress": "<wallet>", "verifyType": "LOGIN", "networkCode": "BSC" }`
+- **Response**: `{ "code": "0", "data": "<nonce>" }`
+
+## 2. Login
+
+- **URL**: `https://four.meme/meme-api/v1/private/user/login/dex`
+- **Body**: Include `verifyInfo.signature` = sign(`You are sign in Meme {nonce}`) with wallet, `verifyInfo.address`, `verifyInfo.networkCode` ("BSC"), `verifyInfo.verifyType` ("LOGIN"), plus region, langType, walletName, etc.
+- **Response**: `{ "code": "0", "data": "<access_token>" }`
+
+## 3. Upload image
+
+- **URL**: `https://four.meme/meme-api/v1/private/token/upload`
+- **Headers**: `meme-web-access: <access_token>`, `Content-Type: multipart/form-data`
+- **Body**: `file` = image (jpeg/png/gif/bmp/webp)
+- **Response**: `{ "code": "0", "data": "<imgUrl>" }`
+
+## 4. Create token
+
+- **URL**: `https://four.meme/meme-api/v1/private/token/create`
+- **Headers**: `meme-web-access: <access_token>`, `Content-Type: application/json`
+- **Body**: **Required**: **raisedAmount** (raise amount; use 24 or raisedToken.totalBAmount from public config), **raisedToken** (from `GET /public/config`; do not modify). Customizable: name, shortName, desc, imgUrl, launchTime, label, lpTradingFee (0.0025), webUrl, twitterUrl, telegramUrl, preSale, onlyMPC, feePlan, tokenTaxInfo (optional).
+- **Response**: `{ "code": "0", "data": { "createArg": "...", "signature": "..." } }`
+
+Then call **TokenManager2.createToken(createArg, sign)** on BSC with these values (as bytes).
+
+## Labels
+
+Meme, AI, Defi, Games, Infra, De-Sci, Social, Depin, Charity, Others.
+
+## tokenTaxInfo (optional; Tax-type token)
+
+Omit to create a normal token; include to create a tax-type token.
+
+- **feeRate**: Trading fee; must be **1, 3, 5, or 10** (1%/3%/5%/10%).
+- **burnRate**, **divideRate**, **liquidityRate**, **recipientRate**: All percentages; **sum of the four must be 100**.
+- **recipientAddress**: Address that receives the recipient share; use `""` when not used, and **recipientRate = 0**.
+- **minSharing**: Min balance to participate in dividends (ether units); must satisfy **minSharing = d×10ⁿ**, n≥5, 1≤d≤9, e.g. 100000, 1000000.
+
+Full field description and examples: [token-tax-info.md](token-tax-info.md).