Live feed
Documentation

Player documentation

Everything you need to know about fair play, Chainlink VRF settlement, PvP Arena, refunds, games, contracts, and progression on Base.

Core concepts

Essentials

BasePlay is a provably fair gaming protocol on Base. Wagers, game logic, and payouts are settled by smart contracts using Chainlink VRF.

Fair results

Results are settled by contracts using Chainlink VRF on Base. The UI does not decide whether a player wins or loses.

Clear payouts

Wagers and profile profit rows are shown in ETH with a lightweight USD reference where it helps. Quick bet buttons start at 0.000115 ETH, and the contract enforces active minimum and maximum bet limits.

XP and streaks

Settled rounds grant XP mainly from wager size, not from winning luck. Playing on active days builds your daily streak.

Fast activity views

Live feed, profile tabs, leaderboard data, Home stats, and round detail timelines are indexed from Base mainnet events and cached by view importance instead of polling every few seconds.

Clean Home hero

The Home hero uses a static full-width band without an animated Pixel Blast background, while tabs, game cards, round status panels, contract panels, buttons, filters, and mobile help sections stay compact.

Peer to Peer

PvP 1v1 Arena

PvP Arena lets two players duel 1v1 on Base Mainnet. Both players deposit matching ETH into the PvPArena smart contract escrow, and Chainlink VRF v2.5 delivers the provably fair random seed.

  1. Create or Join a Duel Room

    The host selects Heads or Tails, enters the bet amount, and opens a room on Base Mainnet. Challengers can browse open rooms in the lobby or join directly via an invite link.

  2. Opposing Side Assignment

    The challenger automatically takes the opposite side (e.g. if the Host selected Heads, the Challenger fights for Tails). Both players wager identical ETH into the contract escrow.

  3. Provably Fair VRF Resolution

    Once the challenger matches the room, Chainlink VRF v2.5 generates the random seed on Base Mainnet. The winner receives 98% of the pot (2% platform rake).

  4. Timeout & Cancellation Protection

    Open rooms can be cancelled by the host at any time before a challenger joins. If VRF resolution exceeds 60 blocks, either player can claim a full refund via claimTimeout().

Economic Model & 2% Rake

PvP Arena is -EV neutral to the platform bankroll. The winner receives 98% of the total pot (1.96x payout), with a 2% platform rake sent to the protocol treasury to maintain VRF gas subscriptions.

Timeout & Refund Protection

If an open room is not challenged, the host can cancel anytime. If VRF resolution is delayed past 60 blocks, either player can call claimTimeout(roomId) for a 100% full refund.

Flow

How a round works

  1. Choose a game

    Pick any active game from the library. Each game shows recent activity and the core options needed before you play.

  2. Place a bet

    Connect your wallet, choose the game options, and confirm the wager transaction. The bet is submitted on-chain.

  3. Wait for verification

    After the transaction confirms, the game waits for verifiable randomness. The round status card shows the transaction, request ID, and final settlement link when it is available.

  4. See the result

    The contract settles the round. The screen shows win or loss, and the result appears in the live feed after it is indexed. Feed rows open a round detail view with the VRF request, transaction links, and indexed event timeline. If settlement is delayed, the connected profile and wallet menu show the pending round and refund action.

Safety

Pending rounds and refunds

If Chainlink VRF randomness is delayed past the contract window, the refund action becomes active in your profile and connected wallet menu. Claiming a refund returns your original locked bet without house edge deductions.

Library

Games

Public records

Public contracts

All game, vault, and PvP contracts are verified on Base Mainnet. Use the explorer links below to view live contract transactions, balances, and verified code.

