Common patterns & pitfalls

import { createBentoSdk, jwtAuthProvider, walletAuthProvider } from '@bento.fun/sdk';

const sdk = createBentoSdk({
  baseUrl: process.env.BENTO_URL!, // https://internal-server.bento.fun
  apiKey: process.env.BENTO_BUILDER_API_KEY!,
  tournamentsBaseUrl: process.env.PARLAY_TOURNAMENT_URL, // optional
  auth: walletAuthProvider(() => ({ Authorization: `Bearer ${token}` })),
  tournamentsAuth: jwtAuthProvider({ getAccessToken: () => token }),
});

const { data } = await sdk.public.listDuels({ page: 1, limit: 10 });
await sdk.public.getDuelById({ duelId: data[0].duelId }); // ✓
// await sdk.public.getDuelById({ duelId: data[0].id }); // ✗ 404

const est = await sdk.user.bets.estimateBuy({
  duelId,
  optionIndex: 0,
  betAmountUsdc: stake,
  slippageBps: 100,
});
if (!est.success) throw new Error('estimate rejected');

await sdk.user.placeBetFromEstimate(
  {
    estimate: est.estimate,
    duelId,
    duelType: market.duelType ?? 'PREDICTION',
    bet: market.options?.[0] ?? 'YES',
    optionIndex: 0,
    betAmount: stake,
    betAmountUsdc: stake,
    slippageBps: 100,
    tokenDecimals: 18,
  },
  { idempotencyKey }, // caller-stable, not Date.now()
);

const { tournaments, total } = (await sdk.tournaments!.tournaments.list({
  status: 'active',
})) as { tournaments: unknown[]; total: number };

import {
  isAuthError, isValidationError, isRateLimited, isGeoblockError,
  getFieldErrors, getRetryAfterMs, getRequestId, getStatus, getErrorCode,
} from '@bento.fun/sdk';

try {
  await sdk.user.placeBetFromEstimate(input, { idempotencyKey });
} catch (err) {
  if (isRateLimited(err)) {
    await sleep(getRetryAfterMs(err) ?? 1_000);
  } else if (isValidationError(err)) {
    showFieldErrors(getFieldErrors(err));
  } else if (isGeoblockError(err)) {
    // 403 GEO_BLOCKED on the usdc stack — try collateralMode: 'credits'
  } else if (isAuthError(err)) {
    await refreshSession();
  } else {
    report({
      status: getStatus(err),
      code: getErrorCode(err),
      requestId: getRequestId(err),
    });
  }
}

if (isRateLimited(err)) await sleep(getRetryAfterMs(err) ?? 1_000);

const sdk = createBentoSdk({
  baseUrl, apiKey, auth,
  rateLimit: {
    default: { limit: 120, intervalMs: 60_000 },
    endpoints: {
      'POST /bento/user/bets/create': { limit: 20, intervalMs: 60_000 },
      '/bento/user': { limit: 60, intervalMs: 60_000 },
    },
    onLimit: 'wait', // or 'throw' to shed load
    maxWaitMs: 60_000,
  },
});