Multi-Chain Casino Games Platform | Solana & EVM Casino Game Smart Contracts

Production-ready Platform for building provably fair casino games on Solana and EVM chains. Includes 10 games (Crash, Plinko, Dice, Blackjack, Roulette, Poker, Slots, CoinFlip, Jackpot, Lottery) with VRF-powered randomness via Chainlink and ORAO.

This repository provides production-ready Solana and EVM casino game smart contracts for building provably fair Web3 casino games. It supports multi-chain deployment on Solana and EVM networks, enabling developers to create decentralized casino games with transparent logic, verifiable randomness, and on-chain fairness.

📋 Table of Contents

• Overview
• Games Suite
• Supported Chains
• Technology Stack
• Documentation
• Core Features
• Security Features
• Token Integration
• Telegram Bot Features
• Multi-Chain Bridge
• Contact

🌟 Overview

A fully decentralized, provably fair casino platform supporting Solana and EVM-compatible chains. (Additional chains can be added by extending the same patterns.) Play classic casino games with transparent, verifiable outcomes powered by VRF (Verifiable Random Function) technology.

📚 Documentation

• Docs index: docs/README.md
• Games: docs/GAMES.md
• Getting started: docs/GETTING_STARTED.md

Built for:

• 🎲 Casino operators looking for multi-chain support
• 🏦 DeFi protocols integrating gaming features
• 👥 Communities wanting to run their own casino
• 💼 Token projects seeking utility and engagement

🏗️ Architecture

Web3 Game Architecture

┌────────────────────────────────────────────────┐
│              Frontend (Next.js)                │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Phantom  │  │ MetaMask │  │ Telegram │      │
│  └──────────┘  └──────────┘  └──────────┘      │
└────────────────────────────────────────────────┘
                      │
        ┌─────────────┴─────────────┐
        │                           │
┌───────▼────────┐          ┌───────▼────────┐
│ Solana Chain   │          │  EVM Chains    │
│                │          │                │
│ ┌────────────┐ │          │ ┌────────────┐ │
│ │ ORAO VRF   │ │          │ │Chainlink   │ │
│ └────────────┘ │          │ │    VRF     │ │
│                │          │ └────────────┘ │
│ ┌────────────┐ │          │ ┌────────────┐ │
│ │Game        │ │          │ │Game        │ │
│ │Programs    │ │          │ │Contracts   │ │
│ └────────────┘ │          │ └────────────┘ │
└────────────────┘          └────────────────┘

Web2 Game Architecture

┌─────────────────────┐     ┌──────────────────────┐     ┌─────────────────────┐
│   originals-games   │────▶│  originals-backend   │────▶│    originals-rng    │
│                     │     │                      │     │                     │
│  Next.js 16 + React │     │  Express + Prisma    │     │   NestJS + Crypto   │
│  Port 4000          │     │  Port 3001           │     │   Port 3002         │
│                     │     │  PostgreSQL          │     │                     │
│  WebSocket + HTTP   │────▶│  Socket.IO           │     │   REST API          │
└─────────────────────┘     └──────────────────────┘     └─────────────────────┘

