How gsmoura033/chat-p2p works
P2P Secure Chat is an Electron client backed by an isolated Node.js daemon. The main workflow is a user sending a message through the UI: the daemon routes it to a connected peer over libp2p, with X3DH/Double Ratchet providing end-to-end encryption, and stores local chat history. The graph also preserves identity, contact, recovery, and in-development traffic-privacy capabilities. Relationships are limited to calls visible in excerpts or the source index and flows stated in the README; unsampled details are not assumed.
Main entry points: node.js Network daemon · session-manager.js Session manager · deletion.js Secure deletion · main.js Electron app
Components 24
User interface
- Electron app
p2p-secure/src/ui/main.js - Chat interface
p2p-secure/src/ui/renderer.js
P2P networking
- Network daemon
p2p-secure/src/network/node.js - libp2p transport
p2p-secure/src/network/libp2p-factory.js - Peer manager
p2p-secure/src/network/peer-manager.js - Chat protocol
p2p-secure/src/network/chat-protocol.js - X3DH handshake
p2p-secure/src/network/handshake-protocol.js
Identity and cryptography
- Identity keygen
p2p-secure/src/identity/keygen.js - Peer fingerprint
p2p-secure/src/identity/fingerprint.js - Session manager
p2p-secure/src/crypto/session-manager.js - X3DH
p2p-secure/src/crypto/x3dh.js - Double Ratchet
p2p-secure/src/crypto/session.js - Secure RNG
p2p-secure/src/crypto/rng.js - Key zeroization
p2p-secure/src/crypto/memory.js
Local persistence
- Identity store
p2p-secure/src/persistence/identity-store.js - Chat history
p2p-secure/src/persistence/chat-store.js - Contact store
p2p-secure/src/persistence/contact-store.js - Secure deletion
p2p-secure/src/persistence/deletion.js - Recovery journal
p2p-secure/src/persistence/journal.js - Persistence recovery
p2p-secure/src/persistence/recovery.js
Traffic privacy
- Fixed-size cells
p2p-secure/src/onion/cells.js - Onion encryption
p2p-secure/src/onion/encrypt.js - Traffic shaping
p2p-secure/src/traffic/shaper.js
Other components
- User
Connections 20
- User → Chat interface: uses
README.md - Chat interface → Electron app: IPC via
README.md - Electron app → Network daemon: IPC controls
README.md - Network daemon → libp2p transport: creates node
p2p-secure/src/network/node.js - Network daemon → Chat protocol: registers and sends
p2p-secure/src/network/node.js - Network daemon → X3DH handshake: registers
p2p-secure/src/network/node.js - Network daemon → Peer manager: tracks connections
p2p-secure/src/network/node.js - Network daemon → Session manager: manages sessions
p2p-secure/src/network/node.js - Network daemon → Identity keygen: generates identity
p2p-secure/src/network/node.js - Network daemon → Peer fingerprint: computes fingerprint
p2p-secure/src/network/node.js - Network daemon → Identity store: loads and saves
p2p-secure/src/network/node.js - Network daemon → Chat history: reads and appends
p2p-secure/src/network/node.js - Network daemon → Contact store: manages contacts
p2p-secure/src/network/node.js - Network daemon → Persistence recovery: runs recovery
p2p-secure/src/network/node.js - Network daemon → Secure deletion: clears keys
p2p-secure/src/network/node.js - Session manager → X3DH: derives shared secret
p2p-secure/src/crypto/session-manager.js - Session manager → Double Ratchet: creates sessions
p2p-secure/src/crypto/session-manager.js - Identity store → Secure deletion: stores file keys
p2p-secure/src/persistence/identity-store.js - Chat history → Secure deletion: registers and destroys keys
p2p-secure/src/persistence/chat-store.js - Persistence recovery → Recovery journal: uses journal
p2p-secure/src/persistence/recovery.js