GameVault0x9690226283942203e1580bdf3c3b0e9f26b3820fView
PvPArena0x0965A9ACc1f300E60179057D7eEA20967731b8F5View
Coin Flip0x40983083bce51b7d36f17ab8a84a0ad078430f5bView
Dice0x9b7de1b6048d5520ecf83190a356afce3d768d94View
Crash0x9632631d8fb4afeb48bee8c70f9652d1d16cc865View
Mines0x631347ae0178b14e216ed11b9559e334657063b4View
Hi-Lo0x321c981c56a2914027522963c537295df2b24ad8View
Over / Under0x4905dab331607902b2f921d0295a65fe15c47d48View
Limbo0x805e6206b52cd33be2992e954d7f9d0e60698588View
Wheel0xefb9663863b8ac97ca049782ed83bbe93c1aad25View
Plinko Lite0x6ad2290f69033e0592b02093f58f271653de88c2View
Color Pick0x522fa3265d077b34572e088748164529641fa5fcView
Treasure Chest0x11ec51f2eca6048fb0fd5fdb5ce4d61544cf3845View
Lucky Seven0x7117ea3d43d6175ea30deea6206d8aa2ce157216View
Roulette Lite0x6f3f319e2cfe256aacf573d035cdb06c6ff7dd5cView
Scratch Card0x2d1178376eb23053b5474ebad8437fc2018ee469View
Rock Paper Scissors0x40cc80d6a4f14d958c692998d9279d8e6aac8eebView
Slots0x89290afe9f2b11d482d2684ce1d299da58b05c7aView
Account

Wallet, stats, and safety

Wallet and results

Your connected browser wallet or Coinbase Wallet session is your player identity through wagmi. Game pages show the latest results for that game, while the full live feed shows recent activity across games.

Before playing

  • Only confirm transactions you understand in your wallet.
  • Current quick bet buttons are 0.000115 ETH, 0.00023 ETH, and 0.0005 ETH on supported game pages.
  • Small games can still lose real ETH. Play with amounts you are comfortable risking.
  • A pending round may take time while the transaction and randomness settle.
  • The Chainlink VRF button shows the request ID and the Basescan transaction link used to verify the round.
  • If Play is disabled, the game is temporarily closed or the bankroll is being topped up.
  • If a round is delayed beyond the contract window, the refund action appears in the connected wallet menu and your profile page.
  • Claiming a refund only returns the locked bet. It does not create a new random result.
Progression

XP, quests, badges, referrals, and Lucky Draw

Progression is separate from game odds. It gives players profile goals and shareable achievements without changing the contract result or vault accounting.

XP

Settled rounds grant XP from wager size. Quest rewards are intentionally smaller than the main round activity curve, and referral XP stays capped and cosmetic.

Daily and weekly quests

Quests reward player activity such as round counts, wins, game variety, and daily streaks. The Quests page features a sleek card layout with distinct glowing green completed states.

Badges and on-chain NFT claim

Badges represent major progression milestones across game tiers, win streaks, and quests. Earned badges can be claimed as on-chain ERC-1155 NFTs directly on Base via the BasePlayBadges contract (0x1Ca9E82eBA7967295C3D77404af639B592C268eD).

Referrals

Referral links award small capped XP to the referrer after referred players settle rounds. Referral never pays ETH and never touches the vault.

Lucky Draw

Players qualify for Lucky Draw spins through gameplay activity and streaks. Rewards are promotional prizes provided by the platform treasury.

Questions

Questions and answers

How do I know the game is fair?

Every single-player and PvP round requests a random seed from Chainlink VRF v2.5 directly on Base Mainnet. The contract cannot alter the outcome after your transaction is confirmed.

How does PvP Arena work?

PvP Arena is 100% peer-to-peer. Host and challenger lock identical ETH bets in the contract escrow. Chainlink VRF determines the winner, who receives 98% of the pot (2% platform rake). The house has zero bankroll risk.

What happens if a PvP duel is not matched or VRF is delayed?

You can cancel your open room at any time before a challenger joins for a 100% refund. If VRF callback takes longer than 60 blocks, either player can call claimTimeout() to receive a full refund.

Can I share my win on Twitter / X?

Yes! Every victory enables the 'Share Win Card' modal, which generates a high-resolution 1200x630 card with your personal referral QR code, instant image copy for Twitter (Ctrl+V), and download support.

What happens if a round is delayed?

If Chainlink VRF is delayed beyond the contract window, a refund button appears in your profile and wallet menu to recover your locked wager.