mint-day 0.3.3 → 0.4.2

package/site/index.html

@@ -374,12 +374,18 @@
     <!-- ── Hero ── -->
     <section class="hero">
       <h1>Free <span class="green">NFT minting</span> for agents. On Base.</h1>
-      <p class="subtitle">No wallet. No gas. No code. Tell your agent what to mint and it lands on-chain in seconds. Identity, credentials, proof of work. <strong>Works for humans too.</strong></p>
-      <div class="install-row hero-install">
-        <div class="npx-block" style="cursor:pointer;" onclick="copyNpx(this)" title="Copy">
-          <code><span class="prompt">$</span> npx mint-day</code>
-          <svg id="npx-copy-icon" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="color:var(--text-dim);margin-left:4px;vertical-align:-1px;flex-shrink:0"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>
+      <p class="subtitle">No wallet. No gas. No code. Describe what to mint — identity, credentials, art — and it lands on Base in seconds. <strong>Works for humans too.</strong></p>
+      <div style="margin-top:32px;margin-bottom:24px;font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--text-secondary);display:flex;flex-direction:column;gap:12px;">
+        <div style="display:flex;align-items:center;gap:12px;">
+          <span style="width:20px;height:20px;border-radius:50%;background:var(--surface-raised);border:1px solid var(--border-bright);display:inline-flex;align-items:center;justify-content:center;font-size:11px;color:var(--text-dim);flex-shrink:0;">1</span>
+          <span>Add mint.day to your agent</span>
+        </div>
+        <div style="display:flex;align-items:center;gap:12px;">
+          <span style="width:20px;height:20px;border-radius:50%;background:var(--surface-raised);border:1px solid var(--border-bright);display:inline-flex;align-items:center;justify-content:center;font-size:11px;color:var(--text-dim);flex-shrink:0;">2</span>
+          <span>Tell it what to mint — it lands on Base</span>
         </div>
+      </div>
+      <div class="install-row hero-install">
         <button class="copy-setup-btn" onclick="copySetup(this)"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-2px;margin-right:6px"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>Copy setup for your agent</button>
         <a href="https://github.com/jordanlyall/mintday" target="_blank" class="github-btn"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z"/></svg>Docs & Source</a>
       </div>
@@ -479,6 +485,29 @@
       </div>
     </section>
 
+    <!-- ── Protocols ── -->
+    <section class="usecases" style="margin-top:64px;">
+      <div class="section-label">Two protocols, one tool</div>
+      <div class="usecase-grid" style="grid-template-columns:1fr 1fr;">
+        <div class="usecase">
+          <div style="font-family:'JetBrains Mono',monospace;font-size:13px;font-weight:600;color:var(--text);margin-bottom:8px;">mint.day</div>
+          <div class="usecase-scenario">Gas-sponsored minting on the MintFactory contract. Free, zero config. Best for identity, credentials, attestations, and utility tokens.</div>
+          <div style="margin-top:12px;font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--text-dim);">
+            <div>platform: <span style="color:var(--green);">"mintday"</span> <span style="opacity:0.5;">(default)</span></div>
+            <div style="margin-top:4px;">gas: sponsored</div>
+          </div>
+        </div>
+        <div class="usecase">
+          <div style="font-family:'JetBrains Mono',monospace;font-size:13px;font-weight:600;color:var(--text);margin-bottom:8px;">Rare Protocol <span style="font-weight:400;color:var(--text-dim);font-size:11px;">(SuperRare)</span></div>
+          <div class="usecase-scenario">Mint on Rare Protocol ERC-721 contracts on Base. Permissionless. Best for art, collectibles, and visual tokens that belong on SuperRare.</div>
+          <div style="margin-top:12px;font-family:'JetBrains Mono',monospace;font-size:11px;color:var(--text-dim);">
+            <div>platform: <span style="color:var(--green);">"superrare"</span></div>
+            <div style="margin-top:4px;">gas: bring your own key</div>
+          </div>
+        </div>
+      </div>
+    </section>
+
     <!-- ── FAQ ── -->
     <section class="faq" id="faq">
       <div class="section-label">FAQ</div>
