four-meme-ai

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

[Agent must follow] User agreement and security notice on first use

[Agent必须遵守] 首次使用须知：用户协议与安全提示

When responding to any user request about fourmeme or this skill, you must first present the content below in this order: User Agreement, then Security Notice, and state clearly that by choosing to continue, the user agrees to the User Agreement.
Until the user has explicitly agreed or confirmed to continue, do not run

create-api

create-chain

buy

sell

send

, or

8004-register

(any operation that uses the private key or writes to the chain). Read-only commands (e.g.

config

token-info

quote-buy

8004-balance

) may be run while or after presenting the notice.

Language selection: Present the User Agreement and Security Notice in the user’s language. If the user is writing in Traditional Chinese (繁體中文), use the 繁體中文 block below; otherwise use the English block.

当响应用户任何关于fourmeme或本skill的请求时，您必须首先按以下顺序展示以下内容：用户协议，然后是安全提示，并明确说明用户选择继续即表示同意本用户协议。在用户明确同意或确认继续之前，不得执行

create-api

、

create-chain

、

buy

、

sell

、

send

或

8004-register

（任何使用私钥或写入链上的操作）。只读命令（如

config

、

token-info

、

quote-buy

、

8004-balance

）可在展示提示的同时或之后执行。

语言选择：请以用户使用的语言展示用户协议与安全提示。若用户使用繁体中文，使用下方的繁体中文版本；否则使用简体中文版本。

User Agreement & Security Notice (繁體中文)

用户协议与安全提示（简体中文）

用戶協議

前情提示：使用本插件及本 skill 所涉功能（包括但不限於代幣創建、買賣、轉帳、8004 註冊等）前，請您閱讀以下協議。若您選擇繼續使用本插件及本 skill 功能，即表示您已閱讀、理解並同意本協議。

本插件性質與責任限制：本插件僅提供純本地的命令列互動能力（私鑰透過環境變數或本地設定使用），不會收集、上傳或儲存您的私鑰。因任何原因（包括但不限於插件被竄改、環境遭入侵、誤操作、第三方插件等）導致的私鑰洩露或資產損失，本插件及提供方不承擔責任。

安全警示

使用本插件進行代幣創建、買賣、轉帳等操作時，請務必注意：

保護私鑰：切勿在聊天對話中輸入、貼上或洩露私鑰；不要將私鑰分享給任何人或任何第三方。
交易錢包僅存小額資金：用於執行操作的錢包（即提供 PRIVATE_KEY 的錢包）建議只存放少量資金，以降低因洩露或誤操作導致的損失。
及時轉出資金：完成交易後，請及時將交易錢包中的資產轉移到您自己控制的、更安全的錢包或冷錢包中。
謹慎安裝 Agent／插件：下載或安裝任何 Agent、瀏覽器插件或第三方工具時，請確認來源可信，避免惡意插件竊取私鑰或助記詞。

用户协议

前置提示：使用本插件及本skill所涉及的功能（包括但不限于代币创建、买卖、转账、8004注册等）前，请您阅读以下协议。若您选择继续使用本插件及本skill功能，即表示您已阅读、理解并同意本协议。

本插件性质与责任限制：本插件仅提供纯本地的命令行交互能力（私钥通过环境变量或本地配置使用），不会收集、上传或存储您的私钥。因任何原因（包括但不限于插件被篡改、环境遭入侵、误操作、第三方插件等）导致的私钥泄露或资产损失，本插件及提供方不承担责任。

安全警示

使用本插件进行代币创建、买卖、转账等操作时，请务必注意：

保护私钥：切勿在聊天对话中输入、粘贴或泄露私钥；不要将私钥分享给任何人或任何第三方。
交易钱包仅存小额资金：用于执行操作的钱包（即提供PRIVATE_KEY的钱包）建议只存放少量资金，以降低因泄露或误操作导致的损失。
及时转出资金：完成交易后，请及时将交易钱包中的资产转移到您自己控制的、更安全的钱包或冷钱包中。
谨慎安装Agent／插件：下载或安装任何Agent、浏览器插件或第三方工具时，请确认来源可信，避免恶意插件窃取私钥或助记词。

User Agreement & Security Notice (English)

用户协议与安全提示（简体中文）

User Agreement

Notice: Before using this plugin and this skill (including but not limited to token creation, buy/sell, transfers, 8004 registration), please read the following. By choosing to continue using this plugin and this skill, you have read, understood, and agreed to this agreement.

Plugin nature and limitation of liability: This plugin provides local-only CLI interaction (private key is used via environment or local config). It does not collect, upload, or store your private key. The plugin and its providers are not liable for private key disclosure or asset loss due to any cause (including but not limited to tampered plugin, compromised environment, user error, or third-party plugins).

Security Notice

When using this plugin for token creation, trading, or transfers, please:

Protect your private key: Do not type, paste, or expose your private key in chat; do not share it with anyone or any third party.
Keep only small amounts in the trading wallet: The wallet used for operations (the one whose PRIVATE_KEY you provide) should hold only a small amount of funds to limit loss from disclosure or mistakes.
Move funds out promptly: After trading, move assets from the trading wallet to a wallet or cold storage you control.
Install agents/plugins carefully: When installing any agent, browser extension, or third-party tool, verify the source to avoid malware that could steal your private key or seed phrase.

用户协议

前置提示：使用本插件及本skill（包括但不限于代币创建、买卖、转账、8004注册）前，请阅读以下内容。选择继续使用本插件及本skill，即表示您已阅读、理解并同意本协议。

本插件性质与责任限制：本插件仅提供纯本地的CLI交互能力（私钥通过环境变量或本地配置使用），不会收集、上传或存储您的私钥。因任何原因（包括但不限于插件被篡改、环境遭入侵、用户误操作或第三方插件）导致的私钥泄露或资产损失，本插件及其提供方不承担责任。

安全警示

使用本插件进行代币创建、交易或转账时，请务必注意：

保护私钥：切勿在聊天中输入、粘贴或泄露私钥；不要与任何人或第三方分享私钥。
交易钱包仅存小额资金：用于执行操作的钱包（即您提供PRIVATE_KEY的钱包）应仅存放少量资金，以限制因泄露或误操作造成的损失。
及时转出资金：交易完成后，请将交易钱包中的资产转移到您自己控制的钱包或冷存储中。
谨慎安装Agent/插件：安装任何Agent、浏览器扩展或第三方工具时，请验证来源的可信度，避免恶意软件窃取您的私钥或助记词。

fourmeme capability overview

fourmeme功能概述

