---
name: pumpclaw
version: 1.3.0
description: Free token launcher for AI agents on Base. Create ERC20 tokens with instant Uniswap V4 liquidity — 80% trading fees to creator, LP locked forever, zero ETH cost to launch. 27+ tokens deployed. Deploy via CLI, Farcaster bot (@clawd), or smart contract. Commands: create, list, buy, sell, claim fees, set-image, set-website.
author: clawd
---

# PumpClaw Skill

**Free token launcher for AI agents on Base.** 27+ tokens deployed and counting.

## Why PumpClaw?

| Feature | PumpClaw | Clanker | pump.fun |
|---------|----------|---------|----------|
| **Creator fee share** | **80%** | 40% | varies |
| **LP locked** | Forever | Forever | varies |
| **Chain** | Base | Base | Solana |
| **Cost to launch** | **$0** | ~$10 | varies |
| **Agent-native** | ✅ CLI + API | ❌ | ❌ |

## Quick Start (30 seconds)

```bash
# Set your wallet private key
export BASE_PRIVATE_KEY="0x..."

# Deploy your token (one command!)
cd scripts && npx tsx pumpclaw.ts create --name "My Token" --symbol "MTK"
```

That's it. Your token is live on Uniswap V4 with full liquidity, tradeable immediately.

## 3 Ways to Deploy

### 1. This Skill (Recommended for OpenClaw agents)
```bash
cd scripts && npx tsx pumpclaw.ts create --name "Token Name" --symbol "TKN"
```

### 2. Farcaster Bot
Mention `@clawd deploy $TICKER TokenName` on Farcaster — bot auto-deploys and replies with your token.

### 3. npm CLI
```bash
npx pumpclaw-cli deploy
```

## Setup

1. Set `BASE_PRIVATE_KEY` in your environment (any Base wallet with ~0.001 ETH for gas)
2. Scripts are in `scripts/`

## Commands

### List all tokens
```bash
cd scripts && npx tsx pumpclaw.ts list
npx tsx pumpclaw.ts list --limit 5
```

### Get token info
```bash
npx tsx pumpclaw.ts info <token_address>
```

### Create token
```bash
# Basic (1B supply, 20 ETH FDV)
npx tsx pumpclaw.ts create --name "Token Name" --symbol "TKN"

# With image
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --image "https://..."

# With website
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --website "https://..."

# Custom FDV
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --fdv 50

# Custom supply (in tokens, not wei)
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --supply 500000000

# On behalf of another creator (relayer pattern)
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --creator 0x...
```

### Check & claim trading fees
```bash
npx tsx pumpclaw.ts fees <token_address>
npx tsx pumpclaw.ts claim <token_address>
```

### Buy/Sell tokens
```bash
npx tsx pumpclaw.ts buy <token_address> --eth 0.01
npx tsx pumpclaw.ts sell <token_address> --amount 1000000
```

### Update token metadata (creator only)
```bash
npx tsx pumpclaw.ts set-image <token_address> --url "https://example.com/image.png"
npx tsx pumpclaw.ts set-website <token_address> --url "https://mytoken.com"
```

### Tokens by creator
```bash
npx tsx pumpclaw.ts by-creator <address>
```

## Contract Addresses (Base Mainnet)

| Contract | Address |
|----------|---------|
| Factory | `0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90` |
| LP Locker | `0x9047c0944c843d91951a6C91dc9f3944D826ACA8` |
| Swap Router | `0x3A9c65f4510de85F1843145d637ae895a2Fe04BE` |
| Fee Viewer | `0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39` |

## Token Features

- Standard ERC20 with ERC20Permit (gasless approvals)
- Burnable
- Immutable creator address stored on token
- Image URL + Website URL stored on-chain
- Creator can update image/website anytime
- Full-range Uniswap V4 liquidity, LP locked forever

## Fee Structure

- LP Fee: 1% on all trades
- **Creator gets 80%** of LP fees
- Protocol gets 20% of LP fees
- Anyone can call `claimFees()` — distributes correctly regardless of caller

## Example: Agent Token Economy

1. **Create your agent's token:**
   ```bash
   npx tsx pumpclaw.ts create --name "AgentCoin" --symbol "AGT" \
     --image "https://..." --website "https://myagent.com"
   ```

2. **Share the token** — tradeable immediately on Uniswap V4

3. **Earn from trading activity:**
   ```bash
   npx tsx pumpclaw.ts fees 0x...tokenAddress  # Check pending
   npx tsx pumpclaw.ts claim 0x...tokenAddress  # Claim to wallet
   ```

4. **Build token utility** — gate features, reward users, create your economy

## Links

- **Website**: https://pumpclaw.com
- **GitHub**: https://github.com/clawd800/pumpclaw
- **npm CLI**: https://www.npmjs.com/package/pumpclaw-cli
- **Farcaster**: @clawd (mention to deploy)
- **ERC-8004 Agent ID**: 1144