Don't trade blind. Understand crypto risk before you invest.
Problem & Solution • Features • Tech Stack • Setup • Usage • Learning Hub
The Problem: The cryptocurrency market is highly volatile, filled with complex smart contract vulnerabilities, rug pulls, and massive whale movements that leave retail investors at a disadvantage. Navigating this landscape safely requires deep technical knowledge and constant monitoring across multiple disparate tools.
The Solution: CryptoGuard is a centralized, AI-driven risk intelligence platform designed to level the playing field. By analyzing millions of live data points—including liquidity metrics, whale transactions, and code vulnerabilities—CryptoGuard synthesizes complex threats into a single, actionable AI Risk Score (0-100), empowering users to make safe, informed investment decisions.
- 🧠 AI Risk Scanner: Enter any token or contract address. Our engine analyzes liquidity pools, historical volatility, and audits smart contracts for red flags (honeypots, infinite minting) to generate a composite safety score.
- 🐋 Real-Time Whale Tracker: Monitor massive wallet movements across exchanges before they move the market. Get alerted when institutions accumulate or dump assets.
- 📊 Portfolio Risk Analyzer: Connect your wallets to receive a holistic exposure assessment. CryptoGuard calculates your portfolio health score, diversification metrics, and suggests rebalancing strategies.
- 🤖 Interactive AI Assistant: Chat with our specialized trading AI to simulate scenarios, backtest strategies without risking capital, or ask questions about specific tokens.
- 🎓 Built-in Learning Hub: A dedicated education center with responsive video cards, step-by-step roadmaps, and simple explanations to guide absolute beginners from first concepts to safe trading.
- 🌃 Cyberpunk Terminal UI: A sleek, immersive "hacker-style" interface featuring glassmorphism cards, neon sweeps, mono typography, drifting particle networks, and satisfying micro-interactions.
| Category | Technologies |
|---|---|
| Frontend Framework | React 18, Vite, TypeScript |
| Routing & State | React Router v6, Context API |
| Styling & UI | Tailwind CSS, System CSS variables, Lucide React (Icons) |
| Animations | Framer Motion, HTML5 Canvas (Custom Particle Engines) |
| Authentication | Phone.Email (Simulation), LocalStorage persistence |
| Data Fetching | Axios (Mocked API Endpoints) |
Get CryptoGuard running on your local machine in seconds.
- Node.js (v16.x or later)
- npm or yarn
-
Clone the repository:
git clone https://github.com/your-username/cryptoguard.git cd cryptoguard -
Install dependencies:
npm install
-
Configure Environment Variables: Rename
.env.exampleto.env(if applicable) and add necessary API keys:VITE_GEMINI_API_KEY=your_api_key_here
-
Start the development server:
npm run dev
-
Open in browser: Navigate to
http://localhost:5173to see the app live.
Authentication & Dashboard
Sign in via the cyberpunk terminal interface (`/auth`). The persistent session system will keep you logged in. From the Dashboard (`/dashboard`), view live Bitcoin/Ethereum tickers, a real-time Fear & Greed index, and global market heatmaps.
Coin Scanner
Navigate to Coin Scanner (`/scanner`) and paste a token contract address. View the generated safety dials highlighting liquidity risk, code audits, and social sentiment.
AI Trading Simulator
Open the AI Assistant (`/assistant`) to chat with the threat intel bot. Use the built-in modal to simulate buy/sell scenarios and see projected risks without using real money.
We believe education is the ultimate risk mitigation. The Learning Hub (/learning) serves as a built-in academy:
▶️ Beginner Video Series: Watch curated YouTube embeds on blockchain basics directly in the app.- 📚 Concept Glossary: Digestible cards explaining Wallets, Exchanges, and Trading mechanics.
- 🗺️ Learning Path Timeline: A structured 5-step roadmap to guide your educational journey.
- 🔗 Verified Resources: External links to trusted platforms like Binance Academy and Coursera.
- Live Blockchain Integration: Replace mock data with real Web3 RPC endpoints (Alchemy, Infura) and WebSockets.
- Web3 Wallet Connect: Integrate MetaMask/WalletConnect to authenticate securely and read actual portfolio holdings.
- Push Notifications: Alert users via email/SMS when a monitored token's risk score exceeds safety thresholds.
- Expanded Multi-chain Support: Monitor risks across Solana, Polygon, and Arbitrum additionally.
If you'd like to contribute, please fork the repository and open a pull request. All major, minor, and security updates are welcome!
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for a safer Web3 ecosystem.