Expand description
Raft consensus infrastructure for InferaDB Ledger.
Provides:
- OpenRaft integration with inferadb-ledger-store log storage
- Combined RaftStorage implementation (log + state machine)
- Inter-node Raft network transport
- Transaction batching, rate limiting, and background jobs
§Public API
The stable public API surface consists of:
trace_context— distributed tracing propagation helpersmetrics— Prometheus metric constants and recording helpersLedgerTypeConfig— OpenRaft type configuration
All other modules and re-exports are server-internal infrastructure hidden from documentation. They may change without notice.
§Architecture Note
OpenRaft 0.9 has sealed traits for RaftLogStorage and RaftStateMachine (v2 API).
We use the deprecated but non-sealed RaftStorage trait which combines both
log storage and state machine functionality into a single implementation.
§Security Model
Ledger runs behind WireGuard VPN. Authentication and authorization are handled by Engine/Control services upstream. Ledger trusts all incoming requests.
Modules§
- metrics
- Observability metrics exposed via Prometheus using the
metricscrate. - trace_
context - W3C Trace Context propagation for distributed tracing.
Structs§
- Ledger
Type Config - OpenRaft type configuration for the ledger’s Raft consensus layer. Ledger Raft type configuration.