x402agent/SolanaOS / skills/pump-token-incentives
pump-token-incentives
VerifiedVolume-based PUMP token reward system with day-indexed epochs, pro-rata distribution, accumulator tracking, and cross-program claiming on Solana.
Token Incentives — Volume-Based PUMP Token Rewards
Implement and maintain the token incentive system that rewards traders with PUMP governance tokens based on their SOL trading volume, using a day-based epoch system with pro-rata distribution.
Context
The Pump protocol incentivizes trading activity by distributing PUMP tokens to users proportional to their SOL trading volume. The system tracks volume in day-long epochs, with each day having a pre-configured token supply pool.
Day-Based Epoch System
Volume tracking operates in fixed-length epochs defined by the GlobalVolumeAccumulator:
startTime— epoch system start timestampsecondsInADay— epoch length (typically 86,400 seconds)solVolumes[]— array of total SOL volume per daytotalTokenSupply[]— array of PUMP tokens available per day
dayIndex = Math.floor((currentTimestamp - startTime) / secondsInADay)
Pro-Rata Reward Formula
$$\text{tokens} = \frac{\text{userSolVolume} \times \text{dayTokenSupply}}{\text{globalSolVolume}}$$
Account Lifecycle
- Init (
initUserVolumeAccumulator) — creates the user's volume accumulator PDA - Sync (
syncUserVolumeAccumulator) — updates the accumulator with latest volume data - Claim (
claimTokenIncentives) — claims accumulated PUMP token rewards - Close (
closeUserVolumeAccumulator) — closes the account, reclaims rent
BothPrograms Aggregation
Since users trade on both the bonding curve (Pump) and AMM (PumpAMM):
fetchUserVolumeAccumulatorTotalStats(user)— sums across both programsgetTotalUnclaimedTokensBothPrograms(user)— combined unclaimed rewardsclaimTokenIncentivesBothPrograms(user, payer)— claims from bothsyncUserVolumeAccumulatorBothPrograms(user)— syncs both
Edge Cases
| Case | Behavior |
|---|---|
| Zero global volume for a day | No tokens distributed (division by zero guarded) |
| User never synced | Only totalUnclaimedTokens from account state returned |
| Day index beyond arrays | No additional rewards computed |
| User updated same day | currentDayTokens returns preview, totalUnclaimedTokens excludes it |
Patterns to Follow
- Pure functions in
tokenIncentives.ts— no side effects, no RPC calls - Accept optional
currentTimestampparameter for testability - Always use
BNarithmetic — never convert to JavaScriptnumber - Sync before claiming to ensure the latest volume is reflected
Common Pitfalls
totalUnclaimedTokensdoes NOT include the current day's rewards — only finalized dayscurrentDayTokensreturns 0 if the user's last update was on a different day (sync first)- Day indices are zero-based from
startTime, not from epoch 0 - Volume accumulator PDAs differ between Pump and PumpAMM programs
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |