Soniavasseur / Wallet-Risk-Scanner

# Wallet-Risk-Scanner
Multi-chain crypto wallet risk scanner for AML/KYT screening. Scores addresses 0–100 using sanctions, risky contracts and fund tracing. Integrates 6 intelligence providers with failover, detects scams, hacks, mixers and phishing, supports 15+ chains, batch screening and TXT/JSON/CSV/HTML/PDF reports. Python, cross-platform.
---
# Wallet Risk Scanner
**Multi-Service AML Screening — 15+ Chains, 6 Intel Providers**
---
*Multi-service AML screening engine that scores any wallet address on a 0–100 risk scale. Sanctions matching, high-risk contract detection and fund source tracing — aggregated from six intelligence providers across 15+ blockchains.*
Features · Scoring Model · Providers · Getting Started · Configuration · Usage · FAQ
---
## Features
### Screening Engine
| Feature | Status |
|---------|--------|
| Single Address Risk Report | ✅ |
| Batch Screening (multi-thread) | ✅ |
| 0–100 Weighted Risk Score | ✅ |
| LOW / MEDIUM / HIGH / CRITICAL Bands | ✅ |
| Multi-Hop Fund Source Tracing | ✅ |
| Mixer Interaction Detection | ✅ |
| Honeypot / Rug-Pull Signals | ✅ |
| JSON / CSV / HTML / PDF Reports | ✅ |
### Intelligence Coverage
| Feature | Status |
|---------|--------|
| OFAC SDN Sanctions List | ✅ |
| ScamSniffer Phishing DB | ✅ |
| ChainAbuse Community Reports | ✅ |
| Tornado Cash / Mixer Sets | ✅ |
| GoPlus Security (keyless) | ✅ |
| Etherscan V2 / BscScan | ✅ |
| MistTrack / BlockSec (optional) | ✅ |
| 24h Local Blacklist Caching | ✅ |
---
## Scoring Model
Every screened wallet receives a **0–100 risk score** built from three weighted dimensions:
| Dimension | Cap | What it measures |
|-----------|:---:|:---|
| **Sanctions Exposure** | 40 | Direct or transitive links to OFAC SDN entries, sanctioned entities and known hacker addresses |
| **Contract Interaction** | 30 | Calls to honeypots, rug-pull tokens, phishing contracts and malicious approvals (GoPlus signals) |
| **Fund Source** | 30 | Inflows traceable to mixers, stolen funds or darknet-market clusters (multi-hop) |
The weighted sum maps onto four operational bands:
| Score | Band | Recommended action |
|:-----:|:-----|:-------------------|
| 0–20 | 🟢 **LOW** | No action required |
| 21–50 | 🟡 **MEDIUM** | Manual review advised |
| 51–80 | 🔴 **HIGH** | Avoid interaction |
| 81–100 | ⛔ **CRITICAL** | Block / report |
Bands and weights are fully configurable — tune them to your compliance policy in `config.json`.
---
## Intelligence Providers
| Provider | Coverage | Auth | Notes |
|----------|----------|------|-------|
| **GoPlus Security** | Token & contract risk | Keyless | Works out of the box, no signup |
| **Etherscan V2** | Tx history & contract verification | API key | One key covers all EVM chains |
| **BscScan V1** | BSC transaction history | API key | Fallback for BSC-specific data |
| **ChainAbuse** | Community abuse reports | API key | Optional, adds phishing signals |
| **MistTrack** | Address risk score | API key | Optional, SlowMist label graph |
| **B