# gsmoura033/chat-p2p architecture

> Architecture diagram of the GitHub repository gsmoura033/chat-p2p, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gsmoura033/chat-p2p
- Repository: https://github.com/gsmoura033/chat-p2p

## Overview

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: [`p2p-secure/src/network/node.js`](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/node.js) (Network daemon), [`p2p-secure/src/crypto/session-manager.js`](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/session-manager.js) (Session manager), [`p2p-secure/src/persistence/deletion.js`](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/deletion.js) (Secure deletion), [`p2p-secure/src/ui/main.js`](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/ui/main.js) (Electron app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_electron["Electron app<br/>[main.js]"]
  node_renderer["Chat interface<br/>[renderer.js]"]
end

subgraph group_network["P2P networking"]
  node_daemon["Network daemon<br/>[node.js]"]
  node_libp2p["libp2p transport<br/>[libp2p-factory.js]"]
  node_peers["Peer manager<br/>[peer-manager.js]"]
  node_chatproto["Chat protocol<br/>[chat-protocol.js]"]
  node_handshake["X3DH handshake"]
end

subgraph group_crypto["Identity and cryptography"]
  node_keygen["Identity keygen<br/>[keygen.js]"]
  node_fingerprint["Peer fingerprint<br/>[fingerprint.js]"]
  node_sessions["Session manager<br/>[session-manager.js]"]
  node_x3dh["X3DH<br/>[x3dh.js]"]
  node_ratchet["Double Ratchet<br/>[session.js]"]
  node_rng["Secure RNG<br/>[rng.js]"]
  node_memory["Key zeroization<br/>[memory.js]"]
end

subgraph group_storage["Local persistence"]
  node_identity_store[("Identity store<br/>[identity-store.js]")]
  node_chat_store[("Chat history<br/>[chat-store.js]")]
  node_contacts[("Contact store<br/>[contact-store.js]")]
  node_deletion["Secure deletion<br/>[deletion.js]"]
  node_journal[("Recovery journal<br/>[journal.js]")]
  node_recovery["Persistence recovery<br/>[recovery.js]"]
end

subgraph group_privacy["Traffic privacy"]
  node_onion_cells["Fixed-size cells<br/>[cells.js]"]
  node_onion_encrypt["Onion encryption<br/>[encrypt.js]"]
  node_shaper["Traffic shaping<br/>[shaper.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_renderer
node_renderer -->|"IPC via"| node_electron
node_electron -->|"IPC controls"| node_daemon
node_daemon -->|"creates node"| node_libp2p
node_daemon -->|"registers and sends"| node_chatproto
node_daemon -->|"registers"| node_handshake
node_daemon -->|"tracks connections"| node_peers
node_daemon -->|"manages sessions"| node_sessions
node_daemon -->|"generates identity"| node_keygen
node_daemon -->|"computes fingerprint"| node_fingerprint
node_daemon -->|"loads and saves"| node_identity_store
node_daemon -->|"reads and appends"| node_chat_store
node_daemon -->|"manages contacts"| node_contacts
node_daemon -->|"runs recovery"| node_recovery
node_daemon -->|"clears keys"| node_deletion
node_sessions -->|"derives shared secret"| node_x3dh
node_sessions -->|"creates sessions"| node_ratchet
node_identity_store -->|"stores file keys"| node_deletion
node_chat_store -->|"registers and destroys keys"| node_deletion
node_recovery -->|"uses journal"| node_journal

click node_electron "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/ui/main.js"
click node_renderer "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/ui/renderer.js"
click node_daemon "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/node.js"
click node_libp2p "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/libp2p-factory.js"
click node_peers "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/peer-manager.js"
click node_chatproto "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/chat-protocol.js"
click node_handshake "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/handshake-protocol.js"
click node_keygen "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/identity/keygen.js"
click node_fingerprint "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/identity/fingerprint.js"
click node_sessions "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/session-manager.js"
click node_x3dh "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/x3dh.js"
click node_ratchet "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/session.js"
click node_rng "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/rng.js"
click node_memory "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/memory.js"
click node_identity_store "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/identity-store.js"
click node_chat_store "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/chat-store.js"
click node_contacts "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/contact-store.js"
click node_deletion "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/deletion.js"
click node_journal "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/journal.js"
click node_recovery "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/recovery.js"
click node_onion_cells "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/onion/cells.js"
click node_onion_encrypt "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/onion/encrypt.js"
click node_shaper "https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/traffic/shaper.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_electron,node_renderer,node_user toneBlue
class node_daemon,node_libp2p,node_peers,node_chatproto,node_handshake toneAmber
class node_keygen,node_fingerprint,node_sessions,node_x3dh,node_ratchet,node_rng,node_memory toneMint
class node_identity_store,node_chat_store,node_contacts,node_deletion,node_journal,node_recovery toneRose
class node_onion_cells,node_onion_encrypt,node_shaper toneIndigo
```

## Components

### User interface

- [Electron app](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/ui/main.js): `p2p-secure/src/ui/main.js`
- [Chat interface](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/ui/renderer.js): `p2p-secure/src/ui/renderer.js`

### P2P networking

- [Network daemon](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/node.js): `p2p-secure/src/network/node.js`
- [libp2p transport](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/libp2p-factory.js): `p2p-secure/src/network/libp2p-factory.js`
- [Peer manager](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/peer-manager.js): `p2p-secure/src/network/peer-manager.js`
- [Chat protocol](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/chat-protocol.js): `p2p-secure/src/network/chat-protocol.js`
- [X3DH handshake](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/network/handshake-protocol.js): `p2p-secure/src/network/handshake-protocol.js`

### Identity and cryptography

- [Identity keygen](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/identity/keygen.js): `p2p-secure/src/identity/keygen.js`
- [Peer fingerprint](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/identity/fingerprint.js): `p2p-secure/src/identity/fingerprint.js`
- [Session manager](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/session-manager.js): `p2p-secure/src/crypto/session-manager.js`
- [X3DH](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/x3dh.js): `p2p-secure/src/crypto/x3dh.js`
- [Double Ratchet](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/session.js): `p2p-secure/src/crypto/session.js`
- [Secure RNG](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/rng.js): `p2p-secure/src/crypto/rng.js`
- [Key zeroization](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/crypto/memory.js): `p2p-secure/src/crypto/memory.js`

### Local persistence

- [Identity store](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/identity-store.js): `p2p-secure/src/persistence/identity-store.js`
- [Chat history](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/chat-store.js): `p2p-secure/src/persistence/chat-store.js`
- [Contact store](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/contact-store.js): `p2p-secure/src/persistence/contact-store.js`
- [Secure deletion](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/deletion.js): `p2p-secure/src/persistence/deletion.js`
- [Recovery journal](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/journal.js): `p2p-secure/src/persistence/journal.js`
- [Persistence recovery](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/persistence/recovery.js): `p2p-secure/src/persistence/recovery.js`

### Traffic privacy

- [Fixed-size cells](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/onion/cells.js): `p2p-secure/src/onion/cells.js`
- [Onion encryption](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/onion/encrypt.js): `p2p-secure/src/onion/encrypt.js`
- [Traffic shaping](https://github.com/gsmoura033/chat-p2p/blob/main/p2p-secure/src/traffic/shaper.js): `p2p-secure/src/traffic/shaper.js`

### Other components

- **User**

## Connections

- User → Chat interface: uses (evidence: `README.md`)
- Chat interface → Electron app: IPC via (evidence: `README.md`)
- Electron app → Network daemon: IPC controls (evidence: `README.md`)
- Network daemon → libp2p transport: creates node (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Chat protocol: registers and sends (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → X3DH handshake: registers (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Peer manager: tracks connections (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Session manager: manages sessions (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Identity keygen: generates identity (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Peer fingerprint: computes fingerprint (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Identity store: loads and saves (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Chat history: reads and appends (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Contact store: manages contacts (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Persistence recovery: runs recovery (evidence: `p2p-secure/src/network/node.js`)
- Network daemon → Secure deletion: clears keys (evidence: `p2p-secure/src/network/node.js`)
- Session manager → X3DH: derives shared secret (evidence: `p2p-secure/src/crypto/session-manager.js`)
- Session manager → Double Ratchet: creates sessions (evidence: `p2p-secure/src/crypto/session-manager.js`)
- Identity store → Secure deletion: stores file keys (evidence: `p2p-secure/src/persistence/identity-store.js`)
- Chat history → Secure deletion: registers and destroys keys (evidence: `p2p-secure/src/persistence/chat-store.js`)
- Persistence recovery → Recovery journal: uses journal (evidence: `p2p-secure/src/persistence/recovery.js`)
