# ceramicnetwork/rust-ceramic architecture

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

- Interactive diagram: https://gitdiagram.com/ceramicnetwork/rust-ceramic
- Repository: https://github.com/ceramicnetwork/rust-ceramic

## Overview

Rust Ceramic is a multi-crate implementation of the Ceramic protocol. The documented operational workflow is to run `ceramic-one daemon`, which currently mimics the Kubo RPC API; the README says remaining Ceramic logic still relies on js-ceramic. The workspace also contains Rust event, storage, pipeline, networking, and anchoring subsystems, including optional EVM self-anchoring. The graph preserves these capabilities, but only draws relationships supported by the README or SOURCE INDEX references; unsampled code limits confidence in runtime wiring.

Main entry points: [`anchor-evm/src/evm_transaction_manager.rs`](https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-evm/src/evm_transaction_manager.rs) (EVM transaction manager), [`beetle/iroh-bitswap/src/client/session.rs`](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/session.rs) (Bitswap client), [`one/src/daemon.rs`](https://github.com/ceramicnetwork/rust-ceramic/blob/main/one/src/daemon.rs) (ceramic-one daemon), [`kubo-rpc-server/src/server/mod.rs`](https://github.com/ceramicnetwork/rust-ceramic/blob/main/kubo-rpc-server/src/server/mod.rs) (Kubo RPC server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Daemon and APIs"]
  node_daemon["ceramic-one daemon<br/>[daemon.rs]"]
  node_kubo_server["Kubo RPC server<br/>[mod.rs]"]
  node_kubo_api["Kubo RPC API<br/>[http.rs]"]
  node_ceramic_api["Ceramic API<br/>[server.rs]"]
  node_api_server["API server<br/>[mod.rs]"]
  node_api_models["API request models<br/>[models.rs]"]
end

subgraph group_protocol["Events and identity"]
  node_event_types["Event types<br/>[event.rs]"]
  node_event_identity["Event identifiers<br/>[event_id.rs]"]
  node_validation["Event validation<br/>[event_verifier.rs]"]
end

subgraph group_services["Ceramic services"]
  node_event_service["Event service<br/>[service.rs]"]
  node_event_store[("Event SQL store<br/>[query.rs]")]
  node_interest_service["Interest service<br/>[service.rs]"]
  node_peer_service["Peer service<br/>[service.rs]"]
end

subgraph group_data["Data pipeline"]
  node_pipeline_aggregator["Event aggregator<br/>[mod.rs]"]
  node_pipeline_concluder["Conclusion processing<br/>[mod.rs]"]
  node_pipeline_resolver["Stream resolver<br/>[mod.rs]"]
  node_pipeline_schemas["Pipeline schemas<br/>[schemas.rs]"]
  node_flight_server["Flight SQL server<br/>[server.rs]"]
end

subgraph group_network["Networking and blocks"]
  node_bitswap_client["Bitswap client<br/>[session.rs]"]
  node_peer_manager["Bitswap peer manager<br/>[peer_manager.rs]"]
  node_message_queue["Peer message queue<br/>[message_queue.rs]"]
  node_bitswap_network["Bitswap network<br/>[network.rs]"]
  node_block["Block representation<br/>[block.rs]"]
end

subgraph group_anchor["Anchoring"]
  node_anchor_service["Anchor service<br/>[anchor.rs]"]
  node_anchor_tx["EVM transaction manager"]
  node_proof_builder["Anchor proof builder<br/>[proof_builder.rs]"]
end

node_operator(("Node operator"))
node_evm_chain(("EVM blockchain"))

node_operator -->|"runs"| node_daemon
node_daemon -->|"mimics API"| node_kubo_server
node_kubo_server -.->|"serves RPC"| node_kubo_api
node_api_server -->|"uses models"| node_api_models
node_pipeline_aggregator -.->|"coordinates"| node_pipeline_concluder
node_pipeline_resolver -.->|"uses schemas"| node_pipeline_schemas
node_flight_server -.->|"exposes tables"| node_pipeline_schemas
node_peer_manager -->|"manages queues"| node_message_queue
node_bitswap_client -->|"uses peers"| node_peer_manager
node_bitswap_client -->|"sends messages"| node_bitswap_network
node_bitswap_network -.->|"transfers blocks"| node_block
node_anchor_service -.->|"requests anchoring"| node_anchor_tx
node_anchor_tx -->|"submits transaction"| node_evm_chain
node_anchor_tx -->|"builds proof"| node_proof_builder

click node_daemon "https://github.com/ceramicnetwork/rust-ceramic/blob/main/one/src/daemon.rs"
click node_kubo_server "https://github.com/ceramicnetwork/rust-ceramic/blob/main/kubo-rpc-server/src/server/mod.rs"
click node_kubo_api "https://github.com/ceramicnetwork/rust-ceramic/blob/main/kubo-rpc/src/http.rs"
click node_ceramic_api "https://github.com/ceramicnetwork/rust-ceramic/blob/main/api/src/server.rs"
click node_api_server "https://github.com/ceramicnetwork/rust-ceramic/blob/main/api-server/src/server/mod.rs"
click node_api_models "https://github.com/ceramicnetwork/rust-ceramic/blob/main/api-server/src/models.rs"
click node_event_types "https://github.com/ceramicnetwork/rust-ceramic/blob/main/event/src/unvalidated/event.rs"
click node_event_identity "https://github.com/ceramicnetwork/rust-ceramic/blob/main/core/src/event_id.rs"
click node_validation "https://github.com/ceramicnetwork/rust-ceramic/blob/main/validation/src/verifier/event_verifier.rs"
click node_event_service "https://github.com/ceramicnetwork/rust-ceramic/blob/main/event-svc/src/event/service.rs"
click node_event_store "https://github.com/ceramicnetwork/rust-ceramic/blob/main/event-svc/src/store/sql/query.rs"
click node_interest_service "https://github.com/ceramicnetwork/rust-ceramic/blob/main/interest-svc/src/interest/service.rs"
click node_peer_service "https://github.com/ceramicnetwork/rust-ceramic/blob/main/peer-svc/src/service.rs"
click node_pipeline_aggregator "https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/aggregator/mod.rs"
click node_pipeline_concluder "https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/concluder/mod.rs"
click node_pipeline_resolver "https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/resolver/mod.rs"
click node_pipeline_schemas "https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/schemas.rs"
click node_flight_server "https://github.com/ceramicnetwork/rust-ceramic/blob/main/flight/src/server.rs"
click node_bitswap_client "https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/session.rs"
click node_peer_manager "https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/peer_manager.rs"
click node_message_queue "https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/message_queue.rs"
click node_bitswap_network "https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/network.rs"
click node_block "https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/block.rs"
click node_anchor_service "https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-service/src/anchor.rs"
click node_anchor_tx "https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-evm/src/evm_transaction_manager.rs"
click node_proof_builder "https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-evm/src/proof_builder.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_daemon,node_kubo_server,node_kubo_api,node_ceramic_api,node_api_server,node_api_models toneBlue
class node_event_types,node_event_identity,node_validation toneAmber
class node_event_service,node_event_store,node_interest_service,node_peer_service toneMint
class node_pipeline_aggregator,node_pipeline_concluder,node_pipeline_resolver,node_pipeline_schemas,node_flight_server toneRose
class node_bitswap_client,node_peer_manager,node_message_queue,node_bitswap_network,node_block,node_operator,node_evm_chain toneIndigo
class node_anchor_service,node_anchor_tx,node_proof_builder toneTeal
```

## Components

### Daemon and APIs

- [ceramic-one daemon](https://github.com/ceramicnetwork/rust-ceramic/blob/main/one/src/daemon.rs): `one/src/daemon.rs`
- [Kubo RPC server](https://github.com/ceramicnetwork/rust-ceramic/blob/main/kubo-rpc-server/src/server/mod.rs): `kubo-rpc-server/src/server/mod.rs`
- [Kubo RPC API](https://github.com/ceramicnetwork/rust-ceramic/blob/main/kubo-rpc/src/http.rs): `kubo-rpc/src/http.rs`
- [Ceramic API](https://github.com/ceramicnetwork/rust-ceramic/blob/main/api/src/server.rs): `api/src/server.rs`
- [API server](https://github.com/ceramicnetwork/rust-ceramic/blob/main/api-server/src/server/mod.rs): `api-server/src/server/mod.rs`
- [API request models](https://github.com/ceramicnetwork/rust-ceramic/blob/main/api-server/src/models.rs): `api-server/src/models.rs`

### Events and identity

- [Event types](https://github.com/ceramicnetwork/rust-ceramic/blob/main/event/src/unvalidated/event.rs): `event/src/unvalidated/event.rs`
- [Event identifiers](https://github.com/ceramicnetwork/rust-ceramic/blob/main/core/src/event_id.rs): `core/src/event_id.rs`
- [Event validation](https://github.com/ceramicnetwork/rust-ceramic/blob/main/validation/src/verifier/event_verifier.rs): `validation/src/verifier/event_verifier.rs`

### Ceramic services

- [Event service](https://github.com/ceramicnetwork/rust-ceramic/blob/main/event-svc/src/event/service.rs): `event-svc/src/event/service.rs`
- [Event SQL store](https://github.com/ceramicnetwork/rust-ceramic/blob/main/event-svc/src/store/sql/query.rs): `event-svc/src/store/sql/query.rs`
- [Interest service](https://github.com/ceramicnetwork/rust-ceramic/blob/main/interest-svc/src/interest/service.rs): `interest-svc/src/interest/service.rs`
- [Peer service](https://github.com/ceramicnetwork/rust-ceramic/blob/main/peer-svc/src/service.rs): `peer-svc/src/service.rs`

### Data pipeline

- [Event aggregator](https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/aggregator/mod.rs): `pipeline/src/aggregator/mod.rs`
- [Conclusion processing](https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/concluder/mod.rs): `pipeline/src/concluder/mod.rs`
- [Stream resolver](https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/resolver/mod.rs): `pipeline/src/resolver/mod.rs`
- [Pipeline schemas](https://github.com/ceramicnetwork/rust-ceramic/blob/main/pipeline/src/schemas.rs): `pipeline/src/schemas.rs`
- [Flight SQL server](https://github.com/ceramicnetwork/rust-ceramic/blob/main/flight/src/server.rs): `flight/src/server.rs`

### Networking and blocks

- [Bitswap client](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/session.rs): `beetle/iroh-bitswap/src/client/session.rs`
- [Bitswap peer manager](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/peer_manager.rs): `beetle/iroh-bitswap/src/client/peer_manager.rs`
- [Peer message queue](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/client/message_queue.rs): `beetle/iroh-bitswap/src/client/message_queue.rs`
- [Bitswap network](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/network.rs): `beetle/iroh-bitswap/src/network.rs`
- [Block representation](https://github.com/ceramicnetwork/rust-ceramic/blob/main/beetle/iroh-bitswap/src/block.rs): `beetle/iroh-bitswap/src/block.rs`

### Anchoring

- [Anchor service](https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-service/src/anchor.rs): `anchor-service/src/anchor.rs`
- [EVM transaction manager](https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-evm/src/evm_transaction_manager.rs): `anchor-evm/src/evm_transaction_manager.rs`
- [Anchor proof builder](https://github.com/ceramicnetwork/rust-ceramic/blob/main/anchor-evm/src/proof_builder.rs): `anchor-evm/src/proof_builder.rs`

### Other components

- **Node operator**
- **EVM blockchain**

## Connections

- Node operator → ceramic-one daemon: runs (evidence: `README.md`)
- ceramic-one daemon → Kubo RPC server: mimics API (evidence: `README.md`)
- Kubo RPC server → Kubo RPC API: serves RPC
- API server → API request models: uses models (evidence: `api-server/src/lib.rs`)
- Event aggregator → Conclusion processing: coordinates
- Stream resolver → Pipeline schemas: uses schemas
- Flight SQL server → Pipeline schemas: exposes tables
- Bitswap peer manager → Peer message queue: manages queues (evidence: `beetle/iroh-bitswap/src/client/peer_manager.rs`)
- Bitswap client → Bitswap peer manager: uses peers (evidence: `beetle/iroh-bitswap/src/client/session.rs`)
- Bitswap client → Bitswap network: sends messages (evidence: `beetle/iroh-bitswap/src/client/session.rs`)
- Bitswap network → Block representation: transfers blocks
- Anchor service → EVM transaction manager: requests anchoring
- EVM transaction manager → EVM blockchain: submits transaction (evidence: `anchor-evm/src/evm_transaction_manager.rs`)
- EVM transaction manager → Anchor proof builder: builds proof (evidence: `anchor-evm/src/evm_transaction_manager.rs`)
