Wallet Limits

Control how many times each wallet can claim.

The "Max Claims per Wallet" setting controls how many times the same person can claim from your campaign. This prevents a single user from draining all your codes.

This is separate from the total number of claims in your campaign, which is determined by the number of codes (unique mode) or the max claims setting (shared mode). See Code Modes for details.

How it works

Note
Wallets are identified by their stake key (reward address). This stays the same across all addresses, even if someone generates a new receiving address. This makes it a reliable deduplication mechanism.

Configuration

  • Leave empty for unlimited claims per wallet (no restriction).
  • Set to 1 (highly recommended) for exclusive drops where each wallet can claim exactly once.
  • Set to a higher number for scenarios like treasury hunts where collecting multiple codes is part of the game.

Shared QR mode

In shared QR mode, the wallet limit is always 1 per stake key regardless of the setting. This is built into the shared mode logic to prevent a single wallet from claiming multiple times from the same shared code.

Edge cases

  • Wallets without a stake key (enterprise addresses) are identified by their payment key hash instead.
  • If a claim transaction fails, the attempt does not count against the wallet limit. The code is released and the wallet can try again.