How sephyroth1/raft-consensus-implementation works
This repository is an incomplete, from-scratch Raft consensus implementation. Its current runtime entry point creates configured node records, registers RPC services, opens listeners, converts records into runtime nodes, and starts each node’s run loop. Node code contains election-timer handling and vote/append handlers, while shared types represent node state, log entries, roles, and queued RPC events. The README also describes heartbeat and leader-election capabilities, but end-to-end execution and the main coordinating event loop remain unfinished; the graph does not imply they are complete.
Main entry points: Node.go Node lifecycle · NodeEntry.go Node state · main.go Cluster startup · network.go RPC service wrapper
Components 12
Runtime setup
- Cluster startup
main.go - Timeout configuration
Config/config.go
Raft node logic
- Node lifecycle
RaftNode/Node.go - Vote handling
RaftNode/Node.go - Append handling
RaftNode/Node.go
RPC transport
- RPC service wrapper
RPC/network.go - Vote RPC types
RPC/RequestVote.go - Append RPC types
RPC/AppendEntries.go
Protocol data
- Node state
shared/NodeEntry.go - Log entries
shared/LogEntry.go - Node roles
shared/Role.go - RPC events
shared/RpcEvent.go
Connections 15
- Cluster startup → Timeout configuration: sets values
main.go - Cluster startup → Node lifecycle: creates and starts
main.go - Cluster startup → RPC service wrapper: registers and listens
main.go - Node lifecycle → Timeout configuration: chooses timeout
RaftNode/Node.go - Node lifecycle → Vote handling: calls
RaftNode/Node.go - Node lifecycle → Vote RPC types: builds vote request
RaftNode/Node.go - Node lifecycle → Node roles: updates role
RaftNode/Node.go - Vote handling → Vote RPC types: accepts request
RaftNode/Node.go - Vote handling → RPC events: queues event
RaftNode/Node.go - Append handling → Append RPC types: accepts request
RaftNode/Node.go - Append handling → Node state: updates state
RaftNode/Node.go - Append handling → RPC events: queues event
RaftNode/Node.go - RPC service wrapper → Node state: registers service
RPC/network.go - Node lifecycle → Node state: holds state
RaftNode/Node.go - Node state → Log entries: contains
shared/NodeEntry.go