@provable-games/budokan-sdk 0.1.25 → 0.1.26

package/dist/index.cjs

@@ -211,12 +211,37 @@ function camelToSnake(obj) {
   return obj;
 }
 
+// src/phase/index.ts
+function tournamentPhase(t, nowSeconds) {
+  const createdAt = Number(t.createdAtOnchain ?? NaN);
+  if (!Number.isFinite(createdAt)) return null;
+  const regStartDelay = Number(t.registrationStartDelay ?? t.schedule?.registrationStartDelay ?? 0);
+  const regEndDelay = Number(t.registrationEndDelay ?? t.schedule?.registrationEndDelay ?? 0);
+  const gameStartDelay = Number(t.gameStartDelay ?? t.schedule?.gameStartDelay ?? 0);
+  const gameEndDelay = Number(t.gameEndDelay ?? t.schedule?.gameEndDelay ?? 0);
+  const submissionDuration = Number(t.submissionDuration ?? t.schedule?.submissionDuration ?? 0);
+  const now = nowSeconds ?? Math.floor(Date.now() / 1e3);
+  const hasReg = regStartDelay > 0 || regEndDelay > 0;
+  const regStart = createdAt + regStartDelay;
+  const regEnd = regStart + regEndDelay;
+  const gameStart = createdAt + gameStartDelay;
+  const gameEnd = gameStart + gameEndDelay;
+  const subEnd = gameEnd + submissionDuration;
+  if (hasReg && now < regStart) return "scheduled";
+  if (hasReg && now < regEnd) return "registration";
+  if (now < gameStart) return "staging";
+  if (now < gameEnd) return "live";
+  if (now < subEnd) return "submission";
+  return "finalized";
+}
+
 // src/api/tournaments.ts
 function normalizeTournament(raw) {
   const t = snakeToCamel(raw);
   const id = t.id ?? t.tournamentId;
   const protocolFeeShare = t.protocolFeeShare ?? t.entryFee?.protocolFeeShare ?? null;
-  return { ...t, id, tournamentId: id, protocolFeeShare };
+  const phase = t.phase ?? tournamentPhase(t);
+  return { ...t, id, tournamentId: id, protocolFeeShare, phase };
 }
 function fetchOpts(ctx) {
   return {
@@ -541,7 +566,7 @@ var WSManager = class {
 // src/chains/constants.ts
 var CHAINS = {
   mainnet: {
-    rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet/rpc/v0_10",
+    rpcUrl: "https://rpc.provable.games/rpc",
     apiBaseUrl: "https://budokan-api-production.up.railway.app",
     wsUrl: "wss://budokan-api-production.up.railway.app/ws",
     budokanAddress: "0x0596ced030e74ebc37f33607f07ecd5a62eff22cdc4ae31fe2d724040c1bdc0b",
@@ -954,6 +979,14 @@ function parseTournament(raw, entryCount, protocolFeeShare = null) {
     entryFeeExtension,
     entryRequirement,
     leaderboardConfig: { ascending, gameMustBeOver },
+    phase: tournamentPhase({
+      createdAtOnchain: createdAtStr,
+      registrationStartDelay,
+      registrationEndDelay,
+      gameStartDelay,
+      gameEndDelay,
+      submissionDuration
+    }),
     entryCount,
     prizeCount: 0,
     // Not available from viewer
@@ -6104,6 +6137,248 @@ function felt252FromShortString(s) {
   }
   return "0x" + value.toString(16);
 }
+
+// src/distribution/index.ts
+var BASIS_POINTS = 10000n;
+function calculateDistribution(positions, weight, distributionType) {
+  if (positions <= 0) return [];
+  let raw;
+  if (distributionType === "uniform") {
+    raw = Array(positions).fill(1);
+  } else if (distributionType === "linear") {
+    raw = [];
+    for (let i = 0; i < positions; i++) {
+      const positionValue = positions - i;
+      raw.push(1 + (positionValue - 1) * (weight / 10));
+    }
+  } else {
+    raw = [];
+    for (let i = 0; i < positions; i++) {
+      raw.push(Math.pow(1 - i / positions, weight));
+    }
+  }
+  const total = raw.reduce((a, b) => a + b, 0);
+  if (total === 0) return Array(positions).fill(0);
+  const bpShares = raw.map((d) => Math.floor(d / total * 1e4));
+  const remaining = 1e4 - bpShares.reduce((a, b) => a + b, 0);
+  if (remaining !== 0) bpShares[0] = bpShares[0] + remaining;
+  return bpShares.map((bp) => bp / 100);
+}
+var KNOWN_KEYS = {
+  linear: "linear",
+  exponential: "exponential",
+  uniform: "uniform",
+  custom: "custom"
+};
+function parseDistribution(dist) {
+  if (!dist || typeof dist !== "object") {
+    return { type: "unknown", weight: 0 };
+  }
+  const explicit = dist;
+  if (typeof explicit.type === "string") {
+    const kind = KNOWN_KEYS[explicit.type.toLowerCase()] ?? "unknown";
+    return { type: kind, weight: Number(explicit.weight ?? 0) };
+  }
+  const bag = dist.variant ?? dist;
+  for (const [rawKey, value] of Object.entries(bag)) {
+    if (value === void 0 || value === null) continue;
+    const kind = KNOWN_KEYS[rawKey.toLowerCase()];
+    if (!kind) continue;
+    if (kind === "uniform") return { type: "uniform", weight: 0 };
+    if (kind === "custom") {
+      const arr = Array.isArray(value) ? value.map((v) => Number(v)) : [];
+      return { type: "custom", weight: 0, customWeights: arr };
+    }
+    if (typeof value === "number" || typeof value === "string" || typeof value === "bigint") {
+      return { type: kind, weight: Number(value) };
+    }
+    if (typeof value === "object" && value !== null && "Some" in value) {
+      return { type: kind, weight: Number(value.Some) };
+    }
+    return { type: kind, weight: 0 };
+  }
+  return { type: "unknown", weight: 0 };
+}
+function prizeDistribution(prize) {
+  const type = KNOWN_KEYS[String(prize.distributionType ?? "uniform").toLowerCase()] ?? "uniform";
+  if (type === "custom") {
+    return { type, weight: 0, customWeights: prize.distributionShares ?? [] };
+  }
+  return { type, weight: prize.distributionWeight ?? 10 };
+}
+function distributionPercentages(dist, count) {
+  if (count <= 0) return [];
+  if (dist.type === "custom") {
+    const cw = dist.customWeights ?? [];
+    if (cw.length === count) return cw.map((bp) => bp / 100);
+    return calculateDistribution(count, 1, "uniform");
+  }
+  const distType = dist.type === "linear" || dist.type === "exponential" || dist.type === "uniform" ? dist.type : "uniform";
+  return calculateDistribution(count, dist.weight / 10, distType);
+}
+function bps(total, share) {
+  const b = Number(share ?? 0);
+  if (b <= 0) return 0n;
+  return total * BigInt(b) / BASIS_POINTS;
+}
+function entryFeeSplit(input) {
+  const total = BigInt(input.amount ?? 0) * BigInt(input.entryCount ?? 0);
+  const creator = Number(input.tournamentCreatorShare ?? 0);
+  const game = Number(input.gameCreatorShare ?? 0);
+  const refund = Number(input.refundShare ?? 0);
+  const protocol = Number(input.protocolFeeShare ?? 0);
+  const availableShareBps = Math.max(0, 1e4 - creator - game - refund - protocol);
+  return {
+    total,
+    positionPool: total * BigInt(availableShareBps) / BASIS_POINTS,
+    tournamentCreator: bps(total, creator),
+    gameCreator: bps(total, game),
+    refund: bps(total, refund),
+    protocolFee: bps(total, protocol),
+    availableShareBps
+  };
+}
+function entryFeePositionPayout(input, position) {
+  const distCount = Number(input.distributionCount ?? 0);
+  if (distCount <= 0 || position < 1 || position > distCount) return 0n;
+  const split = entryFeeSplit(input);
+  if (split.positionPool <= 0n) return 0n;
+  const pcts = distributionPercentages(parseDistribution(input.distribution), distCount);
+  const pct = pcts[position - 1] ?? 0;
+  if (pct <= 0) return 0n;
+  return split.positionPool * BigInt(Math.floor(pct * 1e4)) / 1000000n;
+}
+function sponsorPrizePayout(prize, position) {
+  if (prize.tokenType !== "erc20") return 0n;
+  const distCount = Number(prize.distributionCount ?? 0);
+  if (distCount <= 0 || position < 1 || position > distCount) return 0n;
+  const pcts = distributionPercentages(prizeDistribution(prize), distCount);
+  const pct = pcts[position - 1] ?? 0;
+  if (pct <= 0) return 0n;
+  return BigInt(prize.amount ?? "0") * BigInt(Math.floor(pct * 1e4)) / 1000000n;
+}
+
+// src/rewards/index.ts
+function getClaimableRewards(input) {
+  const tournamentsById = /* @__PURE__ */ new Map();
+  for (const t of input.tournaments) tournamentsById.set(t.id, t);
+  const prizesByTournament = /* @__PURE__ */ new Map();
+  for (const p of input.prizes) {
+    let list = prizesByTournament.get(p.tournamentId);
+    if (!list) prizesByTournament.set(p.tournamentId, list = []);
+    list.push(p);
+  }
+  const claimedKeys = /* @__PURE__ */ new Set();
+  for (const c of input.existingClaims) {
+    if (!c.claimed) continue;
+    const key = rewardClaimKey(c);
+    if (key) claimedKeys.add(`${c.tournamentId}:${key}`);
+  }
+  const out = [];
+  for (const placement of input.placements) {
+    const tournament = tournamentsById.get(placement.tournamentId);
+    if (!tournament) continue;
+    const tournamentName = tournament.name || `#${tournament.id}`;
+    const pos = placement.position;
+    const ef = tournament.entryFee;
+    const efDistCount = Number(ef?.distributionCount ?? 0);
+    if (ef && ef.tokenAddress && efDistCount >= pos) {
+      const claimKey = `${placement.tournamentId}:EntryFee.Position.${pos}`;
+      if (!claimedKeys.has(claimKey)) {
+        const amount = entryFeePositionPayout(
+          {
+            amount: ef.amount ?? "0",
+            entryCount: tournament.entryCount ?? 0,
+            tournamentCreatorShare: ef.tournamentCreatorShare,
+            gameCreatorShare: ef.gameCreatorShare,
+            refundShare: ef.refundShare,
+            protocolFeeShare: tournament.protocolFeeShare,
+            distribution: ef.distribution,
+            distributionCount: efDistCount
+          },
+          pos
+        );
+        if (amount > 0n) {
+          out.push({
+            tournamentId: placement.tournamentId,
+            tournamentName,
+            source: "entry_fee_position",
+            position: pos,
+            tokenAddress: ef.tokenAddress,
+            tokenType: "erc20",
+            amount,
+            reward: { kind: "entry_fee_position", position: pos }
+          });
+        }
+      }
+    }
+    for (const prize of prizesByTournament.get(placement.tournamentId) ?? []) {
+      if (!isRawTokenPrize(prize)) continue;
+      const dc = prize.distributionCount ?? 0;
+      const pp = prize.payoutPosition ?? 0;
+      const isSingle = pp === pos && dc === 0;
+      const isDistributed = dc >= pos && pp === 0;
+      if (!isSingle && !isDistributed) continue;
+      const tokenType = prize.tokenType === "erc721" ? "erc721" : "erc20";
+      if (isSingle) {
+        const claimKey2 = `${placement.tournamentId}:Prize.Single.${prize.prizeId}`;
+        if (claimedKeys.has(claimKey2)) continue;
+        out.push({
+          tournamentId: placement.tournamentId,
+          tournamentName,
+          source: "sponsor_single",
+          position: pos,
+          tokenAddress: prize.tokenAddress,
+          tokenType,
+          amount: tokenType === "erc20" ? BigInt(prize.amount ?? "0") : void 0,
+          tokenId: prize.tokenId,
+          reward: { kind: "prize_single", prizeId: prize.prizeId }
+        });
+        continue;
+      }
+      const payoutIndex = pos - 1;
+      const claimKey = `${placement.tournamentId}:Prize.Distributed.${prize.prizeId}.${payoutIndex}`;
+      if (claimedKeys.has(claimKey)) continue;
+      const amount = sponsorPrizePayout(prize, pos);
+      if (amount <= 0n) continue;
+      out.push({
+        tournamentId: placement.tournamentId,
+        tournamentName,
+        source: "sponsor_distributed",
+        position: pos,
+        tokenAddress: prize.tokenAddress,
+        tokenType: "erc20",
+        amount,
+        reward: {
+          kind: "prize_distributed",
+          prizeId: prize.prizeId,
+          payoutPosition: payoutIndex
+        }
+      });
+    }
+  }
+  return out;
+}
+function buildClaimCalls(rewards, budokanAddress) {
+  return rewards.map(
+    (r) => buildClaimRewardCall(budokanAddress, {
+      tournamentId: r.tournamentId,
+      reward: r.reward
+    })
+  );
+}
+function rewardClaimKey(c) {
+  switch (c.claimKind) {
+    case "prize_single":
+      return c.prizeId ? `Prize.Single.${c.prizeId}` : null;
+    case "prize_distributed":
+      return c.prizeId != null && c.payoutIndex != null ? `Prize.Distributed.${c.prizeId}.${c.payoutIndex}` : null;
+    case "entry_fee_position":
+      return c.position != null ? `EntryFee.Position.${c.position}` : null;
+    default:
+      return null;
+  }
+}
 function sdkChainId(chain) {
   return chain === "mainnet" ? "SN_MAIN" : "SN_SEPOLIA";
 }
@@ -6184,6 +6459,7 @@ exports.RpcError = RpcError;
 exports.TournamentNotFoundError = TournamentNotFoundError;
 exports.WSManager = WSManager;
 exports.buildAddPrizeCall = buildAddPrizeCall;
+exports.buildClaimCalls = buildClaimCalls;
 exports.buildClaimRewardCall = buildClaimRewardCall;
 exports.buildCreateTournamentCall = buildCreateTournamentCall;
 exports.buildEnterTournamentCall = buildEnterTournamentCall;
@@ -6195,6 +6471,9 @@ exports.buildSubmitScoreCall = buildSubmitScoreCall;
 exports.buildTournamentValidatorConfig = buildTournamentValidatorConfig;
 exports.camelToSnake = camelToSnake;
 exports.createBudokanClient = createBudokanClient;
+exports.distributionPercentages = distributionPercentages;
+exports.entryFeePositionPayout = entryFeePositionPayout;
+exports.entryFeeSplit = entryFeeSplit;
 exports.explorerAddressUrl = explorerAddressUrl;
 exports.explorerBaseUrl = explorerBaseUrl;
 exports.explorerTxUrl = explorerTxUrl;
@@ -6202,6 +6481,7 @@ exports.extensionAddressFor = extensionAddressFor;
 exports.findWhitelistedGame = findWhitelistedGame;
 exports.getActivityStats = getActivityStats;
 exports.getChainConfig = getChainConfig;
+exports.getClaimableRewards = getClaimableRewards;
 exports.getGameDefaults = getGameDefaults;
 exports.getGameStats = getGameStats;
 exports.getGameTournaments = getGameTournaments;
@@ -6224,14 +6504,18 @@ exports.isRawExtensionPrize = isRawExtensionPrize;
 exports.isRawTokenPrize = isRawTokenPrize;
 exports.isTokenPrize = isTokenPrize;
 exports.normalizeAddress = normalizeAddress;
+exports.parseDistribution = parseDistribution;
 exports.parseTournamentIdFromReceipt = parseTournamentIdFromReceipt;
+exports.prizeDistribution = prizeDistribution;
 exports.snakeToCamel = snakeToCamel;
+exports.sponsorPrizePayout = sponsorPrizePayout;
 exports.toMetagameExtensionPrize = toMetagameExtensionPrize;
 exports.toMetagamePrize = toMetagamePrize;
 exports.toMetagamePrizes = toMetagamePrizes;
 exports.toMetagameTokenPrize = toMetagameTokenPrize;
 exports.toMetagameTokenPrizes = toMetagameTokenPrizes;
 exports.tournamentPageUrl = tournamentPageUrl;
+exports.tournamentPhase = tournamentPhase;
 exports.tryToMetagamePrize = tryToMetagamePrize;
 exports.tryToMetagamePrizes = tryToMetagamePrizes;
 exports.u256ToLowHigh = u256ToLowHigh;