Skip to content

alexmel1/TokenFlip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

122 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 TokenFlip — WEB3 App on Base 🟦

My first vibe WEB3 app built on the Base blockchain.

⚔️ Play 1vs1 with real USDC — 50/50 chance 🎲
Winner takes all.

🔗 Live App: https://tokenflip-app.vercel.app/


📱 How to use

For now, the app works best on mobile inside the Base app https://base.app/invite/polkamela/WWNK27F4

⚠️ Desktop wallets like MetaMask are not supported yet.


💰 Requirements

To play, you need:

  • USDC — to create or join game rooms
  • ETH (Base network) — to pay gas fees (very small fees)

🎮 Gameplay

  • Create a room with your bet (USDC)
  • Another player joins
  • Flip the coin 🎲
  • 50/50 chance — winner takes all

⚙️ Smart Contract Logic

  • Player 1 creates a game with a USDC bet
  • Player 2 joins with the same amount
  • The contract locks both deposits
  • A pseudo-random outcome decides the winner
  • The winner receives the full prize (2x bet)

🎲 Randomness

The current version uses on-chain pseudo-randomness based on block data.

⚠️ This approach is not fully secure and may be predictable under certain conditions.

🔜 Future updates will include more secure randomness solutions
(e.g. Chainlink VRF or similar technologies).


⚠️ Disclaimer

This is a gambling-style application.

  • You are playing with real funds
  • All actions are fully your responsibility
  • No guarantees of winning

Play responsibly.


🛠️ Status

  • MVP version
  • Expanding wallet support
  • UI/UX improvements coming

💡 About

Built as an experimental Web3 project on Base.

Releases

No releases published

Packages

 
 
 

Contributors