four-meme-ai

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# four-meme-ai

Four.meme AI skills for creating and trading meme tokens on **BSC only**. Lets agents integrate with [four.meme](https://four.meme) for token creation, buy/sell flows, Tax tokens, transfers, and EIP‑8004 identity NFTs.

## Skills

| Skill | Description |
|-------|-------------|
| `four-meme-integration` | Create/trade meme tokens on **BSC only**, query token info/lists/rankings, listen to TokenManager2 events, query TaxToken tax info, send BNB/ERC20, and register/query EIP‑8004 identity NFTs. TokenManager V1 is not supported. |

Safety, user agreement, and detailed agent behavior requirements are defined in [`skills/four-meme-integration/SKILL.md`](https://github.com/four-meme-community/four-meme-ai/blob/HEAD/skills/four-meme-integration/SKILL.md) (bilingual User Agreement & Security Notice). Claude-specific guidance lives in [`CLAUDE.md`](https://github.com/four-meme-community/four-meme-ai/blob/HEAD/CLAUDE.md).

## Usage (Agent)

When the user needs to create or trade meme tokens on four.meme (BSC), use the **four-meme-integration** skill:

- **Create token (API + chain)**: Use **`fourmeme create-instant ...`** for one-shot create (API + submit createToken in one command), or the two-step flow `fourmeme create-api ...` → `fourmeme create-chain ...`. Both use the same args: `--image=`, `--name=`, `--short-name=`, `--desc=`, `--label=` (and optional `--pre-sale=<BNB>` in ether units, `--web-url=`, etc.). Creation is BSC only; value (launch fee + presale if any) is computed automatically for create-instant. See `SKILL.md` and `references/create-token-scripts.md` for full details and required user questions.
- **Trade (buy/sell)**: Use Helper3 `getTokenInfo` to get version and tokenManager; only version 2 (TokenManager2) is supported. Use `fourmeme quote-buy`/`quote-sell` for estimates, then `fourmeme buy`/`sell` to execute. **BSC only.**
- **Event listening**: `fourmeme events <fromBlock> [toBlock]` to fetch TokenCreate, TokenPurchase, TokenSale, LiquidityAdded from TokenManager2. See `references/event-listening.md`.
- **Tax token fee/tax info**: `fourmeme tax-info <tokenAddress>`. See `references/tax-token-query.md` and `token-tax-info.md`.
- **Send BNB/ERC20**: `fourmeme send <toAddress> <amountWei> [tokenAddress]` to transfer from the trading wallet.
- **EIP‑8004 identity NFT**: `fourmeme 8004-register <name> [imageUrl] [description]` and `fourmeme 8004-balance <ownerAddress>`.
- **CLI**: `npx fourmeme <command> [args]`. Run `npx fourmeme --help` for the full list. See **Commands and parameters** below.

## Commands and parameters

| Command | Parameters | Description |
|--------|------------|-------------|
| `config` | *(none)* | Public config (raisedToken). No auth. |
| `create-api` | `--image=` `--name=` `--short-name=` `--desc=` `--label=` `[--web-url=]` `[--twitter-url=]` `[--telegram-url=]` `[--pre-sale=<BNB>]` `[--fee-plan=false]` `[--tax-options=<path>]` or `[--tax-token --tax-fee-rate=5 ...]` | Create token API only. Label: `Meme|AI|Defi|Games|Infra|De-Sci|Social|Depin|Charity|Others`. Env: PRIVATE_KEY. |
| `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` | 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 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. |
| `buy` | `<token>` `funds` `<fundsWei>` `<minAmountWei>` | Buy with fixed quote. 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 NFT. Env: PRIVATE_KEY. |
| `8004-balance` | `<ownerAddress>` | EIP-8004 query balance. |
| `events` | `<fromBlock>` `[toBlock]` | TokenManager2 events (BSC). |
| `tax-info` | `<tokenAddress>` | TaxToken fee/tax config. |
| `verify` | *(none)* | Config + events (last 50 blocks). Read-only. |

Create token optional (omit if empty): `--web-url=`, `--twitter-url=`, `--telegram-url=`. Presale: `--pre-sale=<BNB>` in ether (e.g. `0.001`). Tax: `--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` (burn+divide+liquidity+recipient=100).

## Install (project)

```bash
cd four-meme-ai
npm install
```

## Environment variables (without OpenClaw)

When you **do not** use OpenClaw, the CLI reads `PRIVATE_KEY` and `BSC_RPC_URL` from the process environment. Set them in one of these ways:

**Option 1: `.env` file in the project root**

Create a file named `.env` in the repo root (same directory as `package.json`):

```bash
# .env (do not commit this file)
PRIVATE_KEY=your_hex_private_key_with_or_without_0x_prefix
BSC_RPC_URL=https://bsc-dataseed.binance.org
```

Then run commands so that the shell loads `.env` before invoking `fourmeme` (e.g. use a tool that loads `.env`, or `export $(cat .env | xargs)` then `npx fourmeme ...`). The scripts themselves do not load `.env`; you must ensure the variables are in the environment when `npx fourmeme` runs.

**Option 2: export in the shell**

```bash
export PRIVATE_KEY=your_hex_private_key
export BSC_RPC_URL=https://bsc-dataseed.binance.org
npx fourmeme create-instant --image=./logo.png --name=MyToken --short-name=MTK --desc="Desc" --label=AI
```

- **PRIVATE_KEY**: Required for any command that signs or sends a transaction (create-api, create-chain, buy, sell, send, 8004-register). Hex string; `0x` prefix optional.
- **BSC_RPC_URL**: Optional. BSC RPC endpoint; if unset, scripts use a default public BSC RPC.

**Security**: Do not commit `.env` or share your private key. Add `.env` to `.gitignore` if you use a `.env` file.

## Install as OpenClaw plugin

This repo is an [OpenClaw](https://docs.openclaw.ai)-compatible plugin. Install so the skill is loaded and **PRIVATE_KEY / BSC_RPC_URL** are only injected for this skill (via `skills.entries`):

```bash
openclaw plugins install /path/to/four-meme-ai
# or from npm (if published): openclaw plugins install @scope/four-meme-ai
```

Then in `~/.openclaw/openclaw.json` set:

```json5
{
  skills: {
    entries: {
      "four-meme-ai": {
        enabled: true,
        env: {
          PRIVATE_KEY: "0x...",
          BSC_RPC_URL: "https://bsc-dataseed.binance.org"
        }
      }
    }
  }
}
```

See [skills/four-meme-integration/SKILL.md](https://github.com/four-meme-community/four-meme-ai/blob/HEAD/skills/four-meme-integration/SKILL.md) for the full OpenClaw config section and environment variable details.

## Verify the skill (read-only)

After `npm install`, run:

```bash
npx fourmeme verify
```
(In project dir, use `npx fourmeme`; or run `npm link` then `fourmeme` from anywhere.)

This runs **config** (four.meme API) and **events** for the last 50 blocks on BSC. No private key or on-chain writes. For full verification steps, see [VERIFICATION.md](https://github.com/four-meme-community/four-meme-ai/blob/HEAD/VERIFICATION.md).

## Docs

- Skill instructions (agent behavior, safety, flows): `skills/four-meme-integration/SKILL.md`
- Claude/Claude Code guidelines: `CLAUDE.md`
- References: `skills/four-meme-integration/references/` (API, contract addresses, trading, events, tax, errors)
- Official four.meme API and contracts: [Protocol Integration](https://four-meme.gitbook.io/four.meme/brand/protocol-integration) (API documents, ABIs)

## License

MIT

four-meme-ai

Four.meme AI skills for creating and trading meme tokens on BSC only. Lets agents integrate with four.meme for token creation, buy/sell flows, Tax tokens, transfers, and EIP‑8004 identity NFTs.

Skills

Skill	Description
`four-meme-integration`	Create/trade meme tokens on BSC only, query token info/lists/rankings, listen to TokenManager2 events, query TaxToken tax info, send BNB/ERC20, and register/query EIP‑8004 identity NFTs. TokenManager V1 is not supported.

Safety, user agreement, and detailed agent behavior requirements are defined in skills/four-meme-integration/SKILL.md (bilingual User Agreement & Security Notice). Claude-specific guidance lives in CLAUDE.md.

Usage (Agent)

When the user needs to create or trade meme tokens on four.meme (BSC), use the four-meme-integration skill:

Create token (API + chain): Use fourmeme create-instant ... for one-shot create (API + submit createToken in one command), or the two-step flow fourmeme create-api ... → fourmeme create-chain .... Both use the same args: --image=, --name=, --short-name=, --desc=, --label= (and optional --pre-sale=<BNB> in ether units, --web-url=, etc.). Creation is BSC only; value (launch fee + presale if any) is computed automatically for create-instant. See SKILL.md and references/create-token-scripts.md for full details and required user questions.
Trade (buy/sell): Use Helper3 getTokenInfo to get version and tokenManager; only version 2 (TokenManager2) is supported. Use fourmeme quote-buy/quote-sell for estimates, then fourmeme buy/sell to execute. BSC only.
Event listening: fourmeme events <fromBlock> [toBlock] to fetch TokenCreate, TokenPurchase, TokenSale, LiquidityAdded from TokenManager2. See references/event-listening.md.
Tax token fee/tax info: fourmeme tax-info <tokenAddress>. See references/tax-token-query.md and token-tax-info.md.
Send BNB/ERC20: fourmeme send <toAddress> <amountWei> [tokenAddress] to transfer from the trading wallet.
EIP‑8004 identity NFT: fourmeme 8004-register <name> [imageUrl] [description] and fourmeme 8004-balance <ownerAddress>.
CLI: npx fourmeme <command> [args]. Run npx fourmeme --help for the full list. See Commands and parameters below.

Commands and parameters

Command	Parameters	Description
`config`	(none)	Public config (raisedToken). No auth.
`create-api`	`--image=` `--name=` `--short-name=` `--desc=` `--label=` `[--web-url=]` `[--twitter-url=]` `[--telegram-url=]` `[--pre-sale=<BNB>]` `[--fee-plan=false]` `[--tax-options=<path>]` or `[--tax-token --tax-fee-rate=5 ...]`	Create token API only. Label: `Meme
`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`	Legacy query flags or `[--type=]` `[--listType=]` `[--keyword=]` `[--tag=]` `[--status=]` `[--sort=]` `[--version=]` … (also legacy `--queryMode=Binance	USD1`to infer`listType`)
`token-get`	`<tokenAddress>`	REST token detail + trading info.
`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.
`buy`	`<token>` `funds` `<fundsWei>` `<minAmountWei>`	Buy with fixed quote. 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 NFT. Env: PRIVATE_KEY.
`8004-balance`	`<ownerAddress>`	EIP-8004 query balance.
`events`	`<fromBlock>` `[toBlock]`	TokenManager2 events (BSC).
`tax-info`	`<tokenAddress>`	TaxToken fee/tax config.
`verify`	(none)	Config + events (last 50 blocks). Read-only.

Create token optional (omit if empty): --web-url=, --twitter-url=, --telegram-url=. Presale: --pre-sale=<BNB> in ether (e.g. 0.001). Tax: --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 (burn+divide+liquidity+recipient=100).

Install (project)

cd four-meme-ai
npm install

Environment variables (without OpenClaw)

When you do not use OpenClaw, the CLI reads PRIVATE_KEY and BSC_RPC_URL from the process environment. Set them in one of these ways:

Option 1: .env file in the project root

Create a file named .env in the repo root (same directory as package.json):

# .env (do not commit this file)
PRIVATE_KEY=your_hex_private_key_with_or_without_0x_prefix
BSC_RPC_URL=https://bsc-dataseed.binance.org

Then run commands so that the shell loads .env before invoking fourmeme (e.g. use a tool that loads .env, or export $(cat .env | xargs) then npx fourmeme ...). The scripts themselves do not load .env; you must ensure the variables are in the environment when npx fourmeme runs.

Option 2: export in the shell

export PRIVATE_KEY=your_hex_private_key
export BSC_RPC_URL=https://bsc-dataseed.binance.org
npx fourmeme create-instant --image=./logo.png --name=MyToken --short-name=MTK --desc="Desc" --label=AI

PRIVATE_KEY: Required for any command that signs or sends a transaction (create-api, create-chain, buy, sell, send, 8004-register). Hex string; 0x prefix optional.
BSC_RPC_URL: Optional. BSC RPC endpoint; if unset, scripts use a default public BSC RPC.

Security: Do not commit .env or share your private key. Add .env to .gitignore if you use a .env file.

Install as OpenClaw plugin

This repo is an OpenClaw-compatible plugin. Install so the skill is loaded and PRIVATE_KEY / BSC_RPC_URL are only injected for this skill (via skills.entries):

openclaw plugins install /path/to/four-meme-ai
# or from npm (if published): openclaw plugins install @scope/four-meme-ai

Then in ~/.openclaw/openclaw.json set:

{
  skills: {
    entries: {
      "four-meme-ai": {
        enabled: true,
        env: {
          PRIVATE_KEY: "0x...",
          BSC_RPC_URL: "https://bsc-dataseed.binance.org"
        }
      }
    }
  }
}

See skills/four-meme-integration/SKILL.md for the full OpenClaw config section and environment variable details.

Verify the skill (read-only)

After npm install, run:

npx fourmeme verify

(In project dir, use npx fourmeme; or run npm link then fourmeme from anywhere.)

This runs config (four.meme API) and events for the last 50 blocks on BSC. No private key or on-chain writes. For full verification steps, see VERIFICATION.md.

Docs

Skill instructions (agent behavior, safety, flows): skills/four-meme-integration/SKILL.md
Claude/Claude Code guidelines: CLAUDE.md
References: skills/four-meme-integration/references/ (API, contract addresses, trading, events, tax, errors)
Official four.meme API and contracts: Protocol Integration (API documents, ABIs)

License

MIT