About Sui Wheel

This app lets you create an on-chain prize wheel on Sui Testnet, spin to pick winners, and track results. Connect your wallet, configure entries and prizes, and spin fairly using on-chain randomness.

Note: This app supports both off-chain and on-chain on Sui. To use on-chain features, please connect your wallet.

Guide for Organizers

• Connect wallet (prefer Slush Wallet)
• Add entries, prizes, timing, and fund pool
• Update entries/prizes/timing only before any spins (coming soon)
• Spin to select winners randomly
• After all spins, reclaim unclaimed funds after claim window

Wheel Mechanism

The wheel uses on-chain randomness to select winners from the remaining entries without replacement (unique winners). Each spin removes the winner and all their duplicate entries if any. Winners are assigned prizes in the order of spins. Claims are time-locked with a delay and must occur within the claim window after their spin. The organizer controls spins and can cancel the wheel before spins to reclaim the pool.

Rules

• Minimum 2 entries, maximum 200; entries must have at least as many unique addresses as prizes.
• Prizes must be fully funded in the pool before spins.
• Claim window minimum 1 hour, default 24 hours if not specified.
• Winners must claim within their time window or forfeit the prize.
• No updates after spins start; wheel can be cancelled only before spins.
• Auto-assign last prize if one entry remains for the final spin.

Features

• Multi-token Rewards: Organizers can choose SUI or other tokens/coins for prizes.
• Robust Data Fetching: Utilizes GraphQL (beta) with automatic fallback to RPC for reliable data access.
• X Integration: Import entries directly from X (Twitter) posts (requires API key).
• Analytics: Track spins and outcomes (uses MongoDB for optional off-chain backup).

Roadmap

• ✅ Initial release
• ✅ Multiple reward tokens support
• ✅ GraphQL query support (beta)
• Edit entries & prizes (guarded)
• Support Sui Names for entries

Built with Svelte 5, Tailwind CSS 4 and daisyUI.

Configuration

Create a .env file (copy from .env.example) to configure optional features:

• DATABASE_URL: MongoDB connection string. Optional. Required if you want to enable analytics.
• X_API_KEY: X (Twitter) API Key. Optional. Required for importing entries from X posts.
• PUBLIC_ENOKI_API_KEY & PUBLIC_GOOGLE_CLIENT_ID: Required for Google login (use Enoki ZkLogin). Visit https://enoki.mystenlabs.com/ to setup.

Front-end deployment (simple)

Requirements

• Node.js 22.12.0 (configured in netlify.toml)
• pnpm 10.25 (the project uses pnpm as the package manager; see package.json)

Enable Corepack to use the exact pnpm version:

corepack enable
corepack prepare [email protected] --activate
pnpm --version

Run locally

Use the scripts from package.json:

pnpm install
pnpm dev       # start the dev server
pnpm build     # build the app
pnpm preview   # preview the production build locally

Deploy to Netlify (recommended)

This project is already configured with the Netlify adapter and netlify.toml:

1. Connect this repo to Netlify (New site from Git > select this repo)
2. Settings:
   • Build command: pnpm build
   • Publish directory: build
   • Node version: 22.12.0 (already in netlify.toml)
3. Deploy. Each push to the default branch will auto build & deploy.

Deploy with Netlify CLI (optional)

# Log in and initialize the site (first time)
pnpm dlx netlify-cli@latest login
pnpm dlx netlify-cli@latest init

# Build using the package.json script
pnpm build

# Deploy the build directory to production
pnpm dlx netlify-cli@latest deploy --dir=build --prod

Note: This is a front-end app using SvelteKit + the Netlify adapter, no separate backend required. If you need environment variables, set them in your Netlify site settings.