Creator rewards
Creator rewards convert configured fee proceeds into a selected Solana token, calculate each eligible holder’s proportional entitlement, and publish the evidence required to verify every distribution round.
Round lifecycle
- Collect creator fees.The keeper resolves whether the token is on the bonding curve or graduated and uses the corresponding official fee path.
- Open a numbered round.The program records the project, sequence number, input amount, and execution state before value changes.
- Purchase the reward token.A bounded Jupiter route swaps the configured input while enforcing program, mint, slippage, output, and price-impact limits.
- Snapshot holders.Finalized SPL token balances are consolidated by owner, filtered through the exclusion policy, and committed to a specific slot.
- Calculate entitlements.The full purchased amount is allocated proportionally with deterministic remainder handling.
- Distribute and publish.Payout batches or holder claims use the committed root and record their resulting signatures.
Reward calculation
holder_reward = purchased_reward_amount × eligible_holder_balance ÷ eligible_supplyEligible supply is the total balance remaining after exclusions. Integer division remainders are assigned deterministically so the sum of all entitlements equals the exact purchased reward amount.
| Excluded category | Why it is excluded |
|---|---|
| Bonding curve and liquidity accounts | Not independent holder positions |
| Burn addresses | Tokens cannot participate or claim |
| Project and reward vaults | Prevents the system from rewarding itself |
| Configured wallets | Supports project-specific treasury, team, or service exclusions |
| Zero and dust balances | Avoids uneconomical payout transactions |
Distribution modes and fairness
| Mode | Best fit | Operational tradeoff |
|---|---|---|
| Direct payout | Smaller holder sets with meaningful balances | The service pays transaction and token-account costs |
| Holder claim | Large communities | Each holder submits a proof and pays their transaction |
| Hybrid | Automatic larger payouts with dust accumulation | Requires more accounting and policy disclosure |
Snapshot policy
Finalized randomized slots or time-weighted balances reduce last-second snapshot gaming. Every round should publish its snapshot slot, exclusion set, calculation version, eligible supply, and entitlement root.