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 許可證。