How krish-legend13/sentra works
SENTRA is a secure messaging system with Ed25519 identity, challenge-response authentication, optional TOTP, mTLS transport, signed envelopes, and client-side end-to-end encryption. The principal workflow is a user starting a client, authenticating to the server, then exchanging encrypted messages that the server routes without seeing plaintext. The graph also preserves identity vaults, registration, offline delivery, sessions, and security monitoring. Edges reflect the sampled excerpts, SOURCE INDEX references, or explicit source documentation; unsampled subsystems are included where the tree and index establish them, without guessing their internal calls.
Main entry points: server.py Messaging server · client.py Messaging client · manager.py Identity manager · main.py Application flow
Components 20
Application entry
- Application flow
main.py
Messaging transport
- Messaging client
network/client.py - Messaging server
network/server.py - Packet framing
network/framing.py - TLS configuration
network/tls_config.py - Offline queue
network/offline_queue.py - Session tracking
network/sessions.py
Identity and authentication
- Identity manager
identity/manager.py - Identity registry
auth/registry.py - Challenge authentication
auth/challenge.py - TOTP verification
auth/totp.py - Account recovery
auth/recovery.py
Cryptography and signing
- Key vault
crypto/vault.py - Key management
crypto/keys.py - Ed25519 signatures
crypto/signatures.py - Payload encryption
crypto/encryption.py - Signed envelopes
signing/envelope.py
Security operations
- Incident detection
network/incident_detection.py - Security event log
network/security_events.py
Other components
- User
Connections 29
- User → Application flow: starts
main.py - Application flow → Identity manager: loads identity
main.py - Application flow → Messaging client: starts client
main.py - Application flow → Messaging server: starts server
main.py - Messaging client → Messaging server: exchanges packets
network/client.py - Messaging client → Identity manager: uses identity
network/client.py - Messaging client → Packet framing: frames packets
network/client.py - Messaging client → TLS configuration: configures TLS
network/client.py - Messaging client → Challenge authentication: signs challenge
network/client.py - Messaging client → Payload encryption: encrypts payload
network/client.py - Messaging client → Signed envelopes: creates envelope
network/client.py - Messaging server → Packet framing: reads packets
network/server.py - Messaging server → TLS configuration: configures TLS
network/server.py - Messaging server → Identity registry: registers identities
network/server.py - Messaging server → Challenge authentication: verifies challenge
network/server.py - Messaging server → TOTP verification: verifies TOTP
network/server.py - Messaging server → Offline queue: queues delivery
network/server.py - Messaging server → Session tracking: tracks sessions
network/server.py - Messaging server → Incident detection: checks activity
network/server.py - Messaging server → Security event log: logs events
network/server.py - Identity manager → Key management: loads keys
identity/manager.py - Identity manager → Key vault: protects private key
identity/manager.py - Identity manager → Payload encryption: decrypts payload
identity/manager.py - Identity manager → Ed25519 signatures: signs data
identity/manager.py - Identity registry → Key management: uses key utilities
auth/registry.py - Challenge authentication → Ed25519 signatures: uses Ed25519
auth/challenge.py - Payload encryption → Ed25519 signatures: uses canonical bytes
crypto/encryption.py - Signed envelopes → Ed25519 signatures: signs fields
signing/envelope.py - Incident detection → Security event log: reports detections
network/incident_detection.py