Settlement

What the program checksCopy Anchor Link

When the settler settles a contest, the wagers program enforces:

• Payouts go to entrants only. The winning side is a set of seats of that contest. Their payouts are claimed into their own vaults.
• The rake is capped. The fee cannot exceed the tier stored on the contest when it was created, and no tier can exceed the program's hard cap of 10 percent.
• Payouts add up. The rake, the winners' payouts and the rounding remainder always add up to exactly the pot. Winners on a side get equal payouts, and the remainder (less than one micro-USDC per winning seat) goes to the treasury. In tournaments, the remainder goes to first place.
• One settlement. A settled contest cannot be settled again.

A tie refunds every stake with no fee.

Result hashesCopy Anchor Link

Each settlement commits a result_hash on-chain, in the ContestSettled event of the settle transaction. It is the SHA-256 of the full scoring breakdown: every trade, quote and rule decision that produced the result, serialized as canonical JSON (sorted keys, integers as strings).

The breakdown is public once the contest settles. You can re-hash it and compare:

# API is the bandforband.fun API origin the app talks to.
curl -G "$API/trpc/contests.result" \
  --data-urlencode 'input={"json":{"contestId":"<contest id>"}}'

import { verifyBreakdown } from '@wagers/scoring'

verifyBreakdown(result.breakdown, result.resultHash) // true

If the hash matches, the published breakdown is exactly what the result was based on, and you can check every number in it against the chain.

When scoring is not cleanCopy Anchor Link

• A result flagged by anti-cheat, or a scoring outage, is not settled automatically. In duels, players can self-report for 30 minutes. Matching reports settle; anything else becomes a dispute.
• Staff resolve disputes by picking a winner, a draw or a refund. The decision is hashed and committed like any other result.

The timeout refundCopy Anchor Link

If a contest is still not settled 7 days after it ends, anyone can call cancel on it. The program marks it cancelled and every entrant can claim their full stake back into their vault. This works even if the bandforband.fun servers are gone. The program refuses a timeout shorter than 24 hours.