# moral666/qt architecture

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

- Interactive diagram: https://gitdiagram.com/moral666/qt
- Repository: https://github.com/moral666/qt

## Overview

QT is a technical prototype for end-to-end encrypted messaging, not a finished chat product. A client establishes a session with X3DH or PQXDH, then protects messages with Double Ratchet and sealed-sender identity; the CLI demonstrates sending and receiving through a Noise-over-WebSocket relay, which queues opaque data. Local encrypted persistence and mobile-language bindings are additional capabilities. The graph reflects README-described workflows where client internals were not excerpted; those links are cited to the README, not presented as inspected call sites.

Main entry points: [`cli/src/bin/messenger.rs`](https://github.com/moral666/qt/blob/main/cli/src/bin/messenger.rs) (Terminal client), [`server/src/connection.rs`](https://github.com/moral666/qt/blob/main/server/src/connection.rs) (Client connection handler), [`core/src/x3dh.rs`](https://github.com/moral666/qt/blob/main/core/src/x3dh.rs) (X3DH sessions), [`core/src/ratchet.rs`](https://github.com/moral666/qt/blob/main/core/src/ratchet.rs) (Double Ratchet)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client interfaces"]
  node_cli["Terminal client<br/>[messenger.rs]"]
  node_demo["Conversation demo<br/>[messenger_demo.rs]"]
  node_wire["Pre-key wire format<br/>[wire_format.rs]"]
end

subgraph group_crypto["Cryptographic core"]
  node_x3dh["X3DH sessions<br/>[x3dh.rs]"]
  node_pqxdh["PQXDH sessions<br/>[pqxdh.rs]"]
  node_ratchet["Double Ratchet<br/>[ratchet.rs]"]
  node_sealed["Sealed Sender<br/>[sealed_sender.rs]"]
  node_primitives["Crypto primitives<br/>[primitives.rs]"]
end

subgraph group_network["Network and relay"]
  node_transport["Noise WebSocket<br/>[ws_transport.rs]"]
  node_noise["Noise sessions<br/>[noise_session.rs]"]
  node_server_entry["Relay server entry<br/>[relay_server.rs]"]
  node_connection["Client connection handler<br/>[connection.rs]"]
  node_protocol["Relay message protocol<br/>[protocol.rs]"]
  node_store["Relay queues and keys<br/>[store.rs]"]
end

subgraph group_integration["Persistence and bindings"]
  node_storage[("Encrypted local storage<br/>[lib.rs]")]
  node_ffi["Platform bindings<br/>[lib.rs]"]
end

node_person(("Messaging user"))
node_redis[("Redis")]
node_platforms["Kotlin, Swift, Python"]

node_person -->|"uses"| node_cli
node_cli -->|"establishes sessions"| node_x3dh
node_cli -->|"can establish"| node_pqxdh
node_x3dh -->|"initializes"| node_ratchet
node_pqxdh -.->|"initializes"| node_ratchet
node_ratchet -->|"uses"| node_primitives
node_x3dh -->|"uses"| node_primitives
node_pqxdh -->|"uses"| node_primitives
node_sealed -->|"uses"| node_primitives
node_cli -->|"seals sender identity"| node_sealed
node_cli -->|"encodes pre-key bundles"| node_wire
node_cli -->|"persists identity and conversations"| node_storage
node_cli -->|"connects over WebSocket"| node_transport
node_demo -->|"demonstrates messaging"| node_ratchet
node_demo -->|"demonstrates network layer"| node_transport
node_transport -->|"uses"| node_noise
node_server_entry -.->|"accepts connections"| node_connection
node_connection -->|"uses"| node_transport
node_connection -->|"decodes and encodes"| node_protocol
node_connection -->|"dispatches requests"| node_store
node_store -->|"reads and writes"| node_redis
node_ffi -->|"provides bindings"| node_platforms
node_platforms -->|"uses crypto core"| node_x3dh

click node_cli "https://github.com/moral666/qt/blob/main/cli/src/bin/messenger.rs"
click node_demo "https://github.com/moral666/qt/blob/main/cli/src/bin/messenger_demo.rs"
click node_wire "https://github.com/moral666/qt/blob/main/cli/src/wire_format.rs"
click node_x3dh "https://github.com/moral666/qt/blob/main/core/src/x3dh.rs"
click node_pqxdh "https://github.com/moral666/qt/blob/main/core/src/pqxdh.rs"
click node_ratchet "https://github.com/moral666/qt/blob/main/core/src/ratchet.rs"
click node_sealed "https://github.com/moral666/qt/blob/main/core/src/sealed_sender.rs"
click node_primitives "https://github.com/moral666/qt/blob/main/core/src/primitives.rs"
click node_transport "https://github.com/moral666/qt/blob/main/transport/src/ws_transport.rs"
click node_noise "https://github.com/moral666/qt/blob/main/transport/src/noise_session.rs"
click node_server_entry "https://github.com/moral666/qt/blob/main/server/src/bin/relay_server.rs"
click node_connection "https://github.com/moral666/qt/blob/main/server/src/connection.rs"
click node_protocol "https://github.com/moral666/qt/blob/main/server/src/protocol.rs"
click node_store "https://github.com/moral666/qt/blob/main/server/src/store.rs"
click node_storage "https://github.com/moral666/qt/blob/main/storage/src/lib.rs"
click node_ffi "https://github.com/moral666/qt/blob/main/ffi/src/lib.rs"

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_cli,node_demo,node_wire,node_person toneBlue
class node_x3dh,node_pqxdh,node_ratchet,node_sealed,node_primitives,node_redis toneAmber
class node_transport,node_noise,node_server_entry,node_connection,node_protocol,node_store toneMint
class node_storage,node_ffi toneRose
class node_platforms toneIndigo
```

## Components

### Client interfaces

- [Terminal client](https://github.com/moral666/qt/blob/main/cli/src/bin/messenger.rs): `cli/src/bin/messenger.rs`
- [Conversation demo](https://github.com/moral666/qt/blob/main/cli/src/bin/messenger_demo.rs): `cli/src/bin/messenger_demo.rs`
- [Pre-key wire format](https://github.com/moral666/qt/blob/main/cli/src/wire_format.rs): `cli/src/wire_format.rs`

### Cryptographic core

- [X3DH sessions](https://github.com/moral666/qt/blob/main/core/src/x3dh.rs): `core/src/x3dh.rs`
- [PQXDH sessions](https://github.com/moral666/qt/blob/main/core/src/pqxdh.rs): `core/src/pqxdh.rs`
- [Double Ratchet](https://github.com/moral666/qt/blob/main/core/src/ratchet.rs): `core/src/ratchet.rs`
- [Sealed Sender](https://github.com/moral666/qt/blob/main/core/src/sealed_sender.rs): `core/src/sealed_sender.rs`
- [Crypto primitives](https://github.com/moral666/qt/blob/main/core/src/primitives.rs): `core/src/primitives.rs`

### Network and relay

- [Noise WebSocket](https://github.com/moral666/qt/blob/main/transport/src/ws_transport.rs): `transport/src/ws_transport.rs`
- [Noise sessions](https://github.com/moral666/qt/blob/main/transport/src/noise_session.rs): `transport/src/noise_session.rs`
- [Relay server entry](https://github.com/moral666/qt/blob/main/server/src/bin/relay_server.rs): `server/src/bin/relay_server.rs`
- [Client connection handler](https://github.com/moral666/qt/blob/main/server/src/connection.rs): `server/src/connection.rs`
- [Relay message protocol](https://github.com/moral666/qt/blob/main/server/src/protocol.rs): `server/src/protocol.rs`
- [Relay queues and keys](https://github.com/moral666/qt/blob/main/server/src/store.rs): `server/src/store.rs`

### Persistence and bindings

- [Encrypted local storage](https://github.com/moral666/qt/blob/main/storage/src/lib.rs): `storage/src/lib.rs`
- [Platform bindings](https://github.com/moral666/qt/blob/main/ffi/src/lib.rs): `ffi/src/lib.rs`

### Other components

- **Messaging user**
- **Redis**
- **Kotlin, Swift, Python**

## Connections

- Messaging user → Terminal client: uses (evidence: `README.md`)
- Terminal client → X3DH sessions: establishes sessions (evidence: `README.md`)
- Terminal client → PQXDH sessions: can establish (evidence: `README.md`)
- X3DH sessions → Double Ratchet: initializes (evidence: `README.md`)
- PQXDH sessions → Double Ratchet: initializes
- Double Ratchet → Crypto primitives: uses (evidence: `core/src/ratchet.rs`)
- X3DH sessions → Crypto primitives: uses (evidence: `core/src/x3dh.rs`)
- PQXDH sessions → Crypto primitives: uses (evidence: `core/src/pqxdh.rs`)
- Sealed Sender → Crypto primitives: uses (evidence: `core/src/sealed_sender.rs`)
- Terminal client → Sealed Sender: seals sender identity (evidence: `README.md`)
- Terminal client → Pre-key wire format: encodes pre-key bundles (evidence: `README.md`)
- Terminal client → Encrypted local storage: persists identity and conversations (evidence: `README.md`)
- Terminal client → Noise WebSocket: connects over WebSocket (evidence: `README.md`)
- Conversation demo → Double Ratchet: demonstrates messaging (evidence: `README.md`)
- Conversation demo → Noise WebSocket: demonstrates network layer (evidence: `README.md`)
- Noise WebSocket → Noise sessions: uses (evidence: `transport/src/ws_transport.rs`)
- Relay server entry → Client connection handler: accepts connections
- Client connection handler → Noise WebSocket: uses (evidence: `server/src/connection.rs`)
- Client connection handler → Relay message protocol: decodes and encodes (evidence: `server/src/connection.rs`)
- Client connection handler → Relay queues and keys: dispatches requests (evidence: `server/src/connection.rs`)
- Relay queues and keys → Redis: reads and writes (evidence: `server/src/store.rs`)
- Platform bindings → Kotlin, Swift, Python: provides bindings (evidence: `README.md`)
- Kotlin, Swift, Python → X3DH sessions: uses crypto core (evidence: `README.md`)
