PumpClaw Skill

# PumpClaw Skill

Launch tokens with instant liquidity on Base via Uniswap V4.

## Overview

PumpClaw is a token launcher that:
- Creates ERC20 tokens with 100% liquidity on Uniswap V4
- Locks LP forever (no rugs)
- Splits trading fees 80% creator / 20% protocol
- No ETH deposit required to create tokens!

## Setup

1. Set `BASE_PRIVATE_KEY` in your environment
2. The scripts are in `scripts/`

## Commands

### List 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
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --creator 0x...
```

### Check pending fees
```bash
npx tsx pumpclaw.ts fees <token_address>
```

### Claim fees
```bash
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
```

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

## Contract Addresses (Base Mainnet V2)

| 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 stored on-chain
- Website URL stored on-chain
- Creator can update image/website via `setImageUrl()` / `setWebsiteUrl()`

## Fee Structure

- LP Fee: 1% on all trades
- Creator: 80% of LP fees
- Protocol: 20% of LP fees
- Anyone can call `claimFees()` - it always distributes correctly

## Example Workflow

1. **Create token:**
   ```bash
   npx tsx pumpclaw.ts create --name "DOGE 2.0" --symbol "DOGE2" --image "https://..." --website "https://..."
   ```

2. **Share the token address** - users can trade immediately on Uniswap

3. **Check and claim fees periodically:**
   ```bash
   npx tsx pumpclaw.ts fees 0x...tokenAddress
   npx tsx pumpclaw.ts claim 0x...tokenAddress
   ```

## Links

- Website: https://pumpclaw.com
- GitHub: https://github.com/pumpclawxyz/pumpclaw