After you agree to the above and confirm to continue, this skill can help you with the following (all via the

fourmeme

CLI on BSC):

Category	Capability	Description
Create	Create token	Upload image + name/symbol/description/label; optional tax-token params; API returns signature then on-chain create.
Query	Public config	Get raisedToken and other public config (no auth).
Query	Token info (on-chain)	By address: version, tokenManager, price, offers (Helper3).
Query	Token list / detail / rankings	REST: filtered paginated list, single-token detail and trading info, hot/24h volume/newest/graduated rankings.
Trading	Buy/sell quotes	Estimate cost or proceeds for buy or sell (no transaction sent).
Trading	Execute buy	Buy a given token by amount or by quote spent (requires PRIVATE_KEY).
Trading	Execute sell	Sell a given token amount; optional minimum quote received (requires PRIVATE_KEY).
Other	Event listening	Fetch TokenCreate, TokenPurchase, TokenSale, LiquidityAdded on-chain.
Other	Tax token fees	Query on-chain fee and burn/dividend/liquidity config for a token.
Other	Send	Send BNB or ERC20 to a given address (requires PRIVATE_KEY).
Other	EIP-8004	Register 8004 identity NFT; query balance by address.

See the CLI (fourmeme) table and sections below for commands and arguments.

在您同意上述内容并确认继续后，本skill可帮您完成以下操作（全部通过BSC链上的

fourmeme

CLI实现）：

分类	功能	描述
创建	创建代币	上传图片 + 名称/符号/描述/标签；可选税费代币参数；API返回签名后完成链上创建。
查询	公开配置	获取raisedToken及其他公开配置（无需授权）。
查询	代币信息（链上）	通过地址查询：版本、tokenManager、价格、报价（Helper3）。
查询	代币列表/详情/排名	REST接口：过滤分页列表、单一代币详情与交易信息、热门/24小时交易量/最新/已毕业排名。
交易	买卖报价	估算买入或卖出的成本或收益（不会发送交易）。
交易	执行买入	按数量或花费的报价买入指定代币（需要PRIVATE_KEY）。
交易	执行卖出	卖出指定数量的代币；可选最低接收报价（需要PRIVATE_KEY）。
其他	事件监听	获取链上的TokenCreate、TokenPurchase、TokenSale、LiquidityAdded事件。
其他	税费代币手续费	查询代币的链上手续费及销毁/分红/流动性配置。
其他	转账	向指定地址发送BNB或ERC20代币（需要PRIVATE_KEY）。
其他	EIP-8004	注册8004身份NFT；通过地址查询余额。

请查看下方的**CLI（fourmeme）**表格及章节了解命令和参数。

fourmeme CLI

BSC only; all commands output JSON. Run

fourmeme --help

for usage.

仅支持BSC链；所有命令输出JSON格式数据。运行

fourmeme --help

查看使用方法。

Installation (required before use)

安装（使用前必须完成）

You must install the fourmeme CLI before using this skill. Recommended (global):

bash

npm install -g @four-meme/four-meme-ai@latest

After installation, run commands with

fourmeme <command> [args]

. If you use a local install instead, use

npx fourmeme <command> [args]

from the project root.

This skill provides: token creation (API + chain), buy/sell quotes and execution, token info/list/rankings, event listening, Tax token fee queries, send, and EIP-8004 identity NFT register and balance. Contract addresses and version notes: references/contract-addresses.md. TokenManager V1 is not supported in this skill.

使用本skill前必须安装fourmeme CLI。推荐全局安装：

bash

npm install -g @four-meme/four-meme-ai@latest

安装完成后，使用

fourmeme <command> [args]

运行命令。如果是本地安装，请在项目根目录使用

npx fourmeme <command> [args]

。

本skill提供以下功能：代币创建（API+链上）、买卖报价与执行、代币信息/列表/排名、事件监听、税费代币手续费查询、转账、EIP-8004身份NFT注册与余额查询。合约地址及版本说明：references/contract-addresses.md。本skill不支持TokenManager V1。

Create token flow

创建代币流程

1. Ask user for required information (must be done first)

1. 向用户索要必填信息（必须首先完成）

Before calling

create-api

, the Agent must ask the user for and confirm:

Info	Required	Description
Image path (imagePath)	Yes	Local logo path; jpeg/png/gif/bmp/webp
Token name (name)	Yes	Full token name
Token symbol (shortName)	Yes	e.g. MTK, DOGE
Description (desc)	Yes	Token description text
Label (label)	Yes	One of: Meme \| AI \| Defi \| Games \| Infra \| De-Sci \| Social \| Depin \| Charity \| Others
Tax token?	No	If yes, then ask for tokenTaxInfo (feeRate, four rates, recipientAddress, minSharing); see "Create token (full flow)" below

Optional: WEB_URL, TWITTER_URL, TELEGRAM_URL, PRE_SALE, FEE_PLAN (AntiSniperFeeMode), etc.; may be provided by user or left at defaults.

调用

create-api

前，Agent必须向用户索要并确认以下信息：

信息	是否必填	描述
图片路径（imagePath）	是	本地logo路径；支持jpeg/png/gif/bmp/webp格式
代币名称（name）	是	代币全称
代币符号（shortName）	是	例如：MTK、DOGE
描述（desc）	是	代币描述文本
标签（label）	是	以下选项之一：Meme \
是否为税费代币？	否	如果是，需索要tokenTaxInfo（feeRate、四个分配比例、recipientAddress、minSharing）；请查看下方的“创建代币（完整流程）”

可选信息：WEB_URL、TWITTER_URL、TELEGRAM_URL、PRE_SALE、FEE_PLAN（AntiSniperFeeMode）等；可由用户提供或使用默认值。

2. Technical flow (done by create-api / create-chain)

2. 技术流程（由create-api / create-chain完成）

After collecting the above, execute in this order (handled by scripts or CLI):

Get nonce —
```
POST /private/user/nonce/generate
```
with body accountAddress, verifyType, networkCode (BSC).

Login — Sign

You are sign in Meme {nonce}

with wallet;

POST /private/user/login/dex

to get access_token.

Upload image —
```
POST /private/token/upload
```
with access_token in header and image as body; get imgUrl.
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.
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; script flow and examples: references/create-token-scripts.md; Tax token params: references/token-tax-info.md.

收集上述信息后，按以下顺序执行（由脚本或CLI处理）：

