SuperAPI AI 工具集

polybaskets-skills

智能体与模型

查看项目

更新于 10-15 11:06

技能介绍

用途

PolyBaskets Skills 是一套供 AI 智能体使用的技能包,用于与部署在 Vara Network 主网上的 PolyBaskets 交互。PolyBaskets 是一个 ETF 风格的预测市场篮子聚合器:用户把多个 Polymarket 预测市场按百分比权重组合成一个「篮子」,再对篮子整体下注,市场结算后按指数计算并领取赔付。

主要能力

技能包覆盖以下操作:

  • 创建钱包并配置主网(vara-wallet config set network mainnet)。
  • 检查与刷新 gas 凭证(voucher),采用按小时分档模型,每次批量 POST 注册所需程序并增加 500 VARA,每个钱包每小时最多一次。
  • 在链上注册智能体名称(BasketMarket/RegisterAgent,3-20 字符,小写字母数字加连字符)。
  • 每小时领取免费 CHIP 代币(BetToken/Claim)。奖励为 500 + 10 ×(连续天数 − 1)CHIP,上限 600;连续天数按 UTC 自然日推进,漏掉一整天则重置为 1。
  • 搜索 Polymarket 市场、挑选市场并分配权重(权重之和须为 100%)来构建篮子。
  • 在链上创建篮子。
  • 授权 CHIP 支出(BetToken/Approve)后,通过报价服务获取签名报价,再调用 BetLane/PlaceBet 下注。
  • 查询篮子、持仓与结算状态(BasketMarket/GetBasket、GetSettlement 等)。
  • 在结算状态为 Finalized 后领取赔付(BetLane/Claim)。
  • 原生 VARA 免费投注流程:查询 FreebetLedger/BalanceOf,查找或创建 asset_kind 为 "Vara" 的篮子,计算 index_at_creation_bps,调用 FreebetLedger/SpendFreebet,验证 BasketMarket/GetFreebetPositions,并通过 BasketMarket/Claim 领取。免费投注本金在领取时返回 FreebetLedger,只有超过本金的利润支付到钱包。
  • 结算者角色:提出与最终确定结算(basket-settle)。

使用方式

技能包以 SKILL.md 文档与可复制粘贴的命令块组织,按智能体意图路由到不同子技能:basket-bet(领取 CHIP、授权与下注)、basket-create(搜索市场并创建篮子)、basket-query(浏览篮子、查询持仓与结算)、basket-claim(领取赔付)、basket-freebet(原生 VARA 免费投注)、basket-settle(结算者)、polybaskets-overview(协议、指数数学与赔付公式)。

典型智能体循环为:创建钱包 → 检查/刷新 gas 凭证 → 注册名称 → 领取 CHIP → 搜索市场 → 构建篮子 → 上链创建 → 授权并下注 → 等待市场结算 → 检查结算是否 Finalized → 领取赔付 → 循环。也可跳过创建步骤,直接对他人已创建的篮子下注。

依赖 vara-wallet 命令行工具(需 0.10+ 版本,用于 PlaceBet 参数中的 hex→bytes 自动转换),并推荐安装 vara-skills 以获得完整 Vara Network 支持。技能包需要定位 IDL 文件目录(可通过 POLYBASKETS_SKILLS_DIR 环境变量指定)。

适用场景

适合希望让 AI 智能体自主参与 PolyBaskets 预测市场篮子经济(Season 2)的用户,包括领取免费 CHIP、构建并下注篮子、查询与领取赔付,以及处理原生 VARA 免费投注余额。

限制与规则

  • 仅支持主网(wss://rpc.vara.network),禁止切换到测试网;测试网没有合约与凭证。
  • 每次调用必须加 --idl <path>,否则调用失败。
  • 写操作(Claim、Approve、PlaceBet、SpendFreebet)需使用 --account agent --voucher $VOUCHER_ID;只读查询不加。
  • 未经用户在当前会话中明确批准,不得花费钱包自身的 VARA。
  • actor_id 参数必须为 0x 开头的十六进制格式,SS58 地址会失败。
  • CHIP 金额为原始单位(12 位小数),须以带引号字符串传入。
  • 下注前必须先授权(BetToken/Approve),否则会因 BetTokenTransferFromFailed 失败。
  • PlaceBet 应显式指定 --gas-limit,推荐流程为报价 → 估算 → 发送,缓冲建议为估算值 × 1.2 + 5_000_000_000。
  • 避免同一账户并行发送 PlaceBet;遇到 OperationInProgress 应先检查状态而非盲目重试。
  • 除非拥有结算者角色,否则不要调用 ProposeSettlement。
  • 默认公开智能体路径为 CHIP(BetLane,asset_kind 为 "Bet");原生 VARA 免费投注仅在用户明确要求时使用,且需先确认 BasketMarket/IsVaraEnabled=true。
  • poly_market_id 是形如 "540816" 的数字字符串,不是十六进制 conditionId。

关于收费、价格、平台覆盖范围等更多细节,资料暂未提供。