Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
AI-powered cryptocurrency safety assistant with database-first architecture. Protects users from phishing, honeypots, rug pulls, and ponzi schemes. No extern...
AI-powered cryptocurrency safety assistant with database-first architecture. Protects users from phishing, honeypots, rug pulls, and ponzi schemes. No extern...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Your AI-powered cryptocurrency safety assistant for OpenClaw Analyzes crypto addresses for phishing, honeypots, rug pulls, and ponzi schemes using a local database with background sync from Etherscan. Zero external API calls during user checks = instant results!
โ Database-first design - All checks query local SQLite database โ Instant results - No API latency during checks (<5ms) โ No rate limits - User queries never hit Etherscan API โ Background sync worker - Separate process pulls from Etherscan โ Transaction message analysis - Decodes and analyzes hex data โ Auto-queue system - Unknown addresses automatically queued for sync โ Deep scanning - Detects suspicious keywords in transaction data
Now catches scams the old version missed: โ "Lazarus Vanguard" hacking group references โ "Orbit Bridge Hacker" mentions โ Private key phishing attempts โ Exploit recruitment messages โ And much more...
crypto-genie/ โโโ SKILL.md # This file โโโ DATABASE_ARCHITECTURE.md # Technical documentation โโโ database.py # SQLite database layer โโโ crypto_check_db.py # Database-only checker (instant) โโโ sync_worker.py # Background Etherscan sync worker โโโ secure_key_manager.py # Encrypted API key storage โโโ install.sh # Auto-installer โโโ setup.sh # API key setup wizard โโโ check_address.sh # Convenience script (sync if needed) โโโ requirements.txt # Python dependencies โโโ venv/ # Virtual environment (created on install)
cd ~/.openclaw/workspace/skills/crypto-genie bash install.sh
Option A: Interactive Setup (Encrypted storage) ./setup.sh # Follow the wizard to encrypt your API key Option B: Environment Variable export ETHERSCAN_API_KEY="your_key_here" Get free API key: https://etherscan.io/myapikey
# Check address (instant, database-only) python3 crypto_check_db.py 0x1234567890abcdef1234567890abcdef12345678
Manual mode: python3 sync_worker.py # Runs continuously, processes queue Batch mode: python3 sync_worker.py --max-jobs 20 # Process 20 addresses then exit Cron schedule (recommended): # Add to crontab */10 * * * * cd ~/.openclaw/workspace/skills/crypto-genie && source venv/bin/activate && ETHERSCAN_API_KEY="key" python3 sync_worker.py --max-jobs 30
User checks address โ โโโโโโโโโโโโโโโโโโโโ โ crypto_check_db โ โ Queries local database ONLY โโโโโโโโโโฌโโโโโโโโโโ (No external API calls) โ โ โโโโโโโโโโโโโโโโโโโโโโโโ โ Local SQLite DB โ โ ~/.config/crypto- โ โ scam-detector/ โ โ โ โ โข Addresses โ โ โข Transactions โ โ โข Risk scores โ โ โข Scam indicators โ โ โข Sync queue โ โโโโโโโโโโฒโโโโโโโโโโโโโโ โ โ Background sync โ โโโโโโโโโโดโโโโโโโโโโโโโโ โ sync_worker.py โ โ Pulls from Etherscan โ โ (Uses your API key) โ โข Reads queue โ โ โข Calls Etherscan โ โ โข Decodes TX data โ โ โข Analyzes messages โ โ โข Stores in DB โ โโโโโโโโโโโโโโโโโโโโโโโโ
Check address: python3 crypto_check_db.py 0x... If in database: Instant results with full analysis If NOT in database: Returns "unknown" status Automatically adds to sync queue Shows: "โณ Check again in a few minutes" Background worker syncs it (next cron run or manual trigger) Check again: Full analysis now available
TypeDetection MethodPhishingKeyword analysis: "private key", "seed phrase", "verify wallet"HoneypotContract code analysis (unverified contracts)Rug PullTransaction pattern analysisExploit GroupsKeywords: "Lazarus", "hack", "exploit", "breach"Social EngineeringKeywords: "urgent", "claim reward", "airdrop winner"
Algorithm factors: Suspicious transaction count (+25 per TX, max +50) Account age (new addresses: +10) Balance patterns (large balance + suspicious TX: +20) Contract verification (unverified: +30) Risk Levels: 0-19: โ Low Risk 20-49: โน๏ธ Medium Risk 50-79: โ ๏ธ High Risk 80-100: ๐จ Critical Risk
# Human-readable output python3 crypto_check_db.py 0x... # JSON output python3 crypto_check_db.py 0x... --json
# Add address to queue python3 sync_worker.py --add-address 0x... # Run worker (continuous) python3 sync_worker.py # Process N addresses then stop python3 sync_worker.py --max-jobs 20 # Custom delay between addresses python3 sync_worker.py --delay 2.0 # Show database stats python3 sync_worker.py --stats
# Check and auto-sync if needed ./check_address.sh 0x... # Automatically syncs if not in DB, then shows results
๐จ Analysis for 0x098b716b8aaf21512996dc57eb0615e2383e2f96 Risk Score: 100/100 - CRITICAL RISK Last Updated: 2026-02-20 07:14:32 ๐จ KNOWN SCAM DETECTED! โ๏ธ Smart Contract โ ๏ธ NOT VERIFIED on Etherscan Transactions: 38 Balance: 101.802430 ETH ๐จ 5 Scam Indicator(s) Detected: โข Suspicious keyword detected: 'lazarus' (confidence: 80%) โข Suspicious keyword detected: 'hack' (confidence: 80%) โข Suspicious keyword detected: 'exploit' (confidence: 80%) โข Suspicious keyword detected: 'private key' (confidence: 80%) โ ๏ธ 5 Suspicious Transaction(s): โข 0x74f7fbfe5a0bd3... Reason: Suspicious keyword detected: 'lazarus' Message: "Greetings Lazarus Vanguard..." ๐ Recommendations: ๐ซ DO NOT send funds to this address โ ๏ธ This address has been flagged as high risk ๐ Report the source that gave you this address
โณ Analysis for 0xnew_address_not_in_db Risk Score: 0/100 - UNKNOWN Last Updated: N/A โณ Address not yet in database Address not in database. Added to sync queue. ๐ Recommendations: โณ This address will be analyzed soon ๐ Check again in a few minutes โ ๏ธ Exercise caution until analysis completes
Default: ~/.config/crypto-genie/crypto_data.db
Free tier: 5 calls/second, 100,000 calls/day Each address: 4 API calls (balance, TX count, TX list, code) Default delay: 1.5 seconds between addresses (safe for free tier)
# Every 10 minutes, process 30 addresses */10 * * * * cd ~/.openclaw/workspace/skills/crypto-genie && source venv/bin/activate && ETHERSCAN_API_KEY="key" python3 sync_worker.py --max-jobs 30 --delay 2.0 # Handles ~4,320 addresses per day
โ Encrypted API key storage - AES-256 with PBKDF2 โ No third-party sharing - API key only sent to Etherscan โ Local processing - All analysis happens on your machine โ No telemetry - Zero data collection โ Open source - Fully auditable code
addresses - Address info, risk scores, balances, metadata transactions - Suspicious transactions with decoded messages scam_indicators - Individual red flags per address sync_queue - Addresses waiting to be synced See DATABASE_ARCHITECTURE.md for full technical details.
Default behavior: First check โ address queued for sync Worker processes queue (manual or cron) Subsequent checks โ instant from database Recommended: Run worker via cron every 5-10 minutes
"Check if 0x1234... is a scam" "Is this address safe: 0xabc..." "Verify 0xdef... before I send ETH"
When you check an address, OpenClaw: Runs crypto_check_db.py If not in DB โ queues for sync Returns current status Suggests checking again after sync
Solution: Wait for background worker to sync it, or manually trigger: python3 sync_worker.py --add-address 0x... python3 sync_worker.py --max-jobs 1
Solution: Set API key via environment or setup wizard: ./setup.sh # or export ETHERSCAN_API_KEY="your_key"
Solution: Increase delay between addresses: python3 sync_worker.py --delay 3.0
โ Check latency: <5ms (database query) โ Sync time: ~2 seconds per address (4 API calls) โ Database size: ~1KB per address โ Capacity: Handles millions of addresses
Featurev1.1.3 (Old)v2.0.0 (New)Check speed2-5 seconds (API calls)<5ms (database)Rate limitsYes (every check)No (checks only query DB)TX message analysisโ Not analyzedโ Fully analyzedFalse negativesHigh (missed scams)Low (deep analysis)ArchitectureDirect API callsDatabase + background workerAPI key usageEvery checkOnly background worker
MIT License - Free and open source
ClawHub: https://clawhub.com/crypto-genie Hackathon: NeoClaw Hackathon 2026
Developed by Trust Claw Team for NeoClaw Hackathon 2026 Built with: SQLite - Local database Etherscan API - Blockchain data ChainAbuse API - Community scam reports Python asyncio - Async operations ๐ Stay safe in crypto! Always verify addresses before sending funds.
Identity, auth, scanning, governance, audit, and operational guardrails.
Largest current source with strong distribution and engagement signals.