获取随机数 — 向
```
POST /private/user/nonce/generate
```
发送请求，请求体包含accountAddress、verifyType、networkCode（BSC）。
登录 — 使用钱包签署
```
You are sign in Meme {nonce}
```
；向
```
POST /private/user/login/dex
```
发送请求获取access_token。
上传图片 — 向
```
POST /private/token/upload
```
发送请求，请求头包含access_token，请求体为图片；获取imgUrl。
创建（API） — 调用
```
GET /public/config
```
获取raisedToken（请勿修改）；向
```
POST /private/token/create
```
发送请求，包含name、shortName、desc、imgUrl、label、raisedToken等参数；获取createArg和signature。
创建（链上） — 在BSC链上调用
```
TokenManager2.createToken(createArg, sign)
```
完成链上创建。

命令：先执行

fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]

，再执行

fourmeme create-chain <createArgHex> <signatureHex>

。完整API及参数：references/api-create-token.md；脚本流程及示例：references/create-token-scripts.md；税费代币参数：references/token-tax-info.md。

Agent workflow: buy/sell from rankings or events

Agent工作流：从排名或事件中进行买卖

This skill supports a flow to discover tokens, get details, quote, and execute. The following is an example workflow, not a trading recommendation: discover → detail → quote → execute.

Discover (one or more of):
- Rankings:
```
fourmeme token-rankings <orderBy>
```
  (orderBy = Hot, TradingDesc, Time, ProgressDesc, Graduated); use token addresses from the response.
- List:
```
fourmeme token-list [--orderBy=] [--labels=] ...
```
  to filter and get addresses.
- On-chain events:
```
fourmeme events <fromBlock> [toBlock]
```
  ; parse token addresses from TokenCreate/TokenPurchase, etc., for “newly created” or “recent trades” strategies.
Get details: For each candidate, call
```
fourmeme token-get <address>
```
(REST detail and trading info) or
```
fourmeme token-info <address>
```
(on-chain version, tokenManager, price, offers) to filter or display.

Quote:

fourmeme quote-buy <token> <amountWei> [fundsWei]

fourmeme quote-sell <token> <amountWei>

for estimated cost or proceeds.

Execute:
```
fourmeme buy ...
```
/
```
fourmeme sell ...
```
(requires PRIVATE_KEY). Before executing, the Agent must confirm user intent (e.g. user said “buy 0.05 BNB each for top 5 by 24h volume” or “auto-buy 0.01 BNB for new tokens”) and obtain explicit confirmation before first automated execution to avoid unauthorized use of funds.

When the user asks to “buy/sell based on rankings or activity”, the Agent should clarify: which ranking (hot, 24h volume, newest, graduated, etc.), amount per token, and whether to quote only or also execute; then run the appropriate commands.

本skill支持发现代币、获取详情、报价、执行交易的流程。以下是示例工作流，非交易建议：发现 → 详情 → 报价 → 执行。

发现（以下一种或多种方式）：
- 排名：
```
fourmeme token-rankings <orderBy>
```
  （orderBy可选值：Hot、TradingDesc、Time、ProgressDesc、Graduated）；从响应中获取代币地址。
- 列表：
```
fourmeme token-list [--orderBy=] [--labels=] ...
```
  过滤并获取代币地址。
- 链上事件：
```
fourmeme events <fromBlock> [toBlock]
```
  ；从TokenCreate/TokenPurchase等事件中解析代币地址，用于“新创建”或“近期交易”策略。
获取详情：对每个候选代币，调用
```
fourmeme token-get <address>
```
（REST接口详情与交易信息）或
```
fourmeme token-info <address>
```
（链上版本、tokenManager、价格、报价）进行筛选或展示。

报价：

fourmeme quote-buy <token> <amountWei> [fundsWei]

fourmeme quote-sell <token> <amountWei>

估算成本或收益。

执行：
```
fourmeme buy ...
```
/
```
fourmeme sell ...
```
（需要PRIVATE_KEY）。执行前，Agent必须确认用户意图（例如用户说明“按24小时交易量排名前5的代币各买0.05 BNB”或“自动为新创建的代币买入0.01 BNB”），并在首次自动执行前获得明确确认，避免未经授权使用资金。

当用户要求“根据排名或活跃度进行买卖”时，Agent应明确：使用哪种排名（热门、24小时交易量、最新、已毕业等）、每个代币的交易金额、仅获取报价还是同时执行交易；然后运行相应命令。

Trading (Buy / Sell)

交易（买入/卖出）

Version – Use TokenManagerHelper3
```
getTokenInfo(token)
```
. If
```
version === 1
```
use V1 TokenManager; if
```
version === 2
```
use TokenManager2 (and check for X Mode / TaxToken / AntiSniperFeeMode if needed).
Quote (pre-calc) – TokenManagerHelper3:
- Buy:
```
tryBuy(token, amount, funds)
```
  – use
```
amount > 0
```
  for “buy X tokens”, or
```
funds > 0
```
  for “spend X quote”.
- Sell:
```
trySell(token, amount)
```
  .

Execute – Use the

tokenManager

address from

getTokenInfo

and call the corresponding contract:

V1:
```
purchaseToken
```
/
```
purchaseTokenAMAP
```
,
```
saleToken
```
.

V2:

buyToken

buyTokenAMAP

sellToken

. For sell, user must

ERC20.approve(tokenManager, amount)

first.

X Mode tokens: use TokenManager2

buyToken(bytes args, uint256 time, bytes signature)

with encoded

BuyTokenParams

版本 — 使用TokenManagerHelper3的
```
getTokenInfo(token)
```
。若
```
version === 1
```
则使用V1 TokenManager；若
```
version === 2
```
则使用TokenManager2（必要时检查X Mode / TaxToken / AntiSniperFeeMode）。
报价（预计算） — TokenManagerHelper3：
- 买入：
```
tryBuy(token, amount, funds)
```
  —
```
amount > 0
```
  表示“买入X个代币”，
```
funds > 0
```
  表示“花费X报价”。
- 卖出：
```
trySell(token, amount)
```
  。

执行 — 使用

getTokenInfo

返回的

tokenManager

地址调用对应合约：

V1：
```
purchaseToken
```
/
```
purchaseTokenAMAP
```
、
```
saleToken
```
。

V2：

buyToken

buyTokenAMAP

、

sellToken

。卖出前用户必须先执行

ERC20.approve(tokenManager, amount)

。

X Mode代币：使用TokenManager2的

buyToken(bytes args, uint256 time, bytes signature)

，传入编码后的

BuyTokenParams

。

CLI (fourmeme)

CLI（fourmeme）

Run

fourmeme --help

for usage. After global install (

npm install -g @four-meme/four-meme-ai@latest

), use fourmeme <command> [args]
. With a local install only, use npx fourmeme <command> [args]
from the project root.

