Blockscout Explorer API Skill
用途：通过 uxc + OpenAPI 运行 Blockscout 区块浏览器操作。共享的执行、认证和错误处理指引复用 uxc skill。
前提条件：
- 已安装 uxc 并可在 PATH 中使用。
- 可网络访问暴露 /api/v2 的 Blockscout 部署。
- 可访问整理好的 OpenAPI 模式 URL：https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
- 一个目标 Blockscout 实例。本技能示例使用 https://eth.blockscout.com/api/v2。
范围： 本技能覆盖以读取为主的浏览器接口：地址概要查询、地址代币余额、地址交易历史、代币元数据、代币持有人读取、交易详情查询、区块详情查询。 不覆盖：Blockscout GraphQL、原始 JSON-RPC 代理、写操作或管理/配置流程、调用方未显式绑定的自定义认证网关。
认证：公共 Blockscout 实例通常允许无需认证的浏览器读取。若目标为自托管或受网关保护的实例，需针对该主机使用标准 uxc 认证绑定单独配置认证。本技能不假设任何默认凭据。
核心工作流： 默认使用固定链接命令： command -v blockscout-openapi-cli 若缺失则创建： uxc link blockscout-openapi-cli https://eth.blockscout.com/api/v2 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
blockscout-openapi-cli -h
先检查操作模式： blockscout-openapi-cli get:/addresses/{address_hash} -h blockscout-openapi-cli get:/tokens/{address_hash} -h blockscout-openapi-cli get:/transactions/{hash} -h
在较大历史读取前优先进行窄查询验证： blockscout-openapi-cli get:/blocks/{block_number_or_hash} block_number_or_hash=latest blockscout-openapi-cli get:/addresses/{address_hash} address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045 blockscout-openapi-cli get:/tokens/{address_hash} address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
使用键值参数执行： blockscout-openapi-cli get:/addresses/{address_hash}/transactions address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045 blockscout-openapi-cli get:/tokens/{address_hash}/holders address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
操作分组： 地址读取：get:/addresses/{address_hash}、get:/addresses/{address_hash}/token-balances、get:/addresses/{address_hash}/transactions 代币、交易和区块读取：get:/tokens/{address_hash}、get:/tokens/{address_hash}/holders、get:/transactions/{hash}、get:/blocks/{block_number_or_hash}
多实例使用：要定位不同的 Blockscout 部署，保持相同模式并将命令重新链接到另一个提供 /api/v2 的主机：
uxc link blockscout-openapi-cli https://optimism.blockscout.com/api/v2
--schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
防护准则：
- 自动化保持使用 JSON 输出信封；不要使用 --text。
- 优先解析稳定字段：ok、kind、protocol、data、error。
- 将本 v1 技能视为只读。不要暗示支持交易广播或合约写入。
- 本模式为在 /api/v2 暴露浏览器 REST 接口的 Blockscout 部署设计。若主机帮助失败，先检查部署路径再假设协议不匹配。
- 分页和过滤选项因部署而异。在构建大规模抓取前，先从目标实例的主机帮助和操作帮助开始。
- blockscout-openapi-cli <operation> ... 等价于 uxc <blockscout_api_v2_host> --schema-url <blockscout_openapi_schema> <operation> ...。
参考：使用模式 references/usage-patterns.md；整理好的 OpenAPI 模式 references/blockscout-v2.openapi.json；Blockscout API 文档 https://docs.blockscout.com/devs/apis-redirect