Skip to content

Lesnak1/monara-nft

Repository files navigation

๐Ÿงฌ MONARA: Evolving Digital Beings on Monad

Live Demo Smart Contract License

๐ŸŒŸ The First Evolving NFT Collection on Monad Network ๐ŸŒŸ

Experience neural network-powered digital beings that grow, mutate, and evolve entirely on-chain


๐ŸŽฏ What is MONARA?

MONARA represents a breakthrough in NFT technology - the first collection of truly evolving digital beings on Monad Network. Each MONARA is not just a static image, but a living, breathing digital organism that:

  • ๐Ÿงฌ Evolves through 4 distinct life stages over time
  • ๐ŸŽจ Generates unique on-chain SVG art based on neural pathways
  • ๐Ÿ”ฎ Mutates with different probabilities based on genesis type
  • โšก Lives entirely on-chain - no IPFS, no centralized servers

โœจ Key Features

๐Ÿง  Neural Evolution System

  • Genesis Stage: Newly minted beings start as neural networks
  • Synapse Stage: Connections form and strengthen (24h after mint)
  • Neural Stage: Full consciousness emerges (7 days after mint)
  • Transcendent Stage: Ultimate evolution achieved (30 days after mint)

๐Ÿ”ฎ Dual Genesis Types

Type Cost Mutation Rate Special Effects
๐ŸŒŸ Neural Genesis 0.1 MON 3% Standard evolution
โšก Quantum Genesis 0.25 MON 8% Enhanced particles & glow

๐ŸŽจ On-Chain Art Generation

  • 100% Solidity-generated SVG with dynamic effects
  • 6 Particle Systems: Circles, Squares, Triangles, Diamonds, Stars, Hexagons
  • 12 Core Geometries: From simple nodes to complex neural networks
  • 8 Pathway Patterns: Different connection styles between neurons
  • Real-time visual evolution based on blockchain timestamp

โšก Live Monad Integration

  • Real-time network stats: TPS, Gas Price, Block Time
  • Native Monad testnet support with optimized gas usage
  • Instant transaction feedback with smooth UX

๐Ÿ› ๏ธ Technology Stack

Next.js React TypeScript Solidity TailwindCSS Wagmi Viem


๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ and npm
  • MetaMask or compatible Web3 wallet
  • Monad Testnet tokens (Get from faucet)

1. Clone & Install

git clone https://github.com/Lesnak1/monara-nft.git
cd monara-nft
npm install

2. Environment Setup

Create .env file in the root directory:

# Contract Configuration
NEXT_PUBLIC_CONTRACT_ADDRESS=0xa7793FfC44680c03dC18ab0972b2a96A20d82335
NEXT_PUBLIC_CHAIN_ID=10143

# Network Configuration
NEXT_PUBLIC_MONAD_RPC=https://testnet-rpc.monad.xyz
NEXT_PUBLIC_BLOCK_EXPLORER=https://testnet-explorer.monad.xyz

# Optional: Enhanced RPC Performance
NEXT_PUBLIC_ALCHEMY_API_KEY=your-alchemy-api-key-here

3. Run Development Server

npm run dev

Visit http://localhost:3000 and connect your wallet to Monad Testnet!


๐Ÿ“ฑ Demo & Screenshots


๐Ÿ—๏ธ Smart Contract Architecture

MONARA.sol
โ”œโ”€โ”€ ๐Ÿงฌ Evolution Logic (time-based stages)
โ”œโ”€โ”€ ๐ŸŽจ SVG Generation (on-chain art)
โ”œโ”€โ”€ ๐Ÿ”ฎ Mutation System (probabilistic traits)
โ”œโ”€โ”€ ๐Ÿ“Š Metadata Generation (dynamic)
โ””โ”€โ”€ โšก Gas Optimization (efficient rendering)

Contract Address: 0xa7793FfC44680c03dC18ab0972b2a96A20d82335


๐Ÿ—บ๏ธ Roadmap

โœ… Phase 1: Core Platform (Completed)

  • Smart contract deployment on Monad Testnet
  • Basic evolution mechanics
  • Web3 wallet integration
  • Responsive UI/UX

๐Ÿ”„ Phase 2: Enhanced Features (Current)

  • Advanced trait combinations
  • Breeding mechanics between MONARAs
  • Staking rewards for long-term holders
  • Community governance features

๐Ÿ”ฎ Phase 3: Ecosystem Expansion (Planned)

  • Mainnet deployment
  • Mobile app development
  • VR/AR visualization
  • Cross-chain bridge integration

๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

๐Ÿ› Bug Reports

Found a bug? Open an issue with:

  • Clear description of the problem
  • Steps to reproduce
  • Expected vs actual behavior

๐Ÿ’ก Feature Requests

Have an idea? Create a feature request with:

  • Detailed description of the feature
  • Use cases and benefits
  • Implementation suggestions

๐Ÿ”ง Pull Requests

Ready to code?

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open a Pull Request

๐Ÿ“ž Contact & Support

Email GitHub

Have questions? Need support? Want to collaborate?
We're here to help! Reach out anytime.


๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿงฌ MONARA - Where Evolution Meets Innovation ๐Ÿงฌ

Built with โค๏ธ for the Monad Network community

Star this repo Follow on GitHub


๐ŸŒŸ If you found this project interesting, please give it a star! ๐ŸŒŸ

About

Monad Network NFT Evolution dApp

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published