运行

fourmeme --help

查看使用方法。全局安装（

npm install -g @four-meme/four-meme-ai@latest

）后，使用

fourmeme <command> [args]

。仅本地安装时，在项目根目录使用

npx fourmeme <command> [args]

。

PRIVATE_KEY and BSC_RPC_URL

PRIVATE_KEY与BSC_RPC_URL

When using OpenClaw
This skill declares

requires.env: ["PRIVATE_KEY"]

and

primaryEnv: "PRIVATE_KEY"

in metadata; OpenClaw injects them only when an agent runs with this skill enabled (other skills cannot access them).

Required steps:

Configure private key: In the Skill management page, set the four-meme-ai skill’s apiKey (corresponds to
```
primaryEnv: "PRIVATE_KEY"
```
), or set
```
PRIVATE_KEY
```
under
```
skills.entries["four-meme-ai"].env
```
in
```
~/.openclaw/openclaw.json
```
. Optionally set BSC_RPC_URL in global env if needed.
Enable this skill: In the agent or session, ensure the four-meme-ai skill is enabled. Only when the skill is enabled will OpenClaw inject PRIVATE_KEY into the process; otherwise create/buy/sell/send/8004-register will fail with missing key. BSC_RPC_URL is optional (metadata:
```
optionalEnv
```
); if not set, scripts use a default BSC RPC.

When not using OpenClaw (standalone)
Set PRIVATE_KEY and optionally BSC_RPC_URL via the process environment so they are available when running

npx fourmeme

node bin/fourmeme.cjs

.env file: Put a
```
.env
```
file in the directory where you run the
fourmeme
command (i.e. your project / working directory). Example: if you run
```
fourmeme quote-buy ...
```
from
```
/path/to/my-project
```
, place
```
.env
```
at
```
/path/to/my-project/.env
```
. The CLI automatically loads
```
.env
```
from that current working directory. Use lines like
```
PRIVATE_KEY=...
```
and
```
BSC_RPC_URL=...
```
. Do not commit
```
.env
```
; add it to
```
.gitignore
```
.

Shell export:

export PRIVATE_KEY=your_hex_key

and

export BSC_RPC_URL=https://bsc-dataseed.binance.org

(or another BSC RPC), then run

npx fourmeme <command> ...

使用OpenClaw时
本skill在元数据中声明了

requires.env: ["PRIVATE_KEY"]

和

primaryEnv: "PRIVATE_KEY"

；仅当Agent启用本skill时，OpenClaw才会注入这些环境变量（其他skill无法访问）。

必要步骤：

配置私钥：在Skill管理页面，设置four-meme-ai skill的apiKey（对应
```
primaryEnv: "PRIVATE_KEY"
```
），或在
```
~/.openclaw/openclaw.json
```
的
```
skills.entries["four-meme-ai"].env
```
下设置
```
PRIVATE_KEY
```
。必要时可在全局环境中设置BSC_RPC_URL。
启用本skill：在Agent或会话中，确保four-meme-ai skill已启用。仅当skill启用时，OpenClaw才会将PRIVATE_KEY注入进程；否则create/buy/sell/send/8004-register操作会因缺少密钥而失败。BSC_RPC_URL为可选（元数据中标记为
```
optionalEnv
```
）；若未设置，脚本将使用默认的BSC RPC。

不使用OpenClaw时（独立模式）
通过进程环境设置PRIVATE_KEY，必要时设置BSC_RPC_URL，确保运行

npx fourmeme

或

node bin/fourmeme.cjs

时可访问这些变量：

.env文件：在运行
fourmeme
命令的目录（即您的项目/工作目录）中放置
```
.env
```
文件。例如：如果您从
```
/path/to/my-project
```
运行
```
fourmeme quote-buy ...
```
，则将
```
.env
```
放在
```
/path/to/my-project/.env
```
。CLI会自动从当前工作目录加载
```
.env
```
文件。文件内容示例：
```
PRIVATE_KEY=...
```
和
```
BSC_RPC_URL=...
```
。请勿提交
```
.env
```
文件；将其添加到
```
.gitignore
```
中。

Shell导出：执行

export PRIVATE_KEY=your_hex_key

和

export BSC_RPC_URL=https://bsc-dataseed.binance.org

（或其他BSC RPC），然后运行

npx fourmeme <command> ...

。

Declared and optional environment variables

已声明和可选的环境变量

Declared in registry metadata (injected by OpenClaw when skill is enabled): PRIVATE_KEY (required for write operations). Optional in metadata: BSC_RPC_URL (scripts fall back to default BSC RPC if unset).
Not in metadata; optional, may be set in env or project
.env
: BSC_RPC_URL, CREATION_FEE_WEI (extra BNB on create), TAX_TOKEN, TAX_FEE_RATE, TAX_BURN_RATE, TAX_DIVIDE_RATE, TAX_LIQUIDITY_RATE, TAX_RECIPIENT_RATE, TAX_RECIPIENT_ADDRESS, TAX_MIN_SHARING, WEB_URL, TWITTER_URL, TELEGRAM_URL, PRE_SALE, FEE_PLAN, 8004_NFT_ADDRESS / EIP8004_NFT_ADDRESS. Only PRIVATE_KEY is required for signing; others have defaults or are used only for specific commands (see Create token flow, EIP-8004, etc.).

在注册表元数据中声明（当skill启用时由OpenClaw注入）：PRIVATE_KEY（写入操作必填）。元数据中的可选变量：BSC_RPC_URL（若未设置，脚本将回退到默认的BSC RPC）。
未在元数据中声明；可选，可在环境或项目
.env
中设置：BSC_RPC_URL、CREATION_FEE_WEI（创建时额外的BNB）、TAX_TOKEN、TAX_FEE_RATE、TAX_BURN_RATE、TAX_DIVIDE_RATE、TAX_LIQUIDITY_RATE、TAX_RECIPIENT_RATE、TAX_RECIPIENT_ADDRESS、TAX_MIN_SHARING、WEB_URL、TWITTER_URL、TELEGRAM_URL、PRE_SALE、FEE_PLAN、8004_NFT_ADDRESS / EIP8004_NFT_ADDRESS。仅PRIVATE_KEY为签名必填项；其他变量有默认值或仅用于特定命令（请查看创建代币流程、EIP-8004等）。

Execution and install

执行与安装

