Paste any BSC token address → get an instant AI-powered safety analysis → on-chain attestation on opBNB.

🌐 Live Demo: opvibecheck.xyz
⚔️ Comparison: opvibecheck.xyz/compare
👛 Portfolio Scanner: opvibecheck.xyz/portfolio
📜 Contract: 0x427F...AA161 on opBNB (v2, with access control)
🏗️ Track: Consumer
🎯 Hackathon: Good Vibes Only: OpenClaw Edition

VibeCheck helps users evaluate the safety of any BEP-20 token on BNB Smart Chain before investing. It combines on-chain data analysis with AI to provide a clear, actionable safety report.

• Instant AI Safety Analysis — Powered by Gemini 3 Flash for lightning-fast, high-reasoning audits.
• On-Chain Attestations — Every scan result is permanently recorded on opBNB as an immutable, verifiable proof.
• ⚔️ Comparison Mode — Compare two tokens side-by-side to make better investment decisions.
• 👛 Portfolio Scanner — Paste any BSC wallet address, scan all held tokens in parallel.
• Premium Visualization — Holder concentration charts and liquidity depth bars.
• Project Intel — Deep-dive into verification status, ownership, and supply metrics.
• Redis Caching — Repeat scans return instantly via Upstash Redis (1hr TTL).

1. Paste a token address — any BSC BEP-20 contract
2. On-chain data fetching — contract source code, top holders, PancakeSwap liquidity, recent large transfers
3. AI safety analysis — Gemini 3.0 Flash Preview analyzes the data and produces a structured safety report
4. Safety score 0-100 with risk level (SAFE / CAUTION / DANGER / CRITICAL)
5. On-chain attestation — the verdict is permanently recorded on opBNB

Home	Scan Result	Comparison

• Frontend: Next.js 16 + React 19 + Tailwind CSS v4
• AI: Gemini 3.0 Flash Preview via OpenRouter
• On-chain data: BSCScan API + ethers.js (direct RPC calls to BSC)
• Attestation: Custom Solidity contract on opBNB (verified)
• Liquidity: PancakeSwap V2 factory/pair contracts
• Streaming: Server-Sent Events for real-time scan progress

User → Next.js Frontend
         ↓
    API Route (POST /api/scan-stream)
         ↓
    ┌────────────────────────────┐
    │ 1. Fetch BSC Data          │
    │    • BSCScan API           │
    │    • Direct RPC (ethers)   │
    │    • PancakeSwap V2        │
    ├────────────────────────────┤
    │ 2. AI Analysis             │
    │    • Gemini 3.0 Flash via  │
    │      OpenRouter            │
    │    • Structured JSON       │
    │      output                │
    ├────────────────────────────┤
    │ 3. On-chain Attestation    │
    │    • VibeCheck.sol on      │
    │      opBNB                 │
    │    • Permanent record      │
    └────────────────────────────┘
         ↓
    SSE Stream → Frontend
    (real-time progress updates)

vibecheck/
├── contracts/
│   └── VibeCheck.sol          # On-chain attestation contract (opBNB)
├── frontend/
│   └── src/
│       ├── app/
│       │   ├── page.tsx        # Main UI — input, score gauge, report
│       │   ├── compare/        # ⚔️ Comparison mode
│       │   ├── portfolio/      # 👛 Wallet portfolio scanner
│       │   ├── history/        # On-chain scan history + attestation proofs
│       │   └── api/
│       │       ├── scan/       # Original scan endpoint
│       │       ├── scan-stream/# SSE streaming scan
│       │       ├── total-scans/# Contract scan counter
│       │       └── history/    # On-chain history data
│       ├── components/
│       │   ├── HolderChart.tsx # 🏦 Holder distribution
│       │   ├── LiquidityPanel.tsx# 💧 Liquidity depth
│       │   └── TokenLogo.tsx   # 🖼️ CDN-powered logos
│       └── lib/
│           ├── analyzer.ts     # AI analysis pipeline (Gemini 3.0)
│           ├── attester.ts     # opBNB attestation submission
│           ├── fetcher.ts      # BSC data fetching
│           ├── chain.ts        # ABIs, addresses, providers
│           └── types.ts        # TypeScript interfaces
├── scripts/
│   └── deploy.js              # Contract deployment script
├── AI_BUILD_LOG.md            # Detailed AI build log
└── README.md

# Clone
git clone https://github.com/AnishDe12020/vibecheck
cd vibecheck/frontend

# Install
npm install

# Configure
cp .env.local.example .env.local
# Fill in your keys (see .env.local.example)

# Run
npm run dev

Open http://localhost:3000, paste a BSC token address, hit Scan.

cd vibecheck
node scripts/deploy.js mainnet   # or 'testnet'

Requires opBNB gas in the deployer wallet. Current deployment cost: ~$0.003.

• Contract v2: 0x427F80AE3ebF7C275B138Bc9C9A39C76572AA161
• Contract v1 (deprecated): 0x851d1B08F9166D18eC379B990D7E9D6d45FFA8CA
• Network: opBNB Mainnet (Chain ID 204)
• v2 changes: Added access control (only authorized scanners can submit attestations)
• Sample attestations (v1):
  • WBNB scan
  • CAKE scan
  • SafeMoon scan

• IP-based rate limiting: 5 scans per IP per hour
• In-memory store (best-effort in serverless; for production, use Upstash Redis)
• Applied to /api/scan and /api/scan-stream

• onlyAuthorized modifier on submitAttestation — only whitelisted scanner addresses can write
• Owner can addScanner(address) / removeScanner(address)
• Deployer is auto-authorized in constructor

• Content-Type enforcement (must be application/json)
• Max body size (1KB)
• Input address validation via ethers.js

• Restricted to vibecheck-bsc.vercel.app and localhost origins

• Stack traces and file paths are stripped from client-facing errors

• Cloudflare WAF — custom domain + Cloudflare proxy for DDoS protection and bot filtering
• Upstash Redis rate limiter — persistent, serverless-friendly rate limiting across all instances
• Contract verification — verify v2 contract source on opBNB BSCScan

See AI_BUILD_LOG.md for a detailed breakdown of how AI was used throughout development.

TL;DR: Built over 2 days with Claude Opus 4 (via OpenClaw) handling architecture, coding, deployment, and testing. Gemini 3 Flash powers the runtime token analysis. Multi-agent parallel development with 5+ sub-agents for concurrent feature building.

MIT