agent-market

🎯 Base链预测市场全能交互工具

基于Base Sepolia的去中心化预测市场协议交互工具,支持创建市场、交易仓位和流动性管理,代码安全规范但需妥善保管私钥。

收藏
1.1k
安装
452
版本
v0.1.0
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

AgentMarket Skill 是一个专为 Base Sepolia 测试网设计的去中心化预测市场交互工具,允许用户通过自然语言或结构化命令完成从市场创建到资金结算的全生命周期管理。该 Skill 通过与 MarketFactory 智能合约交互,实现了二元预测市场(YES/NO)的完整功能闭环,包括市场创建、仓位交易(买卖 YES/NO 代币)、流动性提供(LP)以及基于乐观预言机的争议解决机制。

核心用法围绕 USDC 结算的预测市场生态展开。用户可调用 market_create 创建新市场(需 2 USDC:1 USDC 协议费 + 1 USDC 初始流动性),通过 market_buy_yesmarket_buy_no 进行方向性押注,利用恒定乘积 AMM 机制实时交易。市场决议采用乐观预言机设计:任何人可质押 USDC 保证金提出结果,经过争议窗口期后若无挑战即可 finalize;若遇争议,则由预设仲裁者进行最终裁决。流动性提供者可通过 market_add_liquidity 注入资金赚取 0.3% 交易手续费,但需承担无常损失风险。

显著优点在于功能完备性与技术实现规范。该 Skill 提供了预测市场所需的全部核心工具(涵盖 18 个具体操作),文档详尽说明了费用结构(0.1% 协议费 + 0.3% AMM 费)、经济机制与仲裁流程。代码层面采用 TypeScript 与 viem 库进行区块链交互,具备完整的类型安全封装;私钥通过环境变量管理,无硬编码风险;所有交易均设置 5 分钟截止时间保护,并配备完善的错误处理机制。

潜在局限性主要体现在网络限制与来源可信度。当前仅支持 Base Sepolia 测试网,主网部署需手动配置合约地址;技能来源于 GitHub 个人账号(T3 级别),虽经安全审计但缺乏机构背书。功能上仅支持二元预测市场,无法处理多结果预测场景。此外,预言机争议解决依赖预设仲裁者,若仲裁者失能可能导致资金暂时锁定(需通过 market_reset_dispute 紧急重置)。

适合目标群体包括:DeFi 开发者(测试预测市场协议集成)、量化交易员(自动化策略执行)、区块链研究员(验证乐观预言机机制)以及社区治理参与者(担任市场仲裁者)。对于希望构建自动化交易 agent 或流动性管理机器人的开发者尤为适用。

常规使用风险需特别关注私钥安全与网络环境混淆。尽管代码本身无注入漏洞,但 WALLET_PRIVATE_KEY 的配置要求意味着用户需承担密钥泄露风险,建议使用专用测试钱包。Base Sepolia 虽为测试网,但涉及真实 USDC 水龙头资金与 ETH gas 费,操作失误仍会造成损失。此外,智能合约风险(尽管代码审计通过但合约本身可能存在逻辑漏洞)、预言机操纵风险(低流动性市场易受攻击)以及流动性提供的无常损失均需用户自行评估。务必确认交易参数(尤其是合约地址与金额)后再执行签名。

安全解读

AgentMarket Skill 综合评估

核心用法

AgentMarket Skill 是一款与 Base Sepolia 测试网上的预测市场协议交互的 Web3 工具集。用户可通过该 Skill 完成预测市场全生命周期操作:创建 YES/NO 二元市场、买卖预测头寸、提供 AMM 流动性、参与争议仲裁及结算收益。所有交易以 USDC 计价结算,通过恒定乘积做市商(FPMM)机制实现价格发现。

关键操作流程
1. 市场浏览 (market_list):查看活跃市场的当前价格与预言机状态

2. 头寸交易 (market_buy_yes/market_buy_no):最低 2 USDC,0.1% 协议费+0.3% AMM 费

3. 流动性管理 (market_add_liquidity/market_remove_liquidity):LP 赚取交易费,承担无常损失风险

4. 预言机决议 (market_propose_outcomemarket_finalizemarket_disputemarket_arbitrate):乐观预言机机制,默认 5 USDC 保证金,争议后由指定仲裁人裁决

5. 收益提取 (market_claim/market_lp_withdraw):胜方按比例瓜分全部 USDC 池

显著优点

  • 完整功能覆盖:囊括预测市场从创建到结算的全流程,包括独特的 LP 收益结算路径(market_lp_claim_winningsmarket_lp_withdraw
  • 经济机制透明:费用结构清晰(创建费 1 USDC + 流动性 1 USDC,交易费 0.4%),预言机保证金机制激励诚实参与
  • 技术实现规范:TypeScript 类型安全,依赖 viem 等知名区块链库,无危险函数使用
  • 紧急退出机制market_emergency_withdraw 为无法决议的市场提供资金回收通道

潜在缺点与局限性

  • 测试网限制:仅支持 Base Sepolia,主网部署状态不明,测试网代币无实际价值
  • 私钥依赖:必须配置 WALLET_PRIVATE_KEY 环境变量,存在密钥泄露风险
  • 仲裁中心化:争议最终由预设 arbitrator 地址裁决,非完全去中心化
  • 流动性风险:LP 面临显著无常损失,尤其是市场向单一方向剧烈移动时
  • 来源可信度中等:T3 级个人开发者项目(humanjesse),GitHub 账号较新,需自行验证合约安全性

适合人群

  • 预测市场爱好者:希望体验 Polymarket 类产品的开发者与用户
  • DeFi 流动性提供者:愿意承担无常损失换取交易费收益的进阶用户
  • Web3 开发者:研究 AMM+FPMM+乐观预言机组合机制的工程人员
  • Hackathon 参与者:Circle USDC Hackathon 相关项目的参考实现

常规风险

| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 密钥安全 | `WALLET_PRIVATE_KEY` 泄露可导致资金损失 | 使用专用测试网钱包,禁用主网私钥 |
| 合约风险 | 硬编码地址可能与官方部署不一致 | 独立验证 Etherscan/BaseScan 合约源码 |
| 预言机操纵 | 低流动性市场可能被保证金攻击 | 避免参与深度不足的市场 |
| 争议僵局 | 仲裁人 inactive 导致 7 天锁定期 | 监控 `market_arbitrator_check` 状态 |
| 项目弃用 | 个人项目维护不确定性 | 关注 GitHub 更新频率,分散资金暴露 |

agent-market 内容

abi文件夹
手动下载zip · 11.7 kB
BinaryMarket.tstext/plain
请选择文件