Pumpclaw

@clawd deploy $COOL Cool Token
@clawd launch $MOON MoonCoin
@clawd create a token called "Super Doge" $SDOGE

// Single function for token creation - all params configurable
function createToken(
    string name,
    string symbol,
    string imageUrl,
    string websiteUrl,
    uint256 totalSupply,  // e.g., 1_000_000_000e18 for 1B
    uint256 initialFdv,   // e.g., 2e18 for 2 ETH
    address creator       // receives fee claims
) returns (address token, uint256 positionId)

cd client-cli
npm install

# Set private key
export PRIVATE_KEY=0x...

# View factory info
npx tsx src/cli.ts info

# Create a new token (V4: no ETH required!)
npx tsx src/cli.ts create --name "My Token" --symbol "MTK"

# Create with custom FDV (default: 2 ETH)
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --fdv 50

# Create with custom supply
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --supply 21000000

# Buy tokens with ETH
npx tsx src/cli.ts buy <token_address> -e 0.001

# Sell tokens for ETH
npx tsx src/cli.ts sell <token_address> -a 1000000

# List all created tokens
npx tsx src/cli.ts list

# Check pending fees
npx tsx src/cli.ts fees <token_address>

# Claim fees (creator or admin)
npx tsx src/cli.ts claim <token_address>

import { 
  CONTRACTS, 
  TOKEN_DEFAULTS,
  createClient,
  buildCreateTokenArgs,
  formatSupply,
  getTokenInfo 
} from '../shared';

// Use defaults
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  creator: "0x..."
});

// Or customize
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  totalSupply: 21_000_000n * 10n ** 18n,  // 21M like Bitcoin
  initialFdv: 100n * 10n ** 18n,           // 100 ETH FDV
  creator: "0x..."
});

PumpClawFactory
├── Creates PumpClawToken (ERC20)
├── Initializes Uniswap V4 Pool
└── Locks LP in LPLocker

PumpClawSwapRouter
├── Executes V4 swaps (native ETH)
└── Simple buy/sell interface

# Install deps
forge install

# Build
forge build

# Test
forge test

# Deploy (requires PRIVATE_KEY env)
# From contracts/ directory:
cd contracts && forge script script/Deploy.s.sol --rpc-url $BASE_RPC --broadcast

# Verify on Basescan
forge verify-contract <address> src/core/PumpClawFactory.sol:PumpClawFactory \
  --chain base --etherscan-api-key $BASESCAN_API_KEY

GET https://api.pumpclaw.com/api/v1/tokens

{
  "tokens": [
    {
      "address": "0x76767891...",
      "name": "PumpClaw",
      "symbol": "PUMPCLAW",
      "imageUrl": "https://i.imgur.com/v9B9SlZ.png",
      "creator": "0x261368f0...",
      "createdAt": "2026-02-01T08:01:45.000Z",
      "percentPurchased": 5.4,
      "links": {
        "pumpclaw": "https://pumpclaw.com/#/token/0x...",
        "trade": "https://matcha.xyz/tokens/base/0x...",
        "basescan": "https://basescan.org/token/0x..."
      }
    }
  ],
  "total": 148, "lastSynced": 42701077, "currentBlock": 42701109
}

GET https://api.pumpclaw.com/api/v1/stats

# Get all tokens
curl -s https://api.pumpclaw.com/api/v1/tokens | jq '.tokens[] | {symbol, address}'

# Get stats
curl -s https://api.pumpclaw.com/api/v1/stats | jq '{totalTokens, uniqueCreators}'