Architecture

Service Overview

• FastAPI backend exposes wallet analysis and risk retrieval endpoints.
• Scoring engine supports mock mode and live RPC mode with failover.
• Persistence is selected via dependency injection based on environment settings.
• Readiness and metrics endpoints are first-class for operations and monitoring.

Key Routes

• POST /wallet/analyze computes risk and records latest snapshot.
• GET /wallet/{address}/risk returns latest known risk state.
• GET /readyz reports readiness with provider-aware semantics.

Repository Documentation

For detailed diagrams and operational notes, open the architecture markdown in GitHub.