Volume-based PUMP token reward system with day-indexed epochs, pro-rata distribution, accumulator tracking, and cross-program claiming on Solana.
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.
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.
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 daydayIndex = Math.floor((currentTimestamp - startTime) / secondsInADay)
$$\text{tokens} = \frac{\text{userSolVolume} \times \text{dayTokenSupply}}{\text{globalSolVolume}}$$
initUserVolumeAccumulator) — creates the user's volume accumulator PDAsyncUserVolumeAccumulator) — updates the accumulator with latest volume dataclaimTokenIncentives) — claims accumulated PUMP token rewardscloseUserVolumeAccumulator) — closes the account, reclaims rentSince 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| 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 |
tokenIncentives.ts — no side effects, no RPC callscurrentTimestamp parameter for testabilityBN arithmetic — never convert to JavaScript numbertotalUnclaimedTokens does NOT include the current day's rewards — only finalized dayscurrentDayTokens returns 0 if the user's last update was on a different day (sync first)startTime, not from epoch 0