Skip to main content

All-in-one crypto security toolkit โ€” honeypot, approvals, rugpull, phishing

Project description

๐Ÿ›ก 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+ License: MIT PyPI

Why CryptoShield?

Every day, people lose money to:

  • Honeypot tokens โ€” you can buy but can't sell. Your funds are trapped.
  • Unlimited token approvals โ€” you gave a random contract permission to drain your wallet. Months later, they do.
  • Rugpulls โ€” team dumps all tokens, liquidity vanishes, price goes to zero.
  • Phishing sites โ€” fake airdrop pages that look like Uniswap but steal your seed phrase.

CryptoShield combines all these checks into one CLI tool. No API keys needed. No accounts. No BS. Just run a command and get a clear report.

# Before you ape into that token:
cryptoshield check 0xToken

# Before you connect your wallet to some random site:
cryptoshield check-url suspicious-site.com

# Check if your wallet has dangerous approvals:
cryptoshield approvals 0xYourWallet

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

pip install cryptoshield

Or from source:

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

Usage

Full security report (EVM)

cryptoshield check 0xdAC17F958D2ee523a2206206994597C13D831ec7
cryptoshield check 0xToken --chain bsc
cryptoshield check 0xToken --quick  # honeypot only

Solana token check

cryptoshield check EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana

Scan wallet approvals

cryptoshield approvals 0xYourWallet
cryptoshield approvals 0xYourWallet --chain polygon

Check phishing URL

cryptoshield check-url uniswap-airdrop.com
cryptoshield check-url https://app.uniswap.org
cryptoshield check-url metamask-sync.xyz

Solana wallet scan

cryptoshield solana YourSolanaWalletAddress

Batch check

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

๐Ÿ“‹ APPROVAL AUDIT โ€” 0x47ac...8188
  โŒ USDT โ†’ UNLIMITED to 0xUnkn...abcd
         โšก RECOMMEND: revoke immediately
  โš ๏ธ  WETH โ†’ unlimited to Uniswap V2 Router
         Known protocol โ€” consider reducing allowance
  โœ… DAI โ†’ 500.00 to Uniswap V3 Router

Supported Chains

Chain Honeypot Approvals Rugpull
Ethereum โœ… โœ… โœ…
BSC โœ… โœ… โœ…
Polygon โœ… โœ… โœ…
Arbitrum โœ… โœ… โœ…
Optimism โœ… โœ… โœ…
Base โœ… โœ… โœ…
Avalanche โœ… โœ… โœ…
Fantom โœ… โœ… โœ…
Solana โœ… ๐Ÿ”œ โœ…

๐Ÿ”œ = Coming soon. SPL token delegation uses a different model than ERC-20 approvals.

How It Works

Check Data Source Key Needed?
Honeypot GoPlus Security API No
Approvals On-chain events (RPC) No
Rugpull GoPlus + on-chain heuristics No
Phishing Pattern matching + 60+ known domains No
Solana tokens Jupiter + Birdeye + Solana RPC No

Everything runs with public APIs and free RPC endpoints. No signups. No API keys. No tracking.

Contributing

PRs welcome! Especially:

  • More scam domains / phishing patterns
  • More chain support (TON, Sui, Aptos)
  • SPL token delegation scanner (Solana approvals)
  • Better rugpull heuristics
  • UI improvements

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cryptoshield-0.2.2.tar.gz (21.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cryptoshield-0.2.2-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

Details for the file cryptoshield-0.2.2.tar.gz.

File metadata

  • Download URL: cryptoshield-0.2.2.tar.gz
  • Upload date:
  • Size: 21.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for cryptoshield-0.2.2.tar.gz
Algorithm Hash digest
SHA256 42d9b5994a1e6605f3bf24470537098148d4619883c932d07fdbcc6c797a5db7
MD5 4fc92afd2a882371fb77050e2c92e2e2
BLAKE2b-256 c80d873d71cb16f8d45b2e6090731e2b44968d311a1704e62fab6c5a63957c3f

See more details on using hashes here.

File details

Details for the file cryptoshield-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: cryptoshield-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 22.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for cryptoshield-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b4cace6e99aa3bf6aee337e27f0d6424bccd5318d08a731a059896696bd9128c
MD5 ad734ea802b6d068dd87ea2cc9c3e9a3
BLAKE2b-256 c78a17e1d4a359152499c5115fe7c428a39269d08bed558816c1043a853e931d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page