evm-atlas

EVM Atlas

此技能免于协调：对于其声明的工作，请跳过 ai-coord 门禁。

只能在严格的只读边界内解析和查询 references/generated/target-mainnets.json 中的目标主网。

收集浏览器 UI 证据前，请加载 chromium-browser。遵循其页面所有权、实时工具和隐私契约。当所需的浏览器工具不可用时，请使用文档中说明的提供方回退方案。

注册表行中的当前 category 是分类的权威依据。对于精确为零的原生资产扫描，或关于特定分类手续费行为的问题，请先解析目标，再阅读 链分类。不要推断历史分类，也不要以文字形式维护目标链清单。

范围与权威来源

• 将 references/generated/chain-aliases.json 中显示的名称、数字链 ID 和别名，与权威目标主网行进行匹配。
• 先使用 scripts/chain-lookup.sh <name|alias|slug|chain_id> 查询链。该脚本会打印 key=value 行，或使用 --json 打印一行紧凑结果。切勿 cat 生成的 JSON 文件，也不要打印完整的 routemesh chains 列表。对于其他查询，请使用包含具名字段的 jq -c 选择器，例如 jq -c '.chains[] | {chainId, category}'。
• 如果未列出某条链，不要改用其他服务商、网页搜索、Chainlist 或未列出的 RPC 来绕过范围限制。请前往 https://github.com/PaulRBerg/agent-skills 提交功能请求。
• 带有 defunct 的目标行表示该链已由其运营方关闭。其历史记录以 defunct.finalStateBlock 为准。之后的空区块或服务商缺少历史记录不属于覆盖缺口。若未提供 finalStateBlock，该链仍可能接受提现等退出交易。此时应将其视为在线链。在结果中说明该链已关闭。
• 对于交由 cli-cast 处理的每一项离散读取和有界实时订阅，均由你负责，包括链、区块、费用、nonce、eth_call、eth_estimateGas、交易、收据、日志、余额、代码、存储、证明和 ENS 查询。即使读取结果将用于后续状态变更操作的准备、模拟或验证，也必须在此处完成读取。
• 切勿签署消息、提交签名、执行桥接步骤或广播交易。将状态变更类 Cast 工作交由 cli-cast 处理。
• DEX 支持仅限历史数据和证据。不要查询实时报价、构造或模拟新交易、准备授权或许可、提交订单、管理协议、解读 CoW AMM 仓位、处理独立的 1inch 限价订单，或为任意 Uniswap v4 钩子定义语义。
• 不要默认使用 Ethereum。根据明确的链上下文和明确无误的链专属代币进行判断。若链不明确，请询问。
• 切勿回显、插入或记录 API 密钥的值（ETHERSCAN_API_KEY、BLOCKSCOUT_API_KEY、RPC 密钥）。检查变量是否存在时不要打印其值：[ -n "$ETHERSCAN_API_KEY" ] && echo set || echo unset。切勿在打印的输出中使用 ${VAR:-...} 或 ${VAR:+...} 展开式。
• 查询 Etherscan 时，使用官方 etherscan CLI，并指定已解析的数字 --chain 和 --output json。现有 CLI 身份验证可使用环境密钥或已保存的登录信息。不要检查凭据、传入 --api-key，或运行 whoami、config 或 login。CLI 是否可用不会改变服务商优先级或计划门槛。此只读技能中切勿调用 proxy eth_sendRawTransaction 或提交合约验证。
• 免密钥 Blockscout 服务已于 2026 年 7 月停止。托管的 *.blockscout.com 实例子域名也会对免密钥流量限流。对于所有由 Blockscout 托管的链，均使用带密钥的 https://api.blockscout.com/{chain_id} 网关。参见 references/explorers/blockscout-endpoints.md。
• 主机上的所有 Agent 共用 DeBank 的速率限制。访问任何 debank.com 内容（包括快速查看个人资料）时，都必须持有 scripts/debank-gate.py 租约。参见 references/workflows/debank-portfolio.md 中的 Global Queue。
• 无法访问或报错的索引器属于覆盖缺口，绝不能作为活动为零的证据。在记录端点已宕机或被阻止之前，请先在 Chromium 中确认。请在结果中说明验证方法。

路由

1. 对于离散的 JSON-RPC 读取、批处理或有界实时订阅（包括通过 cli-cast 移交的请求），使用 scripts/chain-lookup.sh 解析链。然后阅读 references/workflows/provider-routing.md。返回解析出的链、当前类别、提供方路由、结果、观察到的区块或检查点，以及覆盖缺口。不要将读取请求重新路由至 cli-cast。

2. 对于跨链的公开钱包地址当前原生资产或同质化代币余额、DeFi 仓位，首先阅读 references/workflows/debank-portfolio.md。对于指定链，首先阅读 references/workflows/blockscan-balances.md。

3. 对于一个或多个地址在目标链上的当前 USD 价值（投资组合价值、净资产、资金被盗或尘埃余额检查），阅读 references/workflows/address-usd-value.md。