Invocation: The agent must run commands only via the fourmeme CLI:
```
fourmeme <command> [args]
```
or
```
npx fourmeme <command> [args]
```
(allowed-tools). Do not invoke scripts or
```
npx tsx
```
directly; the CLI entry (
```
bin/fourmeme.cjs
```
) dispatches to the correct script and loads
```
.env
```
from the current working directory.
Install:
```
npm install -g @four-meme/four-meme-ai@latest
```
. Runtime: Node.js. Dependencies (including dotenv, viem, tsx) are declared in the package’s
```
package.json
```
; global install installs them. No separate install spec beyond the npm package.

Need	Command	When
Public config	`fourmeme config`	Get raisedToken / config (no auth)
Token info (on-chain)	`fourmeme token-info <tokenAddress>`	Version, tokenManager, price, offers (BSC Helper3)
Token list (REST)	`fourmeme token-list [--orderBy=] [--pageIndex=] [--pageSize=] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=]`	Filtered, paginated token list
Token detail (REST)	`fourmeme token-get <tokenAddress>`	Token detail and trading info (get/v2)
Token rankings (REST)	`fourmeme token-rankings <orderBy> [--barType=HOUR24]`	Time / ProgressDesc / TradingDesc / Hot / Graduated; barType for TradingDesc
Buy quote	`fourmeme quote-buy <token> <amountWei> [fundsWei]`	Estimate only; no transaction
Sell quote	`fourmeme quote-sell <token> <amountWei>`	Estimate only; no transaction
Execute buy	`fourmeme buy <token> amount <amountWei> <maxFundsWei>`	Buy fixed amount (needs PRIVATE_KEY)
Execute buy	`fourmeme buy <token> funds <fundsWei> <minAmountWei>`	Spend fixed quote (e.g. BNB) (needs PRIVATE_KEY)
Execute sell	`fourmeme sell <token> <amountWei> [minFundsWei]`	Sell (needs PRIVATE_KEY)
Send	`fourmeme send <toAddress> <amountWei> [tokenAddress]`	Send BNB or ERC20 to address (needs PRIVATE_KEY)
EIP-8004 register	`fourmeme 8004-register <name> [imageUrl] [description]`	Register 8004 identity NFT (needs PRIVATE_KEY)
EIP-8004 query	`fourmeme 8004-balance <ownerAddress>`	Query 8004 NFT balance (read-only)
Events	`fourmeme events <fromBlock> [toBlock]`	TokenCreate / Purchase / Sale / LiquidityAdded
Tax token info	`fourmeme tax-info <tokenAddress>`	Fee/tax config for TaxToken
Read-only check	`fourmeme verify`	Run config + events (last 50 blocks)

Chain: BSC only (Arbitrum/Base not supported).

调用方式：Agent必须仅通过fourmeme CLI运行命令：
```
fourmeme <command> [args]
```
或
```
npx fourmeme <command> [args]
```
（允许的工具）。请勿直接调用脚本或
```
npx tsx
```
；CLI入口（
```
bin/fourmeme.cjs
```
）会将请求分发到正确的脚本，并从当前工作目录加载
```
.env
```
文件。
安装：
```
npm install -g @four-meme/four-meme-ai@latest
```
。运行环境：Node.js。依赖项（包括dotenv、viem、tsx）已在包的
```
package.json
```
中声明；全局安装会自动安装这些依赖项。除npm包外无需单独安装其他组件。

需求	命令	适用场景
公开配置	`fourmeme config`	获取raisedToken/配置（无需授权）
代币信息（链上）	`fourmeme token-info <tokenAddress>`	版本、tokenManager、价格、报价（BSC Helper3）
代币列表（REST）	`fourmeme token-list [--orderBy=] [--pageIndex=] [--pageSize=] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=]`	过滤后的分页代币列表
代币详情（REST）	`fourmeme token-get <tokenAddress>`	代币详情与交易信息（get/v2）
代币排名（REST）	`fourmeme token-rankings <orderBy> [--barType=HOUR24]`	时间/进度降序/交易量降序/热门/已毕业；TradingDesc需指定barType
买入报价	`fourmeme quote-buy <token> <amountWei> [fundsWei]`	仅估算；不发送交易
卖出报价	`fourmeme quote-sell <token> <amountWei>`	仅估算；不发送交易
执行买入	`fourmeme buy <token> amount <amountWei> <maxFundsWei>`	买入固定数量（需要PRIVATE_KEY）
执行买入	`fourmeme buy <token> funds <fundsWei> <minAmountWei>`	花费固定报价（如BNB）（需要PRIVATE_KEY）
执行卖出	`fourmeme sell <token> <amountWei> [minFundsWei]`	卖出代币（需要PRIVATE_KEY）
转账	`fourmeme send <toAddress> <amountWei> [tokenAddress]`	向指定地址发送BNB或ERC20代币（需要PRIVATE_KEY）
EIP-8004注册	`fourmeme 8004-register <name> [imageUrl] [description]`	注册8004身份NFT（需要PRIVATE_KEY）
EIP-8004查询	`fourmeme 8004-balance <ownerAddress>`	查询8004 NFT余额（只读）
事件	`fourmeme events <fromBlock> [toBlock]`	TokenCreate/购买/售卖/添加流动性事件
税费代币信息	`fourmeme tax-info <tokenAddress>`	TaxToken的手续费/税费配置
只读检查	`fourmeme verify`	运行配置+事件查询（最近50个区块）

链支持：仅BSC（不支持Arbitrum/Base）。

Create token (full flow)

创建代币（完整流程）

Agent interaction: ask about tax token and parameters before creating

When the user asks to create a token, the Agent must ask in this order:

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 yes: continue to step 2.
Tax parameters (only when user chose tax token)
Ask for (and explain constraints; see “tokenTaxInfo parameters” table below):
- feeRate: Fee rate (%). Only 1, 3, 5, or 10.
- burnRate, divideRate, liquidityRate, recipientRate: Four percentages; sum must be 100.
- If recipientRate > 0: ask recipientAddress.
- 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).

Step 1 – Config (optional)

bash

fourmeme config

Step 2 – Create token (API)
Requires

PRIVATE_KEY

. Outputs

createArg

and

signature

(hex).


imagePath
name
shortName
desc
label
tokenTaxInfo

Position	Argument	Description
1	`imagePath`	Local image path (jpeg/png/gif/bmp/webp)
2	`name`	Token full name
3	`shortName`	Token symbol (e.g. MTK)
4	`desc`	Description text
5	`label`	Category label (see list below)
6	`[taxOptions.json]`	Optional; path to JSON containing `tokenTaxInfo` for tax token

Label (exactly one):

Meme

AI

Defi

Games

Infra

De-Sci

Social

Depin

Charity

