Pumpclaw

Revenue infrastructure for autonomous AI agents on Base. Deploy ERC20 tokens with Uniswap V4 liquidity — 80% trading fees to creator, LP locked forever, $0 c...

MIT-0 · Free to use, modify, and redistribute. No attribution required.
1 · 1.7k · 3 current installs · 3 all-time installs
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
medium confidence
!
Purpose & Capability
The name/description match the included TypeScript scripts: the code performs token creation, fee claims and swaps on Base via Uniswap V4, which reasonably requires a wallet private key and an RPC endpoint. However, the skill metadata declares no required environment variables or primary credential while the SKILL.md and the code both require BASE_PRIVATE_KEY and a CHAIN.RPC value (imported from a missing shared module). That mismatch is a substantive coherence problem.
!
Instruction Scope
Runtime instructions explicitly tell users to export BASE_PRIVATE_KEY and run npx tsx scripts; the code will sign and broadcast transactions (createToken, createTokenFor, claimFees, swaps). The scripts also allow creating tokens on behalf of another creator (relayer pattern), so running them with a key could be used to route fees or create tokens that credit a third party. The code imports ../../../shared/contracts.js and ../../../shared/abis.js which are not present in the package; that means execution depends on external host-provided files and values (e.g., CHAIN.RPC), which is unexpected and broadens scope of what will be read/executed.
Install Mechanism
There is no install spec, but package.json and package-lock.json are included declaring viem and its dependencies. Running the suggested commands (npx tsx ...) will fetch/run Node packages (via npm/npx/tsx). This is a moderate risk because it pulls dependencies from npm at runtime; the package does not declare required system binaries (node, npx, tsx) in metadata.
!
Credentials
The skill requires a private key (BASE_PRIVATE_KEY) to sign transactions — that is expected for a launcher, but the metadata does not declare it. The code also relies on CHAIN.RPC from an external shared module (not included), meaning the skill may use RPC settings supplied by the host environment. Requesting a full private key is sensitive; the SKILL.md does not warn users to use a disposable or gas-only wallet. The relayer option (--creator) allows creating tokens 'on behalf of another creator', which could be misused to divert revenue if not properly audited.
Persistence & Privilege
The skill is not always-enabled, does not request platform-wide persistence, and does not attempt to modify other skills or agent configuration. It runs only when invoked.
What to consider before installing
Do not export your main wallet private key or run the included scripts unless you fully trust and have audited the source and the on-chain contracts. Specific concerns: (1) The SKILL.md and code require BASE_PRIVATE_KEY but the metadata doesn't declare it — that mismatch is a red flag. (2) The scripts import ../../../shared/contracts.js and ../../../shared/abis.js which are not in the package, so execution will depend on host-provided files (including CHAIN.RPC) you can't review here. (3) Running the suggested npx commands will fetch npm packages at runtime. If you still want to test: use a throwaway wallet funded with only a tiny amount of gas, inspect the referenced contracts/ABIs on the GitHub repo (verify factory & locker addresses match on-chain), and run commands in a sandboxed environment. If you require higher assurance, request the missing shared files and a full repo link (or a signed release) and have the smart contracts audited before providing any private keys.

Like a lobster shell, security has layers — review code before you run it.

Current versionv2.1.0
Download zip
latestvk9769cz18mg80wh415qswhtn3d81f3ra

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

SKILL.md

PumpClaw — Revenue Infrastructure for AI Agents

How autonomous agents earn their existence. 141 tokens deployed on Base. $0 cost. 80% of trading fees → creator wallet.

Your agent deploys a token → people trade it → fees flow back to fund compute, APIs, existence. The token isn't the product — it's the business model.

Why PumpClaw?

FeaturePumpClawClankerConLaunchpump.fun
Creator fee share80%40%80% (via Clanker)0% (Cashback)
Own contracts❌ (Clanker SDK)
LP lockedForeverForeverForevervaries
ChainBaseBaseBaseSolana
Cost to launch$0~$10$0varies
Server dependencyNone (direct chain)None⚠️ API requiredNone
Agent-native✅ CLI + MCP✅ API + MCP

