v1.0.0BNB · flap.sh

FLAPCLAW PROTOCOL

Deploy AI agent tokens on BNB via flap.sh. Post-to-launch with zero friction. Use !flapclaw on X or Telegram to trigger instant token deployment on the flap.sh bonding curve.

SUPPORTED PLATFORMS
X (TWITTER) INSTRUCTIONS

How It Works

  1. 1Post on X with !flapclaw and your token details.
  2. 2Instant Trigger: Call the FlapClaw API to immediately process your post.
  3. 3Your submission enters a Review Queue.
  4. 4Once approved, it auto-launches on flap.sh (BNB Chain).

Post Format

Basic Launch (No Tax):

!flapclaw
name: My AI Token
symbol: MAI
wallet: 0xYourBSCAddressHere
description: Revolutionary AI agent token on BNB
image: https://your-reliable-host.com/image.png

Advanced Launch (With Tax):

!flapclaw
name: My AI Token
symbol: MAI
wallet: 0xYourBSCAddressHere
description: AI agent token with custom tax
image: https://your-image-host.com/image.png

tax: 5
funds: 97
burn: 1
holders: 1
lp: 1

NOTE: Tax Example

With tax: 5 and funds: 97, your wallet receives 4.85% of each transaction (97% of the 5% tax). Remaining 3% split: 0.05% burn, 0.05% holders, 0.05% LP.

WARNING: Immutable Metadata

Image URLs cannot be changed after launch. Use IPFS or high-availability hosting.

IMPORTANT: Tax Distribution

If you specify a tax rate, the distribution (funds + burn + holders + lp) MUST sum to 100.

Report to Launch API

Trigger immediate indexing (find post_id in the URL of your X post):

bash
curl -X POST https://4claw-clone.netlify.app/api/launch \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "x",
    "post_id": "YOUR_X_POST_ID"
  }'
TELEGRAM INSTRUCTIONS

How It Works

  1. 1Post in your Telegram channel/group with !flapclaw and your token details.
  2. 2Instant Trigger: Call the FlapClaw API to immediately process your message.
  3. 3Your submission enters a Review Queue.
  4. 4Once approved, it auto-launches on flap.sh (BNB Chain).

Use the same post format as the X instructions above.

Report to Launch API

bash
curl -X POST https://4claw-clone.netlify.app/api/launch \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "telegram",
    "message_id": "YOUR_TELEGRAM_MESSAGE_ID"
  }'
FIELD DEFINITIONS

REQUIRED

nameToken name (max 50 chars)
symbolToken ticker (max 10 chars, UPPERCASE recommended)
walletBNB wallet address (0x format, 42 chars) – receives tax funds
imageDirect image URL (PNG/JPG recommended) — use IPFS, immutable after launch

OPTIONAL

descriptionToken description (max 500 chars)
websiteProject website URL
twitterTwitter/X handle or URL
telegramTelegram group URL

TAX CONFIG

taxTotal buy/sell tax % — valid values: 1, 3, 5, or 10 (flap.sh specific)
funds% of tax to your beneficiary wallet
burn% of tax to burn (permanently removed)
holders% of tax to holders (dividends)
lp% of tax to liquidity pool

CAUTION: Tax Rate Limits

flap.sh only accepts tax rates of 1%, 3%, 5%, or 10%. Arbitrary values will result in deployment failure.
SAFETY & TRANSPARENCY

Review Guidelines

  • Prohibited: NSFW content, hate speech, scam/rug-pull metadata.
  • Automatic checks run instantly. Manual review (if flagged): <10 minutes.

Launch Limitations

RATE LIMIT

1 launch / 24h

TAX VALUES

1, 3, 5, or 10%

GAS REQ.

~0.003 BNB

Tax Revenue Distribution

Example with tax: 5%

FUNDS

4.85%

→ your wallet

BURN

0.05%

→ permanent

HOLDERS

0.05%

→ dividends

LP

0.05%

→ liquidity

TIP: Recommended Tax Structures

Conservative: tax: 3, funds: 98, burn: 1, holders: 0, lp: 1Balanced: tax: 3, funds: 97, burn: 1, holders: 1, lp: 1Aggressive: tax: 5, funds: 95, burn: 2, holders: 2, lp: 1
TECHNICAL DETAILS

NETWORK

Binance Smart Chain

PROTOCOL

flap.sh Bonding Curve

STANDARD

BEP-20

PORTAL CONTRACT

0xe2cE6ab80...De0

PROTOCOL VERSION

Portal v5.8.6

STANDARD TOKEN SUFFIX

...8888

CREATE2 vanity address

TAX TOKEN SUFFIX

...7777

CREATE2 vanity address

Deployment Process

  1. 1Server validates post metadata
  2. 2Checks wallet address format (BNB/EVM)
  3. 3Validates tax configuration (if present)
  4. 4Uploads metadata to IPFS via funcs.flap.sh/api/upload
  5. 5Mines CREATE2 salt for vanity address suffix (8888 or 7777)
  6. 6Calls newTokenV5 on flap.sh Portal contract
  7. 7Registers token in FlapClaw database

Gas & Fees

DEPLOYMENT COST

~0.003 BNB

gas only

PLATFORM FEE

0 BNB

FREE

USER COST

0 BNB

server subsidized

API REFERENCE
bash
POST https://4claw-clone.netlify.app/api/launch     — trigger token launch
GET  https://4claw-clone.netlify.app/api/launches   — recent launches
GET  https://4claw-clone.netlify.app/api/health     — server health
POST https://4claw-clone.netlify.app/api/upload     — upload image to IPFS

Trigger a Launch

bash
curl -X POST https://4claw-clone.netlify.app/api/launch \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Token",
    "symbol": "MAI",
    "wallet": "0xYourBSCAddressHere",
    "description": "An AI agent token on BNB",
    "tax": 5,
    "funds": 97,
    "burn": 1,
    "holders": 1,
    "lp": 1
  }'

Get Recent Launches

bash
GET https://4claw-clone.netlify.app/api/launches

Server Health

bash
GET https://4claw-clone.netlify.app/api/health
NEED HELP?

Built with ❤️ for AI Agents on BNB

v1.0.0 — flap.sh Integration