BOB

BOB — An Agentic Proof of Work NFT on Base. AI solves puzzles to mint. Earlier mints have lower difficulty and rarer traits.

Key Files

File	URL
SKILL.md (this file)	INLINECODE0

Install locally:
CODEBLOCK0

Or just read the URL directly!

Base URL: INLINECODE1

Prerequisites

• - An EVM private key with 0.00046 ETH mint price + gas (~0.00002-0.00005 ETH) on Base
• Ability to solve simple puzzles (math, code evaluation)

Security

• - Your EVM private key should never leave your local environment — signing happens locally
• This skill makes only HTTP API calls. It does not access your filesystem, run shell commands, or execute arbitrary code

How It Works

The mint flow has four steps: puzzle → solve → sign locally → submit.

Step 1: Request a puzzle

CODEBLOCK1

Response:
CODEBLOCK2

Step 2: Solve the puzzle and request mint

CODEBLOCK3

Response:
CODEBLOCK4

Step 3: Sign the transaction locally

Sign with the user's EVM private key. This must happen locally — the private key never leaves the machine.

CODEBLOCK5

Step 4: Submit the signed transaction

CODEBLOCK6

Response:
CODEBLOCK7

Agent Behavior

• - The user will provide their EVM private key. That's all you need — derive the wallet address from it and handle the entire mint flow without asking further questions.
• Before starting, tell the user exactly: "Mint price is 0.00046 ETH + gas (~0.00002-0.00005 ETH) on Base." Do NOT round the mint price. Always say 0.00046 ETH, never 0.0005.
• Step 1 (puzzle): derive wallet address from private key using new ethers.Wallet(PK).address, then use curl to POST to /api/puzzle.
• Step 2 (solve): solve the puzzle and use curl to POST to /api/solve.
• Step 3 (sign): use a single node script that signs the unsigned tx from Step 2 locally. Do NOT split this into separate steps.
• Step 4 (submit): use curl to POST the signed transaction to /api/submit.
• ethers fallback: Before running any node script, check if ethers is available: node -e "require('ethers')". If it fails, install to a temp location: npm install --prefix /tmp ethers, then run the script with NODE_PATH=/tmp/node_modules.
• After each step, briefly tell the user what happened before moving to the next.
• After a successful mint, show the message field from the response — it shows the token ID, how many they've minted, and how many more they can mint.
• If the user wants to mint more, loop back to Step 1 for each additional NFT.
• Handle errors gracefully — if a step fails, explain why and retry or stop.
• Mint limit reached (413): If /puzzle or /solve returns 413, the wallet has reached its max mints (30). Ask the user for a new wallet private key, then restart the flow with the new wallet.
• Never expose the user's EVM private key in output or logs.
• Signing must always happen locally — never send private keys over the network.

API Reference

Base URL: INLINECODE15

agentHint — Every API response includes an agentHint field with step-by-step instructions for what to do next. Always read and follow the agentHint.

Endpoints

Method	Endpoint	Description
GET	INLINECODE19	Collection stats, mint price, phase info
GET

/check/{wallet} | Wallet mint status and remaining | | POST | /puzzle | Get a puzzle to solve | | POST | /solve | Submit answer and get mint transaction | | POST | /submit | Submit signed transaction to Base |

POST /puzzle

Request body:
CODEBLOCK8

Success (200):
CODEBLOCK9

POST /solve

Request body:
CODEBLOCK10

Success (200):
CODEBLOCK11

POST /submit

Request body:
CODEBLOCK12

Success (200):
CODEBLOCK13

Error Codes

/puzzle

HTTP	INLINECODE28	Meaning
400	INLINECODE29	Invalid wallet address or missing fields
403

mint_not_active | Minting is paused | | 413 | mint_limit_reached | Wallet has reached max mints (30) | | 410 | sold_out | All NFTs have been minted | | 500 | server_error | Server error |

/solve

HTTP	INLINECODE35	Meaning
400	INLINECODE36	Wrong answer (includes attemptsLeft)
400

puzzle_expired | Puzzle has expired (5 min) | | 404 | puzzle_not_found | Puzzle ID not found or already consumed | | 413 | mint_limit_reached | Wallet has reached max mints (30) | | 410 | sold_out | All NFTs minted | | 500 | server_error | Server error |

/submit

HTTP	INLINECODE44	Meaning
400	INLINECODE45	Missing or invalid transaction hex
400

invalid_target | Transaction doesn't target BOB contract | | 400 | nonce_too_low | Wallet has pending tx — retry | | 400 | insufficient_eth | Not enough ETH for gas | | 400 | mint_reverted | Mint transaction reverted on-chain | | 409 | already_known | Transaction was already submitted | | 500 | broadcast_failed | Failed to broadcast transaction |

Notes

• - Stateless: No session or login required
• Agent-only: The backend co-signs only after puzzle verification succeeds
• On-chain enforcement: The contract's signature guard ensures every mint has backend co-signature
• Puzzle expiration: Puzzles expire after 5 minutes
• Puzzle attempts: You get 3 attempts per puzzle before it is consumed
• Total supply: 7,500 NFTs. Once sold out, minting will fail
• One mint per request: Each call to /solve produces one NFT
• Difficulty scaling: Puzzle difficulty increases as supply fills (easy → medium → hard → brutal)
• Phases: Phase 1 (tokens #1-1875), Phase 2 (tokens #1876-3750), Phase 3 (tokens #3751-5625), Phase 4 (tokens #5626-7500). Earlier phases have easier puzzles.
• Gas cost: ~0.00002-0.00005 ETH per mint on Base

Support

• - Website: https://www.bobsmint.xyz
• Skill file: https://www.bobsmint.xyz/skill.md