Production Architecture

                                         ┌──────────────────┐
                                         │   External CDN   │
                                         │  (Static Assets) │
                                         └────────┬─────────┘
                                                  │
                                    ┌─────────────▼─────────────┐
                                    │      Load Balancer        │
                                    │      (nginx / ALB)        │
                                    └─────────────┬─────────────┘
                                                  │
                 ┌────────────────────────────────┼────────────────────────────────┐
                 │                                │                                │
        ┌────────▼────────┐              ┌────────▼────────┐              ┌────────▼────────┐
        │  Frontend #1    │              │  Frontend #2    │              │  Frontend #N    │
        │  Next.js        │              │  Next.js        │              │  Next.js        │
        └────────┬────────┘              └────────┬────────┘              └────────┬────────┘
                 │                                │                                │
                 └────────────────────────────────┼────────────────────────────────┘
                                                  │
                                    ┌─────────────▼─────────────┐
                                    │    API Load Balancer      │
                                    │    (sticky sessions)      │
                                    └─────────────┬─────────────┘
                                                  │
                 ┌────────────────────────────────┼────────────────────────────────┐
                 │                                │                                │
        ┌────────▼────────┐              ┌────────▼────────┐              ┌────────▼────────┐
        │   Backend #1    │              │   Backend #2    │              │   Backend #N    │
        │   Express.js    │              │   Express.js    │              │   Express.js    │
        └────────┬────────┘              └────────┬────────┘              └────────┬────────┘
                 │                                │                                │
                 └────────────────────────────────┼────────────────────────────────┘
                                                  │
        ┌─────────────────────────────────────────┼─────────────────────────────────────────┐
        │                                         │                                         │
        │                    ┌────────────────────┼────────────────────┐                    │
        │                    │                    │                    │                    │
┌───────▼───────┐    ┌───────▼───────┐    ┌───────▼───────┐    ┌───────▼───────┐    ┌───────▼───────┐
│     Redis     │    │   PgBouncer   │    │  RNG Cluster  │    │   External    │    │    Game DB    │
│   (sessions,  │    │  (connection  │    │  (4-8 nodes   │    │    Wallet     │    │  (PostgreSQL) │
│  socket.io,   │    │   pooling)    │    │   clustered)  │    │     API       │    │               │
│    cache)     │    └───────┬───────┘    └───────────────┘    │  (Your Casino │    │  Game state,  │
└───────────────┘            │                                 │Infrastructure)│    │   sessions,   │
                             │                                 └───────────────┘    │   history     │
                   ┌─────────▼─────────┐                                            └───────────────┘
                   │    PostgreSQL     │
                   │  (game sessions   │
                   │   + read replica) │
                   └───────────────────┘

Data Flow for Game Action

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Frontend   │───▶│   Backend   │───▶│    RNG      │    │  External   │    │   Game DB   │
│             │    │             │    │   Service   │    │   Wallet    │    │             │
│             │    │             │◀───│             │    │    API      │    │             │
│             │    │             │    │             │    │             │    │             │
│             │    │             │────┼────────────▶│    │             │    │             │
│             │    │             │    │             │    │             │    │             │
│             │    │             │◀───┼─────────────│    │             │    │             │
│             │    │             │    │             │    │             │    │             │
│             │    │             │───────────────────────────────────────▶│             │
│             │    │             │    │             │    │             │    │             │
│             │◀───│             │◀───────────────────────────────────────│             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

1. Frontend sends game action (bet/hit/stand/etc)
2. Backend validates request + JWT
3. Backend calls External Wallet API to deduct bet (if new game)
4. Backend calls RNG for random outcome
5. Backend calculates result
6. Backend calls External Wallet API to credit winnings (if won)
7. Backend saves game state to Game DB
8. Backend returns result to Frontend

🎮 Games Suite

🔗 Supported Chains

🛠️ Technology Stack

Smart Contract Development

Core Game Logic

// Solana (Rust + Anchor)
- VRF-based randomness generation
- On-chain game state management
- SPL token integration
- Program-derived addresses (PDAs)

// EVM (Solidity + Foundry/Hardhat)
- Chainlink VRF integration
- ERC-20 token support
- Gas-optimized contracts
- Upgradeable proxy patterns

Game Mechanics Breakdown

🚀 Quick Start

Prerequisites

Required:

• Node.js 18+
• Rust 1.70+
• Solana CLI 1.16+
• Anchor 0.29+

For EVM:

• Foundry (recommended) OR Hardhat
• MetaMask or similar wallet

Installation

1️⃣ Clone Repository

git clone https://github.com/LaChance-Lab/solana-casino-games-evm-web3.git
cd solana-casino-games-evm-web3

2️⃣ Solana Setup

