# aditya-karn234/peerpayload architecture

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

- Interactive diagram: https://gitdiagram.com/aditya-karn234/peerpayload
- Repository: https://github.com/aditya-karn234/peerpayload

## Overview

PeerPayload combines two file-transfer products over a shared TLS engine: Enterprise uses accounts, presence, and an audit-oriented backend; Connect uses device identities, pairing, and encrypted store-and-forward messages without accounts. The main workflow is selecting a recipient, negotiating a transfer route, moving and verifying file bytes, then recording transfer state/history. The map also preserves both client families, protocol definitions, and the relay/mailbox services. Some unsampled subsystems are included based on the README and tree; their internal links are omitted where source excerpts do not establish calls.

Main entry points: [`connect/core/transfers.js`](https://github.com/aditya-karn234/peerpayload/blob/main/connect/core/transfers.js) (Identity and transfer logic), [`client-core/engine.js`](https://github.com/aditya-karn234/peerpayload/blob/main/client-core/engine.js) (Client core), [`engine/src/peerpayload.cpp`](https://github.com/aditya-karn234/peerpayload/blob/main/engine/src/peerpayload.cpp) (TLS transfer engine), [`backend/src/server.js`](https://github.com/aditya-karn234/peerpayload/blob/main/backend/src/server.js) (Enterprise API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_enterprise["Enterprise"]
  node_desktop["Enterprise desktop<br/>[App.jsx]"]
  node_dashboard["Dashboard state<br/>[useDashboard.js]"]
  node_cli["Enterprise CLI<br/>[index.js]"]
  node_client_core["Client core<br/>[engine.js]"]
  node_backend["Enterprise API<br/>[server.js]"]
  node_backend_routes["Accounts and transfers"]
  node_presence["Presence service<br/>[presenceService.js]"]
end

subgraph group_connect["Connect"]
  node_connect_desktop["Connect desktop app<br/>[App.jsx]"]
  node_android_app["Connect Android app<br/>[ConnectApp.kt]"]
  node_connect_core["Identity and transfer logic<br/>[transfers.js]"]
  node_mailbox_client["Mailbox client<br/>[mailboxClient.js]"]
end

subgraph group_transfer["Transfer runtime"]
  node_engine["TLS transfer engine<br/>[peerpayload.cpp]"]
  node_sender["Sender runtime<br/>[sender.cpp]"]
  node_receiver["Receiver runtime<br/>[receiver.cpp]"]
  node_engine_entry["Engine entry interface<br/>[engine_entry.hpp]"]
end

subgraph group_services["Network services"]
  node_connect_mailbox["Connect mailbox<br/>[server.js]"]
  node_mailbox_store[("Envelope store<br/>[store.js]")]
  node_enterprise_relay["Enterprise relay<br/>[server.js]"]
end

subgraph group_protocol["Shared protocol"]
  node_protocol["Wire formats<br/>[messages.js]"]
  node_relay_tickets["Relay tickets<br/>[relayTickets.js]"]
  node_connect_android_envelope["Android envelope format<br/>[Envelope.kt]"]
end

node_enterprise_user(("Team user"))
node_connect_user(("Connect user"))

node_enterprise_user -->|"uses"| node_desktop
node_enterprise_user -->|"uses"| node_cli
node_desktop -->|"renders"| node_dashboard
node_dashboard -.->|"requests transfers"| node_client_core
node_cli -->|"uses API"| node_client_core
node_client_core -.->|"calls API"| node_backend
node_backend -->|"routes requests"| node_backend_routes
node_backend -.->|"records presence"| node_presence
node_enterprise_user -->|"uses Connect"| node_connect_desktop
node_connect_user -->|"uses"| node_android_app
node_connect_user -->|"uses"| node_connect_desktop
node_connect_desktop -.->|"manages transfers"| node_connect_core
node_android_app -.->|"uses transfer logic"| node_connect_core
node_connect_core -.->|"exchanges envelopes"| node_mailbox_client
node_mailbox_client -->|"posts and receives"| node_connect_mailbox
node_connect_mailbox -->|"stores envelopes"| node_mailbox_store
node_connect_core -->|"uses message formats"| node_protocol
node_mailbox_client -->|"verifies and opens"| node_connect_android_envelope
node_client_core -->|"spawns engine"| node_engine
node_connect_core -->|"transfers bytes"| node_engine
node_sender -->|"calls entry"| node_engine_entry
node_receiver -->|"calls entry"| node_engine_entry
node_engine -->|"provides runtime"| node_sender
node_engine -->|"provides runtime"| node_receiver
node_backend_routes -.->|"issues tickets"| node_relay_tickets
node_enterprise_relay -.->|"validates tickets"| node_relay_tickets
node_connect_core -.->|"uses device tickets"| node_relay_tickets
node_connect_core -->|"relays if needed"| node_enterprise_relay

click node_desktop "https://github.com/aditya-karn234/peerpayload/blob/main/desktop/src/renderer/src/App.jsx"
click node_dashboard "https://github.com/aditya-karn234/peerpayload/blob/main/desktop/src/renderer/src/lib/useDashboard.js"
click node_cli "https://github.com/aditya-karn234/peerpayload/blob/main/cli/src/index.js"
click node_client_core "https://github.com/aditya-karn234/peerpayload/blob/main/client-core/engine.js"
click node_backend "https://github.com/aditya-karn234/peerpayload/blob/main/backend/src/server.js"
click node_backend_routes "https://github.com/aditya-karn234/peerpayload/tree/main/backend/src/routes"
click node_presence "https://github.com/aditya-karn234/peerpayload/blob/main/backend/src/services/presenceService.js"
click node_connect_desktop "https://github.com/aditya-karn234/peerpayload/blob/main/connect/desktop/src/renderer/src/App.jsx"
click node_android_app "https://github.com/aditya-karn234/peerpayload/blob/main/connect/android/app/src/main/java/com/peerpayload/connect/app/ConnectApp.kt"
click node_connect_core "https://github.com/aditya-karn234/peerpayload/blob/main/connect/core/transfers.js"
click node_mailbox_client "https://github.com/aditya-karn234/peerpayload/blob/main/connect/core/mailboxClient.js"
click node_connect_mailbox "https://github.com/aditya-karn234/peerpayload/blob/main/connect/mailbox/src/server.js"
click node_mailbox_store "https://github.com/aditya-karn234/peerpayload/blob/main/connect/mailbox/src/store.js"
click node_engine "https://github.com/aditya-karn234/peerpayload/blob/main/engine/src/peerpayload.cpp"
click node_sender "https://github.com/aditya-karn234/peerpayload/blob/main/sender/src/sender.cpp"
click node_receiver "https://github.com/aditya-karn234/peerpayload/blob/main/receiver/src/receiver.cpp"
click node_engine_entry "https://github.com/aditya-karn234/peerpayload/blob/main/shared/include/engine_entry.hpp"
click node_protocol "https://github.com/aditya-karn234/peerpayload/blob/main/protocol/messages.js"
click node_relay_tickets "https://github.com/aditya-karn234/peerpayload/blob/main/protocol/relayTickets.js"
click node_enterprise_relay "https://github.com/aditya-karn234/peerpayload/blob/main/relay/src/server.js"
click node_connect_android_envelope "https://github.com/aditya-karn234/peerpayload/blob/main/connect/android/app/src/main/java/com/peerpayload/connect/protocol/Envelope.kt"

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_desktop,node_dashboard,node_cli,node_client_core,node_backend,node_backend_routes,node_presence,node_enterprise_user,node_connect_user toneBlue
class node_connect_desktop,node_android_app,node_connect_core,node_mailbox_client toneAmber
class node_engine,node_sender,node_receiver,node_engine_entry toneMint
class node_connect_mailbox,node_mailbox_store,node_enterprise_relay toneRose
class node_protocol,node_relay_tickets,node_connect_android_envelope toneIndigo
```

## Components

### Enterprise

- [Enterprise desktop](https://github.com/aditya-karn234/peerpayload/blob/main/desktop/src/renderer/src/App.jsx): `desktop/src/renderer/src/App.jsx`
- [Dashboard state](https://github.com/aditya-karn234/peerpayload/blob/main/desktop/src/renderer/src/lib/useDashboard.js): `desktop/src/renderer/src/lib/useDashboard.js`
- [Enterprise CLI](https://github.com/aditya-karn234/peerpayload/blob/main/cli/src/index.js): `cli/src/index.js`
- [Client core](https://github.com/aditya-karn234/peerpayload/blob/main/client-core/engine.js): `client-core/engine.js`
- [Enterprise API](https://github.com/aditya-karn234/peerpayload/blob/main/backend/src/server.js): `backend/src/server.js`
- [Accounts and transfers](https://github.com/aditya-karn234/peerpayload/tree/main/backend/src/routes): `backend/src/routes`
- [Presence service](https://github.com/aditya-karn234/peerpayload/blob/main/backend/src/services/presenceService.js): `backend/src/services/presenceService.js`

### Connect

- [Connect desktop app](https://github.com/aditya-karn234/peerpayload/blob/main/connect/desktop/src/renderer/src/App.jsx): `connect/desktop/src/renderer/src/App.jsx`
- [Connect Android app](https://github.com/aditya-karn234/peerpayload/blob/main/connect/android/app/src/main/java/com/peerpayload/connect/app/ConnectApp.kt): `connect/android/app/src/main/java/com/peerpayload/connect/app/ConnectApp.kt`
- [Identity and transfer logic](https://github.com/aditya-karn234/peerpayload/blob/main/connect/core/transfers.js): `connect/core/transfers.js`
- [Mailbox client](https://github.com/aditya-karn234/peerpayload/blob/main/connect/core/mailboxClient.js): `connect/core/mailboxClient.js`

### Transfer runtime

- [TLS transfer engine](https://github.com/aditya-karn234/peerpayload/blob/main/engine/src/peerpayload.cpp): `engine/src/peerpayload.cpp`
- [Sender runtime](https://github.com/aditya-karn234/peerpayload/blob/main/sender/src/sender.cpp): `sender/src/sender.cpp`
- [Receiver runtime](https://github.com/aditya-karn234/peerpayload/blob/main/receiver/src/receiver.cpp): `receiver/src/receiver.cpp`
- [Engine entry interface](https://github.com/aditya-karn234/peerpayload/blob/main/shared/include/engine_entry.hpp): `shared/include/engine_entry.hpp`

### Network services

- [Connect mailbox](https://github.com/aditya-karn234/peerpayload/blob/main/connect/mailbox/src/server.js): `connect/mailbox/src/server.js`
- [Envelope store](https://github.com/aditya-karn234/peerpayload/blob/main/connect/mailbox/src/store.js): `connect/mailbox/src/store.js`
- [Enterprise relay](https://github.com/aditya-karn234/peerpayload/blob/main/relay/src/server.js): `relay/src/server.js`

### Shared protocol

- [Wire formats](https://github.com/aditya-karn234/peerpayload/blob/main/protocol/messages.js): `protocol/messages.js`
- [Relay tickets](https://github.com/aditya-karn234/peerpayload/blob/main/protocol/relayTickets.js): `protocol/relayTickets.js`
- [Android envelope format](https://github.com/aditya-karn234/peerpayload/blob/main/connect/android/app/src/main/java/com/peerpayload/connect/protocol/Envelope.kt): `connect/android/app/src/main/java/com/peerpayload/connect/protocol/Envelope.kt`

### Other components

- **Team user**
- **Connect user**

## Connections

- Team user → Enterprise desktop: uses (evidence: `README.md`)
- Team user → Enterprise CLI: uses (evidence: `README.md`)
- Enterprise desktop → Dashboard state: renders (evidence: `desktop/src/renderer/src/App.jsx`)
- Dashboard state → Client core: requests transfers
- Enterprise CLI → Client core: uses API
- Client core → Enterprise API: calls API
- Enterprise API → Accounts and transfers: routes requests (evidence: `backend/src/server.js`)
- Enterprise API → Presence service: records presence
- Team user → Connect desktop app: uses Connect (evidence: `README.md`)
- Connect user → Connect Android app: uses (evidence: `README.md`)
- Connect user → Connect desktop app: uses (evidence: `README.md`)
- Connect desktop app → Identity and transfer logic: manages transfers
- Connect Android app → Identity and transfer logic: uses transfer logic
- Identity and transfer logic → Mailbox client: exchanges envelopes
- Mailbox client → Connect mailbox: posts and receives (evidence: `connect/core/mailboxClient.js`)
- Connect mailbox → Envelope store: stores envelopes (evidence: `connect/mailbox/src/server.js`)
- Identity and transfer logic → Wire formats: uses message formats
- Mailbox client → Android envelope format: verifies and opens
- Client core → TLS transfer engine: spawns engine (evidence: `README.md`)
- Identity and transfer logic → TLS transfer engine: transfers bytes (evidence: `README.md`)
- Sender runtime → Engine entry interface: calls entry
- Receiver runtime → Engine entry interface: calls entry
- TLS transfer engine → Sender runtime: provides runtime (evidence: `README.md`)
- TLS transfer engine → Receiver runtime: provides runtime (evidence: `README.md`)
- Accounts and transfers → Relay tickets: issues tickets
- Enterprise relay → Relay tickets: validates tickets
- Identity and transfer logic → Relay tickets: uses device tickets
- Identity and transfer logic → Enterprise relay: relays if needed (evidence: `README.md`)
