# LiquidLottery

> Provably fair, non-custodial on-chain lottery on Hyperliquid L1, powered by Chainlink VRF.

LiquidLottery is a decentralised lottery protocol deployed on Hyperliquid L1 (HyperEVM, Chain ID 999). Randomness is generated by Chainlink VRF v2.5 on Base and relayed cross-chain via Chainlink CCIP. There is no backend and no operator involvement — the smart contract handles ticket sales, draws, settlement, and payouts autonomously.

## Key facts

- Ticket price: from 0.01 HYPE (dynamic, based on pool size; max 0.5 HYPE). Up to 25 tickets per player per round.
- Jackpot (5/5 match): 50% of ticket revenue goes to the round jackpot pool. Rolls over if unclaimed.
- Super Jackpot (5/5 + gold position): 30% of ticket revenue seeds a cross-round super jackpot, won by matching all 5 whites + gold number at the exact drawn position.
- Fee split: 20% total fee — 10% to GoldenTicket NFT holders, 7% to protocol, 3% referral commission (when referred; otherwise 10% to protocol).
- Draws: triggered automatically by Chainlink Automation or publicly by any user after a grace period. Randomness is verifiable on-chain.
- Prizes: held in the smart contract with no expiry — claim at any time.
- Max 10,000 tickets per round.

## GoldenTicket NFT

10 founder NFTs (ERC-721). Each GoldenTicket earns 1% of ALL protocol fees — forever, with no expiry. Fully transferable. Revenue is claimed per-token via the lottery contract. One GoldenTicket is reserved as a prize for the first Super Jackpot winner (minted automatically by the smart contract).

## Referral program

Players can share a referral link. When someone buys tickets using a referral link, the referrer earns 3% of the ticket cost — permanently, with no cap. Referrer registration is one-time and permanent on-chain. Referral earnings are claimable at any time.

## Security

- Smart contracts: fully open source, UUPS upgradeable proxy pattern
- 72-hour timelock on upgrades (with 1-hour execution window)
- 48-hour timelock on admin configuration changes
- Emergency cancel: anyone can cancel a stuck draw after 24 hours
- Reentrancy guards, strict access controls, no admin key over funds

## Pages

- [Landing page](https://liquidlottery.app/) — overview, FAQ, legal
- [Dapp](https://go.liquidlottery.app/) — buy tickets, check results, claim prizes, mint GoldenTicket, earn referral rewards
- [LLMs.txt](https://liquidlottery.app/llms.txt) — this file

## Legal

- [Terms of Service](https://liquidlottery.app/legal/terms.md)
- [Privacy Policy](https://liquidlottery.app/legal/privacy.md)
- [Risk Disclaimer](https://liquidlottery.app/legal/disclaimer.md)

## Technical

- Smart contracts: open source, deployed on Hyperliquid L1 (HyperEVM, Chain ID 999)
- Randomness: Chainlink VRF v2.5 (Base) → Chainlink CCIP cross-chain relay → HyperEVM
- Frontend: React SPA at go.liquidlottery.app
- Landing page uses Google Analytics for anonymous traffic metrics