Skip to content

Ganateju/Consensus-Mesh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

24 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Consensus Mesh πŸ“‘

Zero-Trust Environmental Consensus Architecture

License: MIT Flutter Node.js MongoDB


Consensus Mesh is a high-security presence verification ecosystem designed to eliminate proxy attendance through environmental consensus.

Instead of verifying credentials, Consensus Mesh verifies shared physical reality by combining RF fingerprinting, indoor triangulation, temporal synchronization, and human liveness validation.

If two devices are not observing the same environment, at the same moment, under the same physical conditions, they are not considered part of the mesh.


πŸ“– Documentation


Status

Current State: Functional MVP

Deployment: APK Released

Validation Phase: Campus Pilot Deployment

Current Focus

  • Environmental Consensus
  • Dynamic Indoor Triangulation
  • Cluster Detection
  • Proxy Resistance Validation
  • Real-World Deployment Analysis

🌟 Core Innovation: Environmental Consensus Mesh

Consensus Mesh establishes trust through four independent dimensions of evidence.

Spatial Consensus

Environmental similarity analysis through RF fingerprinting and indoor triangulation.

Temporal Consensus

Universal synchronized challenge windows ensure simultaneous participation.

Human Liveness

Cognitive response mechanisms combined with inertial verification.

Distributed Peer Verification

Cross-device comparison identifies anomalous clusters and coordinated proxy behavior.

Together these mechanisms create an environmental proof of presence that is substantially harder to spoof than traditional credential-based attendance systems.


πŸ›‘οΈ Security Analysis

Attack Vector Consensus Mesh Defense
Remote Proxy Environment mismatch detection using signal-set divergence
Bag-Drop / Ghosting Accelerometer variance analysis
Piano Attack Pulse-Sync challenge distribution
Wall-Guard Bypass Euclidean displacement shielding
Signal Cloning Distributed peer verification
Proxy Clusters Multi-anchor environmental consensus

πŸ”„ System Workflow

1. Scheduling

Admin provisions classroom schedules through the control center.

2. Anchoring

Teacher initializes a session and establishes environmental boundaries.

3. Synchronization

Student devices align to the global pulse clock.

4. Validation

Server computes similarity metrics and displacement values.

5. Challenge Distribution

Liveness challenges are broadcast simultaneously to all participants.

6. Consensus Formation

Environmental evidence is aggregated and evaluated.

7. Audit & Finalization

Potential anomalies are reviewed prior to attendance finalization.


πŸ“ˆ Mathematical Foundations

Consensus Mesh currently utilizes two primary proximity models.

Cosine Similarity

Measures environmental fingerprint similarity.

$$Similarity = \frac{ \sum (S_v \cdot T_v) }{ \sqrt{\sum S_v^2} \cdot \sqrt{\sum T_v^2} }$$

Euclidean Displacement

Measures radial deviation within the presence bubble.

$$d= \sqrt{ \frac{ \sum_{i=1}^{n} (T_i-S_i)^2 }{n} }$$

πŸ–₯️ Control & Audit Layer

Consensus Mesh includes a reactive administrative dashboard featuring:

  • Live Mesh Monitor
  • Dynamic Classroom Mapping
  • Weekly Scheduling Engine
  • Audit Trails
  • Session Reconciliation
  • Attendance Override System
  • Historical Analytics
  • Real-Time Status Monitoring

πŸ› οΈ Technology Stack

Domain Stack
Frontend / Mobile Flutter, Provider, Sensors Plus, WiFi Scan
Backend Node.js, Express.js
Cloud Hosting Render
Database MongoDB Atlas
Authentication JWT, HMAC-SHA256, Bcrypt
Signal Processing RF Fingerprinting, Cosine Similarity
Localization Indoor Triangulation, Euclidean Displacement
Verification Environmental Consensus, Liveness Validation

Engineering Domains

  • Systems Engineering
  • Signal Processing
  • Distributed Verification
  • Sensor Fusion
  • Indoor Localization
  • Security Engineering
  • Backend Architecture
  • Mobile Systems
  • Consensus Algorithms
  • Presence Verification

Developed by Ganateju
Securing identity through environmental consensus.