How ceramicnetwork/rust-ceramic works
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: evm_transaction_manager.rs EVM transaction manager · session.rs Bitswap client · daemon.rs ceramic-one daemon · mod.rs Kubo RPC server
Components 28
Daemon and APIs
- ceramic-one daemon
one/src/daemon.rs - Kubo RPC server
kubo-rpc-server/src/server/mod.rs - Kubo RPC API
kubo-rpc/src/http.rs - Ceramic API
api/src/server.rs - API server
api-server/src/server/mod.rs - API request models
api-server/src/models.rs
Events and identity
- Event types
event/src/unvalidated/event.rs - Event identifiers
core/src/event_id.rs - Event validation
validation/src/verifier/event_verifier.rs
Ceramic services
- Event service
event-svc/src/event/service.rs - Event SQL store
event-svc/src/store/sql/query.rs - Interest service
interest-svc/src/interest/service.rs - Peer service
peer-svc/src/service.rs
Data pipeline
- Event aggregator
pipeline/src/aggregator/mod.rs - Conclusion processing
pipeline/src/concluder/mod.rs - Stream resolver
pipeline/src/resolver/mod.rs - Pipeline schemas
pipeline/src/schemas.rs - Flight SQL server
flight/src/server.rs
Networking and blocks
- Bitswap client
beetle/iroh-bitswap/src/client/session.rs - Bitswap peer manager
beetle/iroh-bitswap/src/client/peer_manager.rs - Peer message queue
beetle/iroh-bitswap/src/client/message_queue.rs - Bitswap network
beetle/iroh-bitswap/src/network.rs - Block representation
beetle/iroh-bitswap/src/block.rs
Anchoring
- Anchor service
anchor-service/src/anchor.rs - EVM transaction manager
anchor-evm/src/evm_transaction_manager.rs - Anchor proof builder
anchor-evm/src/proof_builder.rs
Other components
- Node operator
- EVM blockchain
Connections 14
- Node operator → ceramic-one daemon: runs
README.md - ceramic-one daemon → Kubo RPC server: mimics API
README.md - Kubo RPC server → Kubo RPC API: serves RPC
- API server → API request models: uses models
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
beetle/iroh-bitswap/src/client/peer_manager.rs - Bitswap client → Bitswap peer manager: uses peers
beetle/iroh-bitswap/src/client/session.rs - Bitswap client → Bitswap network: sends messages
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
anchor-evm/src/evm_transaction_manager.rs - EVM transaction manager → Anchor proof builder: builds proof
anchor-evm/src/evm_transaction_manager.rs