用途:先解析 EVM 链元数据,再读取链上账户数据。可用于在调用 RPC、发送交易、调用合约、构造链特定 RPC URL 或生成地址/交易/区块浏览器链接前解析链信息,也可在链解析后查询余额、代币、转账、交易历史与首笔资金等数据;还可用于跨链桥相关场景的只读数据补充。
主要能力:依据 references/target-mainnets.json 作为权威范围,按显示名称或数字链 ID 匹配链,并用 references/chain-aliases.json 归一化代码别名。目标是读取账户数据时按路由分发:Etherscan 优先(统一 API V2,需 $ETHERSCAN_API_KEY),其次 Blockscout;两者都不支持时直接通过公共 RPC 走 JSON-RPC(如 cli-cast 的 cast 或 curl)。已知付费链 Base(8453)、Optimism(10)、Avalanche(43114)、BNB Chain(56) 在免费 Etherscan 计划下可自动转用 Blockscout。桥接场景可按提示或证据选择 Bungee/Socket、LayerZero/Stargate/OFT/CCTP/Aori、LI.FI 等参考文档做只读数据补充。RouteMesh 仅在 target-mainnets.json 的 routeMesh 为 true 且存在 ROUTEMESH_API_KEY 时使用,RPC URL 形如 https://lb.routeme.sh/rpc/CHAIN_ID/ROUTEMESH_API_KEY,可用 GET https://lb.routeme.sh/chains(备用 https://lb2.routeme.sh/chains)核验支持情况。
使用方式与限制:公共 RPC 为尽力而为,依赖前先用 eth_chainId 校验,主端点失败再按 target-fallback-rpcs.json 顺序尝试备用。浏览器链接由 target-mainnets.json 的 explorerUrl 拼接 explorer-paths.json 路径生成;Etherscan 风格路径或名称并不代表支持 API V2,需查 etherscan-chains.md。桥接 API 仅作只读补充,不作为链上执行权威,不签名、不提交、不广播。非目标链应要求用户在 https://github.com/PaulRBerg/agent-skills 提交功能请求,不得绕开范围。注意 OP Mainnet 2021-11-11 最终 regenesis 前历史查 references/optimism-pre-2021-11-11.md;Ronin 不使用 Etherscan 路径方案,也不使用 Chainscout 元数据(2020 与无关注册项冲突)。