How krascovictbr/bmchat works
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: client.py Messenger client · manager.py Network manager · app.py Chat GUI · objects.py Message objects
Components 23
User interface
- Chat GUI
bmchat/gui/app.py - GUI commands
bmchat/gui/commands/send_message.py - Key backup
bmchat/gui/commands/backup_keys.py - Network diagnostics
bmchat/gui/app.py
Messaging core
- Messenger client
bmchat/core/client.py - Event system
bmchat/core/events/emitter.py - Message state
bmchat/core/models/message.py - Data repositories
bmchat/core/repositories/message_repo.py - Local database
bmchat/core/database.py
Bitmessage protocol
- Object factory
bmchat/protocol/factory.py - Message objects
bmchat/protocol/objects.py - Wire packets
bmchat/protocol/packets.py - Bitmessage addresses
bmchat/protocol/address.py
Peer networking
- Network manager
bmchat/net/manager.py - Peer connection
bmchat/net/peer.py - Known peers
bmchat/net/peers.py - Proxy settings
bmchat/net/proxy.py
Keys and security
- Proof of work
bmchat/crypto/pow/standard.py - Identity keys
bmchat/crypto/keys.py - Elliptic cryptography
bmchat/crypto/ecc.py - Encrypted data
bmchat/crypto/encrypted_db.py
Other components
- User
- Bitmessage peers
Connections 28
- User → Chat GUI: uses
README.md - Chat GUI → Messenger client: invokes
bmchat/gui/app.py - Chat GUI → GUI commands: dispatches
bmchat/gui/app.py - Chat GUI → Network diagnostics: displays
README.md - GUI commands → Messenger client: sends message
bmchat/gui/commands/send_message.py - Chat GUI → Key backup: offers backup
README.md - Key backup → Identity keys: exports keys
- Messenger client → Local database: reads and writes
bmchat/core/client.py - Messenger client → Object factory: creates objects
bmchat/core/client.py - Messenger client → Network manager: publishes objects
bmchat/core/client.py - Messenger client → Proof of work: requests work
bmchat/core/client.py - Messenger client → Identity keys: uses identities
bmchat/core/client.py - Messenger client → Event system: emits events
bmchat/core/client.py - Messenger client → Data repositories: loads pubkeys
bmchat/core/client.py - Data repositories → Local database: queries
- Messenger client → Message state: tracks messages
- Object factory → Message objects: builds objects
bmchat/protocol/factory.py - Message objects → Elliptic cryptography: signs payloads
bmchat/protocol/objects.py - Message objects → Identity keys: uses key material
bmchat/protocol/objects.py - Identity keys → Bitmessage addresses: derives addresses
bmchat/crypto/keys.py - Network manager → Peer connection: manages connections
bmchat/net/manager.py - Network manager → Wire packets: exchanges packets
bmchat/net/manager.py - Network manager → Message objects: parses objects
bmchat/net/manager.py - Network manager → Known peers: uses peer records
bmchat/net/manager.py - Network manager → Proxy settings: configures proxy
bmchat/net/manager.py - Peer connection → Bitmessage peers: connects to
README.md - Chat GUI → Encrypted data: uses encrypted storage
bmchat/gui/app.py - Network diagnostics → Network manager: reports status