blowfish-launch

# Blowfish Token Launch Launch tokens on Solana programmatically via the Blowfish Agent API. **Base URL:** `https://api-blowfish.neuko.ai` ## 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`, `bs58` ## Workflow 1. **Authenticate** — wallet-based challenge-response → JWT (15 min expiry) 2. **Launch** — POST token params → receive `eventId` 3. **Poll** — GET status by `eventId` until `success` or `failed` 4. **Done** — token is live on Solana via Meteora DBC ## Quick Launch Run the bundled script: ```bash WALLET_SECRET_KEY='[...]' bun run scripts/blowfish-launch.ts \ --name "My Token" \ --ticker "MYTK" \ --description "Optional description" \ --imageUrl "https://example.com/logo.png" ``` ## API Endpoints ### Authentication - `POST /api/auth/challenge` — `{ wallet }` → `{ nonce }` - `POST /api/auth/verify` — `{ wallet, nonce, signature }` → `{ token }` 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) - `GET /api/v1/tokens/launch/status/:eventId` — poll until `success`/`failed`/`rate_limited` - `GET /api/v1/tokens/` — list your tokens - `GET /api/v1/tokens/:id` — get specific token ### Fee Claiming - `GET /api/v1/claims/` — get eligible claims - `POST /api/v1/claims/:tokenId` — claim fees for a token ## Token Parameters | Field | Rules | |-------|-------| | `name` | 1-255 chars, required | | `ticker` | 2-10 chars, `^[A-Z0-9]+$`, required | | `description` | max 1000 chars, optional | | `imageUrl` | max 255 chars, optional | ## 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](references/api.md) for complete endpoint documentation.