Install the Mint Manager SDK

Install the required packages, depending on your package manager:

npm
Yarn
pnpm

npm install @thenamespace/mint-manager@2.0.0 viem

yarn add @thenamespace/mint-manager@2.0.0 viem

pnpm add @thenamespace/mint-manager@2.0.0 viem

viem is a peer dependency. Installing it yourself keeps a single copy in your dependency tree, which matters because the SDK type-checks errors returned by viem. Create a Mint Manager client. The default configuration uses production services and mainnet listings:

import { createMintClient } from '@thenamespace/mint-manager';

export const mintClient = createMintClient({
  mintSource: 'my-app',
});

For testnet listings and staging services, set isTestnet: true. The flag switches the listing source (Sepolia) and the API environment together, so a price quote can never come from a different network than the transaction that follows it:

export const mintClient = createMintClient({ isTestnet: true });

Listings are per network. A name listed on mainnet is invisible to a client created with isTestnet: true, and looking one up throws LISTING_NOT_FOUND.

Supply your own RPC endpoints

The SDK reads the ENS registry to confirm availability. Its default endpoints are shared and rate limited, so pass your own for anything user facing. Keys are numeric chain IDs:

export const mintClient = createMintClient({
  customRpcUrls: {
    1: process.env.MAINNET_RPC_URL,
    8453: process.env.BASE_RPC_URL,
    10: process.env.OPTIMISM_RPC_URL,
  },
});

MintClientConfig

Parameter	Default	Description
`isTestnet`	`false`	Uses Sepolia listings and staging services when `true`.
`customRpcUrls`	`{}`	RPC endpoints keyed by numeric chain ID. Strongly recommended.
`mintSource`	`namespace-sdk`	Identifies your integration in the mint transaction.
`listingCacheMilliseconds`	15 minutes	Controls how long listing metadata remains cached.
`timeoutMilliseconds`	`30000`	HTTP timeout for the listing and mint APIs.
`logger`	silent	Receives SDK diagnostics. The SDK logs nothing unless you pass one.
`listManagerUri`	Namespace service	Advanced override for the listing API base URL. Must use `https`.
`mintManagerUri`	Namespace service	Advanced override for the mint API base URL. Must use `https`.

logger takes any object with debug, info, warn, and error methods that accept a string.

Supported networks

Network	Chain ID	Mint path
Ethereum Mainnet	1	L1
Sepolia	11155111	L1 testnet
Base	8453	L2
Base Sepolia	84532	L2 testnet
Optimism	10	L2

The SDK resolves the parent name’s listing and selects the L1 or L2 path for you, so you pass names rather than chain IDs.

Start building

How to guides

Starter kits

Concepts

Reference

AI tooling

Troubleshooting

Install the Mint Manager SDK

Supply your own RPC endpoints

MintClientConfig

Supported networks

Next steps

Check a name

Transaction parameters

​Supply your own RPC endpoints

​MintClientConfig

​Supported networks

​Next steps

Check a name

Transaction parameters

Supply your own RPC endpoints

MintClientConfig

Supported networks

Next steps