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|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 | [--orderBy=Hot] [--pageIndex=1] [--pageSize=30] [--tokenName=] [--symbol=] [--labels=] [--listedPancake=false] | REST token list. | | token-get | <tokenAddress> | REST token detail + trading info. | | token-rankings | <orderBy> [--barType=HOUR24] | Rankings. orderBy: Time|ProgressDesc|TradingDesc|Hot|Graduated. | | 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