用途
主子系统(Main Subsystem)是 stellar-core 的中心编排层,负责协调应用整体生命周期并持有所有其他子系统管理器。该技能提供主子系统的技术摘要,可用于快速了解 stellar-core 主模块的结构与各关键文件、类、线程的职责。
主要能力
- 定义 Application 抽象接口及其具体实现 ApplicationImpl,后者拥有全部子系统管理器、线程和 io_context。
- 管理应用生命周期:构造、初始化、启动、主事件循环、优雅关闭、线程管理。
- 提供配置解析(Config)、持久化状态管理(PersistentState)、HTTP 命令处理(CommandHandler)、查询服务(QueryServer)、CLI 入口与命令路由(CommandLine、main.cpp),以及 XDR 转储、诊断、设置升级辅助和维护等工具。
关键文件与类
- Application.h / Application.cpp:抽象 Application 接口;工厂方法 Application::create()。
- ApplicationImpl.h / ApplicationImpl.cpp:具体实现;拥有所有子系统管理器、线程、io_context。
- AppConnector.h / AppConnector.cpp:线程安全访问门面,使子系统不直接访问 Application。
- Config.h / Config.cpp:基于 TOML 的配置解析、默认值与校验。
- PersistentState.h / PersistentState.cpp:通过两张 SQL 表持久化节点关键状态(LCL、SCP 数据、升级)。
- CommandHandler.h / CommandHandler.cpp:HTTP 管理命令服务器路由与处理。
- QueryServer.h / QueryServer.cpp:用于 BucketListDB 读取的多线程 HTTP 查询服务器。
- CommandLine.h / CommandLine.cpp:通过 Clara 解析 CLI 参数,分发各子命令运行函数。
- main.cpp:入口点;初始化加密、检查 XDR/版本一致性、委托给 handleCommandLine()。
- Maintainer.h / Maintainer.cpp:周期性维护(清理旧 SCP 历史与账本数据)。
- ApplicationUtils.h / ApplicationUtils.cpp:高层应用工具(setupApp、runApp、catchup、selfCheck、dumpLedger 等)。
- Diagnostics.h / Diagnostics.cpp:桶统计转储工具。
- dumpxdr.h / dumpxdr.cpp:XDR 文件内省、打印与交易签名工具。
- SettingsUpgradeUtils.h / SettingsUpgradeUtils.cpp:构建 Soroban 设置升级交易的辅助函数。
- ErrorMessages.h:常见失败模式的常量错误消息。
- StellarCoreVersion.h:声明 STELLAR_CORE_VERSION 字符串常量。
关键类包括:Application(抽象基类,定义 State 枚举与多个纯虚方法)、ApplicationImpl(具体实现,拥有 io_context、子系统管理器与线程)、AppConnector(线程安全门面)、Config、PersistentState、CommandHandler、QueryServer、Maintainer 等。
使用方式
该技能本身为文档摘要(skill),不是可执行程序。stellar-core 的使用方式通过 CLI 体现:main.cpp 初始化后调用 handleCommandLine(),通过 Clara 解析子命令,支持 run、catchup、publish、new-db、new-hist、self-check、convert-id、dump-xdr、print-xdr、sign-transaction、sec-to-pub、gen-seed、http-command、version、merge-bucket-list、dump-ledger、offline-info、report-last-history-checkpoint、check-quorum-intersection、dump-state-archival-stats、calculate-asset-supply 等,以及仅测试命令(test、fuzz、gen-fuzz、load-xdr、rebuild-ledger-from-buckets、apply-load)。
适用场景
- 需要快速了解 stellar-core 主子系统架构、关键类与线程模型的开发者。
- 需要查阅主子系统内配置、持久状态、HTTP 命令、查询服务、维护与工具职责的运维或研究人员。
- 作为节省 token 的技术摘要,辅助阅读源码或进行开发规划。
限制
该资料仅为主子系统的技术摘要。关于安装命令、收费标准、价格、平台支持情况、性能效果或具体使用步骤,资料中暂未提供,不应推断。
分类
依据明确用途(stellar-core 主子系统核心编排与技术摘要),归入“编程与开发”。