Hook-gated entry
A Uniswap v4 hook can verify pool, notional, cooldown, and wallet limits before a draw request is created.
Protocol Summary
A campaign layer for pools that need measurable, transparent incentives.
BlindBox V4 is built for liquidity programs, partner launches, and recurring trading campaigns that need measurable incentives without sacrificing transparency.
Verifiable randomness
Draw outcomes are derived from oracle-backed randomness and published settlement events.
Budget-aware rewards
Campaign operators can publish vault balances, tier caps, claim windows, and per-wallet limits.
Auditable receipts
Each qualified swap can be linked to a request id, tier result, claim status, and settlement transaction.
How It Works
The product turns swap activity into controlled reward requests.
01
Swap observed
The hook receives swap context and checks whether the pool is enrolled in a campaign.
02
Eligibility scored
Notional size, wallet cooldown, pool direction, and campaign rules determine entry count.
03
Randomness requested
A request id maps the draw to a verifiable random seed and prevents hidden rerolls.
04
Tier selected
Probability bands and remaining vault budget decide the reward category and maximum value.
05
Claim settled
The user claims within the published window, or the allocation returns to the campaign vault.
Implementation Notes
Pool layer
Uniswap v4 hook qualification and event emission.
Random layer
VRF-compatible request, seed, and fulfillment flow.
Reward layer
Vault budget, tier caps, settlement receipts, and claims.
Campaign Guardrails
- Campaign terms remain visible across active pools.
- Vault funding is visible for each reward draw.
- Reward caps and exclusions shown in UI.
Reward Design
Reward tiers designed for repeat participation and clear campaign limits.
Each tier is tied to published probability bands, claim windows, wallet limits, and campaign-level reward budgets.
| Tier | Typical Reward | Probability Band | Budget Guardrail | Claim Rule |
|---|---|---|---|---|
| Common | Small fee credit or points allocation |
62%
|
Per-swap maximum | Auto-claimable |
| Boost | Next-swap entry multiplier or gas offset |
27%
|
Daily wallet cap | Expires after 72 hours |
| Rare | Partner allowlist or fixed USDC reward |
9%
|
Campaign-level cap | Manual eligibility check |
| Epic | Larger vault payout or sponsor-backed package |
2%
|
Hard budget ceiling | Claim plus review |
Operator Controls
Professional incentive campaigns need guardrails as much as rewards.
Rate limits
Per-wallet cooldowns, daily draw limits, and maximum entries per swap reduce repetitive extraction.
Eligibility rules
Minimum notional, approved pools, excluded addresses, and partner-specific terms are configured before launch.
Treasury controls
Reward vaults can expose remaining budget, pending claims, and allocation ceilings in the interface.
Terms disclosure
Campaign copy avoids guaranteed-yield language and makes claim windows, restrictions, and review steps explicit.
Monitoring
Request ids, settlement delays, failed claims, and pool-level draw volume can be reviewed after launch.
Pause path
A campaign pause can stop new reward requests while preserving existing claim receipts.
Weekly Leaderboard
Verified activity gives participants a reason to come back.
| Rank | Wallet | Weekly Points | Qualified Swaps | Best Tier | Claimed |
|---|
Swap & Open
Enter a swap amount, earn entries, and open every BlindBox.
USDC
Entries
3
Fee Budget
$0.75
BlindBox Queue
Your boxes are ready to open.