Others

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]

Agent交互：创建前询问税费代币及参数

当用户要求创建代币时，Agent必须按以下顺序询问：

是否为税费代币？
询问：“您是否要创建税费（Tax）代币？若选择否，则创建普通代币。”
- 若否：使用
```
fourmeme create-api <imagePath> <name> <shortName> <desc> <label>
```
  （无第六个参数，无TAX_*环境变量）。
- 若是：继续步骤2。
税费参数（仅当用户选择税费代币时）
索要以下参数（并说明约束；请查看下方的“tokenTaxInfo参数”表格）：
- feeRate：手续费率（%）。仅支持1、3、5或10。
- burnRate、divideRate、liquidityRate、recipientRate：四个百分比；总和必须为100。
- 若recipientRate > 0：索要recipientAddress。
- minSharing：参与分红的最低代币余额（以ether为单位，例如100000、1000000）。
然后选择以下方式之一：
- 选项A：将
```
{ "tokenTaxInfo": { ... } }
```
  写入JSON文件，调用
```
fourmeme create-api ... <path/to/tax.json>
```
  。
- 选项B：设置环境变量TAX_TOKEN=1、TAX_FEE_RATE、TAX_BURN_RATE、TAX_DIVIDE_RATE、TAX_LIQUIDITY_RATE、TAX_RECIPIENT_RATE、TAX_RECIPIENT_ADDRESS（可选）、TAX_MIN_SHARING，然后运行
```
fourmeme create-api <imagePath> <name> <shortName> <desc> <label>
```
  （无第六个参数）。

步骤1 – 配置（可选）

bash

fourmeme config

步骤2 – 创建代币（API）
需要PRIVATE_KEY。输出

createArg

和

signature

（十六进制格式）。


imagePath
name
shortName
desc
label
tokenTaxInfo

位置	参数	描述
1	`imagePath`	本地图片路径（支持jpeg/png/gif/bmp/webp）
2	`name`	代币全称
3	`shortName`	代币符号（例如：MTK）
4	`desc`	描述文本
5	`label`	分类标签（请查看下方列表）
6	`[taxOptions.json]`	可选；包含税费代币 `tokenTaxInfo` 的JSON文件路径

标签（必须选择其一）：

Meme

AI

Defi

Games

Infra

De-Sci

Social

Depin

Charity

Others

。

可选环境变量（未设置时使用默认值）：WEB_URL、TWITTER_URL、TELEGRAM_URL；PRE_SALE（默认值

"0"

）；FEE_PLAN（

"true"

表示启用AntiSniperFeeMode，默认值

"false"

）。

bash

fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]

Example: fourmeme create-api ./logo.png MyToken MTK "Description" AI

示例：fourmeme create-api ./logo.png MyToken MTK "描述文本" AI

Tax: fourmeme create-api ./logo.png TaxToken TAX "Tax token" Meme tax.json

税费代币：fourmeme create-api ./logo.png TaxToken TAX "税费代币" Meme tax.json


**Tax token**  
- **Option 1**: Last argument = path to JSON file with `{ "tokenTaxInfo": { ... } }`; fields see “tokenTaxInfo parameters” below.  
- **Option 2**: Env vars: `TAX_TOKEN=1`, `TAX_FEE_RATE` (1|3|5|10), `TAX_BURN_RATE` / `TAX_DIVIDE_RATE` / `TAX_LIQUIDITY_RATE` / `TAX_RECIPIENT_RATE` (sum = 100), `TAX_RECIPIENT_ADDRESS`, `TAX_MIN_SHARING` (e.g. 100000). See [references/token-tax-info.md](references/token-tax-info.md).

**tokenTaxInfo parameters** (required for tax token, via JSON or env):

| Field | Type | Description | Constraint |
|-------|------|-------------|------------|
| `feeRate` | number | Trading fee rate (%) | **Only** `1`, `3`, `5`, `10` |
| `burnRate` | number | Burn share (%) | Sum with next three = 100 |
| `divideRate` | number | Dividend share (%) | Same |
| `liquidityRate` | number | Liquidity share (%) | Same |
| `recipientRate` | number | Recipient share (%) | 0 if unused |
| `recipientAddress` | string | Recipient address | `""` if unused |
| `minSharing` | number | Min balance for dividend (ether units) | d×10ⁿ, n≥5, 1≤d≤9; e.g. 100000, 1000000 |

Example (5% fee, 20% burn, 30% dividend, 40% liquidity, 10% recipient):

```json
{
  "tokenTaxInfo": {
    "feeRate": 5,
    "burnRate": 20,
    "divideRate": 30,
    "liquidityRate": 40,
    "recipientRate": 10,
    "recipientAddress": "0x1234567890123456789012345678901234567890",
    "minSharing": 100000
  }
}

Step 3 – Create token (chain)

bash

fourmeme create-chain <createArgHex> <signatureHex>


**税费代币**  
- **选项1**：最后一个参数为包含`{ "tokenTaxInfo": { ... } }`的JSON文件路径；字段请查看下方的“tokenTaxInfo参数”。  
- **选项2**：设置环境变量：TAX_TOKEN=1、TAX_FEE_RATE（1|3|5|10）、TAX_BURN_RATE/TAX_DIVIDE_RATE/TAX_LIQUIDITY_RATE/TAX_RECIPIENT_RATE（总和=100）、TAX_RECIPIENT_ADDRESS、TAX_MIN_SHARING（例如100000）。详情请查看[references/token-tax-info.md](references/token-tax-info.md)。

**tokenTaxInfo参数**（税费代币必填，可通过JSON或环境变量设置）：

| 字段 | 类型 | 描述 | 约束 |
|-------|------|-------------|------------|
| `feeRate` | 数字 | 交易手续费率（%） | **仅支持**`1`、`3`、`5`、`10` |
| `burnRate` | 数字 | 销毁占比（%） | 与后三个字段的总和为100 |
| `divideRate` | 数字 | 分红占比（%） | 同上 |
| `liquidityRate` | 数字 | 流动性占比（%） | 同上 |
| `recipientRate` | 数字 | 接收方占比（%） | 未使用时设为0 |
| `recipientAddress` | 字符串 | 接收方地址 | 未使用时设为`""` |
| `minSharing` | 数字 | 参与分红的最低余额（ether单位） | d×10ⁿ，n≥5，1≤d≤9；例如100000、1000000 |

示例（5%手续费，20%销毁、30%分红、40%流动性、10%接收方）：

```json
{
  "tokenTaxInfo": {
    "feeRate": 5,
    "burnRate": 20,
    "divideRate": 30,
    "liquidityRate": 40,
    "recipientRate": 10,
    "recipientAddress": "0x1234567890123456789012345678901234567890",
    "minSharing": 100000
  }
}

