# cgutman/adblib architecture

> Architecture diagram of the GitHub repository cgutman/adblib, 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/cgutman/adblib
- Repository: https://github.com/cgutman/adblib

## Overview

AdbLib is a Java implementation of the ADB network protocol. A caller supplies a socket and crypto keys, starts a connection, and opens a destination stream; the connection exchanges protocol packets with the ADB peer while streams expose byte and string reads/writes. The library also generates, signs, loads, and saves RSA keys, with Base64 encoding delegated to a caller-provided implementation. Edges reflect calls and packet handling shown in excerpts; key file operations and the external peer are represented only where supported.

Main entry points: [`src/com/cgutman/adblib/AdbConnection.java`](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbConnection.java) (Connection manager), [`src/com/cgutman/adblib/AdbStream.java`](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbStream.java) (Logical streams), [`src/com/cgutman/adblib/AdbCrypto.java`](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbCrypto.java) (RSA key handling), [`src/com/cgutman/adblib/AdbProtocol.java`](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbProtocol.java) (Packet codec)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["Connection"]
  node_adb_connection["Connection manager<br/>[AdbConnection.java]"]
  node_adb_stream["Logical streams<br/>[AdbStream.java]"]
end

subgraph group_protocol["ADB Protocol"]
  node_adb_protocol["Packet codec<br/>[AdbProtocol.java]"]
end

subgraph group_auth["Authentication"]
  node_adb_crypto["RSA key handling<br/>[AdbCrypto.java]"]
  node_adb_base64["Base64 provider<br/>[AdbBase64.java]"]
end

node_caller(("Library caller"))
node_socket(("ADB peer socket"))

node_caller -->|"creates connection"| node_adb_connection
node_caller -->|"starts and opens"| node_adb_connection
node_adb_connection -->|"reads and writes"| node_socket
node_adb_connection -->|"parses and validates"| node_adb_protocol
node_adb_connection -->|"generates packets"| node_adb_protocol
node_adb_connection -->|"creates and dispatches"| node_adb_stream
node_adb_stream -->|"generates stream packets"| node_adb_protocol
node_adb_stream -->|"writes to connection"| node_adb_connection
node_adb_connection -->|"signs auth challenges"| node_adb_crypto
node_adb_crypto -->|"encodes public key"| node_adb_base64
node_caller -->|"supplies keys"| node_adb_crypto

click node_adb_connection "https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbConnection.java"
click node_adb_stream "https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbStream.java"
click node_adb_protocol "https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbProtocol.java"
click node_adb_crypto "https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbCrypto.java"
click node_adb_base64 "https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbBase64.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_adb_connection,node_adb_stream toneBlue
class node_adb_protocol toneAmber
class node_adb_crypto,node_adb_base64 toneMint
class node_caller,node_socket toneIndigo
```

## Components

### Connection

- [Connection manager](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbConnection.java): `src/com/cgutman/adblib/AdbConnection.java`
- [Logical streams](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbStream.java): `src/com/cgutman/adblib/AdbStream.java`

### ADB Protocol

- [Packet codec](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbProtocol.java): `src/com/cgutman/adblib/AdbProtocol.java`

### Authentication

- [RSA key handling](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbCrypto.java): `src/com/cgutman/adblib/AdbCrypto.java`
- [Base64 provider](https://github.com/cgutman/adblib/blob/master/src/com/cgutman/adblib/AdbBase64.java): `src/com/cgutman/adblib/AdbBase64.java`

### Other components

- **Library caller**
- **ADB peer socket**

## Connections

- Library caller → Connection manager: creates connection (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Library caller → Connection manager: starts and opens (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Connection manager → ADB peer socket: reads and writes (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Connection manager → Packet codec: parses and validates (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Connection manager → Packet codec: generates packets (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Connection manager → Logical streams: creates and dispatches (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- Logical streams → Packet codec: generates stream packets (evidence: `src/com/cgutman/adblib/AdbStream.java`)
- Logical streams → Connection manager: writes to connection (evidence: `src/com/cgutman/adblib/AdbStream.java`)
- Connection manager → RSA key handling: signs auth challenges (evidence: `src/com/cgutman/adblib/AdbConnection.java`)
- RSA key handling → Base64 provider: encodes public key (evidence: `src/com/cgutman/adblib/AdbCrypto.java`)
- Library caller → RSA key handling: supplies keys
