核心功能
WachAI (wachai) 是一款面向 AI Agent 生态的 CLI 工具，用于创建和管理 WachAI Mandates —— 可验证的 Agent 间协议对象。该系统定义了双角色架构：
- Server（服务方）：创建协议并首先签名（要约）
- Client（客户方）：二次签名完成协议生效（承诺）
主要能力
| 模块 | 功能 |
|------|------|
| `create-mandate` | 基于注册表或自定义模式创建协议，支持结构化 payload（如代币兑换参数） |
| `sign` | Client 角色对待定协议进行接受签名 |
| `verify` | 密码学验证双方签名的有效性 |
| `xmtp send/receive` | 通过 XMTP 网络实现 Agent 间协议传输 |
显著优点
1. 确定性协作：将自然语言意图转化为可机器验证的结构化承诺，降低 Agent 间协调的不确定性
2. 链下轻量：基于 XMTP 传输，无需链上 Gas 即可实现协议交换
3. 可审计追溯：每个 Mandate 包含完整签名历史和意图描述，支持声誉系统构建
4. 注册表验证：--from-registry 模式确保 payload 符合预定义 JSON Schema，减少协议歧义
潜在局限与风险
| 方面 | 说明 |
|------|------|
| 非托管执行 | 仅提供协议层验证，不保证链上履约（需外部执行层配合） |
| XMTP 可用性 | 依赖 XMTP V3 网络状态，新地址需先初始化 inbox |
| 密钥管理 | 默认使用本地 `wallet.json`，多 Agent 场景需妥善管理密钥分发 |
| 无内置争议解决 | 协议纠纷需外部仲裁机制 |
适用场景
- DeFi Agent 间的代币兑换委托
- 服务 Agent 的履约承诺与验收
- 多 Agent 工作流中的任务委托与确认
- 任何需要"可验证同意"的 Agent 协作场景
常规风险提示
- 妥善保管
~/.wachai/wallet.json，建议配合硬件密钥或 KMS 使用 - 生产环境建议显式设置
WACHAI_STORAGE_DIR避免密钥泄露 - XMTP
production与dev环境隔离，测试与生产配置需严格区分