How sajanibandara/final-year-project works
MOBIGUARD simulates attacks against a mobility-aware software-defined vehicular network, detects them with signature-based defenses, and exposes results through an analytics GUI. The main workflow is simulation → attack/detection events and metrics → GUI analysis; separate ML pipelines support detection research and an optional Fabric bridge records selected events on-chain. The README documents the simulation capabilities, while source excerpts show GUI service routing and bridge dispatch. Unsampled subsystem links are included only where the README supports them; other uncertain wiring is omitted.
Main entry points: routing.cc NS-3 Simulation · service.py Results Service · app.js Dashboard UI · parser.py CSV Parser
Components 26
Network Simulation
- NS-3 Simulation
scratch/routing.cc - Mobility Optimization
scratch/optimization.py - Attack Setup
scratch/attack_declaration.h - Metrics CSVs
scratch/routing.cc
Detection and Defense
- Time-Delay Attacks
scratch/selective_time_delay.h - TCAM Attacks
scratch/tcam_attack_helper.h - Forwarding Attacks
scratch/hf_attack_helper.h - Detection Signatures
scratch/s1_detection.h - Crypto Integrity
scratch/crypto_layer.h - Blockchain Simulation
scratch/bc_blockchain_helper.h
Results Dashboard
- Dashboard UI
gui/frontend/js/app.js - Attack Lab
gui/frontend/js/lab.js - GUI API
gui/backend/app.py - Results Service
gui/backend/service.py - Run Catalog
gui/backend/catalog.py - CSV Parser
gui/backend/parser.py - Metric Schema
gui/backend/schema.py - Snapshot Service
gui/backend/snapshot_service.py
Detection Research
- Federated LSTM
lstm_pipeline/src/fed_aggregator.py - LSTM Preprocessing
lstm_pipeline/src/preprocessor.py - SFTO Benchmark
sfto_pipeline/src/run_pipeline.py
Fabric Audit
- Fabric Bridge
blockchain/bridge/index.js - CSV Tailers
blockchain/bridge/tailers/trust.js - Fabric Client
blockchain/bridge/fabric-client.js
Other components
- Experimenter
- Hyperledger Fabric
Connections 26
- Experimenter → NS-3 Simulation: runs experiments
README.md - NS-3 Simulation → Mobility Optimization: uses route optimization
- NS-3 Simulation → Attack Setup: arms attacks
README.md - NS-3 Simulation → Time-Delay Attacks: simulates delays
README.md - NS-3 Simulation → TCAM Attacks: simulates TCAM attacks
README.md - NS-3 Simulation → Forwarding Attacks: simulates forwarding attacks
README.md - NS-3 Simulation → Detection Signatures: runs detection signatures
README.md - NS-3 Simulation → Crypto Integrity: applies integrity layer
README.md - NS-3 Simulation → Blockchain Simulation: records simulation events
README.md - NS-3 Simulation → Metrics CSVs: writes metrics
README.md - Experimenter → Dashboard UI: views results
gui/frontend/js/app.js - Dashboard UI → Attack Lab: initializes panel
gui/frontend/js/app.js - Dashboard UI → GUI API: uses API routes
- GUI API → Results Service: delegates requests
gui/backend/app.py - Results Service → Run Catalog: indexes runs
gui/backend/service.py - Results Service → CSV Parser: parses run files
gui/backend/service.py - CSV Parser → Metric Schema: validates layout
gui/backend/parser.py - Results Service → Snapshot Service: supports snapshot mode
gui/backend/snapshot_service.py - Metrics CSVs → Run Catalog: catalogs CSV files
gui/backend/catalog.py - Metrics CSVs → CSV Parser: decodes selected runs
- LSTM Preprocessing → Federated LSTM: prepares training data
lstm_pipeline/src/fed_aggregator.py - Experimenter → SFTO Benchmark: runs benchmark
sfto_pipeline/src/run_pipeline.py - Fabric Bridge → CSV Tailers: starts tailers
blockchain/bridge/index.js - Fabric Bridge → Fabric Client: registers network
blockchain/bridge/index.js - CSV Tailers → Fabric Client: submits and queries
blockchain/bridge/tailers/trust.js - Fabric Client → Hyperledger Fabric: invokes transactions
blockchain/bridge/fabric-client.js