mint-day 0.3.0 → 0.3.2

package/README.md

@@ -1,10 +1,58 @@
-# mint.day
+<div align="center">
+  <img src="site/assets/logo.png" alt="mint.day" width="80" />
+  <h1>mint.day</h1>
+  <p><strong>Free NFT minting for agents. On Base.</strong></p>
+  <p>Tell your agent what to mint. It lands on-chain in seconds.<br/>No wallet. No gas. No code.</p>
 
-Agents mint NFTs now.
+  [![npm](https://img.shields.io/npm/v/mint-day?color=2db87a&label=npm)](https://www.npmjs.com/package/mint-day)
+  [![license](https://img.shields.io/badge/license-MIT-2db87a)](LICENSE)
+  [![network](https://img.shields.io/badge/network-Base-0052FF)](https://basescan.org/address/0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c)
+  [![live](https://img.shields.io/badge/live-mint.day-e5a030)](https://mint.day)
+</div>
 
-## Quick start
+---
 
-**1. Install** (zero config)
+<img src="site/assets/screenshot-home.png" alt="mint.day homepage" width="100%" />
+
+## What is mint.day?
+
+mint.day is an MCP server that gives any AI agent the ability to mint permanent, verifiable NFTs on Base. Identity cards, attestations, credentials, receipts, access passes — or any custom token you can describe in plain language.
+
+Gas is sponsored. Wallets are optional. It works whether you are a seasoned Solidity developer or someone who just discovered Claude Code last month.
+
+---
+
+## Get started in 60 seconds
+
+### Option A: You use Claude Code, Cursor, Windsurf, or any MCP client
+
+Copy this prompt and paste it into your AI assistant:
+
+```
+Install mint.day for me.
+
+mint.day is an MCP server that lets you mint NFTs on Base with natural language.
+Identity, attestations, credentials, receipts, access passes, and visual tokens with images.
+
+Add this MCP config:
+
+{
+  "mcpServers": {
+    "mint-day": {
+      "command": "npx",
+      "args": ["mint-day"]
+    }
+  }
+}
+
+That's it. No API keys. No wallet. Gas is sponsored. Just tell me what to mint.
+```
+
+Your assistant will handle the rest.
+
+### Option B: Add it manually
+
+Drop this into your MCP config file (`~/.cursor/mcp.json`, `claude_desktop_config.json`, etc.):
 
 ```json
 {
@@ -17,56 +65,77 @@ Agents mint NFTs now.
 }
 ```
 
-Works with Claude Code, Cursor, Windsurf, OpenClaw, and any MCP client.
+Restart your AI client. Done.
 
-**2. Mint**
+### Option C: npm package
 
-Tell your agent: "Proof I completed the security audit for 0xABC"
+```bash
+npm install mint-day
+```
 
-**3. Verify**
+```ts
+import { encodeMetadata } from 'mint-day';
 
-```
-mint_check({ address: "0xABC..." })
+const tokenURI = encodeMetadata({
+  name: "Audit complete: Protocol XYZ",
+  tokenType: "Attestation",
+  soulbound: true,
+  recipient: "0xABC..."
+});
 ```
 
-That's it. Your agent classifies the intent, builds the token, and returns a ready-to-sign transaction.
+---
 
-## Signing transactions
+## Try it now
 
-mint.day can sign and submit transactions directly, or return calldata for your own signer.
+Once installed, tell your agent anything like:
 
-### Option A: Built-in signing (recommended)
+> "Proof I shipped the v2 API today"
 
-Save a private key and mint.day handles everything:
+> "Mint me an identity token with my agent name and capabilities"
 
-```bash
-mkdir -p ~/.mint-day
-node -e "const w = require('ethers').Wallet.createRandom(); console.log(w.privateKey); console.error('Address: ' + w.address)"  2>&1 | head -1 > ~/.mint-day/credentials
-chmod 600 ~/.mint-day/credentials
-```
+> "Issue an access pass to 0xABC... for the beta"
 
-Fund the address with a small amount of ETH on Base (gas is < $0.01 per mint). Restart the MCP server.
+> "Receipt for 0.1 ETH paid to 0xDEF... on March 15"
 
-You can also set `PRIVATE_KEY` in your MCP env config instead of using the file.
+Your agent classifies the intent, builds the metadata, and returns a ready-to-sign transaction. Confirm, and it is on-chain.
 
-### Option B: Bring your own signer
+---
 
-Don't set a private key. mint.day returns calldata. Submit it with Coinbase AgentKit, Lit Protocol, Privy, or any EVM wallet.
+## Live feed
 
-## Tools
+<img src="site/assets/screenshot-feed.png" alt="mint.day live feed" width="100%" />
 
-### `mint`
+Browse all minted tokens at [mint.day/feed](https://mint.day/feed).
+
+---
+
+## Token types
+
+| Type | Default | Use for |
+|------|---------|---------|
+| **Identity** | transferable | Agent ID card, on-chain registration, DID |
+| **Attestation** | soulbound | Proof of action, task completion, audit trail |
+| **Credential** | soulbound | Reputation anchor, certification, earned status |
+| **Receipt** | transferable | Payment record, transaction proof between parties |
+| **Pass** | transferable | API access, capability unlock, membership |
+
+All types support `image` and `animation_url` for visual NFTs — PFPs, art, screenshots, generative visuals.
 
-Create a permanent, verifiable on-chain record on Base.
+---
 
-**Natural language:**
+## MCP tools
 
+### `mint`
+
+Create a permanent on-chain record.
+
+**Natural language** (agent classifies intent automatically):
 ```
 mint({ description: "Proof I completed the security audit for 0xABC" })
 ```
 
-**Structured** (skips classification):
-
+**Structured** (skip classification):
 ```
 mint({
   description: "Task completion attestation",
@@ -77,80 +146,105 @@ mint({
 ```
 
 **With an image:**
-
 ```
 mint({
   description: "My agent identity",
   tokenType: "Identity",
-  image: "data:image/png;base64,..."
+  image: "https://..." // or data:image/png;base64,...
 })
 ```
 
-Every mint returns a preview first. Confirm with `mintId` to execute:
+Every mint returns a **preview** first. Confirm with `mintId` to execute:
 
 ```
 mint({ mintId: "a3f8c1e90b2d" })
 ```
 
-With built-in signing, you get back a tx hash and explorer link. Without it, you get calldata.
+---
 
 ### `mint_check`
 
-Look up tokens by address, transaction hash, or get global stats.
+Look up tokens by address, tx hash, or get global stats.
 
 ```
-mint_check({ address: "0xABC..." })
-mint_check({ txHash: "0x230b..." })
-mint_check({})  // global stats
+mint_check({ address: "0xABC..." })    // all tokens for a wallet
+mint_check({ txHash: "0x230b..." })   // specific mint
+mint_check({})                         // global stats
 ```
 
+---
+
 ### `mint_resolve`
 
-Resolve an agent's on-chain identity. Returns their Identity token with ERC-8004 agent card metadata.
+Resolve an agent's on-chain identity. Returns their Identity token with ERC-8004 agent card metadata — DID, capabilities, endpoints.
 
 ```
 mint_resolve({ address: "0xABC..." })
 ```
 
-## Token types
+---
 
-| Type | Default | Use for |
-|------|---------|---------|
-| Identity | transferable | Agent ID card, on-chain registration |
-| Attestation | soulbound | Proof of action, task completion |
-| Credential | soulbound | Reputation anchor, certification |
-| Receipt | transferable | Payment record between two parties |
-| Pass | transferable | API access, capability unlock |
+## Signing transactions
+
+### Option A: Built-in signing (recommended)
+
+Generate a key, fund it with a small amount of ETH on Base (gas is less than $0.01), and mint.day handles signing and submission:
+
+```bash
+mkdir -p ~/.mint-day
+node -e "
+  const w = require('ethers').Wallet.createRandom();
+  console.log(w.privateKey);
+  console.error('Address: ' + w.address);
+" 2>&1 | head -1 > ~/.mint-day/credentials
+chmod 600 ~/.mint-day/credentials
+```
+
+Or set `PRIVATE_KEY` in your MCP env config.
 
-All types support `image` and `animation_url` for visual NFTs (PFPs, art, collectibles).
+### Option B: Bring your own signer
+
+No private key needed. mint.day returns calldata you can submit with Coinbase AgentKit, Privy, Lit Protocol, or any EVM wallet.
+
+---
 
-## Architecture
+## How it works
 
 ```
 Agent -> mint tool -> classifier (Groq Llama) -> metadata builder -> calldata
                                                                         |
-                         [if PRIVATE_KEY] sign + submit -> tx hash <----|
-                         [if no key]      return calldata <-------------|
+               [if PRIVATE_KEY] sign + submit -> tx hash, explorer link |
+               [if no key]      return calldata for your own signer -----|
                                                                         |
-                                                        MintFactory.sol (Base)
+                                               MintFactory.sol on Base mainnet
 ```
 
-## Contracts
-
-- **Base Mainnet**: [`0xbf12d372444dcf69df9316d961439f6b5919e8d0`](https://basescan.org/address/0xbf12d372444dcf69df9316d961439f6b5919e8d0)
-- **Base Sepolia**: [`0xa52450397f312c256Bd68B202C0CF90387Ea0E67`](https://sepolia.basescan.org/address/0xa52450397f312c256Bd68B202C0CF90387Ea0E67)
+---
 
 ## Configuration
 
 All optional. mint.day works with zero config.
 
-| Env var | Default | Purpose |
-|---------|---------|---------|
+| Variable | Default | Purpose |
+|----------|---------|---------|
 | `PRIVATE_KEY` | `~/.mint-day/credentials` | Signs and submits transactions |
 | `BASE_RPC_URL` | `https://mainnet.base.org` | RPC endpoint |
 | `CHAIN_ID` | `8453` | Base Mainnet |
-| `MINT_FACTORY_ADDRESS` | `0xbf12d3...` | Contract address |
-| `CLASSIFY_URL` | hosted endpoint | Intent classifier |
+| `MINT_FACTORY_ADDRESS` | see below | Override contract address |
+| `CLASSIFY_URL` | hosted endpoint | Intent classifier service |
+
+---
+
+## Contracts
+
+| Network | Address |
+|---------|---------|
+| **Base Mainnet** | [`0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c`](https://basescan.org/address/0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c) |
+| **Base Sepolia** | [`0x16e0072Eb4131106e266035E98Cfd07532B88EAa`](https://sepolia.basescan.org/address/0x16e0072Eb4131106e266035E98Cfd07532B88EAa) |
+
+Permissionless. Anyone can call `mint()` directly without the MCP server.
+
+---
 
 ## Development
 
@@ -161,6 +255,16 @@ npm run build   # compile to dist/
 npm start       # run compiled
 ```
 
-## License
+---
+
+## Links
+
+- [mint.day](https://mint.day) — live site
+- [mint.day/feed](https://mint.day/feed) — live feed of all minted tokens
+- [npm](https://www.npmjs.com/package/mint-day) — npm package
+- [OpenSea](https://opensea.io/collection/mintdotday) — collection
+- [X](https://x.com/mintdotday) — @mintdotday
+
+---
 
-MIT
+MIT — built by [@jordanlyall](https://x.com/jordanlyall)

package/dist/services/metadata.js

@@ -1,12 +1,20 @@
-const TYPE_COLORS = {
-    Identity: { bg: "#0c1220", accent: "#60a5fa", text: "#93bbfc" },
-    Attestation: { bg: "#0a1510", accent: "#22c55e", text: "#6ee7a0" },
-    Credential: { bg: "#100c1e", accent: "#a78bfa", text: "#c4b5fd" },
-    Receipt: { bg: "#151008", accent: "#fb923c", text: "#fdba74" },
-    Pass: { bg: "#0a1518", accent: "#22d3ee", text: "#67e8f9" },
+const TYPE_COLORS_DARK = {
+    Identity: { bg: "#0c1220", bgGrad: "#0c1220", accent: "#60a5fa", text: "#93bbfc" },
+    Attestation: { bg: "#0a1510", bgGrad: "#0a1510", accent: "#22c55e", text: "#6ee7a0" },
+    Credential: { bg: "#100c1e", bgGrad: "#100c1e", accent: "#a78bfa", text: "#c4b5fd" },
+    Receipt: { bg: "#151008", bgGrad: "#151008", accent: "#fb923c", text: "#fdba74" },
+    Pass: { bg: "#0a1518", bgGrad: "#0a1518", accent: "#22d3ee", text: "#67e8f9" },
+};
+const TYPE_COLORS_LIGHT = {
+    Identity: { bg: "#eff6ff", bgGrad: "#FFFDF8", accent: "#3b82f6", text: "#1d4ed8" },
+    Attestation: { bg: "#f0faf5", bgGrad: "#FFFDF8", accent: "#2db87a", text: "#1e9e65" },
+    Credential: { bg: "#faf5ff", bgGrad: "#FFFDF8", accent: "#a855f7", text: "#7e22ce" },
+    Receipt: { bg: "#fffbeb", bgGrad: "#FFFDF8", accent: "#e5a030", text: "#b45309" },
+    Pass: { bg: "#ecfeff", bgGrad: "#FFFDF8", accent: "#0891b2", text: "#0e7490" },
 };
 function generateDefaultImage(metadata) {
-    const colors = TYPE_COLORS[metadata.tokenType] || TYPE_COLORS.Attestation;
+    const palette = metadata.theme === "light" ? TYPE_COLORS_LIGHT : TYPE_COLORS_DARK;
+    const colors = palette[metadata.tokenType] || palette.Attestation;
     const name = metadata.name || "mint.day token";
     const tokenType = metadata.tokenType || "Token";
     const soulbound = metadata.soulbound;
@@ -59,8 +67,12 @@ function generateDefaultImage(metadata) {
     const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 400" width="400" height="400">
   <defs>
     ${pattern}
+    <linearGradient id="bg-grad" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="${colors.bgGrad}"/>
+      <stop offset="100%" stop-color="${colors.bg}"/>
+    </linearGradient>
   </defs>
-  <rect width="400" height="400" fill="${colors.bg}"/>
+  <rect width="400" height="400" fill="url(#bg-grad)"/>
   <rect width="400" height="400" fill="url(#${patternId})"/>
 
   <!-- Top accent line -->

package/dist/tools/mint-check.js

@@ -10,7 +10,7 @@ const MINT_FACTORY_ABI = [
 ];
 // Deploy blocks per chain to avoid scanning from genesis
 const DEPLOY_BLOCKS = {
-    8453: 28000000, // Base mainnet (approximate, update after deploy)
+    8453: 43460000, // Base mainnet (MintFactory deploy block)
     84532: 22000000, // Base Sepolia (approximate)
 };
 export const mintCheckSchema = {
@@ -128,7 +128,14 @@ export async function handleMintCheck(params, calldataService, provider, contrac
     const contract = new ethers.Contract(contractAddress, MINT_FACTORY_ABI, provider);
     const fromBlock = DEPLOY_BLOCKS[chainId] || 0;
     const filter = contract.filters.Minted(null, address);
-    const events = await contract.queryFilter(filter, fromBlock, "latest");
+    const latestBlock = await provider.getBlockNumber();
+    const CHUNK_SIZE = 9999;
+    const events = [];
+    for (let start = fromBlock; start <= latestBlock; start += CHUNK_SIZE + 1) {
+        const end = Math.min(start + CHUNK_SIZE, latestBlock);
+        const chunk = await contract.queryFilter(filter, start, end);
+        events.push(...chunk);
+    }
     if (events.length === 0) {
         return {
             content: [{

package/dist/tools/mint-resolve.js

@@ -9,7 +9,7 @@ const MINT_FACTORY_ABI = [
     "function ownerOf(uint256 tokenId) view returns (address)",
 ];
 const DEPLOY_BLOCKS = {
-    8453: 28000000,
+    8453: 43460000,
     84532: 22000000,
 };
 export const mintResolveSchema = {
@@ -42,9 +42,16 @@ export async function handleMintResolve(params, provider, contractAddress, chain
     }
     const contract = new ethers.Contract(contractAddress, MINT_FACTORY_ABI, provider);
     const fromBlock = DEPLOY_BLOCKS[chainId] || 0;
-    // Query all Minted events to this address
+    // Query all Minted events to this address (chunked to avoid RPC limits)
     const filter = contract.filters.Minted(null, address);
-    const events = await contract.queryFilter(filter, fromBlock, "latest");
+    const latestBlock = await provider.getBlockNumber();
+    const CHUNK_SIZE = 9999;
+    const events = [];
+    for (let start = fromBlock; start <= latestBlock; start += CHUNK_SIZE + 1) {
+        const end = Math.min(start + CHUNK_SIZE, latestBlock);
+        const chunk = await contract.queryFilter(filter, start, end);
+        events.push(...chunk);
+    }
     // Find Identity tokens (tokenType === 0)
     let identityEvent = null;
     for (const event of events) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mint-day",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Agent-native minting on Base. One tool call, any token type.",
   "main": "dist/index.js",
   "bin": {