How shriya345/vasp-investigator works
Tracepoint is a local investigator dashboard for tracing supplied or synthetic blockchain evidence to evidence-supported VASP candidates—not identifying wallet owners. The workflow is: an investigator starts a demo or imports normalized evidence, the API validates it, obtains demo evidence when requested, analyzes fund flows and risk, then saves a case for dashboard review and report/evidence export. The README also documents interactive graph filtering, candidate-path highlighting, metrics, and case history. Some frontend request wiring and internal analysis stages were not shown, so those relationships are omitted or marked unverified.
Main entry points: main.py Investigation API · engine.py Fund-flow tracing · page.tsx Investigation dashboard · models.py Evidence validation
Components 14
Investigation dashboard
- Investigation dashboard
frontend/app/page.tsx - Interactive flow graph
frontend/components/FlowGraph.tsx - Dashboard data types
frontend/lib/types.ts
Evidence and API
- Investigation API
backend/app/main.py - Evidence validation
backend/app/models.py - Synthetic evidence provider
backend/app/providers.py
Tracing and assessment
- Fund-flow tracing
backend/app/engine.py - VASP attribution
backend/app/engine.py - Risk and metrics
backend/app/engine.py
Case records and outputs
- Case persistence
backend/app/storage.py - SQLite or PostgreSQL
- Markdown report
backend/app/report.py
Other components
- Investigator
- Imported evidence
Connections 15
- Investigator → Investigation dashboard: starts investigation
README.md - Investigation dashboard → Interactive flow graph: renders graph
frontend/app/page.tsx - Investigation dashboard → Investigation API: submits and retrieves cases
- Imported evidence → Investigation API: supplies evidence
README.md - Investigation API → Evidence validation: validates requests
backend/app/main.py - Investigation API → Synthetic evidence provider: fetches demo evidence
backend/app/main.py - Synthetic evidence provider → Evidence validation: builds normalized records
backend/app/providers.py - Investigation API → Fund-flow tracing: runs analysis
backend/app/main.py - Fund-flow tracing → Evidence validation: consumes request schema
backend/app/engine.py - Investigation API → Case persistence: saves cases
backend/app/main.py - Case persistence → SQLite or PostgreSQL: reads and writes
backend/app/storage.py - Investigation API → Markdown report: renders report
backend/app/main.py - Fund-flow tracing → VASP attribution: scores candidates
README.md - Fund-flow tracing → Risk and metrics: computes risk and metrics
README.md - Investigation API → Investigation dashboard: returns case results