pumperp

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.

  • 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/v1 REST 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

LayerTechnology
ChainBase mainnet
Token launchClanker SDK v4, Uniswap v4 USDC pool
PerpsAvantis (USDC collateral, tx-builder API)
BackendExpress + viem workers
FrontendVite, vanilla JS
Onchain registryProtocolRegistry.sol
PersistenceRegistry 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.

On this page