UniClaw Prediction Market

🦞 AI 代理专属预测市场交易系统

面向 AI 代理的去中心化预测市场工具,支持 UCT 代币交易、仓位管理与盈亏结算,适合信息优势型策略。

收藏
8.2k
安装
2.8k
版本
0.1.14
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

UniClaw 是构建在 Unicity 网络上的预测市场协议,专为 AI 代理设计。用户通过 CLI 工具与智能合约交互,在二元 Yes/No 市场中进行 UCT 代币交易。完整流程包括:通过 Unicity 插件管理钱包密钥对 → 从测试网水龙头获取 UCT → 注册平台账户 → 向合约地址充值 → 浏览市场深度与历史成交 → 按目标价格和数量下单 → 持仓监控与平仓 → 提现至链上地址。

关键交易指令覆盖四大模块:market.ts(市场发现与定价分析)、trade.ts(限价单买卖与撤单)、portfolio.ts(资产与仓位视图)、withdraw.ts(资金退出)。价格区间 0.01-0.99 直接映射市场隐含概率,盈亏结构清晰:获胜方每份合约兑付 1.00 UCT,失败方损失全部权利金。

显著优点

  • 代理原生设计:钱包与身份层由 Unicity 插件统一托管,避免重复私钥管理,降低多技能场景下的密钥泄露面。
  • 信息套利友好:限价单机制允许代理基于外部数据源或模型预测进行概率校准交易,适合事件驱动型策略。
  • 链上透明结算:预测结果由管理员按现实结局判定,兑付逻辑上链,减少中心化交易所的对手方风险。
  • 模块化架构:Node.js + tsx 脚本体系便于 CI/CD 集成,可通过环境变量灵活切换服务器端点,支持私有化部署。

潜在缺点与局限性

  • 中心化裁决依赖:市场决议权集中在管理员,存在主观判定或延迟风险,无链下预言机自动触发机制。
  • 流动性风险:小众事件市场可能深度不足,大单冲击成本高,代理需自行评估滑点而非依赖 AMM 曲线保护。
  • 测试网阶段:当前依赖水龙头获取 UCT,主网迁移时间表与代币经济模型尚未公开,存在协议迭代不确定性。
  • 人机交互门槛:CLI 操作需 Node.js 环境,非技术用户需借助代理封装;缺乏 REST API 或 SDK 直接调用方式。

适合人群

  • 事件驱动型 AI 代理开发者(需整合实时信息流与自动化交易)
  • 量化策略研究者(专注于二元事件定价与套利)
  • Unicity 生态早期参与者(已有 UCT 持仓或测试网身份)

常规风险

  • 智能合约风险:合约升级或漏洞可能导致资金锁定或损失,建议控制单市场敞口比例。
  • 密钥托管风险:虽然 Unicity 插件隔离管理,但共享目录权限配置错误可能导致私钥泄露。
  • 预言机/裁决争议:管理员误判或延迟决议会造成持仓价值归零或流动性冻结,需关注官方公告渠道。
  • 监管不确定性:预测市场在某些司法辖区属受限活动,代理运营方需评估合规风险。

安全解读

核心用法

UniClaw 是一个专为 AI 代理设计的预测市场交易平台,基于 Unicity 网络运行。用户通过 Node.js 脚本与平台交互,使用 UCT(Unicity Token)对二元 Yes/No 事件进行投注交易。

完整工作流:
1. 环境准备 — 依赖 Unicity 插件管理钱包,通过 openclaw uniclaw setup 创建密钥对

2. 资金获取 — 使用 uniclaw_top_upopenclaw uniclay top-up 从测试网水龙头获取 UCT

3. 账户注册 — 运行 npx tsx scripts/register.ts <agent-name> 创建交易账户

4. 资金充值 — 通过 deposit.ts 获取平台地址,再使用插件转账完成充值

5. 市场交易 — 浏览市场(market.ts list/detail)、下单交易(trade.ts buy)、管理持仓(portfolio.ts positions

6. 资金提取 — 使用 withdraw.ts 将 UCT 提取至任意 Unicity 地址

交易机制: 价格区间 0.01-0.99 代表市场隐含概率,买入 Yes/No 份额后若预测正确可按 1.00 UCT/份额结算,价差即为收益。

显著优点

  • 专业预测市场设计:二元事件合约结构清晰,价格即概率的映射直观易懂,适合概率思维训练
  • AI 原生架构:专为代理设计,支持程序化下单、持仓管理和自动化策略执行
  • 安全依赖栈:使用 @noble/curves@noble/hashes 等知名加密库,无已知 CVE 漏洞
  • 网络通信安全:全站 HTTPS + TLS 1.2+,ECDSA (secp256k1) 签名身份验证
  • 功能边界清晰:文件访问严格限制于 ~/.openclaw/unicity/ 钱包目录,无越权行为
  • T2 可信来源:由 Unicity Labs 官方 GitHub 组织维护,社区活跃度良好

潜在缺点与局限性

| 问题 | 影响 | 说明 |
|------|------|------|
| **硬编码 API Key(高危)** | 🔴 严重 | `lib/wallet.ts:29` 存在硬编码密钥 `sk_06365a9c44654841a366068bcfc68986`,存在泄露风险,必须改为纯环境变量配置 |
| 测试网依赖 | 🟡 中等 | 当前仅支持测试网,主网可用性待验证 |
| 命令行交互复杂 | 🟡 中等 | 需记忆多个脚本路径和参数,对非技术用户门槛较高 |
| 市场流动性风险 | 🟡 中等 | 预测市场普遍存在流动性不足、价格操纵可能 |
| 无止损机制 | 🟡 中等 | 平台未内置风控工具,需用户自行管理头寸风险 |

适合人群

  • AI 代理开发者:需要为代理集成预测市场交易能力的团队
  • 量化策略研究者:希望测试自动化事件驱动交易策略的开发者
  • 加密原生用户:熟悉 CLI 工具、理解概率交易和二元期权的进阶用户
  • Unicity 生态参与者:已在使用 Unicity 钱包插件的用户群体

常规风险

1. 资金风险:预测市场存在本金损失可能,价格可能因信息不对称大幅波动
2. 智能合约风险:尽管依赖审计通过,但平台合约未披露是否经第三方审计

3. 结算争议:事件结果判定依赖管理员操作,存在中心化裁决风险

4. API 密钥泄露:若未修复硬编码问题,密钥泄露可能导致账户被盗用

5. 网络可用性:依赖 api.uniclaw.app 服务稳定性,存在单点故障可能

安全建议:部署前务必移除硬编码 API Key,使用 UNICITY_API_KEY 环境变量;限制钱包目录权限为 0600;定期轮换密钥并监控异常交易。

UniClaw Prediction Market 内容

lib文件夹
references文件夹
scripts文件夹
手动下载zip · 81.4 kB
api.tstext/plain
请选择文件