How maliniaids-stack/quantum-threat-detector works
This is an academic, quantum-simulated digital-signature threat-detection prototype, not a physical quantum system. The main workflow is a user-selected scenario in the Streamlit console, sent to the FastAPI backend, where QDSSystem creates and distributes keys, signs or simulates an attack, verifies quantum measurements, classifies the result, and records an audit event; the result returns to the console. Separate API capabilities expose history, thresholds, detection curves, and a toy Shor demonstration. The graph follows README capabilities and sampled call sites; unsampled frontend/API wiring is shown only where documented.
Main entry points: service.py QDS Coordinator · main.py REST API · protocol.py QDS Protocol · measure.py State Measurement
Components 17
User Interfaces
- Monitoring Console
frontend/app.py - REST API
backend/main.py
Signature Protocol
- QDS Coordinator
qds/service.py - QDS Protocol
qds/protocol.py
Quantum Simulation
- State Measurement
quantum/measure.py - Pauli States
quantum/paulis.py - Bell Channel Test
quantum/bell.py - Teleportation Demo
quantum/teleport.py - Shor Toy Demo
quantum/shor_toy.py
Threat Detection
- Decision Thresholds
detection/thresholds.py - Mismatch Statistics
detection/statistics.py - Threat Classifier
detection/classifier.py - Replay Guard
detection/replay.py - Audit Ledger
detection/audit.py
Attack Simulation
- Attack Scenarios
attacks/simulate.py
Other components
- Operator
- SQLite Event Store
Connections 24
- Operator → Monitoring Console: selects scenario
- Monitoring Console → REST API: requests API
- REST API → QDS Coordinator: runs scenario
- REST API → Audit Ledger: reads history
- REST API → Decision Thresholds: computes thresholds
- REST API → Shor Toy Demo: runs demo
- QDS Coordinator → QDS Protocol: generates and verifies
- QDS Coordinator → Attack Scenarios: creates forged signatures
- QDS Coordinator → Replay Guard: checks freshness
- QDS Coordinator → Mismatch Statistics: analyses mismatches
- QDS Coordinator → Decision Thresholds: decides verdict
- QDS Coordinator → Threat Classifier: classifies context
- QDS Coordinator → Audit Ledger: appends result
- QDS Protocol → State Measurement: prepares and measures
- QDS Protocol → Bell Channel Test: tests channel
- QDS Protocol → Decision Thresholds: gets QBER limit
- State Measurement → Pauli States: uses eigenstates
- Bell Channel Test → State Measurement: simulates measurements
- Bell Channel Test → Pauli States: uses eigenstates
- Attack Scenarios → QDS Protocol: generates attacker key
- Attack Scenarios → State Measurement: measures key copy
- Audit Ledger → SQLite Event Store: reads and writes events
- QDS Coordinator → Monitoring Console: returns result
- Teleportation Demo → State Measurement: demonstrates measurement model