# delta-kronecker/delta-tor architecture

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

- Interactive diagram: https://gitdiagram.com/delta-kronecker/delta-tor
- Repository: https://github.com/delta-kronecker/delta-tor

## Overview

DeltaTor is a cross-platform Tor client whose central workflow races connection transports, selects a working Tor runner, then exposes traffic through a VPN or SOCKS endpoint. Android’s service owns tunnel lifecycle and recovery; Windows has a parallel application/core structure. Separate branches cover remembered bridges, domain and exit routing, and an optional Tor→SSTP→VPN Gate chain. The README documents major capabilities not represented by sampled implementation files; those branches use existing enclosing directories, and their internal wiring is not inferred.

Main entry points: [`Android/app/src/main/java/io/deltator/TorVpnService.kt`](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/TorVpnService.kt) (VPN service), [`Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt`](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt) (Transport race), [`Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt`](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt) (SSTP chain), [`Android/app/src/main/java/io/deltator/MainActivity.kt`](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/MainActivity.kt) (Android UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client applications"]
  node_android_ui["Android UI<br/>[MainActivity.kt]"]
  node_android_service["VPN service<br/>[TorVpnService.kt]"]
  node_win_ui["Windows client<br/>[Program.cs]"]
  node_windows_core["Windows core<br/>[DeltaTor.Core]"]
end

subgraph group_tor["Tor connection"]
  node_race["Transport race"]
  node_runner["Tor runners"]
  node_bridge_memory[("Bridge memory")]
  node_tor_settings["Tor configuration"]
end

subgraph group_tunnel["Traffic routing"]
  node_domain_router["Domain routing<br/>[DomainRouter.kt]"]
  node_vpn_tunnel["VPN tunnel"]
  node_socks["SOCKS endpoint"]
  node_dns["Tor DNS"]
  node_exit_country["Exit selection"]
end

subgraph group_chain["Proxy chain"]
  node_chain_manager["Chain manager"]
  node_chain_engine["SSTP chain<br/>[SstpChainEngine.kt]"]
  node_sstp_controller["SSTP negotiation<br/>[Controller.kt]"]
  node_sstp_io["PPP data I/O<br/>[IncomingManager.kt]"]
end

node_user(("User"))
node_network(("Internet"))

node_user -->|"starts connection"| node_android_ui
node_user -->|"starts connection"| node_win_ui
node_android_ui -.->|"requests VPN"| node_android_service
node_android_service -->|"starts race"| node_race
node_race -->|"starts runners"| node_runner
node_race -->|"records winners"| node_bridge_memory
node_runner -->|"opens Tor circuits"| node_network
node_android_service -->|"starts tunnel"| node_vpn_tunnel
node_android_service -->|"probes endpoint"| node_socks
node_android_service -->|"resolves via Tor"| node_dns
node_android_service -.->|"routes domains"| node_domain_router
node_android_service -.->|"sets exit country"| node_exit_country
node_android_service -->|"starts chain"| node_chain_engine
node_chain_manager -.->|"selects server"| node_chain_engine
node_chain_engine -->|"runs session"| node_sstp_controller
node_sstp_controller -->|"dispatches packets"| node_sstp_io
node_sstp_io -.->|"carries traffic"| node_network
node_win_ui -->|"uses core services"| node_windows_core
node_windows_core -.->|"connects through Tor"| node_network

click node_android_ui "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/MainActivity.kt"
click node_android_service "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/TorVpnService.kt"
click node_win_ui "https://github.com/delta-kronecker/delta-tor/blob/main/Windows/src/DeltaTor.App/Program.cs"
click node_race "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt"
click node_runner "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_bridge_memory "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_tor_settings "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_domain_router "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/DomainRouter.kt"
click node_vpn_tunnel "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/cpp/hev-socks5-tunnel-src/src/hev-socks5-tunnel.c"
click node_socks "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_dns "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_exit_country "https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel"
click node_chain_manager "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/ProxyChainManager.kt"
click node_chain_engine "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt"
click node_sstp_controller "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/kittoku/osc/control/Controller.kt"
click node_sstp_io "https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/kittoku/osc/io/incoming/IncomingManager.kt"
click node_windows_core "https://github.com/delta-kronecker/delta-tor/tree/main/Windows/src/DeltaTor.Core"

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_android_ui,node_android_service,node_win_ui,node_windows_core,node_user toneBlue
class node_race,node_runner,node_bridge_memory,node_tor_settings toneAmber
class node_domain_router,node_vpn_tunnel,node_socks,node_dns,node_exit_country toneMint
class node_chain_manager,node_chain_engine,node_sstp_controller,node_sstp_io toneRose
class node_network toneIndigo
```

## Components

### Client applications

- [Android UI](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/MainActivity.kt): `Android/app/src/main/java/io/deltator/MainActivity.kt`
- [VPN service](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/TorVpnService.kt): `Android/app/src/main/java/io/deltator/TorVpnService.kt`
- [Windows client](https://github.com/delta-kronecker/delta-tor/blob/main/Windows/src/DeltaTor.App/Program.cs): `Windows/src/DeltaTor.App/Program.cs`
- [Windows core](https://github.com/delta-kronecker/delta-tor/tree/main/Windows/src/DeltaTor.Core): `Windows/src/DeltaTor.Core`

### Tor connection

- [Transport race](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt): `Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt`
- [Tor runners](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`
- [Bridge memory](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`
- [Tor configuration](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`

### Traffic routing

- [Domain routing](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/DomainRouter.kt): `Android/app/src/main/java/io/deltator/tunnel/DomainRouter.kt`
- [VPN tunnel](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/cpp/hev-socks5-tunnel-src/src/hev-socks5-tunnel.c): `Android/app/src/main/cpp/hev-socks5-tunnel-src/src/hev-socks5-tunnel.c`
- [SOCKS endpoint](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`
- [Tor DNS](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`
- [Exit selection](https://github.com/delta-kronecker/delta-tor/tree/main/Android/app/src/main/java/io/deltator/tunnel): `Android/app/src/main/java/io/deltator/tunnel`

### Proxy chain

- [Chain manager](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/ProxyChainManager.kt): `Android/app/src/main/java/io/deltator/ProxyChainManager.kt`
- [SSTP chain](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt): `Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt`
- [SSTP negotiation](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/kittoku/osc/control/Controller.kt): `Android/app/src/main/java/kittoku/osc/control/Controller.kt`
- [PPP data I/O](https://github.com/delta-kronecker/delta-tor/blob/main/Android/app/src/main/java/kittoku/osc/io/incoming/IncomingManager.kt): `Android/app/src/main/java/kittoku/osc/io/incoming/IncomingManager.kt`

### Other components

- **User**
- **Internet**

## Connections

- User → Android UI: starts connection
- User → Windows client: starts connection
- Android UI → VPN service: requests VPN (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → Transport race: starts race (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- Transport race → Tor runners: starts runners (evidence: `Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt`)
- Transport race → Bridge memory: records winners (evidence: `Android/app/src/main/java/io/deltator/tunnel/ParallelTorManager.kt`)
- Tor runners → Internet: opens Tor circuits
- VPN service → VPN tunnel: starts tunnel (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → SOCKS endpoint: probes endpoint (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → Tor DNS: resolves via Tor (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → Domain routing: routes domains (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → Exit selection: sets exit country (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- VPN service → SSTP chain: starts chain (evidence: `Android/app/src/main/java/io/deltator/TorVpnService.kt`)
- Chain manager → SSTP chain: selects server (evidence: `Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt`)
- SSTP chain → SSTP negotiation: runs session (evidence: `Android/app/src/main/java/io/deltator/tunnel/SstpChainEngine.kt`)
- SSTP negotiation → PPP data I/O: dispatches packets (evidence: `Android/app/src/main/java/kittoku/osc/control/Controller.kt`)
- PPP data I/O → Internet: carries traffic
- Windows client → Windows core: uses core services (evidence: `Windows/src/DeltaTor.App/Program.cs`)
- Windows core → Internet: connects through Tor
