Skip to main content

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.

A quick reference for terminology used across the Time-Based Incentives docs. Each entry links to the relevant deeper coverage where useful.

Foundations

Boost — The platform behind Time-Based Incentives. Boost runs the operational layer end-to-end: indexing on-chain events, computing rewards, publishing snapshots, and serving campaign data. References to “the operator” in these docs mean Boost. Campaign — A single Time-Based Incentives program: a fixed reward budget paid out continuously over a fixed schedule against a chosen target position. Each campaign has its own configuration — targets, budget, schedule, eligibility, and any modes. Creator — The team or address that funded and configured a campaign. Eligibility — Who is allowed to earn from a campaign. Three options: open, allowlist, or verified. Mode — A stackable rule that shapes who earns and how much within a campaign. See Campaign Modes for the full catalog. rabbithole.gg — Boost’s consumer-facing app, where users discover campaigns, hold positions, and claim rewards. Teams running campaigns can monitor live stats here too. Target — The on-chain position that counts toward earning. Could be a token, a vault share, an LP position, or another protocol position. Time-Based Incentives (TBI) — A reward program where users earn in proportion to how much eligible balance they hold and how long they hold it. Rewards drip continuously over the campaign window.

Earning mechanics

Accrued rewards — The reward total a user has earned but not yet claimed. Updates continuously as their position changes. Drip — The continuous flow of rewards out of a campaign budget. The drip rate is set by total budget ÷ duration and runs every second the campaign is active. Eligible balance — A user’s position size as it counts for rewards. Modes can transform raw balance into eligible balance — capping it, multiplying it, or zeroing it out below a threshold. Eligible position — A user’s holding of a campaign’s target, after eligibility rules have been applied. A user with the right asset but the wrong eligibility (e.g., not on an allowlist) does not have an eligible position. Merkle root — The cryptographic commitment to a snapshot, published on-chain. Users prove their claim against the latest root. Position — A user’s holding of a campaign’s target asset. Tracked per user, per campaign. Reward rate — Same as drip rate. The amount of reward token paid out per second of the campaign. Share — A user’s slice of the drip at a given moment. share = your eligible balance ÷ total eligible balance. Recomputed continuously as people enter and exit. Snapshot — A periodic on-chain publication of cumulative rewards. Once a snapshot lands, the user’s accrued earnings up to that point become claimable. Sometimes called a reward snapshot to distinguish it from a snapshot block. Snapshot block — A specific historical block used as a reference point. Used by the New Capital mode to measure pre-existing balance. Trigger — The moment a user first becomes eligible to earn — typically when their balance moves from zero to non-zero and any eligibility checks pass. After triggering, they accrue continuously while the position stays active. TVL — Total Value Locked. The aggregate eligible balance currently active in a campaign.

Lifecycle phases

See Campaign Lifecycle for the full arc. Active — The campaign is live. startTime has passed and endTime hasn’t. Users earn continuously. Cancelled — The campaign was ended early by the creator or admin. Already-accrued rewards stay claimable on the normal schedule. Closed — The claim window has expired. Anything still unclaimed can be reclaimed by the creator. Configured (Pending) — The campaign is deployed and funded, but startTime hasn’t hit. No earning yet. EndedendTime has passed (or the campaign otherwise stopped early). Earning has stopped, but the system is still settling. Finalized — The final snapshot is locked. Total distributed rewards are confirmed and the creator can recover any unspent budget.

Schedule

Campaign window — The interval between startTime and endTime during which earning happens. Claim window — The period after a campaign finalizes during which users can still claim earned rewards. Standard campaigns use a 60-day window; configurable per campaign. endTime — When earning stops on the standard schedule. startTime — When earning begins.

Money flow

Claim — The on-chain action that transfers a user’s earned rewards to their wallet. Uses a merkle proof against the latest snapshot. Claims are cumulative — claiming once now and once later, or all at once at the end, all return the same total. Forfeited rewards — Rewards a user accrued but lost — for example, by breaking a Cliff. Stay in the campaign pool, recoverable by the creator at finalization. Recoverable budget — The leftover funds the creator can withdraw at the end of a campaign. Includes undistributed rewards, throttled rewards (Capped APY), forfeited rewards (Cliff, when live), and any rewards left unclaimed after the claim window closes. Reward budget — The total amount of reward token committed to a campaign at launch. Reward token — The token users earn. Set when the campaign is created and locked for the campaign’s life. Throttled rewards — Drip that was held back when Capped APY bound the rate below its natural value. Stays in the pool as recoverable budget. Undistributed rewards — Drip that flowed during periods when no one held eligible balance. Stays in the pool as recoverable budget.

Modes (quick reference)

Each mode has its own section in Campaign Modes; these are one-line summaries. Capital Cap — Caps the total eligible balance summed across all participants. Capped APY — Throttles the per-second rate when the natural APY would exceed a ceiling. Cliff (coming soon) — Forfeits a user’s accrued rewards if they exit before a hold window elapses. Deposit Cap — Caps each individual user’s eligible balance at a maximum. Deposit Tiers — Larger positions earn more per token via tiered multipliers. Fixed APY — Pays out at a guaranteed annualized rate, regardless of total balance. Minimum Balance — Users below the threshold earn nothing; users at or above earn on their full balance. New Capital — Only the increase over a snapshot-block balance counts toward rewards. Participant Cap — Limits the number of distinct earners.

Eligibility types

Allowlist — Only addresses on a pre-approved list can earn. Open — Anyone holding the target position can earn. Verified — Only addresses that meet a verification standard (e.g., World ID) can earn.

Other

APY — Annual Percentage Yield. The annualized return rate a user would earn if conditions stayed constant for a year. Cold start — The early phase of a campaign before participation builds up. The natural APY can spike to absurd numbers because the reward pool is divided across very little capital. Capped APY exists to address this.