How sheikhrehanseo/valiguard-project-main works
ValiGuard AI is a QIE validator security dashboard. Its main workflow connects a wallet in the Next.js UI, authenticates through Flask, and presents monitoring and cross-chain risk information. Separately, the ingestion worker polls QIE, normalizes and scores transactions, and persists monitoring data for the API. Validator setup and node management are additional product capabilities. The README documents analytics and live feeds; sampled source gives only partial visibility into their routes and frontend data flow, so those links are conservative.
Main entry points: app.py Flask API · worker.py Transaction ingestion · routes.py Wallet auth routes · anomaly_model.py Anomaly scoring
Components 20
Dashboard
- Wallet connect
frontend/src/components/WalletConnect.js - Monitoring dashboard
frontend/src/app/page.js - API client
frontend/src/lib/api.js
API and auth
- Flask API
backend/app.py - Wallet auth routes
backend/auth/routes.py - Nonce store
backend/auth/nonce_store.py - JWT auth
backend/auth/jwt_auth.py
Monitoring pipeline
- Transaction ingestion
backend/ingestion/worker.py - QIE node manager
backend/qie_node_manager.py - Anomaly scoring
backend/ml/anomaly_model.py - Feature extraction
backend/ml/feature_extraction.py - Severity classification
backend/core/severity.py
Persistence
- Database operations
backend/database/db.py - Monitoring data models
backend/database/models.py
Validator operations
- Node setup
backend/qie_setup_manager.py - Validator management
backend/qie_validator_manager.py - Validator wallet
backend/qie_wallet_manager.py
Other components
- Dashboard user
- QIE network
- QIE validator operator
Connections 21
- Dashboard user → Monitoring dashboard: uses
- Monitoring dashboard → Wallet connect: renders
frontend/src/app/page.js - Monitoring dashboard → API client: calls
frontend/src/app/page.js - Wallet connect → API client: authenticates via
frontend/src/components/WalletConnect.js - API client → Wallet auth routes: requests nonce and verifies
frontend/src/lib/api.js - Wallet auth routes → Nonce store: issues and consumes
backend/auth/routes.py - Wallet auth routes → JWT auth: issues token
backend/auth/routes.py - Flask API → Wallet auth routes: registers
backend/app.py - Flask API → QIE node manager: queries node
backend/app.py - Flask API → Anomaly scoring: scores requests
backend/app.py - Flask API → Transaction ingestion: starts monitoring
backend/app.py - Transaction ingestion → QIE node manager: polls
backend/ingestion/worker.py - Transaction ingestion → Anomaly scoring: scores transactions
backend/ingestion/worker.py - Anomaly scoring → Feature extraction: extracts features
backend/ml/anomaly_model.py - Anomaly scoring → Severity classification: classifies risk
backend/ml/anomaly_model.py - Transaction ingestion → Database operations: persists transactions
backend/ingestion/worker.py - Database operations → Monitoring data models: manages records
backend/database/db.py - QIE node manager → QIE network: queries and broadcasts
backend/qie_node_manager.py - QIE validator operator → Node setup: sets up node
- QIE validator operator → Validator management: registers validator
- Validator management → Validator wallet: uses wallet operations