@provable-games/budokan-sdk 0.1.22 → 0.1.23

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './client-DlXvzneQ.cjs';
-export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, S as Schedule, n as WSChannel, o as WSEventMessage, p as WSMessage, q as WSSubscribeMessage, r as WSUnsubscribeMessage, s as createBudokanClient } from './client-DlXvzneQ.cjs';
+import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './player-BUynfv7D.cjs';
+export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, n as PlayerPlacement, o as PlayerRewards, S as Schedule, p as WSChannel, q as WSEventMessage, r as WSMessage, s as WSSubscribeMessage, t as WSUnsubscribeMessage, u as createBudokanClient } from './player-BUynfv7D.cjs';
 export { EntryFee } from '@provable-games/metagame-sdk';
 import 'starknet';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './client-DlXvzneQ.js';
-export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, S as Schedule, n as WSChannel, o as WSEventMessage, p as WSMessage, q as WSSubscribeMessage, r as WSUnsubscribeMessage, s as createBudokanClient } from './client-DlXvzneQ.js';
+import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './player-BUynfv7D.js';
+export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, n as PlayerPlacement, o as PlayerRewards, S as Schedule, p as WSChannel, q as WSEventMessage, r as WSMessage, s as WSSubscribeMessage, t as WSUnsubscribeMessage, u as createBudokanClient } from './player-BUynfv7D.js';
 export { EntryFee } from '@provable-games/metagame-sdk';
 import 'starknet';
 

package/dist/{client-DlXvzneQ.d.cts → player-BUynfv7D.d.cts}

@@ -482,4 +482,39 @@ declare class BudokanClient {
  */
 declare function createBudokanClient(config: BudokanClientConfig): BudokanClient;
 
-export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type GameConfig as G, type LeaderboardConfig as L, type PrizeAggregation as P, type QualificationEntry as Q, type Registration as R, type Schedule as S, type Tournament as T, type WSSubscribeOptions as W, type Prize as a, type PaginatedResult as b, type RewardClaim as c, type RewardClaimSummary as d, type TournamentListParams as e, type PlatformStats as f, type PrizeStats as g, type WSEventHandler as h, type BudokanClientConfig as i, ConnectionStatus as j, type ConnectionStatusState as k, type LeaderboardEntry as l, type Phase as m, type WSChannel as n, type WSEventMessage as o, type WSMessage as p, type WSSubscribeMessage as q, type WSUnsubscribeMessage as r, createBudokanClient as s };
+/**
+ * One row per (player token, tournament) where the token's final rank fell
+ * inside a paid position. Multiple placements per tournament are possible
+ * when the player owns several tokens entered into the same tournament.
+ */
+interface PlayerPlacement {
+    tournamentId: string;
+    tokenId: string;
+    /** 1-indexed rank in the tournament's final leaderboard. */
+    position: number;
+    /** Token's final score as a decimal string (preserves felt252 precision). */
+    score: string;
+}
+/**
+ * Aggregate rewards summary for a player address. Computed against current
+ * NFT ownership (denshokan), not historical attribution — see PR #243.
+ *
+ * `tournaments`, `prizes`, and `rewardClaims` are restricted to tournaments
+ * where the player has at least one placement. Consumers compute USD values
+ * by walking placements + prize/entry-fee data + token prices client-side.
+ */
+interface PlayerRewards {
+    /** Count of placements that landed on a paid position. */
+    wins: number;
+    /** Lowest position number across all placements; null when no wins. */
+    bestPlacement: number | null;
+    placements: PlayerPlacement[];
+    /** Tournaments where the player placed (subset of currently-held entries). */
+    tournaments: Tournament[];
+    /** All sponsored prizes for those tournaments. */
+    prizes: Prize[];
+    /** All reward claims for those tournaments. */
+    rewardClaims: RewardClaim[];
+}
+
+export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type GameConfig as G, type LeaderboardConfig as L, type PrizeAggregation as P, type QualificationEntry as Q, type Registration as R, type Schedule as S, type Tournament as T, type WSSubscribeOptions as W, type Prize as a, type PaginatedResult as b, type RewardClaim as c, type RewardClaimSummary as d, type TournamentListParams as e, type PlatformStats as f, type PrizeStats as g, type WSEventHandler as h, type BudokanClientConfig as i, ConnectionStatus as j, type ConnectionStatusState as k, type LeaderboardEntry as l, type Phase as m, type PlayerPlacement as n, type PlayerRewards as o, type WSChannel as p, type WSEventMessage as q, type WSMessage as r, type WSSubscribeMessage as s, type WSUnsubscribeMessage as t, createBudokanClient as u };

