用途:查询 Nano(XNO)账户的链上余额与待接收(pending)金额。当用户询问“收到了吗”“查一下余额”时,需要一个链上数据源,本技能通过用户提供的 Nano 节点 RPC 获取数据,余额与 pending 均以 raw 单位表示。
主要能力:区分 pending 与 received。Nano 中资金可能先显示为 pending,直到接收钱包发布 receive/open 区块;多数钱包应用会自动处理,但仅有 raw 私钥不会。若看到 pending 资金,需调用 wallet_receive 领取。可查询自己钱包的余额(wallet_balance / wallet_probe_balances,后者还会显示哪些账户已打开),也可查询任意地址(rpc_account_balance)。
使用方式(CLI,xno-skills):先设置 RPC URL,export NANO_RPC_URL="https://rpc.nano.org";然后执行 npx -y xno-skills rpc account-balance <address> --json --xno;或显式传 URL:npx -y xno-skills rpc account-balance <address> --url "https://rpc.nano.org" --json --xno。若用户有助记词但不确定是 bip39 还是 legacy,建议本地运行并通过 stdin 输入(不要粘贴到聊天中):npx -y xno-skills wallet probe-mnemonic --stdin --url "https://rpc.nano.org" --json。
使用方式(MCP,xno-mcp):先设默认值 config_set: { "rpcUrl": "https://rpc.nano.org" };再调用 rpc_account_balance(含 includeXno: true)、wallet_balance(name、index)或 wallet_probe_balances(name、count)。若有 pending 资金,调用 wallet_receive(name、index)领取。
公开 RPC 节点(用户无 RPC URL 时可推荐):https://rpc.nano.org(Nano Foundation)、https://app.natrium.io/api/rpc(Natrium)、https://nanonode.cc/api(NanoNode.cc)、https://node.somenano.site/api(SomeNano)。
限制与回退:若用户无法提供 RPC URL 或环境无网络访问,则请其在区块浏览器或钱包应用中查看地址并回报链上已确认余额与 pending/可接收金额(若有显示)。不要将助记词粘贴到聊天中,应本地运行并通过 stdin 输入。资料未提供收费、价格或其他功能信息。