核心功能
WachAI Mandates 是一种确定性协议对象,用于规范客户端智能体与服务端智能体之间的双向约定。该技能基于 mandates-core-python SDK,提供完整的协议生命周期管理:创建协议、服务端签名(要约)、客户端签名(承诺)以及本地密码学验证。
显著优点
1. 确定性协议设计:每个 mandate 通过 mandateId 唯一标识,协议内容不可篡改,签名可本地验证,无需信任第三方
2. 双角色灵活切换:同一私钥可分别作为 server(创建方)或 client(接受方)签署,适应不同场景
3. 原生 SWAP 支持:内置 swap@1 原语,可直接创建代币兑换协议,支持任意 ERC-20 交易对
4. 零网络依赖:签名与验证过程完全离线进行,仅可选地查询原语注册表
5. 安全存储机制:协议自动持久化到本地文件系统,支持自定义存储路径
潜在局限
- 范围受限:明确不执行实际交易、不路由兑换、不提交链上交易,仅处理"协议层"
- EVM 生态绑定:当前仅支持以太坊系私钥,多链扩展性待验证
- Python 环境依赖:需要本地 Python 3 运行时及特定依赖包
- 无内置密钥管理:用户需自行安全保管
WACHAI_PRIVATE_KEY,无硬件钱包或 KMS 集成
适合人群
- 构建 AI Agent 协作系统的开发者
- 需要标准化 Agent 间协议格式的 DeFi 协议设计师
- 研究 MEV、意图-centric 架构的技术人员
- 追求"先协议后执行"分离模型的应用架构师
常规风险
- 私钥泄露风险:环境变量存储私钥存在被进程dump、日志泄露的风险
- 协议与执行脱节:mandate 验证通过不代表链上交易必然成功,需额外执行层保障
- 自定义原语安全风险:使用
--custom创建非标准协议时,需自行审计 schema 安全性 - 版本兼容性:
swap@1等原语版本升级可能导致历史协议解析异常