Documentation

Learn how Flip Battle works and get started

Coin Heads
Coin Tails
Coin Heads
Coin Tails
Coin Heads
Coin Tails

🎮 BATTLE GUIDE

âš¡ HOW TO PLAY âš¡

> MASTER THE ART OF THE FLIP

Learn the rules, understand the game, dominate the battlefield

1

Choose Your Side

Pick HEADS or TAILS and set your bet amount. The choice is yours!

Select HEADS or TAILS
Set your bet amount
Choose your token
Confirm the battle
2

Find Your Opponent

Either create a battle and wait for someone to join, or join an existing battle.

Browse open battles
Match bet amounts
Instant battle creation
Fair matchmaking
3

The Flip Happens

Generate a truly random result. No cheating, no manipulation!

VRF randomness
Provably fair
On-chain verified
Instant results
4

Winner Takes All

The winner gets 95% of the total pot. Loser gets bragging rights for next time!

95% to winner
5% platform fee
Instant payouts
Battle history tracking

🌟 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

0x067dE043A165DC83b344eD7aC7778a92F04eDC6d
0x3A85782310548997015E7D66A84222D513dbc038
0x6a64E692e3E15D8107e7B5E46937136aaa4E6c4b
View on Block Explorer

Arbitrum OneChain ID: 42161

0xD05E015b3c5ec292d63be233beac093f50b30abc
0x8fB7E4061A4df78F2861366c6C22Cac8D6ed7496
0x92B1b3261656A83587BCCDF90b33F45369D0a754
View on Block Explorer

BaseChain ID: 8453

0x6a64E692e3E15D8107e7B5E46937136aaa4E6c4b
0x495E110c381415f9EbD6616993805a9dfb011b56
0x3A85782310548997015E7D66A84222D513dbc038
View on Block Explorer

How 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