For the complete documentation index, see llms.txt. This page is also available as Markdown.

Scan Mode campaign

Run a full community campaign with a USDC prize pool.


A Scan Mode campaign builds on a token listing by adding a community-driven reveal mechanic. Collective puzzle activity progressively uncovers a hidden QR code, which eligible players can scan to claim a USDC prize once fully revealed.

Campaign setup

Setting
Description

Reward pool

Total USDC allocated for the campaign, split between winners

Number of winners

How many eligible players receive a share of the prize pool

Campaign games

Target delivery volume — the number of puzzles that need to be generated to fully deliver the campaign

Eligibility rules

Conditions players must meet to claim — token holding, puzzle solves, level requirement, task completion

Promoted task or link

A task or external link featured in the campaign (e.g. follow a profile, visit a page)

Rounds

After Round 1 ends, Round 2 begins with a fresh milestone cycle

How delivery works

Scan Mode progress is based on delivered games, not wins.

1 generated puzzle while the campaign is active
= 1 consumed play from the campaign pack
= 1 delivered campaign game

Progress is tracked as delivered_games / target_games.

While a Scan Mode campaign is active, general puzzle packs on the same token pause automatically. They resume in FIFO order once the campaign ends.

Milestone schedule

Delivered games progressively unlock tiles of the hidden QR. The milestone schedule is set per campaign — exact thresholds depend on the project and campaign configuration. Once all 9 tiles are revealed, eligible players can scan the QR and claim from the prize pool.

Eligibility and claims

Campaign delivery and claim eligibility are tracked separately. Even after full delivery, players must meet all campaign conditions to claim: token holding requirements, puzzle solves, task completion, level threshold, and anti-cheat checks. Only users who meet all conditions can claim when the campaign opens.

Last updated