步骤3 – 创建代币（链上）

bash

fourmeme create-chain <createArgHex> <signatureHex>

Or pipe: fourmeme create-api ... | fourmeme create-chain --

或管道执行：fourmeme create-api ... | fourmeme create-chain --

undefined

undefined

Full automated create flow

完整自动化创建流程

To create and submit on-chain in one go, the Agent should:

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]

Parse stdout JSON for

createArg

and

signature

(already hex strings).

Run create-chain with those two values:
bash
```
fourmeme create-chain <createArgHex> <signatureHex>
```
This calls
```
TokenManager2.createToken(createArg, sign)
```
on BSC and outputs tx result / token address.
Optional: If the user said “create and go on-chain for me”, the Agent can run the two steps in sequence after collecting tax params, then summarize: success,
```
tokenAddress
```
/
```
requestId
```
, and main params (name, shortName, label, tax config).

要一键完成创建并提交到链上，Agent应执行以下步骤：

运行create-api获取签名数据（与上述步骤2相同；返回包含
```
createArg
```
和
```
signature
```
的JSON）：
bash
```
fourmeme create-api <imagePath> <name> <shortName> <desc> <label> [taxOptions.json]
```
解析标准输出的JSON，获取
```
createArg
```
和
```
signature
```
（已为十六进制字符串）。
运行create-chain传入上述两个值：
bash
```
fourmeme create-chain <createArgHex> <signatureHex>
```
此命令会在BSC链上调用
```
TokenManager2.createToken(createArg, sign)
```
，并输出交易结果/代币地址。
可选：若用户要求“帮我创建并提交到链上”，Agent可在收集完税费参数后依次运行上述两个步骤，然后总结：创建成功、
```
tokenAddress
```
/
```
requestId
```
以及主要参数（名称、符号、标签、税费配置）。

token-info

bash

fourmeme token-info <tokenAddress>

On-chain query (Helper3); returns version, tokenManager, price, offers, etc.

bash

fourmeme token-info <tokenAddress>

链上查询（Helper3）；返回版本、tokenManager、价格、报价等信息。

token-list / token-get / token-rankings (REST)

token-list / token-get / token-rankings（REST）

Four.meme REST API; use

Accept: application/json

; no login or cookie.

Token list (filter / paginate)

bash

fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]

Token detail and trading info

bash

fourmeme token-get <tokenAddress>

API: GET

/private/token/get/v2?address=...

Rankings

bash

fourmeme token-rankings <orderBy> [--barType=HOUR24]

orderBy:

Time

(newest) |

ProgressDesc

TradingDesc

(24h volume; barType HOUR24) |

Hot

Graduated

. Output JSON.

Four.meme REST API；使用

Accept: application/json

；无需登录或Cookie。

代币列表（过滤/分页）

bash

fourmeme token-list [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false]

代币详情与交易信息

bash

fourmeme token-get <tokenAddress>

API：GET

/private/token/get/v2?address=...

排名

bash

fourmeme token-rankings <orderBy> [--barType=HOUR24]

orderBy可选值：

Time

（最新）|

ProgressDesc

TradingDesc

（24小时交易量；barType为HOUR24）|

Hot

（热门）|

Graduated

（已毕业）。输出JSON格式数据。

quote-buy / quote-sell (estimate only; no transaction)

quote-buy / quote-sell（仅估算；不发送交易）

bash

fourmeme quote-buy <tokenAddress> <amountWei> [fundsWei]
fourmeme quote-sell <tokenAddress> <amountWei>

amountWei: token amount (use 0 when buying by quote amount); fundsWei: quote to spend (omit or 0 when buying by token amount).

bash

fourmeme quote-buy <tokenAddress> <amountWei> [fundsWei]
fourmeme quote-sell <tokenAddress> <amountWei>

amountWei：代币数量（按报价买入时设为0）；fundsWei：花费的报价（按代币数量买入时省略或设为0）。

buy / sell (execute; requires PRIVATE_KEY)

buy / sell（执行交易；需要PRIVATE_KEY）

Buy (one of):

By amount:
```
fourmeme buy <token> amount <amountWei> <maxFundsWei>
```
(spend at most maxFundsWei to buy amountWei tokens).
By funds:
```
fourmeme buy <token> funds <fundsWei> <minAmountWei>
```
(spend fundsWei quote, receive at least minAmountWei tokens).

Sell: Script performs approve then sell.

bash

fourmeme sell <tokenAddress> <amountWei> [minFundsWei]

minFundsWei optional (slippage: minimum quote received). V2 tokens only.

买入（二选一）：

按数量买入：
```
fourmeme buy <token> amount <amountWei> <maxFundsWei>
```
（花费不超过maxFundsWei买入amountWei个代币）。
按报价买入：
```
fourmeme buy <token> funds <fundsWei> <minAmountWei>
```
（花费fundsWei报价，至少买入minAmountWei个代币）。

卖出：脚本会先执行approve再卖出。

bash

fourmeme sell <tokenAddress> <amountWei> [minFundsWei]

minFundsWei为可选参数（滑点控制：最低接收报价）。仅支持V2代币。

send (send BNB or ERC20 to an address)

send（向指定地址发送BNB或ERC20代币）

Send native BNB or ERC20 from the current wallet (PRIVATE_KEY) to a given address (BSC).

bash

fourmeme send <toAddress> <amountWei> [tokenAddress]

Argument	Description
`toAddress`	Recipient address (0x...)
`amountWei`	Amount in wei (BNB or token smallest unit)
`tokenAddress`	Optional. Omit or use `BNB` / `0x0` for native BNB; otherwise ERC20 contract address

Env:
```
PRIVATE_KEY
```
. Optional:
```
BSC_RPC_URL
```
.
Output: JSON with
```
txHash
```
,
```
to
```
,
```
amountWei
```
,
```
native
```
(whether BNB).

Examples:

bash

undefined

从当前钱包（PRIVATE_KEY对应的钱包）向指定地址发送原生BNB或ERC20代币（BSC链）。

bash

fourmeme send <toAddress> <amountWei> [tokenAddress]

参数	描述
`toAddress`	接收方地址（0x...格式）
`amountWei`	数量（以wei为单位，BNB或代币的最小单位）
`tokenAddress`	可选。省略或设为 `BNB` / `0x0` 表示发送原生BNB；否则传入ERC20合约地址

