# arcellateam/arcella-broker architecture

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

## Overview

Arcella Broker is an in-process hierarchical message broker for trusted platform components. A client subscribes to an address, then sends a protocol Message whose address selects the recipient; the registry resolves exact or wildcard routes and transport delivers it to a subscriber. InOut requests additionally register a reply waiter and await a correlated response. The graph includes the indexed routing, transport, publisher, subscriber, and reply-dispatch components; some implementation details are unsampled, so undocumented links are omitted.

Main entry points: [`src/client/mod.rs`](https://github.com/arcellateam/arcella-broker/blob/dev/src/client/mod.rs) (Client Facade), [`src/broker_core/registry/mod.rs`](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/mod.rs) (Local Registry), [`src/broker_core/registry/routing.rs`](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/routing.rs) (Route Targets), [`src/protocol/mod.rs`](https://github.com/arcellateam/arcella-broker/blob/dev/src/protocol/mod.rs) (Message Protocol)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Broker API"]
  node_broker["Broker Core<br/>[mod.rs]"]
  node_client["Client Facade<br/>[mod.rs]"]
  node_publisher["Publisher<br/>[publisher.rs]"]
  node_subscriber["Subscriber<br/>[subscriber.rs]"]
  node_reply["Reply Dispatcher"]
end

subgraph group_routing["Address Routing"]
  node_registry[("Local Registry<br/>[mod.rs]")]
  node_route["Route Targets<br/>[routing.rs]"]
  node_slot["Subscription Slots<br/>[slot.rs]"]
  node_balanced["Load-Balanced Group"]
end

subgraph group_delivery["Message Delivery"]
  node_transport["Transport Abstraction<br/>[mod.rs]"]
  node_memory["In-Memory Transport<br/>[in_memory.rs]"]
  node_channel["Message Channels<br/>[channel.rs]"]
end

subgraph group_wire["Protocol and Config"]
  node_protocol["Message Protocol<br/>[mod.rs]"]
  node_config["Broker Config<br/>[mod.rs]"]
end

node_actor(("Trusted Component"))

node_actor -->|"uses"| node_client
node_broker -->|"initializes"| node_registry
node_broker -->|"creates"| node_client
node_broker -->|"uses"| node_config
node_client -->|"registers routes"| node_registry
node_client -->|"creates"| node_subscriber
node_client -->|"registers waiters"| node_reply
node_client -->|"delegates publishing"| node_publisher
node_client -->|"sends messages"| node_memory
node_subscriber -.->|"receives messages"| node_channel
node_registry -->|"resolves targets"| node_route
node_route -->|"dispatches by policy"| node_balanced
node_route -->|"sends via slot"| node_slot
node_balanced -->|"uses shared slot"| node_slot
node_memory -->|"looks up routes"| node_registry
node_transport -->|"resolves endpoints"| node_memory
node_route -->|"uses sender types"| node_transport
node_channel -->|"carries messages"| node_protocol
node_publisher -->|"publishes messages"| node_protocol
node_reply -->|"correlates messages"| node_protocol
node_actor -->|"forms messages"| node_protocol
node_config -->|"selects routing policy"| node_registry

click node_broker "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker/mod.rs"
click node_client "https://github.com/arcellateam/arcella-broker/blob/dev/src/client/mod.rs"
click node_publisher "https://github.com/arcellateam/arcella-broker/blob/dev/src/client/publisher.rs"
click node_subscriber "https://github.com/arcellateam/arcella-broker/blob/dev/src/client/subscriber.rs"
click node_reply "https://github.com/arcellateam/arcella-broker/blob/dev/src/client/reply_dispatcher.rs"
click node_registry "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/mod.rs"
click node_route "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/routing.rs"
click node_slot "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/slot.rs"
click node_balanced "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/load_balanced_group.rs"
click node_transport "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/mod.rs"
click node_memory "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/in_memory.rs"
click node_channel "https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/channel.rs"
click node_protocol "https://github.com/arcellateam/arcella-broker/blob/dev/src/protocol/mod.rs"
click node_config "https://github.com/arcellateam/arcella-broker/blob/dev/src/config/mod.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_broker,node_client,node_publisher,node_subscriber,node_reply toneBlue
class node_registry,node_route,node_slot,node_balanced toneAmber
class node_transport,node_memory,node_channel toneMint
class node_protocol,node_config toneRose
class node_actor toneIndigo
```

## Components

### Broker API

- [Broker Core](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker/mod.rs): `src/broker/mod.rs`
- [Client Facade](https://github.com/arcellateam/arcella-broker/blob/dev/src/client/mod.rs): `src/client/mod.rs`
- [Publisher](https://github.com/arcellateam/arcella-broker/blob/dev/src/client/publisher.rs): `src/client/publisher.rs`
- [Subscriber](https://github.com/arcellateam/arcella-broker/blob/dev/src/client/subscriber.rs): `src/client/subscriber.rs`
- [Reply Dispatcher](https://github.com/arcellateam/arcella-broker/blob/dev/src/client/reply_dispatcher.rs): `src/client/reply_dispatcher.rs`

### Address Routing

- [Local Registry](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/mod.rs): `src/broker_core/registry/mod.rs`
- [Route Targets](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/routing.rs): `src/broker_core/registry/routing.rs`
- [Subscription Slots](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/slot.rs): `src/broker_core/registry/slot.rs`
- [Load-Balanced Group](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/registry/load_balanced_group.rs): `src/broker_core/registry/load_balanced_group.rs`

### Message Delivery

- [Transport Abstraction](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/mod.rs): `src/broker_core/transport/mod.rs`
- [In-Memory Transport](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/in_memory.rs): `src/broker_core/transport/in_memory.rs`
- [Message Channels](https://github.com/arcellateam/arcella-broker/blob/dev/src/broker_core/transport/channel.rs): `src/broker_core/transport/channel.rs`

### Protocol and Config

- [Message Protocol](https://github.com/arcellateam/arcella-broker/blob/dev/src/protocol/mod.rs): `src/protocol/mod.rs`
- [Broker Config](https://github.com/arcellateam/arcella-broker/blob/dev/src/config/mod.rs): `src/config/mod.rs`

### Other components

- **Trusted Component**

## Connections

- Trusted Component → Client Facade: uses (evidence: `README.md`)
- Broker Core → Local Registry: initializes (evidence: `src/broker/mod.rs`)
- Broker Core → Client Facade: creates (evidence: `src/broker/mod.rs`)
- Broker Core → Broker Config: uses (evidence: `src/broker/mod.rs`)
- Client Facade → Local Registry: registers routes (evidence: `src/client/mod.rs`)
- Client Facade → Subscriber: creates (evidence: `src/client/mod.rs`)
- Client Facade → Reply Dispatcher: registers waiters (evidence: `src/client/mod.rs`)
- Client Facade → Publisher: delegates publishing (evidence: `src/client/mod.rs`)
- Client Facade → In-Memory Transport: sends messages (evidence: `src/client/mod.rs`)
- Subscriber → Message Channels: receives messages
- Local Registry → Route Targets: resolves targets (evidence: `src/broker_core/registry/mod.rs`)
- Route Targets → Load-Balanced Group: dispatches by policy (evidence: `src/broker_core/registry/routing.rs`)
- Route Targets → Subscription Slots: sends via slot (evidence: `src/broker_core/registry/routing.rs`)
- Load-Balanced Group → Subscription Slots: uses shared slot (evidence: `src/broker_core/registry/load_balanced_group.rs`)
- In-Memory Transport → Local Registry: looks up routes (evidence: `src/broker_core/transport/in_memory.rs`)
- Transport Abstraction → In-Memory Transport: resolves endpoints (evidence: `src/broker_core/transport/mod.rs`)
- Route Targets → Transport Abstraction: uses sender types (evidence: `src/broker_core/registry/routing.rs`)
- Message Channels → Message Protocol: carries messages (evidence: `src/broker_core/transport/channel.rs`)
- Publisher → Message Protocol: publishes messages (evidence: `src/client/publisher.rs`)
- Reply Dispatcher → Message Protocol: correlates messages (evidence: `src/client/reply_dispatcher.rs`)
- Trusted Component → Message Protocol: forms messages (evidence: `README.md`)
- Broker Config → Local Registry: selects routing policy (evidence: `src/config/mod.rs`)
