# electkismet/eltdx architecture

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

## Overview

eltdx is a Python-facing TDX market-data client with a Rust protocol and connection runtime. The principal flow is a caller using TdxClient’s modular APIs to request market data; requests are encoded and sent through the native transport, then decoded into Python-facing results. The README also documents helpers, F10 data, MCP tools, and an HTTP/WebSocket gateway. Several domain APIs and gateway internals were not sampled, so those branches are represented at their supported directory paths; edges are limited to documented or indexed relationships.

Main entry points: [`src/eltdx/client.py`](https://github.com/electkismet/eltdx/blob/main/src/eltdx/client.py) (TdxClient), [`crates/eltdx-runtime/src/engine.rs`](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/engine.rs) (Runtime engine), [`src/eltdx/transport/pool.py`](https://github.com/electkismet/eltdx/blob/main/src/eltdx/transport/pool.py) (Transport pool), [`src/eltdx/api`](https://github.com/electkismet/eltdx/tree/main/src/eltdx/api) (Modular APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Python API"]
  node_client["TdxClient<br/>[client.py]"]
  node_apis["Modular APIs"]
  node_transport["Transport pool<br/>[pool.py]"]
  node_host_discovery["Host discovery<br/>[hosts.py]"]
end

subgraph group_domain["Data Capabilities"]
  node_helpers["Research helpers"]
  node_f10["F10 client<br/>[client.py]"]
  node_models["Result models"]
end

subgraph group_wire["Protocol"]
  node_protocol["7709 command codecs"]
  node_request_frame["Request framing<br/>[request.rs]"]
  node_frame["Frame codec<br/>[frame.rs]"]
  node_unit["Protocol primitives<br/>[unit.rs]"]
end

subgraph group_runtime["Rust Runtime"]
  node_native["Python native bridge<br/>[transport.rs]"]
  node_request_bridge["Request conversion<br/>[request.rs]"]
  node_response_bridge["Response conversion<br/>[response.rs]"]
  node_engine["Runtime engine<br/>[engine.rs]"]
  node_supervisor["Request supervisor<br/>[supervisor.rs]"]
  node_request_lifecycle["Request lifecycle<br/>[request.rs]"]
  node_slots["Connection slots<br/>[slot.rs]"]
  node_pins["Pinned calls<br/>[pin.rs]"]
  node_push["Push queue<br/>[push.rs]"]
  node_endpoint["Endpoint selection<br/>[endpoint.rs]"]
end

subgraph group_integration["Integrations"]
  node_mcp["MCP tools<br/>[mcp.py]"]
  node_gateway["HTTP/WebSocket gateway<br/>[http_server.py]"]
end

node_caller(("Python caller"))
node_market_server(("TDX servers"))

node_caller -->|"uses"| node_client
node_client -->|"exposes"| node_apis
node_client -->|"configures"| node_transport
node_client -->|"exposes"| node_helpers
node_client -->|"exposes"| node_f10
node_apis -->|"requests data"| node_protocol
node_apis -->|"returns models"| node_models
node_helpers -->|"combines calls"| node_apis
node_helpers -->|"composes results"| node_models
node_f10 -->|"fetches F10"| node_market_server
node_mcp -->|"uses"| node_client
node_gateway -->|"serves API"| node_client
node_transport -->|"uses hosts"| node_host_discovery
node_transport -->|"dispatches"| node_native
node_transport -->|"connects"| node_market_server
node_native -->|"encodes requests"| node_request_bridge
node_native -->|"converts responses"| node_response_bridge
node_request_bridge -->|"builds commands"| node_protocol
node_response_bridge -->|"provides DTOs"| node_models
node_engine -->|"coordinates"| node_supervisor
node_engine -->|"manages requests"| node_request_lifecycle
node_engine -->|"manages slots"| node_slots
node_engine -->|"manages pins"| node_pins
node_engine -->|"manages push"| node_push
node_engine -->|"selects endpoints"| node_endpoint
node_request_lifecycle -->|"leases pinned calls"| node_pins
node_slots -->|"decodes frames"| node_frame
node_protocol -->|"uses primitives"| node_unit
node_request_frame -->|"frames requests"| node_frame
node_frame -->|"reads fields"| node_unit

click node_client "https://github.com/electkismet/eltdx/blob/main/src/eltdx/client.py"
click node_apis "https://github.com/electkismet/eltdx/tree/main/src/eltdx/api"
click node_helpers "https://github.com/electkismet/eltdx/tree/main/src/eltdx/helpers"
click node_f10 "https://github.com/electkismet/eltdx/blob/main/src/eltdx/f10/client.py"
click node_models "https://github.com/electkismet/eltdx/tree/main/src/eltdx/models"
click node_mcp "https://github.com/electkismet/eltdx/blob/main/src/eltdx/mcp.py"
click node_gateway "https://github.com/electkismet/eltdx/blob/main/src/eltdx/http_server.py"
click node_transport "https://github.com/electkismet/eltdx/blob/main/src/eltdx/transport/pool.py"
click node_host_discovery "https://github.com/electkismet/eltdx/blob/main/src/eltdx/hosts.py"
click node_native "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/transport.rs"
click node_request_bridge "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/request.rs"
click node_response_bridge "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/response.rs"
click node_engine "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/engine.rs"
click node_supervisor "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/supervisor.rs"
click node_request_lifecycle "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/request.rs"
click node_slots "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/slot.rs"
click node_pins "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/pin.rs"
click node_push "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/push.rs"
click node_endpoint "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/endpoint.rs"
click node_protocol "https://github.com/electkismet/eltdx/tree/main/crates/eltdx-protocol/src/commands"
click node_request_frame "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/request.rs"
click node_frame "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/frame.rs"
click node_unit "https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/unit.rs"

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_client,node_apis,node_transport,node_host_discovery toneBlue
class node_helpers,node_f10,node_models toneAmber
class node_protocol,node_request_frame,node_frame,node_unit,node_market_server toneMint
class node_native,node_request_bridge,node_response_bridge,node_engine,node_supervisor,node_request_lifecycle,node_slots,node_pins,node_push,node_endpoint toneRose
class node_mcp,node_gateway,node_caller toneIndigo
```

## Components

### Python API

- [TdxClient](https://github.com/electkismet/eltdx/blob/main/src/eltdx/client.py): `src/eltdx/client.py`
- [Modular APIs](https://github.com/electkismet/eltdx/tree/main/src/eltdx/api): `src/eltdx/api`
- [Transport pool](https://github.com/electkismet/eltdx/blob/main/src/eltdx/transport/pool.py): `src/eltdx/transport/pool.py`
- [Host discovery](https://github.com/electkismet/eltdx/blob/main/src/eltdx/hosts.py): `src/eltdx/hosts.py`

### Data Capabilities

- [Research helpers](https://github.com/electkismet/eltdx/tree/main/src/eltdx/helpers): `src/eltdx/helpers`
- [F10 client](https://github.com/electkismet/eltdx/blob/main/src/eltdx/f10/client.py): `src/eltdx/f10/client.py`
- [Result models](https://github.com/electkismet/eltdx/tree/main/src/eltdx/models): `src/eltdx/models`

### Protocol

- [7709 command codecs](https://github.com/electkismet/eltdx/tree/main/crates/eltdx-protocol/src/commands): `crates/eltdx-protocol/src/commands`
- [Request framing](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/request.rs): `crates/eltdx-protocol/src/request.rs`
- [Frame codec](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/frame.rs): `crates/eltdx-protocol/src/frame.rs`
- [Protocol primitives](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-protocol/src/unit.rs): `crates/eltdx-protocol/src/unit.rs`

### Rust Runtime

- [Python native bridge](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/transport.rs): `crates/eltdx-python/src/transport.rs`
- [Request conversion](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/request.rs): `crates/eltdx-python/src/request.rs`
- [Response conversion](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-python/src/response.rs): `crates/eltdx-python/src/response.rs`
- [Runtime engine](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/engine.rs): `crates/eltdx-runtime/src/engine.rs`
- [Request supervisor](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/supervisor.rs): `crates/eltdx-runtime/src/supervisor.rs`
- [Request lifecycle](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/request.rs): `crates/eltdx-runtime/src/request.rs`
- [Connection slots](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/slot.rs): `crates/eltdx-runtime/src/slot.rs`
- [Pinned calls](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/pin.rs): `crates/eltdx-runtime/src/pin.rs`
- [Push queue](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/push.rs): `crates/eltdx-runtime/src/push.rs`
- [Endpoint selection](https://github.com/electkismet/eltdx/blob/main/crates/eltdx-runtime/src/endpoint.rs): `crates/eltdx-runtime/src/endpoint.rs`

### Integrations

- [MCP tools](https://github.com/electkismet/eltdx/blob/main/src/eltdx/mcp.py): `src/eltdx/mcp.py`
- [HTTP/WebSocket gateway](https://github.com/electkismet/eltdx/blob/main/src/eltdx/http_server.py): `src/eltdx/http_server.py`

### Other components

- **Python caller**
- **TDX servers**

## Connections

- Python caller → TdxClient: uses
- TdxClient → Modular APIs: exposes (evidence: `src/eltdx/client.py`)
- TdxClient → Transport pool: configures (evidence: `src/eltdx/client.py`)
- TdxClient → Research helpers: exposes (evidence: `src/eltdx/client.py`)
- TdxClient → F10 client: exposes (evidence: `src/eltdx/client.py`)
- Modular APIs → 7709 command codecs: requests data
- Modular APIs → Result models: returns models (evidence: `src/eltdx/api/trades.py`)
- Research helpers → Modular APIs: combines calls (evidence: `src/eltdx/helpers/core.py`)
- Research helpers → Result models: composes results (evidence: `src/eltdx/helpers/core.py`)
- F10 client → TDX servers: fetches F10
- MCP tools → TdxClient: uses (evidence: `src/eltdx/mcp.py`)
- HTTP/WebSocket gateway → TdxClient: serves API
- Transport pool → Host discovery: uses hosts (evidence: `src/eltdx/transport/pool.py`)
- Transport pool → Python native bridge: dispatches (evidence: `src/eltdx/transport/pool.py`)
- Transport pool → TDX servers: connects
- Python native bridge → Request conversion: encodes requests (evidence: `crates/eltdx-python/src/lib.rs`)
- Python native bridge → Response conversion: converts responses (evidence: `crates/eltdx-python/src/lib.rs`)
- Request conversion → 7709 command codecs: builds commands (evidence: `crates/eltdx-python/src/request.rs`)
- Response conversion → Result models: provides DTOs (evidence: `crates/eltdx-python/src/response.rs`)
- Runtime engine → Request supervisor: coordinates (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Runtime engine → Request lifecycle: manages requests (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Runtime engine → Connection slots: manages slots (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Runtime engine → Pinned calls: manages pins (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Runtime engine → Push queue: manages push (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Runtime engine → Endpoint selection: selects endpoints (evidence: `crates/eltdx-runtime/src/engine.rs`)
- Request lifecycle → Pinned calls: leases pinned calls (evidence: `crates/eltdx-runtime/src/request.rs`)
- Connection slots → Frame codec: decodes frames (evidence: `crates/eltdx-runtime/src/slot.rs`)
- 7709 command codecs → Protocol primitives: uses primitives (evidence: `crates/eltdx-protocol/src/commands/quotes.rs`)
- Request framing → Frame codec: frames requests (evidence: `crates/eltdx-protocol/src/request.rs`)
- Frame codec → Protocol primitives: reads fields (evidence: `crates/eltdx-protocol/src/frame.rs`)
