用途:该技能用于通过 uxc 与 JSON-RPC 执行 Sui 的查询操作,复用 uxc 的共享执行与错误处理方式,默认面向公共主网全节点 https://fullnode.mainnet.sui.io。
前提条件:需在 PATH 中安装 uxc;可访问上述全节点地址;默认流程使用公共主网全节点,无需 API key。
覆盖范围:链标识与最新 checkpoint 读取、checkpoint 查询、对象查询、参考 gas 价格读取、最新系统状态读取,以及事件和交易效果的 pubsub 订阅。不覆盖 unsafe_* 交易构建方法、sui_executeTransactionBlock、钱包签名流程,以及认证或限流不同的自定义或私有 Sui RPC 提供方。
用法:默认使用固定链接命令。先检查是否已有 sui-jsonrpc-cli,缺失时执行命令创建:uxc link sui-jsonrpc-cli https://fullnode.mainnet.sui.io。随后可查看帮助与操作 schema(如 sui-jsonrpc-cli -h,以及 sui_getCheckpoint -h 等)。建议先做只读校验(sui_getChainIdentifier、sui_getLatestCheckpointSequenceNumber、suix_getReferenceGasPrice),再执行查询,支持 key/value 与位置参数 JSON 两种传参形式。pubsub 需使用经确认支持 JSON-RPC 订阅的 Sui WebSocket 端点,通过 uxc subscribe start 启动,并用 status/stop 管理任务。
限制:默认停留在只读方法面,不调用 unsafe_* 方法;不用于写入、签名或提交流程。自动化应保持 JSON 输出信封,不要使用 --text,并优先解析稳定字段。订阅任务应写入 sink 文件以便检查回放。公共 HTTPS 全节点不保证存在同名的 wss:// 端点,使用前需验证;公共 RPC 的可用性与速率限制可能变化。