🎡

Wheel on Chain

● Live on Sepolia

Blockchain-based Lucky Wheel Game Platform · Provably Fair · On-chain Verifiable

Visit DApp

Self-Hosted

Runs on a Mac Mini kept online 24/7, serving both frontend and backend locally.

Cloudflare Tunnel

Publicly accessible via Cloudflare Tunnel at wheelonchain.xyz

EVM Compatible

Deployed on Sepolia testnet. Easily portable to any EVM chain where Chainlink VRF is supported.

About the Project

Wheel on Chain is a blockchain-based lucky wheel game platform built on Ethereum. It provides a transparent and provably fair lottery experience where users can participate with ETH, and winners are selected using Chainlink VRF (Verifiable Random Function) to guarantee on-chain verifiable randomness.

The entire stack — frontend, backend, and WebSocket server — runs on a personal Mac Mini kept online 24/7. Public access is provided through a Cloudflare Tunnel, exposing the app at wheelonchain.xyz.

Smart contracts are deployed on the Sepolia testnet and can be re-deployed to any EVM-compatible chain supported by Chainlink VRF (e.g., Ethereum mainnet, Polygon, Avalanche, BNB Chain, and more).

Architecture Overview

FRONTENDNext.js + React + Chakra UI

↕ HTTP / WebSocket

BACKENDNode.js + WebSocket · Mac Mini (local)

↕ Cloudflare Tunnel → wheelonchain.xyz

PUBLICInternet users access via wheelonchain.xyz

↕ ethers.js RPC calls

CHAINEthereum (Sepolia) + Smart Contract

↕

DBMySQL (local)

Frontend

React

Next.js 14

React 18

Chakra UI

Tailwind CSS

Zustand

GSAP

Framer Motion

React Query

Backend

Node.js

WebSocket

MySQL

ethers.js v6

Winston Logger

Blockchain

Solidity

Solidity ^0.8.23

Ethereum (Sepolia)

Chainlink VRF V2+

OpenZeppelin ERC721

Foundry

Merkle Proof

Core Features

Round System

Game runs in rounds with fixed time windows for players to join and place bets

Chainlink VRF

Provably fair random winner selection using Chainlink VRF for on-chain verifiable randomness

Reward Distribution

Winners receive the full prize pool (minus protocol fees), claimable directly from the smart contract

Wallet Integration

Seamless MetaMask connection with support for Sepolia testnet ETH transactions

Multiple Entries

Players can enter multiple times per round to increase their winning chances

Real-time Updates

WebSocket-powered live game state, dynamic wheel rendering, and countdown timers

Multi-language

Full internationalization support with Chinese and English interface switching

NFT Lottery

ERC-721 NFT with Merkle-based whitelisting and weekly VRF-powered draws with ETH rewards

Smart Contract Highlights

WheelNFT

ERC-721 Enumerable NFT with 100 max supply and Merkle-based whitelist claim system

Chainlink VRF V2+ integration for provably fair weekly draws and bulk randomness

Automated reward distribution: 10 winners per draw with on-chain prize pool management

ReentrancyGuard, pausable contract, and emergency admin functions for safety

Two-phase draw: VRF callback stores randomness, then finalize distributes rewards to reduce gas

Complete draw history and per-token reward tracking with batch claim support

Network & Deployment

Current Network

Sepolia Testnet

Ethereum test network with real Chainlink VRF integration

Hosting

Mac Mini + Cloudflare

Self-hosted 24/7 with zero-infrastructure Cloudflare Tunnel exposure

Chain Portability

Any EVM + Chainlink

Works on Polygon, Avalanche, BNB Chain, Arbitrum, Optimism & more

Try the DApp

Play the lucky wheel on Sepolia testnet — provably fair, on-chain verifiable

wheelonchain.xyz Wheel Contract on Etherscan GitHub