manifold-nft-minting

name

manifold-nft-minting

description

Build NFT minting experiences with Manifold's client-sdk. Guides agents through campaign setup, custom minting websites (React/Next.js), minting bots (Node.js), and SDK integration into existing projects. Supports [`Edition`](https://docs.manifold.xyz/client-sdk/sdk/product/edition-product) and [`Blind Mint`](https://docs.manifold.xyz/client-sdk/sdk/product/blind-mint) products across Ethereum, Base, Optimism, Shape, Sepolia, and ApeChain. Use when building minting pages, mint bots, integrating Manifold NFT products, or helping users set up Manifold campaigns. NOT for deploying smart contracts, managing Manifold Studio settings, or non-minting blockchain operations.

Manifold NFT Minting Skill

Build custom NFT minting experiences using @manifoldxyz/client-sdk.

References

Load lazily — only when the current step needs them. Never load all at once.

Reference	When to Load
getting-started.md	First SDK setup in any project
product-types.md	Working with Edition vs BlindMint products
purchase-flow.md	Implementing preparePurchase → purchase
transaction-steps.md	Multi-step transactions, ERC-20 approvals
adapters.md	Setting up wallet + provider adapters (ethers5/viem/wagmi)
product-data.md	Querying status, allocations, inventory, rules
error-handling.md	Error codes, pitfalls — always load before writing purchase code
networks.md	Multi-chain setup or non-mainnet deployments
react-minting-app.md	Building a React/Next.js minting page
rainbowkit-setup.md	RainbowKit installation, wagmi config, ConnectButton, providers
rpc-setup-guide.md	Setting up an RPC provider (Alchemy/Infura/QuickNode)
minting-bot.md	Building a headless minting bot
studio-setup-guide.md	User needs to create a Manifold campaign first
full-docs.md	Fallback only — 128KB complete SDK docs with TOC for grep

Workflow

Follow in order. Ask questions — don't assume.

Step 1: Check if they have a Manifold campaign

Ask: "Do you already have a Manifold product/campaign deployed with an instance ID?"

• No → Read references/studio-setup-guide.md. Guide them through product type selection and Studio setup. Return when they have an instance ID.
• Yes → Continue.

Step 2: Determine project context

Ask: "Do you have an existing project to add minting to, or building from scratch?"

Existing project:

1. Ask their framework
2. Ask if they already have a wallet connection library set up (e.g., RainbowKit, Web3Modal, ConnectKit, custom)
   • Yes, already set up → Ask which library they use. Read references/getting-started.md + references/adapters.md. Match adapter setup to their stack — integrate, don't scaffold.
   • No wallet connection yet → Proceed to Step 2a
3. Proceed to Step 2b (RPC setup)

From scratch:

1. Ask what they're building:
   • Web minting page → Proceed to Step 2a (Wallet Connection), then Step 2b (RPC Setup)
   • Server-side bot → Read references/minting-bot.md. Proceed to Step 2b (RPC Setup)
   • Data query script → Read references/getting-started.md only. Proceed to Step 2b (RPC Setup)

Step 2a: Wallet connection (web apps only)

Ask: "Would you like to use RainbowKit for wallet connection? It's the most common choice for React/Next.js minting apps."

RainbowKit (yes):

1. Read references/rainbowkit-setup.md + references/react-minting-app.md + references/getting-started.md + references/networks.md + references/adapters.md
2. Follow RainbowKit's setup patterns for wagmi config, providers, and <ConnectButton />

Other library (no):

1. Ask: "Which wallet connection library would you like to use?" (e.g., Web3Modal, ConnectKit, Dynamic, Privy, custom)
2. Ask the user to describe their library's provider/config pattern, then adapt the SDK integration accordingly.
3. Read references/getting-started.md + references/networks.md + references/adapters.md
4. Adapt the SDK integration to work with their chosen wallet library instead of RainbowKit

Step 2b: RPC node setup

Ask: "Do you have an RPC node URL you can provide (e.g., from Alchemy, Infura, QuickNode)?"

Yes → Store the RPC URL in a .env file and reference via process.env.* in configuration. Ensure .gitignore includes .env. Proceed to Step 3.

No, but willing to set one up → Read references/rpc-setup-guide.md and guide them through creating an Alchemy account and getting an RPC endpoint. Proceed to Step 3.

No, skip (use public RPC) → Use viem's built-in public transport. In code, use http() with no URL argument:

import { http } from 'viem';
// Public RPC — no URL needed
transport: http()

Note: Public RPCs have rate limits and may be slower. Recommend upgrading to a dedicated RPC for production apps.

Proceed to Step 3.

Step 3: Implement product interaction

1. Read references/product-types.md — use type guards (isEditionProduct, isBlindMintProduct)
2. Read references/product-data.md — status, allocations, metadata display
3. Read references/purchase-flow.md — two-step prepare → purchase
4. If ERC-20 pricing → also read references/transaction-steps.md

Step 4: Error handling

Always before finalizing:

1. Read references/error-handling.md — ClientSDKError handling + common pitfalls
2. If multi-chain → read references/networks.md

Rules

• When using RainbowKit, ALWAYS install wagmi@^2.9.0 — NEVER run npm install wagmi without the version pin. The correct command is npm install wagmi@^2.9.0 (or yarn add wagmi@^2.9.0 / pnpm add wagmi@^2.9.0). Running npm install wagmi or npm install wagmi@latest will install wagmi 3.x, which is incompatible with RainbowKit and will cause build/runtime errors. This is the #1 mistake agents make — always include the @^2.9.0 version specifier.
• Always use environment variables for RPC URLs and private keys — generate .env files for secrets and ensure .gitignore includes .env. Never inline credentials in source code. Reference values via process.env.* (e.g., process.env.RPC_URL!, process.env.WALLET_PRIVATE_KEY!).
• Always display cost and confirm before executing transactions. Before calling purchase() or step.execute(), display the total cost (prepared.cost.total.native.formatted), network, and quantity to the user and ask for explicit confirmation.
• Prefer viem over ethers for new projects. Only use ethers v5 if the user explicitly requests it or has an existing ethers codebase.
• Never fabricate SDK method signatures or field names. Verify against references.
• Always confirm wallet connection choice before scaffolding a web minting app. Never assume RainbowKit.
• Always read wallet library docs before writing integration code — read references/rainbowkit-setup.md for RainbowKit, or ask the user to describe their library's config pattern for other libraries.
• Always use type guards before accessing product-specific methods.
• Always check getStatus() before purchases.
• Use preparePurchase → purchase for simple flows. Manual step.execute() only for granular UI control.
• Never hardcode chain IDs — use configuration.
• Never commit private keys — use environment variables.
• Verify code against official docs at docs.manifold.xyz/client-sdk.
• For issues beyond SDK scope → Manifold Help or Forum.