A Time-Based Incentives campaign rewards users for how much they hold and how long they hold it. Instead of paying on a single qualifying action, the campaign streams rewards every second a user’s position is open and stops the moment they exit. This page walks through how a campaign actually runs — what the protocol decides, what users experience, where funds sit, and how rewards flow from budget to wallet.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.
The Earning Model
Rewards don’t unlock at fixed intervals. They accrue every second, distributed in real time across everyone holding a qualifying position at that moment. Two things shape what a user earns:- Position size — the eligible balance they hold.
- Time held — how long that balance stays active inside the campaign window.
The Campaign Loop
A protocol defines the goal
Pick the on-chain position the campaign should reward — a token, vault share, LP position, or another supported asset.
Boost turns the goal into a campaign
Set the eligibility, reward token, budget, schedule, and any modes. Once funded, the campaign goes live at its scheduled start time.
Users participate
Users enter or maintain the eligible position. Rewards accrue while the position stays active and stop the moment it exits.
For the phase-by-phase view of a campaign’s life — pending, active, ended, finalized, claim window — see Campaign Lifecycle.
What Each Side Does
What protocols decide
Protocols set the shape of the campaign — what users are doing, who counts, and what they’re earning.| Decision | What it controls |
|---|---|
| Targets | Which positions or assets count |
| Reward token and budget | What’s being paid out, and how much |
| Schedule | When earning starts and ends |
| Eligibility | Open, allowlist-gated, or verification-gated |
| Modes | Caps, tiers, fixed APY, and other reward shaping |
What Boost handles
Boost runs the operational layer end to end:- Indexes the relevant on-chain events.
- Calculates each user’s earnings continuously.
- Applies eligibility rules, caps, and any campaign-specific modes.
- Produces distribution snapshots and publishes them on-chain.
- Supports claim transactions when rewards are ready.
What users experience
From a user’s point of view, the loop is simple:- Hold or open the eligible position.
- Watch rewards accrue while the position stays active.
- Claim whenever they’re ready — once at the end, periodically, in full or in part.
Where Funds Sit
Two pots of money live separately during a campaign. User principal stays in the protocol or vault where the position lives. Boost does not custody user deposits or move user principal into a Boost-controlled pool. Users stake, deposit, or hold exactly the way they would without a campaign attached. Reward funds live in campaign smart contracts deployed at launch. Reward tokens sit there and pay out to users as they claim earned rewards. After a campaign ends, any reward funds that were never allocated — undistributed, throttled, or forfeited — can be reclaimed by the creator. Users then have the campaign’s claim window (60 days for standard campaigns) to claim what they earned. After the window closes, any still-unclaimed reward funds can also be reclaimed.Example Campaign
A protocol wants users to keep capital in a vault for 90 days. It launches a Time-Based Incentives campaign with a fixed reward budget and points it at the vault share token. During the campaign:- Users holding vault shares are eligible to earn.
- A user with a larger eligible balance earns more than a user with a smaller balance.
- A user who stays in the vault the full 90 days earns more than a user who exits after a few weeks.
- A user who joins on day 60 still earns for the time they participate.
- Users can claim accrued rewards along the way as snapshots publish — they don’t have to wait for the end.
Beyond the Basics
The mechanics above describe the default flow. Most campaigns layer additional rules on top — minimum balances, tiered earning, fixed APY, allowlists, snapshots — to match a specific goal.Reward Calculation
The drip math: how eligible balance, share of the moment, and time held translate into rewards.
Campaign Modes
The reward-shaping rules — caps, tiers, fixed APY, and more — that stack on top of a campaign.
Campaign Lifecycle
Phase-by-phase walkthrough from setup through claim window close.
Launch a Campaign
What it looks like to bring a campaign live with the Boost team today.