wachaimandates

核心功能

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 等原语版本升级可能导致历史协议解析异常

核心用法

WachAI Mandates是client agent与server agent之间的确定性协议对象，本Skill基于Python SDK (mandates-core) 提供完整的协议生命周期管理。核心操作包含三类：

创建协议：通过/wachai create-mandate命令生成协议体。支持两种模式——--swap模式用于标准代币交换场景（需指定代币合约地址、数量），--custom模式支持自定义协议类型（通过JSON定义业务字段）。创建完成后自动以server身份签名，生成具有唯一mandateId的协议文件。

客户端签署：通过/wachai sign <mandate-id>加载本地存储的协议，以client身份完成 countersign，实现双向承诺。

本地验证：通过/wachai verify <mandate-id>离线校验server与client双签的有效性，返回布尔状态确认协议完整性。

配置要求：需设置WACHAI_PRIVATE_KEY环境变量提供EVM私钥（server/client角色由调用场景决定），支持.env文件自动加载；存储路径可通过WACHAI_STORE_DIR自定义，默认位于~/.wachai/mandates/。

显著优点

密码学可验证：采用确定性协议结构，双签机制确保双方不可抵赖，验证过程完全本地执行无需网络信任假设。

功能边界清晰：专注协议层操作，明确不涉及资金转移、交易执行、支付处理等金融操作，降低误用风险。

离线能力完整：签名与验证均无需网络连接（除可选的primitive registry查询），适合安全隔离环境部署。

输入安全处理：使用ast.literal_eval替代eval解析用户输入，有效阻断代码注入攻击向量。

灵活扩展性：既支持标准化swap协议，也开放自定义协议类型，满足不同业务场景的agent协作需求。

潜在局限

私钥管理负担：依赖环境变量暴露EVM私钥，虽无私钥硬编码风险，但用户需自行保障.env文件权限（建议600）及环境隔离，缺乏硬件钱包或KMS集成选项。

依赖供应链风险：核心依赖mandates-core（v0.1.3，较新版本）及eth-account，虽后者为成熟以太坊生态库，但前者作为新兴包缺乏长期安全审计积累，需验证PyPI来源真实性。

来源可信度限制：维护者为个人开发者（akshat-mishra101），无GitHub组织背书或GPG代码签名，T3评级意味着社区监督力度弱于企业级项目。

数据持久化风险：协议文件以明文JSON存储于本地，包含交易意向及地址等敏感元数据，需用户主动管理目录权限及定期清理。

网络信任假设：若使用swap@1等标准协议类型，可能触发对WachAI primitive registry的远程查询，引入轻微的外部依赖风险。

适合群体

• 多Agent系统开发者：构建需要形式化协作协议的分布式AI系统
• DeFi协议集成者：需要在agent层标准化代币交换意向表达的场景
• 自动化交易研究者：探索MEV-resistant或 intents-based 交易架构的实验性项目
• 隐私敏感用户：偏好完全离线签名验证、最小网络暴露的协议管理方案

使用风险

性能风险：Python运行时及椭圆曲线签名计算在高频场景下可能成为瓶颈，大规模部署需考虑异步优化。

密钥泄露风险：.env文件若未正确加入.gitignore或权限设置宽松，可能导致私钥意外提交至版本控制。

依赖过时风险：requirements.txt未锁定依赖哈希，供应链攻击或意外版本升级可能引入破坏性变更。

协议语义风险：Skill仅保障签名有效性，不验证协议内容的业务合理性（如代币地址真实性、汇率公允性），需上层应用补充校验。

兼容性风险：mandates-core SDK处于早期版本，API可能随WachAI生态演进发生变动，建议关注官方文档更新。