Metadata-Version: 2.4
Name: cryptoshield
Version: 0.2.0
Summary: All-in-one crypto security toolkit — honeypot, approvals, rugpull, phishing
Author-email: yossweh <cilokcilok15@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/yossweh/cryptoshield
Project-URL: Repository, https://github.com/yossweh/cryptoshield
Project-URL: Issues, https://github.com/yossweh/cryptoshield/issues
Keywords: crypto,security,honeypot,rugpull,web3,defi,approval
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: web3>=6.0.0
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# 🛡 CryptoShield

**All-in-one crypto security toolkit.** Check tokens before you buy. Scan your wallet for dangerous approvals. Detect rugpulls. Block phishing sites.

[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/pypi/v/cryptoshield.svg)](https://pypi.org/project/cryptoshield/)

## Features

- **🍯 Honeypot Detection** — Can you sell? Hidden taxes? Mint function? Check before you buy.
- **📋 Approval Scanner** — Find all token approvals on your wallet. Flag dangerous unlimited approvals.
- **🔴 Rugpull Scorer** — Analyze contracts for common rug patterns. Score 0-100.
- **🎣 Phishing Checker** — 60+ known scam domains. Typosquatting, fake airdrops, wallet drainers.
- **☀️ Solana Support** — Check SPL tokens, freeze/mint authority, Jupiter listing status.
- **📦 Batch Mode** — Check 100+ tokens/wallets from a file.

## Install

```bash
pip install cryptoshield
```

Or from source:

```bash
git clone https://github.com/yossweh/cryptoshield
cd cryptoshield
pip install -e .
```

## Usage

### Full security report (EVM)
```bash
cryptoshield check 0xdAC17F958D2ee523a2206206994597C13D831ec7
cryptoshield check 0xToken --chain bsc
cryptoshield check 0xToken --quick  # honeypot only
```

### Solana token check
```bash
cryptoshield check EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana
```

### Scan wallet approvals
```bash
cryptoshield approvals 0xYourWallet
cryptoshield approvals 0xYourWallet --chain polygon
```

### Check phishing URL
```bash
cryptoshield check-url uniswap-airdrop.com
cryptoshield check-url https://app.uniswap.org
cryptoshield check-url metamask-sync.xyz
```

### Solana wallet scan
```bash
cryptoshield solana YourSolanaWalletAddress
```

### Batch check
```bash
cryptoshield batch tokens.txt --mode honeypot
cryptoshield batch tokens.txt --mode honeypot --chain solana
cryptoshield batch wallets.txt --mode approvals --chain bsc
```

## Example Output

```
🛡 CRYPTO SHIELD REPORT
━━━━━━━━━━━━━━━━━━━━━━━

🍯 HONEYPOT CHECK — Tether USD (USDT)
  ✅ Can sell: YES
  ✅ Tax: 0% buy / 0% sell
  ❌ Owner can mint: YES — infinite supply risk
  ❌ Owner can change balances: YES
  ✅ Contract: Verified
  ℹ️  Holders: 14,585,422
  ⚠️  Risk Score: 30/100 — MEDIUM RISK

🎣 PHISHING CHECK — uniswap-airdrop.com
  🚨 KNOWN SCAM DOMAIN — DO NOT VISIT
  ❌ KNOWN SCAM DOMAIN — uniswap-airdrop.com is in scam database

☀️ SOLANA TOKEN CHECK — SafeToken (SAFE)
  ✅ Listed on Jupiter
  ✅ On Jupiter Strict List (vetted)
  ✅ Freeze Authority: None
  ✅ Mint Authority: None (fixed supply)
  ✅ Holders: 5,432
  ✅ Risk Score: 0/100 — LOW RISK
```

## Supported Chains

| Chain | Honeypot | Approvals | Rugpull |
|-------|----------|-----------|---------|
| Ethereum | ✅ | ✅ | ✅ |
| BSC | ✅ | ✅ | ✅ |
| Polygon | ✅ | ✅ | ✅ |
| Arbitrum | ✅ | ✅ | ✅ |
| Optimism | ✅ | ✅ | ✅ |
| Base | ✅ | ✅ | ✅ |
| Avalanche | ✅ | ✅ | ✅ |
| Fantom | ✅ | ✅ | ✅ |
| Solana | ✅ | — | ✅ |

## Data Sources

- **GoPlus Security API** — Honeypot detection, token security analysis (free, no key)
- **Jupiter API** — Solana token data, strict list
- **Birdeye API** — Solana holder count, volume
- **On-chain data** — Approval events, contract code, ownership (direct RPC)
- **Heuristics** — URL pattern matching, domain analysis, typosquatting detection
- **Community scam database** — 60+ known phishing domains

## Contributing

PRs welcome! Especially:

- More scam domains / phishing patterns
- More chain support (TON, Sui, Aptos)
- Better rugpull heuristics
- UI improvements

## License

MIT
