Skip to content

Latest commit

ย 

History

1,470 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ Celo Game Arcade

A blockchain-powered gaming arcade built as a Farcaster mini app on the Celo network. Deposit the current stablecoin entry fee to unlock all games, compete for the top spot on the leaderboard, and claim the entire prize pool!

๐Ÿ•น๏ธ Games

  • ๐ŸŽ๏ธ Turbo Racing - Dodge obstacles and collect coins
  • ๐Ÿ Neon Snake - Classic snake with a neon twist
  • ๐Ÿฆ Flappy Celo - Fly through pipes, don't crash!
  • ๐Ÿš€ Space Blaster - Destroy aliens, survive waves

โšก Features

  • ๐Ÿ’ฐ Prize Pool - 80% of each entry goes to the prize pool, and the #1 player can claim it all
  • ๐Ÿ† Leaderboard - Top 10 players ranked by score
  • ๐ŸŽฏ Difficulty Multipliers - Easy (1x), Medium (1.5x), Hard (2x)
  • ๐Ÿ”— On-chain Scores - All scores recorded on Celo blockchain
  • ๐Ÿ“ฑ Farcaster Integration - Play directly in Warpcast

๐Ÿ› ๏ธ Tech Stack

  • Frontend: Next.js 14, React, TypeScript, Tailwind CSS
  • Blockchain: Celo, Solidity, Wagmi, Viem
  • Farcaster: @farcaster/miniapp-sdk, @farcaster/miniapp-wagmi-connector
  • Wallet: WalletConnect, Injected wallets

๐Ÿ“‹ Contract

  • Address: 0xD3Cb0357edF92E1056cfBC3dC5cC1DA52846DDB0
  • Network: Celo Mainnet (Chain ID: 42220)
  • Entry Fee: Read from the contract at runtime
  • SDK Amount Parsing: Uses strict decimal strings (1, 1., .5) and rejects scientific notation.
  • Zero-Decimal Tokens: When integrating non-fractional tokens, pass entryFee explicitly in base units.

๐Ÿš€ Quick Start

git clone https://github.com/AdekunleBamz/CeloGameArcade.git
cd CeloGameArcade
npm ci
npm run dev

# Run SDK unit tests
npm run sdk:test
npm run check:fast

# Build SDK artifacts
npm run sdk:build

# Run fast local checks
npm run check:fast
npm run typecheck

๐Ÿ“ฆ Deploy

npm run sdk:test
npm run sdk:build
npm run build
npx vercel --prod

๐Ÿ” Security Notes

  • Keep .env.local out of commits and avoid sharing WalletConnect keys in logs.

๐Ÿงญ Operational Notes

๐Ÿ“„ License

MIT

Keep release evidence tied to the score submission hash so support can match screenshots, wallet prompts, and explorer links quickly.

About

๐ŸŽฎ Celo Game Arcade - A Farcaster mini app with 4 blockchain games. Play, compete on leaderboards, and win the CELO prize pool!

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages