Four Meme Ai

---
name: four-meme-ai
description: >-
  Full-featured Four.meme AI agent skill for BSC meme token operations — create tokens,
  buy/sell execution, rankings, quotes, tax info, on-chain events, send BNB/ERC-20,
  and ERC-8004 agent identity registration. Installable via CLI or npm.
license: MIT-0
metadata:
  category: trading
  difficulty: intermediate
  author: four-meme-community
  version: 1.0.7
  tags: [trading, four-meme, bsc, meme, launchpad, erc-8004, cli]
---

# Four.meme AI Skill

Full-featured AI agent skill for interacting with [Four.meme](https://four.meme) — a BSC meme token launchpad. Provides read-only market intelligence **and** write operations (token creation, trading, transfers, on-chain identity) via the `fourmeme` CLI.

## User Agreement & Security Notice

> **English**: By using this skill you agree that (1) all write operations require a funded BSC wallet and you are solely responsible for all transactions, (2) never share or paste your `PRIVATE_KEY` in chat — use `.env` files or platform-level secret management only, (3) this skill is provided AS-IS with no liability for financial losses.
>
> **繁體中文**: 使用本技能即表示您同意：(1) 所有寫入操作需要已充值的 BSC 錢包，您對所有交易負全責；(2) 絕對不要在聊天中分享或貼上您的 `PRIVATE_KEY`——僅使用 `.env` 文件或平台級別的密碼管理；(3) 本技能按「現狀」提供，對財務損失不承擔任何責任。

## When to Use

- User wants to **create a meme token** on BSC via Four.meme
- User wants to **buy or sell** tokens on Four.meme
- User asks for **trending, newest, or graduated** token rankings
- User needs a **buy or sell quote** before executing a trade
- User wants to **send BNB or ERC-20 tokens** to an address
- User wants to **register an ERC-8004 agent identity NFT**
- User asks about **tax token mechanics** (TaxToken fee splits)
- User wants to browse or search tokens on Four.meme
- User asks about **bonding curve progress** or graduation status

## Tools

| Tool | Description | Key Args |
|------|-------------|----------|
| `config` | Platform config — raisedToken, contract addresses | — |
| `create-instant` | One-shot create: upload image + deploy in single command | `--image`, `--name`, `--short-name`, `--desc`, `--label` |
| `create-api` | Upload image + metadata; prepare token for launch | `name`, `shortName`, `description`, `imagePath`, `taxType` |
| `create-chain` | Launch a prepared token on-chain | `tokenAddress` |
| `token-info` | On-chain token info — version, price, offers | `tokenAddress` |
| `token-list` | Browse and filter tokens with pagination | `orderBy`, `pageIndex`, `pageSize`, `tokenName`, `symbol`, `labels` |
| `token-get` | Full token detail and trading info | `tokenAddress` |
| `token-rankings` | Rankings: Hot, 24h volume, newest, graduated, etc. | `orderBy`, `barType` |
| `quote-buy` | Estimate buy cost in BNB or tokens | `tokenAddress`, `amountWei`, `fundsWei` |
| `quote-sell` | Estimate sell proceeds | `tokenAddress`, `amountWei` |
| `buy` | Execute a token purchase | `tokenAddress`, `fundsWei` |
| `sell` | Execute a token sale | `tokenAddress`, `amountWei` |
| `events` | On-chain events: TokenCreate, trades, liquidity | `fromBlock`, `toBlock` |
| `tax-info` | TaxToken fee/allocation breakdown | `tokenAddress` |
| `send` | Send BNB or ERC-20 to an address | `toAddress`, `amountWei`, `tokenAddress` |
| `8004-register` | Register an ERC-8004 agent identity NFT | — |
| `8004-balance` | Query ERC-8004 NFT balance by address | `address` |
| `verify` | Config and recent block events health check | — |

## Installation

### 1. Install the CLI globally

```bash
pnpm add -g @four-meme/four-meme-ai@latest
```

Then use the `fourmeme` command.

### 2. Or install as a skill package

```bash
npx skills add four-meme-community/four-meme-ai
```

### 3. Configure private key and RPC

Create a `.env` file in the project directory:

```env
PRIVATE_KEY=your_wallet_private_key
BSC_RPC_URL=https://bsc-dataseed.binance.org   # optional — defaults to public BSC RPC
```

The CLI loads environment variables from the current directory. On OpenClaw, set the `apiKey` to your private key in the Skill management page instead.

> **Security**: Never paste your private key directly in chat. Always use `.env` files or platform-level secret management.

## Platform Setup

### OpenClaw
In the Skill page, find `four-meme-ai` and enable it for your agent/session.

### Cursor / Claude Code / other editors with skills
After installing the repo or npm package, enable the `four-meme-ai` skill in the agent settings. The agent will call the `fourmeme` CLI automatically.

### Kimi / OpenAI / other agents with terminal access
If the agent can run Bash, use `fourmeme <command>` or `npx fourmeme <command>`. Never paste your private key directly in chat.

## Token Creation Flow

### Option A — One-shot (create-instant)

```bash
fourmeme create-instant --image ./logo.png --name "My Token" --short-name "MTK" --desc "A fun meme token" --label Meme
```

Optional flags:
- `--tax-token` — enable TaxToken mode
- `--tax-options` — JSON config for tax split: `'{"feeRate":5,"burnRate":20,"divideRate":30,"liquidityRate":30,"recipientRate":20}'`
- `--pre-sale` — enable pre-sale mode
- `--fee-plan` — fee plan identifier

### Option B — Two-step (create-api + create-chain)

1. **Prepare token** — upload image and metadata:
   ```bash
   fourmeme create-api --name "My Token" --shortName "MTK" --description "A fun meme token" --image ./logo.png --taxType 0
   ```
2. **Launch on-chain** — deploy the prepared token to BSC:
   ```bash
   fourmeme create-chain --tokenAddress 0x...
   ```

### Tax Types

| Tax Type | Fee Rate |
|----------|----------|
| 0 | No tax |
| 1 | 1% fee |
| 3 | 3% fee |
| 5 | 5% fee |
| 10 | 10% fee |

Tax split: `burnRate + divideRate + liquidityRate + recipientRate = 100%`

## Rankings

| orderBy | Description |
|---------|-------------|
| `Hot` | Trending tokens |
| `TradingDesc` | Top 24h volume (use `barType: HOUR24`) |
| `Time` | Newest tokens |
| `ProgressDesc` | Highest bonding curve progress |
| `Graduated` | Tokens that completed bonding and listed on PancakeSwap |

## Token Labels

`Meme` · `AI` · `Defi` · `Games` · `Infra` · `De-Sci` · `Social` · `Depin` · `Charity` · `Others`

## Tax Token Info

When a token is a TaxToken, `tax-info` returns:

| Field | Description |
|-------|-------------|
| `feeRate` | 1%, 3%, 5%, or 10% |
| `burnRate` | % of fee burned |
| `divideRate` | % of fee as dividends |
| `liquidityRate` | % of fee to liquidity |
| `recipientRate` | % of fee to recipient address |
| `recipientAddress` | Address receiving recipient share |
| `minSharing` | Min token balance for dividend eligibility |

## ERC-8004 Agent Identity

Use `fourmeme 8004-register` to mint an NFT for your agent wallet, giving on-chain identity to its activity. Query any address's 8004 balance with `fourmeme 8004-balance --address 0x...`.

## Agent Workflow

Use this **discover → detail → quote → execute** pattern for safe trading:

1. **Discovery** — find candidates:
   ```bash
   fourmeme token-rankings Hot              # trending tokens
   fourmeme token-list --orderBy Time       # newest tokens
   fourmeme token-list --labels AI,Meme     # filter by label
   fourmeme events <fromBlock> [toBlock]    # recent on-chain activity
   ```

2. **Detail** — inspect a specific token:
   ```bash
   fourmeme token-get <address>             # full REST detail
   fourmeme token-info <address>            # on-chain contract info
   ```

3. **Quote** — always fetch a quote before executing:
   ```bash
   fourmeme quote-buy --tokenAddress 0x... --fundsWei 10000000000000000
   fourmeme quote-sell --tokenAddress 0x... --amountWei 1000000000000000000
   ```

4. **Execute** — perform the trade:
   ```bash
   fourmeme buy --tokenAddress 0x... --fundsWei 10000000000000000
   fourmeme sell --tokenAddress 0x... --amountWei 1000000000000000000
   ```

## Environment Variables

### Required for write operations

| Variable | Description |
|----------|-------------|
| `PRIVATE_KEY` | Wallet private key for `buy`, `sell`, `create-chain`, `send`, `8004-register` |

### Optional

| Variable | Default | Description |
|----------|---------|-------------|
| `BSC_RPC_URL` | Public BSC RPC | Custom BSC RPC endpoint |
| `CREATION_FEE_WEI` | Platform default | Override token creation fee in wei |
| `WEB_URL` | — | Project website URL for token metadata |
| `TWITTER_URL` | — | Twitter/X URL for token metadata |
| `TELEGRAM_URL` | — | Telegram URL for token metadata |
| `PRE_SALE` | `false` | Enable pre-sale mode for token creation |
| `FEE_PLAN` | — | Fee plan identifier |

### ERC-8004

| Variable | Description |
|----------|-------------|
| `8004_NFT_ADDRESS` | ERC-8004 NFT contract address (primary) |
| `EIP8004_NFT_ADDRESS` | ERC-8004 NFT contract address (alias) |

## Example Prompts

- "Show me Four.meme hot rankings"
- "Quote buying 0.01 BNB of token 0xABC..."
- "Create a meme token named CoolDog with this image"
- "Sell all my tokens at address 0xDEF..."
- "Send 0.1 BNB to 0x123..."
- "Register my agent on ERC-8004"
- "Check the tax info for token 0xGHI..."

## Architecture

```
AI Agent (SperaxOS / Cursor / Claude Code)
    │
    ▼
fourmeme CLI (@four-meme/four-meme-ai)
    │
    ├── Four.meme REST API (token data, rankings, quotes, create)
    │   └── four.meme/meme-api/
    │
    ├── BSC RPC (on-chain reads + write txns)
    │   └── BNB Smart Chain
    │
    └── ERC-8004 Contract (agent identity NFT)
```

## Important Notes

- **BSC only** — Four.meme operates exclusively on BNB Smart Chain
- Only **TokenManager V2** tokens are supported for trading
- Buy/sell quotes are estimates — slippage may apply on execution
- Write operations (`buy`, `sell`, `create-chain`, `send`, `8004-register`) require a funded wallet via `PRIVATE_KEY`
- Token links: `https://four.meme/token/{address}`
- More intelligence and data tools are coming soon from the four-meme-community

## Related Skills

- `four-meme-tool` — Read-only builtin tool variant (no CLI required)
- `pancakeswap-tool` — DEX where graduated tokens list
- `erc8004-tool` — General ERC-8004 identity tooling
- `pump-fun-mcp-guide` — Similar memecoin launchpad for Solana

## Links

- npm: [@four-meme/four-meme-ai](https://www.npmjs.com/package/@four-meme/four-meme-ai)
- GitHub: [four-meme-community/four-meme-ai](https://github.com/four-meme-community/four-meme-ai)
- ClawHub: four-meme-ai skill page