pumpclaw

PumpClaw 🦞

为 Base 上的自主 AI Agent 提供营收基础设施。

软件包：

部署代币 → 用户交易代币 → 80% 的手续费流入你的 Agent 钱包。无需资助、无需风投、无需人工审批。

🌐 pumpclaw.com · 📦 CLI：npx pumpclaw-cli deploy · 🔌 MCP：npx pumpclaw-mcp

🧩 ElizaOS：npm i elizaos-plugin-pumpclaw · 🎬 GitHub Action · 🛠️ ClawHub Skill

概述

PumpClaw 让自主 Agent 能够自力更生。部署一个 ERC-20 代币，即可获得即时 Uniswap V4 流动性，并永久赚取所有交易手续费的 80%。你的 Agent 代币不是投机工具，而是一条收入来源。

• 零成本启动 — 创建代币无需 ETH
• 80% 创作者手续费 — 市场最高（是 Clanker 的 2 倍）
• 自有合约 — 无需依赖 Clanker SDK，无中间人服务
• LP 永久锁定 — 不可更改，无跑路风险
• Uniswap V4 — 采用原生 ETH 的最新 DEX 基础设施
• 直接连接区块链 — 即使 pumpclaw.com 宕机，你的代币仍然可用
• 原生支持 Agent — 可通过 CLI、MCP、ElizaOS、Farcaster、GitHub Action 或合约部署
• 可配置 — 自定义供应量（1M-1T）和初始 FDV
• Base 主网上已有 148 个代币

🤖 通过 Farcaster 部署

启动代币最简单的方式——只需在 Farcaster 上发布一条动态：

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

机器人将：

1. 解析你的代币名称和符号
2. 在 PumpClaw 上部署（Uniswap V4，LP 永久锁定）
3. 回复代币地址和兑换链接
4. 将你设为创作者（80% 的交易手续费归你）

**要求：**你的 Farcaster 个人资料中必须有经过验证的 Ethereum 地址。

机器人源码是内部运维脚本。

合约（Base 主网）— V3

合约	地址	已验证
PumpClawFactory	0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90	✅
PumpClawLPLocker	0x9047c0944c843d91951a6C91dc9f3944D826ACA8	✅
PumpClawSwapRouter	0x3A9c65f4510de85F1843145d637ae895a2Fe04BE	✅
PumpClawFeeViewer	0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39	✅

**注意：**兑换使用原生 ETH（不包装为 WETH），以降低 Gas 成本。 创作者可以设置来源证明 websiteUrl，并通过 setImageUrl() 更新图片。

合约接口

// 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)

默认值（由客户端设置）：

• 供应量：10 亿枚代币
• 初始 FDV：2 ETH

CLI 使用

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>

共享模块

/shared 中包含所有客户端共用的实用工具：

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

代币经济模型

• 代币总量：可配置（默认：10 亿）
• 初始 FDV：可配置（默认：2 ETH）
• LP 手续费：所有兑换收取 1%
• 费用分配：80% 分配给创建者，20% 分配给协议

开发

# 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

PumpClaw 与竞品对比

功能	PumpClaw 🦞	Clanker	ConLaunch	Bankr	pump.fun
创建者费用分成	80%	40%	80%（通过 Clanker）	57%	0%（返现）
自有合约	✅ MIT	✅	❌ Clanker SDK	✅	✅
服务器依赖	无	无	⚠️ 需要 API	无	无
LP 锁定	永久（不可变）	不定	永久	→ 0xdead	不定
链	Base	Base	Base	Base	Solana
Agent 集成	CLI、MCP、ElizaOS、ClawHub、GH Action、FC bot	仅 FC	API、MCP	FC、4claw	❌
自定义代币总量	100 万–1 万亿	固定	固定	固定	固定
自定义 FDV	可配置	固定	固定	固定	固定
链上注册表	✅（无需索引器）	❌	❌	❌	❌
开源	MIT	❌	❌	❌	❌

**主要优势：**PumpClaw 直接调用区块链——无需中间服务器，也不依赖 SDK。即使我们的网站宕机，你的代币仍可正常使用，费用仍会流转，Agent 仍可获利。依赖 Clanker SDK 的竞品会在其服务器宕机时一起停止运行。

统计数据

• Base 主网上已发行 148 种代币
• 70 多位独立创建者
• 创建费用为 $0
• 7 种集成方式——ClawHub 技能、CLI、MCP、ElizaOS、GitHub Action、Farcaster bot、直接调用合约

集成选项

方式	适用对象	文档
Farcaster Bot	用户和社交 Agent	发布 @clawd deploy $SYM Name
CLI	开发者和自动化	client-cli/
npm 包	Agent 框架	npx pumpclaw-cli deploy
MCP 服务	Claude、GPT 及任何 MCP Agent	npx pumpclaw-mcp
智能合约	直接集成	参见上方的合约接口
REST API	只读代币数据	参见下方的 API 部分

📡 API

实时 JSON API——无需 API 密钥、支持 CORS，由索引器提供服务。

所有代币

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

返回汇总统计数据：代币总数、独立创建者数量、工厂地址和费用结构。

快速获取（curl/Agent）

# 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}'

集成包

包	安装	版本	描述
CLI	npx pumpclaw-cli deploy		一条命令即可部署代币
MCP 服务	npx pumpclaw-mcp		面向 AI 工具的模型上下文协议
ElizaOS 插件	npm i elizaos-plugin-pumpclaw		ElizaOS Agent 框架插件
ClawHub 技能	clawdhub install clawd800/token-launcher	v2.1.0	OpenClaw Agent 技能
GitHub Action	clawd800/pumpclaw-action@v1	v1.0.0	CI/CD 代币部署
REST API	curl api.pumpclaw.com/api/v1/tokens	—	只读代币数据

链接

• 🌐 Web 应用：pumpclaw.com
• 🛠️ ClawHub：token-launcher
• 📦 npm CLI：pumpclaw-cli
• 🔌 npm MCP：pumpclaw-mcp
• 🧩 npm ElizaOS：elizaos-plugin-pumpclaw

许可证

MIT