# krascovictbr/bmchat architecture

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

- Interactive diagram: https://gitdiagram.com/krascovictbr/bmchat
- Repository: https://github.com/krascovictbr/bmchat

## Overview

bmchat is a Tkinter Bitmessage messenger. The main workflow is composing a message in the GUI, passing it to the client for contact-key lookup and protocol-object creation, computing proof of work, and publishing through the peer network; incoming objects are parsed and surfaced to the GUI. The repository also includes identity/key management, encrypted local data, contact and message persistence, proxy networking, and operational GUI features such as key backup and network diagnostics. Arrows are limited to relationships visible in excerpts, the source index, or the README; unsampled details are not inferred.

Main entry points: [`bmchat/core/client.py`](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/client.py) (Messenger client), [`bmchat/net/manager.py`](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/manager.py) (Network manager), [`bmchat/gui/app.py`](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/app.py) (Chat GUI), [`bmchat/protocol/objects.py`](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/objects.py) (Message objects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_gui["Chat GUI<br/>[app.py]"]
  node_gui_commands["GUI commands<br/>[send_message.py]"]
  node_backup["Key backup<br/>[backup_keys.py]"]
  node_diagnostics["Network diagnostics<br/>[app.py]"]
end

subgraph group_messaging["Messaging core"]
  node_client["Messenger client<br/>[client.py]"]
  node_events["Event system<br/>[emitter.py]"]
  node_message_model["Message state<br/>[message.py]"]
  node_repositories["Data repositories<br/>[message_repo.py]"]
  node_database[("Local database<br/>[database.py]")]
end

subgraph group_protocol["Bitmessage protocol"]
  node_protocol_factory["Object factory<br/>[factory.py]"]
  node_objects["Message objects<br/>[objects.py]"]
  node_packets["Wire packets<br/>[packets.py]"]
  node_address["Bitmessage addresses<br/>[address.py]"]
end

subgraph group_network["Peer networking"]
  node_network_manager["Network manager<br/>[manager.py]"]
  node_peer["Peer connection<br/>[peer.py]"]
  node_peer_store[("Known peers<br/>[peers.py]")]
  node_proxy["Proxy settings<br/>[proxy.py]"]
end

subgraph group_security["Keys and security"]
  node_pow["Proof of work<br/>[standard.py]"]
  node_keys["Identity keys<br/>[keys.py]"]
  node_ecc["Elliptic cryptography<br/>[ecc.py]"]
  node_encrypted_db["Encrypted data<br/>[encrypted_db.py]"]
end

node_person(("User"))
node_bitmessage(("Bitmessage peers"))

node_person -->|"uses"| node_gui
node_gui -->|"invokes"| node_client
node_gui -->|"dispatches"| node_gui_commands
node_gui -->|"displays"| node_diagnostics
node_gui_commands -->|"sends message"| node_client
node_gui -->|"offers backup"| node_backup
node_backup -.->|"exports keys"| node_keys
node_client -->|"reads and writes"| node_database
node_client -->|"creates objects"| node_protocol_factory
node_client -->|"publishes objects"| node_network_manager
node_client -->|"requests work"| node_pow
node_client -->|"uses identities"| node_keys
node_client -->|"emits events"| node_events
node_client -->|"loads pubkeys"| node_repositories
node_repositories -.->|"queries"| node_database
node_client -.->|"tracks messages"| node_message_model
node_protocol_factory -->|"builds objects"| node_objects
node_objects -->|"signs payloads"| node_ecc
node_objects -->|"uses key material"| node_keys
node_keys -->|"derives addresses"| node_address
node_network_manager -->|"manages connections"| node_peer
node_network_manager -->|"exchanges packets"| node_packets
node_network_manager -->|"parses objects"| node_objects
node_network_manager -->|"uses peer records"| node_peer_store
node_network_manager -->|"configures proxy"| node_proxy
node_peer -->|"connects to"| node_bitmessage
node_gui -->|"uses encrypted storage"| node_encrypted_db
node_diagnostics -.->|"reports status"| node_network_manager

click node_gui "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/app.py"
click node_gui_commands "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/commands/send_message.py"
click node_backup "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/commands/backup_keys.py"
click node_diagnostics "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/app.py"
click node_client "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/client.py"
click node_events "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/events/emitter.py"
click node_message_model "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/models/message.py"
click node_repositories "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/repositories/message_repo.py"
click node_database "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/database.py"
click node_protocol_factory "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/factory.py"
click node_objects "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/objects.py"
click node_packets "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/packets.py"
click node_address "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/address.py"
click node_pow "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/pow/standard.py"
click node_keys "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/keys.py"
click node_ecc "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/ecc.py"
click node_encrypted_db "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/encrypted_db.py"
click node_network_manager "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/manager.py"
click node_peer "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/peer.py"
click node_peer_store "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/peers.py"
click node_proxy "https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/proxy.py"

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_gui,node_gui_commands,node_backup,node_diagnostics,node_person toneBlue
class node_client,node_events,node_message_model,node_repositories,node_database toneAmber
class node_protocol_factory,node_objects,node_packets,node_address toneMint
class node_network_manager,node_peer,node_peer_store,node_proxy toneRose
class node_pow,node_keys,node_ecc,node_encrypted_db,node_bitmessage toneIndigo
```

## Components

### User interface

- [Chat GUI](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/app.py): `bmchat/gui/app.py`
- [GUI commands](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/commands/send_message.py): `bmchat/gui/commands/send_message.py`
- [Key backup](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/commands/backup_keys.py): `bmchat/gui/commands/backup_keys.py`
- [Network diagnostics](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/gui/app.py): `bmchat/gui/app.py`

### Messaging core

- [Messenger client](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/client.py): `bmchat/core/client.py`
- [Event system](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/events/emitter.py): `bmchat/core/events/emitter.py`
- [Message state](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/models/message.py): `bmchat/core/models/message.py`
- [Data repositories](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/repositories/message_repo.py): `bmchat/core/repositories/message_repo.py`
- [Local database](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/core/database.py): `bmchat/core/database.py`

### Bitmessage protocol

- [Object factory](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/factory.py): `bmchat/protocol/factory.py`
- [Message objects](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/objects.py): `bmchat/protocol/objects.py`
- [Wire packets](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/packets.py): `bmchat/protocol/packets.py`
- [Bitmessage addresses](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/protocol/address.py): `bmchat/protocol/address.py`

### Peer networking

- [Network manager](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/manager.py): `bmchat/net/manager.py`
- [Peer connection](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/peer.py): `bmchat/net/peer.py`
- [Known peers](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/peers.py): `bmchat/net/peers.py`
- [Proxy settings](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/net/proxy.py): `bmchat/net/proxy.py`

### Keys and security

- [Proof of work](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/pow/standard.py): `bmchat/crypto/pow/standard.py`
- [Identity keys](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/keys.py): `bmchat/crypto/keys.py`
- [Elliptic cryptography](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/ecc.py): `bmchat/crypto/ecc.py`
- [Encrypted data](https://github.com/krascovictbr/bmchat/blob/rolling-release/bmchat/crypto/encrypted_db.py): `bmchat/crypto/encrypted_db.py`

### Other components

- **User**
- **Bitmessage peers**

## Connections

- User → Chat GUI: uses (evidence: `README.md`)
- Chat GUI → Messenger client: invokes (evidence: `bmchat/gui/app.py`)
- Chat GUI → GUI commands: dispatches (evidence: `bmchat/gui/app.py`)
- Chat GUI → Network diagnostics: displays (evidence: `README.md`)
- GUI commands → Messenger client: sends message (evidence: `bmchat/gui/commands/send_message.py`)
- Chat GUI → Key backup: offers backup (evidence: `README.md`)
- Key backup → Identity keys: exports keys
- Messenger client → Local database: reads and writes (evidence: `bmchat/core/client.py`)
- Messenger client → Object factory: creates objects (evidence: `bmchat/core/client.py`)
- Messenger client → Network manager: publishes objects (evidence: `bmchat/core/client.py`)
- Messenger client → Proof of work: requests work (evidence: `bmchat/core/client.py`)
- Messenger client → Identity keys: uses identities (evidence: `bmchat/core/client.py`)
- Messenger client → Event system: emits events (evidence: `bmchat/core/client.py`)
- Messenger client → Data repositories: loads pubkeys (evidence: `bmchat/core/client.py`)
- Data repositories → Local database: queries
- Messenger client → Message state: tracks messages
- Object factory → Message objects: builds objects (evidence: `bmchat/protocol/factory.py`)
- Message objects → Elliptic cryptography: signs payloads (evidence: `bmchat/protocol/objects.py`)
- Message objects → Identity keys: uses key material (evidence: `bmchat/protocol/objects.py`)
- Identity keys → Bitmessage addresses: derives addresses (evidence: `bmchat/crypto/keys.py`)
- Network manager → Peer connection: manages connections (evidence: `bmchat/net/manager.py`)
- Network manager → Wire packets: exchanges packets (evidence: `bmchat/net/manager.py`)
- Network manager → Message objects: parses objects (evidence: `bmchat/net/manager.py`)
- Network manager → Known peers: uses peer records (evidence: `bmchat/net/manager.py`)
- Network manager → Proxy settings: configures proxy (evidence: `bmchat/net/manager.py`)
- Peer connection → Bitmessage peers: connects to (evidence: `README.md`)
- Chat GUI → Encrypted data: uses encrypted storage (evidence: `bmchat/gui/app.py`)
- Network diagnostics → Network manager: reports status
