How meding2904/chatorrent works
Chatorrent is a two-person encrypted P2P desktop chat. Users unlock a local vault, add a peer by ID/contact string, discover or dial that peer, establish an E2E session, then send messages with delivery status and queued retries. The graph preserves documented discovery, NAT traversal, verification, encrypted history, and UI capabilities. Edges are limited to relationships shown in excerpts, the source index, or README; unsampled subsystem internals are represented by their exact enclosing directories.
Main entry points: event_loop.rs Swarm event loop · backend.rs App backend · ui.rs Chat interface · handshake.rs X3DH handshake
Components 20
Desktop experience
- Desktop startup
crates/app/src/main.rs - Chat interface
crates/app/src/ui.rs - UI state
crates/app/src/model.rs - Themes
crates/app/src/theme.rs - App backend
crates/app/src/backend.rs
Identity and encryption
- Peer identity
crates/core/src/identity.rs - Contact strings
crates/core/src/contact.rs - X3DH handshake
crates/core/src/crypto/handshake.rs - Double Ratchet
crates/core/src/crypto/ratchet.rs - Wire messages
crates/core/src/wire.rs
Peer networking
- Swarm event loop
crates/net/src/event_loop.rs - Discovery and transport
crates/net/src/behaviour.rs - Chat stream codec
crates/net/src/codec.rs - DHT provider store
crates/net/src/store.rs - Peer CLI
crates/net/src/bin/chatorrent-cli.rs
Local history
- Encrypted SQLite vault
crates/storage/src/lib.rs - Vault cryptography
crates/storage/src/crypto.rs
Other components
- User
- Remote peer
- Configured relay
Connections 25
- User → Chat interface: uses
README.md - Desktop startup → App backend: starts
crates/app/src/main.rs - Desktop startup → Chat interface: opens
crates/app/src/main.rs - Chat interface → App backend: commands
crates/app/src/ui.rs - Chat interface → UI state: updates
crates/app/src/ui.rs - Chat interface → Themes: renders with
crates/app/src/theme.rs - App backend → Peer identity: creates identity
crates/app/src/backend.rs - App backend → Contact strings: parses contacts
crates/app/src/backend.rs - App backend → Encrypted SQLite vault: loads and saves
crates/app/src/backend.rs - App backend → Swarm event loop: starts and commands
crates/app/src/backend.rs - Swarm event loop → Discovery and transport: drives
crates/net/src/event_loop.rs - Discovery and transport → Chat stream codec: uses
crates/net/src/behaviour.rs - Discovery and transport → DHT provider store: uses
crates/net/src/behaviour.rs - Swarm event loop → DHT provider store: reads provider addresses
crates/net/src/store.rs - Swarm event loop → Remote peer: discovers and dials
README.md - Swarm event loop → Configured relay: requests relay fallback
README.md - Swarm event loop → X3DH handshake: establishes sessions
README.md - X3DH handshake → Peer identity: derives shared keys
crates/core/src/crypto/handshake.rs - X3DH handshake → Double Ratchet: initializes
crates/core/src/crypto/handshake.rs - Swarm event loop → Double Ratchet: seals and opens messages
README.md - Swarm event loop → Wire messages: exchanges frames
README.md - Swarm event loop → App backend: reports events
- App backend → Chat interface: updates interface
- Encrypted SQLite vault → Vault cryptography: encrypts values
crates/storage/src/lib.rs - Peer CLI → Swarm event loop: runs peer harness
README.md