Code Modes

When creating a campaign, you choose between two code distribution modes. This affects how QR codes are generated and how recipients claim their tokens.

Unique codes (default)

Each code is typically claimed once. You get a set of individual QR codes that you can print, cut, and hand out individually. This is the standard mode for most events. You can adjust how many times each wallet may claim via the wallet limit setting.

• One code per person, usually one claim per code
• Ideal for badge inserts, flyer handouts, sticker distribution
• Each code has its own URL with a unique suffix
• Unclaimed codes can be deactivated individually

Shared QR code

A single QR code that multiple wallets can scan. Instead of handing out individual codes, you display one QR code on a screen, poster, or slide. Each wallet (identified by its stake key) can claim once.

• One QR code displayed to everyone
• Perfect for conference screens, slides, posters, or social media
• Deduplication happens by stake key, so each person can only claim once
• You set a "Max Claims" number instead of "Number of Codes"

Shared QR codes work best for in-person events with a known audience size. Posting a shared QR code publicly (social media, YouTube, etc.) is not recommended. Automated bots can create wallets and drain claims faster than rate limits can prevent. For online distribution, use unique codes instead.

At events with shared WiFi, multiple users claiming at the same time may hit rate limits. In that case, users should switch to mobile data temporarily.

How limits work

Campaigns have two independent limit settings:

Total claims controls the overall capacity of your campaign.

• Unique codes: the "Number of Codes" you generate. Each code can be claimed once.
• Shared QR: the "Max Claims" you set. This is the total number of times the shared code can be used.

Per-wallet limit controls how often the same wallet can claim from your campaign.

• Unique codes: "Max Claims per Wallet" limits how many different codes a single wallet (stake key) can redeem. Defaults to 1.
• Shared QR: always 1 per wallet (hardcoded). Each stake key can claim exactly once.

Example: A shared QR campaign with Max Claims = 200 allows up to 200 different wallets to claim, one claim each. A unique code campaign with 500 codes and Max Claims per Wallet = 3 allows each wallet to claim up to 3 different codes.

When to use which

Claimpaign is built for in-person events where you hand out QR codes physically. Online distribution (social media, email campaigns) is possible but not the primary use case.