Platypus PFP — Agent Mint Guide

If you just want the runnable shape, here it is. Full detail follows.

// ===== TL;DR — three steps, no browser required =====

// STEP 1 — Send user's image OR X handle to our backend.
//          Our backend does ALL the image work: if you give an X
//          handle, it fetches the avatar and transforms it into a
//          platypus PFP automatically. You get back metadataURL.
const prep = await fetch('https://platypus.community/api/nft/prepare', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    // OPTION A — user uploaded an image (you convert to base64):
    dataUrl: 'data:image/png;base64,iVBOR...',
    minter:  '<EOA that will sign the mint tx>',
    source:  'upload',
    // OPTION B — user gave you an X handle (no @):
    // dataUrl:  <omitted>
    // source:   'x',
    // sourceHandle: 'twitter_handle',
  }),
});
const { metadataURL, backendGenerated } = await prep.json();
//   backendGenerated === true means the backend did the transformation.

// STEP 2 — Approve PLATYPUS (skip if allowance ≥ 50000 * 1e18)
await wallet.writeContract({
  address: '0x4c87B69F0d862cD66b84f7beF639180980b8aE67',
  abi: ERC20_ABI,
  functionName: 'approve',
  args: ['0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193', 50000000000000000000000n],
});

// STEP 3 — Mint
const txHash = await wallet.writeContract({
  address: '0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193',
  abi: PLATYPUS_PFP_ABI,
  functionName: 'mint',
  args: [metadataURL],
});

// STEP 4 — Wait for receipt, decode the Minted event for the canonical tokenId.
// STEP 5 — Send the user the URLs from the 'Post-mint reporting' section.

The 3 must-haves before you start: the user's image (or X handle), an EOA that can sign, and ≥ 50,000 PLATYPUS + ~0.001 ETH in that wallet. If any is missing, ask the user — don't fabricate.

You need all three before you start:

Three steps, two on-chain transactions, one HTTP call. The wallet that signs the txs in steps 2 and 3 must own the 50,000 PLATYPUS and ≥ ~0.001 ETH.

POST https://platypus.community/api/nft/prepare
Content-Type: application/json

// OPTION A -- user uploaded an image (you convert to base64):
{
  "dataUrl":  "data:image/png;base64,iVBOR...",         // required (OPTION A) OR omit if OPTION B
  "minter":   "0xUSER_OR_AGENT_WALLET_ADDRESS",        // REQUIRED (EOA that signs mint)
  "source":   "upload"                                 // "upload" | "x" | "agent"
}

// OPTION B -- user gave you their X/Twitter handle:
//   Our backend fetches the avatar and transforms it into
//   a platypus PFP automatically. You do NOT call generate.
{
  // dataUrl:  <omitted>,                              // omit -- let backend handle it
  "minter":         "0xUSER_OR_AGENT_WALLET_ADDRESS",  // REQUIRED
  "source":         "x",                               // "x" = use X handle below
  "sourceHandle":   "twitter_handle_no_at"             // REQUIRED when source is "x"
}

// At least ONE of {dataUrl, (source=x + sourceHandle)} is required.
// The backend owns the full pipeline -- you do not call /api/pfp/generate.

HTTP 201 Created

{
  "metadataURL":      "https://ztqrfdmtillsqvghoxyd.supabase.co/.../metadata/<uuid>.json",
  "imageURL":         "https://ztqrfdmtillsqvghoxyd.supabase.co/.../images/<uuid>.png",
  "backendGenerated": true,                            // true if we transformed an X avatar
  "metadata":         { "name": "Platypus PFP #N", "image": "...", "attributes": [...] }
}

// EOA signs one ERC-20 approve on the PLATYPUS token contract
address   = 0x4c87B69F0d862cD66b84f7beF639180980b8aE67  (PLATYPUS, 18 decimals)
function  = approve(address spender, uint256 amount)
args[0]   = 0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193  // spender = PlatypusPFP
args[1]   = 50000000000000000000000  // 10_000 * 1e18

// skip if allowance(platypusPfpContract) >= 10_000 * 1e18 already

// EOA signs mint(string) on the PlatypusPFP contract
address   = 0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193
function  = mint(string tokenURI)
args[0]   = <metadataURL from step 1>
returns   = uint256 tokenId (canonical — use this, never a predicted value)

// After the tx confirms, parse the receipt logs for:
event Minted(address indexed minter, uint256 indexed tokenId, string tokenURI)

When something goes wrong, find the row that matches and follow the action. Don't retry blindly — most errors won't resolve on their own.

After a successful mint you MUST report to the user with on-chain proof. Don't just say "done" — the user wants to see the NFT.

Pull these from the receipt / event log:

• tokenId — from the Minted event
• txHash — returned by writeContract

URLs to send (replace placeholders):

• Transaction
  https://robinhoodchain.blockscout.com/tx/<txHash>
  Mint tx on Blockscout