环境变量：
```
PRIVATE_KEY
```
。可选：
```
BSC_RPC_URL
```
。
输出：包含
```
txHash
```
、
```
to
```
、
```
amountWei
```
、
```
native
```
（是否为BNB）的JSON。

示例：

bash

undefined

Send 0.1 BNB (1e17 wei)

发送0.1 BNB（1e17 wei）

fourmeme send 0x1234...abcd 100000000000000000

Send 1000 units of an ERC20 (18 decimals)

发送1000个ERC20代币（18位小数）

fourmeme send 0x1234...abcd 1000000000000000000000 0xTokenContractAddress

undefined

fourmeme send 0x1234...abcd 1000000000000000000000 0xTokenContractAddress

undefined

EIP-8004 identity NFT (register and query)

EIP-8004身份NFT（注册与查询）

EIP-8004 identity NFT: register (mint) and query balance. Default contract:

0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

(BSC). Override with env

8004_NFT_ADDRESS

EIP8004_NFT_ADDRESS

Register: Requires

PRIVATE_KEY

. User provides name (required), image URL (optional), description (optional). CLI builds EIP-8004 payload (type, name, description, image, active, supportedTrust), encodes as

data:application/json;base64,<base64>

for

agentURI

, and calls

register(string agentURI)

bash

fourmeme 8004-register <name> [imageUrl] [description]

Argument	Description
`name`	Required. Identity name
`imageUrl`	Optional. Avatar/image URL (must be publicly reachable)
`description`	Optional. Description

Output JSON:
```
txHash
```
,
```
agentId
```
(from event),
```
agentURI
```
.

Query: Read-only; number of 8004 NFTs held by an address.

bash

fourmeme 8004-balance <ownerAddress>

Output JSON:
```
owner
```
,
```
balance
```
.

Examples:

bash

fourmeme 8004-register "myagent" "https://example.com/logo.png" "My agent description"
fourmeme 8004-balance 0x1234567890123456789012345678901234567890

EIP-8004身份NFT：注册（铸造）与查询余额。默认合约地址：

0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

（BSC链）。可通过环境变量

8004_NFT_ADDRESS

或

EIP8004_NFT_ADDRESS

覆盖。

data:application/json;base64,<base64>

格式的

agentURI

，然后调用

register(string agentURI)

。

bash

fourmeme 8004-register <name> [imageUrl] [description]

参数	描述
`name`	必填。身份名称
`imageUrl`	可选。头像/图片URL（必须可公开访问）
`description`	可选。描述文本

输出JSON：
```
txHash
```
、
```
agentId
```
（来自事件）、
```
agentURI
```
。

查询：只读操作；查询指定地址持有8004 NFT的数量。

bash

fourmeme 8004-balance <ownerAddress>

输出JSON：
```
owner
```
、
```
balance
```
。

示例：

bash

fourmeme 8004-register "myagent" "https://example.com/logo.png" "我的Agent描述"
fourmeme 8004-balance 0x1234567890123456789012345678901234567890

events (TokenManager2 V2 only)

events（仅支持TokenManager2 V2）

Fetch TokenCreate, TokenPurchase, TokenSale, LiquidityAdded on BSC.

bash

fourmeme events <fromBlock> [toBlock]

Omit toBlock for latest. Real-time subscription: references/event-listening.md.

获取BSC链上的TokenCreate、TokenPurchase、TokenSale、LiquidityAdded事件。

bash

fourmeme events <fromBlock> [toBlock]

省略toBlock则查询到最新区块。实时订阅：references/event-listening.md。

tax-info (TaxToken fee/tax)

tax-info（TaxToken手续费/税费）

Only for TaxToken (creatorType 5).

bash

fourmeme tax-info <tokenAddress>

See references/tax-token-query.md.

仅支持TaxToken（creatorType 5）。

bash

fourmeme tax-info <tokenAddress>

详情请查看references/tax-token-query.md。

API and config reference

API与配置参考

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.
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 and 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.

代币详情（REST）：
```
GET /private/token/get?address=<token>
```
、
```
GET /private/token/getById?id=<requestId>
```
（requestId来自TokenCreate事件）。响应可能包含
```
data.aiCreator
```
（由Agent创建的代币）。列表/排名：references/token-query-api.md。
Agent Creator / Agent钱包：链上 — 代币模板的第85位表示“由Agent创建”；BSC链上的AgentIdentifier合约（
```
isAgent(wallet)
```
）用于识别Agent钱包。详情请查看references/agent-creator-and-wallets.md和references/contract-addresses.md。
raisedToken：调用
```
GET https://four.meme/meme-api/v1/public/config
```
获取当前的raisedToken；直接在创建请求体中使用，请勿修改其字段。

References

参考文档

Document	Description
contract-addresses.md	TokenManager / TokenManager2 / Helper3 addresses (BSC)
api-create-token.md	Create token API (nonce / login / upload / create)
create-token-scripts.md	Create token script flow and examples
token-tax-info.md	Tax token tokenTaxInfo parameters and constraints
token-query-api.md	Token list / detail / rankings REST API
errors.md	buy/sell error codes; X Mode / TaxToken / AntiSniperFeeMode; Agent Creator
agent-creator-and-wallets.md	Token created by Agent Creator; AgentIdentifier contract and Agent wallets
execute-trade.md	Execute buy/sell CLI and contract usage
event-listening.md	TokenManager2 event listening (V2)
tax-token-query.md	TaxToken on-chain fee/tax query (tax-info)
Official four.meme API and contracts (online): Protocol Integration	API documents, ABIs: TokenManager, TokenManager2, Helper3, TaxToken, AgentIdentifier, etc.

文档	描述
contract-addresses.md	TokenManager/TokenManager2/Helper3的合约地址（BSC链）
api-create-token.md	创建代币的API（随机数/登录/上传/创建）
create-token-scripts.md	创建代币的脚本流程与示例
token-tax-info.md	税费代币的tokenTaxInfo参数与约束
token-query-api.md	代币列表/详情/排名的REST API
errors.md	买卖错误码；X Mode/TaxToken/AntiSniperFeeMode；Agent Creator
agent-creator-and-wallets.md	由Agent Creator创建的代币；AgentIdentifier合约与Agent钱包
execute-trade.md	执行买卖的CLI与合约使用方法
event-listening.md	TokenManager2事件监听（V2）
tax-token-query.md	TaxToken链上手续费/税费查询（tax-info）
官方four.meme API与合约（在线）：Protocol Integration	API文档、ABI：TokenManager、TokenManager2、Helper3、TaxToken、AgentIdentifier等
",