How dhruvvv-sh/is_proj works
CipherChat is an educational encrypted-messaging prototype with attack detection, privacy-preserving incident evidence, and bounded recovery. Its principal flow establishes peer sessions, sends and validates encrypted messages, then classifies protocol failures, records evidence, and either rekeys or blocks the session. A local teaching UI exposes message and attack demonstrations. The UI and simulator excerpts show orchestration; the graph omits uncertain frontend wiring and treats the prototype as local rather than a production transport.
Main entry points: session.py Session manager · main.py CLI demo · simulator.py Attack simulator · server.py Local UI server
Components 14
Demo entry points
- CLI demo
cipherchat/main.py - Local UI server
cipherchat/ui/server.py - Browser UI
cipherchat/ui/static
Identity and cryptography
- Peer identity
cipherchat/crypto/identity.py - X25519 exchange
cipherchat/crypto/key_exchange.py - HKDF derivation
cipherchat/crypto/kdf.py - AES-GCM
cipherchat/crypto/encryption.py
Messaging protocol
- Session manager
cipherchat/protocol/session.py - Message sessions
cipherchat/protocol/messages.py
Attack response
- Failure classification
cipherchat/security/attacks.py - Evidence chain
cipherchat/security/evidence.py - Recovery machine
cipherchat/security/recovery.py - Attack simulator
cipherchat/security/simulator.py
Other components
- Demo user
Connections 21
- Demo user → CLI demo: runs demo
README.md - Demo user → Local UI server: opens demo
README.md - Browser UI → Local UI server: sends requests
cipherchat/ui/server.py - CLI demo → Peer identity: creates peers
cipherchat/main.py - Peer identity → X25519 exchange: generates keys
cipherchat/crypto/identity.py - CLI demo → Session manager: establishes sessions
cipherchat/main.py - Session manager → Failure classification: checks pinned keys
cipherchat/protocol/session.py - Session manager → X25519 exchange: derives shared secret
cipherchat/protocol/session.py - Session manager → HKDF derivation: derives session key
cipherchat/protocol/session.py - Session manager → Message sessions: creates sessions
cipherchat/protocol/session.py - Message sessions → AES-GCM: encrypts and decrypts
cipherchat/protocol/messages.py - CLI demo → Failure classification: classifies failures
cipherchat/main.py - CLI demo → Evidence chain: records incidents
cipherchat/main.py - CLI demo → Recovery machine: drives recovery
cipherchat/main.py - Local UI server → Peer identity: creates demo peers
cipherchat/ui/server.py - Local UI server → Session manager: establishes sessions
cipherchat/ui/server.py - Local UI server → Attack simulator: runs attack scenarios
cipherchat/ui/server.py - Attack simulator → Session manager: establishes and rekeys
cipherchat/security/simulator.py - Attack simulator → Failure classification: classifies failures
cipherchat/security/simulator.py - Attack simulator → Evidence chain: records and verifies
cipherchat/security/simulator.py - Attack simulator → Recovery machine: drives recovery
cipherchat/security/simulator.py