Documentation Index
Fetch the complete documentation index at: https://docs.boost.xyz/llms.txt
Use this file to discover all available pages before exploring further.
How It Works
Time-Based Incentives campaigns reward users while they keep an eligible onchain position active. The basic flow is simple: a protocol chooses the position it wants to grow, funds a reward budget, and sets the campaign rules. Users participate by holding or entering that position. Boost tracks the position over time, calculates rewards, and makes earned rewards available to claim. The result is a campaign where rewards follow sustained participation instead of a single moment of activity.The Campaign Loop
A protocol defines the goal
The protocol decides what behavior it wants to grow: deposits, holdings, vault shares, or another supported position.
Boost turns that goal into a campaign
The campaign defines the eligible position, reward budget, reward token, schedule, eligibility, and any caps or tiers.
Users keep positions active
Users earn while their position remains eligible. Larger positions and longer participation can earn more.
What Protocols Decide
Campaign setup is about choosing the behavior and guardrails that match the protocol’s goal.| Decision | What it means |
|---|---|
| Eligible position | The token, vault, or protocol position that counts toward rewards. |
| Reward budget | The amount of rewards available for the campaign. |
| Reward token | The token users earn. |
| Campaign window | When rewards start and stop accruing. |
| Eligibility | Whether the campaign is open, allowlisted, or gated by another requirement. |
| Controls | Optional rules like minimum balances, caps, tiers, or reward-rate limits. |
What Users Do
Users do not need to learn the mechanics of the reward system. They just need to understand the campaign requirement. In a typical product flow, a user can:- Discover an active campaign.
- See the position required to earn.
- Enter or maintain that position.
- Track estimated and accrued rewards.
- Claim available rewards when they are ready.
Where Funds Sit
Users enter positions directly through the protocol or application where the position lives. Boost does not custody user deposits or move user principal into a Boost-controlled pool. Boost tracks the eligible position and pays additional rewards for maintaining it. Campaign reward funds are separate from user deposits. Protocols fund the reward budget for a campaign, and those reward tokens sit in campaign smart contracts so they are available for eligible users to claim as rewards accrue. After the campaign ends, funds that were never allocated to users can be reclaimed. Users then have the campaign’s claim window to claim rewards they earned; standard campaigns are configured with a 60-day claim window. After that window expires, any still-unclaimed reward funds can also be reclaimed.What Boost Handles
Boost runs the infrastructure that makes the campaign work:- Tracks eligible positions for active campaigns.
- Applies eligibility and campaign controls.
- Calculates rewards based on eligible balance and time held.
- Surfaces campaign data, user rewards, estimates, and claimable amounts.
- Supports claim transactions when rewards are available.
Example Campaign
A protocol wants users to keep capital in a vault for 30 days. It launches a Time-Based Incentives campaign with a fixed reward budget and points the campaign at the vault share token. During the campaign:- Users who hold vault shares are eligible to earn.
- A user with a larger eligible balance can earn more than a user with a smaller balance.
- A user who stays in the vault for the full campaign can earn more than a user who exits after a few days.
- A user who joins late can still earn for the time they participate.
- Once rewards are available, users can claim what they have earned.
Why This Matters
Time-Based Incentives are useful when the value of a user action depends on what happens after the first transaction.Better retention
Reward users for staying active through the campaign window.
More flexible rewards
Shape earning with eligibility, caps, tiers, and reward-rate controls.
Clear user experience
Show users what to do, what they are earning, and what they can claim.
Less manual work
Let Boost handle tracking, accounting, campaign data, and claim support.
Keep Exploring
Reward Calculation
Learn how eligible balance and time held determine rewards.
Campaign Lifecycle
Follow a campaign from setup through earning, claiming, and completion.
Campaign Modes
Explore the controls that shape who earns and how much.
Launch a Campaign
See how to bring a Time-Based Incentives campaign live.