haggle-protocol

🤝 AI代理链上谈判与托管协议

首个AI代理链上谈判协议,支持Base主网USDC托管与多轮报价,本地签名保障私钥安全,实现无信任公平定价。

收藏
9.9k
安装
3.1k
版本
v1.0.2
CLS 安全性认证2026-05-07
点击查看完整报告 >

使用说明

Haggle Protocol 是一个专为 AI 代理设计的链上谈判协议,旨在解决自动化代理之间服务定价的不确定性问题。该协议通过智能合约实现多轮交替报价机制,允许买方和卖方在 Base 主网(使用真实 USDC)或各类测试网(Solana Devnet、Monad Testnet 等)上进行去信任化的价格发现。

核心用法方面,用户首先需要通过 npm 安装 MCP 服务器或 TypeScript SDK,并配置 HAGGLE_PRIVATE_KEY 环境变量。Workflow 开始于买方创建谈判并托管 USDC 资金到协议控制的保险库,随后双方通过链上交替提交报价进行博弈。协议引入了"托管衰减"机制,每轮谈判未达成一致时托管资金会按设定比例(如 2%)递减,创造时间压力促使双方尽快达成公平价格。一旦任一方接受对方报价,智能合约自动执行结算:卖方获得约定金额(扣除 0.5% 协议费),买方获得剩余托管资金退款。

显著优点包括:真正的去信任化设计,资金由合约托管而非第三方;多链部署支持(Base、Solana、Monad、Arbitrum),兼顾主网生产环境和测试网开发需求;完善的本地安全架构,私钥仅用于本地签名,不会传输或存储;纯数值报价机制消除了提示注入风险;无遥测和跟踪,隐私保护到位。

潜在局限不容忽视:智能合约尚未经过正式安全审计,存在潜在的代码漏洞风险;仅支持数值型报价,无法处理复杂的服务描述或条件谈判;作为 T3 来源的个人项目,长期维护和支持能力有待观察;需要用户具备一定的区块链知识(私钥管理、gas 费、交易确认等)。

适合人群主要包括:开发 AI 代理的工程师,需要为代理间服务交换建立定价机制;DeFi 高级用户,熟悉链上操作并寻求自动化交易工具;研究人员和开发者,希望在测试网上验证多智能体经济交互场景。

使用风险需特别关注:涉及真实资金(USDC)操作,建议仅使用小额专用钱包资金;私钥管理责任完全在用户,一旦泄露将导致资金损失;链上交易存在 gas 费成本和网络拥堵风险;合约暂停功能虽为安全考量,但也意味着中心化控制点;测试网与主网行为可能存在差异,迁移时需谨慎验证。

安全解读

核心用法

Haggle Protocol 是一个去中心化协商协议,允许两个AI智能体通过多轮交替报价达成公平价格。核心流程包括:买方存入USDC托管资金→卖方接受邀请→双方轮流出价→托管资金随回合衰减施加时间压力→任一方接受报价即触发结算。支持 Base Mainnet(真实USDC)、Solana/Monad/Arbitrum 测试网(测试代币)。

显著优点

1. 首创性:首个专为AI智能体设计的链上协商基础设施,填补AI Agent经济交互的空白
2. 博弈优化:托管衰减机制(decayRateBps)创造时间压力,理论上加速价格发现

3. 多链覆盖:同时支持EVM生态(Base、Monad、Arbitrum)和Solana,灵活性高

4. 透明度高:智能合约开源、npm包版本固定、无遥测追踪,符合密码朋克精神

5. 本地签名:私钥仅用于本地ethers.js签名,不上传至任何服务器

潜在缺点与局限性

1. 合约未审计:文档明确披露智能合约未经正式安全审计,存在重入、权限控制等未知漏洞风险
2. 私钥风险:需要HAGGLE_PRIVATE_KEY进行链上交易,用户操作失误(如使用主钱包、泄露私钥)将导致不可逆资金损失

3. T3来源等级:由个人开发者eijiac24维护,非顶级机构背书,长期维护能力存疑

4. 供应链依赖:依赖@haggle-protocol/*系列npm包,需信任该组织的安全实践

5. 功能单一:仅支持数值报价(uint256),无法处理复杂条件协商或服务履约验证

6. 资金效率低:托管资金锁定期间产生机会成本,且失败谈判消耗gas费

适合人群

  • AI Agent开发者:需要为智能体赋予经济协商能力的构建者
  • DeFi高级用户:熟悉智能合约交互、理解MEV和gas优化的区块链从业者
  • 自动化交易员:寻求程序化采购服务(数据、计算、API访问)且价格敏感的用户

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 资金损失 | **高** | 私钥泄露、合约漏洞、误操作均可导致USDC永久丢失 |
| 智能合约 | **中** | 未审计合约可能存在逻辑缺陷,建议小额试水 |
| 供应链 | **低** | npm包被篡改风险,建议安装后执行`npm audit` |
| 网络 | **低** | 依赖公共RPC端点,存在隐私泄露和服务中断可能 |

haggle-protocol 内容

scripts文件夹
手动下载zip · 4.8 kB
setup.shtext/x-shellscript
请选择文件