用途:该技能用于通过 uxc + OpenAPI 执行 Nodit Web3 Data API 的读取操作,复用 uxc 技能提供的执行、认证与错误处理指引。
主要能力(只读 v1 范围):多链实体查询(post:/v1/multichain/lookupEntities)、原生余额查询(post:/v1/{chain}/{network}/native/getNativeBalanceByAccount)、账户交易历史(post:/v1/{chain}/{network}/blockchain/getTransactionsByAccount)、代币合约元数据(post:/v1/{chain}/{network}/token/getTokenContractMetadataByContracts)、按合约查询代币价格(post:/v1/{chain}/{network}/token/getTokenPricesByContracts)。不覆盖交易提交、完整 JSON-RPC 节点兼容、全部 Nodit 产品面及所选 v1 读取之外的链专属 API。
前置条件:uxc 已安装并在 PATH 中;可访问 https://web3.nodit.io;使用托管架构 URL 时需访问 https://raw.githubusercontent.com;需 Nodit API key。
认证:Nodit 使用 X-API-KEY 头认证。配置凭据并绑定到 web3.nodit.io: uxc auth credential set nodit --auth-type api_key --api-key-header X-API-KEY --secret-env NODIT_API_KEY uxc auth binding add --id nodit --host web3.nodit.io --scheme https --credential nodit --priority 100 可用 uxc auth binding match https://web3.nodit.io 校验映射。
使用方式:默认使用固定链接命令 command -v nodit-openapi-cli;若缺失则创建:uxc link nodit-openapi-cli https://web3.nodit.io --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/nodit-openapi-skill/references/nodit-web3.openapi.json。先用 -h 查看操作架构,再以 key/value 参数执行,例如:nodit-openapi-cli post:/v1/{chain}/{network}/native/getNativeBalanceByAccount chain=ethereum network=mainnet accountAddress=0xd8da6bf26964af9d7eed9e03e53415d37aa96045。
限制与护栏:保持 JSON 输出信封,不要用 --text;优先解析 ok、kind、protocol、data、error 等稳定字段;视为只读。lookupEntities 可能先触发计划限流,遇 HTTP 429 TOO_MANY_REQUESTS 应退避、避免热循环重试,已知链时直接改用链专属读取。contractAddresses 列表在 v1 中保持简短,长交易历史从小 limit 开始并谨慎分页。Nodit 与 Chainbase、Alchemy、Moralis 在部分账户与代币工作流上重叠,应在其多链体验或端点形态更契合任务时选用。