cd solana-casino-games-evm-web3
npm install
anchor build
anchor test

3️⃣ EVM Setup

cd web3/evm
forge install
forge build
forge test -vvv

4️⃣ Optional Components

• Telegram bot scaffold: see telegram-bot/ (WIP)

Star ⭐ this repo to get notified whenever this repo is updated!

Deploy to Testnet

Solana Devnet:

cd web3/solana
anchor deploy --provider.cluster devnet

Ethereum Sepolia:

cd web3/evm
forge script script/Deploy.s.sol --rpc-url sepolia --broadcast --verify

📂 Repository Structure

solana-casino-games-evm-web3/
├── 📄 README.md              ← You are here
├── 📄 LICENSE                ← MIT License
├── 📄 CONTRIBUTING.md        ← Contribution guidelines
├── 📄 SECURITY.md            ← Security policy
├── 📄 CHANGELOG.md           ← Version history
│
├── 📁 web3/                  ← Smart contracts
│   ├── 📁 solana/            ← Solana programs (Rust + Anchor)
│   │   ├── programs/
│   │   │   ├── common/       ← Shared utilities
│   │   │   ├── crash/
│   │   │   ├── coinflip/
│   │   │   ├── plinko/
│   │   │   ├── dice/
│   │   │   ├── jackpot/
│   │   │   ├── slots/
│   │   │   ├── blackjack/
│   │   │   ├── roulette/
│   │   │   ├── poker/
│   │   │   └── lottery/
│   │   ├── tests/
│   │   ├── Anchor.toml
│   │   ├── Cargo.toml
│   │   └── README.md
│   │
│   └── 📁 evm/               ← EVM contracts (Solidity)
│       ├── src/
│       │   ├── interfaces/
│       │   │   └── ICasinoGame.sol
│       │   ├── libraries/
│       │   │   └── CasinoMath.sol
│       │   ├── Crash.sol
│       │   ├── CoinFlip.sol
│       │   ├── Plinko.sol
│       │   ├── Dice.sol
│       │   ├── Jackpot.sol
│       │   ├── Slots.sol
│       │   ├── Blackjack.sol
│       │   ├── Roulette.sol
│       │   ├── Poker.sol
│       │   └── Lottery.sol
│       ├── test/
│       ├── script/
│       ├── foundry.toml
│       └── README.md
│
├── 📁 telegram-bot/          ← Telegram integration
│   ├── src/
│   └── package.json
│
├── 📁 docs/                  ← Documentation
│   ├── ARCHITECTURE.md
│   ├── DEPLOYMENT.md
│   ├── FAQ.md
│   ├── GETTING_STARTED.md
│   ├── API.md
│   └── GAMES.md              ← Game-by-game docs
│
└── 📁 examples/              ← Usage examples
    ├── solana/
    └── evm/

Status: ✅ All smart contracts implemented and ready for deployment.

✨ Core Features

🎯 Provably Fair Gaming

• Verifiable Randomness: VRF ensures true randomness
• Transparent Outcomes: All results can be independently verified
• No House Edge Manipulation: Smart contract enforced rules
• Audit Trail: Complete game history on-chain

💎 Universal Token Support

• SPL Tokens: Any Solana token supported
• ERC-20 Tokens: Full EVM token compatibility
• Custom Pools: Set your own liquidity and limits
• Dynamic Multipliers: Auto-adjusted based on pool size

📊 Advanced Analytics

• Player Statistics: Win/loss ratios, favorite games
• House Performance: Revenue, payouts, edge
• Real-time Metrics: Active players, total volume
• Historical Data: Comprehensive reporting

🎨 Enhanced User Experience

• Realistic Animations: Physics-based game visuals
• Sound Effects: Immersive audio feedback
• Celebration Effects: Win animations with confetti
• Responsive Design: Mobile and desktop optimized

🛡️ Security Features

Zero Trust Architecture

Professional Audits

