How monaliens/monaliens-platform works
Monaliens is an on-chain gaming and social platform: players use the React frontend to connect a wallet and play games; HTTP and WebSocket traffic reaches the central API and game backends, while smart contracts settle outcomes using verifiable randomness. The repository also contains NFT trading and raffle products, staking and auction contracts, and community and operations tools. The README documents the broad platform boundaries; sampled source confirms several backend flows, but most game and tool integrations were not inspected, so those links are omitted where not documented.
Main entry points: server.js Raffle backend · index.js Central API · frontend React frontend · nft.routes.js NFT metadata
Components 29
Player experience
- React frontend
frontend - Raffle experience
frontend/src/components/RafflePage - P2P trading UI
frontend/src/components/P2P2Page
Central platform
- Central API
api/src/index.js - NFT metadata
api/src/routes/nft.routes.js - Game streams
api/src/services/gamesStreamService.js - Tournaments and PNL
api/src/services/tournamentService.js - Redis service
api/src/services/redisService.js - TEE game wallet
tools/tee-wallet
On-chain games
- Game backends
games - Blackjack runtime
games/blackjack/backend/gameHandler.js - Hi-Lo runtime
games/hilo/backend/server.js - Mines runtime
games/mines/backend/server.js - Walkie runtime
games/walkie/backend/server.js - Dice runtime
games/dice/backend/server.js - Keno, Limbo, Plinko
games - Coinflip listener
games/coinflip/listener/src/app/api/leaderboard/route.ts
NFT commerce
- Raffle backend
tools/raffle/backend/src/server.js - Raffle operations
tools/raffle/backend/src/controllers/raffleController.js - Raffle event sync
tools/raffle/backend/src/routes/eventListenerRoutes.js - P2P backend
tools/p2p/backend/src/server.ts - Auction backend
contracts/auction/backend/src/server.js - Staking contracts
contracts/staking
Community services
- Staker airdrop
tools/airdrop/airdrop.js - Event indexer
tools/event-listener/src/core/ContractHandler.js - Discord bot
tools/dc-bot/src/services/database.ts - Whitelist checker
tools/whitelist-checker/frontend/src/services/api.js
Other components
- Players
- Monad contracts
Connections 20
- Players → React frontend: use
README.md - React frontend → Central API: HTTP and WebSocket
README.md - Central API → Game backends: proxy requests
README.md - Central API → NFT metadata: routes metadata
- NFT metadata → Game streams
- Central API → Tournaments and PNL: tracks activity
README.md - Tournaments and PNL → Redis service: uses Redis
- Game backends → Monad contracts: settle games
README.md - React frontend → TEE game wallet: game wallet
README.md - Raffle experience → Raffle backend: raffle requests
- Raffle backend → Raffle operations: routes requests
tools/raffle/backend/src/server.js - Raffle backend → Raffle event sync: mounts routes
tools/raffle/backend/src/server.js - Raffle event sync → Raffle backend: manual sync
tools/raffle/backend/src/routes/eventListenerRoutes.js - Raffle backend → Monad contracts: settles raffles
README.md - P2P trading UI → P2P backend: trading requests
- P2P backend → Monad contracts: trade settlement
README.md - Auction backend → Monad contracts: auction contracts
README.md - Staking contracts → Monad contracts: runs on
README.md - Staker airdrop → Staking contracts: rewards stakers
README.md - Event indexer → Monad contracts: indexes events
README.md