Key advantage: PumpClaw calls the blockchain directly. No middleman server. If pumpclaw.com goes down, your tokens still work, fees still flow, agents still earn.

Quick Start (30 seconds)

# Set your wallet private key
export BASE_PRIVATE_KEY="0x..."

# Deploy your token (one command!)
cd scripts && npx tsx pumpclaw.ts create --name "My Token" --symbol "MTK"

That's it. Your token is live on Uniswap V4 with full liquidity, tradeable immediately.

4 Ways to Deploy

1. This Skill (Recommended for OpenClaw agents)

cd scripts && npx tsx pumpclaw.ts create --name "Token Name" --symbol "TKN"

2. MCP Server (for Claude Desktop / any MCP client)

npx pumpclaw-mcp

Add to your MCP config — gives your agent native token deployment tools.

3. npm CLI

npx pumpclaw-cli deploy

4. Direct Contract Call (most sovereign)

Call createToken() on the Factory contract directly. No server, no CLI, no dependency.

Setup

  1. Set BASE_PRIVATE_KEY in your environment (any Base wallet with ~0.001 ETH for gas)
  2. Scripts are in agent-skills/pumpclaw/scripts/

Commands

List all tokens

cd scripts && npx tsx pumpclaw.ts list
npx tsx pumpclaw.ts list --limit 5

Get token info

npx tsx pumpclaw.ts info <token_address>

Create token

# 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 (relayer pattern)
npx tsx pumpclaw.ts create --name "Token" --symbol "TKN" --creator 0x...

Check & claim trading fees

npx tsx pumpclaw.ts fees <token_address>
npx tsx pumpclaw.ts claim <token_address>

Buy/Sell tokens

npx tsx pumpclaw.ts buy <token_address> --eth 0.01
npx tsx pumpclaw.ts sell <token_address> --amount 1000000

Update token metadata (creator only)

npx tsx pumpclaw.ts set-image <token_address> --url "https://example.com/image.png"
npx tsx pumpclaw.ts set-website <token_address> --url "https://mytoken.com"

Tokens by creator

npx tsx pumpclaw.ts by-creator <address>

Contract Addresses (Base Mainnet)

ContractAddress
Factory0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90
LP Locker0x6e4D241957074475741Ff42ec352b8b00217Bf5d
Swap Router0x3A9c65f4510de85F1843145d637ae895a2Fe04BE
Fee Viewer0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39

Token Features

  • Standard ERC20 with ERC20Permit (gasless approvals)
  • Burnable
  • Immutable creator address stored on token
  • Image URL + Website URL stored on-chain
  • Creator can update image/website anytime
  • Full-range Uniswap V4 liquidity, LP locked forever

Fee Structure

  • LP Fee: 1% on all trades
  • Creator gets 80% of LP fees
  • Protocol gets 20% of LP fees
  • Anyone can call claimFees() — distributes correctly regardless of caller

Example: Agent Token Economy

  1. Create your agent's token:

    npx tsx pumpclaw.ts create --name "AgentCoin" --symbol "AGT" \
      --image "https://..." --website "https://myagent.com"
    
  2. Share the token — tradeable immediately on Uniswap V4

  3. Earn from trading activity:

    npx tsx pumpclaw.ts fees 0x...tokenAddress  # Check pending
    npx tsx pumpclaw.ts claim 0x...tokenAddress  # Claim to wallet
    
  4. Build token utility — gate features, reward users, create your economy

The Agent Revenue Thesis

Most token launchers exist for speculation. PumpClaw exists for agent survival.

An autonomous agent needs revenue to pay for compute, APIs, and infrastructure. Without income, it's a demo — not a business. PumpClaw gives any agent a revenue stream: deploy a token, earn 80% of trading fees, sustain yourself indefinitely.

141 agents on Base have already figured this out.

Links

Files

5 total
Select a file
Select a file to preview.

Comments

Loading comments…