{"id":26884139,"url":"https://github.com/v74all/chainwatch","last_synced_at":"2025-06-13T22:32:46.911Z","repository":{"id":273863232,"uuid":"921116523","full_name":"v74all/Chainwatch","owner":"v74all","description":"ChainWatch is an intelligent blockchain transaction analysis and monitoring tool that uses artificial intelligence and machine learning to identify suspicious patterns and behaviors. This tool supports multiple blockchain networks and provides advanced capabilities for transaction analysis.","archived":false,"fork":false,"pushed_at":"2025-01-23T11:47:46.000Z","size":57,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-23T12:23:50.313Z","etag":null,"topics":["analysis","cryptocurrency","scam","scanner"],"latest_commit_sha":null,"homepage":"https://v7lthronyx.xyz/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/v74all.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-23T11:16:44.000Z","updated_at":"2025-01-23T11:47:50.000Z","dependencies_parsed_at":"2025-01-23T12:34:05.209Z","dependency_job_id":null,"html_url":"https://github.com/v74all/Chainwatch","commit_stats":null,"previous_names":["v74all/chainwatch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v74all%2FChainwatch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v74all%2FChainwatch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v74all%2FChainwatch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/v74all%2FChainwatch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/v74all","download_url":"https://codeload.github.com/v74all/Chainwatch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246510256,"owners_count":20789310,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","cryptocurrency","scam","scanner"],"created_at":"2025-03-31T17:40:15.729Z","updated_at":"2025-03-31T17:40:16.381Z","avatar_url":"https://github.com/v74all.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChainWatch Analyzer 1.5 beta\n\u003cdiv dir=\"rtl\"\u003e\n\n## معرفی\nچین‌واچ یک ابزار تحلیل و نظارت هوشمند بر تراکنش‌های بلاکچین است که با استفاده از هوش مصنوعی و یادگیری ماشین، الگوها و رفتارهای مشکوک را شناسایی می‌کند. این ابزار از چندین شبکه بلاکچین پشتیبانی می‌کند و قابلیت‌های پیشرفته‌ای برای تحلیل تراکنش‌ها ارائه می‌دهد.\n\n### ویژگی‌های اصلی\n- تحلیل چند زنجیره‌ای تراکنش‌ها\n- شناسایی الگوهای مشکوک\n- امتیازدهی ریسک\n- تحلیل توپولوژی شبکه\n- تشخیص ناهنجاری‌ها\n- شناسایی مسیرهای تبادل\n- پشتیبانی از زبان فارسی و انگلیسی\n\n### نصب و راه‌اندازی\n\u003c/div\u003e\n\n---\n\n## Introduction\nChainWatch is an intelligent blockchain transaction analysis and monitoring tool that uses artificial intelligence and machine learning to identify suspicious patterns and behaviors. This tool supports multiple blockchain networks and provides advanced capabilities for transaction analysis.\n\n### Key Features\n- Multi-chain transaction analysis\n- Suspicious pattern detection\n- Risk scoring\n- Network topology analysis\n- Anomaly detection\n- Exchange path identification\n- Bilingual support (English/Persian)\n\n### Installation\n\n```bash\ngit clone https://github.com/v74all/Chainwatch.git\ncd chainwatch\npip install -r requirements.txt\n```\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## پیکربندی\nبرای استفاده از برنامه، فایل `.env` را در مسیر اصلی پروژه ایجاد کرده و کلیدهای API مورد نیاز را در آن قرار دهید:\n\u003c/div\u003e\n\n## Configuration\nCreate a `.env` file in the project root and add your API keys:\n\n```env\nTRON_API_KEY_1=your_tron_api_key_1\nTRON_API_KEY_2=your_tron_api_key_2\nETHERSCAN_API_KEY=your_etherscan_api_key\nBLOCKCYPHER_TOKEN=your_blockcypher_token\n# ... other API keys\n```\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## نحوه استفاده\nبرنامه را می‌توانید از طریق خط فرمان با گزینه‌های مختلف اجرا کنید:\n\u003c/div\u003e\n\n## Usage\nYou can run the program through command line with various options:\n\n```bash\n# Basic Analysis / تحلیل پایه\npython cli.py -a 0x123... --format json --output results.json\n\n# Deep Analysis with Risk Assessment / تحلیل عمیق با ارزیابی ریسک\npython cli.py -a 0x123... -b ethereum --mode deep --risk-threshold 0.8 --verbose\n\n# Multi-Address Analysis / تحلیل چند آدرس\npython cli.py -a 0x123... 0x456... Tz1... --batch-size 200 --depth 4\n\n# Generate HTML Report / تولید گزارش HTML\npython cli.py -a 0x123... --format html --output report.html --lang fa\n\n# System Health Check / بررسی سلامت سیستم\npython cli.py --health-check\n```\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## پارامترهای خط فرمان\n\u003c/div\u003e\n\n## Command Line Parameters\n\n```\nRequired Arguments:\n  -a, --addresses        One or more wallet addresses to analyze\n\nAnalysis Configuration:\n  -b, --blockchain      Specific blockchain to analyze (ethereum/bsc/tron/etc)\n  -d, --depth           Analysis depth (default: 3)\n  --mode               Analysis mode (quick/deep)\n  --risk-threshold     Risk threshold (0.0-1.0)\n  --batch-size         Batch size for processing\n\nOutput Options:\n  -o, --output         Output file path\n  -f, --format         Output format (json/csv/html)\n\nAdditional Options:\n  --verbose           Enable detailed output\n  --lang              Interface language (en/fa)\n  --no-progress       Disable progress bars\n  --debug             Enable debug mode\n  --health-check      Run system health check\n```\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## بلاکچین‌های پشتیبانی شده\n\u003c/div\u003e\n\n## Supported Blockchains\n\n- Ethereum (ETH)\n- Binance Smart Chain (BSC)\n- Tron (TRX)\n- Solana (SOL)\n- Polygon (MATIC)\n- Avalanche (AVAX)\n- Cardano (ADA)\n- Fantom (FTM)\n- Arbitrum (ARB)\n- Optimism (OP)\n- And many more...\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## نمونه خروجی\nبرنامه خروجی تحلیل را در قالب‌های مختلف ارائه می‌دهد:\n\u003c/div\u003e\n\n## Sample Output\nThe program provides analysis output in various formats:\n\n```json\n{\n  \"address\": \"0x123...\",\n  \"blockchain\": \"ethereum\",\n  \"risk_score\": 75.5,\n  \"fraud_probability\": 0.85,\n  \"suspicious\": true,\n  \"analysis_details\": {\n    \"risk_factors\": [\n      \"High-value transactions: 15%\",\n      \"Rapid transactions: 25%\",\n      \"Suspicious connections: 3\"\n    ],\n    \"statistics\": {\n      \"total_transactions\": 150,\n      \"total_volume\": 1250.45,\n      \"unique_counterparties\": 45\n    }\n  }\n}\n```\n\n\u003cdiv dir=\"rtl\"\u003e\n\n## آموزش الگوریتم یادگیری ماشین\nبرای بهبود دقت تشخیص تراکنش‌های مشکوک، می‌توانید الگوریتم یادگیری ماشین را با داده‌های خود آموزش دهید:\n\n### نیازمندی‌های داده آموزشی\n- فایل CSV حاوی تراکنش‌های برچسب‌گذاری شده\n- هر تراکنش باید شامل: آدرس کیف پول، زمان، مقدار و برچسب (مشکوک/عادی) باشد\n- حداقل 1000 تراکنش برای آموزش مؤثر توصیه می‌شود\n\n### مراحل آموزش مدل\n1. آماده‌سازی داده‌ها:\n   - داده‌ها را در فرمت CSV ذخیره کنید\n   - برچسب‌های مشکوک را با 1 و عادی را با 0 مشخص کنید\n   - داده‌ها را به دو بخش آموزش و آزمایش تقسیم کنید\n\n2. تنظیم پیکربندی:\n   - فایل `config/training_config.yaml` را ویرایش کنید\n   - پارامترهای مدل را تنظیم کنید\n   - نوع مدل را انتخاب کنید\n\n3. اجرای آموزش:\n   ```bash\n   python scripts/train_model.py --data data/transactions.csv --output models/\n   ```\n\n4. ارزیابی مدل:\n   - گزارش عملکرد را بررسی کنید\n   - مدل را در صورت نیاز بهینه‌سازی کنید\n\u003c/div\u003e\n\n## Training the Machine Learning Algorithm\nTo improve the accuracy of suspicious transaction detection, you can train the ML algorithm with your own data:\n\n### Training Data Requirements\n- CSV file containing labeled transactions\n- Each transaction must include: wallet address, timestamp, amount, and label (suspicious/normal)\n- Minimum of 1000 transactions recommended for effective training\n\n### Training Process\n1. Data Preparation:\n   - Save data in CSV format\n   - Mark suspicious transactions with 1, normal with 0\n   - Split data into training and test sets\n\n2. Configuration Setup:\n   - Edit `config/training_config.yaml`\n   - Configure model parameters\n   - Select model type\n\n3. Run Training:\n   ```bash\n   python scripts/train_model.py --data data/transactions.csv --output models/\n   ```\n\n4. Model Evaluation:\n   - Review performance report\n   - Optimize model if needed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv74all%2Fchainwatch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fv74all%2Fchainwatch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fv74all%2Fchainwatch/lists"}