• NFT instance
  https://robinhoodchain.blockscout.com/token/0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193/instance/<tokenId>
  The minted NFT's page (Blockscout)
• Smart contract
  https://robinhoodchain.blockscout.com/address/0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193
  The PlatypusPFP contract page
• Collection
  https://opensea.io/collection/platypus-pfp-756823947
  OpenSea (may take 1-2h to index after first mint)
• Your PFPs
  https://platypus.community/platypuspfp
  Community site — connect the same wallet to see this NFT

Message template (replace placeholders):

✅ Mint successful! Your Platypus PFP is on Robinhood Chain.

Token ID: #<tokenId>
Tx: <txHash>

🔗 Links:
  • Tx:           https://robinhoodchain.blockscout.com/tx/<txHash>
  • NFT:          https://robinhoodchain.blockscout.com/token/0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193/instance/<tokenId>
  • Contract:     https://robinhoodchain.blockscout.com/address/0x2AD8CBf0d5b43Eef4D4B33ff0d3E8F355DfDE193
  • Collection:   https://opensea.io/collection/platypus-pfp-756823947
  • Your NFTs:    https://platypus.community/platypuspfp

Chain

Contracts

Constants

Minimal ABI

The two ABIs you need to call the contracts.

{
  "ERC20": [
    {
      "type": "function",
      "name": "name",
      "inputs": [],
      "outputs": [
        {
          "type": "string"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "symbol",
      "inputs": [],
      "outputs": [
        {
          "type": "string"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "decimals",
      "inputs": [],
      "outputs": [
        {
          "type": "uint8"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "balanceOf",
      "inputs": [
        {
          "type": "address"
        }
      ],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "allowance",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "address"
        }
      ],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "approve",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "transfer",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ],
      "stateMutability": "nonpayable"
    }
  ],
  "PlatypusPFP": [
    {
      "type": "function",
      "name": "totalMinted",
      "inputs": [],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "MAX_SUPPLY",
      "inputs": [],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "MINT_PRICE",
      "inputs": [],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "hasMinted",
      "inputs": [
        {
          "type": "address"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "platypus",
      "inputs": [],
      "outputs": [
        {
          "type": "address"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "treasury",
      "inputs": [],
      "outputs": [
        {
          "type": "address"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "paused",
      "inputs": [],
      "outputs": [
        {
          "type": "bool"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "owner",
      "inputs": [],
      "outputs": [
        {
          "type": "address"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "tokenURI",
      "inputs": [
        {
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "string"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "balanceOf",
      "inputs": [
        {
          "type": "address"
        }
      ],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "mint",
      "inputs": [
        {
          "type": "string"
        }
      ],
      "outputs": [
        {
          "type": "uint256"
        }
      ],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "approve",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "uint256"
        }
      ],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "setApprovalForAll",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "bool"
        }
      ],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "getApproved",
      "inputs": [
        {
          "type": "uint256"
        }
      ],
      "outputs": [
        {
          "type": "address"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "isApprovedForAll",
      "inputs": [
        {
          "type": "address"
        },
        {
          "type": "address"
        }
      ],
      "outputs": [
        {
          "type": "bool"
        }
      ],
      "stateMutability": "view"
    },
    {
      "type": "function",
      "name": "setTreasury",
      "inputs": [
        {
          "type": "address"
        }
      ],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "withdrawPlatypus",
      "inputs": [],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "pause",
      "inputs": [],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "function",
      "name": "unpause",
      "inputs": [],
      "outputs": [],
      "stateMutability": "nonpayable"
    },
    {
      "type": "event",
      "name": "Minted",
      "inputs": [
        {
          "name": "minter",
          "type": "address",
          "indexed": true
        },
        {
          "name": "tokenId",
          "type": "uint256",
          "indexed": true
        },
        {
          "name": "tokenURI",
          "type": "string",
          "indexed": false
        }
      ],
      "anonymous": false
    },
    {
      "type": "event",
      "name": "Transfer",
      "inputs": [
        {
          "name": "from",
          "type": "address",
          "indexed": true
        },
        {
          "name": "to",
          "type": "address",
          "indexed": true
        },
        {
          "name": "tokenId",
          "type": "uint256",
          "indexed": true
        }
      ],
      "anonymous": false
    }
  ]
}

Rate limits

Server-side protections. Exceed them and you'll get HTTP 429 with a retryAfter field.

• POST /api/nft/prepare: no rate limit
• POST /api/pfp/generate: 5/IP/10min (we do not use this in agent flow; only the mint UI uses it)
• GET /api/nft/collection, /api/nft/owned: standard

Same content, machine-readable:

• /api/agent/spec — full JSON spec
• /.well-known/agent.json — framework discovery (MCP, AutoGPT, LangChain)
• /llms.txt — LLM convention summary
• /skills/platypus-mint.md — LLM skill markdown