SuperAPI AI 工具集

near-jsonrpc-skill

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:通过 uxc 与 JSON-RPC 执行 NEAR 链上只读操作。默认使用 https://free.rpc.fastnear.com,可在官方提供方页面有偏好的情况下改为其它提供方。

主要能力:覆盖 chain status、account state query、finalized block lookup、按 chunk hash 查询、gas price 查询、validator set 查询。不覆盖交易提交、签名或钱包流程,也不保证对极旧区块/chunk 的归档访问。

前置条件:uxc 已安装并在 PATH 中;可访问正常工作的 NEAR RPC 提供方;需为固定 schema 链接。 用法:先执行 command -v near-jsonrpc-cli,缺失时运行 uxc link near-jsonrpc-cli https://free.rpc.fastnear.com --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/near-jsonrpc-skill/references/near-public.openrpc.json。之后可用 -h 查看操作帮助,常用示例包括 near-jsonrpc-cli status、near-jsonrpc-cli block '{"finality":"final"}'、near-jsonrpc-cli query '{"request_type":"view_account","finality":"final","account_id":"near"}'。对象请求直接传 JSON;对 gas_price、validators 等位置为 null/default 的方法使用 --input-json 传对象,如 near-jsonrpc-cli gas_price --input-json '{"block_id":null}'。

限制:保持 JSON 输出信封,不要用 --text;先解析 ok、kind、protocol、data、error 等稳定字段;默认仅限只读方法。FastNear 不提供 UXC 可直接发现的方法面,因此固定 --schema-url 不可随意去掉,除非提供方证明暴露可用 OpenRPC 或 rpc.discover。旧 near.org 与 pagoda.co 端点已被官方标记为弃用。公开提供方的归档保留与速率限制可能不同,如需旧区块或 chunk 请在失败时切换到明确支持所需历史的提供方。认证方面默认 FastNear 公开 RPC 无需认证,改用私有提供方前需先确认其认证模型。