subsystem-summary-of-ledger

Summarize the stellar-core ledger subsystem architecture and control flow.

3.3k|1.1k|Updated Nov 24, 2014
One-click install
npx skills add https://github.com/stellar/stellar-core --skill subsystem-summary-of-ledger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subsystem-summary-of-ledger
Source: https://github.com/stellar/stellar-core/tree/main/.claude/skills/subsystem-summary-of-ledger
Command: npx skills add https://github.com/stellar/stellar-core --skill subsystem-summary-of-ledger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a detailed technical summary of the ledger subsystem in stellar-core, explaining its architecture, key components, and data flows.

Core Features & Use Cases

  • Architectural Overview: Understand the two-thread model (main and apply) and state management.
  • Key File Identification: Learn about the purpose of critical files like LedgerManager.h, LedgerTxn.h, and SorobanNetworkConfig.h.
  • Data Structure Explanation: Grasp the roles of LedgerTxn, InternalLedgerEntry, and InMemorySorobanState.
  • Control Flow Mapping: Follow the ledger close process and parallel Soroban apply mechanisms.
  • Use Case: A new developer joining the stellar-core project can use this Skill to quickly get up to speed on how the ledger subsystem functions, its critical components, and how data flows through it.

Quick Start

Read this skill for a token-efficient summary of the ledger subsystem.

Frequently Asked Questions about subsystem-summary-of-ledger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does the stellar-core ledger subsystem manage state and transactions?

The stellar-core ledger subsystem manages state using a two-thread model, separating main and apply operations. It maintains a transactional in-memory layer to process ledger changes efficiently during the consensus protocol.

What is the architecture of the stellar-core ledger close process?

The ledger close process architecture maps control flows through key files like LedgerManager.h and LedgerTxn.h. It coordinates transactional state updates and parallel Soroban apply mechanisms to finalize ledger entries.

How do I understand data structures in the stellar-core ledger subsystem?

You understand stellar-core ledger data structures by examining LedgerTxn, InternalLedgerEntry, and InMemorySorobanState. These structures manage transactional state, track entry modifications, and handle Soroban state management respectively.

Can I use this technical summary to learn Soroban state management in stellar-core?

Yes, you can use this summary to learn Soroban state management in stellar-core. It details the SorobanNetworkConfig.h file, InMemorySorobanState data structure, and the parallel apply mechanisms used during the ledger close process.

What are the key files I need to understand for stellar-core ledger development?

Key files for stellar-core ledger development include LedgerManager.h for overall management, LedgerTxn.h for transactional operations, and SorobanNetworkConfig.h for Soroban specific state configurations and network parameters.