核心用法
nano 技能是专为 Nano 加密货币(XNO)设计的全功能钱包操作与链上分析工具,覆盖从基础转账到高级区块分析的完整工作流。
主要功能模块
| 模块 | 功能描述 |
|:---|:---|
| **钱包发现** | `wallet_list` 优先调用,识别现有 OWS 钱包,避免重复创建 |
| **余额管理** | 支持 `wallet_balance`(MCP)和 `rpc_account_balance`(直接地址查询),自动检测 pending 资金 |
| **资金收发** | `wallet_send`/`wallet_receive` 完整封装签名、PoW 生成与广播;接收操作自动处理未开户账户(open block) |
| **支付请求** | `payment_create`→`payment_receive`→`payment_refund` 跟踪式工作流,适合商业收款场景 |
| **工具函数** | 地址验证(`util_validate`)、单位换算(`util_convert`,30位小数)、QR 生成(`util_qr`)、消息签名验证(NOMS/ORIS-001) |
| **区块探索** | 优先使用 blocklattice.io 生成账户/区块/交易链接,支持交易历史查询 |
执行架构(双路径设计)
首选: MCP tools (xno-mcp) — 结构化输入输出,自动处理签名/PoW/广播
↓ 不可用时降级
备选: CLI (xno-skills@4.1.0) — bunx/pnpm dlx/npx 执行,需处理 stdout两者底层完全一致,仅访问方式不同。关键安全规则:永不使用 curl、自定义脚本、手动 PoW,或调用 block 子命令(仅输出未签名十六进制,无法上链)。
显著优点
- 确定性最终性:ORV(Open Representative Voting)共识,>67% 在线权重投票即确认,通常 <1 秒
- 零手续费:无 gas、无矿工、无区块生产者
- 账户链架构:Block-lattice 设计,每个账户独立成链,理论吞吐量仅受网络延迟限制
- 安全设计:OWS 加密存储私钥,LLM 上下文永不接触明文密钥;
maxSendXno默认 1.0 硬上限防止意外大额支出 - 故障恢复:内置 RPC 端点自动切换与指数退避,配置热重载无需重启
潜在局限与风险
| 局限 | 说明 |
|:---|:---|
MCP 依赖 | 高级功能(如消息签名)依赖上游 PR #217 未合并,需 CLI 降级且用户自行处理私钥
PoW 计算成本 | 发送块 PoW 难度为接收的 8 倍,CPU 密集型;首启需 5-15 秒 WASM 预热
Pending 资金非自动 | 收款方必须主动 publish receive block,资金在 pending 状态下不可花费
地址格式敏感 | 32 字符 Base32 字母表(无 0/l/v/i),65/64 字符长度严格校验
供应集中风险 | 代表权重分布影响去中心化程度,需用户主动选择高信誉代表
适合人群
- 个人用户:日常收发、余额监控、QR 支付
- 开发者/商家:集成 payment 跟踪流,需要程序化收款确认
- 分析师:区块浏览、交易溯源、代表监控
常规风险控制
- 地址验证前置:任何
send前强制调用util_validate - 退款确认机制:
payment_refund必须人工确认目标地址,禁止自动猜测 - 私钥零暴露:拒绝导出助记词,CLI 签名仅支持占位符模式(
YOUR_PRIVATE_KEY_HEX) - 支出硬限制:
maxSendXno变更需人工显式授权,禁止自动上调 - 供应链锁定:仅使用
xno-skills@4.1.0与@open-wallet-standard/core,禁止第三方包