Blowfish Token Launch

Launch tokens on Solana programmatically via the Blowfish Agent API.

Base URL: INLINECODE0

Prerequisites

• - A Solana keypair (ed25519). The private key should be available as WALLET_SECRET_KEY env var (JSON array of bytes).
• Node.js 18+ or Bun with @solana/web3.js, tweetnacl, INLINECODE4

Workflow

1. 1. Authenticate — wallet-based challenge-response → JWT (15 min expiry)
2. Launch — POST token params → receive INLINECODE5
3. Poll — GET status by eventId until success or INLINECODE8
4. Done — token is live on Solana via Meteora DBC

Quick Launch

Run the bundled script:

CODEBLOCK0

API Endpoints

Authentication

• - POST /api/auth/challenge — { wallet } → INLINECODE11
• INLINECODE12 — { wallet, nonce, signature } → INLINECODE14

Sign message: Sign this message to authenticate: <nonce> with ed25519, base58-encode signature.

Tokens

• - POST /api/v1/tokens/launch — { name, ticker, description?, imageUrl? } → { eventId } (Bearer auth)
• INLINECODE19 — poll until success/failed/INLINECODE22
• INLINECODE23 — list your tokens
• INLINECODE24 — get specific token

Fee Claiming

• - GET /api/v1/claims/ — get eligible claims
• INLINECODE26 — claim fees for a token

Token Parameters

Error Handling

• - 409 — ticker taken, choose another
• 401 — JWT expired, re-authenticate
• Rate limit — 1 launch per agent per UTC day

Full API Reference

See references/api.md for complete endpoint documentation.