用途:该技能用于通过 uxc + OpenAPI 执行 Chainbase 索引数据操作,复用 uxc 技能提供的执行、认证与错误处理能力。
主要能力(只读索引数据):账户原生余额查询、账户代币余额、账户交易历史、代币元数据、代币持有者读取、代币价格查询、交易详情查询。不覆盖原始链 RPC 方法、写入或交易提交流程,以及所选 Web3 API 读取之外的更广泛 Chainbase 数据产品面。
前置条件:uxc 已安装并在 PATH 中;可访问 https://api.chainbase.online;可访问精选 OpenAPI 架构 URL:https://raw.githubusercontent.com/holon-run/uxc/main/skills/chainbase-openapi-skill/references/chainbase-web3.openapi.json;拥有 Chainbase API key。
认证:Chainbase 使用 X-API-KEY 请求头认证。配置一个 API-key 凭据并绑定到 api.chainbase.online:
uxc auth credential set chainbase
--auth-type api_key
--api-key-header X-API-KEY
--secret-env CHAINBASE_API_KEY
uxc auth binding add
--id chainbase
--host api.chainbase.online
--scheme https
--credential chainbase
--priority 100
认证异常时验证当前映射:uxc auth binding match https://api.chainbase.online
核心工作流:默认使用固定链接命令,先检查 command -v chainbase-openapi-cli;若缺失则创建:uxc link chainbase-openapi-cli https://api.chainbase.online --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/chainbase-openapi-skill/references/chainbase-web3.openapi.json,然后 chainbase-openapi-cli -h。先查看操作架构,例如 chainbase-openapi-cli get:/v1/account/balance -h、get:/v1/account/tokens -h、get:/v1/token/metadata -h。建议先用窄范围账户校验再扩大读取,例如 chainbase-openapi-cli get:/v1/account/balance chain_id=1 address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045。以键值参数执行,例如 chainbase-openapi-cli get:/v1/account/tokens chain_id=1 address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045 page=1 limit=20。
操作分组:账户读取 get:/v1/account/balance、get:/v1/account/tokens、get:/v1/account/txs;代币与交易读取 get:/v1/token/metadata、get:/v1/token/holders、get:/v1/token/price、get:/v1/tx/detail。
限制与护栏:自动化保持 JSON 输出信封,不要使用 --text;优先解析稳定字段 ok、kind、protocol、data、error;本 v1 技能视为只读,不应暗示 RPC 写入方法、mempool 发送或签名支持;Chainbase 有多个产品面,本技能仅限 https://api.chainbase.online 上的索引 HTTP 读取;构建大规模抓取前先使用较小的 page 和 limit 值。chainbase-openapi-cli <operation> ... 等价于 uxc https://api.chainbase.online --schema-url <chainbase_openapi_schema> <operation> ...。参考:references/usage-patterns.md、references/chainbase-web3.openapi.json、https://docs.chainbase.com/quickstart/authenticate-your-api-key、https://docs.chainbase.com/api-reference/web3-api/balance。