Introduction

Trustless lottery on Hyperliquid L1, powered by Chainlink VRF and CCIP.

LiquidLottery is a fully on-chain lottery running on Hyperliquid L1 (HyperEVM). Every draw is provably fair — winning numbers are generated by Chainlink VRF v2.5 on Base and delivered cross-chain via Chainlink CCIP. The smart contract is non-custodial: prizes are held on-chain and can be claimed at any time with no expiry.

---

Quick Facts

Detail	Value
Network	Hyperliquid L1 (HyperEVM) — Chain ID 999
RPC	https://rpc.hyperliquid.xyz/evm
Explorer	purrsec.com
Ticket	5 white numbers (1–90) + 1 gold number with position (0–4)
Min price	0.01 HYPE
Max tickets	25 per player per round, 10 000 per round total
Revenue split	50 % Jackpot · 30 % Super Jackpot seed · 20 % protocol fee
Randomness	Chainlink VRF v2.5 (Base) via CCIP
License	MIT

---

What Makes It Different

• Provably fair — randomness from Chainlink VRF, verifiable on-chain.

• Non-custodial — the smart contract holds all funds; no human can move prize pools.

• Cross-chain — draw requests travel Hyperliquid → Base → Hyperliquid via Chainlink CCIP.

• Transparent — open-source contracts, two independent Hashlock security audits.

• No expiry — prizes never expire; claim whenever you want.

• Community safety net — anyone can cancel a stuck draw after 24 hours and earn free ticket credits.

---

Tech Stack

Layer	Technology
Frontend	React 18, Vite 6, wagmi v2, RainbowKit v2
Wallets	MetaMask, Rainbow, Coinbase Wallet, WalletConnect
Smart contracts	Solidity 0.8.28, Hardhat, OpenZeppelin (UUPS proxy)
Randomness	Chainlink VRF v2.5
Cross-chain	Chainlink CCIP
Automation	Node.js server (PM2)

---

Design

• Font: DM Sans (text) + DM Mono (monospace)

• Primary green: #3a7d52 (default) / #4e9967 (light variant)

• Gold accent: #b8860b (default) / #d4a820 (light variant)

• Backgrounds: #faf8f4 (paper), #edeae2 (page bg), #f0ece2 (paper dark)

• Text: #1a1a1a (primary), #4a4a4a (secondary), #7a7a7a (muted)