MorphEcho - Decentralized Whispers

MorphEcho is a decentralized social platform that allows users to share ephemeral, AI-scrambled whispers as temporary NFTs on the Morph L2 blockchain. Experience anonymous, privacy-preserving communication where your thoughts are transformed by locally running AI through a Gaia node and automatically expire.

✨ Features

• 🤫 Ephemeral Whispers: Share temporary thoughts that expire and disappear forever
• 🤖 AI-Powered Privacy: Your thoughts are intelligently scrambled by AI while preserving emotional essence
• 💝 Community Engagement: Heart whispers you find meaningful and build connections
• 🚩 Self-Moderation: Community-driven reporting system to maintain a respectful environment
• 📊 Live Analytics: Real-time statistics showing AI usage and community growth
• 🔗 Blockchain Native: Built on Morph L2 with smart contract integration for true decentralization
• 🎭 Anonymous Expression: Share freely without revealing your identity

🚀 Live Demo

Visit the live application: https://morph-echo.up.railway.app

Smart Contracts Repo: https://github.com/harishkotra/morph-echo-contracts

Deployed Smart Contract: https://explorer-holesky.morphl2.io/address/0x561C97731839A1C65070B424283A7cb3d41027Da

Network: Morph Testnet
Contract: 0x561C97731839A1C65070B424283A7cb3d41027Da

Screenshots

🛠 Technology Stack

• Frontend: Vanilla JavaScript, Bootstrap, Ethers.js
• Backend: Node.js, Express.js
• AI Integration: Gaia AI for text transformation
• Blockchain: Morph L2 (Ethereum Layer 2)
• Smart Contracts: Solidity NFT contracts
• Database: Persistent storage for analytics and community features

🏃‍♂️ Quick Start

Prerequisites

• Node.js (v16 or higher)
• MetaMask or compatible Web3 wallet
• Access to Morph Testnet

Installation

# Clone the repository
git clone https://github.com/harishkotra/morph-echo-dapp/
cd morphecho

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your configuration

# Start the application
npm start

Visit http://localhost:3000 and connect your wallet to start sharing whispers!

🔧 Configuration

Create a .env file with the following variables:

PORT=3000
VITE_CONTRACT_ADDRESS=0x561C97731839A1C65070B424283A7cb3d41027Da
VITE_GAIA_API_KEY=your-gaia-api-key
VITE_GAIA_BASE_URL=your-gaia-endpoint

# Database configuration (optional for enhanced features)
DB_HOST=your-db-host
DB_PORT=3306
DB_NAME=morphecho
DB_USER=your-username
DB_PASSWORD=your-password

🎯 How It Works

1. Connect Wallet: Connect your MetaMask to Morph Testnet
2. Write Whisper: Share your thoughts or feelings
3. AI Transformation: Your text is intelligently scrambled for privacy using a locally running Gaia node
4. Mint NFT: Create a temporary NFT that expires automatically
5. Community Interaction: Others can heart your whispers or report inappropriate content
6. Ephemeral Nature: Whispers disappear forever when they expire

🤖 AI Integration

MorphEcho uses advanced AI to transform your personal thoughts into poetic, anonymous whispers:

• Privacy Preservation: Removes identifying information while maintaining emotional core
• Creative Transformation: Converts thoughts into metaphors, haikus, or abstract expressions
• Token Tracking: Monitors AI usage for transparency and analytics
• Multiple Styles: Supports various transformation approaches for diverse expression

🌐 Blockchain Features

Smart Contract Capabilities

• Temporary NFTs: Whispers are minted as NFTs with built-in expiration
• Automatic Cleanup: Expired whispers are automatically marked as "forgotten"
• On-Chain Feed: Real-time whisper discovery through blockchain events
• Decentralized Storage: No central authority controls your whispers

Morph L2 Benefits

• Low Gas Fees: Affordable minting and interaction costs
• Fast Transactions: Quick confirmation times for seamless UX
• Ethereum Security: Inherits security from Ethereum mainnet
• Scalable: High throughput for community growth

📊 Community Analytics

The platform provides real-time insights:

• AI Tokens Consumed: Total AI processing across all users
• Active Whispers: Current number of live whispers
• Community Size: Total unique wallet addresses
• Engagement Metrics: Hearts and community interactions

🛡 Privacy & Safety

• Anonymous by Design: No personal data collection or storage
• AI-Scrambled Content: Original thoughts are never stored
• Community Moderation: User-driven reporting system
• Temporary Nature: All content automatically expires
• Decentralized: No single point of control or censorship

📜 License

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

---

MorphEcho - Where thoughts become whispers, and whispers become art. 🎭✨