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

Puzzle Mode

Get your token logo inside QRbase puzzles.


A token listing embeds your token's logo directly inside QR puzzles. Players see it on every solve — not as a separate advertisement, but as part of the puzzle itself.

To apply, use the "+ TOKEN / Apply For Listing" option on the Scan Mode page, or the "Prizes / List Your Token" option on the Puzzle Mode page.

What's included

Your token logo appears within the QR image across all puzzle difficulties.

Your token gets a dedicated entry on the Prizes page with a live counter tracking puzzle activity for that token.

Puzzle packs

Visibility in Puzzle Mode is powered by puzzle packs. Tier 1 tokens can hold two pack types:

Pack type
Description

FREE_LISTING

Included with every token listing — one free pack per account

PAID_GENERAL

Additional packs purchased for extended visibility

Packs are consumed one at a time in FIFO order — the next pack starts only when the current one is finished.

If a Scan Mode campaign becomes active on your token, general packs pause automatically and resume once the campaign ends.

What players see

Players solving puzzles don't select which token appears — the pool rotates. The token logo is visible within the puzzle itself, and all listed tokens with their current activity are shown on the Prizes page.

Cover

Partner Space

When a partner creates a puzzle, a Partner Space becomes available. This is a dedicated dashboard where the partner can monitor their puzzle's activity and access all related information.

What is not included

A token listing does not include a Scan Mode campaign, the hidden QR mechanic, or a USDC prize pool. Those features are part of Scan Mode.

Last updated