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. |
privacyAccess | 'public' (catalog + anyone can bet after bootstrap) or 'private' (invite-gated; join required to bet). |
| Duel invitation | Code for a private market (duelInvitations.create / userJoin). Viewing with a code ≠ membership. |
duelId vs id | Every market row has both. duelId is the on-chain id (use it for detail, bets, and charts). id is the server's internal record id. |
| Outcome / option | A side of a market. Bets need both optionIndex (0 or 1) and bet (the option label text, e.g. YES / NO or versus optionA / optionB text). Prefer reading labels from market.options. |
| Stake | The amount you put on a bet, in collateral base units (wei). |
| Shares | What a bet buys: your position size in a market. |
| 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. |
| Tournament chips | Virtual per-stage stake units (often 1000 at stage start). Used with submitPicks on match markets; not USDC/placeBet. |
| Pick | A chip stake on one tournament match market: { marketId, side, stakeChips }. |
| Auto-mint / faucet | sdk.public.faucet.mint (POST /bento/auto-mint/mint) that credits ~1000 USDC + ~1000 credits to the managed account on testnet. Register alone does not fund you. |
| 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 hosts: baseUrl vs tournamentsBaseUrl. |
| Sportmonks proxy | Rate-limited tournaments-host routes (/bento/sportmonks/*) that cache Sportmonks data; pass ttl (live / ended / default). Token stays server-side. |
| Bearer JWT | The token from eoaLogin you send as Authorization: Bearer for markets sdk.user calls. |