pumpclaw-agent

name	pumpclaw-agent
description	Generate customer-ready Telegram polling bots + an Express-style web server that integrate Pump.fun Tokenized Agent payments using @pump-fun/agent-payments-sdk (build invoices, accept payments, and verify invoices on Solana). Use when asked for pump.fun / pumpfun agent integrations, tokenized agent payment flows, invoice verification, or a Telegram+web bot scaffold for Pump Tokenized Agents.

PumpClaw Agent — Pump.fun Tokenized Agents + Telegram + Web Server

This skill stamps a reusable template project and customizes it for a customer.

Template:

• assets/template/

Reference:

• references/PUMP_TOKENIZED_AGENTS.md

Before you start — required info

Ask for these before writing code:

1. Agent token mint address (pump.fun Tokenized Agent mint)
2. Payment currency (USDC or wSOL) → determines CURRENCY_MINT
3. Price (smallest units: USDC=6 decimals, SOL=9 decimals)
4. What to deliver after payment (what the bot/server unlocks)
5. Solana RPC URL (must support sendTransaction)
6. Telegram commands the bot should expose (and where alerts/messages go)

Safety rules (must follow)

• Never log or output private keys / secret key material.
• Never sign transactions on behalf of the user.
• Always verify payments server-side via validateInvoicePayment before delivering service.
• Validate amount > 0, and ensure endTime > startTime.

Workflow

Step 1 — Stamp the template

Copy assets/template/ into a new customer folder (project slug).

Step 2 — Configure env vars

Ensure .env.example includes:

• SOLANA_RPC_URL
• AGENT_TOKEN_MINT_ADDRESS
• CURRENCY_MINT
• TELEGRAM_BOT_TOKEN
• PORT

Do not create/commit real .env.

Step 3 — Implement Pump Tokenized Agent payment flow

Use @pump-fun/agent-payments-sdk:

• Build payment instructions with buildAcceptPaymentInstructions.
• Verify with validateInvoicePayment on the server.

If a frontend wallet flow is requested, follow the Pump reference skill (see references/PUMP_TOKENIZED_AGENTS.md).

Step 4 — Telegram bot (polling)

Implement requested commands. Always include /help.

Step 5 — Web server endpoints

Always include:

• GET /health → { ok: true }

Add payment-related endpoints only as requested (e.g. create invoice, verify invoice).

Step 6 — Deliverables

Provide:

• the full project folder
• run instructions
• smoke test checklist