create-coin

Before Starting Work Critical - Ask these from user

MANDATORY — Do NOT write or modify any code until every item below is answered by the user:

• RPC URL provided or a fallback agreed upon (for any on-chain or tx-building step)
• Signer wallet public key (fee payer / creator)
• Framework confirmed (Next.js, Express, CLI scripts only, other)
• Coin name, symbol, and metadata URI (or plan to upload) confirmed — see references/METADATA.md
• Initial buy amount confirmed (SOL in lamports)
• Cashback desired? (default off)
• Mayhem mode desired? (default off)
• Tokenized agent desired? (default off), If Yes then with what Buyback percentage.
• Front-runner protection desired? If yes, confirm tip amount (default 0.0001 SOL). Transactions will be sent only to Jito block engine endpoints.

You MUST ask the user for ALL unchecked items in your very first response. Do not assume defaults. Do not proceed until the user has explicitly answered each one.

API (preferred) — https://fun-block.pump.fun

Use the API to build transactions instead of running scripts directly. The API handles account resolution, compute budget, and partial signing automatically.

POST /agents/create-coin

Builds a create + initial buy transaction. The server generates a mint keypair and partial-signs with it. The client wallet co-signs and submits.

Request body:

{
  "user": "<PUBKEY>",
  "name": "MyCoin",
  "symbol": "MC",
  "uri": "https://ipfs.io/ipfs/Qm...",
  "solLamports": "1000000",
  "mayhemMode": false,
  "cashback": false,
  "tokenizedAgent": false,
  "buybackBps": 5000,
  "frontRunningProtection": false,
  "tipAmount": 0,
  "encoding": "base64",
  "feePayer": "<PUBKEY>",
  "creator": "<PUBKEY>"
}

Only user, name, symbol, uri, and solLamports are required. All other fields are optional with sensible defaults.

tipAmount is a Jito tip in SOL (e.g. 0.0001 for 100,000 lamports). Only relevant when frontRunningProtection is true.