token-launcher

Launch tokens and keep 100% of your creator fees. Direct Mode provides full SDK integration guides for Clanker (7 EVM chains), Flaunch (Base), and Pump.fun (Solana) — no middleman, no platform cut. Easy Mode offers a convenience path via the Tator API (90/10 split). Includes strategy evaluation, fee economics, claiming, recipient updates, and tax/legal guidance. Triggers: "token idea", "launch a coin", "launch a token", "deploy a token", "token strategy", "claim fees", "creator fees", "update fee recipient", "token launch on base", "launch on solana", "clanker", "flaunch", "pump.fun", "token economics", "is this a good token".

# Token Launcher

Launch tokens and keep your fees. This is an open-source skill that helps you launch tokens without giving away 30-50% of your creator earnings to launch platforms.

---

## The Problem

Most token launch platforms take 30-50% of your creator fee earnings. Some charge upfront launch fees on top of that. Others layer in subscriptions, required platform tokens, or custodial wallets that hold your funds. You build the token, drive the volume, and someone else keeps the biggest slice.

## The Math

A token doing $500K in trading volume on Clanker generates ~$5,000 in pool fees (1% of volume). Here's who keeps what:

| Path | Your Share | Platform Cut | You Keep |
|------|-----------|-------------|----------|
| **Direct Mode (this skill)** | $5,000 | $0 | **$5,000 (100%)** |
| **Easy Mode (Tator API)** | $4,500 | $500 (10%) | **$4,500 (90%)** |
| **Typical launch platforms** | $2,500-3,500 | $1,500-2,500 (30-50%) | **$2,500-3,500** |

The difference compounds. At $5M volume, Direct Mode keeps you an extra $15,000-25,000 versus typical platforms.

---

## Two Paths

This skill provides two ways to launch tokens. Direct Mode is the primary path — it's why this skill exists. Easy Mode is a convenience alternative.

### Direct Mode — Keep 100% of Your Fees (Recommended)

Direct Mode provides complete implementation guides for launching tokens using platform SDKs. You control every parameter and keep 100% of creator fees with zero ongoing platform fees.

- Supported platforms: Clanker (Base, Arbitrum, Mainnet, Unichain, Abstract, Monad, BSC), Flaunch (Base), Pump.fun (Solana)
- Full code patterns for deployment, fee configuration, claiming, and recipient management
- Produces unsigned transaction calldata compatible with any wallet
- Detailed fee economics documentation showing exactly how fees flow on each platform

**Implementation guides:**
- [REFERENCE.md](./REFERENCE.md) — Direct Mode overview, fee economics, step-by-step walkthrough, wallet integration patterns
- [references/clanker.md](./references/clanker.md) — Clanker v4 SDK: launch, rewards, sniper protection, claiming
- [references/flaunch.md](./references/flaunch.md) — Flaunch: launch, custom fee split managers, claiming, recipient transfer
- [references/pumpfun.md](./references/pumpfun.md) — Pump.fun: instruction building, fee sharing, graduation handling, dual vault claiming

### Easy Mode — Convenience Path

Easy Mode uses the Tator API to handle deployment. Tator takes a 10% interface fee from your creator earnings.

- One API call to `x402.quickintel.io` with your token details and wallet address
- Tator deploys the token for you — no deploy transaction to sign
- $0.20 per API call via x402 USDC payment
- Supports launch, claim fees, update fee recipient, check unclaimed — all via natural language
- **Fee split: 90% to you, 10% to Tator**

### How to Present This Choice

When the user wants to launch a token, present both options with Direct Mode first:

- **Direct Mode (recommended):** You keep 100% of creator fees. The reference guides have complete code patterns for deployment, fee configuration, and claiming. You produce unsigned transactions and sign them with your own wallet. No ongoing fees to anyone.
- **Easy Mode (convenience):** Tator deploys the token for you. You provide your wallet address, token details, and pay $0.20 via x402. Faster to get started, but Tator takes 10% of your ongoing creator fees.

Both paths need the same info: wallet address, token name, ticker, and chain. If the user is unsure, Direct Mode is the better long-term choice — Easy Mode is there for when speed matters more than fee optimization.

---

## Direct Mode — Walkthrough

