@provable-games/budokan-sdk 0.1.18 → 0.1.20

package/dist/{client-C4PUxzuO.d.cts → client-CoWIQozF.d.cts}

@@ -100,6 +100,14 @@ interface TournamentListParams {
     sort?: "start_time" | "end_time" | "players" | "created_at";
     fromId?: string;
     excludeIds?: string[];
+    /**
+     * Restrict results to this set of tournament IDs. Used by the
+     * "My Tournaments" UX where the caller derives ids from currently-owned
+     * game tokens (denshokan-sdk) and asks Budokan only for those tournaments.
+     * Mutually exclusive with no-filter "show everything" semantics — an empty
+     * array yields zero results, not all tournaments.
+     */
+    tournamentIds?: string[];
     whitelistedExtensions?: string[];
     includePrizeSummary?: "summary" | boolean;
 }
@@ -114,11 +122,20 @@ interface LeaderboardEntry {
     tokenId: string;
 }
 
+/**
+ * A registration row keyed by (tournamentId, gameTokenId).
+ *
+ * Note: there is intentionally no `playerAddress` field. The contract keys
+ * registrations by token id only — once the underlying NFT transfers, any
+ * stored "registrant" address is the wrong signal for current ownership.
+ * Callers that need the current owner of an entry should resolve it via
+ * `denshokan-sdk.useTokens` (filtering by minterAddress + contextId).
+ * See Provable-Games/budokan#241.
+ */
 interface Registration {
     tournamentId: string;
     gameTokenId: string;
     gameAddress: string;
-    playerAddress: string;
     entryNumber: number;
     hasSubmitted: boolean;
     isBanned: boolean;
@@ -174,20 +191,6 @@ interface RewardClaimSummary {
     totalUnclaimed: number;
 }
 
-interface PlayerStats {
-    totalTournaments: number;
-    totalSubmissions: number;
-}
-interface PlayerTournament extends Tournament {
-    registration: Registration;
-}
-interface PlayerTournamentParams {
-    phase?: Phase;
-    gameTokenIds?: string[];
-    limit?: number;
-    offset?: number;
-}
-
 interface ActivityEvent {
     id: string;
     eventType: string;
@@ -401,7 +404,6 @@ declare class BudokanClient {
      * are applied via on-chain viewer functions where supported.
      */
     getTournamentRegistrations(tournamentId: string, params?: {
-        playerAddress?: string;
         gameTokenIds?: string[];
         hasSubmitted?: boolean;
         isBanned?: boolean;
@@ -413,16 +415,6 @@ declare class BudokanClient {
      * Supports RPC fallback when API is unavailable.
      */
     getTournamentPrizes(tournamentId: string): Promise<Prize[]>;
-    /**
-     * Fetch tournaments that a player has registered for.
-     * Supports RPC fallback via viewer contract.
-     */
-    getPlayerTournaments(address: string, params?: PlayerTournamentParams): Promise<PaginatedResult<PlayerTournament>>;
-    /**
-     * Fetch stats for a player.
-     * API-only — no RPC fallback available.
-     */
-    getPlayerStats(address: string): Promise<PlayerStats>;
     /**
      * Fetch tournaments for a specific game.
      * Supports RPC fallback when API is unavailable.
@@ -502,4 +494,4 @@ declare class BudokanClient {
  */
 declare function createBudokanClient(config: BudokanClientConfig): BudokanClient;
 
-export { type ActivityParams as A, 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 PlayerStats as f, type PlayerTournamentParams as g, type PlayerTournament as h, type PlatformStats as i, type ActivityEvent as j, type PrizeStats as k, type WSEventHandler as l, type BudokanClientConfig as m, ConnectionStatus as n, type ConnectionStatusState as o, type LeaderboardEntry as p, type Phase as q, type WSChannel as r, type WSEventMessage as s, type WSMessage as t, type WSSubscribeMessage as u, type WSUnsubscribeMessage as v, createBudokanClient as w };
+export { type ActivityParams as A, 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 ActivityEvent as g, type PrizeStats as h, type WSEventHandler as i, type BudokanClientConfig as j, ConnectionStatus as k, type ConnectionStatusState as l, type LeaderboardEntry as m, type Phase as n, type WSChannel as o, type WSEventMessage as p, type WSMessage as q, type WSSubscribeMessage as r, type WSUnsubscribeMessage as s, createBudokanClient as t };

package/dist/{client-C4PUxzuO.d.ts → client-CoWIQozF.d.ts}

@@ -100,6 +100,14 @@ interface TournamentListParams {
     sort?: "start_time" | "end_time" | "players" | "created_at";
     fromId?: string;
     excludeIds?: string[];
+    /**
+     * Restrict results to this set of tournament IDs. Used by the
+     * "My Tournaments" UX where the caller derives ids from currently-owned
+     * game tokens (denshokan-sdk) and asks Budokan only for those tournaments.
+     * Mutually exclusive with no-filter "show everything" semantics — an empty
+     * array yields zero results, not all tournaments.
+     */
+    tournamentIds?: string[];
     whitelistedExtensions?: string[];
     includePrizeSummary?: "summary" | boolean;
 }
@@ -114,11 +122,20 @@ interface LeaderboardEntry {
     tokenId: string;
 }
 
+/**
+ * A registration row keyed by (tournamentId, gameTokenId).
+ *
+ * Note: there is intentionally no `playerAddress` field. The contract keys
+ * registrations by token id only — once the underlying NFT transfers, any
+ * stored "registrant" address is the wrong signal for current ownership.
+ * Callers that need the current owner of an entry should resolve it via
+ * `denshokan-sdk.useTokens` (filtering by minterAddress + contextId).
+ * See Provable-Games/budokan#241.
+ */
 interface Registration {
     tournamentId: string;
     gameTokenId: string;
     gameAddress: string;
-    playerAddress: string;
     entryNumber: number;
     hasSubmitted: boolean;
     isBanned: boolean;
@@ -174,20 +191,6 @@ interface RewardClaimSummary {
     totalUnclaimed: number;
 }
 
-interface PlayerStats {
-    totalTournaments: number;
-    totalSubmissions: number;
-}
-interface PlayerTournament extends Tournament {
-    registration: Registration;
-}
-interface PlayerTournamentParams {
-    phase?: Phase;
-    gameTokenIds?: string[];
-    limit?: number;
-    offset?: number;
-}
-
 interface ActivityEvent {
     id: string;
     eventType: string;
@@ -401,7 +404,6 @@ declare class BudokanClient {
      * are applied via on-chain viewer functions where supported.
      */
     getTournamentRegistrations(tournamentId: string, params?: {
-        playerAddress?: string;
         gameTokenIds?: string[];
         hasSubmitted?: boolean;
         isBanned?: boolean;
@@ -413,16 +415,6 @@ declare class BudokanClient {
      * Supports RPC fallback when API is unavailable.
      */
     getTournamentPrizes(tournamentId: string): Promise<Prize[]>;
-    /**
-     * Fetch tournaments that a player has registered for.
-     * Supports RPC fallback via viewer contract.
-     */
-    getPlayerTournaments(address: string, params?: PlayerTournamentParams): Promise<PaginatedResult<PlayerTournament>>;
-    /**
-     * Fetch stats for a player.
-     * API-only — no RPC fallback available.
-     */
-    getPlayerStats(address: string): Promise<PlayerStats>;
     /**
      * Fetch tournaments for a specific game.
      * Supports RPC fallback when API is unavailable.
@@ -502,4 +494,4 @@ declare class BudokanClient {
  */
 declare function createBudokanClient(config: BudokanClientConfig): BudokanClient;
 
-export { type ActivityParams as A, 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 PlayerStats as f, type PlayerTournamentParams as g, type PlayerTournament as h, type PlatformStats as i, type ActivityEvent as j, type PrizeStats as k, type WSEventHandler as l, type BudokanClientConfig as m, ConnectionStatus as n, type ConnectionStatusState as o, type LeaderboardEntry as p, type Phase as q, type WSChannel as r, type WSEventMessage as s, type WSMessage as t, type WSSubscribeMessage as u, type WSUnsubscribeMessage as v, createBudokanClient as w };
+export { type ActivityParams as A, 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 ActivityEvent as g, type PrizeStats as h, type WSEventHandler as i, type BudokanClientConfig as j, ConnectionStatus as k, type ConnectionStatusState as l, type LeaderboardEntry as m, type Phase as n, type WSChannel as o, type WSEventMessage as p, type WSMessage as q, type WSSubscribeMessage as r, type WSUnsubscribeMessage as s, createBudokanClient as t };

package/dist/index.cjs

@@ -233,6 +233,7 @@ async function getTournaments(baseUrl, params, ctx) {
     sort: params?.sort,
     from_id: params?.fromId,
     exclude_ids: params?.excludeIds?.join(","),
+    tournament_ids: params?.tournamentIds?.join(","),
     whitelisted_extensions: params?.whitelistedExtensions?.join(","),
     include_prizes: params?.includePrizeSummary
   });
@@ -254,7 +255,6 @@ async function getTournament(baseUrl, tournamentId, ctx) {
 }
 async function getTournamentRegistrations(baseUrl, tournamentId, params, ctx) {
   const qs = buildQueryString({
-    player_address: params?.playerAddress,
     game_token_ids: params?.gameTokenIds?.length ? params.gameTokenIds.join(",") : void 0,
     has_submitted: params?.hasSubmitted,
     is_banned: params?.isBanned,
@@ -327,42 +327,8 @@ function normalizeAddress(address) {
   return ("0x" + stripped.padStart(64, "0")).toLowerCase();
 }
 
-// src/api/players.ts
-function fetchOpts2(ctx) {
-  return {
-    retryAttempts: ctx?.retryAttempts,
-    retryDelay: ctx?.retryDelay,
-    timeout: ctx?.timeout
-  };
-}
-async function getPlayerTournaments(baseUrl, address, params, ctx) {
-  const normalized = normalizeAddress(address);
-  const qs = buildQueryString({
-    limit: params?.limit,
-    offset: params?.offset,
-    phase: params?.phase,
-    game_token_ids: params?.gameTokenIds?.join(",")
-  });
-  const result = await apiFetch(`${baseUrl}/players/${normalized}/tournaments${qs}`, fetchOpts2(ctx));
-  const { total, limit: resLimit, offset: resOffset } = extractPagination(result, { limit: params?.limit, offset: params?.offset });
-  return {
-    data: result.data.map((item) => snakeToCamel(item)),
-    total,
-    limit: resLimit,
-    offset: resOffset
-  };
-}
-async function getPlayerStats(baseUrl, address, ctx) {
-  const normalized = normalizeAddress(address);
-  const result = await apiFetch(
-    `${baseUrl}/players/${normalized}/stats`,
-    fetchOpts2(ctx)
-  );
-  return snakeToCamel(result.data);
-}
-
 // src/api/games.ts
-function fetchOpts3(ctx) {
+function fetchOpts2(ctx) {
   return {
     retryAttempts: ctx?.retryAttempts,
     retryDelay: ctx?.retryDelay,
@@ -377,7 +343,7 @@ async function getGameTournaments(baseUrl, gameAddress, params, ctx) {
     limit: params?.limit,
     offset: params?.offset
   });
-  const result = await apiFetch(`${baseUrl}/games/${normalized}/tournaments${qs}`, fetchOpts3(ctx));
+  const result = await apiFetch(`${baseUrl}/games/${normalized}/tournaments${qs}`, fetchOpts2(ctx));
   const { total, limit: resLimit, offset: resOffset } = extractPagination(result, { limit: params?.limit, offset: params?.offset });
   return {
     data: result.data.map((item) => snakeToCamel(item)),
@@ -390,13 +356,13 @@ async function getGameStats(baseUrl, gameAddress, ctx) {
   const normalized = normalizeAddress(gameAddress);
   const result = await apiFetch(
     `${baseUrl}/games/${normalized}/stats`,
-    fetchOpts3(ctx)
+    fetchOpts2(ctx)
   );
   return snakeToCamel(result.data);
 }
 
 // src/api/activity.ts
-function fetchOpts4(ctx) {
+function fetchOpts3(ctx) {
   return {
     retryAttempts: ctx?.retryAttempts,
     retryDelay: ctx?.retryDelay,
@@ -411,7 +377,7 @@ async function getActivity(baseUrl, params, ctx) {
     limit: params?.limit,
     offset: params?.offset
   });
-  const result = await apiFetch(`${baseUrl}/activity${qs}`, fetchOpts4(ctx));
+  const result = await apiFetch(`${baseUrl}/activity${qs}`, fetchOpts3(ctx));
   const { total, limit: resLimit, offset: resOffset } = extractPagination(result, { limit: params?.limit, offset: params?.offset });
   return {
     data: result.data.map((item) => snakeToCamel(item)),
@@ -423,14 +389,14 @@ async function getActivity(baseUrl, params, ctx) {
 async function getActivityStats(baseUrl, ctx) {
   const result = await apiFetch(
     `${baseUrl}/activity/stats`,
-    fetchOpts4(ctx)
+    fetchOpts3(ctx)
   );
   return snakeToCamel(result.data);
 }
 async function getPrizeStats(baseUrl, ctx) {
   const result = await apiFetch(
     `${baseUrl}/activity/prize-stats`,
-    fetchOpts4(ctx)
+    fetchOpts3(ctx)
   );
   return snakeToCamel(result.data);
 }
@@ -992,8 +958,6 @@ function parseRegistration(raw, tournamentId) {
     gameTokenId: starknet.num.toHex(obj.game_token_id),
     gameAddress: "",
     // Not in on-chain struct
-    playerAddress: "",
-    // Not in on-chain struct
     entryNumber: Number(obj.entry_id ?? 0),
     hasSubmitted: Boolean(obj.has_submitted),
     isBanned: Boolean(obj.is_banned)
@@ -1152,20 +1116,6 @@ async function viewerRegistrations(contract, tournamentId, offset, limit) {
     };
   }, contract.address);
 }
-async function viewerRegistrationsByOwner(contract, tournamentId, owner, offset, limit) {
-  return wrapRpcCall(async () => {
-    const result = await contract.call("tournament_registrations_by_owner", [tournamentId, owner, offset, limit]);
-    const obj = result;
-    const entries = obj.entries ?? [];
-    const total = Number(obj.total ?? 0);
-    return {
-      data: entries.map((e) => parseRegistration(e, tournamentId)),
-      total,
-      limit,
-      offset
-    };
-  }, contract.address);
-}
 async function viewerRegistrationsByTokenIds(contract, tournamentId, tokenIds, offset, limit) {
   return wrapRpcCall(async () => {
     const result = await contract.call("tournament_registrations_by_token_ids", [tournamentId, tokenIds, offset, limit]);
@@ -1211,12 +1161,6 @@ async function viewerRewardClaims(contract, tournamentId, offset, limit) {
     };
   }, contract.address);
 }
-async function viewerPlayerTournaments(contract, playerAddress, offset, limit) {
-  return wrapRpcCall(async () => {
-    const result = await contract.call("player_tournaments", [playerAddress, offset, limit]);
-    return parseFilterResult(result);
-  }, contract.address);
-}
 
 // src/rpc/abis/budokanViewer.json
 var budokanViewer_default = [
@@ -4524,9 +4468,6 @@ var BudokanClient = class {
       const contract = await this.getViewerContract();
       const offset = params?.offset ?? 0;
       const limit = params?.limit ?? 20;
-      if (params?.playerAddress) {
-        return viewerRegistrationsByOwner(contract, tournamentId, params.playerAddress, offset, limit);
-      }
       if (params?.gameTokenIds?.length) {
         return viewerRegistrationsByTokenIds(contract, tournamentId, params.gameTokenIds, offset, limit);
       }
@@ -4559,43 +4500,6 @@ var BudokanClient = class {
       this.connectionStatus
     );
   }
-  // ---- Player Queries (API-only, no on-chain equivalent) ----
-  /**
-   * Fetch tournaments that a player has registered for.
-   * Supports RPC fallback via viewer contract.
-   */
-  async getPlayerTournaments(address, params) {
-    const rpcFallback = async () => {
-      const contract = await this.getViewerContract();
-      const offset = params?.offset ?? 0;
-      const limit = params?.limit ?? 20;
-      const filterResult = await viewerPlayerTournaments(contract, address, offset, limit);
-      let data = [];
-      if (filterResult.tournamentIds.length > 0) {
-        const tournaments = await viewerTournamentsBatch(contract, filterResult.tournamentIds);
-        data = tournaments.map((t) => ({
-          ...t,
-          tournamentId: t.id
-        }));
-      }
-      return { data, total: filterResult.total, limit, offset };
-    };
-    if (this.resolvedConfig.primarySource === "rpc") {
-      return rpcFallback();
-    }
-    return withFallback(
-      () => getPlayerTournaments(this.resolvedConfig.apiBaseUrl, address, params, this.apiCtx),
-      rpcFallback,
-      this.connectionStatus
-    );
-  }
-  /**
-   * Fetch stats for a player.
-   * API-only — no RPC fallback available.
-   */
-  async getPlayerStats(address) {
-    return getPlayerStats(this.resolvedConfig.apiBaseUrl, address, this.apiCtx);
-  }
   // ---- Game Queries ----
   /**
    * Fetch tournaments for a specific game.
@@ -4772,8 +4676,6 @@ exports.getActivityStats = getActivityStats;
 exports.getChainConfig = getChainConfig;
 exports.getGameStats = getGameStats;
 exports.getGameTournaments = getGameTournaments;
-exports.getPlayerStats = getPlayerStats;
-exports.getPlayerTournaments = getPlayerTournaments;
 exports.getPrizeStats = getPrizeStats;
 exports.getTournament = getTournament;
 exports.getTournamentPrizeAggregation = getTournamentPrizeAggregation;