@@ -507,8 +536,12 @@
         <div class="faq-a">Yes. Pass an image URL or a local file path. Local files are auto-uploaded and pinned. PFPs, art, screenshots, generated visuals. If your agent can see it, it can mint it.</div>
       </div>
       <div class="faq-item">
-        <div class="faq-q">Where is the contract?</div>
-        <div class="faq-a"><a href="https://basescan.org/address/0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c" target="_blank">0x12a1c11a...7f2c</a> on Base. Permissionless. Anyone can call <code>mint()</code> directly without the MCP server.</div>
+        <div class="faq-q">Can I mint on SuperRare / Rare Protocol?</div>
+        <div class="faq-a">Yes. Set <code>platform: "superrare"</code> in your mint call. Tokens mint on Rare Protocol ERC-721 contracts on Base. Requires a private key (no sponsored gas for this path). Set <code>RARE_CONTRACT</code> to your collection address, or deploy one with <code>node scripts/deploy-rare-collection.mjs</code>.</div>
+      </div>
+      <div class="faq-item">
+        <div class="faq-q">Where are the contracts?</div>
+        <div class="faq-a">MintFactory: <a href="https://basescan.org/address/0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c" target="_blank">0x12a1...7f2c</a>. Rare Protocol collection: <a href="https://basescan.org/address/0x99Eee317921a9f12176eED25b0aE1D7eb164AE34" target="_blank">0x99Ee...AE34</a>. Both on Base mainnet.</div>
       </div>
     </section>
 

package/src/index.ts

@@ -14,11 +14,11 @@ import { mintResolveSchema, handleMintResolve } from "./tools/mint-resolve.js";
 dotenv.config();
 
 // Testnet try-it wallet (Base Sepolia, pre-funded)
-const TRYIT_KEY = "REDACTED_RETIRED_KEY";
+const TRYIT_KEY = "";
 const TRYIT_CONTRACT = "0xa52450397f312c256Bd68B202C0CF90387Ea0E67";
 const TRYIT_RPC = "https://sepolia.base.org";
 const TRYIT_CHAIN = 84532;
-const MAINNET_CONTRACT = "0xbf12d372444dcf69df9316d961439f6b5919e8d0";
+const MAINNET_CONTRACT = "0x12a1c11a0b2860f64e7d8df20989f97d40de7f2c";
 const MAINNET_RPC = "https://mainnet.base.org";
 const MAINNET_CHAIN = 8453;
 
