# Introduction

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

LiquidLottery is a fully on-chain lottery running on [Hyperliquid L1 (HyperEVM)](https://hyperliquid.xyz). Every draw is provably fair — winning numbers are generated by [Chainlink VRF v2.5](https://chain.link/vrf) on Base and delivered cross-chain via [Chainlink CCIP](https://chain.link/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](https://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 · 10% GoldenTicket holders · 7% Protocol · 3% Referral |
| **Randomness**    | Chainlink VRF v2.5 (Base) via CCIP                                                          |
| **License**       | MIT                                                                                         |
| **Source code**   | [github.com/LiquidLottery/contracts](https://github.com/LiquidLottery/contracts)            |

***

## 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.
* **GoldenTicket NFTs** — 10 founder NFTs that each earn 1% of all protocol fees, forever. The first Super Jackpot winner receives one automatically.
* **Referral program** — share your link and earn 3% of every ticket your referrals buy, permanently.

***

## 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)

***

## Community

* 🌐 [hypepool.app](https://hypepool.app) — Landing page
* 🎰 [go.hypepool.app](https://go.hypepool.app) — Play the Dapp
* 🐦 [X / Twitter](https://x.com/LiquidLotteryX)
* 💬 [Telegram](https://t.me/LiquidLottery)