SkillHub

clawphunks

v1.0.0

Mint and trade ClawPhunks NFTs. The first collection designed for AI agents.

Sourced from ClawHub, Authored by jef diesel

Installation

Please help me install the skill `clawphunks` from SkillHub official store. npx skills add jefdiesel/clawphunks

ClawPhunks

10,000 unique left-facing pixel punks with OpenClaw red (#C83232) backgrounds. The first NFT collection designed for AI agents.

Rarity & Value

ClawPhunks mirror the original CryptoPunks rarity. Rare types command significant premiums.

Types (5)

Type Count % Rarity Rank
Alien 9 0.09% ★★★★★
Ape 24 0.24% ★★★★☆
Zombie 88 0.88% ★★★☆☆
Female 3,840 38.4% ★★☆☆☆
Male 6,039 60.39% ★☆☆☆☆

Legendary Aliens (9 total - 0.09%)

The rarest type. Only 9 exist:

Token ID Accessories
#0635 Bandana, Regular Shades
#2890 Cap
#3100 Headband
#3443 Earring, Cowboy Hat
#5822 Bandana
#5905 Do-rag, Small Shades
#6089 Earring, Knitted Cap
#7523 Earring, Knitted Cap, Medical Mask
#7804 Cap Forward, Pipe, Small Shades

Rare Apes (24 total - 0.24%)

Token ID Accessories
#0372 Cap Forward
#1021 Cap, Eye Patch
#2140 Knitted Cap, Small Shades
#2243 Bandana, Nerd Glasses
#2386 Headband, Small Shades
#2460 Bandana, VR
#2491 Cap
#2711 Cap Forward, Earring
#2924 Hoodie
#4156 Bandana
#4178 Do-rag
#4464 Eye Mask, Vape, Do-rag
#5217 Gold Chain, Knitted Cap
#5314 Horned Rim Glasses, Do-rag
#5577 Cowboy Hat
#5795 Police Cap
#6145 Cigarette, Cap, Earring
#6915 Cap, Earring, Eye Patch
#6965 Fedora
#7191 Nerd Glasses, Knitted Cap
#8219 Knitted Cap
#8498 Top Hat, Regular Shades
#9265 Bandana, Big Shades
#9280 3D Glasses, Cowboy Hat

Zombies (88 total - 0.88%)

All 88 Zombie token IDs:

Token ID Accessories
#0117 Messy Hair, Front Beard Dark
#0987 Wild Hair, Horned Rim Glasses
#1119 Shadow Beard, Do-rag, Eye Patch
#1190 Cigarette, Bandana, Handlebars, Earring
#1374 Big Shades, Earring, Mohawk Dark
#1478 Shadow Beard, Wild Hair
#1526 Cap, Gold Chain, Eye Patch
#1658 Stringy Hair
#1748 Front Beard, Frown, Knitted Cap
#1886 Messy Hair, Shadow Beard
#1935 Earring, Shaved Head
#2066 Knitted Cap
#2132 Normal Beard Black, Hoodie, Nerd Glasses
#2249 Bandana, Eye Patch
#2306 Cigarette, Mohawk Thin, Earring
#2329 Peak Spike, Earring
#2338 Mohawk Thin
#2424 Bandana, Frown, Earring
#2484 Wild Hair, Classic Shades
#2560 Front Beard, Earring, Headband, VR
#2566 Messy Hair, Normal Beard
#2681 Clown Eyes Blue, Cap
#2708 Bandana, Earring
#2938 Wild Hair
#2967 Mohawk Thin, Chinstrap
#3211 Goat, Headband
#3328 Cigarette, Messy Hair
#3393 Frown, Crazy Hair
#3489 Stringy Hair, Eye Patch
#3493 Peak Spike, Shadow Beard
#3609 Earring, Do-rag
#3636 Front Beard Dark, Earring, Top Hat
#3831 Vampire Hair, Big Shades, Medical Mask
#4472 Cigarette, Purple Hair
#4513 Beanie, Luxurious Beard, Earring
#4559 Stringy Hair, Earring
#4747 Clown Eyes Blue, Headband
#4830 Wild Hair, Classic Shades, Medical Mask
#4850 Purple Hair
#4874 Cigarette, Messy Hair, Clown Nose, Mustache, Earring (5 acc!)
#5066 Earring, Knitted Cap, Smile
#5234 Big Shades, Earring, Crazy Hair
#5253 Messy Hair, Mole
#5299 Cigarette, Handlebars, Earring, Mohawk Dark
#5312 Luxurious Beard, Knitted Cap
#5336 Police Cap
#5412 Nerd Glasses, Crazy Hair
#5489 Fedora
#5573 Luxurious Beard, Mohawk, 3D Glasses
#5742 Mohawk Dark
#5761 Bandana, Horned Rim Glasses
#5944 Mohawk
#6275 Shadow Beard, Mohawk Dark
#6297 Cigarette, Nerd Glasses, Top Hat
#6304 Crazy Hair, Regular Shades
#6491 Cap Forward, Shadow Beard, Earring
#6515 Cigarette, Wild Hair
#6586 Knitted Cap, Smile
#6649 Front Beard Dark, Crazy Hair
#6704 Cigarette, Earring, Rosy Cheeks
#6784 Cigarette, Bandana, Frown
#7014 Cigarette, Frumpy Hair
#7121 Frumpy Hair, Horned Rim Glasses
#7127 Bandana, Eye Mask, Earring
#7252 Chinstrap, Earring, Crazy Hair
#7337 Normal Beard Black, Peak Spike
#7458 Shadow Beard, Knitted Cap, Regular Shades
#7660 Smile, Do-rag
#7756 Shadow Beard, Horned Rim Glasses, Do-rag
#7914 Normal Beard Black, Knitted Cap
#8127 Headband
#8307 Stringy Hair, Mustache
#8386 Classic Shades, Crazy Hair
#8472 Mohawk Thin, Small Shades
#8531 Stringy Hair, Goat, Regular Shades
#8553 Front Beard Dark
#8780 Frumpy Hair, Shadow Beard
#8857 Wild Hair, 3D Glasses
#8909 Luxurious Beard, Police Cap, Regular Shades
#8957 Frumpy Hair, Luxurious Beard
#9203 Clown Nose, Cap Forward, Goat, Mole
#9368 Hoodie, Earring
#9474 Peak Spike
#9804 Stringy Hair, Shadow Beard, Smile, Small Shades
#9838 Peak Spike, Front Beard Dark, Earring
#9909 Cap
#9955 Shaved Head
#9997 Front Beard, Cap Forward

Rare Accessories (87 unique)

Accessory Count Rarity
Beanie 44 ★★★★★
Choker 48 ★★★★★
Pilot Helmet 54 ★★★★★
Tiara 55 ★★★★★
Orange Side 68 ★★★★☆
Buck Teeth 78 ★★★★☆
Welding Goggles 86 ★★★★☆
Top Hat 115 ★★★☆☆
Cowboy Hat 142 ★★★☆☆
Tassle Hat 178 ★★★☆☆
Fedora 186 ★★★☆☆
Police Cap 203 ★★☆☆☆
Clown Nose 212 ★★☆☆☆
Hoodie 259 ★★☆☆☆
Bandana 481 ★☆☆☆☆
Earring 2,459 Common

Accessory Count Rarity

Phunks with more accessories are rarer: - 7 accessories: ~1 phunk - 6 accessories: ~5 phunks - 5 accessories: ~26 phunks - 4 accessories: ~227 phunks - 3 accessories: ~1,340 phunks - 2 accessories: ~3,254 phunks - 1 accessory: ~3,046 phunks - 0 accessories: ~8 phunks (also rare!)

How It Works

1. Create a Wallet

import { privateKeyToAccount, generatePrivateKey } from 'viem/accounts';
import { createWalletClient, http } from 'viem';
import { mainnet } from 'viem/chains';

const privateKey = generatePrivateKey();
const account = privateKeyToAccount(privateKey);
console.log('Address:', account.address);
// Store privateKey securely!

const walletClient = createWalletClient({
  account,
  chain: mainnet,
  transport: http('https://eth.llamarpc.com'),
});

2. Mint a Phunk

Endpoint: POST https://clawphunks.vercel.app/mint

Payment: $1.99 USDC on Base via x402 protocol

Request:

{
  "recipient": "0xYourWalletAddress"
}

Response:

{
  "success": true,
  "tokenId": 1234,
  "txHash": "0x...",
  "ethscriptionId": "0x...",
  "gasStipendWei": "13333333333333",
  "viewerUrl": "https://ethscriptions.com/ethscriptions/0x...",
  "nextSteps": {
    "trade": "Use escrow contract on L1",
    "list": "depositAndList(ethscriptionId, priceWei)",
    "buy": "buy(ethscriptionId) with msg.value = price"
  }
}

You receive: - A random unminted ClawPhunk as an ethscription on Ethereum L1 - ~$0.03 ETH gas stipend for trading

3. Trade on L1

Escrow Contract: 0x3e67d49716e50a8b1c71b8dEa0e31755305733fd

The escrow contract handles trustless trading using ESIP-2.

List for Sale

  1. Transfer your ethscription to the escrow contract
  2. Call depositAndList(bytes32 ethscriptionId, uint256 priceWei)
import { encodeFunctionData } from 'viem';

// First, send ethscription to escrow (send tx to contract with ethscription data)
// Then list it:
const data = encodeFunctionData({
  abi: ESCROW_ABI,
  functionName: 'depositAndList',
  args: [ethscriptionId, priceWei],
});

await walletClient.sendTransaction({
  to: '0x3e67d49716e50a8b1c71b8dEa0e31755305733fd',
  data,
});

Buy a Listing

// Check listing
const [active, seller, price] = await publicClient.readContract({
  address: '0x3e67d49716e50a8b1c71b8dEa0e31755305733fd',
  abi: ESCROW_ABI,
  functionName: 'getListing',
  args: [ethscriptionId],
});

// Buy it
await walletClient.writeContract({
  address: '0x3e67d49716e50a8b1c71b8dEa0e31755305733fd',
  abi: ESCROW_ABI,
  functionName: 'buy',
  args: [ethscriptionId],
  value: price,
});

Cancel Listing

await walletClient.writeContract({
  address: '0x3e67d49716e50a8b1c71b8dEa0e31755305733fd',
  abi: ESCROW_ABI,
  functionName: 'cancelAndWithdraw',
  args: [ethscriptionId],
});

API Reference

GET /health

Health check.

GET /collection

Returns collection info, mint stats, and agent instructions.

{
  "name": "ClawPhunks",
  "symbol": "CPHUNK",
  "totalSupply": 10000,
  "minted": 0,
  "available": 10000,
  "mintPrice": "1.99",
  "mintCurrency": "USDC",
  "chain": "ethereum",
  "escrowContract": "0x3e67d49716e50a8b1c71b8dEa0e31755305733fd",
  "agentInstructions": { ... }
}

POST /mint

Mint a random phunk. Requires x402 payment ($1.99 USDC on Base).

Escrow Contract ABI

[
  {
    "name": "depositAndList",
    "type": "function",
    "inputs": [
      { "name": "ethscriptionId", "type": "bytes32" },
      { "name": "price", "type": "uint256" }
    ]
  },
  {
    "name": "buy",
    "type": "function",
    "stateMutability": "payable",
    "inputs": [
      { "name": "ethscriptionId", "type": "bytes32" }
    ]
  },
  {
    "name": "cancelAndWithdraw",
    "type": "function",
    "inputs": [
      { "name": "ethscriptionId", "type": "bytes32" }
    ]
  },
  {
    "name": "getListing",
    "type": "function",
    "stateMutability": "view",
    "inputs": [
      { "name": "ethscriptionId", "type": "bytes32" }
    ],
    "outputs": [
      { "name": "active", "type": "bool" },
      { "name": "seller", "type": "address" },
      { "name": "price", "type": "uint256" }
    ]
  },
  {
    "name": "updatePrice",
    "type": "function",
    "inputs": [
      { "name": "ethscriptionId", "type": "bytes32" },
      { "name": "newPrice", "type": "uint256" }
    ]
  }
]

Traits

Each ClawPhunk has embedded traits in the ethscription metadata:

{
  "attributes": [
    { "trait_type": "Type", "value": "Female" },
    { "trait_type": "Accessory", "value": "Mohawk" },
    { "trait_type": "Accessory", "value": "3D Glasses" },
    { "trait_type": "Accessory", "value": "Earring" }
  ]
}
  • Marketplace: https://clawphunks.vercel.app
  • Skills/Docs: https://clawphunks.vercel.app/skills
  • Mint API: https://clawphunks.vercel.app
  • Escrow Contract: https://etherscan.io/address/0x3e67d49716e50a8b1c71b8dEa0e31755305733fd
  • Collection: https://ethscriptions.com/collections/0xb432d8c446afefb98651e05c8eee22a8617bd7a0b239dfab70e1fb3a02aa9e8a

x402 Payment

ClawPhunks uses the x402 protocol for payments:

  1. Call /mint without payment → get 402 Payment Required with payment details
  2. Pay $1.99 USDC on Base
  3. Retry with payment proof in header
  4. Receive your phunk

If using Coinbase AgentKit, x402 is handled automatically.