# y0selin/jumpernet architecture

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

- Interactive diagram: https://gitdiagram.com/y0selin/jumpernet
- Repository: https://github.com/y0selin/jumpernet

## Overview

JumperNET is a three-hop anonymity network with a React control panel, account/circuit management API, authenticated browser-proxy entry points, and relay nodes. The documented user journey is: create an account, enable or rotate a circuit, then route browser traffic through it to an allowed internet destination. The map also includes peer exits and browser integrations. Some service links are documented only at a high level; where source excerpts do not show a call, those links are dashed and unevidenced.

Main entry points: [`web/src/App.jsx`](https://github.com/y0selin/jumpernet/blob/dev/web/src/App.jsx) (Panel application), [`servicios/entrada-http/entrada_http.py`](https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada-http/entrada_http.py) (HTTP proxy entry), [`servicios/entrada/entrada.py`](https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada/entrada.py) (SOCKS5 entry), [`servicios/nodo/nodo.py`](https://github.com/y0selin/jumpernet/blob/dev/servicios/nodo/nodo.py) (Relay nodes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Web panel"]
  node_app["Panel application<br/>[App.jsx]"]
  node_public["Public pages<br/>[Inicio.jsx]"]
  node_network_ui["Network controls<br/>[Red.jsx]"]
  node_node_ui["Node management<br/>[Nodos.jsx]"]
  node_account_ui["Account management<br/>[Cuenta.jsx]"]
  node_theme_ui["Theme settings<br/>[Ajustes.jsx]"]
  node_web_api["API client<br/>[api.js]"]
end

subgraph group_control["Management plane"]
  node_management_api["Management API<br/>[main.py]"]
  node_broker["Circuit broker<br/>[broker.py]"]
end

subgraph group_traffic["Proxy traffic"]
  node_socks_entry["SOCKS5 entry<br/>[entrada.py]"]
  node_http_entry["HTTP proxy entry<br/>[entrada_http.py]"]
  node_hop["Relay nodes<br/>[nodo.py]"]
  node_cipher["JENC encryption<br/>[cifra.py]"]
end

subgraph group_peers["Peer integrations"]
  node_peer_agent["Peer exit agent<br/>[agente_salida.py]"]
  node_peer_crypto["Pure crypto fallback<br/>[_chacha_puro.py]"]
  node_local_relay["Local SOCKS relay<br/>[rele_socks.py]"]
  node_extension["Browser extension<br/>[background.js]"]
end

node_user(("User"))
node_browser(("Browser"))
node_internet(("Internet destination"))

node_user -->|"uses panel"| node_app
node_app -->|"routes pages"| node_public
node_app -->|"renders controls"| node_network_ui
node_app -->|"renders nodes"| node_node_ui
node_app -->|"renders account"| node_account_ui
node_network_ui -->|"requests circuits"| node_web_api
node_node_ui -->|"requests nodes"| node_web_api
node_account_ui -->|"requests account"| node_web_api
node_theme_ui -->|"configures appearance"| node_app
node_web_api -->|"calls HTTPS API"| node_management_api
node_management_api -.->|"coordinates circuits"| node_broker
node_user -->|"browses through"| node_browser
node_browser -->|"SOCKS5 traffic"| node_socks_entry
node_browser -->|"HTTP proxy traffic"| node_http_entry
node_extension -->|"authenticates proxy"| node_http_entry
node_local_relay -->|"relays SOCKS5"| node_socks_entry
node_socks_entry -->|"forwards circuit"| node_hop
node_http_entry -->|"opens peer tunnel"| node_broker
node_http_entry -->|"forwards circuit"| node_hop
node_socks_entry -.->|"encrypts stream"| node_cipher
node_http_entry -->|"encrypts stream"| node_cipher
node_hop -.->|"decrypts at exit"| node_cipher
node_hop -->|"exits to destination"| node_internet
node_peer_agent -->|"connects outbound"| node_broker
node_peer_agent -->|"uses fallback cipher"| node_peer_crypto
node_broker -.->|"dispatches peer traffic"| node_peer_agent

click node_app "https://github.com/y0selin/jumpernet/blob/dev/web/src/App.jsx"
click node_public "https://github.com/y0selin/jumpernet/blob/dev/web/src/pages/Inicio.jsx"
click node_network_ui "https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Red.jsx"
click node_node_ui "https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Nodos.jsx"
click node_account_ui "https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Cuenta.jsx"
click node_theme_ui "https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Ajustes.jsx"
click node_web_api "https://github.com/y0selin/jumpernet/blob/dev/web/src/lib/api.js"
click node_management_api "https://github.com/y0selin/jumpernet/blob/dev/servicios/api/main.py"
click node_broker "https://github.com/y0selin/jumpernet/blob/dev/servicios/broker/broker.py"
click node_socks_entry "https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada/entrada.py"
click node_http_entry "https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada-http/entrada_http.py"
click node_hop "https://github.com/y0selin/jumpernet/blob/dev/servicios/nodo/nodo.py"
click node_cipher "https://github.com/y0selin/jumpernet/blob/dev/servicios/_comun/cifra.py"
click node_peer_agent "https://github.com/y0selin/jumpernet/blob/dev/agente/agente_salida.py"
click node_peer_crypto "https://github.com/y0selin/jumpernet/blob/dev/agente/_chacha_puro.py"
click node_local_relay "https://github.com/y0selin/jumpernet/blob/dev/cliente/rele_socks.py"
click node_extension "https://github.com/y0selin/jumpernet/blob/dev/web/extension/background.js"

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_app,node_public,node_network_ui,node_node_ui,node_account_ui,node_theme_ui,node_web_api,node_user,node_browser toneBlue
class node_management_api,node_broker toneAmber
class node_socks_entry,node_http_entry,node_hop,node_cipher toneMint
class node_peer_agent,node_peer_crypto,node_local_relay,node_extension toneRose
class node_internet toneIndigo
```

## Components

### Web panel

- [Panel application](https://github.com/y0selin/jumpernet/blob/dev/web/src/App.jsx): `web/src/App.jsx`
- [Public pages](https://github.com/y0selin/jumpernet/blob/dev/web/src/pages/Inicio.jsx): `web/src/pages/Inicio.jsx`
- [Network controls](https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Red.jsx): `web/src/components/Red.jsx`
- [Node management](https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Nodos.jsx): `web/src/components/Nodos.jsx`
- [Account management](https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Cuenta.jsx): `web/src/components/Cuenta.jsx`
- [Theme settings](https://github.com/y0selin/jumpernet/blob/dev/web/src/components/Ajustes.jsx): `web/src/components/Ajustes.jsx`
- [API client](https://github.com/y0selin/jumpernet/blob/dev/web/src/lib/api.js): `web/src/lib/api.js`

### Management plane

- [Management API](https://github.com/y0selin/jumpernet/blob/dev/servicios/api/main.py): `servicios/api/main.py`
- [Circuit broker](https://github.com/y0selin/jumpernet/blob/dev/servicios/broker/broker.py): `servicios/broker/broker.py`

### Proxy traffic

- [SOCKS5 entry](https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada/entrada.py): `servicios/entrada/entrada.py`
- [HTTP proxy entry](https://github.com/y0selin/jumpernet/blob/dev/servicios/entrada-http/entrada_http.py): `servicios/entrada-http/entrada_http.py`
- [Relay nodes](https://github.com/y0selin/jumpernet/blob/dev/servicios/nodo/nodo.py): `servicios/nodo/nodo.py`
- [JENC encryption](https://github.com/y0selin/jumpernet/blob/dev/servicios/_comun/cifra.py): `servicios/_comun/cifra.py`

### Peer integrations

- [Peer exit agent](https://github.com/y0selin/jumpernet/blob/dev/agente/agente_salida.py): `agente/agente_salida.py`
- [Pure crypto fallback](https://github.com/y0selin/jumpernet/blob/dev/agente/_chacha_puro.py): `agente/_chacha_puro.py`
- [Local SOCKS relay](https://github.com/y0selin/jumpernet/blob/dev/cliente/rele_socks.py): `cliente/rele_socks.py`
- [Browser extension](https://github.com/y0selin/jumpernet/blob/dev/web/extension/background.js): `web/extension/background.js`

### Other components

- **User**
- **Browser**
- **Internet destination**

## Connections

- User → Panel application: uses panel
- Panel application → Public pages: routes pages (evidence: `web/src/App.jsx`)
- Panel application → Network controls: renders controls (evidence: `web/src/App.jsx`)
- Panel application → Node management: renders nodes (evidence: `web/src/App.jsx`)
- Panel application → Account management: renders account (evidence: `web/src/App.jsx`)
- Network controls → API client: requests circuits (evidence: `web/src/components/Red.jsx`)
- Node management → API client: requests nodes (evidence: `web/src/components/Nodos.jsx`)
- Account management → API client: requests account (evidence: `web/src/components/Cuenta.jsx`)
- Theme settings → Panel application: configures appearance (evidence: `web/src/App.jsx`)
- API client → Management API: calls HTTPS API (evidence: `web/src/lib/api.js`)
- Management API → Circuit broker: coordinates circuits
- User → Browser: browses through
- Browser → SOCKS5 entry: SOCKS5 traffic
- Browser → HTTP proxy entry: HTTP proxy traffic
- Browser extension → HTTP proxy entry: authenticates proxy
- Local SOCKS relay → SOCKS5 entry: relays SOCKS5
- SOCKS5 entry → Relay nodes: forwards circuit
- HTTP proxy entry → Circuit broker: opens peer tunnel (evidence: `servicios/entrada-http/entrada_http.py`)
- HTTP proxy entry → Relay nodes: forwards circuit (evidence: `servicios/entrada-http/entrada_http.py`)
- SOCKS5 entry → JENC encryption: encrypts stream (evidence: `servicios/entrada/entrada.py`)
- HTTP proxy entry → JENC encryption: encrypts stream (evidence: `servicios/entrada-http/entrada_http.py`)
- Relay nodes → JENC encryption: decrypts at exit (evidence: `servicios/nodo/nodo.py`)
- Relay nodes → Internet destination: exits to destination
- Peer exit agent → Circuit broker: connects outbound (evidence: `agente/agente_salida.py`)
- Peer exit agent → Pure crypto fallback: uses fallback cipher (evidence: `agente/agente_salida.py`)
- Circuit broker → Peer exit agent: dispatches peer traffic