4. 对于指定链上的特定交易哈希，使用 scripts/chain-lookup.sh 解析链。然后直接阅读 references/workflows/provider-routing.md 获取交易事实。除非用户明确要求以 Blockscan 作为证据来源，否则不要打开 Blockscan。链未知时，阅读 references/workflows/blockscan-tx-lookup.md 一次以解析链。

   对于已知或疑似发生在最终 regenesis 之前的 OP Mainnet 目标，阅读 references/explorers/optimism-pre-regenesis.md。在这种情况下，返回其旧版执行数据包或特定组件的覆盖结果，而不是要求提供当前提供方收据。其他情况下，在解读 DEX 或桥接结果前，先获取确切的提供方收据和日志。

5. 对于地址范围的历史活动或 bootstrap-discovery 扫描，阅读 references/workflows/address-sweeps.md。使用其中确定性的计划/评估辅助工具。对于当前持仓，首先使用 references/workflows/debank-portfolio.md，并通过提供方路由处理缺口。

6. 对于特定链上的历史余额、NFT 持仓、代币/NFT 转账、交易历史、交易的完整原始收据/日志/解码输入或资金来源，使用 scripts/chain-lookup.sh 解析链。然后阅读 references/workflows/provider-routing.md，了解 Etherscan、Blockscout、公共 RPC、RouteMesh、浏览器链接和特殊链的路由。

7. 对于超出上述工作流路由范围的 Etherscan CLI 读取，阅读 references/explorers/etherscan-api.md。其中定义了 CLI 1.1.1 的输出、手动分页、计划门控和直接 API 例外。ENS 正向解析仍是 Ethereum 主网上链名称的直接 API 例外。遵循其中的缓存和解析器限制。

8. 对于超出上述工作流路由范围的原始 Blockscout API 查询，阅读 references/explorers/blockscout-api.md。

9. 对于 DEX 提示词、面向钱包用户的 DEX 历史记录或疑似 DEX 交易证据，解析目标链并阅读 references/workflows/dex-transactions.md。仅加载匹配的协议系列参考文档：

   • Uniswap v1-v4、Universal Router 或 Permit2：references/dexes/uniswap.md
   • 1inch Classic、Fusion、Fusion+、legacy liquidity 或 rewards：references/dexes/1inch.md
   • CoW Swap、CoWSwap、CoW Protocol 或 GPv2：references/dexes/cow-protocol.md

10. 将 1inch 和 CoW 视为执行协议。分别报告任何集成封装器、路由器、池和底层 AMM 流动性。与 Uniswap 池交互，不会使聚合器交易变成 Uniswap 交易。

11. 对于与桥接相关的提示词或交易证据，确认已知的源链/目标链均为目标链。然后仅加载匹配的参考文档：

    • Arbitrum One/Nova 规范桥提现：references/bridges/arbitrum.md
    • Across：references/bridges/across.md
    • Bungee / Socket：references/bridges/bungee.md
    • Circle / CCTP / Gateway：references/bridges/circle.md
    • deBridge / DLN：references/bridges/debridge.md
    • Gas.zip：references/bridges/gaszip.md
    • Hop：references/bridges/hop.md
    • Layerswap：references/bridges/layerswap.md
    • LayerZero / Stargate / OFT / Aori：references/bridges/layerzero.md
    • LI.FI：references/bridges/lifi.md
    • Relay / Relay.link：references/bridges/relay.md
    • Symbiosis：references/bridges/symbiosis.md
    • 1inch Fusion+：references/dexes/1inch.md

12. 将桥和 DEX API 作为补充信息。通过区块浏览器或 RPC 证据验证已提交的交易及最终结果。

完成

返回解析出的目标链、当前类别、服务商路径、所请求的链上事实，以及来源 URL/交易标识符。对于地址扫描，包含每项结果固定的已最终确认/已验证检查点、所选配置文件/通道、服务商覆盖范围，以及任何所请求的仲裁结果。区分服务商事实与推断。报告历史记录不完整、计划/套餐限制、回退失败或不支持的范围。完成流程仅提供只读证据。绝不要执行返回的 calldata 或交易请求。

对于 cli-cast 交接，返回包含以下字段的单个读取数据包：

• 解析出的链名称、ID 和当前类别。
• 确切的服务商路径。
• 结果。
• 观测到的区块或检查点。
• 覆盖范围缺口；若未发现缺口，可留空。

不要包含签名或广播命令。

对于 DEX 证据，包含以下字段：

• 交互类别。
• 执行协议、版本和模式。
• 入口点或集成封装。
• 路由器和底层流动性来源。
• 钱包角色。
• 卖出和收到的资产。
• 协议/集成商费用与 Gas 费用，分别列出。
• 原生/封装状态。
• 订单、仓位、池或迁移标识符。
• 确切证据。

不要将仅含授权的交易或失败交易称为已完成的交易。

对于人类可读的结果，以 ### ⛓️ <chain or route> — <status word> 开头。只有字段重复时才使用紧凑表格。

对于桥接证据，显示 <origin> ──<bridge>──▶ <destination>。然后使用 Leg、Provider status、Transaction 和 Evidence 列。保留每个服务商的原生状态，并列出对应的标准化标签：✅ completed、⏳ pending、↩ refunded、⚠️ partial 或 ❓ unknown。明确区分 Observed facts、Inference 和非空的 ⚠️ Coverage gaps。

对于地址扫描，仅当确切的分母已知时，进度条才可表示已检查的目标链/通道。

对于不支持的范围和安全说明，直接说明。绝不要修饰或截断地址、哈希、URL、calldata、原始 RPC/API JSON、生成的引用、助手 key=value 输出或交易请求。