Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
MonadAI 🚀
AI-Powered DeFi Portfolio Navigator for Monad Blockchain Network
MonadAI is a next-generation Web3 application that combines artificial intelligence with decentralized finance to deliver intelligent portfolio management on Monad Blockchain. Built with cutting-edge Web3 technologies and powered by Google Gemini 2.5 Flash AI, it provides real-time market analysis, conversational AI interfaces, speech recognition, and sophisticated DeFi portfolio management.
🏗️ Architecture Overview
Frontend Stack
Web3 Infrastructure
https://testnet-rpc.monad.xyzAI & Data Services
✨ Core Features
🤖 Advanced AI-Powered Portfolio Intelligence
📊 Advanced Analytics Dashboard
🐋 Advanced Whale Tracking & On-Chain Intelligence
🔗 Monad Blockchain Native Integration
🌊 DeFi Protocol Integration & Strategy Management
🔐 Security & Privacy
🎨 Premium User Experience & Design
🚀 Quick Start
Prerequisites
Installation
Environment Configuration
Create a
.envfile in the project root (copy from.env.example):Contract Address Configuration
The MonadAI application uses environment variables to configure smart contract addresses for maximum flexibility:
VITE_PORTFOLIO_CONTRACT_ADDRESS: Portfolio management contract for automated allocation0xF76Bb2A92d288f15bF17C405Ae715f8d1cedB058VITE_USDC_CONTRACT_ADDRESS: Test USDC token contract for transactions0x2921dbEd807E9ADfF57885a6666d82d6e6596AC2Benefits of environment-based configuration:
Verifying Contract Configuration
After setting up your
.envfile, you can verify the contract addresses are loaded correctly:Check Browser Console: Open DevTools and look for contract configuration logs:
Test Contract Connection: The app will show contract status in the UI:
.envfile configurationVerify on Explorer: Check contracts on Monad Testnet Explorer:
0xF76Bb2A92d288f15bF17C405Ae715f8d1cedB0580x2921dbEd807E9ADfF57885a6666d82d6e6596AC2API Key Setup
Google Gemini API Key
.envfileWalletConnect Project ID (Optional)
.envfileAdding Monad Testnet to MetaMask
To interact with MonadAI, you'll need to add the Monad Testnet to your wallet:
Network Details:
Add Network Automatically:
Add Network Manually:
Development
The application will be available at
http://localhost:8080🔧 Technical Implementation
Smart Contract Integration
MonadAI interacts with deployed smart contracts on Monad Blockchain testnet:
Web3 Connection Configuration
AI Integration Architecture
📁 Project Structure
🔗 Smart Contract Verification
Deployed Contracts on Monad Blockchain Testnet
0xF76Bb2A92d288f15bF17C405Ae715f8d1cedB0580x2921dbEd807E9ADfF57885a6666d82d6e6596AC2🔍 Contract Verification Details
Contract Features
Verification Steps
🧪 Testing & Quality Assurance
Testing Strategy
Code Quality
Performance Optimization
🌐 Deployment Guide
Production Build
Deployment Options
Vercel (Recommended)
Netlify
IPFS/Fleek (Decentralized)
Environment Variables for Production
# Production environment variables VITE_GEMINI_API_KEY=prod_api_key VITE_COINGECKO_API_URL=https://api.coingecko.com/api/v3 VITE_MONAD_EXPLORER_API=https://testnet.monadexplorer.com/api📊 Performance Metrics
Bundle Analysis
Web3 Performance
🔐 Security Considerations
Frontend Security
Web3 Security
Privacy Protection
🎯 Usage Guide
Getting Started
Getting Testnet Tokens
MON Tokens (Monad Native Token)
USDC Test Tokens
Core Features
AI Assistant Chat
Portfolio Management
Market Intelligence
Advanced Features
Custom Token Addition
API Integration
🛠️ Development Guide
Local Development Setup
Custom Components Development
API Service Extension
Contributing Guidelines
git checkout -b feature/amazing-featuregit commit -m 'Add amazing feature'git push origin feature/amazing-featureCode Standards
🚧 Roadmap
Q3 2025 ✅
Q4 2025 🔄
Q1 2026 🎯
Q2 2026 🌟
2026+ 🚀
📄 Legal & Compliance
Disclaimer
Privacy Policy
Terms of Use
🤝 Community & Support
Getting Help
/docsContributing
We welcome contributions from the community! Here's how to get involved:
Code Contributions
📚 Resources & References
Essential Reading
External APIs & Services
📝 License
🌐 Live Demo
Made with ❤️ by the MonadAI team
Powered by Monad Blockchain • Enhanced by AI • Built for the Future