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.
Choosing a Product
Should I use Time-Based Incentives or One-Time Actions?
Should I use Time-Based Incentives or One-Time Actions?
Use Time-Based Incentives when you want users to be rewarded for how long and how much they keep capital in your protocol — for example, depositors holding a position in a vault, lenders, LPs, or stakers. Rewards accrue continuously over the campaign window.Use One-Time Actions when you want to reward a discrete onchain action — a swap, mint, vote, delegation, or contract call. Each qualifying user can claim once.If you’re not sure, reach out to the team and we can help you pick.
Can I run both kinds of campaigns?
Can I run both kinds of campaigns?
Yes. The two products are independent and serve different goals, so it’s common for a protocol to use both at different times.
Onboarding & Setup
How do I get started?
How do I get started?
- One-Time Actions are self-serve. Sign in at boost.xyz and follow Setting up Accounts to create your team and deploy your first campaign.
- Time-Based Incentives are partnership-driven. Email the Boost team to scope a campaign — see Launch a Campaign for what onboarding looks like.
Do I need a crypto wallet to get started?
Do I need a crypto wallet to get started?
No. The platform uses Privy for authentication and creates an embedded wallet automatically when you sign in with email or Google.
How long does it take to launch a campaign?
How long does it take to launch a campaign?
- One-Time Actions: Action review takes 24-48 hours. Once approved, deploying the campaign takes a few minutes.
- Time-Based Incentives: Onboarding timelines depend on integration scope. Plan to start the conversation a couple of weeks before you want to go live.
Fees & Funding
What does it cost?
What does it cost?
Boost charges a 10% protocol fee on rewards distributed through One-Time Actions. The fee is added on top of your spend limit when you deploy — if you want to distribute 1,000 USDC, you’ll need 1,100 USDC in your budget account. The fee is only charged on rewards that are actually claimed.Time-Based Incentives campaign economics are scoped during onboarding.
Who funds the rewards?
Who funds the rewards?
The protocol running the campaign funds it. Rewards are sent from a budget account (One-Time Actions) or a campaign-funded reward pool (Time-Based Incentives) that you control.
Can I get unused funds back?
Can I get unused funds back?
Yes. If a campaign ends with rewards left undistributed, the unused balance is recoverable by the team that funded it.
Chains & Tokens
What chains are supported?
What chains are supported?
One-Time Actions sponsored transactions are supported on Base, Optimism, Celo, and World Chain. Other EVM chains may be available depending on the campaign — reach out if you need a specific chain.
What tokens can I use as rewards?
What tokens can I use as rewards?
For One-Time Actions, only whitelisted ERC-20 tokens can be used. The whitelist includes popular, verified tokens on each supported chain. If your token isn’t listed, request it on Discord with the contract address and chain — requests are typically reviewed within 24-48 hours.For Time-Based Incentives, the reward token is configured during campaign setup with the team.
For Your Users
Where do users see and claim rewards?
Where do users see and claim rewards?
Both products surface campaigns to end users on rabbithole.gg — Boost’s consumer app. Users browse active campaigns, track their progress, and claim rewards directly from there. You don’t need to host a claim UI yourself.
Do users need ETH for gas?
Do users need ETH for gas?
On supported chains, transactions are sponsored, so users don’t need ETH to claim. Time-Based Incentives also has a gasless earning activation flow for opting in.
Can I prevent bots or sybil farming?
Can I prevent bots or sybil farming?
Yes:
- One-Time Actions support allowlists — restrict claims to a specific set of addresses (NFT holders, token holders, partner communities, etc.).
- Time-Based Incentives support eligibility filters like minimum balance, new capital only, and earning activation, which limits rewards to users who actually came through Boost.
Running Campaigns
Can I end a campaign early?
Can I end a campaign early?
Yes. The team that owns the campaign can stop it at any time. Remaining funds are returned to the funding account.
Can I add more budget to an active campaign?
Can I add more budget to an active campaign?
For One-Time Actions, you can top up the budget at any time from the dashboard. Time-Based Incentives campaigns are sized at launch and don’t currently support mid-flight top-ups.
Where do I see analytics?
Where do I see analytics?
- One-Time Actions: Your dashboard at boost.xyz shows claims, budget used, average cost per claim, and recent activity.
- Time-Based Incentives: Your campaigns appear on rabbithole.gg with TVL, participants, and distributed rewards visible alongside the user-facing view.
What happens to rewards users never claim?
What happens to rewards users never claim?
Anything unclaimed at the end of the campaign’s claim window is recoverable by the funding team.
Still Have Questions?
Email the team
Discord
Community support and faster questions