BridgeTrace-AI

Graph-native traceability for financial flows

Multi-hop tracing · Risk propagation · GenAI compliance narratives · Interactive graph UI

Quick Start · Command Center · API · Architecture

All data is synthetic. No real banking or blockchain connections.

---

Overview

BridgeTrace-AI traces money movement across banking (PIX), blockchain, and traditional rails — with explainable risk scoring and natural-language compliance reports.

Built for teams that need honest synthetic boundaries and production-shaped APIs, not mockups that vanish when the demo ends.

Surface	Purpose
Trace Command Center	Tier-0 dashboard · live graph · cascade replay
OpenAPI	/api/v2 trace, risk, AI explain, demo endpoints
Python SDK	BridgeTraceSDK for integration tests and pipelines
CLI	scripts/bt_cli.py for operator workflows

---

Tier-0 Command Center

Fortune 500–grade UI with live API integration and deterministic demo fallback.

Mode	Access
Live	http://localhost:8000/dashboard after docker compose up -d
Static	Labs demo · docs/index.html

Features: force-directed risk graph, multi-hop trace controls, transaction timeline, animated cascade replay, AI compliance narrative.

---

Quick Start

git clone https://github.com/felipeofdev-ai/BridgeTrace-AI.git
cd BridgeTrace-AI
docker compose up -d
curl http://localhost:8000/api/v2/health

Open the dashboard: http://localhost:8000/dashboard

curl -X POST http://localhost:8000/api/v2/trace/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dev-key-1" \
  -H "X-Tenant-ID: demo" \
  -d '{"source_id": "bank_001", "max_hops": 5, "min_amount": 0}'

Run tests:

pip install -r requirements-dev.txt
pytest
# or: .\scripts\run_all_tests.ps1

---

API

Full spec at http://localhost:8000/api/v2/docs.

Endpoint	Description
GET /api/v2/health	Liveness and version
POST /api/v2/trace/	Multi-hop BFS trace with hops_reached
POST /api/v2/risk/analyze	Behavioral risk scoring
POST /api/v2/ai/explain	Compliance narrative (simulated or LLM-ready)
GET /api/v2/demo/graph	Interactive demo graph
GET /api/v2/demo/replay	Risk cascade replay steps

Protected routes require X-API-Key and X-Tenant-ID. Default dev key: dev-key-1.

---

Architecture

FastAPI (:8000)
├── TraceService      → BFS multi-hop graph traversal
├── RiskService       → Propagation + time filters
├── AIService         → Simulated / LLM-ready narratives
└── InMemoryGraph     → Synthetic bank → PIX → crypto → mixer graph

Stack: Python · FastAPI · NetworkX · Prometheus · Docker · PostgreSQL & Redis (compose-ready)

---

Why BridgeTrace

Typical fin-risk demo	BridgeTrace-AI
Static screenshots	Runnable graph + replay
Single-hop lookup	Configurable multi-hop BFS
Black-box “AI”	Explain endpoint with trace context
Hidden data limits	Explicit synthetic-data boundary

---

Constellation

Project	Demo
CardOpsAI	lab
BridgeTrace-AI	lab
Meridian	lab

Portfolio: felipeofdev-ai.github.io · Author: Felipe Fernandes