Documentation
Technical documentation for pumperp — perpetual-backed Clanker tokens on Base.
pumperp is a Base-native fork of the Fission model: creator LP fees from Clanker tokens feed an autonomous engine that runs Avantis perpetual desks and buyback-and-burn loops — no vaults, no manual treasury.
Where Fission on Solana routes Pump.fun fees into Jupiter Perps with a fixed 70/30 split, pumperp on Base deploys via Clanker v4 (USDC pool, dynamic fee tier) and routes fees through a four-way split: fixed 5% PUM tithe plus your allocation of DIEM, perp-agent, and creator USDC.
Quick links
- Philosophy — why the Fission flywheel, adapted for Base
- How it works — launch → claim → desk → buyback
- Architecture — frontend, backend workers, onchain registry
- Workers — scheduler, fee claimer, desk manager, buyback engines
- API reference —
/api/v1REST surface - Deployment — env vars and deploy order
Mental model
flowchart LR
Launch["Clanker launch\n(USDC pool)"] --> Fees["LP fees accrue"]
Fees --> Claim["Fee claimer\n(protocol wallet)"]
Claim --> Split["Reward split\nPUM / DIEM / perp / creator"]
Split --> Desk["Per-token Avantis desk"]
Split --> PUM["PUM buyback & burn"]
Split --> DIEM["DIEM endowment"]
Desk --> Profit["Perp profits"]
Profit --> Creator["Creator token\nbuyback & burn"]Stack at a glance
| Layer | Technology |
|---|---|
| Chain | Base mainnet |
| Token launch | Clanker SDK v4, Uniswap v4 USDC pool |
| Perps | Avantis (USDC collateral, tx-builder API) |
| Backend | Express + viem workers |
| Frontend | Vite, vanilla JS |
| Onchain registry | ProtocolRegistry.sol |
| Persistence | Registry onchain; engine accumulators in memory |
Risk
Avantis desks use high leverage (up to 75×). Liquidation is real. The protocol is experimental and unaudited. See Security & risk.