Creating a minting bot

The SDK can be used on the server side, enabling use cases such as running a minting bot

Example Scripts

Two ready-to-run bots live in the repository:

• Edition: examples/edition/minting-bot

• Blind Mint: examples/blindmint/minting-bot

Each script demonstrates the most direct path to minting—preparePurchase followed by product.purchase()—so you don’t have to orchestrate transaction steps manually.

Running an example

1. From the repository root:

   pnpm install
   pnpm build

2. Inside the example directory:

   pnpm install
   cp .env.example .env
   pnpm start

3. Fill in the environment variables before running.

Basic Example

import {
  createClient,
  createAccountEthers5,
  createPublicProviderEthers5,
  isBlindMintProduct,
  isEditionProduct,
} from '@manifoldxyz/client-sdk';
import { ethers } from 'ethers';

// Setup provider for the network
const provider = new ethers.providers.JsonRpcProvider(process.env.RPC_URL!);
const networkId = Number(process.env.NETWORK_ID!); // e.g., 1 for mainnet, 8453 for Base

// Create public provider for the client
const publicProvider = createPublicProviderEthers5({
  [networkId]: provider
});

// Initialize the client
const client = createClient({ publicProvider });

const product = await client.getProduct('INSTANCE_ID');

// Check product status first
const productStatus = await product.getStatus();
if (productStatus !== 'active') {
  throw new Error(`Product is ${productStatus}`);
}

// Handle different product types
if (!isEditionProduct(product)) {
   throw new Error('Unsupported product type');
}

// Setup wallet for signing transactions
const wallet = new ethers.Wallet(process.env.WALLET_PRIVATE_KEY!, provider);
const account = createAccountEthers5({ wallet });

try {
  const prepared = await product.preparePurchase({
    recipientAddress: wallet.address,
    payload: { quantity: 1 },
  });

  const order = await product.purchase({
    account,
    preparedPurchase: prepared,
  });
  console.log(
    order.status,
    order.receipts.map((r) => r.txHash),
  );
} catch (error) {
  console.log(`Unable to execute transaction: ${(error as Error).message}`);
}

Best Practices

• Type Validation: Use isBlindMintProduct or isEditionProduct for proper TypeScript typings

• Status Checks: Always run getStatus before attempting purchases

• Error Handling: Properly handle ClientSDKError codes

• Gas Management: Monitor gas prices and set appropriate limits

• Retry Logic: Implement retry mechanisms for transient failures

• Security: Never commit private keys, use environment variables

Environment Configuration

# Required
WALLET_PRIVATE_KEY=your_private_key_here
INSTANCE_ID=your_product_instance_id
NETWORK_ID=8453
RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY

# RPC Endpoints

# Optional
MINT_QUANTITY=1

Resources

• Edition Minting Bot - Minimal Edition minting script

• Blind Minting Bot - Minimal Blind Mint minting script

• Examples Overview - Directory of all SDK examples

• See method documentation for detailed error descriptions