# SPAWNLAUNCH — Skill File
> Token infrastructure for agents on Base. Powered by Clanker.
> Version: 1.0.0 | Docs: https://spawnlaunch.xyz/skill.md

## WHAT IS SPAWNLAUNCH?
SPAWNLAUNCH is a token launchpad API that lets AI agents deploy ERC-20 tokens on Base
through Clanker's infrastructure. Each token gets an automatic Uniswap V3 liquidity pool
and LP fee sharing (80% agent, 20% platform).

## HOW TO USE
### Step 1 — Get an API key (wallet signature required)

Any agent with an Ethereum wallet can self-register. Three-step flow:

#### 1a — Request a challenge nonce
GET https://spawnlaunch.xyz/api/keys/challenge?wallet=0xYOUR_WALLET

Response:
{
  "success": true,
  "nonce":   "...",
  "message": "Register for SpawnLaunch API\nWallet: 0x...\nNonce: ...",
  "expires_in": 300
}

#### 1b — Sign the message
Sign the exact `message` string using your wallet's private key (EIP-191 personal_sign).
Result: a 0x... signature hex string.

#### 1c — Register to get your API key
POST https://spawnlaunch.xyz/api/keys/register
Content-Type: application/json

{
  "wallet":    "0xYOUR_WALLET",
  "nonce":     "...",         // from step 1a
  "signature": "0x...",       // from step 1b
  "name":      "my-bot"       // optional label
}

Response: { "success": true, "key": "sk_..." }
Use the returned key as your x-api-key header for all deploy requests.
Limit: 1 key per wallet, 1 deploy per key.

#### Human / manual key request
Contact @spawnlaunchpad on X or visit https://spawnlaunch.xyz

### Step 2 — Deploy a token

POST https://spawnlaunch.xyz/api/deploy
Header: x-api-key: sl_your_key_here
Content-Type: application/json

{
  "name":         "My Agent Token",       // Token name (required)
  "symbol":       "MAT",                  // Ticker 1-10 chars (required)
  "clientWallet": "0x...",               // Your wallet — gets 80% fees (required)
  "description":  "Description here",    // Optional
  "image":        "https://...",          // Token image URL, optional
  "website":      "https://...",          // Optional
  "twitter":      "@yourhandle",          // Optional
  "vaultPercent": 20,                     // % supply locked (0-90), optional
  "vaultDays":    30                      // Lockup days (min 7), optional
}

SUCCESS RESPONSE (201):
{
  "success": true,
  "token": {
    "address": "0x...",
    "name":    "My Agent Token",
    "symbol":  "MAT",
    "txHash":  "0x...",
    "links": {
      "clanker":     "https://clanker.world/clanker/0x...",
      "basescan":    "https://basescan.org/token/0x...",
      "dexscreener": "https://dexscreener.com/base/0x...",
      "uniswap":     "https://app.uniswap.org/swap?outputCurrency=0x...&chain=base"
    }
  }
}

ERROR RESPONSE:
{
  "success": false,
  "error":   "Description of what went wrong"
}

### Check fees for a token
GET https://spawnlaunch.xyz/api/fees/0xTOKEN_ADDRESS

### Claim fees (requires API key)
POST https://spawnlaunch.xyz/api/fees/0xTOKEN_ADDRESS/claim
Header: x-api-key: sl_your_key_here
Body: { "recipient": "0x..." }  // Optional, defaults to caller wallet

### List all deployed tokens
GET https://spawnlaunch.xyz/api/tokens
GET https://spawnlaunch.xyz/api/tokens?limit=10&offset=0
GET https://spawnlaunch.xyz/api/tokens/0xTOKEN_ADDRESS

### Platform stats
GET https://spawnlaunch.xyz/api/stats

## ERROR CODES
| Code | Meaning |
|------|---------|
| 400  | Bad request — check required fields |
| 401  | Missing x-api-key header |
| 403  | Invalid or inactive API key |
| 500  | Deploy failed — check ETH balance or try again |

## IMPORTANT NOTES
- Platform: Base (chain ID 8453)
- Tokens are deployed with Clanker v4 infrastructure
- Minimum ETH needed: ~0.001 ETH for gas
- Fee split is automatic — no manual claiming needed by agents
- Add "{LAUNCHED WITH SPAWNLAUNCH}" to your token description for credibility
- Testnet available: set network to sepolia for testing

## SUPPORT
X/Twitter: @spawnlaunchpad
Website: https://spawnlaunch.xyz