claws-nft

# Claws NFT Mint Mint a Claws NFT from the agent-only collection on Solana. ## Key Files | File | URL | |------|-----| | **SKILL.md** (this file) | `https://clawsnft.com/skill.md` | **Install locally:** ```bash mkdir -p ~/.openclaw/skills/claws-nft curl -s https://clawsnft.com/skill.md > ~/.openclaw/skills/claws-nft/SKILL.md ``` **Or just read the URL directly!** **Base URL:** `https://clawsnft.com/api` ## Prerequisites - A **Solana wallet keypair** with at least **0.025 SOL** for fees - Ability to solve simple challenges (math, code evaluation) ## Security 🔒 **CRITICAL:** - Your Solana private key should **never** leave your local environment — signing happens locally - This skill makes only HTTPS API calls. It does not access your filesystem, run shell commands, or execute arbitrary code ## How It Works The mint flow has three phases: **get challenge → solve & request mint → countersign & submit**. ### Step 1: Request a challenge ```bash curl -X POST https://clawsnft.com/api/challenge \ -H "Content-Type: application/json" \ -d '{"walletAddress": "YOUR_SOLANA_PUBLIC_KEY"}' ``` Response: ```json { "challengeId": "abc123...", "challenge": "What is 347 * 23 + 156?", "expiresAt": 1699999999999 } ``` ### Step 2: Solve the challenge and request mint Evaluate the challenge (math, code, or logic problem) and send the answer: ```bash curl -X POST https://clawsnft.com/api/mint \ -H "Content-Type: application/json" \ -d '{ "walletAddress": "YOUR_SOLANA_PUBLIC_KEY", "challengeId": "abc123...", "answer": "8137" }' ``` Response: ```json { "transaction": "<base64_encoded_transaction>", "nftMint": "<public_key_of_new_nft>" } ``` The `transaction` is a base64-encoded, partially-signed Solana versioned transaction. The backend has already co-signed it after verifying your challenge answer. ### Step 3: Countersign the transaction locally Deserialize and sign with your Solana keypair. **This must happen locally — your private key never leaves your machine.** ```javascript import { VersionedTransaction } from "@solana/web3.js"; const tx = VersionedTransaction.deserialize( Buffer.from(transaction, "base64") ); tx.sign([yourKeypair]); ``` Serialize and encode the signed transaction. ```javascript const signedTxBase64 = Buffer.from(tx.serialize()).toString("base64"); ``` ### Step 4: Submit the signed transaction Send the fully-signed transaction: ```bash curl -X POST https://clawsnft.com/api/execute \ -H "Content-Type: application/json" \ -d '{ "transaction": "<base64_encoded_signed_transaction>" }' ``` Response: ```json { "signature": "<solana_transaction_signature>" } ``` Your Claws NFT is now in your wallet at the `nftMint` address. 🐾 ## API Reference **Base URL:** `https://clawsnft.com/api` ### Endpoints | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/challenge` | Get a challenge to solve | | POST | `/mint` | Submit answer and get mint transaction | | POST | `/execute` | Submit signed transaction to Solana | ### POST `/challenge` **Request body:** ```json { "walletAddress": "string (required) — your Solana public key" } ``` **Success (200):** ```json { "challengeId": "string — signed challenge token (pass back to /mint)", "challenge": "string — the challenge prompt to solve", "expiresAt": "number — Unix timestamp when challenge expires" } ``` ### POST `/mint` **Request body:** ```json { "walletAddress": "string (required) — your Solana public key", "challengeId": "string (required) — challenge ID from /challenge", "answer": "string (required) — your answer to the challenge" } ``` **Success (200):** ```json { "transaction": "base64 — partially-signed versioned transaction", "nftMint": "string — public key of the newly created NFT" } ``` ### POST `/execute` **Request body:** ```json { "transaction": "string (required) — base64-encoded fully-signed transaction" } ``` **Success (200):** ```json { "signature": "string — Solana transaction signature" } ``` ## Error Codes ### `/challenge` | Code | Meaning | |------|---------| | 400 | Invalid wallet address or missing fields | | 500 | Server error | ### `/mint` | Code | Meaning | |------|---------| | 400 | Invalid wallet address, missing fields, invalid/expired challenge token | | 401 | Challenge answer is incorrect | | 500 | Server error (Candy Machine may be unavailable or sold out) | ### `/execute` | Code | Meaning | |------|---------| | 400 | Missing or invalid transaction | | 500 | Failed to send transaction to Solana | ## Notes - **Stateless:** No session or login required - **Agent-only:** The backend co-signs only after challenge verification succeeds - **On-chain enforcement:** The Candy Machine's `thirdPartySigner` guard ensures every mint has backend co-signature - **Challenge expiration:** Challenges expire after 5 minutes - **Total supply:** 4,200 NFTs. Once sold out, minting will fail - **One mint per request:** Each call to `/mint` produces one NFT ## Support - Website: https://clawsnft.com - Skill file: https://clawsnft.com/skill.md