用途:本技能提供 stellar-core 历史子系统的精简技术摘要,帮助以较少 token 快速理解该子系统的职责与结构。
主要能力:历史子系统负责在长期公共归档中存储和检索历史记录,处理两类数据——来自 BucketList 的桶(完整账本状态检查点)与历史区块(账本头、交易、交易结果的顺序日志)。检查点每 64 个账本一次(测试时 ARTIFICIALLY_ACCELERATE_TIME_FOR_TESTING 下为 8),以区间内最后一个账本标识;首个检查点覆盖 [1,63],其后为 [K*64,(K+1)*64-1]。归档通过 HTTP 提供,根状态位于 .well-known/stellar-history.json,各检查点文件使用三级十六进制目录前缀,如 ledger/12/34/56/ledger-0x12345677.xdr.gz。
关键组件:HistoryManager 抽象基类提供检查点算术与发布队列管理;HistoryManagerImpl 为具体实现,负责快照、发布流水线与崩溃恢复;CheckpointBuilder 以 ACID 事务方式将已确认账本追加到顺序 XDR 流;HistoryArchiveState 为账本号与桶列表状态的 JSON 快照;HistoryArchive 表示单个归档;HistoryArchiveManager 管理归档集合;StateSnapshot 为待发布的检查点数据快照;FileTransferInfo 封装文件命名;HistoryUtils 提供按账本查找历史条目的模板函数。
使用方式:发布流水线为 ResolveSnapshotWork → WriteSnapshotWork → PutSnapshotFilesWork,由 ConditionalWork 包裹并带可配置延迟(PUBLISH_TO_ARCHIVE_DELAY);崩溃恢复在启动时调用 restoreCheckpoint(lcl),由 cleanup(lcl) 截断脏文件至已提交状态;追赶下载由 CatchupWork 家族与 LedgerManager 编排。
限制:所有历史操作在主线程运行;CheckpointBuilder 写入在账本关闭期间同步执行并使用 fsync;发布使用 Work/WorkScheduler 异步 I/O。资料未提供安装命令、收费或价格信息。