Connect

Stellar Core Herder Subsystem Reference

stellarbystellar
•
3.3k
•
Learning & Documentation

Provides a token-efficient technical overview of the Stellar Core Herder subsystem and its implementation of the Stellar Consensus Protocol (SCP).

This skill serves as a comprehensive architectural map for developers working on or studying the Stellar network's reference implementation. It outlines the core classes, data structures, and control flows responsible for transaction collection, consensus driving via SCP, quorum intersection analysis, and ledger management. By providing a condensed summary of complex C++ logic, it helps engineers quickly understand the lifecycle of a transaction from receipt to externalization within the Stellar Core Herder, covering both Classic and Soroban transaction paths.

Key Features

013,290 GitHub stars
02Mapping of key C++ classes including HerderImpl, PendingEnvelopes, and QuorumTracker.
03Technical summaries of Classic and Soroban transaction queue management.
04Detailed breakdowns of SCP driver logic and envelope processing states.
05Step-by-step control flows for ledger closing, startup, and protocol upgrades.
06Explanations of quorum intersection algorithms including the Rust-based V2 checker.

Use Cases

01Planning protocol upgrades by understanding the existing upgrade and surge pricing logic.
02Debugging consensus-related issues, transaction bottlenecks, or quorum health.
03Accelerating onboarding for developers new to the Stellar Core C++ codebase.