Protocol Overview
Welcome to the official developer and participant documentation for QanVault, a non-custodial decentralized prize and community jackpot protocol.
QanVault enables transparent, provably fair on-chain draws with deterministic accounting, multi-chain payments across Ethereum and BNB Smart Chain, and 4-in-1 ticket eligibility with zero double counting.
Quick Navigation#
Getting Started
Multi-Chain Architecture & Tokenomics
Technical Whitepaper & Smart Contracts
Core Protocol Metrics#
| Parameter | Value | Description |
|---|---|---|
| Ticket Cost | 100 QANX (~$1.24) | Fixed nominal entry per ticket |
| Draw Tiers | 4 Concurrent Draws | Daily (D), Daily (D+1), Weekly (W), Monthly (M) |
| Daily Pot Share | 50.0% (D) + 30.0% (D+1) | 80% of ticket volume allocated to daily players |
| Weekly Pot Share | 7.5% | ISO week jackpot drawn every Monday at 00:00 UTC |
| Monthly Pot Share | 5.0% | Grand jackpot drawn on the 1st of each month |
| Platform Ops Fee | 7.5% | Covers decentralized keepers, VRF gas, and audits |
| Settlement Hub | BNB Smart Chain | Canonical prize pool & low-fee claims |
| Payment Networks | BSC & Ethereum | Pay with QANX, BNB, ETH, or USDT |
| Bridge Subsidy | 1.0% Fixed Fee | Subsidized cross-chain routing via Symbiosis Finance |
| Claim Window | 72 Hours | Autonomous community rollover if unclaimed |
Key Protocols & Features#
1. 4-in-1 Multi-Draw Entry
A single 100 QANX ticket enters four scheduled draws. Winning in one draw does not disqualify the ticket from subsequent draws. A single entry can win Daily D, Daily D+1, Weekly W, and Monthly M.
2. Contiguous Integer Range Indexing
Tickets are stored as compact sequential intervals [T_{\text{start}}, T_{\text{end}}]. This allows O(1) gas costs when minting large batches and logarithmic O(\log B) winner resolution using binary search.
3. Canonical BSC Settlement Hub
To protect players from prohibitive Ethereum L1 gas fees, all prize disbursements and claim operations settle canonically on BNB Smart Chain in wrapped QANX (0xAAA7915B350aE002B4109403423A39C57cf30663), where claims cost under $0.05.
4. Subsidized Cross-Chain Bridging
Ethereum participants can purchase tickets using native ETH or ERC-20 USDT. QanVault absorbs relayer overhead to cap the bridge fee at an immutable 1.0%, batching liquidity across Symbiosis Finance when the $2,500 threshold is reached.
5. Automated 72-Hour Rollover
Winners have 72 hours to claim prizes. If a winner fails to claim, 100% of unclaimed funds automatically roll over to seed the next pot, ensuring that protocol funds are never permanently locked or confiscated.
Getting Started#
Ready to explore? Begin with our introductory guides: