🎲 TruDelník Game

Web3 Risk-Based Gaming with Verifiable Randomness

Monorepo for TruDelník, a decentralized gambling game where players stake cryptocurrency, progress through risk-based steps with exponentially rising multipliers, and cash out anytime or lose it all. Built with verifiable blockchain randomness and complete transparency.

Built for ETHGlobal Prague 2025 🇨🇿

You can find a live demo here: https://trudelnik.netlify.app

🎮 Game Concept:

TruDelník is a high-stakes, step-based gambling game where:

• 🎯 Stake & Risk: Players stake ETH/BERA and choose difficulty levels
• 📈 Rising Multipliers: Each successful step increases potential winnings exponentially
• 💰 Cash Out Anytime: Players can exit with current winnings before the next step
• 💥 All or Nothing: One failed step loses the entire stake
• 🔐 Provably Fair: Blockchain-verified randomness ensures complete transparency

Difficulty Levels:

🟢 Easy

• Success Rate : 90%
• Max Steps : 24
• Max Multiplier : 24.5x

🟡 Medium

• Success Rate : 85%
• Max Steps : 22
• Max Multiplier : 2,254x

🔴 Hard

• Success Rate : 70%
• Max Steps : 20
• Max Multiplier : 52,067x

⚫ Hardcore

• Success Rate : 55%
• Max Steps : 15
• Max Multiplier : 3,203,384x

🏗️ Architecture:

trdelnik-game/ ├── 🏛️ contracts/ # Solidity smart contracts │ ├── Game.sol # Flare Network version │ └── BerachainGame.sol # Berachain version with Pyth Entropy ├── 🎨 frontend/ # React/TypeScript interface │ ├── Multi-chain support │ ├── Merits integration │ └── Akave storage └── 📚 Documentation & deployment scripts

🤝 Partner Integrations:

🔥 Flare Network - Secure Randomness

• Implementation: RandomNumberV2Interface in Game.sol
• Network: Coston2 Testnet (Chain ID: 114)
• Status: ✅ Fully Functional
• Features:
  • Synchronous random number generation
  • Built-in randomness verification
  • Production-ready deployment

⚡ Pyth Network - Entropy Protocol

• Implementation: IEntropy and IEntropyConsumer in BerachainGame.sol
• Network: Berachain Mainnet (Chain ID: 80094)
• Status: 🔄 Under Development (transactions succeed but events not emitted)
• Features:
  • Asynchronous randomness with callbacks
  • User-provided entropy mixing
  • Fee-based randomness requests

🔍 Blockscout - Merits, Explorer & SDK Integration

