
The TheBingoFi landing page at thebingofi.vercel.app.
Positioning: “web2 gameplay, web3 ownership”
This is the project’s core thesis, and it shapes every design decision documented in this site:- Web2 gameplay: a match runs entirely on the game server. No wallet connection, no transaction, and no gas fee is ever required to play a match, from the draft phase through calling numbers to the win screen. A player can start a guest game within seconds of opening the app.
- Web3 ownership: the only place blockchain shows up is buying, holding, and (on secondary markets) reselling Skill/Skin NFTs. Wallet connection is required strictly for that, and for using a purchased skill’s loadout in
standardmode matches.
Status: live today
Smart contracts
4 contracts (
SkillRegistry, SkillFactory, SkillCollection, Marketplace) deployed and verified on GIWA Sepolia (chain ID 91342) on Blockscout. See Smart Contracts for addresses.Web client
Next.js client live at thebingofi.vercel.app, deployed on Vercel.
Game server
Node.js realtime + HTTP API live on Railway, backing all guest/room/daily-challenge/quest/Plaza traffic.
Tested
52/52 Foundry contract tests passing (100% line/statement/branch/function coverage); 273 TypeScript unit/integration tests passing across the workspace (157 server, 107 engine, 5 chain, 4 i18n), plus 2 opt-in server tests skipped by default.
GIWA Sepolia is a testnet. GIWA mainnet does not exist yet (still in development), so every deployment referenced in this documentation targets Sepolia.
What this documentation covers
This site is TheBingoFi’s whitepaper: game design, the skill system, the on-chain economy, the architecture that separates gameplay from ownership, the deployed smart contracts, and an honest accounting of what is live versus what is still planned. Every number in it (prices, supply, chain IDs, contract addresses, test counts) is pulled directly from the project’s source of truth documents and code. Nothing here is a projection or an estimate.Problem
Why classic bingo and typical GameFi both fall short.
Solution
How strategic bingo + Skill NFTs + off-chain gameplay solve it.
Gameplay
Board, draft phase, turn-based calling, winning, match modes.
Smart Contracts
The 4 deployed contracts, addresses, and dynamic pricing.