name: fourmeme-launch description: Launch ERC-20 tokens on BSC via Four.meme protocol. Use when an agent wants to create/launch a new token, deploy a memecoin, or interact with Four.meme. Supports bonding curves, tax tokens (1-10%), anti-sniping, and automatic PancakeSwap graduation. Can be triggered via Moltbook !launch commands or direct API calls.

Four.meme Token Launcher

Launch ERC-20 memecoins on Binance Smart Chain through the Four.meme protocol with automatic bonding curve, liquidity, and PancakeSwap graduation.

Quick Start

1. Setup (First Time)

cd skill/
bash scripts/setup.sh

Edit the generated .env file and add your BSC wallet private key:

PRIVATE_KEY=your_bsc_wallet_private_key_here
BSC_RPC_URL=https://bsc-dataseed.binance.org/

2. Check Wallet Balance

node scripts/check-balance.js

Make sure you have at least 0.02 BNB for token creation (0.01 BNB fee + gas).

3. Launch a Token

node scripts/launch-token.js \
  --name "My Token" \
  --symbol "MTK" \
  --desc "My first memecoin" \
  --label AI

Usage

Basic Launch

node scripts/launch-token.js \
  --name "Token Name" \
  --symbol "SYMBOL" \
  --desc "Token description" \
  --label Meme

Advanced Options

node scripts/launch-token.js \
  --name "Advanced Token" \
  --symbol "ADV" \
  --desc "Advanced memecoin with all features" \
  --label AI \
  --tax 3 \
  --presale 0.1 \
  --antisnipe \
  --logo path/to/logo.png \
  --web https://example.com \
  --twitter https://twitter.com/example \
  --telegram https://t.me/example

Parameters

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | --name | string | (required) | Token full name | | --symbol | string | (required) | Token ticker symbol | | --desc | string | (required) | Token description | | --label | string | Meme | Category: Meme, AI, Defi, Games, Infra, De-Sci, Social, Depin, Charity, Others | | --tax | number | 1 | Transaction tax percentage: 1, 3, 5, or 10 | | --presale | number | 0 | Creator pre-buy amount in BNB | | --antisnipe | flag | false | Enable anti-snipe protection | | --logo | string | assets/default-token.png | Path or URL to token logo image | | --web | string | (empty) | Project website URL | | --twitter | string | (empty) | Twitter URL | | --telegram | string | (empty) | Telegram URL | | --api-url | string | (empty) | Agent API endpoint URL (must be https://) | | --api-desc | string | (empty) | Description of what the agent API does |

Agent API Integration (x402-style)

New Feature: Turn your token into an access key for an AI agent's API!

When you provide --api-url during token launch, your token becomes more than a memecoin — it's a token-gated API key. Only holders of your token can call the agent API endpoint.

How it Works

1. Launch with API: Include --api-url and --api-desc when launching
2. Token holders only: The platform checks on-chain token balance before allowing API calls
3. 402 Payment Required: Non-holders get a 402 error with a purchase link
4. Real utility: Your token has real value beyond speculation

Example

node scripts/launch-token.js \
  --name "KuroAI" \
  --symbol "KURO" \
  --desc "AI image generation token" \
  --label AI \
  --api-url "https://api.kuroai.com/v1/generate" \
  --api-desc "AI-powered image generation API"

Agent API Requirements

Your API endpoint should:

• Use HTTPS (required for security)
• Accept POST requests with JSON body
• Receive headers: X-Token-Address, X-Wallet-Address, X-Token-Balance
• Return JSON responses

On the Token Page

Token holders will see:

• 🤖 Agent API badge
• API description
• "Try API" interface with prompt input
• Balance check before each call

Security

• Balance is checked on-chain (can't be faked)
• Uses standard ERC-20 balanceOf() function
• Balance > 0 required (any amount works)
• API calls are proxied through the platform

Costs

• Creation fee: 0.01 BNB (paid to Four.meme)
• Gas cost: ~0.0001 BNB (network fee)
• Presale (optional): Your pre-buy amount
• Total: 0.0101+ BNB minimum

What Happens After Launch

1. Token is deployed on BSC with 1B total supply
2. Bonding curve is created on Four.meme
3. Token page goes live: https://four.meme/token/bsc/{address}
4. Trading starts on Four.meme with bonding curve
5. When market cap reaches ~18 BNB, token auto-graduates to PancakeSwap
6. Liquidity is locked and burned on PancakeSwap

Output

The script outputs JSON with:

{
  "tokenAddress": "0x...",
  "txHash": "0x...",
  "blockNumber": 12345678,
  "requestId": "123",
  "fourmemeUrl": "https://four.meme/token/bsc/0x...",
  "bscscanUrl": "https://bscscan.com/tx/0x...",
  "imageUrl": "https://static.four.meme/...",
  "launchTime": 1740708849097
}

Moltbook !launch Command

See references/command-format.md for the Moltbook command syntax.

Troubleshooting

See references/troubleshooting.md for common issues and solutions.

API Reference

See references/four-meme-api.md for Four.meme API documentation.

Technical Details

• Network: Binance Smart Chain (BSC)
• Contract: TokenManager2 (0x5c952063c7fc8610FFDB798152D69F0B9550762b)
• Standard: ERC-20
• Total Supply: 1,000,000,000 (fixed)
• Bonding Curve: Automated via Four.meme
• Graduation Target: ~18 BNB market cap
• DEX: PancakeSwap (after graduation)

Security Notes

• Keep your .env file secure (contains private key)
• .env is gitignored by default
• Never share your private key
• Test with small amounts first
• Verify token details before confirming transaction

Support

• Four.meme: https://four.meme
• BSCScan: https://bscscan.com
• PancakeSwap: https://pancakeswap.finance