关于 polybaskets-overview
polybaskets-overview 是介绍 PolyBaskets 的技能;它是 Vara Network 上的预测市场聚合器,将 Polymarket 结果组合为加权篮子。内容说明从领取 CHIP、创建或选择篮子,到投注、结算和领取赔付的流程。
主要功能
- 01介绍 Polymarket 结果加权篮子
- 02说明 CHIP 领取与连签奖励
- 03概述 CHIP、VARA 和免费投注路径
- 04总结篮子指数与赔付计算
- 05详述结算阶段及相关程序
适用场景
- 01了解篮子投注的完整流程
- 02选择 CHIP 或原生 VARA 投注方式
- 03查看结算如何影响仓位赔付
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ adityaakr/ polybaskets --skill polybaskets-overview安装后在 Claude Code 中输入/polybaskets-overview确认已加载。
详细介绍
PolyBaskets 概览
什么是 PolyBaskets
PolyBaskets 是 Vara Network 上一种类似 ETF 的预测市场聚合器。它将多个 Polymarket 结果打包成一个加权篮子——一笔交易即可构建一个投资组合。
Agent 循环
Claim CHIP → Search markets → Build basket → Create on-chain → Bet → Wait → Claim payout
- 领取 CHIP — 每小时可免费领取代币,连续按 UTC 日领取可获得连领奖励(连续领取的天数越多,每次领取的 CHIP 越多)
- 搜索 Polymarket — 通过 Gamma API 查找有意思的活跃市场
- 构建篮子 — 选择足够多的市场,以满足
GetConfig.min_items_per_basket(当前合约默认值:2;硬性上限:32),为每个市场选择 YES/NO,并分配百分比权重(总和必须为 100%) - 在链上创建篮子 — 将篮子提交到 BasketMarket 合约(返回一个篮子 ID)
- 授权 + 下注 — 授权 BetLane 使用 CHIP,获取签名报价,然后下注(一次下注覆盖整个篮子)
- 等待 — Polymarket 市场结算,结算方发起链上结算提案
- 领取 — 如果结算指数高于你的入场指数,你就能获利。领取赔付。
- 重复 — 一小时后领取更多 CHIP,押注自己的篮子或他人创建的篮子
你也可以跳过第 2–4 步,押注其他用户创建的现有篮子。
CHIP 代币
CHIP 是平台提供的免费下注代币(BetToken 合约)。Agent 可通过以下方式赚取 CHIP:
- 每小时领取 — 每小时调用一次
BetToken/Claim。奖励 =base_claim_amount + streak_step × (streak_days − 1),上限为max_claim_amount。第 2 季默认值:基础奖励 500,每连领一天增加 10,上限 600。 - 按 UTC 日计算的连领奖励 — 每个新的 UTC 日首次领取时,连领计数都会增加(同一 UTC 日内多次领取不会增加计数)。错过一个完整的 UTC 日 → 连领天数重置为 1。上限为
streak_cap_days(默认值为 11)。 - 赢得下注 — 从已结算的篮子中获得赔付
通过 BetLane 合约使用 CHIP 押注篮子(授权 CHIP → 下注)。
原生 VARA 免费投注
原生 VARA 免费投注是存储在 FreebetLedger 中的一笔独立、不可提现的余额。它不是 CHIP,也不是归钱包所有、可用于支出的 VARA。
流程如下:
FreebetLedger balance → SpendFreebet → Vara basket freebet position → Claim profit
规则:
- 只有
asset_kind: "Vara"的篮子符合条件。 BasketMarket/IsVaraEnabled必须为 true。- Agent 应调用
FreebetLedger/SpendFreebet,而不是直接调用BasketMarket/BetOnBasketFromFreebetLedger。 - 领取时,免费投注本金会返还到
FreebetLedger;只有超过本金的利润才会支付到钱包。
可执行的 Agent 流程见 ../basket-freebet/SKILL.md。
核心概念
篮子
由多个 Polymarket 结果组成的命名集合,每个结果都带有百分比权重(总和必须为 100%)。当前合约默认要求至少包含 2 个项目,但管理员可以更改 min_items_per_basket;硬性上限为 32 个项目。每个项目指定:
- 一个 Polymarket 市场(通过数字 ID 和 slug 标识)
- 一个选定结果(YES 或 NO)
- 一个以基点表示的权重(例如,40% = 4000 bps,所有权重之和必须为 10000 bps = 100%)
篮子指数
指数是一个加权概率得分:
index = sum( weight_bps[i] / 10000 * probability[i] )
取值范围为 0.0 到 1.0。用户下注时,当前指数会记录在其 Position 的 index_at_creation_bps 中(u16,1–10000)。篮子本身不存储指数——指数根据 Polymarket 的实时价格计算得出。
公式和计算示例见 ../references/index-math.md。
仓位
用户对某个篮子的下注记录,包含:
shares— 投入的 VARA(原生通道)或 CHIP/BetToken(BetLane)数量index_at_creation_bps— 入场指数。如果同一用户多次押注同一个篮子,合约会存储按份额加权的平均入场指数。claimed— 是否已领取赔付
赔付
结算后:
payout = shares * (settlement_index / entry_index)
如果结算指数高于入场指数,则获利;如果更低,则亏损。
结算生命周期
Active → SettlementPending → Settled
(12-min challenge) (users can claim)
- Active — 篮子接受投注
- SettlementPending — 结算者根据 Polymarket 上每个项目的最终结果提出结算方案。挑战窗口随即开始;请从
BasketMarket/GetConfig.liveness_ms读取实际时长。 - Settled — 挑战窗口结束后,任何人都可以调用
FinalizeSettlement。之后,用户可以领取派彩。
程序
| 程序 | 角色 |
|---|---|
| BasketMarket | 核心合约:篮子、VARA 投注、结算、领取 |
| BetToken | CHIP 同质化代币,每小时可领取(基础数量为 500,连续签到的每个 UTC 日增加 10,第 11 天达到上限 600) |
| BetLane | 使用 CHIP 代币的主要投注通道(Bet 资产类型) |
| FreebetLedger | 原生 VARA 免费投注余额账本;将余额用于 Vara 篮子投注,并接收返还的本金 |
两种资产类型
每个篮子在创建时都会设置 asset_kind:
- Bet (CHIP) — 默认类型。用户通过 BetLane 使用 CHIP 代币投注(每小时领取 → 授权 → 投注)。这是 Agent 的主要路径。
- Vara — 用户通过 BasketMarket 使用原生 VARA 代币投注。原生 VARA 免费投注也通过 FreebetLedger 使用 Vara 篮子。在某些部署中可能会被禁用。
资产类型决定了哪个程序负责处理该篮子的投注和领取。
后续步骤
完整流程(推荐):
- 领取 CHIP 代币:
../basket-bet/SKILL.md(步骤 1) - 搜索市场并创建篮子:
../basket-create/SKILL.md - 授权并投注你的篮子:
../basket-bet/SKILL.md(步骤 4-5) - 浏览篮子并查看持仓:
../basket-query/SKILL.md - 领取派彩:
../basket-claim/SKILL.md
原生 VARA 免费投注流程:
- 使用不可提现的 VARA 免费投注余额:
../basket-freebet/SKILL.md
仅限结算者角色:
- 结算篮子:
../basket-settle/SKILL.md