SuperAPI AI 工具集

subsystem-summary-of-invariant

通用与其它

查看项目

更新于 10-16 08:42

技能介绍

用途:该技能提供 stellar-core 不变量(invariant)子系统的技术摘要,用于在关键生命周期事件上执行运行时正确性检查。

主要能力:定义 Invariant 抽象基类与各类检查钩子(操作应用、账本提交、bucket 应用、assume-state、周期性快照);通过 InvariantManager/Impl 注册、启用(正则匹配名称)和分发不变量;包含多个具体不变量实现,如 ConservationOfLumens、AccountSubEntriesCountIsValid、BucketListIsConsistentWithDatabase、LedgerEntryIsValid、LiabilitiesMatchOffers、SponsorshipCountIsValid、ConstantProductInvariant、BucketListStateConsistency、ArchivedStateConsistency、EventsAreConsistentWithEntryDiffs。

使用方式:通过 registerInvariant 注册,enableInvariant(name) 按正则启用;严格不变量失败时抛 InvariantDoesNotHold 触发节点关闭,非严格则仅记录错误。build 测试中可启用 OrderBookIsNotCrossed 等仅测试使用的检查。

限制:部分不变量受协议版本门控(如 V8、V10、V14、V18)、仅在特定构建或配置下启用;快照检查在后台线程运行,可能被跳过,具体细节需查阅源码与配置文档。