Property Tycoon

Progress During Hackathon Week 1: Core Infrastructure and Smart Contracts Deployed core smart contracts on Mantle Sepolia Testnet. PropertyNFT contract mints ERC-721 property tokens. GameToken contract handles TYCOON token distribution. YieldDistributor contract manages yield calculations and claims. Marketplace contract enables property trading between players. QuestSystem contract tracks quest completion and rewards. Built backend API with NestJS. PostgreSQL database stores user profiles, properties, quest progress, and leaderboard data. Socket.io integration enables real-time updates. Railway deployment configured for production hosting. Created frontend with Next.js and React. Pixi.js renders isometric 3D city map. Wagmi and Viem handle wallet connections. Tailwind CSS styles the interface. Real-time WebSocket connections update UI without page refreshes. Week 2: RWA Integration and Chronicle Oracle Deployed MockRWA contract for testing. MockRWA implements ERC-721 standard with predefined test properties. Each RWA token has unique value and APY. Property linking connects in-game properties to RWA tokens. Integrated Chronicle Oracle for price feeds. MNT/USD price feed displays USD equivalents throughout the app. Oracle integration uses 60-80% less gas than other oracles. Backend fetches prices every 5 minutes and broadcasts via Socket.io. Implemented RWA linking in YieldDistributor. Contract checks if property is linked to RWA. Uses RWA value and yield rate when linked. Falls back to property base rate if not linked. All calculations happen on-chain and are verifiable. Week 3: Real-Time Features and Leveling System Built leveling system with XP calculation. XP based on properties owned, yield earned, and portfolio value. Square root progression formula ensures balanced leveling. Levels update automatically when players mint properties or claim yield. Added WebSocket real-time updates. Level and XP update instantly without page refresh. Leaderboard positions shift live as players progress. Portfolio values update in real-time. Yield accumulation shows live on properties. Implemented coordinate generation system. Properties appear on isometric map with unique coordinates. Coordinate grid set to 30x30 for optimal display. Backend generates and regenerates coordinates automatically. Week 4: Social Features and GameFi Elements Built guild system. Players create and join guilds. Guild stats track combined portfolio value and yield earned. Guild leaderboard ranks guilds by total portfolio value. Guild stats update automatically when members progress. Implemented quest system. Five quest types reward players for milestones. First Property rewards 100 TYCOON for first mint. Diversify Portfolio rewards 500 TYCOON for owning 3 property types. Property Mogul rewards 2000 TYCOON for owning 10 properties. RWA Pioneer rewards 1500 TYCOON for linking 5 properties to RWA. Added global chat. Real-time messaging connects all players. Usernames and avatars personalize the experience. Chat updates instantly via WebSocket. Week 5: Marketplace and Property Trading Completed marketplace implementation. Frontend loads listings directly from blockchain. getActiveListings function provides source of truth. Backend syncs listings and handles blockchain calls when needed. Fixed property trading flow. Buyers purchase properties from other players. Sellers list properties with fixed prices or auctions. Marketplace validates ownership and transfers NFTs. WebSocket updates listings in real-time. Week 6: UI/UX Improvements and Polish Simplified landing page. Removed excessive content. Added floating animations. Clean design matches Noodle Quest style. How to Play guide explains game mechanics clearly. Improved map interactions. Pan and zoom work smoothly. Property find button centers map on selected property. Click outside modals closes them. Better visual feedback for all actions. Fixed property rendering. Pixi.js v8 API updates resolved. Graphics visibility ensured in production. Coordinate handling improved. Debug logging added for troubleshooting. Week 7: Deployment and Infrastructure Fixed Railway deployment. SSL support added for PostgreSQL connection. BigInt serialization handled properly. Frontend API URL detection improved. Production builds work correctly. Optimized leaderboard sync. Auto-updates when properties change. Verifies yield from YieldDistributor contract. Excludes contract addresses from rankings. Real-time updates via WebSocket. Fixed BigInt serialization errors. All numeric fields converted to strings for JSON. Recursive helper functions handle nested objects. Database schema uses NUMERIC type for large values. Frontend displays values correctly. Week 8: Bug Fixes and Final Optimizations Fixed guild join/leave flow. Prevents joining multiple guilds. Auto-creates users when needed. Guild stats update from blockchain. BigInt serialization fixed for guild data. Improved yield display. Verifies yield from YieldDistributor contract. Shows accurate totals in leaderboard. Auto-updates when yield is claimed. Handles edge cases properly. Optimized RPC calls. Multi-RPC failover implemented. Reduces single point of failure. Mantle custom RPC methods used for efficiency. eth_getBlockRange reduces calls by 90%. Final State All core features working. Property minting, RWA linking, yield claiming all functional. Real-time updates work across all features. Guild system complete with leaderboard. Quest system rewards players on-chain. Marketplace enables property trading. Chronicle Oracle provides price feeds. Mantle integration uses custom RPC methods and GasPriceOracle. Production ready. Contracts deployed and verified on Mantle Sepolia. Backend hosted on Railway. Frontend deployed on Vercel. All features tested and working. Documentation complete. Key Metrics 7 smart contracts deployed. PropertyNFT, GameToken, YieldDistributor, Marketplace, QuestSystem, TokenSwap, MockRWA. 5 major features implemented. Property management, RWA integration, guild system, quest system, marketplace. 4 Mantle integrations. Mantle Viem for type-safe contracts, Chronicle Oracle for price feeds, custom RPC methods for efficiency, GasPriceOracle for optimization. Real-time updates across 6 systems. Portfolio values, yield accumulation, leaderboard rankings, guild stats, quest progress, chat messages. Production deployment on 3 platforms. Smart contracts on Mantle Sepolia, backend on Railway, frontend on Vercel.