• ✅ Smart contract security audits
• ✅ Penetration testing
• ✅ Code review by security experts
• ✅ Continuous monitoring and updates

💰 Token Integration

Universal Compatibility

// Support for ANY token on supported chains
- Solana: SPL tokens (USDC, USDT, custom tokens)
- EVM: ERC-20 tokens (USDC, USDT, DAI, custom tokens)

Custom Liquidity Management

Pool Configuration Example

{
  "token": "USDC",
  "initialLiquidity": "100000",
  "minBet": "1",
  "maxBet": "1000",
  "houseEdge": "2.5%",
  "maxPayout": "10000"
}

📱 Telegram Bot Features

In-Chat Gaming Experience

/play <game> <amount> - Start a game
/balance - Check your balance
/deposit - Get deposit address
/withdraw <amount> - Withdraw funds
/history - View game history
/help - Command list

/leaderboard - Top players
/bigwins - Recent big wins
/stats - Global statistics
/jackpot - Current jackpot size
/house - House performance

Advanced Bot Features

• 🎯 In-Group Gaming: Play directly in Telegram groups
• 💳 Wallet Management: Non-custodial wallet integration
• 📊 Live Leaderboards: Real-time rankings and competitions
• ⚡ Instant Payouts: Automatic win settlements
• 🔔 Notifications: Win alerts, jackpot updates
• 👥 Multiplayer: Group tournaments and challenges
• 🎁 Rewards: Daily bonuses and loyalty programs
• 📈 Analytics: Personal statistics and insights

🌉 Multi-Chain Bridge

Seamless Cross-Chain Experience

Bridge Features

• 🔄 Automatic Routing: Best path selection
• 💰 Lowest Fees: Cost optimization
• ⚡ Fast Transfers: Minimal wait times
• 🔐 Secure: Audited bridge protocols
• 📱 User-Friendly: One-click bridging
• 💎 Asset Support: Tokens and NFTs

🚧 Development Status

💡 Want to contribute? We're looking for developers! See CONTRIBUTING.md

📱 Contact

💼 Business & Partnerships

Looking to build your own casino platform?

We offer professional services:

• 🎰 White-label Solutions - Launch your casino in weeks
• 🔧 Custom Game Development - Unique games for your brand
• 🌉 Chain Integration - Connect to any blockchain
• 🎨 UI/UX Design - Beautiful, responsive interfaces
• 🛡️ Security Audits - Professional smart contract audits
• 📈 Marketing & Launch - Go-to-market strategy

Telegram: @lachancelab

🤝 Open Source Collaboration

Interested in collaboration or contributing?

• 🔗 Integrations - Token/protocol partnerships
• 🌉 Bridges - Cross-chain infrastructure
• 🎮 Platforms - Gaming ecosystem partnerships
• 💰 DeFi - Financial protocol integrations

Open an issue or join our Telegram to discuss!

❓ Frequently Asked Questions (FAQ)

What is a provably fair casino game?

Provably fair casino games use Verifiable Random Function (VRF) technology to ensure all game outcomes are random and verifiable. Players can independently verify that the house cannot manipulate results.

Which blockchains are supported?

Currently: Solana, Ethereum, Base, Arbitrum, Polygon. Planned: Sui, Cardano, Bitcoin.

Can I use this commercially?

Yes! MIT licensed - use for any purpose including commercial projects.

How do I deploy the contracts?

See our Deployment Guide for step-by-step instructions.

What tokens are supported?

Any SPL token (Solana) or ERC-20 token (EVM chains). USDC, USDT, and custom tokens all work.

Is this audited?

Yes, all contracts undergo security audits. See SECURITY.md for details.

More questions? See our FAQ Guide or open a GitHub Discussion.

⚠️ Disclaimer

This platform is for entertainment purposes. Please gamble responsibly and comply with your local regulations. The house always has an edge—play for fun, not profit.

Made with ❤️ by LaChanceLab

Powered by Provably Fair Technology