Repository files navigation # 🚀 Monad Access - Web3 Pay-As-You-Go SaaS
> **Kill subscriptions. Pay only for what you use.**
A revolutionary Pay-As-You-Go SaaS platform built on the Monad Blockchain that allows users to pay micro-transactions for premium services (AI, VPN, SMS) instantly via MetaMask—no signup required.




---
## ✨ Features
- 🔗 **MetaMask Integration** - Seamless Web3 wallet connection
- 💳 **Micro-Transactions** - Pay-as-you-go model with Monad tokens
- 🎨 **Cyberpunk UI** - Dark mode with neon glow effects
- ⚡ **5 Premium Services** - AI, VPN, Image Generation, SMS
- 📟 **Real-time Terminal** - Live transaction and service logs
- 🌐 **No Signup** - Wallet-based authentication only
---
## 🎮 Services
| Service | Price | Description |
|---------|-------|-------------|
| 🤖 **GPT-Pro** | 0.005 MON | AI-powered text generation and Q&A |
| 🧠 **Gemini AI** | 0.003 MON | Advanced data analysis and insights |
| 🔒 **Nano VPN** | 0.002 MON/min | Secure VPN connection with encryption |
| 🎨 **Imagine** | 0.05 MON | AI-powered cyberpunk image generation |
| 📱 **Ghost SMS** | 0.01 MON | Temporary phone number rental |
---
## 🚀 Quick Start
### Prerequisites
- Python 3.x
- MetaMask browser extension
- Monad Testnet tokens (for live demo)
### Installation
1. **Clone or navigate to the project:**
```bash
cd C:\Users\hasan\.gemini\antigravity\scratch\monad-access
```
2. **Install dependencies:**
```bash
pip install -r requirements.txt
```
3. **Run the Flask server:**
```bash
python app.py
```
4. **Open your browser:**
```
http://localhost:5000
```
---
## 🎯 How to Use
1. **Connect Wallet**
- Click "Connect Wallet" button
- Approve MetaMask connection
- Your wallet address will appear in the header
2. **Choose a Service**
- Select from 5 premium services
- Enter required input (text, prompt, country, etc.)
3. **Pay & Access**
- Click the service button
- Approve the transaction in MetaMask
- View results in the terminal window
---
## 🛠️ Tech Stack
### Backend
- **Python 3.x** - Core language
- **Flask** - Web framework
- **Flask-CORS** - Cross-origin support
### Frontend
- **HTML5** - Structure
- **CSS3** - Cyberpunk styling
- **Vanilla JavaScript** - Logic
- **Ethers.js** - Web3 integration
### Blockchain
- **Monad Testnet** - Target blockchain
- **MetaMask** - Wallet provider
---
## 📁 Project Structure
```
monad-access/
├── app.py # Flask backend with 5 service endpoints
├── templates/
│ └── index.html # Complete frontend (HTML + CSS + JS)
├── requirements.txt # Python dependencies
└── README.md # This file
```
---
## 🎨 Design System
### Colors
- **Monad Purple**: `#836EF9` (Primary)
- **Neon Green**: `#00ff88` (Success)
- **Neon Red**: `#ff3366` (Error)
- **Dark Background**: `#0a0a0f`
### Typography
- **Orbitron** - Headers (futuristic, bold)
- **Roboto Mono** - Body text (technical, clean)
### Effects
- Neon glow on hover
- Smooth transitions
- Pulse animations
- Terminal-style logs
---
## 🧪 API Endpoints
All endpoints accept POST requests and return JSON responses.
### GPT-Pro
```bash
POST /api/gpt-pro
Body: { "query": "Your question here" }
```
### Gemini AI
```bash
POST /api/gemini-ai
Body: { "query": "Data to analyze" }
```
### Nano VPN
```bash
POST /api/nano-vpn
Body: {}
```
### Imagine AI Art
```bash
POST /api/imagine
Body: { "prompt": "Cyberpunk city at night" }
```
### Ghost SMS
```bash
POST /api/ghost-sms
Body: { "country": "United States" }
```
---
## 🎬 Demo
The application features:
- ✅ Cyberpunk dark theme with Monad Purple accents
- ✅ 5 interactive service cards
- ✅ MetaMask wallet integration
- ✅ Real-time terminal logging
- ✅ Smooth animations and neon effects
---
## 🔮 Future Enhancements
### Phase 2
- [ ] Real API integrations (OpenAI, VPN providers)
- [ ] Transaction history dashboard
- [ ] Multi-token support (ETH, USDC)
- [ ] Service usage analytics
### Phase 3
- [ ] Mobile app (React Native)
- [ ] Service marketplace
- [ ] Referral rewards
- [ ] Bulk credit packages
---
## 🏆 Hackathon Ready
This MVP is **fully functional** and ready for demo:
- Complete Web3 integration
- Professional UI/UX
- 5 working services
- Real-time logging
- Cyberpunk aesthetic
---
## 📝 License
Built for the Monad Hackathon 2026
---
## 🤝 Contributing
This is a hackathon MVP. For production deployment:
1. Replace mock services with real API integrations
2. Add database for transaction logging
3. Implement proper error handling
4. Deploy to Monad Mainnet
5. Use production WSGI server (Gunicorn)
---
## 📞 Support
**Issues?**
- Ensure MetaMask is installed and unlocked
- Check Flask server is running on port 5000
- Verify you have Monad Testnet tokens
- Check browser console for errors
---
**Built with 💜 for Monad**
*Killing subscriptions, one micro-transaction at a time.*
# MONAI
You can’t perform that action at this time.