What is Mint Club V2?

Mint Club V2 is a permissionless bonding curve protocol. Launch tokens backed by any reserve asset (HUNT, ETH, USDC, …) with automated pricing — no liquidity pool required. The protocol handles minting, burning, and price discovery through audited smart contracts.

This SDK is the canonical TypeScript client for the protocol. Use it from Node.js, browsers, or any JavaScript runtime.

→ Full docs: sdk.mint.club

Install

npm install mint.club-v2-sdk
# or
yarn add mint.club-v2-sdk
# or
bun add mint.club-v2-sdk

Quick Start

import { mintclub } from 'mint.club-v2-sdk';

// Read: token details
const detail = await mintclub.network('base').token('SIGNET').getDetail();
console.log(detail.priceForNextMint, detail.info.currentSupply);

// Read: USD price (with 1inch / DEX fallback)
const usd = await mintclub.network('base').token('HUNT').getUsdRate();

// Write: buy on the bonding curve (browser / wagmi)
await mintclub
  .network('base')
  .token('SIGNET')
  .buy({
    amount: 100n,                 // tokens to mint
    slippage: 1,                  // %
    onSuccess: (tx) => console.log(tx),
    onError: (e) => console.error(e),
  });

// Write: create a new token
await mintclub.network('base').token('MYTOKEN').create({
  name: 'My Token',
  reserveToken: { address: '0x...', decimals: 18 },
  curveData: {
    curveType: 'EXPONENTIAL',
    stepCount: 100,
    maxSupply: 1_000_000,
    initialMintingPrice: 0.0001,
    finalMintingPrice: 0.1,
  },
});

For Node.js / server contexts, use withPrivateKey():

await mintclub
  .withPrivateKey(process.env.PRIVATE_KEY as `0x${string}`)
  .network('base')
  .token('SIGNET')
  .buy({ amount: 100n, slippage: 1 });

Features

| | | |---|---| | 🪙 Bond contract | Buy, sell, create, and read token state | | 🎁 Airdrops | Merkle-tree airdrops with IPFS-backed allowlists | | 🔐 Stake & lock | Stake pools and lockups | | ⚡ Zap | Swap + bond in a single transaction | | 🦄 Uniswap routing | V3/V4 swap helpers via UniversalRouter | | 💵 USD pricing | 1inch spot, DefiLlama, 0x fallbacks | | 📦 IPFS | Upload metadata, logos, and airdrop lists via Filebase | | 🏷️ Metadata | Mint Club token metadata create / update / read |

Supported Networks

Ethereum · Base · BNB Chain · Polygon · Arbitrum · Optimism · Avalanche · Kaia · Cyber · Degen · Ham · Shibarium · Unichain · Zora · HashKey · Ape Chain · Over — plus their testnets.

Running tests

npm install
npm test

Integration tests that require credentials (PRIVATE_KEY, FILEBASE_API_KEY) are auto-skipped when the env var is not set.

Links

| | | |---|---| | 🌐 App | mint.club | | 📖 SDK Docs | sdk.mint.club | | 📖 Protocol Docs | docs.mint.club | | 🔗 Contracts | Steemhunt/mint.club-v2-contract | | 🤖 AI Tools (CLI + MCP) | mint.club-v2-ai | | 💬 Community | OnChat | | 🐦 Twitter | @MintClubPro | | 🏗️ Hunt Town | hunt.town |

License

MIT — built with 🏗️ by Hunt Town