Skip to content

sheikhlimon/crypto-guardian

Repository files navigation

Crypto Guardian

A crypto wallet safety checker. Paste any blockchain address and instantly see if it's safe to interact with. Analyzes transaction patterns, checks against known scam databases, and assigns a risk score.

Built with React, TypeScript, and Express. Supports Ethereum, Bitcoin, and EVM chains.

Quick Start

pnpm install
pnpm dev

Prerequisites

  • Node.js 24+ (.nvmrc)
  • pnpm 10.0.0+

Environment

cp backend/.env.example backend/.env
# Add your Etherscan API key (free): https://etherscan.io/apis

Tech Stack

  • Frontend: Vite + React + TypeScript + Tailwind CSS + Radix UI
  • Backend: Node.js + Express + TypeScript
  • APIs: Etherscan V2 (free key), BlockCypher (free)
  • Prices: Blockchain.info (BTC), Coinbase (ETH, BNB, MATIC, ARB)
  • Blacklist: ScamSniffer (community-maintained scam address database)

API

POST /api/check-address

{ "address": "0x165CD37b4C644C2921454429E7F9358d18A45e14" }
{
  "success": true,
  "data": {
    "address": "0x165cd37b4c644c2921454429e7f9358d18a45e14",
    "verdict": "CLEAN",
    "risk_score": 10,
    "findings": ["High transaction volume with low value"],
    "transaction_count": 78958,
    "total_value": "348.57",
    "recommendation": "No suspicious activity detected",
    "blockchain": "ethereum",
    "balance": "157955776415709087"
  }
}

Blacklist Hit

If the address is found in the ScamSniffer database:

{
  "success": true,
  "data": {
    "verdict": "MALICIOUS",
    "risk_score": 100,
    "findings": ["Address found in ScamSniffer scam database"],
    "blacklistInfo": { "source": "scamsniffer" }
  }
}

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors