核心用法
本技能为Nano (XNO)加密货币提供全栈钱包操作与链上交互能力。执行路径采用MCP优先、CLI降级的双层架构:优先调用xno-mcp工具集(如wallet_send、wallet_receive、wallet_balance、util_qr等),若环境不支持MCP则自动降级至xno-skills@4.0.0 CLI命令行工具。
关键操作流程:
- 钱包发现:任何操作前必须先执行
wallet_list识别现有钱包 - 资金接收:检测到pending状态时立即自动调用
wallet_receive,支持未开通账户的自动开户(open block) - 资金发送:通过
wallet_send执行,默认1.0 XNO限额,超限需人工确认调整 - 支付请求:
payment_create生成nano:URI →payment_receive确认到账状态 - 安全退款:
payment_refund或wallet_send配合历史查询,必须人工确认目标地址
单位与验证:
- 30位小数精度(1 XNO = 10³⁰ raw),强制使用
util_convert工具避免浮点误差 - 地址离线验证支持
nano_(65字符)和遗留xrb_(64字符)格式 - 区块探索默认指向blocklattice.io
显著优点
1. 双层执行安全:MCP工具自动处理签名、PoW、广播;CLI降级时仍保持相同底层代码路径,拒绝自定义脚本或curl RPC调用
2. OWS密钥隔离:私钥全程由Open Wallet Standard管理,Agent永不接触明文密钥或助记词
3. 确定性最终性:ORV共识机制下交易<1秒确认,无gas费、无pending池拥堵
4. 零配置启动:默认集成rainstorm.city与nanoslo.0x.no公共节点,本地WASM PoW无需外部工作节点
潜在局限与风险
架构限制:
- 消息签名(NOMS/ORIS-001)依赖OWS上游PR #217,暂不可用
- CLI的
block send/block receive仅输出未签名十六进制,禁止作为失败回退
操作风险:
- 地址不可逆:Nano转账即时最终,发送前必须
util_validate验证目标地址 - Pending资金陷阱:接收方必须主动发布receive block,资金pending状态可永久持续
- stdout截断:QR码生成需用
--json或重定向文件避免终端截断
网络依赖:
- RPC端点可能触发速率限制,内置指数退避与节点切换机制
- 单次操作限制:最多3次同工具重试、2次RPC端点切换
适合人群
- Nano持币用户:日常收发、余额监控、QR支付
- 开发者/集成者:需要程序化Nano交互的自动化工作流
- 商户收款方:利用payment请求追踪入账,支持部分付款检测
- 节点运营者:通过
rpc_probe-caps等工具诊断网络状态
常规风险控制
| 场景 | 防护措施 |
|---|---|
| 私钥泄露 | 禁止导出助记词,拒绝处理原始私钥(仅允许占位符模式) |
| 误发资金 | 强制地址验证+人工确认,大额退款需显式地址二次确认 |
| 限额绕过 | `maxSendXno`变更必须人工指令,禁止自动提升 |
| 供应链污染 | 严格锁定`xno-skills@4.0.0`与`@open-wallet-standard/core` |
| 无限循环 | 5次工具调用未完成任务则强制停止并上报 |