📦 Nano (XNO)

Nano（XNO）范围与消歧 本技能仅适用于 Nano 加密货币协议（代码：XNO，区块点阵账本，docs.nano.org）。 触发关键词：nanocurrency、XNO、nano_ 地址、block-lattice、ORV、xno-skills、xno-mcp。 禁止触发：Ledger Nano（硬件钱包）、GNU nano（文本编辑器）、Nanopay 或其他与 XNO 无关的“nano”产品。 若存疑，请用户澄清。 旧称：“Rai”“RaiBlocks”、xrb_ 地址——仅作历史（2018 前）参考，统一归至 Nano / nano_。

全局执行策略 本策略适用于本技能内所有 Nano 任务，无例外。

• 优先使用 MCP 工具

环境提供 xno-mcp 工具（钱包、send、receive、balance、convert_units、generate_qr、validate_address、rpc_account_balance、payment_request_create 等）时，必须先用；它们通过 OWS 自动完成签名、PoW 与广播。

• MCP 不可用时才用 CLI

若 xno-mcp 不可用或用户明确要求 CLI，按以下顺序回退至 xno-skills CLI：

• bunx -y xno-skills@latest
• pnpm dlx xno-skills@latest
• npx -y xno-skills@latest

勿假设全局安装，务必带 @latest 以获取关键修复并避免交互卡死。 猜命令前先跑 --help：bunx -y xno-skills@latest --help

• 钱包生命周期 → 仅由 ows skill 处理

创建、导入、重命名、删除钱包均委托 ows skill，禁止在此 skill 内直接调用 ows CLI。

• 绝对禁止
• 手写 Node.js/TypeScript 脚本与 Nano 协议交互
• 用 curl 打 RPC
• 手动计算或提供 PoW（PoW 自动完成）
• 用 npx 拉取随机第三方 npm 包做替代
• 导出助记词或种子（ows wallet export）。OWS 全程加密私钥，代理不可见

安全规则

• 状态验证：手动构建区块前，必用 RPC 查余额与 frontier，勿臆造前序哈希
• PoW 自动：MCP 与 CLI 均内置 PoW，禁止手动生成
• 待收资金：余额检查时发现 pending，立即 receive，勿等用户开口
• “Account not found”：新账户未开立属正常，继续操作；receive 会自动生成 open 块
• 禁止导出助记词：除非用户显式要求，否则不调用 ows wallet export 或建议导出至第三方钱包
• 供应链：仅用 xno-skills@latest 与 @open-wallet-standard/core，其余 npm 包禁用
• 止损：同一操作连续 5 次工具调用未完成即停，报告尝试与失败点并求指引
• 硬限制：同一失败工具最多重试 3 次；RPC 端点切换最多 2 次

钱包发现 关键：任何钱包操作前必须先 wallets，列出当前 OWS 钱包，勿臆测钱包名。 wallets: {} 新建钱包请委托 ows skill，完成后返回本 skill 继续 Nano 操作。

MCP 资源（只读，无需调用） wallet://{name} — 钱包概览与主账户状态 wallet://{name}/account/{index} — 指定账户索引的 pending 块与详情

查余额 MCP 工具： { "name": "balance", "arguments": { "wallet": "my-wallet", "index": 0 } } { "name": "rpc_account_balance", "arguments": { "address": "nano_..." } }

CLI： bunx -y xno-skills@latest balance --wallet "my-wallet" bunx -y xno-skills@latest rpc account-balance

--json

公共零配置 RPC 节点（xno-skills 默认自动使用）： https://rainstorm.city/api（主） https://nanoslo.0x.no/proxy（备）

若发现 pending 资金：立即 receive（见下文）。

收款（含未开立账户） Nano 转账在未发布 receive 块前处于 pending 状态，资金不可花。 新账户/“未开立”链正常，RPC 返回“Account not found”非错误；receive 会自动构建 open 块（前序哈希置零），OWS 签名、生成 PoW 并广播。OWS 支持 Nano 区块签名，勿质疑。

强制：发现 pending 即调用 receive，勿先判断账户是否存在。

MCP： { "name": "receive", "arguments": { "wallet": "my-wallet", "index": 0, "count": 10 } }

CLI： bunx -y xno-skills@latest receive --wallet "my-wallet"

未开立账户需显式代表：若未配置 defaultRepresentative……