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:

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

Last updated