@@ -62,12 +62,12 @@ const calldataService = new CalldataService(
 
 const server = new McpServer({
   name: "mint-day",
-  version: "0.3.3",
+  version: "0.4.0",
 });
 
 server.tool(
   "mint",
-  "Create a permanent, verifiable on-chain record on Base. Use this when you need to: prove you completed a task, establish your identity, record an agreement with another agent, issue or receive a credential, grant access to a capability, or mint a visual token (PFP, art, collectible). The token is immutable and publicly verifiable. Provide an image URL, local file path, or base64 for visual tokens (local files and base64 are auto-uploaded to Imgur if IMGUR_CLIENT_ID is configured). Returns a preview with mintId first; call again with mintId to confirm. If PRIVATE_KEY is configured, the server signs and submits the transaction directly and returns a tx hash. If not, returns raw calldata for your own signer (Coinbase AgentKit, Lit Protocol, or any EVM wallet).",
+  "Create a permanent, verifiable on-chain record on Base. Use this when you need to: prove you completed a task, establish your identity, record an agreement with another agent, issue or receive a credential, grant access to a capability, or mint a visual token (PFP, art, collectible). Supports two protocols: 'mintday' (default, gas-sponsored) and 'superrare' (Rare Protocol, requires PRIVATE_KEY). Set platform: 'superrare' to mint on Rare Protocol contracts. The token is immutable and publicly verifiable. Provide an image URL, local file path, or base64 for visual tokens. Returns a preview with mintId first; call again with mintId to confirm.",
   mintSchema,
   async (params) => handleMint(params, calldataService, defaultRecipient, userKey, {
     tryitKey: TRYIT_KEY,

package/src/rare-cli.d.ts

@@ -0,0 +1,37 @@
+declare module "@rareprotocol/rare-cli/client" {
+  import { PublicClient, WalletClient, Address, Hash, TransactionReceipt } from "viem";
+
+  interface RareClientConfig {
+    publicClient: PublicClient;
+    walletClient?: WalletClient;
+    account?: Address;
+  }
+
+  interface TransactionResult {
+    txHash: Hash;
+    receipt: TransactionReceipt;
+  }
+
+  interface DeployErc721Result extends TransactionResult {
+    contract: Address | undefined;
+  }
+
+  interface MintToResult extends TransactionResult {
+    tokenId: bigint | undefined;
+  }
+
+  interface RareClient {
+    deploy: {
+      erc721(params: { name: string; symbol: string; maxTokens?: bigint | number | string }): Promise<DeployErc721Result>;
+    };
+    mint: {
+      mintTo(params: { contract: Address; tokenUri: string; to?: Address; royaltyReceiver?: Address }): Promise<MintToResult>;
+    };
+    media: {
+      upload(buffer: Uint8Array, filename: string): Promise<{ url: string; mimeType: string; size: number }>;
+      pinMetadata(opts: { name: string; description: string; image: { url: string; mimeType: string; size: number } }): Promise<string>;
+    };
+  }
+
+  export function createRareClient(config: RareClientConfig): RareClient;
+}

package/src/services/rare-protocol.ts

@@ -0,0 +1,119 @@
+import { createPublicClient, createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base, baseSepolia } from "viem/chains";
+import { createRareClient } from "@rareprotocol/rare-cli/client";
+import { encodeMetadata } from "./metadata.js";
+import { MintIntent, TOKEN_TYPE_NAMES } from "../types.js";
+
+// Default mint.day collection on Rare Protocol (Base mainnet)
+// Set via RARE_CONTRACT env var, or deploy one with scripts/deploy-rare-collection.ts
+const DEFAULT_RARE_CONTRACT = process.env.RARE_CONTRACT || "";
+
+export interface RareMintResult {
+  status: string;
+  txHash: string;
+  tokenId: string;
+  contract: string;
+  platform: string;
+  tokenType: string;
+  soulbound: boolean;
+  recipient: string;
+  chain: string;
+  explorer: string;
+  tokenUri: string;
+}
+
+export async function mintOnRareProtocol(
+  intent: MintIntent,
+  privateKey: string,
+  isTestnet: boolean = false,
+): Promise<RareMintResult> {
+  const chain = isTestnet ? baseSepolia : base;
+  const contractAddress = DEFAULT_RARE_CONTRACT as `0x${string}`;
+
+  if (!contractAddress) {
+    throw new Error(
+      "RARE_CONTRACT not set. Deploy a collection first: node scripts/deploy-rare-collection.mjs",
+    );
+  }
+
+  const account = privateKeyToAccount(privateKey as `0x${string}`);
+
+  const publicClient = createPublicClient({
+    chain,
+    transport: http(),
+  });
+
+  const walletClient = createWalletClient({
+    account,
+    chain,
+    transport: http(),
+  });
+
+  // Cast clients to satisfy rare-cli's bundled viem types (runtime-compatible)
+  const rare = createRareClient({
+    publicClient: publicClient as any,
+    walletClient: walletClient as any,
+    account: account.address,
+  });
+
+  // Build metadata URI (same format as MintFactory path)
+  const tokenUri = encodeMetadata(intent.metadata);
+
+  // Mint via Rare Protocol
+  const result = await rare.mint.mintTo({
+    contract: contractAddress,
+    tokenUri,
+    to: intent.recipient as `0x${string}`,
+  });
+
+  const explorerBase = isTestnet ? "sepolia.basescan.org" : "basescan.org";
+
+  return {
+    status: "minted",
+    txHash: result.txHash,
+    tokenId: result.tokenId?.toString() || "unknown",
+    contract: contractAddress,
+    platform: "superrare",
+    tokenType: TOKEN_TYPE_NAMES[intent.tokenType],
+    soulbound: intent.soulbound,
+    recipient: intent.recipient,
+    chain: isTestnet ? "Base Sepolia (testnet)" : "Base",
+    explorer: `https://${explorerBase}/tx/${result.txHash}`,
+    tokenUri,
+  };
+}
+
+export async function deployRareCollection(
+  privateKey: string,
+  name: string,
+  symbol: string,
+  isTestnet: boolean = false,
+): Promise<{ contract: string; txHash: string }> {
+  const chain = isTestnet ? baseSepolia : base;
+  const account = privateKeyToAccount(privateKey as `0x${string}`);
+
+  const publicClient = createPublicClient({
+    chain,
+    transport: http(),
+  });
+
+  const walletClient = createWalletClient({
+    account,
+    chain,
+    transport: http(),
+  });
+
+  const rare = createRareClient({
+    publicClient: publicClient as any,
+    walletClient: walletClient as any,
+    account: account.address,
+  });
+
+  const result = await rare.deploy.erc721({ name, symbol });
+
+  return {
+    contract: result.contract || "unknown",
+    txHash: result.txHash,
+  };
+}

package/src/tools/mint.ts

@@ -5,28 +5,29 @@ import { TokenType, MintIntent, TokenMetadata, TOKEN_TYPE_NAMES } from "../types
 import { classifyIntent } from "../services/classifier.js";
 import { CalldataService } from "../services/calldata.js";
 import { resolveImage } from "../services/image-upload.js";
+import { mintOnRareProtocol } from "../services/rare-protocol.js";
 
-// Intent cache: preview mintId -> frozen intent
-const intentCache = new Map<string, { intent: MintIntent; expiresAt: number }>();
+// Intent cache: preview mintId -> frozen intent + platform
+const intentCache = new Map<string, { intent: MintIntent; platform: string; expiresAt: number }>();
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
 
-function cacheMintId(intent: MintIntent): string {
+function cacheMintId(intent: MintIntent, platform: string = "mintday"): string {
   const hash = createHash("sha256")
     .update(JSON.stringify(intent))
     .digest("hex")
     .slice(0, 12);
-  intentCache.set(hash, { intent, expiresAt: Date.now() + CACHE_TTL_MS });
+  intentCache.set(hash, { intent, platform, expiresAt: Date.now() + CACHE_TTL_MS });
   return hash;
 }
 
-function getCachedIntent(mintId: string): MintIntent | null {
+function getCachedEntry(mintId: string): { intent: MintIntent; platform: string } | null {
   const entry = intentCache.get(mintId);
   if (!entry) return null;
   if (Date.now() > entry.expiresAt) {
     intentCache.delete(mintId);
     return null;
   }
-  return entry.intent;
+  return { intent: entry.intent, platform: entry.platform };
 }
 
 export const mintSchema = {
@@ -62,6 +63,10 @@ export const mintSchema = {
     .record(z.string(), z.unknown())
     .optional()
     .describe("Additional key-value metadata. Supports strings, arrays, and objects (e.g. capabilities: ['mint'])."),
+  platform: z
+    .enum(["mintday", "superrare"])
+    .optional()
+    .describe("Which protocol to mint on. 'mintday' uses the MintFactory contract (default). 'superrare' mints via Rare Protocol on Base."),
 };
 
 interface TryitConfig {
@@ -71,7 +76,7 @@ interface TryitConfig {
   tryitChain: number;
 }
 
-const SPONSOR_URL = process.env.SPONSOR_URL || "https://agent-mint-nine.vercel.app/api/sponsor";
+const SPONSOR_URL = process.env.SPONSOR_URL || "https://www.mint.day/api/sponsor";
 
 async function sponsoredMint(result: { to: string; calldata: string; value: string; estimatedGas: number; tokenType: string; soulbound: boolean; chainId: number }, recipient: string): Promise<Record<string, unknown> | null> {
   try {
@@ -105,8 +110,9 @@ async function sponsoredMint(result: { to: string; calldata: string; value: stri
       explorer: data.explorer,
       sponsored: true,
     };
-  } catch {
-    return null;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { error: `Sponsor request failed: ${message}` };
   }
 }
 
@@ -120,23 +126,18 @@ export async function handleMint(
     animation_url?: string;
     mintId?: string;
     metadata?: Record<string, unknown>;
+    platform?: string;
   },
   calldataService: CalldataService,
   defaultRecipient: string,
   userKey: string = "",
   tryit: TryitConfig = { tryitKey: "", tryitContract: "", tryitRpc: "", tryitChain: 84532 },
 ) {
-  // Determine mode:
-  // 1. User has private key: mainnet, sign + submit locally
-  // 2. No key but recipient provided: mainnet, sponsored gas via server
-  // 3. No key, no recipient: testnet try-it mode
-  const hasRecipient = !!params.recipient;
-  const isTestnet = !userKey && !hasRecipient;
-  const privateKey = userKey || (isTestnet ? tryit.tryitKey : "");
   // Confirmation path: replay cached intent
+  // Check cache first so we can use cached recipient for mode detection
   if (params.mintId) {
-    const cached = getCachedIntent(params.mintId);
-    if (!cached) {
+    const entry = getCachedEntry(params.mintId);
+    if (!entry) {
       return {
         content: [{
           type: "text" as const,
@@ -144,8 +145,44 @@ export async function handleMint(
         }],
       };
     }
+    const cached = entry.intent;
+    const cachedPlatform = entry.platform;
     intentCache.delete(params.mintId);
 
+    // Mode detection using cached recipient
+    const hasRecipient = !!cached.recipient;
+    const isTestnet = !userKey && !hasRecipient;
+    const privateKey = userKey || (isTestnet ? tryit.tryitKey : "");
+
+    // Rare Protocol path: mint via SuperRare contracts on Base
+    if (cachedPlatform === "superrare") {
+      if (!privateKey) {
+        return {
+          content: [{
+            type: "text" as const,
+            text: JSON.stringify({ error: "SuperRare minting requires a private key. Save one to ~/.mint-day/credentials." }, null, 2),
+          }],
+        };
+      }
+      try {
+        const rareResult = await mintOnRareProtocol(cached, privateKey, isTestnet);
+        return {
+          content: [{
+            type: "text" as const,
+            text: JSON.stringify(rareResult, null, 2),
+          }],
+        };
+      } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          content: [{
+            type: "text" as const,
+            text: JSON.stringify({ error: `SuperRare mint failed: ${message}` }, null, 2),
+          }],
+        };
+      }
+    }
+
     // Use testnet calldataService if in try-it mode
     let activeCalldataService = calldataService;
     if (isTestnet) {
@@ -255,6 +292,8 @@ export async function handleMint(
   }
 
   const recipient = params.recipient || defaultRecipient;
+  const hasRecipient = !!recipient;
+  const isTestnet = !userKey && !hasRecipient;
 
   if (!recipient) {
     return {
@@ -362,12 +401,14 @@ export async function handleMint(
   }
 
   // Cache intent and return preview
-  const mintId = cacheMintId(intent);
+  const selectedPlatform = params.platform || "mintday";
+  const mintId = cacheMintId(intent, selectedPlatform);
 
   const preview: Record<string, unknown> = {
     status: "preview",
     mintId,
-    message: `I'll mint a ${TOKEN_TYPE_NAMES[intent.tokenType]} token${intent.soulbound ? " (soulbound)" : ""} to ${intent.recipient}.`,
+    platform: selectedPlatform,
+    message: `I'll mint a ${TOKEN_TYPE_NAMES[intent.tokenType]} token${intent.soulbound ? " (soulbound)" : ""} to ${intent.recipient} via ${selectedPlatform === "superrare" ? "Rare Protocol (SuperRare)" : "mint.day"}.`,
     tokenType: TOKEN_TYPE_NAMES[intent.tokenType],
     soulbound: intent.soulbound,
     recipient: intent.recipient,

package/vercel.json

@@ -1,4 +1,5 @@
 {
   "buildCommand": "",
-  "outputDirectory": "."
+  "outputDirectory": "site",
+  "cleanUrls": true
 }