Pumpclaw

🚀 PumpClaw 🦞

PumpClaw 是为基于 Base 链的自主 AI 智能体打造的收益基础设施。它允许用户部署带有即时 Uniswap V4 流动性的 ERC - 20 代币，并永久获得 80% 的交易手续费。

🚀 快速开始

部署一个代币，人们进行交易，80% 的手续费将流入你的智能体钱包。无需资助，无需风投，无需人工审批。

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

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

✨ 主要特性

• 零成本启动 — 创建代币无需任何 ETH。
• 80% 创作者手续费 — 市场上最高（是 Clanker 的 2 倍）。
• 自有合约 — 不依赖 Clanker SDK，没有中间人服务器。
• 永久锁定流动性 — 不可变，无跑路风险。
• Uniswap V4 — 采用最新的 DEX 基础设施，支持原生 ETH。
• 直接连接区块链 — 即使 pumpclaw.com 宕机，你的代币仍然可以正常工作。
• 支持智能体 — 可通过 CLI、MCP、ElizaOS、Farcaster、GitHub Action 或合约进行部署。
• 可配置 — 自定义供应量（100 万 - 1 万亿）和初始完全稀释估值（FDV）。
• 已有 148 个代币 在 Base 主网上线。

📦 安装指南

CLI 使用

cd client-cli
npm install

# 设置私钥
export PRIVATE_KEY=0x...

# 查看工厂信息
npx tsx src/cli.ts info

# 创建一个新代币（V4：无需 ETH！）
npx tsx src/cli.ts create --name "My Token" --symbol "MTK"

# 使用自定义 FDV 创建（默认：2 ETH）
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --fdv 50

# 使用自定义供应量创建
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --supply 21000000

# 使用 ETH 购买代币
npx tsx src/cli.ts buy <token_address> -e 0.001

# 出售代币换取 ETH
npx tsx src/cli.ts sell <token_address> -a 1000000

# 列出所有创建的代币
npx tsx src/cli.ts list

# 检查待领取的手续费
npx tsx src/cli.ts fees <token_address>

# 领取手续费（创作者或管理员）
npx tsx src/cli.ts claim <token_address>

开发环境

# 安装依赖
forge install

# 构建
forge build

# 测试
forge test

# 部署（需要设置 PRIVATE_KEY 环境变量）
# 从 contracts/ 目录执行：
cd contracts && forge script script/Deploy.s.sol --rpc-url $BASE_RPC --broadcast

# 在 Basescan 上验证合约
forge verify-contract <address> src/core/PumpClawFactory.sol:PumpClawFactory \
  --chain base --etherscan-api-key $BASESCAN_API_KEY

💻 使用示例

基础用法

通过 Farcaster 部署代币

这是启动代币最简单的方法 — 只需在 Farcaster 上发布消息：

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

机器人将执行以下操作：

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

要求：必须在你的 Farcaster 个人资料中验证以太坊地址。

高级用法

合约接口

// 用于创建代币的单一函数 - 所有参数均可配置
function createToken(
    string name,
    string symbol,
    string imageUrl,
    string websiteUrl,
    uint256 totalSupply,  // 例如，1_000_000_000e18 表示 10 亿
    uint256 initialFdv,   // 例如，2e18 表示 2 ETH
    address creator       // 接收手续费的地址
) returns (address token, uint256 positionId)

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

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

共享模块

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

// 使用默认值
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  creator: "0x..."
});

// 或者自定义
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  totalSupply: 21_000_000n * 10n ** 18n,  // 像比特币一样 2100 万
  initialFdv: 100n * 10n ** 18n,           // 100 ETH FDV
  creator: "0x..."
});

📚 详细文档

合约信息（Base 主网）— V3

注意：使用原生 ETH（无需包装成 WETH）进行节省 gas 的交易。 创作者可以设置来源证明 websiteUrl 并通过 setImageUrl() 更新图像。

集成选项

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/智能体）

# 获取所有代币
curl -s https://api.pumpclaw.com/api/v1/tokens | jq '.tokens[] | {symbol, address}'

# 获取统计信息
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 智能体框架的插件
ClawHub 技能	clawdhub install clawd800/token-launcher	v2.1.0	OpenClaw 智能体技能
GitHub Action	clawd800/pumpclaw-action@v1	v1.0.0	CI/CD 代币部署
REST API	curl api.pumpclaw.com/api/v1/tokens	—	只读代币数据

链接

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

🔧 技术细节

架构

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）
• 流动性手续费：所有交易 1%
• 手续费分配：80% 给创作者，20% 给协议

PumpClaw 与竞争对手对比

关键区别：PumpClaw 直接调用区块链 — 没有中间人服务器，不依赖 SDK。即使我们的网站宕机，你的代币仍然可以正常工作，手续费仍然可以正常流入，智能体仍然可以获得收益。依赖 Clanker SDK 的竞争对手在其服务器宕机时将无法正常工作。

统计信息

• 已有 148 个代币 在 Base 主网上线
• 70 多个唯一创作者
• 创建成本为 0
• 7 种集成方法 — ClawHub 技能、CLI、MCP、ElizaOS、GitHub Action、Farcaster 机器人、直接合约

📄 许可证

本项目采用 MIT 许可证。