How vicky4t/sih-183 works
SHADOWTRACE is a crypto-fraud investigation platform: an investigator submits a suspect wallet, the system traces related wallets and analyzes transactions for patterns, VASP links, clusters, and risk, then presents findings for investigation and reporting. The graph emphasizes this workflow and the documented dashboard, cases, alerts, and PDF reporting capabilities. Sampled source confirms the tracing and analysis internals and frontend calls; several API-to-service and persistence links are documented or suggested by module names but not visible in the excerpts, so those uncertain connections are omitted.
Main entry points: api.ts API Client · analysis_pipeline.py Analysis Pipeline · main.py FastAPI App · page.tsx Investigate
Components 23
Investigator UI
- Investigate
frontend/app/investigate/page.tsx - Cases Dashboard
frontend/app/cases/page.tsx - Overview Dashboard
frontend/app/dashboard/page.tsx - Reports
frontend/app/reports/page.tsx - API Client
frontend/app/lib/api.ts - Graph Builder
frontend/app/lib/graph.ts
Backend API
- FastAPI App
backend/app/main.py - Case Routes
backend/app/api/cases.py - Analysis Routes
backend/app/api/analysis.py - Report Routes
backend/app/api/reports.py
Intelligence Analysis
- Wallet Tracing
backend/app/services/tracing/trace_engine.py - Analysis Pipeline
backend/app/services/analysis_pipeline.py - Pattern Detection
backend/app/services/patterns - Wallet Clustering
backend/app/services/clustering/wallet_cluster.py - VASP Matching
backend/app/services/exchange_matcher.py - Nearest VASP
backend/app/services/nearest_vasp.py - Risk Scoring
backend/app/services/risk_scoring.py - Alert Generation
backend/app/services/alert_generator.py
Data and Integrations
- Etherscan API
backend/app/services/blockchain/etherscan.py - Case Database
backend/app/database.py - Case Model
backend/app/models/case.py - PDF Reports
backend/app/services/reporting/pdf_report.py
Other components
- Investigator
Connections 23
- Investigator → Investigate: submits wallet
- Investigator → Cases Dashboard: reviews cases
- Investigator → Overview Dashboard: views overview
- Investigator → Reports: requests reports
- Investigate → API Client: calls case and analysis APIs
- Cases Dashboard → API Client: loads cases
- Overview Dashboard → API Client: loads cases
- Reports → API Client: loads and analyzes cases
- Investigate → Graph Builder: builds display graph
- API Client → Case Routes: REST requests
- API Client → Analysis Routes: REST requests
- API Client → Report Routes: REST requests
- FastAPI App → Case Routes: registers router
- FastAPI App → Analysis Routes: registers router
- FastAPI App → Report Routes: registers router
- Wallet Tracing → Etherscan API: fetches transactions
- Analysis Pipeline → Pattern Detection: detects patterns
- Analysis Pipeline → VASP Matching: matches exchanges
- Analysis Pipeline → Nearest VASP: finds nearby VASPs
- Analysis Pipeline → Wallet Clustering: builds wallet cluster
- Analysis Pipeline → Risk Scoring: calculates risk
- Analysis Pipeline → Alert Generation: generates alert
- Report Routes → PDF Reports: generates reports