MonadWorld Documentation

1. Overview

MonadWorld is a Web3 project on the Monad blockchain featuring:

  • Lilnad NFTs as unique Soul-Bound Tokens (SBTs)
  • Point collection and rewards system
  • Engaging pixel art experience
  • Focus on community and game economy

2. The MonadWorld Ecosystem

2.1 Frontend (Your Gateway)

The web app technology stack:

  • Next.js App Router, React, TypeScript
  • Tailwind CSS for styling
  • Wagmi hooks for seamless on-chain calls

Key components:

  • MintPage: Commit-reveal flow (commitMintSingle/10/25 and revealMint*) with localStorage pack persistence and three static expired-reveal cards.
  • CollectionPage: SWR hook useOwnedNfts calls /api/nfts/owner/:ownerAddress and displays NFTs via SbtCard.
  • SbtCard: Calculates points/minute using calculateNftPoints (totalPoints/lifetimeSecs*60), formats numbers with toLocaleString(), and uses Pixelify_Sans & VT323 pixel-style fonts.

2.2 Backend (The Engine Room)

Backend components:

  • Stack: Node.js, Express, Prisma, PostgreSQL
  • API Endpoints: /api/nfts/owner/:ownerAddress
  • Indexer: Built with viem to decode on-chain events
  • Events: RevealAndMint, Transfer, Collected
  • Performance: contractDataCache for rank data, Bottleneck for rate-limiting

2.3 Smart Contracts (The Rulebook on Blockchain)

`LilnadNFT.sol` (Your NFTs)

  • Primary NFT contract for Lilnad tokens
  • Commit-reveal system for fair rank assignment
  • Point accrual based on token rank
  • Soul-Bound Token lifecycle management

`LoveToken.sol` (Reward Currency)

  • ERC20 token named LOVE
  • Official reward currency
  • Earned through gameplay and point collection

`LoveDistributor.sol` (Reward Payouts)

  • Handles seasonal LOVE token distribution
  • Uses MON from minting fees to mint LOVE tokens
  • Distributes rewards based on player points
  • Implements Merkle Tree system for verification

3. Community & Player Engagement

3.1 Building the Community

Our strategy for Season 0:

  • User Acquisition: Attracting active players through incentives and engaging gameplay
  • Retention: Creating compelling reasons for players to return daily
  • Education: Helping players understand how ranking and points work
  • Feedback Loop: Constantly improving based on community input

3.2 Player Incentives During Season 0

While building toward $LOVE token:

  • Leaderboard Recognition: Top players highlighted
  • Early Adopter Benefits: Special recognition for Season 0 participants
  • Community Events: Regular activities to maintain engagement
  • Point Accumulation: Building up points that will be valuable when $LOVE launches
  • Mainnet Snapshot: Your status and points will be captured when Monad announces mainnet, marking the end of Season 0

4. Project Roadmap

Current Phase: Season 0 (Testnet Focus)

We are currently in Season 0, an initial phase with no set end date. This phase focuses on building our player base and refining core mechanics before $LOVE token launch.

Important: Season 0 will conclude on the day Monad announces its mainnet launch. We will take a snapshot of all player data on that day, which will be used for future rewards and benefits.

  • Security: Enhancing Smart Contract security
  • Core Logic: Refining minting and SBT mechanics
  • Performance: Optimizing blockchain data fetching
  • UX Improvements: Point collection and NFT status visibility
  • Community Building: Attracting and engaging a sufficient player base

$LOVE Token Implementation

The next major milestone after Season 0 will be the launch of our $LOVE token. This will only happen once we reach a critical mass of active players.

  • Prerequisites: Minimum active player count threshold
  • Token Launch: ERC20 $LOVE token deployment
  • Liquidity: Creation of MON/LOVE trading pair
  • Reward System: Seasonal point-based reward distribution

Future Phases

  • Season Structure: Defined seasons with clear start/end dates after $LOVE launch
  • Rewards System: Full seasonal LOVE token implementation
  • Off-chain Tools: Scripts for reward calculations, lottery draws, and Merkle Tree generation
  • Frontend: User-friendly reward claim system allowing winners to claim prizes 2-3 days after season end
  • Quality Assurance: Testing, security audits, community feedback
  • Launch: Mainnet deployment of MonadWorld!
Back to Home