Build Multi-Outcome Bets with the Poll SDK

Create the bet

Add two or more initial outcomes. The returned bet address identifies the on-chain bet for later calls.

const { bet, tx } = await sdk.initializeBetV4({
  question: "Who wins Group A?",
  expectedUserCount: 12,
  minimumVoteCount: 3,
  isCreatorResolver: false,
  initialOutcomes: ["Brazil", "Spain", "France"],
  signers: [wallet],
});

console.log(bet.toBase58(), tx);

Add more outcomes

You can add outcomes before the first wager. This is useful for a long list because a Solana transaction has a fixed size limit.

for (const label of ["Germany", "Japan", "Mexico"]) {
  await sdk.addOutcomeV4({
    bet,
    label,
    signers: [wallet],
  });
}

Place a wager

V4 wager amounts use micro-USDC. One USDC is 1,000,000 micro-USDC. Use an integer string or BN. Do not use floating-point math for money.

await sdk.placeWagerV4({
  bet,
  amount: "25000000", // 25 USDC
  outcomeIndex: 0, // Brazil
  signers: [wallet],
});

Vote on the result

When the result is known, an eligible participant starts voting. Participants then vote with the same zero-based outcome index that the wager call uses.

await sdk.initiateVoteV4({
  bet,
  signers: [wallet],
});

await sdk.placeVoteV4({
  bet,
  outcomeIndex: 0,
  signers: [wallet],
});

Settle in batches

After resolution, distribute funds in small batches. Use no more than three users in each V4 settlement transaction.

await sdk.settleBetBatchV4({
  bet,
  batchNumber: 0,
  usersPerBatch: 3,
  signers: [wallet],
});

Increase batchNumber until all participants are settled. A group of 50 participants needs 17 batches when each batch has three users.