Consensus Mesh 📡

Zero-Trust Hybrid Proximity & Identity Verification

Consensus Mesh is a high-security attendance and identity verification ecosystem designed to eliminate "Proxy Attendance." It creates a mathematical consensus of the ambient RF (Radio Frequency) environment between a Teacher and a Student. If you aren't breathing the same air and seeing the same signals at the exact same millisecond, you aren't in the mesh.

📖 Documentation

• 🚀 Project Overview - The "Why" and "What"
• 🏗️ Technical Specifications - The "How" and "Math"

---

🌟 Core Innovation: The "Zero-Trust Quad-Lock"

Consensus Mesh enforces four simultaneous proofs of presence to ensure 100% integrity:

1. Spatial Consensus (N-Dimensional Mapping): The server compares the WiFi "landscape" (SSIDs and RSSI) using Cosine Similarity. Unlike GPS, WiFi signals cannot be easily mocked via software and vary per meter of distance.

2. Pulse-Sync Temporal Logic: Heartbeats are synchronized to a Universal 10-second Clock Pulse. Challenges hit every phone in the room at the same millisecond, making it physically impossible for one person to handle multiple devices during a check.

3. Human Liveness (Cognitive Challenge):

   • Smallest Number Scan: Students must identify and tap the smallest number among random choices within 3 seconds.
   • Inertial Audit: Uses Accelerometer Variance to ensure the device is in a human hand, flagging devices sitting static in bags or emulators.

4. Anti-Cluster Detection (Peer-to-Peer Audit): The server performs a cross-comparison between all students. If devices report identical signal fingerprints and motion patterns, they are flagged as a Proxy Cluster.

---

🛡️ Security Analysis (Defense Mechanisms)

Attack Vector	Consensus Mesh Defense
Remote Proxy	Environment Mismatch: Fails if the student's signal "Set Difference" > 70% from Teacher.
Bag-Drop / Ghosting	Motion Audit: Accelerometer analysis flags devices with static variance (<0.01).
The "Piano" Attack	Pulse-Sync: One person cannot solve 5 cognitive challenges appearing simultaneously on 5 screens.
Wall-Guard™ Bypass	Spherical Shield: Uses Euclidean Displacement ($d$) to detect signals leaking through walls.

---

🔄 System Workflow

1. Scheduling: Admin pushes class schedule to MongoDB via the Admin Terminal.
2. Anchoring: Teacher initializes the session, setting the Radial Displacement Limit for that specific room.
3. Synchronized Pulse: Student apps align their heartbeats to the server's global clock mark (:00, :10, :20...).
4. Validation: Server performs Cosine Similarity and Euclidean Displacement Math on the signal vectors.
5. Simultaneous Challenge: Teacher pushes a liveness flag; every student must pass the "Smallest Number" scan instantly.
6. Audit & Finalize: Teacher reviews flagged "Proxy Clusters" before exporting the cryptographically signed CSV.

---

📈 Mathematics of Proximity

The system utilizes two primary mathematical models to define the "Presence Bubble":

1. Cosine Similarity (Pattern Matching): $$Similarity = \frac{\sum (S_v \cdot T_v)}{\sqrt{\sum S_v^2} \cdot \sqrt{\sum T_v^2}}$$

2. Euclidean Displacement (Radial Shielding): $$d = \sqrt{\frac{\sum_{i=1}^{n} (T_i - S_i)^2}{n}}$$

---

🖥️ Admin Dashboard

Includes a Reactive Control Center:

• Live Mesh Monitor: Real-time visualization of active classes and student "Links."
• Master Scheduler: Integrated IST-synced management for weekly time-slots.
• Class-Specific Audit Logs: Advanced search and filtering for historical attendance reports.
• Reactive UI: Instant loading states (spinners) for all database interactions to ensure consistency.

---

🛠️ Tech Stack

• Mobile App: Flutter (Provider, Sensors_Plus, Wifi_Scan)
• Backend: Node.js, Express.js (Hosted on Render)
• Database: MongoDB Atlas (NoSQL)
• Authentication: JWT (HMAC-SHA256) & Bcrypt Password Hashing

---

Developed with ❤️ by Ganateju Securing identity through environmental consensus.