getBetsReport

import { getBetsReport, BetStatusFilter } from '@azuro-org/toolkit'
 
const report = await getBetsReport({
  chainId: 137,
  filter: { bettor: '0x...', status: BetStatusFilter.Settled },
})
 
// `single` is non-null whenever exactly one settlement token is present - the normal case, since a
// chain has one bet token. Fall back to the first row of `byToken` only when there is more than one.
const row = report.single ?? report.byToken[0]
 
// `roi` is `null` when turnover is 0 (e.g. no settled bets yet) - never `NaN`, so guard before formatting
const roiLabel = row && row.roi !== null ? `${row.roi.toFixed(2)}%` : '—'
 
if (report.isTruncated) {
  // more bets matched the filter than the walk covered - present the figures as a lower bound,
  // e.g. "based on the most recent 50,000 bets", instead of a final total
}

type GetBetsReportParams = {
  chainId: ChainId
  filter: BetsFilter
  /** aborts the in-flight multi-page walk, e.g. when the filter changes mid-walk */
  signal?: AbortSignal
  /** default: 1000, the maximum page size the subgraph accepts */
  pageSize?: number
  /** default: 50, which caps the walk at 50 000 bets */
  maxPages?: number
}

type BetsFilter = {
  bettor: Address // bettor address
  affiliate?: Address // affiliate address
  status?: BetStatusFilter // lifecycle preset - narrows both the bet list and this report
  kind?: BetKind // single (Ordinar) vs combo (Express)
  createdFrom?: number // inclusive lower bound, unix seconds (matches `Bet.createdAt`)
  createdTo?: number // inclusive upper bound, unix seconds
  isFreebet?: boolean // `true` = freebet-funded only, `false` = own-funds only, omit = both
  /** @deprecated renamed to `status` - when both are set, `status` wins */
  type?: BetStatusFilter
}
 
enum BetStatusFilter {
  Unredeemed = 'unredeemed', // ready to redeem bets
  Pending = 'pending', // not yet accepted on-chain
  Accepted = 'accepted', // accepted, not yet resolved
  Settled = 'settled', // resolved bets
  CashedOut = 'cashedOut', // cashed out bets
}
 
enum BetKind {
  Single = 'single',
  Combo = 'combo',
}
 
type ChainId =
  | 100     // Gnosis
  | 137     // Polygon
  | 80002   // Polygon Amoy
  | 88888   // Chiliz
  | 88882   // Chiliz Spicy
  | 8453    // Base
  | 84532   // Base Sepolia
 
import { type Address } from 'viem'

type GetBetsReportResult = BetsReportResult & {
  /** `true` when `maxPages` was hit before the walk reached the end of the bettor's history - the
   * figures below are then a lower bound, not an exact total, and the UI must surface that */
  isTruncated: boolean
}
 
type BetsReportResult = {
  /** one row per settlement token, sorted by turnover descending */
  byToken: BetsReportRow[]
  /** non-null iff exactly one token is present - render this instead of `byToken` whenever it is
   * non-null, which is the normal case since a chain has one bet token */
  single: BetsReportRow | null
  /** every bet matching the filter, freebet-funded ones included - see count semantics below */
  betsCount: number
}
 
type BetsReportRow = {
  token: { address: Address, decimals: number, symbol: string | null }
  /** own-funds bets only - freebet-funded ones are counted in `freebet.count` instead */
  betsCount: number
  /** `betsCount` splits into these three */
  settledCount: number
  pendingCount: number
  canceledCount: number
  /** decimal strings, already formatted with the token's decimals - the whole result is JSON-safe,
   * no bigint ever appears in it */
  turnover: string
  returns: string
  profit: string
  /** percent, `profit / turnover * 100`; `null` when turnover is 0 - never `NaN` or `Infinity` */
  roi: number | null
  /** sum of the stakes of unsettled, non-freebet bets */
  atStake: string
  /** sum of the stakes returned by voided bets, excluded from every figure above */
  refunded: string
  /** freebet-funded bets, excluded from every figure above */
  freebet: {
    count: number
    canceledCount: number
    turnover: string
    returns: string
    profit: string
    atStake: string
    refunded: string
  }
}