用途:这是 stellar-core 中账本(Ledger)子系统的技术摘要,供需要快速了解该子系统结构的人阅读,描述本身强调这是 token 高效的摘要,可用于替代直接阅读源码。
主要能力与覆盖内容:
- 账本生命周期:LedgerManager 抽象接口与 LedgerManagerImpl 实现负责应用交易集、关闭账本、管理最后关闭账本(LCL)状态,并对外发布状态。
- 事务性内存层:LedgerTxn 提供可嵌套的内存事务层,LedgerTxnRoot 作为根连接数据库,提交时把变更合并到父层或写入数据库。
- Soroban 相关:InMemorySorobanState 缓存活跃合约数据、代码与 TTL;SorobanNetworkConfig 从账本条目读取网络配置;SharedModuleCacheCompiler 多线程编译 Wasm 合约。
- 元数据与快照:LedgerCloseMetaFrame 构建每账本元数据,供 Horizon 等下游消费;LedgerSnapshot 与 CompleteConstLedgerState 提供只读快照。
- 一致性保障:LedgerEntryScope 提供编译期与运行期的作用域检查,防止跨线程、跨阶段访问错误。
架构要点:采用双线程架构,主线程处理共识并发布状态,apply 线程执行交易并提交状态,不变量 LCL <= A <= Q <= H 跟踪账本进度。Ledger 管理器状态包括 LM_BOOTING_STATE、LM_SYNCED_STATE、LM_CATCHING_UP_STATE。LedgerTxn 为线程亲和,必须在同一线程内使用。
使用方式:资料未提供安装命令、调用示例或运行步骤。
限制:InMemorySorobanState 对并发读写不安全,需保证互斥;LedgerSnapshot 不应跨账本边界持久使用;其余具体接口细节需查阅源码。