useBetsReport

import { BetStatusFilter } from '@azuro-org/sdk'
import { useBetsReport } from '@azuro-org/sdk'
 
const { data: report, isFetching } = useBetsReport({
  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) {
  // the bettor has more matching bets than the walk covered - say so instead of presenting
  // the numbers above as final, e.g. "based on the most recent 50,000 bets"
}

type UseBetsReportProps<TData = GetBetsReportResult> = {
  filter: BetsFilter
  chainId?: ChainId
  query?: QueryParameterWithSelect<GetBetsReportResult, TData> // useQuery params
}

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'

UseQueryResult<GetBetsReportResult>

import { type UseQueryResult } from '@tanstack/react-query'
 
type GetBetsReportResult = BetsReportResult & {
  /** `true` when the walk stopped early because it hit `maxPages` - the figures above 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 */
  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
  }
}

import { getUseBetsReportQueryOptions } from '@azuro-org/sdk'
 
const options = getUseBetsReportQueryOptions({ ...props, chainId })
await queryClient.prefetchQuery(options)

type GetUseBetsReportQueryOptionsProps<TData = GetBetsReportResult> = UseBetsReportProps<TData> & {
  chainId: ChainId
}