ZilloPoly

ZilloPoly is a gamified housing market prediction platform built on Celo that transforms real-world property data into an engaging blockchain game. Players use HOBO tokens to predict whether property prices will go up or down, competing in single-player survival mode or real-time 1v1 multiplayer battles.

The game integrates Chainlink CRE (Commercial Real Estate) oracles to validate predictions against actual market data, ensuring transparency and accuracy. Built as a Farcaster Mini-App, ZilloPoly features on-chain game mechanics with ERC-20 token economics, WebSocket-powered real-time multiplayer matchmaking, and an intuitive interface that makes complex market data accessible.

Key features include:

• Single-player survival mode with streak mechanics and 10-second countdown timers
• Real-time 1v1 multiplayer battles via WebSocket matchmaking
• Chainlink CRE oracle integration for real property price validation
• On-chain bet settlement with automatic HOBO token transfers
• Farcaster Mini-App native experience for social gaming

Players learn about housing market trends while competing for HOBO tokens, creating an educational and entertaining bridge between traditional finance and Web3 gaming.

ZilloPoly is built on Celo Mainnet using a Next.js/TypeScript frontend with Wagmi and Viem for Web3 interactions. The smart contract handles game logic, token transfers, and bet settlements with functions like startGame(), makeGuess(), and settleBet().

For real-time multiplayer, we implemented a Node.js WebSocket server that handles matchmaking, game state synchronization, and player communication. The server maintains active game sessions and broadcasts updates to connected players.

Chainlink CRE (Commercial Real Estate) oracles are integrated to fetch actual property prices, which are compared against displayed prices to determine prediction outcomes. The oracle data ensures fairness and transparency in game results.

The frontend uses React hooks for state management, with custom hooks like useZillopolyContract() and useHoboTokenAddress() to interact with the smart contract. The Farcaster Mini-App SDK provides seamless wallet connection and social integration.

Key technical decisions:

• Celo for fast, low-cost transactions
• WebSocket for real-time multiplayer (no polling needed)
• Chainlink CRE for reliable property data
• ERC-20 HOBO token for in-game economy
• Server-side matchmaking for fair player pairing

The architecture separates concerns: blockchain handles game logic and token transfers, WebSocket server manages multiplayer state, and frontend provides the user experience. This modular approach allows for easy scaling and future enhancements.