How gokulakrishnan610/vasp works
SAHYOG is a blockchain-forensics and VASP-attribution platform for law-enforcement investigations. Investigators submit a suspect wallet through the dashboard; the backend traces fund flows, identifies candidate VASPs, scores AML risk and evidence, and persists case results. Investigators can inspect the graph and evidence, generate statutory documents, and dispatch a VASP notice through SAHYOG. The README documents crawler failover and threat-intelligence integrations; their detailed wiring is not shown in the sampled source, so those links are represented only where the documented workflow supports them.
Main entry points: investigation.py Investigation Route · main.py FastAPI Application · App.jsx Application Router · Dashboard.jsx Investigation Dashboard
Components 26
Investigation UI
- Application Router
frontend/src/App.jsx - Investigation Dashboard
frontend/src/pages/Dashboard.jsx - Fund-Flow Explorer
frontend/src/components/FundFlowGraph.jsx - Case Management
frontend/src/pages/CaseManagement.jsx - Entity Intelligence
frontend/src/pages/EntityIntelligence.jsx - Alerts
frontend/src/pages/Alerts.jsx - Model Analytics
frontend/src/pages/ModelAnalytics.jsx - SAHYOG Integration
frontend/src/pages/SAHYOGIntegration.jsx
API and Cases
- FastAPI Application
backend/main.py - Investigation Route
backend/routes/investigation.py - Entity Routes
backend/routes/entities.py - Alert Routes
backend/routes/alerts.py - SAHYOG Routes
backend/routes/sahyog.py
Forensic Analysis
- Multi-Chain Crawler
backend/services/blockchain_fetcher.py - Entity Resolver
backend/services/entity_resolver.py - GNN and AML Inference
backend/services/gnn_inference.py - Path Scoring
backend/services/path_scorer.py - Evidence Fusion
backend/services/evidence_fusion.py - Evidence Generation
backend/services/evidence_generator.py
Intelligence and Dispatch
- Threat Intelligence
backend/services/threat_intelligence_scraper.py - Notice Dispatch Adapter
backend/services/sahyog_service.py
Persistence
- Case Database
backend/database.py - Graph Database
backend/neo4j_driver.py
Other components
- Investigator
- Blockchain and Intel Sources
- SAHYOG I4C Endpoint
Connections 31
- Investigator → Application Router: uses
- Application Router → Investigation Dashboard: routes to
- Application Router → Case Management: routes to
- Application Router → Entity Intelligence: routes to
- Application Router → Alerts: routes to
- Application Router → Model Analytics: routes to
- Application Router → SAHYOG Integration: routes to
- Investigation Dashboard → FastAPI Application: requests investigation
- Investigation Dashboard → Fund-Flow Explorer: renders graph
- Case Management → FastAPI Application: requests cases
- Entity Intelligence → FastAPI Application: requests entities
- Alerts → FastAPI Application: requests alerts
- Model Analytics → FastAPI Application: requests analytics
- SAHYOG Integration → FastAPI Application: submits notice
- FastAPI Application → Investigation Route: dispatches route
- FastAPI Application → Entity Routes: dispatches route
- FastAPI Application → Alert Routes: dispatches route
- FastAPI Application → SAHYOG Routes: dispatches route
- Investigation Route → Multi-Chain Crawler: fetches fund flows
- Multi-Chain Crawler → Blockchain and Intel Sources: queries chains
- Investigation Route → Entity Resolver: resolves entities
- Investigation Route → GNN and AML Inference: scores risk
- Investigation Route → Path Scoring: scores paths
- Investigation Route → Evidence Fusion: fuses evidence
- Investigation Route → Threat Intelligence: screens threats
- Investigation Route → Graph Database: queries graph
- Investigation Route → Case Database: stores cases
- Investigation Route → Evidence Generation: generates documents
- SAHYOG Routes → Notice Dispatch Adapter: builds and dispatches
- Notice Dispatch Adapter → SAHYOG I4C Endpoint: sends notice
- Threat Intelligence → Blockchain and Intel Sources: queries intelligence