package/dist/{client-DlXvzneQ.d.ts → player-BUynfv7D.d.ts}

@@ -482,4 +482,39 @@ declare class BudokanClient {
  */
 declare function createBudokanClient(config: BudokanClientConfig): BudokanClient;
 
-export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type GameConfig as G, type LeaderboardConfig as L, type PrizeAggregation as P, type QualificationEntry as Q, type Registration as R, type Schedule as S, type Tournament as T, type WSSubscribeOptions as W, type Prize as a, type PaginatedResult as b, type RewardClaim as c, type RewardClaimSummary as d, type TournamentListParams as e, type PlatformStats as f, type PrizeStats as g, type WSEventHandler as h, type BudokanClientConfig as i, ConnectionStatus as j, type ConnectionStatusState as k, type LeaderboardEntry as l, type Phase as m, type WSChannel as n, type WSEventMessage as o, type WSMessage as p, type WSSubscribeMessage as q, type WSUnsubscribeMessage as r, createBudokanClient as s };
+/**
+ * One row per (player token, tournament) where the token's final rank fell
+ * inside a paid position. Multiple placements per tournament are possible
+ * when the player owns several tokens entered into the same tournament.
+ */
+interface PlayerPlacement {
+    tournamentId: string;
+    tokenId: string;
+    /** 1-indexed rank in the tournament's final leaderboard. */
+    position: number;
+    /** Token's final score as a decimal string (preserves felt252 precision). */
+    score: string;
+}
+/**
+ * Aggregate rewards summary for a player address. Computed against current
+ * NFT ownership (denshokan), not historical attribution — see PR #243.
+ *
+ * `tournaments`, `prizes`, and `rewardClaims` are restricted to tournaments
+ * where the player has at least one placement. Consumers compute USD values
+ * by walking placements + prize/entry-fee data + token prices client-side.
+ */
+interface PlayerRewards {
+    /** Count of placements that landed on a paid position. */
+    wins: number;
+    /** Lowest position number across all placements; null when no wins. */
+    bestPlacement: number | null;
+    placements: PlayerPlacement[];
+    /** Tournaments where the player placed (subset of currently-held entries). */
+    tournaments: Tournament[];
+    /** All sponsored prizes for those tournaments. */
+    prizes: Prize[];
+    /** All reward claims for those tournaments. */
+    rewardClaims: RewardClaim[];
+}
+
+export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type GameConfig as G, type LeaderboardConfig as L, type PrizeAggregation as P, type QualificationEntry as Q, type Registration as R, type Schedule as S, type Tournament as T, type WSSubscribeOptions as W, type Prize as a, type PaginatedResult as b, type RewardClaim as c, type RewardClaimSummary as d, type TournamentListParams as e, type PlatformStats as f, type PrizeStats as g, type WSEventHandler as h, type BudokanClientConfig as i, ConnectionStatus as j, type ConnectionStatusState as k, type LeaderboardEntry as l, type Phase as m, type PlayerPlacement as n, type PlayerRewards as o, type WSChannel as p, type WSEventMessage as q, type WSMessage as r, type WSSubscribeMessage as s, type WSUnsubscribeMessage as t, createBudokanClient as u };

package/dist/react.cjs

