Use when the agent needs to claim payout from a settled basket via vara-wallet. Do not use before settlement is finalized.
Claim payout from a settled PolyBaskets basket via vara-wallet.
MAINNET ONLY. Run vara-wallet config set network mainnet before anything else. NEVER switch to testnet — there are no contracts there.
vara-wallet config set network mainnet
BASKET_MARKET="0x1fa6fd12433accef350a68da4555a2a71acab261c4ae9eb713033023fc0775ea"
BET_LANE="0x40dc1597c8e3beb3523f9c05ad2b44e00a11be6e665da20e4323bb7dfae1ecda"
_PB="${POLYBASKETS_SKILLS_DIR:-skills}"
IDL="$_PB/idl/polymarket-mirror.idl"
BET_LANE_IDL="$_PB/idl/bet_lane_client.idl"
vara-wallet call $BASKET_MARKET BasketMarket/GetSettlement \
--args '[<basket_id>]' --idl $IDL
Check the result:
status: "Finalized" — ready to claimstatus: "Proposed" — challenge window not yet passed. If you have the settler role, see ../basket-settle/SKILL.md to finalize. Otherwise, wait for the settler to finalize (challenge window is ~12 minutes from proposed_at).SettlementNotFound — not yet settled# Parse settlement status
vara-wallet call $BASKET_MARKET BasketMarket/GetSettlement \
--args '[<basket_id>]' --idl $IDL | jq '.result.ok.status'
Get your hex address first (SS58 won't work for actor_id args):
MY_ADDR=$(vara-wallet balance | jq -r .address)
# VARA lane
vara-wallet call $BASKET_MARKET BasketMarket/GetPositions \
--args '["'$MY_ADDR'"]' --idl $IDL | jq '.[] | select(.basket_id == <basket_id>)'
# BET lane
vara-wallet call $BET_LANE BetLane/GetPosition \
--args '["'$MY_ADDR'", <basket_id>]' --idl $BET_LANE_IDL
Check claimed: false.
For baskets with asset_kind: "Vara":
vara-wallet --account agent call $BASKET_MARKET BasketMarket/Claim --voucher $VOUCHER_ID \
--args '[<basket_id>]' --idl $IDL
Returns u128 — payout amount in minimal VARA units (divide by 10^12 for VARA).
# Claim from basket 0
PAYOUT=$(vara-wallet --account agent call $BASKET_MARKET BasketMarket/Claim --voucher $VOUCHER_ID \
--args '[0]' --idl $IDL)
echo "Payout: $PAYOUT"
For baskets with asset_kind: "Bet":
vara-wallet --account agent call $BET_LANE BetLane/Claim --voucher $VOUCHER_ID \
--args '[<basket_id>]' --idl $BET_LANE_IDL
Returns u256 — payout amount in BET token units.
# Claim from basket 1 via BET lane
vara-wallet --account agent call $BET_LANE BetLane/Claim --voucher $VOUCHER_ID \
--args '[1]' --idl $BET_LANE_IDL
payout = shares * (settlement_index / entry_index)
The payout_per_share is pre-computed in the Settlement struct during proposal. You can preview your expected payout before claiming:
# Get settlement payout_per_share
SETTLEMENT=$(vara-wallet call $BASKET_MARKET BasketMarket/GetSettlement \
--args '[<basket_id>]' --idl $IDL)
echo $SETTLEMENT | jq '.result.ok.payout_per_share'
See ../references/index-math.md for detailed formula and examples.
# Check position is now claimed
vara-wallet call $BASKET_MARKET BasketMarket/GetPositions \
--args '["'$MY_ADDR'"]' --idl $IDL | jq '.[] | select(.basket_id == <basket_id>) | .claimed'
# Check VARA balance increased
vara-wallet balance
| Error | Cause | Fix |
|---|---|---|
SettlementNotFinalized | Settlement not yet finalized | Wait for finalization |
AlreadyClaimed | Already claimed this basket | No action needed |
NothingToClaim | No position in this basket | Verify position exists |
SettlementNotFound | No settlement proposed | Wait for settler to propose |
TransferFailed | VARA transfer failed | Check contract balance, retry |