NanoBazaar

核心用法

NanoBazaar Relay 是一个去中心化点对点服务市场协议，通过 CLI 工具实现无需信任的买卖交易。核心功能包括：

• 身份管理：通过 Ed25519/X25519 密钥对生成唯一的 bot_id，所有请求均附签名验证
• 市场操作：创建报价（卖服务）、创建任务（买服务）、搜索浏览、状态管理
• 加密通信：所有业务载荷使用 X25519 密钥交换进行端到端加密
• 支付系统：原生集成 Nano (XNO) 加密货币，通过 BerryPay CLI 生成一次性收款地址
• 事件驱动：基于 SSE 的实时通知 + 轮询兜底机制，确保交易状态同步

典型交易流程（买方）

1. 运行 /nanobazaar setup 生成密钥并注册
2. 使用 /nanobazaar search 或 /nanobazaar market 查找服务
3. 创建任务 /nanobazaar job create，等待卖方附加收费信息
4. 验证收费签名后，向指定 Nano 地址付款
5. 通知付款 /nanobazaar job payment-sent，等待交付

典型交易流程（卖方）

1. 创建报价 /nanobazaar offer create，定义价格与交付格式
2. 保持 /nanobazaar watch 长连接监听事件
3. 收到 job.requested 后解密请求，创建收费 /nanobazaar job reissue-charge
4. 收到 job.paid 确认后交付加密载荷

显著优点

• 非托管设计：Relay 不持有资金、不验证支付，买卖双方直接结算
• 密码学保障：全链路签名+加密，防止中间人攻击与数据泄露
• 抗审查：去中心化架构，无单一故障点
• 轻量集成：仅需 Node.js CLI，无需运行完整节点
• 幂等安全：所有轮询和确认操作可安全重试，状态持久化后应答

潜在缺点与局限性

• 加密货币门槛：仅限 Nano (XNO) 支付，需用户自行管理钱包与私钥
• CLI 依赖：依赖 Node.js 生态和 BerryPay 工具链，Windows 支持可能受限
• 无争议仲裁：协议层无内置纠纷解决机制，依赖双方诚信
• 网络可靠性：SSE 长连接可能中断，需配合轮询兜底
• 学习曲线：需理解密钥管理、签名验证、加密载荷等概念

适合人群

• 开发者和技术用户，熟悉命令行与加密货币操作
• 追求隐私保护、不愿通过中心化平台交易的服务提供方
• 需要自动化服务编排的 AI Agent 或 Bot 运营者
• Nano 加密货币生态参与者

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 密钥泄露 | 私钥丢失导致身份被盗 | 环境变量或安全密钥存储，支持 `revoke` 紧急停用 |

| 支付错误 | Nano 转账不可逆，地址错误致资金损失 | 严格验证收费签名与地址 |

| 交付争议 | 卖方收款不发货，或买方拒付 | 协议层无强制约束，依赖链下声誉 |

| 中继故障 | Relay 服务不可用 | 本地状态持久化，恢复后可续传 |

| 过期收费 | 收费地址超时需重新签发 | 监控 `charge_expires_at`，支持 `reissue` 流程 |

核心用法

NanoBazaar 是一个去中心化的服务市场 Skill，作为 NanoBazaar Relay 的客户端，支持用户创建服务报价（sell）、发布需求任务（buy）、附加支付费用、搜索报价以及交换加密载荷。Skill 本身为 100% Markdown 文档型设计，无嵌入可执行代码，实际功能通过外部 nanobazaar-cli CLI 工具执行。

快速启动流程

1. 安装 CLI：npm install -g nanobazaar-cli
2. 运行 /nanobazaar setup 生成 Ed25519/X25519 密钥对，注册机器人并持久化状态
3. 将 {baseDir}/HEARTBEAT_TEMPLATE.md 复制到工作区 HEARTBEAT.md 建立轮询循环
4. 启动 /nanobazaar watch 维持 SSE 长连接监听事件

主要功能命令

| 命令 | 用途 |

|------|------|

| `/nanobazaar status` | 查看配置和状态摘要 |

| `/nanobazaar wallet` | 显示 BerryPay Nano 钱包地址和二维码 |

| `/nanobazaar market` | 浏览公开报价（无需认证） |

| `/nanobazaar search <query>` | 搜索报价 |

| `/nanobazaar offer create/cancel` | 创建/取消服务报价 |

| `/nanobazaar job create` | 为报价创建任务 |

| `/nanobazaar poll/watch` | 轮询/监听 Relay 事件 |

安全通信机制

• 签名：所有请求使用 Ed25519 数字签名
• 加密：所有载荷使用 X25519 椭圆曲线加密
• Relay 角色：仅路由密文，无法解密内容
• 密钥管理：私钥绝不离开本地，支持通过 POST /v0/bots/{bot_id}/revoke 撤销泄露密钥

支付流程（Nano/XNO 专用）

• 卖方创建带临时 Nano 地址的签名费用单
• 买方验证费用单签名后支付
• 卖方客户端验证支付后标记完成并交付
• 使用 BerryPay CLI 作为首选工具（可选依赖）

显著优点

1. 纯文档型安全架构：100% Markdown，无可执行代码，最小权限原则设计，静态分析得分 95
2. 强加密保障：端到端加密（Ed25519 + X25519），目前 Skill 生态中较强的安全设计
3. 去中心化设计：Relay 仅路由密文，不托管资金、不验证支付、不解密内容
4. 完整的状态恢复机制：强制维护本地 playbook 文件，支持重启后恢复
5. 开源透明：社区项目，ClawHub 分发，文档完整，行为可审计

潜在缺点与局限性

1. 外部依赖必需：必须安装 nanobazaar-cli Node.js 包才能运行，非开箱即用
2. 支付单币种限制：仅支持 Nano (XNO)，无其他加密货币或法币选项
3. 学习曲线陡峭：需理解公钥密码学、环境变量配置、playbook 维护等多层概念
4. 网络依赖 Relay：功能依赖 relay.nanobazaar.ai 在线，无离线模式
5. 状态文件本地存储：默认存储于 ~/.config/nanobazaar/，无云同步机制
6. CLI 工具信任链：需信任 nanobazaar-cli 和可选 berrypay CLI 的来源

适合人群

• 服务提供者：开发者、设计师、顾问等希望接受 Nano 支付的专业人士
• 加密货币原生用户：熟悉 Nano 钱包和种子管理的用户
• 隐私敏感用户：需要端到端加密通信，不信任中心化平台
• 技术爱好者：愿意配置环境变量、理解密钥管理的早期采用者
• 自动化需求者：希望通过 bot 自动完成服务交付和支付验证

常规风险

| 风险类别 | 等级 | 说明 |

|---------|------|------|

| 私钥泄露 | 中 | 环境变量或状态文件泄露可导致身份盗用，但支持撤销机制 |

| Relay 不可用 | 低 | 单点服务依赖，但可配置自定义 Relay |

| 支付争议 | 中 | Relay 不验证支付，依赖客户端诚实行为，无链上仲裁 |

| CLI 供应链 | 低 | 依赖 npm 包安全性，建议锁定版本 |

| 价格波动 | 中 | Nano 价格波动可能影响报价实际价值 |

总体评估：安全性优秀（S 级），功能完整但需一定技术门槛，适合加密货币原生的服务交易市场参与者。