# Send Crypto Genie to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "crypto-genie",
    "name": "Crypto Genie",
    "source": "tencent",
    "type": "skill",
    "category": "安全合规",
    "sourceUrl": "https://clawhub.ai/princedoss77/crypto-genie",
    "canonicalUrl": "https://clawhub.ai/princedoss77/crypto-genie",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/crypto-genie",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crypto-genie",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "blockchain_detector.py",
      "CHANGELOG.md",
      "check_address.sh",
      "clawhub-manifest.json",
      "crypto_check_db.py",
      "database.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/crypto-genie"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/crypto-genie",
    "downloadUrl": "https://openagent3.xyz/downloads/crypto-genie",
    "agentUrl": "https://openagent3.xyz/skills/crypto-genie/agent",
    "manifestUrl": "https://openagent3.xyz/skills/crypto-genie/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/crypto-genie/agent.md"
  }
}
```
## Documentation

### 🧞 Crypto Genie v2.0

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!

### 🚀 Major Architecture Upgrade

✅ 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

### 🔍 Enhanced Detection

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...

### 📦 What's Included

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)

### 1. Install

cd ~/.openclaw/workspace/skills/crypto-genie
bash install.sh

### 2. Configure Etherscan API Key (Optional but Recommended)

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

### 3. Check an Address

# Check address (instant, database-only)
python3 crypto_check_db.py 0x1234567890abcdef1234567890abcdef12345678

### 4. Run Background Sync Worker

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

### Architecture Flow

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       │
└──────────────────────┘

### User Flow

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

### Scam Types Detected

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"

### Risk Scoring

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

### Check Address

# Human-readable output
python3 crypto_check_db.py 0x...

# JSON output
python3 crypto_check_db.py 0x... --json

### Sync Worker

# 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

### Convenience Script

# Check and auto-sync if needed
./check_address.sh 0x...
# Automatically syncs if not in DB, then shows results

### Critical Risk Address

🚨 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

### Unknown Address (Not Yet Synced)

⏳ 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

### Database Location

Default: ~/.config/crypto-genie/crypto_data.db

### Etherscan API Rate Limits

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)

### Recommended Cron Schedule

# 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

### 🛡️ Security

✅ 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

### Tables

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.

### 🔄 Sync Frequency

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

### Via Chat

"Check if 0x1234... is a scam"
"Is this address safe: 0xabc..."
"Verify 0xdef... before I send ETH"

### Automatic Detection

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

### "Address not in database"

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

### "Etherscan API key not configured"

Solution: Set API key via environment or setup wizard:

./setup.sh  # or
export ETHERSCAN_API_KEY="your_key"

### Rate limit errors

Solution: Increase delay between addresses:

python3 sync_worker.py --delay 3.0

### 📈 Performance

✅ Check latency: <5ms (database query)
✅ Sync time: ~2 seconds per address (4 API calls)
✅ Database size: ~1KB per address
✅ Capacity: Handles millions of addresses

### 🆚 Comparison: v1 vs v2

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

### 📜 License

MIT License - Free and open source

### 🤝 Support

ClawHub: https://clawhub.com/crypto-genie
Hackathon: NeoClaw Hackathon 2026

### 🏆 Credits

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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: princedoss77
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/crypto-genie)
- [Send to Agent page](https://openagent3.xyz/skills/crypto-genie/agent)
- [JSON manifest](https://openagent3.xyz/skills/crypto-genie/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/crypto-genie/agent.md)
- [Download page](https://openagent3.xyz/downloads/crypto-genie)