AVLO
Menu
← BACK|AVLO DOCUMENTATION
01 / 18

Overview

Permissionless Casino Protocol is a fully on-chain, permissionless casino platform on Avalanche C-Chain. Anyone can deploy casino game contracts with any ERC-20 token, configure game parameters, and open them to players. Community members can stake into game pools to earn fees from every bet.

Key Highlights
  • No off-chain oracles — SHA-256 commit-reveal randomness
  • Multi-game factory pattern — each game type has its own factory
  • Community staking — Synthetix-style fee distribution to liquidity providers
  • Roulette — 13 bet types, multi-bet (×10), 36x max
  • Slots — 3-reel, 10 symbols, up to 100x jackpot
  • Crash — multiplier crash game, cashout before crash
  • Configurable RTP, fees, pool limits, and branding per game
  • Unlimited claim window — blockhash auto-cached, no 256-block expiry
  • All contracts verified on Sourcify
  • V1 & V2 & V3 factories — V1 requires AVLO deploy fee; V2 is free with 3% platform fee; V3 adds 1% creator fee incentive

V1 vs V2 vs V3 Contracts

FeatureV1 (Legacy)V2V3 (Current)
Deploy Fee10M AVLO tokensFree (no deploy fee)Free (no deploy fee)
Platform FeeNone3% on every bet3% on every bet
Creator FeeNoneNone1% to game creator
Pause/Resume✅ Owner can pause❌ No pause (always live)❌ No pause (always live)
Staker FeesConfigurable (max 25%)Configurable (max 25%)Configurable (max 25%)
Creator TransferN/AN/A✅ updateCreator()
Game MechanicsIdenticalIdenticalIdentical
Staking SystemSynthetix-styleSynthetix-styleSynthetix-style
getPlatformInfo()❌ Not available✅ Returns fee data✅ Returns fee data
getCreatorInfo()❌ Not available❌ Not available✅ Returns creator + earnings
Which version should I use?

V3 is recommended for new deployments — no upfront cost, instant deploy. 3% platform fee + 1% creator fee are deducted from each bet. The creator earns passive income from every bet placed on their game. V2 is the same as V3 but without creator fee. V1 games remain fully operational and are not affected.

Architecture

Contract Architecture
┌──────────────────────────────────────────────────────────────────────────────┐
│                            Casino Protocol                                    │
│                                                                               │
│  V1 Factories (AVLO deploy fee, no platform fee)                              │
│  ┌───────────────────┐  ┌─────────────────────┐  ┌───────────────────────┐   │
│  │  RouletteFactory   │  │  SlotFactory         │  │  CrashFactory         │   │
│  └────────┬──────────┘  └────────┬─────────────┘  └────────┬─────────────┘   │
│                                                                               │
│  V2 Factories (free deploy, 3% platform fee on bets)                          │
│  ┌───────────────────┐  ┌─────────────────────┐  ┌───────────────────────┐   │
│  │  RouletteFactoryV2 │  │  SlotFactoryV2       │  │  CrashFactoryV2       │   │
│  └────────┬──────────┘  └────────┬─────────────┘  └────────┬─────────────┘   │
│                                                                               │
│  V3 Factories (free deploy, 3% platform + 1% creator fee)                     │
│  ┌───────────────────┐  ┌─────────────────────┐  ┌───────────────────────┐   │
│  │  RouletteFactoryV3 │  │  SlotFactoryV3       │  │  CrashFactoryV3       │   │
│  └────────┬──────────┘  └────────┬─────────────┘  └────────┬─────────────┘   │
│           │                      │                          │                 │
│  ┌────────┴───────┐     ┌────────┴───────┐        ┌────────┴───────┐         │
│  ▼                ▼     ▼                ▼        ▼                ▼         │
│ RouletteGame A  RouletteGame B  SlotGame A  SlotGame B  CrashGame A  CrashB  │
│ Token: USDC    Token: AVAX    Token: USDC  Token: AVLO  Token: AVLO          │
│ Pool ◄ Stakers Pool ◄ Stakers Pool ◄ Stakers Pool ◄ Stakers                  │
└──────────────────────────────────────────────────────────────────────────────┘

Game Types Comparison

FeatureRouletteSlotsCrash
Bet Input13 bet types + numberAmount onlyAmount + target multiplier
Result Space37 outcomes (0-36)1000 combos (10×10×10)Continuous multiplier curve
Max Multiplier36× (straight number)100× (triple 7️⃣)Configurable (up to 100×)
Multi-Bet✅ Up to 10 positions❌ Single spin❌ Single bet
Pair MatchN/A2× (any two same)N/A
StakingSynthetix-styleSynthetix-styleSynthetix-style
Chat
RandomnessSHA-256 commit-revealSHA-256 commit-revealSHA-256 commit-reveal
ConfigRTP, fee, limitsRTP, fee, limitsRTP, fee, limits, maxMultiplier