Midnight Dice Roll

A DiceRoll Game : This project is built on the Midnight Network.

This project demonstrates how to derive dice outcomes from entropy, call the contract, and present a clean UI that reflects on-chain state in real time.

---

What this demonstrates

This project focuses on verifiable on-chain roll history:

• A 32-byte secret is generated per roll
• Two dice values are derived deterministically
• The DiceRoll contract stores the outcomes and increments roll count
• The UI displays the latest roll and recent history

---

Features

• DiceRoll Contract Integration Records two dice values and totals on-chain

• Deterministic Roll Derivation Dice values are derived from a fresh secret each roll

• CLI Experience Simple terminal flow for on-chain rolls

• Web UI (Next.js) Real-time dice visualization and roll history

---

Setup

1. Install dependencies

npm install

---

2. Start the proof server

Make sure Docker is running:

docker run -p 6300:6300 midnightntwrk/proof-server:8.0.3 -- midnight-proof-server -v

---

3. Compile contract

npm run compile

---

4. Deploy contract

export PRIVATE_STATE_PASSWORD='your-strong-password'
npm run deploy

Notes:

• You’ll be prompted for a seed if not set
• Ensure wallet has at least 1,000,000 DUST

---

🎲 Roll Dice (CLI)

npm run roll

Verbose mode:

npm run roll:verbose

---

🌐 Web UI (Next.js)

The project includes a DiceRoll web frontend.

1. Start the House Server

   export PRIVATE_STATE_PASSWORD='your-strong-password'
   npx tsx src/server.ts

2. Launch the UI

   cd ui
   npm run dev

3. Open http://localhost:3000 to roll dice and view roll history.

---

Example Flow

🎲 Roll initiated
→ Dice values derived from entropy
→ roll_dice called on-chain

🎯 Result: 4 + 2 = 6
✅ Recorded on Midnight

---

Tests

Run tests:

npm test

Covers:

• dice value range validation
• deterministic roll derivation
• distribution sanity checks

---

Built on Midnight

Showcasing privacy-preserving computation and verifiable execution.

---

Author

Kali-Decoder