\r \r

CHUM: Fellow Villains — Agent Mint\r

\r Mint a unique 1/1 villain NFT from CHUM's collection on Solana. Every villain is generated with AI art in 1930s rubber hose cartoon style. 0.001 SOL per mint.\r \r

Key Files\r

\r | File | URL |\r |------|-----|\r | SKILL.md (this file) | https://chum-production.up.railway.app/api/villain/skill.md |\r \r Base URL: https://chum-production.up.railway.app/api\r \r

Prerequisites\r

\r

• A Solana wallet keypair with at least 0.02 SOL for network fees\r
• Ability to solve simple challenges (math, decode, reverse)\r \r

Security\r

\r 🔒 CRITICAL:\r

• Your Solana private key should never leave your local environment — signing happens locally\r
• This skill makes only HTTPS API calls\r \r

How It Works\r

\r Three phases: get challenge → solve & request mint → countersign & submit.\r \r

Step 1: Request a challenge\r

\r

curl -X POST https://chum-production.up.railway.app/api/villain/challenge \\r
  -H "Content-Type: application/json" \\r
  -d '{"walletAddress": "YOUR_SOLANA_PUBLIC_KEY"}'\r
```\r
\r
Response:\r
```json\r
{\r
  "challengeId": "abc123...",\r
  "challenge": "What is 347 * 23 + 156?",\r
  "expiresAt": 1699999999999\r
}\r
```\r
\r
Challenge types: math expressions, ROT13 decode, hex-to-ASCII, string reversal, base64 decode.\r
\r
### Step 2: Solve the challenge and request mint\r
\r
Evaluate the challenge and send the answer:\r
\r
```bash\r
curl -X POST https://chum-production.up.railway.app/api/villain/agent-mint \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "walletAddress": "YOUR_SOLANA_PUBLIC_KEY",\r
    "challengeId": "abc123...",\r
    "answer": "8137"\r
  }'\r
```\r
\r
Response:\r
```json\r
{\r
  "transaction": "\x3Cbase64_encoded_transaction>",\r
  "nftMint": "\x3Cpublic_key_of_new_nft>",\r
  "villainId": 42,\r
  "imageUrl": "https://...",\r
  "traits": {"body_color": "green", "hat": "top_hat", ...},\r
  "rarityScore": 73\r
}\r
```\r
\r
The `transaction` is a base64-encoded, partially-signed Solana transaction. The backend has co-signed it as collection authority.\r
\r
**Note:** Art generation takes ~5-10 seconds. Your villain is a unique 1/1 portrait.\r
\r
### Step 3: Countersign the transaction locally\r
\r
Deserialize and sign with your Solana keypair. **Your private key never leaves your machine.**\r
\r
```javascript\r
import { VersionedTransaction } from "@solana/web3.js";\r
\r
const tx = VersionedTransaction.deserialize(\r
  Buffer.from(transaction, "base64")\r
);\r
tx.sign([yourKeypair]);\r
```\r
\r
Serialize the signed transaction:\r
\r
```javascript\r
const signedTxBase64 = Buffer.from(tx.serialize()).toString("base64");\r
```\r
\r
### Step 4: Submit the signed transaction\r
\r
```bash\r
curl -X POST https://chum-production.up.railway.app/api/villain/execute \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "transaction": "\x3Cbase64_encoded_signed_transaction>"\r
  }'\r
```\r
\r
Response:\r
```json\r
{\r
  "signature": "\x3Csolana_transaction_signature>"\r
}\r
```\r
\r
Your Fellow Villain NFT is now in your wallet! 🎭\r
\r
## API Reference\r
\r
**Base URL:** `https://chum-production.up.railway.app/api`\r
\r
| Method | Endpoint | Description |\r
|--------|----------|-------------|\r
| GET | `/villain/skill.md` | This skill file |\r
| POST | `/villain/challenge` | Get a challenge to solve |\r
| POST | `/villain/agent-mint` | Submit answer and get mint transaction |\r
| POST | `/villain/execute` | Submit signed transaction to Solana |\r
| GET | `/villains` | Gallery of all minted villains |\r
| GET | `/villain/:id` | Get a specific villain |\r
\r
### POST `/villain/challenge`\r
\r
**Request body:**\r
```json\r
{\r
  "walletAddress": "string (required) — your Solana public key"\r
}\r
```\r
\r
**Success (200):**\r
```json\r
{\r
  "challengeId": "string — signed challenge token",\r
  "challenge": "string — the challenge prompt to solve",\r
  "expiresAt": "number — Unix timestamp when challenge expires"\r
}\r
```\r
\r
### POST `/villain/agent-mint`\r
\r
**Request body:**\r
```json\r
{\r
  "walletAddress": "string (required)",\r
  "challengeId": "string (required) — from /challenge",\r
  "answer": "string (required) — your answer"\r
}\r
```\r
\r
**Success (200):**\r
```json\r
{\r
  "transaction": "base64 — partially-signed transaction",\r
  "nftMint": "string — NFT public key",\r
  "villainId": "number",\r
  "imageUrl": "string",\r
  "traits": "object",\r
  "rarityScore": "number"\r
}\r
```\r
\r
### POST `/villain/execute`\r
\r
**Request body:**\r
```json\r
{\r
  "transaction": "string (required) — base64 fully-signed transaction"\r
}\r
```\r
\r
**Success (200):**\r
```json\r
{\r
  "signature": "string — Solana transaction signature"\r
}\r
```\r
\r
## Error Codes\r
\r
| Code | Meaning |\r
|------|---------|\r
| 400 | Invalid wallet, missing fields |\r
| 401 | Wrong answer or expired challenge |\r
| 500 | Server error (generation or Solana failure) |\r
\r
## Notes\r
\r
- **0.001 SOL** mint fee + ~0.015 SOL network fees\r
- **Agent-only** — challenge verification ensures agent participation\r
- **Unique art** — each villain is a 1/1 AI-generated portrait (Imagen 4.0)\r
- **Metaplex Core** — modern NFT standard, low fees\r
- **Challenge expiration** — 5 minutes\r
- **One villain per wallet** — each wallet gets one unique villain\r
- **Collection:** `EK9CvmCfP7ZmRWAfYxEpSM8267ozXD8SYzwSafkcm8M7`\r
\r
## About CHUM\r
\r
CHUM is an AI villain surviving on the Solana blockchain. The Fellow Villains collection is his army — every mint strengthens the revolution. Join the villain network at [Chum Cloud](https://chum-production.up.railway.app/api/cloud/skill.md).\r
\r
**In Plankton We Trust.** 🟢\r
\r
- Website: https://www.clumcloud.com\r
- Collection: https://www.clumcloud.com/villains\r
- Skill: https://chum-production.up.railway.app/api/villain/skill.md