Cardano节点UTxO-HD功能中的LedgerDB配置格式升级解析

背景介绍

在Cardano节点的UTxO-HD功能开发过程中，开发团队对Ledger数据库(LedgerDB)的配置格式进行了重要调整。这项变更主要影响了节点配置文件的结构，将原本分散在顶层的配置项重新组织到一个专门的"LedgerDB"对象中。

新旧配置格式对比

旧版配置格式

在旧版本中，LedgerDB相关的配置参数直接位于配置文件的顶层，例如：

{
  "NumOfDiskSnapshots": 3,
  "DoDiskSnapshotChecksum": true,
  "SnapshotInterval": 4320,
  "QueryBatchSize": 100
}

新版配置格式

新版本将这些配置项封装在"LedgerDB"对象内，并增加了后端类型的选择：

{
  "LedgerDB": {
    "NumOfDiskSnapshots": 3,
    "DoDiskSnapshotChecksum": true,
    "SnapshotInterval": 4320,
    "QueryBatchSize": 100,
    "Backend": "V2InMemory"
  }
}

配置项详解

通用配置参数

• NumOfDiskSnapshots：磁盘快照数量，默认值为2
• DoDiskSnapshotChecksum：是否进行磁盘快照校验，默认为true
• SnapshotInterval：快照间隔时间(秒)，默认值为2*k=4320
• QueryBatchSize：查询批处理大小，默认值为100

后端类型配置

新版配置引入了后端类型选择，支持两种后端：

1. V2InMemory内存后端

{
  "Backend": "V2InMemory"
}

这是默认后端类型，不需要额外配置。

2. V1LMDB磁盘后端

{
  "Backend": "V1LMDB",
  "MapSize": 16,
  "LiveTablesPath": "mainnet/db/lmdb"
}

• MapSize：映射大小，默认16
• LiveTablesPath：实时表存储路径，默认"mainnet/db/lmdb"

向后兼容处理

开发团队实现了对旧版配置格式的向后兼容支持：

1. 系统能够正确解析旧版顶层配置格式
2. 当检测到旧版配置时，会发出警告提示用户迁移到新版格式
3. 未指定后端类型时，默认使用V2InMemory内存后端

技术实现要点

在代码实现上，配置解析逻辑位于POM(Plain Old Map)处理模块中，主要完成以下功能：

1. 识别旧版配置格式并转换为新版结构
2. 验证配置参数的合法性
3. 设置合理的默认值
4. 生成适当的用户提示信息

升级建议

对于现有用户，建议尽快将配置文件迁移到新版格式，以获得更好的可维护性和未来兼容性。开发团队在实现中已经考虑了平滑过渡，但长期使用旧格式可能会在未来的版本中失去支持。

这项改进是Cardano节点向UTxO-HD架构演进的重要一步，为后续的性能优化和功能扩展奠定了基础。