Skip to main content
AirdropCovenant lets eligible addresses claim a fixed amountPerClaim from a funded pool. Claim submission is permissionless, while a backend-held claim-authority key co-signs each claim after eligibility checks. Authority controls campaign-level pause, resume, and cancel.

​
Use Cases

  • Token launches and community drops
  • Protocol incentive distributions
  • Retroactive user rewards

​
How It Works

​
Key Properties

PropertyDetail
Claim amountFixed. Identical for every claimer.
EligibilityEnforced off-chain by claim-authority co-signing policy (open or merkle/KYC).
Time windowOptional startTimestamp and endTimestamp
Pool behaviorAuto-completes when totalClaimed >= totalPool
AuthorityCan pause, resume, or cancel. Cancel returns remainder.

​
NFT State

[0]:    status
[1]:    flags
[2-9]:  total_claimed (uint64)
[10-17]: claims_count (uint64)
[18-22]: last_claim_timestamp (5 bytes)
[23-39]: reserved

​
Creating an Airdrop

See Create an Airdrop for the step-by-step guide.

​
Contract Reference

See AirdropCovenant for full parameter and function documentation.