subsystem-summary-of-work

Asynchronous task execution in Stellar Core operates through a cooperative, single-threaded framework. This subsystem uses a finite state machine (FSM) model to manage hierarchical task trees, executing sequential and parallel operations without blocking the main event loop.

The finite state machine (FSM) model in Stellar Core's work subsystem governs the lifecycle of asynchronous tasks. It defines state transitions for work execution, enabling retry logic, conditional gating, and orderly abort or shutdown mechanisms across hierarchical task trees.

You manage retry logic and conditional task gating in Stellar Core using specific classes within the work subsystem. Classes like ConditionalWork handle execution dependencies, while the base Work class provides built-in retry mechanisms for resilient asynchronous task processing.

You can execute parallel and sequential asynchronous tasks in Stellar Core using WorkSequence and BatchWork classes. These components orchestrate hierarchical task trees within the single-threaded, cooperative scheduler to process tasks efficiently without concurrent thread blocking.

You implement orderly abort and shutdown mechanisms in Stellar Core by leveraging the finite state machine transitions within the work subsystem. The framework ensures hierarchical task trees are cleanly terminated and cleaned up during scheduler shutdown operations.

WorkScheduler manages the overall cooperative execution loop in Stellar Core's architecture. WorkWithCallback integrates custom completion logic, while BasicWork and Work serve as foundational classes for defining asynchronous tasks within the single-threaded state machine framework.