• Implementation: Merit-based leaderboard system + Blockscout SDK (https://docs.blockscout.com/devs/blockscout-sdk) integration
• Status: ✅ Fully Functional + 🎯 ETHGlobal Bounty Target ($3,000 for best SDK usage)
• Features:
  • 🏆 Merit System: 1 Merit awarded per game played
  • 📊 Leaderboard rankings based on Merit balance
  • 🔒 Feature gating: Advanced difficulties require Merit thresholds
  • 🔍 Transaction explorer integration for game verification
  • 🔔 Real-time Notifications: Transaction toast notifications with pending/success/error states
  • 📝 Transaction History: Popup with recent transactions for addresses or entire chains
  • 📱 Mobile-responsive: Optimized SDK integration for all devices
  • 🔗 Deep Integration: Transaction interpretation and detailed summaries

📦 Protocol Labs (Akave) - Decentralized Storage

• Implementation: Proof-of-play storage system
• Status: ✅ Fully Functional
• Features:
  • Game history stored on decentralized storage
  • Randomness transparency - all game infos recorded
  • Immutable records of wins, losses, and payouts
  • CORS-configured for seamless frontend integration

🌐 Multi-Chain Support:

🔥 Coston2

• Contract Type : TrdelnikGame
• Randomness Provider : Flare Randomness
• Status : ✅ Live

🐻 Berachain

• Contract Type : BerachainGame
• Randomness Provider : Pyth Entropy
• Status : 🔄 Testing

Chain Selector:

• Automatic detection of connected wallet network
• Seamless switching between supported chains
• Chain-specific contract interactions and fee handling

🚀 Key Features:

🎲 Provably Fair Gaming

• Blockchain-verified random number generation
• Transparent randomness sources (Flare/Pyth)
• Immutable game state and history

💎 Merit System

• Earn Merits for every game played
• Unlock features with Merit requirements
• Leaderboard competition with other players

📊 Complete Transparency

• All game data stored on Akave
• Transaction hashes for every action
• Randomness proofs publicly verifiable

🎨 Modern UI/UX

• Responsive design with Tailwind CSS
• Real-time updates and animations
• Multi-chain wallet integration
• 🔔 Transaction Notifications: Real-time toast notifications for all game actions
• 📜 Transaction History: Instant access to transaction history with Blockscout SDK
• 📱 Mobile-optimized: Seamless experience across all devices

🛠️ Technical Stack:

Smart Contracts

• Solidity ^0.8.0 with OpenZeppelin security
• Hardhat development environment
• Multi-network deployment automation

Frontend

• React 18 with TypeScript
• Vite for fast development
• Tailwind CSS for styling
• ethers.js for blockchain interaction
• @blockscout/app-sdk (https://www.npmjs.com/package/@blockscout/app-sdk) for transaction notifications and history

Blockchain Integration

• MetaMask wallet connection
• Multi-chain support (Flare, Berachain)
• Automatic network switching
• Real-time transaction tracking with Blockscout SDK integration

🚦 Current Status:

✅ Working Features

• ✅ Flare Network deployment - fully functional
• ✅ Multi-chain frontend with chain detection
• ✅ Merit system integration
• ✅ Akave storage for game history
• ✅ Complete UI/UX for all game functions

🔄 In Development

• 🔄 Pyth Entropy integration - debugging event emission issue

🎯 ETHGlobal Prague 2025:

This project showcases the integration of cutting-edge blockchain technologies:

• 🔐 Verifiable Randomness from multiple sources
• 📊 Decentralized Data Storage with Protocol Labs
• 🏆 Merit-based Gamification with Blockscout
• 🌍 Multi-chain Architecture for broader accessibility

TruDelník demonstrates how Web3 gaming can achieve:

• Complete transparency in random number generation
• Immutable game records stored decentrally
• Cross-chain user experiences
• Community-driven progression systems

🎯 ETHGlobal Bounties Targeted

• 🔍 Blockscout SDK Integration: $3,000 bounty for best SDK usage (https://docs.blockscout.com/devs/blockscout-sdk)
  • Real-time transaction notifications in gaming interface
  • Transaction history popup for game verification
  • Enhanced UX with mobile-responsive design

---

🚀 Quick Start:

Clone the repository

git clone https://github.com/yourusername/trdelnik-game cd trdelnik-game

Install dependencies - both FE and SC

npm install

Set up environment variables - both FE and SC

cp .env.example .env

Deploy contracts

cd contracts && npm run deploy:coston2

Start frontend

cd ../frontend && npm run dev

🔗 Links:

• 🎮 Live Demo: https://trudelnik.netlify.app
• 🔍 Explorer: (Coston2 Blockscout) https://coston2-explorer.flare.network/
• 📊 Merits: (Blockscout Merits) https://merits-staging.blockscout.com/

---

Built with ❤️ for ETHGlobal Prague 2025 🇨🇿

TruDelník lives or dies on provably fair randomness, so we wired that layer before anything else. On Flare (Coston2) we call RandomNumberV2Interface and get a value back in the same transaction—no waiting, no polling, instant UX. On Berachain we lean on Pyth Entropy, an asynchronous oracle that emits a callback once the randomness is ready. Every game round stores the request-ID, so when the oracle fires we stitch the answer to the right player and step. The result: one codebase, two randomness modes, both publicly verifiable and signed by their respective networks

How the rest comes together • Smart contracts — Solidity 0.8.25, zero upgradeability for transparency. Two concrete contracts share a common library: one speaks Flare’s sync API, the other implements IEntropyConsumer.receiveEntropy. We pack game state into a four-field struct and push full play history to IPFS via Akave so the chain stays lean. • Front-end — React 18 + Vite + Tailwind. State lives in a lightweight Zustand store; an useRandomness hook transparently handles the “sync vs async” dance and shows either an instant multiplier or a spinner that resolves on callback. • Blockscout App SDK : we show tx hashes, stream status updates into toast notifications, and fetch decoded receipts for a popup history panel. The same SDK surfaces “Merits” balances that gate harder difficulty levels. • Akave storage — after each round the contract fires GameEnded(cid); the UI grabs the CID, pins the JSON off-chain, and anyone can audit stake, steps, final multiplier, and the oracle proof forever. • CI/CD — Hardhat for local and GitHub Actions for fuzzing with Foundry, deploying to Flare, and publishing a Netlify preview on every pull request.