pumperp

Workers

Scheduler, intervals, and responsibilities of each autonomous worker.

The backend scheduler runs autonomous workers with randomized intervals (jitter reduces thundering herds). Health is exposed at GET /api/v1/health.

Worker table

WorkerInterval (sec)Function
price-sampler40–70Sample Pyth prices; warm momentum/volatility window
fee-claimer180–300Claim USDC LP fees; allocate PUM/DIEM/perp
desk-manager300–480Open/increase per-token Avantis desks
profit-checker~15 (fast loop)Detect desk profit; queue creator buybacks
creator-buyback600–1200Swap USDC → creator token → burn
buyback-engine900–1800Swap → PUM → burn
diem-engine900–1800Batch DIEM purchases
desk-risk300–600Drawdown, liquidation proximity, halts

Fee claimer

claimPooledFeesCycle:

  • Loads active tokens from registry cache
  • Claims a round-robin batch (CLAIM_BATCH_SIZE)
  • Attributes USDC per token → splitProtocolUsdc → state accumulators

Skips when no enrolled tokens or dust below thresholds.

Desk manager

manageTokenDesks iterates enrolled tokens:

  1. Skip if desk halted (risk)
  2. peekPerpUsdc(token) — pending perp allocation
  3. If no desk: decideDeskEntry(token) (agent)
  4. consumePerpUsdc → open or increase Avantis position (USDC collateral)
  5. Enforces AVANTIS_MIN_NOTIONAL_USDC (default 100 USDC notional = collateral × leverage)

reconcileTokenDesks on startup syncs onchain Avantis trade indices.

Buyback engines

PUM (runBuybackCycle):

  • Primary: USDC → WETH (Uniswap v3) → PUM (Uniswap v4) via swapUsdcForTokenburnTokens
  • Legacy fallback: drain old WETH accumulator if present
  • Min batch ~0.5 USDC

Creator (runCreatorBuybackCycle):

  • Drains consumeCreatorBuybacksAbove(CREATOR_BUYBACK_MIN_USDC) queue
  • Same Uniswap USDC → WETH → token path per creator token
  • Per-token swap + burn — the Fission "profits → derivative burn" leg

Fission worker mapping

Fission (Solana)pumperp (Base)
Fee Claimer (60 min)fee-claimer (3–5 min jitter)
Position Manager (75 min)desk-manager + profit-checker
Buyback Engine (90 min)buyback-engine + creator-buyback
Risk Manager (100 min)desk-risk + signal filter

pumperp adds DIEM endowment and market signal sampling — not present in the original Fission README.

Observability

GET /api/v1/health
GET /api/v1/stats
GET /api/v1/activity

Stats include Avantis desk snapshots and aggregate buyback totals where available.

On this page