// 当前强制统一登记的 canonical key：
// - dao_governance
// - foundation_treasury
// - gas_fee_distribution
// - economic_constitution
// - block_time_schedule
// - emission_schedule
//
// 2026-04-21 / 当前在线节点 Q1(8081) live 输出：
// get_contract_by_canonical_key(foundation_treasury)
// {"success":true,"data":{"canonical_key":"foundation_treasury","contract_address":"msg1en5v7k7cpj6m0hh4fnt89d94d6mgmydusxxmuf","contract_name":"foundation_treasury_v2","status":"active","updated_at_height":1,"updated_at_time":1776478894}}
//
// get_contract_by_canonical_key(emission_schedule)
// {"success":true,"data":{"canonical_key":"emission_schedule","contract_address":"msg1mfj7uvup2ek6tk6ftqmmxmntupytac6q2sxcfr","contract_name":"emission_schedule_v2","status":"active","updated_at_height":1,"updated_at_time":1776478894}}
//
// resolve_contract_address(foundation_treasury)
// {"success":true,"data":{"contract_address":"msg1en5v7k7cpj6m0hh4fnt89d94d6mgmydusxxmuf","contract_name":"foundation_treasury_v2","registered_at_height":1,"registered_at_time":1776478894}}
//
// list_canonical_mappings
// {"success":true,"data":{"mappings":[...,
//   {"canonical_key":"economic_constitution","contract_address":null,"contract_name":null,"status":"reserved",...},
//   {"canonical_key":"foundation_treasury","contract_address":"msg1en5v7k7cpj6m0hh4fnt89d94d6mgmydusxxmuf","contract_name":"foundation_treasury_v2","status":"active",...}
// ],"total_mappings":10}}
//
// 当前 live 风险点：
// - /api/v1/contracts surface 可见 foundation_treasury_v2 地址是 msg1szmtx2gehktfxpzt70gv6kklnharkjf4075c6p
// - 但 registry canonical key / resolve 返回 foundation_treasury 地址是 msg1en5v7k7cpj6m0hh4fnt89d94d6mgmydusxxmuf
// - 且这两个地址当前都能成功返回同一套 get_config
// - 因此 registry 已可证明“canonical key 可查且 active”，但 surface/cache 与 canonical 仍需最终对账
//
// 这说明 registry 页讲的是“链上寻址与状态登记”，不是口头说明；
// 同时也说明 reserved 与 active 在当前运行节点上都能被真实查出。

// 2026-04-21 / 当前在线节点 Q1(8081) live 输出：
// list_contracts(limit=5)
// {"success":true,"data":{"contracts":[
//   {"contract_name":"block_time_schedule_v1",...},
//   {"contract_name":"msg_token_cw20",...},
//   {"contract_name":"candidate_node_staking_v2",...},
//   {"contract_name":"emission_schedule_v2",...},
//   {"contract_name":"challenge_slashing_v1",...}
// ],"total_contracts":12}}
//
// list_contracts(limit=5, start_after="challenge_slashing_v1")
// {"success":true,"data":{"contracts":[
//   {"contract_name":"dao_governance_v1",...},
//   {"contract_name":"dar_rating_v1",...},
//   {"contract_name":"emission_schedule_v2",...},
//   {"contract_name":"foundation_treasury_v2",...},
//   {"contract_name":"gas_fee_distribution_v2",...}
// ],"total_contracts":12}}
//
// 归档对账样例：
// 01_list_contracts_page1.response.json
// {"success":true,"data":{"contracts":[
//   {"contract_name":"block_time_schedule_v1",...},
//   {"contract_name":"msg_token_cw20",...},
//   {"contract_name":"candidate_node_staking_v2",...},
//   {"contract_name":"emission_schedule_v2",...},
//   {"contract_name":"challenge_slashing_v1",...}
// ],"total_contracts":12}}
//
// 05_list_contracts_page2.response.json
// {"success":true,"data":{"contracts":[
//   {"contract_name":"dao_governance_v1",...},
//   {"contract_name":"dar_rating_v1",...},
//   {"contract_name":"emission_schedule_v2",...},
//   {"contract_name":"foundation_treasury_v2",...},
//   {"contract_name":"gas_fee_distribution_v2",...}
// ],"total_contracts":12}}
//
// 这说明：
// - registry 不只是单 key 查询，也有分页 list 能力
// - 页面把“12 条注册项 + 翻页”画出来是有当前在线节点 live 证据基础的。
// - 当前 live 节点 `/api/v1/contracts` 表面列表不带 `contract_name` 时，仍能通过 registry 分页查询恢复真实注册表语义。

// 节点启动后会从 genesis_registry_v1 解析关键地址：
// 现行运行时不是把 *_v1 / *_v2 当协议行为根，而是：
// - normalizeContractRoleAliases(addresses, canonicalRole, aliases...)
// - contractAddressForRole(addresses, canonicalRole)
// - ResolveContractAddress(...) 仍是底层 registry 查询入口之一，但上层运行时语义已切到 canonical role helper
// - tryRefreshContractAddresses() / QueryDelegations() 等运行时路径优先按 canonical role 解析
// -> 成功时写入 merged contractAddresses
// -> 失败时记录日志并继续，不伪装成已解析
//
// 因而 registry 是节点运行的真实依赖面，而不是文档附录。

// 这轮新增的关键边界：
// 1. 运行时 / 协议层只认 canonical role：
//    gas_fee_distribution / candidate_node_staking / emission_schedule / block_time_schedule / foundation_treasury ...
// 2. 具体实现名 *_v1 / *_v2 只保留在：
//    genesis / artifact / reporting / test / alias 兼容边界
// 3. 白皮书页因此不应把具体实现名写成“协议根语义”。
//
// 这也是为什么 registry 页现在既要讲 keyspace，
// 又要讲 canonical role resolver，而不是只停留在“查到某个地址”。

// registry 页当前要证明的不是“所有合约都可用”，而是：
// 1. keyspace 已定义：
//    dao_governance / foundation_treasury / gas_fee_distribution / emission_schedule 等 canonical key 有统一登记口径。
// 2. resolve 可回查：
//    get_contract_by_canonical_key 与 list_contracts 分页都能给出原始响应。
// 3. 失败不伪装：
//    reserved / timeout / empty response 仍被保留，不画成 active。
// 4. 下游可追：
//    dao、foundation、emission 页面都把 registry 作为寻址上游显式引用。
//
// 所以 registry 页是整套导航系统的“寻址证明链入口”，
// 它证明后续控制面、资金面、发行面引用的地址不是文档手填。