MonadWorld Documentation

1. Overview

MonadWorld is a Web3 project centered around Lilnad NFTs, unique Soul-Bound Tokens (SBTs) that allow users to collect, earn scores, and compete for rewards within an interactive ecosystem on the Monad blockchain. The project aims to deliver an engaging pixel art experience with a focus on community and a rewarding game economy.

Key Objectives:

  • Providing a fun and engaging NFT collection experience.
  • Implementing a fair and exciting reward system through seasonal snapshots and Love Token distribution.
  • Building a secure and efficient platform on the Monad Testnet, with plans for Mainnet deployment.

2. The MonadWorld Ecosystem

2.1 Frontend (Your Gateway)

The website you are using! Built with modern web technologies (Next.js, React, TypeScript, Tailwind CSS) to provide a smooth, pixel-perfect experience for minting, collecting, and interacting with your Lilnad NFTs.

2.2 Backend (The Engine Room)

Works behind the scenes (Node.js, Express.js, Prisma) to manage data, provide information to the website, and interact with the blockchain when needed. It includes an indexer to keep track of NFT data efficiently in a PostgreSQL database.

2.3 Smart Contracts (The Rulebook on Blockchain)

`LilnadNFT.sol` (Your NFTs)

This is where your Lilnad NFTs live. It handles minting (with a commit-reveal system for fair rank assignment), how scores are accrued over time based on rank, and the lifecycle of your Soul-Bound Tokens.

`LoveToken.sol` (Reward Currency)

The official reward token of MonadWorld, an ERC20 token named LOVE. You earn this by participating in the game and collecting scores with your Lilnads!

`LoveDistributor.sol` (Reward Payouts)

This contract is responsible for the seasonal distribution of LOVE tokens. It uses MON (from a portion of minting fees) to mint LOVE and then distributes these rewards to eligible players based on their scores, using a Merkle Tree system for verification.

3. Gameplay & Rewards

3.1 Minting Your Lilnad NFT

New Lilnad NFTs are minted using a secure Commit-Reveal process. This ensures fairness in rank assignment, making it exciting to see what rank your new Lilnad will be! If you don\'t complete the reveal process in time, your NFT will still be minted but will receive the lowest rank.

Available packs (subject to change on Testnet): Single Mint, Pack 10 (+1 Bonus), Pack 25 (+3 Bonus).

3.2 Soul-Bound Tokens (SBTs) & Scoring

Your Lilnad NFTs are Soul-Bound Tokens. They accrue scores over time based on their rank – the higher the rank, the faster the score accrual!

Make sure to `collect()` your scores periodically. Each NFT has a defined lifecycle and will eventually stop accruing scores (become "dead").

3.3 Seasonal Rewards with Love Tokens (LOVE)

MonadWorld features an exciting seasonal reward system!

  • **Snapshots:** Player scores are recorded every 7 days.
  • **Reward Pool & LOVE Generation:** All MON collected from LilnadNFT minting fees (after a 5% development fee) is designated for the seasonal rewards. For every 1 MON allocated to a season, 2 LOVE tokens are minted by the `LoveDistributor` contract.
  • **Liquidity Provision (LP):** The entirety of the seasonal MON (from the reward pool) along with an equivalent amount of the newly minted LOVE (i.e., 1 MON : 1 LOVE ratio from the minted total) are used to provide liquidity for the MON/LOVE trading pair on a Decentralized Exchange. This creates a foundational market for LOVE tokens.
  • **Player Rewards:** The remaining LOVE tokens (the other half of the total minted LOVE after LP provision) are then distributed to the top 70% of players based on their collected scores during that season.
  • **Lottery-Style Distribution:** Your collected score acts like lottery tickets (1 score = 1 ticket). While you can only win one prize tier per season, having more tickets significantly increases your chances of winning a higher-tier prize! The exact prize structure is determined off-chain for each season.

3.4 (Planned) NFT Expiration & Collect All

We\'re working on features to clearly show when your NFTs will stop accruing scores. A "Collect All" button is also planned to make score collection easier if you own many Lilnads!

4. Project Roadmap

Current Phase (Testnet Focus)

  • Ongoing Smart Contract security enhancements and adjustments to core minting and SBT logic.
  • Optimizing how data is fetched from the blockchain and displayed on the website for improved performance and user experience.
  • Improving features like score collection and providing clear NFT status visibility (e.g., upcoming expiration).

Future Phases

  • Full implementation and rollout of the seasonal LOVE token reward system, including off-chain scripts for reward calculations and Merkle Tree generation.
  • Integration of a user-friendly reward claim system on the frontend.
  • Comprehensive testing, security audits, and community feedback rounds.
  • Eventual Mainnet Launch of MonadWorld, bringing the complete experience to a wider audience!
Back to Home