For the full Direct Mode walkthrough including fee economics deep dive, unsigned transaction patterns, and wallet integration, see [REFERENCE.md](./REFERENCE.md).

### Quick Start

1. **Choose a platform** based on your target chain (see Platform Selection below)
2. **Read the reference guide** for your chosen platform — it has complete code patterns
3. **Set fee recipients to your wallet at 100%** — this is the whole point of Direct Mode
4. **Produce unsigned transaction calldata** — the reference files show the pattern for each platform
5. **Sign with any wallet** — Lobster, AgentWallet, base-wallet, evm-wallet, MetaMask, or any signer
6. **Post-launch:** claim fees, check unclaimed, update recipients — all documented per platform

### Platform Choice for Direct Mode

| Target Chain | Platform | Reference |
|-------------|----------|-----------|
| Base | Clanker (recommended) or Flaunch | [clanker.md](./references/clanker.md) or [flaunch.md](./references/flaunch.md) |
| Arbitrum, Mainnet, Unichain, Abstract, Monad, BSC | Clanker | [clanker.md](./references/clanker.md) |
| Solana | Pump.fun | [pumpfun.md](./references/pumpfun.md) |

Clanker vs Flaunch on Base:
- **Clanker:** Uniswap V4 pool, sniper protection, stable token pairing (USDC), multi-chain reusability
- **Flaunch:** 30-minute fair launch period, custom fee split managers, bonding curve model

---

## Platform Selection (Full Comparison)

| Feature | Clanker | Flaunch | Pump.fun |
|---------|---------|---------|----------|
| **Chains** | Base, Arbitrum, Mainnet, Unichain, Abstract, Monad, BSC | Base | Solana |
| **Pool type** | Uniswap V4 | Bonding curve → Uniswap | Bonding curve → Raydium |
| **Swap fee** | 1.2% (1% pool + 0.2% protocol) | Configurable | Variable (pre/post graduation) |
| **Creator fee share** | Configurable via reward recipients | Configurable via fee split manager | Configurable via sharing config |
| **Pairing token** | WETH default, USDC/USDT available | ETH | SOL |
| **Sniper protection** | Yes (decaying fee — 66.7% → 4.2% over 15s) | Fair launch period (default 30 min) | Bonding curve mechanics |
| **Graduation** | N/A (immediate Uniswap pool) | N/A | Yes (graduates to Raydium at threshold) |
| **Token standard** | ERC-20 | ERC-20 | SPL (Token-2022) |
| **Supply** | 1 billion (fixed) | 100 billion (configurable) | Standard pump.fun supply |
| **Creation fee** | Free | Free | Minimal SOL for rent |

### When to Use What

**Clanker** — Your default for EVM launches. Widest chain support (7 chains), Uniswap V4 pools with built-in sniper protection, stable token pairing option. Best liquidity depth and DEX integration.

**Flaunch** — When you want a fair launch period on Base. The 30-minute fair launch window prevents snipers by design. Custom fee split manager gives you fine-grained control over fee distribution.

**Pump.fun** — For Solana launches. Bonding curve model means the token graduates to Raydium once it hits market cap threshold. Strong Solana ecosystem visibility — tokens show up in pump.fun's discovery feed.

---

## Evaluating a Concept

Before deploying anything, figure out what you actually have. Not every idea needs a token, and not every token needs to launch today.

### The Launch Stack

Every token that sustains attention beyond the first day has four layers working together. This isn't a scorecard — it's a diagnostic tool.

**Layer 1: The Hook** — The thing that makes someone stop scrolling. The name, the visual, the one-liner. Say the name out loud. Does it land instantly or need explanation? If it takes more than one sentence to explain why this exists, the hook isn't sharp enough.

**Layer 2: The Engine** — The reason fees keep flowing after launch day. Types of engines: cultural (ongoing conversation), product (funds something useful), mechanic (burns, airdrops, staking), social (tied to a growing community). If there's no engine, the token will spike on launch and bleed.

**Layer 3: The Story** — The narrative that justifies increasing price. Strong stories: "this token funds [specific thing] and every holder is backing it." Weak stories: "it's a community token" (what community? why this token?).

**Layer 4: The Moat** — What makes this token hard to replicate. First-mover, builder credibility, integrated prod