Getting Started
How to Refer & Earn
The QanVault protocol features a built-in referral rewards system that allows community advocates and players to earn bonus tickets by sharing the platform.
The 1:10 Bonus Ticket Mechanism#
For every 10 tickets purchased by a referred player, the referrer receives 1 bonus ticket free of charge:
\text{Bonus Tickets Earned} = \left\lfloor \frac{\text{Referred Tickets Purchased}}{10} \right\rfloor
- Zero Deduction for Buyers: The referred player receives 100% of their purchased tickets. Referral bonus tickets are funded out of the protocol's promotional reserve.
- Full Draw Eligibility: Referral bonus tickets are genuine tickets that participate across all four scheduled draws (Daily D, Daily D+1, Weekly, and Monthly).
- Proportional Scaling: If your referral buys 100 tickets, you earn 10 bonus tickets; if they buy 1,000 tickets, you earn 100 bonus tickets.
How to Get Your Referral Link#
- Connect your Web3 wallet at qanvault.io.
- Navigate to the Referrals Dashboard.
- The platform will automatically generate your unique referral link using your wallet address:
text
https://qanvault.io/?ref=0xYourWalletAddress- Click Copy Referral Link or use the social sharing shortcuts for Twitter/X and Telegram.
How Attribution Works#
QanVault uses a transparent, dual-layer attribution model:
01
Share Link
Share your unique referral URL (?ref=0xYourAddress) with friends and community.
02
First-Touch Attribution
When visited, the referee's browser securely stores your address in local storage.
03
On-Chain Verification
When the friend purchases tickets, your referrer address is passed into EverpotCore.
04
1:10 Bonus Tickets
For every 10 tickets purchased by your referral, you instantly receive 1 bonus ticket minted on-chain.
- Client-Side Capture: When a new user lands on the website with a
?ref=query parameter, their browser securely persists the referrer address in local storage. - First-Touch Attribution: If a user visits multiple referral links, the first link clicked is honored to protect original content creators.
- On-Chain Minting: During the purchase transaction, the contract verifies the referral address and mints bonus ticket IDs directly into the referrer's portfolio.
Anti-Sybil & Fair Play Rules#
To maintain protocol integrity:
- Self-Referral Prohibition: A wallet address cannot refer itself (
buyer != referrer). Transactions attempting self-referral will execute normally but will award 0 bonus tickets. - Minimum Batch Threshold: Bonus tickets are awarded for full multiples of 10. Unused fractional balances accumulate toward future purchases from the same referred wallet.
- Contract Safety: Smart contract referrers must be able to receive ERC-721 or contract-minted tickets.
Next Steps#
- Check your referral stats: Referrals Dashboard
- Review ticket rules: Ticket Mechanics
- Learn about protocol economics: Tokenomics