Glossary
Plain definitions for the terms you'll meet across the docs and the SDK.
| Term | What it means |
|---|---|
| Duel | A market. The SDK uses "duel" (the on-chain term) and "market" interchangeably — sdk.public.duels and sdk.public.markets are aliases. |
duelId vs id | Every market row has both. duelId is the on-chain id — use it for detail, bets, and charts. id is the database row id. |
| Outcome / option | A side of a market. Bets reference optionIndex (0 or 1), not a 'YES' / 'NO' label. |
| Stake | The amount you put on a bet or parlay, in collateral base units (wei). |
| Shares | What a bet buys — your position size in a market. |
| Parlay | A multi-leg bet across markets; all legs must win. Placed on-chain via the tournaments host. |
| Leg | One selection inside a parlay ({ outcomeId }). |
| Pack | A bundled points game on the markets host. |
| Parent market | A grouped event with several child markets. |
| Tournament | A bracket competition with a vault, entries, and Merkle payouts. |
| Managed account | The address Bento provisions for your signing key — where your funds and positions live (not your wallet's own address). |
| EOA / signing key | The wallet you sign the login message with. It proves identity; it isn't where funds sit. |
| Credits vs USDC | Two collateral stacks (collateralMode). Credits are not geo-gated; the USDC stack is. |
| wei | Amounts are token base units — 18 decimals on BSC / credits. '10000000000000000000' is 10, not '10'. |
| Markets host / tournaments host | The two backends — baseUrl vs tournamentsBaseUrl. |
| Bearer JWT | The token from eoaLogin you send as Authorization: Bearer for markets sdk.user calls. |