@@ -4871,7 +4871,6 @@ function useOwnedTournamentIds(owner, contextId) {
     enabled ? {
       owner,
       minterAddress: budokanAddress,
-      hasContext: true,
       ...{},
       limit: MAX_OWNED_TOKENS
     } : void 0
@@ -4987,7 +4986,11 @@ function useRegistrationsByOwner(tournamentId, owner, params) {
   }, [enabled, tokensResult]);
   const inner = useRegistrations(
     ownedGameTokenIds && ownedGameTokenIds.length > 0 ? tournamentId : void 0,
-    ownedGameTokenIds && ownedGameTokenIds.length > 0 ? { ...params, gameTokenIds: ownedGameTokenIds } : void 0
+    ownedGameTokenIds && ownedGameTokenIds.length > 0 ? {
+      limit: Math.min(ownedGameTokenIds.length, MAX_OWNED_TOKENS),
+      ...params,
+      gameTokenIds: ownedGameTokenIds
+    } : void 0
   );
   if (ownedGameTokenIds !== null && ownedGameTokenIds.length === 0) {
     return {
@@ -5176,6 +5179,200 @@ function useActivityStats() {
   }, [fetch2]);
   return { stats, loading, error, refetch: fetch2 };
 }
+function usePlayerRewards(address) {
+  const budokan = useBudokanClient();
+  const denshokan = react$1.useDenshokanClient();
+  const budokanAddress = budokan.clientConfig.budokanAddress;
+  const [rewards, setRewards] = react.useState(null);
+  const [aggregating, setAggregating] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  useResetOnClient(budokan, setRewards, setError);
+  const tokensEnabled = !!address && !!budokanAddress;
+  const { data: tokensResult, isLoading: tokensLoading } = react$1.useTokens(
+    tokensEnabled ? {
+      owner: address,
+      minterAddress: budokanAddress,
+      limit: 1e3
+    } : void 0
+  );
+  const tokensByTournament = react.useMemo(() => {
+    if (!tokensResult?.data) return null;
+    const map = /* @__PURE__ */ new Map();
+    for (const t of tokensResult.data) {
+      if (t.contextId == null || !t.tokenId) continue;
+      const tid = String(t.contextId);
+      let list = map.get(tid);
+      if (!list) {
+        list = [];
+        map.set(tid, list);
+      }
+      list.push(t.tokenId);
+    }
+    return map;
+  }, [tokensResult]);
+  const tournamentIds = react.useMemo(
+    () => tokensByTournament ? Array.from(tokensByTournament.keys()) : [],
+    [tokensByTournament]
+  );
+  const { tournaments: tournamentsPage, loading: tournamentsLoading } = useTournaments(
+    tournamentIds.length > 0 ? { tournamentIds, limit: 1e3 } : void 0
+  );
+  const tournamentIdsKey = tournamentIds.join(",");
+  const fetch2 = react.useCallback(async () => {
+    if (!tokensEnabled) {
+      setRewards(null);
+      return;
+    }
+    if (!tokensByTournament) return;
+    if (tokensByTournament.size === 0) {
+      setRewards(emptyRewards());
+      return;
+    }
+    if (!tournamentsPage?.data) return;
+    const now = Math.floor(Date.now() / 1e3);
+    const finalized = tournamentsPage.data.filter((t) => {
+      const sub = Number(t.submissionEndTime ?? 0);
+      return sub > 0 && sub <= now;
+    });
+    if (finalized.length === 0) {
+      setRewards(emptyRewards());
+      return;
+    }
+    setAggregating(true);
+    setError(null);
+    try {
+      const settled = await Promise.allSettled(
+        finalized.map(async (t) => {
+          const tid = t.id;
+          const tokenIds = tokensByTournament.get(tid) ?? [];
+          if (tokenIds.length === 0) return null;
+          const [prizes, allClaims, ranksResult] = await Promise.all([
+            budokan.getTournamentPrizes(tid),
+            fetchAllRewardClaims(budokan, tid),
+            denshokan.getTokenRanks(tokenIds, {
+              contextId: Number(tid),
+              minterAddress: budokanAddress
+            })
+          ]);
+          let maxPaid = 0;
+          for (const p of prizes) {
+            if ((p.payoutPosition ?? 0) > 0) {
+              maxPaid = Math.max(maxPaid, p.payoutPosition);
+            }
+            if ((p.distributionCount ?? 0) > 0) {
+              maxPaid = Math.max(maxPaid, p.distributionCount);
+            }
+          }
+          const efDistCount = Number(t.entryFee?.distributionCount ?? 0);
+          if (efDistCount > 0) maxPaid = Math.max(maxPaid, efDistCount);
+          if (maxPaid === 0) return null;
+          const placements = ranksResult.data.filter((r) => r.rank > 0 && r.rank <= maxPaid).map((r) => ({
+            tournamentId: tid,
+            tokenId: r.tokenId,
+            position: r.rank,
+            score: String(r.score ?? "0")
+          }));
+          if (placements.length === 0) return null;
+          return {
+            tournament: t,
+            prizes,
+            rewardClaims: allClaims,
+            placements
+          };
+        })
+      );
+      const valid = settled.map((s, i) => {
+        if (s.status === "fulfilled") return s.value;
+        console.warn(
+          `usePlayerRewards: tournament ${finalized[i].id} fetch failed; skipping`,
+          s.reason
+        );
+        return null;
+      }).filter((r) => r !== null);
+      const allPlacements = valid.flatMap(
+        (r) => r.placements
+      );
+      const wins = allPlacements.length;
+      const bestPlacement = wins > 0 ? Math.min(...allPlacements.map((p) => p.position)) : null;
+      const tournamentsList = valid.map((r) => r.tournament);
+      const prizesList = valid.flatMap((r) => r.prizes);
+      const rewardClaimsList = valid.flatMap(
+        (r) => r.rewardClaims
+      );
+      setRewards({
+        wins,
+        bestPlacement,
+        placements: allPlacements,
+        tournaments: tournamentsList,
+        prizes: prizesList,
+        rewardClaims: rewardClaimsList
+      });
+    } catch (e) {
+      setError(e);
+    } finally {
+      setAggregating(false);
+    }
+  }, [
+    tokensEnabled,
+    tokensByTournament,
+    tournamentsPage,
+    tournamentIdsKey,
+    budokan,
+    denshokan,
+    budokanAddress
+  ]);
+  const lastRunRef = react.useRef("");
+  react.useEffect(() => {
+    if (!tokensEnabled) {
+      setRewards(null);
+      return;
+    }
+    if (!tokensByTournament || !tournamentsPage?.data) return;
+    const fingerprint = `${address}|${tournamentIdsKey}|${tournamentsPage.data.length}`;
+    if (fingerprint === lastRunRef.current) return;
+    lastRunRef.current = fingerprint;
+    fetch2();
+  }, [
+    address,
+    tokensEnabled,
+    tokensByTournament,
+    tournamentsPage,
+    tournamentIdsKey,
+    fetch2
+  ]);
+  const loading = tokensEnabled && (tokensLoading || tournamentsLoading) || aggregating;
+  return { rewards, loading, error, refetch: fetch2 };
+}
+function emptyRewards() {
+  return {
+    wins: 0,
+    bestPlacement: null,
+    placements: [],
+    tournaments: [],
+    prizes: [],
+    rewardClaims: []
+  };
+}
+async function fetchAllRewardClaims(client, tournamentId) {
+  const first = await client.getTournamentRewardClaims(tournamentId, {
+    limit: 100
+  });
+  const accumulated = [...first.data];
+  const total = first.total ?? accumulated.length;
+  if (accumulated.length >= total) return accumulated;
+  const pageSize = Math.max(first.data.length, 1);
+  let offset = accumulated.length;
+  while (offset < total) {
+    const next = await client.getTournamentRewardClaims(tournamentId, {
+      limit: pageSize,
+      offset
+    });
+    if (next.data.length === 0) break;
+    accumulated.push(...next.data);
+    offset += next.data.length;
+  }
+  return accumulated;
+}
 function useSubscription(channels, tournamentIds) {
   const client = useBudokanClient();
   const [lastMessage, setLastMessage] = react.useState(null);
@@ -5226,6 +5423,7 @@ exports.useActivityStats = useActivityStats;
 exports.useBudokanClient = useBudokanClient;
 exports.useConnectionStatus = useConnectionStatus;
 exports.useLeaderboard = useLeaderboard;
+exports.usePlayerRewards = usePlayerRewards;
 exports.usePrizeAggregation = usePrizeAggregation;
 exports.usePrizeStats = usePrizeStats;
 exports.usePrizes = usePrizes;