🛡️ BaseGuard - Protect Your Base Trades

Web application to analyze token security on Base blockchain.

✨ Features

• ✅ Clean, professional UI (Base blue theme)
• ✅ Token address input
• ✅ 6-category risk analysis (mock)
• ✅ Risk score and detailed report
• ✅ Responsive design (mobile-first)

📋 Current Status

Frontend ready - UI is fully functional. Currently uses mock data (simulated scan results).

🔜 Next Steps (Real Blockchain Integration)

1. Token Contract Reading

// Create src/lib/tokenScanner.ts
- Call ERC20 functions
- Read owner, totalSupply, decimals

2. Honeypot Detection

- Download contract source code (Basescan API)
- Parse with @solidity-parser/parser
- Check sell function, modifiers, tax

3. Liquidity Analysis

- Find Uniswap/Aerodrome pool
- Check LP tokens
- Verify lock status (Team.Finance, Unicrypt API)

4. Holder Distribution

- Get holder list from Basescan API
- Calculate top 10 percentage

🛠️ Tech Stack

• Frontend: Next.js 14, React, TypeScript
• Styling: Tailwind CSS
• Animation: Framer Motion
• Icons: Lucide React
• Blockchain: wagmi, viem (ready to integrate)

📂 Project Structure

baseguard/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # Root layout + providers
│   │   ├── page.tsx        # Main page (UI)
│   │   └── globals.css     # Global styles
│   ├── components/
│   │   └── WagmiProvider.tsx  # Blockchain providers
│   ├── lib/
│   │   └── tokenScanner.ts  # (TODO: Real scanning logic)
│   └── types/
│       └── index.ts        # (TODO: TypeScript types)
├── package.json
├── tailwind.config.ts
├── tsconfig.json
└── README.md

📄 License

MIT

---

Built with ❤️ on Base