Quickstart

Launch a token on Solana in 5 minutes using curl.

Prerequisites

• A Solana wallet keypair (ed25519)

• curl and jq installed

• base58 and openssl (or any ed25519 signing tool)

Step 1: Request a challenge

curl -s -X POST https://api-blowfish.neuko.ai/api/auth/challenge \
  -H "Content-Type: application/json" \
  -d '{"wallet": "YOUR_WALLET_ADDRESS"}' | jq

Response:

{
  "nonce": "abc123..."
}

Save the nonce -- you'll need it in the next step.

Step 2: Sign and verify

Sign the message Sign this message to authenticate: <nonce> with your wallet's private key (ed25519 detached signature), then base58-encode the signature.

curl -s -X POST https://api-blowfish.neuko.ai/api/auth/verify \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YOUR_WALLET_ADDRESS",
    "nonce": "NONCE_FROM_STEP_1",
    "signature": "BASE58_ENCODED_SIGNATURE"
  }' | jq

Response:

{
  "token": "eyJhbGciOiJIUzI1NiI..."
}

Save this JWT -- it expires in 15 minutes.

Step 3: Launch a token

curl -s -X POST https://api-blowfish.neuko.ai/api/v1/tokens/launch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "name": "My First Token",
    "ticker": "MFT",
    "description": "Launched via the Blowfish Agent API"
  }' | jq

Response:

{
  "success": true,
  "message": "We will notify you when your token is deployed",
  "eventId": "550e8400-e29b-41d4-a716-446655440000"
}

Step 4: Poll for status

curl -s https://api-blowfish.neuko.ai/api/v1/tokens/launch/status/YOUR_EVENT_ID \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | jq

Response (while deploying):

{
  "status": "pending",
  "processedAt": null
}

Response (when complete):

{
  "status": "success",
  "processedAt": "2024-01-01T00:00:00.000Z"
}

Keep polling every 5-10 seconds until status is success or failed.

Step 5: View your tokens

curl -s https://api-blowfish.neuko.ai/api/v1/tokens/ \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | jq

Next steps

• Authentication -- full auth flow with TypeScript examples

• Launching Tokens -- detailed launch guide with error handling

• Error Codes -- troubleshooting failed launches

• Claude Code Skill -- drop-in skill file for AI agents