SuperAPI AI 工具集

check xno balance (rpc)

通用与其它

查看项目

更新于 10-16 05:02

技能介绍

用途:当用户询问“收到了吗”“查一下余额”时,该技能通过用户提供的 Nano 节点 RPC 地址查询链上数据,返回账户余额与待接收(pending)金额,两者均以 raw 为单位。

主要能力:查询指定地址的账户余额;区分已确认余额与 pending/receivable 金额。注意 Nano 中资金在接收方发布 receive/open 区块前会显示为 pending,许多钱包会自动完成该操作,仅持有 raw 私钥不会自动接收。

使用方式(CLI):先设置 RPC 地址,export NANO_RPC_URL="http://127.0.0.1:7076",然后运行 npx -y xno-skills rpc account-balance <address> --json --xno;也可显式传 URL:npx -y xno-skills rpc account-balance <address> --url "<rpc-url>" --json --xno。若用户有助记词且不确定是 bip39 还是 legacy(24 词短语常见),建议本地运行并通过 stdin 输入,不要把助记词粘贴到聊天中:npx -y xno-skills wallet probe-mnemonic --stdin --url "<rpc-url>" --json。

MCP 用法:若智能体可访问 xno-mcp 工具,调用 rpc_account_balance,参数为 { "address": "...", "rpcUrl": "...", "includeXno": true }。若使用 xno-mcp purse,优先用 purse_balance / purse_probe_balances,避免让模型接触密钥。

回退方案:若用户无法提供 RPC URL 或环境无网络,请让其在区块浏览器或钱包应用中查看地址,并回报已确认的链上余额与 pending/receivable 金额(若显示)。

限制:依赖可用的 Nano 节点 RPC;pending 与已接收状态取决于接收区块是否已发布;资料未提供收费、价格或平台支持范围等信息。