Documentation
Learn how Flip Battle works and get started
🎮 BATTLE GUIDE
âš¡ HOW TO PLAY âš¡
> MASTER THE ART OF THE FLIP
Learn the rules, understand the game, dominate the battlefield
Choose Your Side
Pick HEADS or TAILS and set your bet amount. The choice is yours!
Find Your Opponent
Either create a battle and wait for someone to join, or join an existing battle.
The Flip Happens
Generate a truly random result. No cheating, no manipulation!
Winner Takes All
The winner gets 95% of the total pot. Loser gets bragging rights for next time!
🌟 GAME FEATURES 🌟
Why Flip Battle is the ultimate coin flip experience
Provably Fair
Every flip uses Chainlink VRF for transparent randomness
Instant Results
No waiting around - battles resolve in seconds
Multi-Network
Play on many popular networks
Contract Addresses
Ethereum MainnetChain ID: 1
0x067dE043A165DC83b344eD7aC7778a92F04eDC6d0x3A85782310548997015E7D66A84222D513dbc0380x6a64E692e3E15D8107e7B5E46937136aaa4E6c4bArbitrum OneChain ID: 42161
0xD05E015b3c5ec292d63be233beac093f50b30abc0x8fB7E4061A4df78F2861366c6C22Cac8D6ed74960x92B1b3261656A83587BCCDF90b33F45369D0a754BaseChain ID: 8453
0x6a64E692e3E15D8107e7B5E46937136aaa4E6c4b0x495E110c381415f9EbD6616993805a9dfb011b560x3A85782310548997015E7D66A84222D513dbc038How It Works
1. Centralized VRF Architecture
Our platform uses a centralized BettingManager that acts as the single VRF consumer, eliminating the need for multiple VRF subscriptions and reducing costs.
- Single VRF subscription for all betting contracts
 - Shared VRF costs across all battles
 - Centralized authorization and player tracking
 
2. Fair Randomness with Chainlink VRF
Every coin flip result is generated using Chainlink VRF (Verifiable Random Function), ensuring complete transparency and fairness.
- Cryptographically secure random number generation
 - On-chain verification of randomness
 - No possibility of manipulation by players or platform
 
3. Transparent Fee Structure
Our platform charges a transparent 5% fee on all battles, with no hidden costs.
- 5% platform fee deducted from total pot
 - Winner receives 95% of the combined bet amounts
 - Fees support platform development and VRF costs
 
Technical Details
Smart Contracts
- BettingManager: Central VRF consumer and coordinator
 - CoinFlipFactory: Deploys new betting contracts
 - CoinFlipBetting: Individual token betting logic
 
Supported Networks
- Ethereum Mainnet
 - Arbitrum One
 - Base