钱包搜不到某条 Cosmos 链？去 Chain Registry 核对 chain_id、前缀与 RPC

钱包”加一条链”到底在加什么

Cosmos 生态里链多、名字还彼此相近，钱包”搜不到某条链”或”加进去余额是零”，十有八九是链信息没填对。对钱包来说，所谓加一条链，本质上是要拿到几个能定位这条网络的参数：一条唯一的链标识、地址用什么人类可读前缀、账户密钥用哪条派生路径、以及一组可信的接口端点。cosmos/chain-registry 这个官方仓库就是把这些信息集中登记的地方：它为大量基于 cosmos-sdk 的链各提供一个 chain.json、assetlist.json 和 versions.json，README 说 chain.json 里含的数据”能让人更容易地去运行或与节点交互”。与其到处搜陌生人贴的 RPC，不如回到这个登记处逐项核对。

钱包搜不到某条 Cosmos 链？去 Chain Registry 核对 chain_id、前缀与 RPC 图 2 — 钱包搜不到某条 Cosmos 链？去 Chain Registry 核对 chain_id、前缀与 RPC · 图 2

chain.json 里的四个关键字段

从仓库给出的 Osmosis 样例看，钱包最该盯四个字段。一是 chain_id，例如 osmosis-1——它标识的是”哪条链”，填错了签名就签给了另一条网，常见后果是交易发出去却不被你预期的网接受。二是 bech32_prefix，例如 osmo——它决定地址的前缀长什么样，前缀不同，同一条公钥派生出来的地址文本也不同。三是 slip44，例如样例里的 118——它对应钱包派生密钥时用的币种编号，和 HD 钱包”同一句助记词派生哪条链的密钥”直接相关。四是 apis 下的 rpc 与 rest 端点，以及 explorers，用来把交易丢上网络、查回执。把这些填进钱包前，可以先对照钱包弹出的网络配置单怎么逐项核对：chainId、RPC 与小数位那套”网络配置单逐项核对”的做法：chainId、RPC、小数位一项项验，别整段照抄。

bech32 前缀：看着一样不代表能通用

chain-registry 的指引里特别提到，虽然不强制 bech32 前缀唯一，但强烈建议每条链把前缀登记到 Satoshi Labs 的注册表（即 SLIP-0173，专门登记 BIP-0173 里那些人类可读前缀的规范），如果所选前缀已被别的项目占用，就考虑换一个没被认领的。为什么要这么较真？因为地址前缀是用户辨别”我到底在跟哪条链打交道”的第一道线索：如果两条链共用同一个前缀，一个地址可能”看起来合法”却在另一条链上被当成有效收款，钱一旦打过去，找回来要么靠对方配合、要么根本没法处理。前缀冲突不是学术问题，它正是”跨链转错、余额没增加”那一类事故的一条成因，排查路径可以参考转错链了？代币余额没增加的排查路径与跨链找回的几种结局。

端点可信度：每日探活与”以后会上链”

仓库还透露了两件对安全有用的事。第一，登记的端点是靠 CI 每天 00:00 UTC 探活的，它要求 rest 路径和 rpc 的 /status 返回 HTTP 200，长期连不上的端点”可能不加警告就被移除”——也就是说，一份旧截图里的 RPC 可能早就失效，照抄有风险。第二，README 说明这套登记数据最终打算迁到 Cosmos Hub 上的链上形态，也就是所谓 Cosmos Chain Name Service，在此之前，仓库里的 chain.json 是社区协作、经 Pull Request 维护的离线登记，值得信任不等于无脑信任，重要参数最好两处对照。

实操：从登记处到钱包的核对顺序

把上面的道理落成动作，大致这样走：先在 chain-registry 里按链名找到目录，读 chain.json 的 chain_id、bech32_prefix、slip44；再挑 apis 里 provider 明确、探活正常的 rpc 端点填进钱包；加完先转一笔极小额验证到账与回执，再上量；如果钱包里已经有一条同名链，务必比对 chain_id 是否一致，防止把测试网或分叉网当成主网。assetlist.json 负责的是”这条链上有哪些资产、最小单位和小数位”，它和前端显示差额、单位错乱的问题相关，核对顺序上放到加链之后。

多留一句关于 slip44 的：它不是链自己的属性，而是钱包派生密钥时”用哪一段路径”的编号。同一句助记词，slip44 填对才派生得出你预期的那条链的账户；这也是为什么照抄别人给的地址前缀却填错 slip44，会出现”地址能显示、却和你原来那个对不上”。Cosmos 生态里 118 是常用的默认值，但确有链登记成别的数字，以 chain.json 现网为准，别凭印象统一填 118。