Rainbow Token Launcher SDK

Launch ERC-20 tokens on Base through Clanker and Liquid Protocol.

Install

npm install @rainbow-me/token-launcher viem

Quick Start

import { TokenLauncher, Protocol } from '@rainbow-me/token-launcher';
import { createPublicClient, createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';

const account = privateKeyToAccount('0x...');
const publicClient = createPublicClient({ chain: base, transport: http() });
const walletClient = createWalletClient({ account, chain: base, transport: http() });

TokenLauncher.configure({ chains: [8453] });

const { txHash, tokenAddress } = await TokenLauncher.launchToken({
  protocol: Protocol.Liquid, // or Protocol.Clanker
  name: 'My Token',
  symbol: 'MTK',
  walletClient,
  publicClient,
  logoUrl: 'https://example.com/logo.png',
  amountIn: '0', // wei — set non-zero for a dev buy at launch
});

API

| Method | Description | |---|---| | configure(config) | Set { chains: number[] } | | getConfig() | Read current config | | getInitialTick(price) | Compute starting tick from a token price | | launchToken(params) | Deploy a token and return { txHash, tokenAddress, tokenUri? } |

Protocols

Both protocols deploy tokens paired against WETH on Base via Uniswap V4.

| | Clanker | Liquid | |---|---|---| | Token | ERC-20 | ERC-20 (18 decimals, 100B supply) | | Rewards | 50% creator / 50% Rainbow | 100% creator (WETH) | | Fees | Set by Clanker SDK | 80% creator / 20% protocol |

Liquid contracts are verified on Basescan, forked from Clanker v4, and audited by 0xMacro and Cantina.

Errors

All errors are TokenLauncherSDKError with a code:

INVALID_PROTOCOL · INVALID_ADDRESS · UNSUPPORTED_CHAIN_ID · INVALID_AMOUNT_IN_PARAM · MISSING_REQUIRED_PARAM · INSUFFICIENT_FUNDS · GAS_ESTIMATION_FAILED · CONTRACT_INTERACTION_FAILED · TRANSACTION_FAILED · WALLET_CONNECTION_ERROR · UNKNOWN_ERROR