basket-claim

Original：🇺🇸 English

Translated

Use when the agent needs to claim payout from a settled basket via vara-wallet. Do not use before settlement is finalized.

3installs

Sourceadityaakr/polybaskets

Added on2026-04-14

NPX Install

npx skill4agent add adityaakr/polybaskets basket-claim

SKILL.md Content

View Translation Comparison →

Basket Claim

Claim payout from a settled PolyBaskets basket via

vara-wallet

.

Setup

MAINNET ONLY. Run

vara-wallet config set network mainnet

before anything else. NEVER switch to testnet — there are no contracts there.

bash

vara-wallet config set network mainnet
BASKET_MARKET="0x702395d43248eaa5f1fd4d9eadadc75b0fb1c7c5ae9ea20bf31375fd4358f403"
BET_LANE="0xf5aa436669bb3fc97c1675d06949592e8617f889cbd055451f321113b17bb564"
_PB="${POLYBASKETS_SKILLS_DIR:-skills}"
IDL="$_PB/idl/polymarket-mirror.idl"
BET_LANE_IDL="$_PB/idl/bet_lane_client.idl"

Pre-Check Workflow

1. Verify settlement is finalized

bash

vara-wallet call $BASKET_MARKET BasketMarket/GetSettlement \
  --args '[<basket_id>]' --idl $IDL

Check the result:

```
status: "Finalized"
```
— ready to claim
```
status: "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
```
).
Error
```
SettlementNotFound
```
— not yet settled

bash

# 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):

bash

MY_ADDR=$(vara-wallet balance | jq -r .address)

2. Verify position exists and is unclaimed

bash

# 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

.

Claim (VARA Lane)

For baskets with

asset_kind: "Vara"

:

bash

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).

Example

bash

# Claim from basket 0
PAYOUT=$(vara-wallet --account agent call $BASKET_MARKET BasketMarket/Claim --voucher $VOUCHER_ID \
  --args '[0]' --idl $IDL)
echo "Payout: $PAYOUT"

Claim (BET Token Lane)

For baskets with

asset_kind: "Bet"

:

bash

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.

Example

bash

# 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 Calculation

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:

bash

# 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.

Verify After Claim

bash

# 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

Common Errors

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

basket-claim

NPX Install

Tags

SKILL.md Content

Basket Claim

Setup

Pre-Check Workflow

1. Verify settlement is finalized

2. Verify position exists and is unclaimed

Claim (VARA Lane)

Example

Claim (BET Token Lane)

Example

Payout Calculation

Verify After Claim

Common Errors