EthoShield 🛡️

AI-powered wallet security analysis tool for Ethereum. Analyze any wallet address for potential risks, scams, and trust scores.

Features

• AI Security Analysis: Get instant security verdicts via the Gemini-powered chatbot
• Ethos Score: Trust scoring from 0-100 based on on-chain activity
• Voice Agent: Listen to concise security verdicts with TTS
• Scam Detection: Cross-reference addresses against known scam databases
• Approval Scanner: Review and manage your token approvals

Quick Start

1. Install Dependencies

npm install

2. Configure Environment Variables

Copy the example environment file:

cp .env.example .env.local

Then edit .env.local and add your API keys:

Variable	Required	Description
VITE_GEMINI_API_KEY	✅ Yes	Get free key
VITE_ETHERSCAN_API_KEY	Recommended	Get free key
VITE_ALCHEMY_API_KEY	Optional	For enhanced on-chain data
VITE_INFURA_API_KEY	Optional	Alternative RPC provider
VITE_CHAINABUSE_API_KEY	Optional	Scam database lookups

3. Run the Development Server

npm run dev

Open http://localhost:5173 in your browser.

Usage

1. Click the floating chat button (bottom-right corner)
2. Paste any Ethereum address (e.g., 0x71C7656EC7ab88b098defB751B7401B5f6d8976F)
3. Get an instant security analysis with:
   • Ethos Score (0-100)
   • Risk Level (LOW / MEDIUM / HIGH)
   • Voice Summary (click "Listen" or enable auto-play)

Tech Stack

• React 19 + Vite
• Gemini AI (Google's generative AI)
• Ethers.js (blockchain interactions)
• Lucide React (icons)

License

MIT