Documentation
Technical documentation for pumperp — agentic Clanker launches on Base.
pumperp is agentic finance on Base: every token gets an agent with a fee-funded treasury and genuine trading discretion inside a machine-enforced charter. Creators compile intent into hard risk clamps + a public mandate; the mind trades only inside those clamps; buyback/burn floors are untouchable; everything is ledgered.
Powered by the ClawBase monorepo. Public docs here are derived from STRATEGY.md, docs/CHARTER-DESIGN.md, and docs/ARCHITECTURE.md in that repo.
Quick links
- Philosophy — bounded discretion, not empty promises
- How it works — charter → launch → mind → buybacks
- Architecture — miniapp, API, core, MCP
- Agents & signals — mind loop and clamp-gate
- Deployment — Fly API + Vercel miniapp
- API reference —
/api/v1surface (may lag; prefer clawbasedocs/ARCHITECTURE.md)
Mental model
flowchart LR
Charter["Charter compile\n(clamps + mandate)"] --> Launch["Clanker launch\n(agent wallet)"]
Launch --> Fees["LP fees accrue"]
Fees --> Claim["Treasury claim"]
Claim --> Split["Reserve / burn / desk / DIEM"]
Split --> Mind["Mind proposes\nwithin clamps"]
Mind --> Exec["Engine executes\n+ ledger"]
Exec --> Burn["Token buyback & burn"]Stack at a glance
| Layer | Technology |
|---|---|
| Chain | Base mainnet |
| Token launch | Clanker v4 from per-agent wallet |
| Perps | Avantis (USDC collateral) |
| API | Fastify + SQLite (apps/api) |
| Frontend | Vite Farcaster miniapp (apps/miniapp) |
| Agent surface | MCP (@clawbase/agents) + SDK |
| Persistence | SQLite volume + encrypted wallets |
Risk
Avantis desks can use high leverage. Liquidation is real. Clamps and circuit breakers bound damage; they do not guarantee profit. See Security & risk.