# prophetbrochure/p2p_messenger architecture

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

- Interactive diagram: https://gitdiagram.com/prophetbrochure/p2p_messenger
- Repository: https://github.com/prophetbrochure/p2p_messenger

## Overview

This is a JavaFX peer-to-peer messenger for local networks. The main workflow configures a nickname, port, and network interface; starts a TCP listener and chat UI; discovers peers through ZeroConf or lets the user connect directly; then exchanges encrypted messages and displays chat history. The graph separates UI, networking, discovery, and cryptography. Some README capabilities, including subnet scanning and interface selection, are documented but their implementation details are not shown in the excerpts, so their internal links are omitted.

Main entry points: [`src/main/java/Network/PeerHandler.java`](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/PeerHandler.java) (Peer session), [`src/main/java/app/Main.java`](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/Main.java) (Setup and launch), [`src/main/java/Crypto/AES128_CTR_MAC.java`](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AES128_CTR_MAC.java) (CTR and MAC), [`src/main/java/Network/Server.java`](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Server.java) (TCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Chat interface"]
  node_main["Setup and launch<br/>[Main.java]"]
  node_chat["Chat window<br/>[ChatWindow.java]"]
  node_io["Interface selection<br/>[IO.java]"]
end

subgraph group_network["Peer networking"]
  node_server["TCP server<br/>[Server.java]"]
  node_handler["Peer session<br/>[PeerHandler.java]"]
  node_peer["Peer and history<br/>[Peer.java]"]
  node_commands["Session commands<br/>[Command.java]"]
end

subgraph group_discovery["Peer discovery"]
  node_zeroconf["ZeroConf discovery"]
end

subgraph group_crypto["Encryption"]
  node_dh["Diffie-Hellman<br/>[DH.java]"]
  node_hkdf["Key derivation<br/>[HKDF.java]"]
  node_cipher["CTR and MAC"]
  node_aes["AES block cipher<br/>[AES128.java]"]
  node_ctr["CTR mode<br/>[CTRMode.java]"]
  node_mac["AES-CMAC<br/>[AESCMAC.java]"]
  node_wire["Encrypted message format"]
  node_key["Key material<br/>[Key.java]"]
  node_nonce["Nonce<br/>[Nonce.java]"]
end

node_user(("Messenger user"))
node_remote(("Remote peer"))

node_user -->|"configures"| node_main
node_main -->|"lists interfaces"| node_io
node_main -->|"starts listener"| node_server
node_main -->|"opens window"| node_chat
node_main -->|"starts discovery"| node_zeroconf
node_chat -->|"sends messages"| node_server
node_server -->|"creates sessions"| node_handler
node_server -->|"tracks peers"| node_peer
node_handler -->|"updates history"| node_peer
node_handler -->|"exchanges keys"| node_dh
node_handler -->|"derives keys"| node_hkdf
node_handler -->|"encrypts messages"| node_cipher
node_handler -->|"parses payloads"| node_wire
node_cipher -->|"uses"| node_ctr
node_cipher -->|"authenticates"| node_mac
node_cipher -->|"constructs"| node_aes
node_cipher -->|"returns ciphertext"| node_wire
node_ctr -->|"uses counter nonce"| node_nonce
node_hkdf -->|"produces keys"| node_key
node_zeroconf -->|"reports peers"| node_chat
node_remote -->|"opens TCP connection"| node_server
node_commands -->|"operates on peer"| node_peer

click node_main "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/Main.java"
click node_chat "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/ChatWindow.java"
click node_io "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/IO.java"
click node_server "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Server.java"
click node_handler "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/PeerHandler.java"
click node_peer "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Peer.java"
click node_commands "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Command.java"
click node_zeroconf "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/ZeroConfProtocol.java"
click node_dh "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/DH.java"
click node_hkdf "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/HKDF.java"
click node_cipher "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AES128_CTR_MAC.java"
click node_aes "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AES128.java"
click node_ctr "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/CTRMode.java"
click node_mac "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AESCMAC.java"
click node_wire "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/EncryptedMessage.java"
click node_key "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/Key.java"
click node_nonce "https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/Nonce.java"

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_main,node_chat,node_io,node_user toneBlue
class node_server,node_handler,node_peer,node_commands toneAmber
class node_zeroconf toneMint
class node_dh,node_hkdf,node_cipher,node_aes,node_ctr,node_mac,node_wire,node_key,node_nonce toneRose
class node_remote toneIndigo
```

## Components

### Chat interface

- [Setup and launch](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/Main.java): `src/main/java/app/Main.java`
- [Chat window](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/ChatWindow.java): `src/main/java/app/ChatWindow.java`
- [Interface selection](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/IO.java): `src/main/java/app/IO.java`

### Peer networking

- [TCP server](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Server.java): `src/main/java/Network/Server.java`
- [Peer session](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/PeerHandler.java): `src/main/java/Network/PeerHandler.java`
- [Peer and history](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Peer.java): `src/main/java/Network/Peer.java`
- [Session commands](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Network/Command.java): `src/main/java/Network/Command.java`

### Peer discovery

- [ZeroConf discovery](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/app/ZeroConfProtocol.java): `src/main/java/app/ZeroConfProtocol.java`

### Encryption

- [Diffie-Hellman](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/DH.java): `src/main/java/Crypto/DH.java`
- [Key derivation](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/HKDF.java): `src/main/java/Crypto/HKDF.java`
- [CTR and MAC](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AES128_CTR_MAC.java): `src/main/java/Crypto/AES128_CTR_MAC.java`
- [AES block cipher](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AES128.java): `src/main/java/Crypto/AES128.java`
- [CTR mode](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/CTRMode.java): `src/main/java/Crypto/CTRMode.java`
- [AES-CMAC](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/AESCMAC.java): `src/main/java/Crypto/AESCMAC.java`
- [Encrypted message format](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/EncryptedMessage.java): `src/main/java/Crypto/EncryptedMessage.java`
- [Key material](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/Key.java): `src/main/java/Crypto/Key.java`
- [Nonce](https://github.com/prophetbrochure/p2p_messenger/blob/main/src/main/java/Crypto/Nonce.java): `src/main/java/Crypto/Nonce.java`

### Other components

- **Messenger user**
- **Remote peer**

## Connections

- Messenger user → Setup and launch: configures (evidence: `README.md`)
- Setup and launch → Interface selection: lists interfaces (evidence: `src/main/java/app/Main.java`)
- Setup and launch → TCP server: starts listener (evidence: `src/main/java/app/Main.java`)
- Setup and launch → Chat window: opens window (evidence: `src/main/java/app/Main.java`)
- Setup and launch → ZeroConf discovery: starts discovery (evidence: `src/main/java/app/Main.java`)
- Chat window → TCP server: sends messages (evidence: `src/main/java/app/ChatWindow.java`)
- TCP server → Peer session: creates sessions (evidence: `src/main/java/Network/Server.java`)
- TCP server → Peer and history: tracks peers (evidence: `src/main/java/Network/Server.java`)
- Peer session → Peer and history: updates history (evidence: `src/main/java/Network/PeerHandler.java`)
- Peer session → Diffie-Hellman: exchanges keys (evidence: `src/main/java/Network/PeerHandler.java`)
- Peer session → Key derivation: derives keys (evidence: `src/main/java/Network/PeerHandler.java`)
- Peer session → CTR and MAC: encrypts messages (evidence: `src/main/java/Network/PeerHandler.java`)
- Peer session → Encrypted message format: parses payloads (evidence: `src/main/java/Network/PeerHandler.java`)
- CTR and MAC → CTR mode: uses (evidence: `src/main/java/Crypto/AES128_CTR_MAC.java`)
- CTR and MAC → AES-CMAC: authenticates (evidence: `src/main/java/Crypto/AES128_CTR_MAC.java`)
- CTR and MAC → AES block cipher: constructs (evidence: `src/main/java/Crypto/AES128_CTR_MAC.java`)
- CTR and MAC → Encrypted message format: returns ciphertext (evidence: `src/main/java/Crypto/AES128_CTR_MAC.java`)
- CTR mode → Nonce: uses counter nonce (evidence: `src/main/java/Crypto/AES128_CTR_MAC.java`)
- Key derivation → Key material: produces keys (evidence: `src/main/java/Crypto/HKDF.java`)
- ZeroConf discovery → Chat window: reports peers (evidence: `src/main/java/app/ZeroConfProtocol.java`)
- Remote peer → TCP server: opens TCP connection (evidence: `src/main/java/Network/Server.java`)
- Session commands → Peer and history: operates on peer (evidence: `src/main/java/Network/HistoryCommand.java`)
