@provable-games/budokan-sdk 0.1.8 → 0.1.10

package/dist/{client-CYj1Iw_w.d.cts → client-ugXv3NlV.d.cts}

@@ -349,7 +349,7 @@ declare class BudokanClient {
      * Fetch a single tournament by its ID.
      * Supports RPC fallback when API is unavailable.
      */
-    getTournament(tournamentId: string): Promise<Tournament>;
+    getTournament(tournamentId: string): Promise<Tournament | null>;
     /**
      * Fetch the leaderboard for a tournament.
      * Supports RPC fallback when API is unavailable.
@@ -358,9 +358,15 @@ declare class BudokanClient {
     /**
      * Fetch registrations for a tournament.
      * Supports RPC fallback when API is unavailable.
-     * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings.
+     * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings,
+     * and filter params (`playerAddress`, `gameTokenIds`, `hasSubmitted`, `isBanned`)
+     * are applied via on-chain viewer functions where supported.
      */
     getTournamentRegistrations(tournamentId: string, params?: {
+        playerAddress?: string;
+        gameTokenIds?: string[];
+        hasSubmitted?: boolean;
+        isBanned?: boolean;
         limit?: number;
         offset?: number;
     }): Promise<PaginatedResult<Registration>>;

package/dist/{client-CYj1Iw_w.d.ts → client-ugXv3NlV.d.ts}

@@ -349,7 +349,7 @@ declare class BudokanClient {
      * Fetch a single tournament by its ID.
      * Supports RPC fallback when API is unavailable.
      */
-    getTournament(tournamentId: string): Promise<Tournament>;
+    getTournament(tournamentId: string): Promise<Tournament | null>;
     /**
      * Fetch the leaderboard for a tournament.
      * Supports RPC fallback when API is unavailable.
@@ -358,9 +358,15 @@ declare class BudokanClient {
     /**
      * Fetch registrations for a tournament.
      * Supports RPC fallback when API is unavailable.
-     * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings.
+     * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings,
+     * and filter params (`playerAddress`, `gameTokenIds`, `hasSubmitted`, `isBanned`)
+     * are applied via on-chain viewer functions where supported.
      */
     getTournamentRegistrations(tournamentId: string, params?: {
+        playerAddress?: string;
+        gameTokenIds?: string[];
+        hasSubmitted?: boolean;
+        isBanned?: boolean;
         limit?: number;
         offset?: number;
     }): Promise<PaginatedResult<Registration>>;

package/dist/index.cjs

@@ -261,6 +261,10 @@ async function getTournamentLeaderboard(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,
     limit: params?.limit,
     offset: params?.offset
   });
@@ -1124,7 +1128,9 @@ async function viewerTournamentsByPhase(contract, phase, offset, limit) {
 async function viewerTournamentDetail(contract, tournamentId) {
   return wrapRpcCall(async () => {
     const result = await contract.call("tournament_detail", [tournamentId]);
-    return parseTournamentFullState(result);
+    const tournament = parseTournamentFullState(result);
+    if (!tournament.gameAddress || tournament.gameAddress === "0x0") return null;
+    return tournament;
   }, contract.address);
 }
 async function viewerTournamentsBatch(contract, tournamentIds) {
@@ -1147,6 +1153,34 @@ 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]);
+    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 viewerLeaderboard(contract, tournamentId, offset, limit) {
   return wrapRpcCall(async () => {
     const result = await contract.call("leaderboard", [tournamentId, offset, limit]);
@@ -2533,11 +2567,16 @@ var BudokanClient = class {
     if (this.resolvedConfig.primarySource === "rpc") {
       return rpcFallback();
     }
-    return withFallback(
-      () => getTournament(this.resolvedConfig.apiBaseUrl, tournamentId, this.apiCtx),
-      rpcFallback,
-      this.connectionStatus
-    );
+    try {
+      return await getTournament(this.resolvedConfig.apiBaseUrl, tournamentId, this.apiCtx);
+    } catch {
+      try {
+        this.connectionStatus.markApiUnavailable();
+        return await rpcFallback();
+      } catch {
+        return null;
+      }
+    }
   }
   /**
    * Fetch the leaderboard for a tournament.
@@ -2560,13 +2599,21 @@ var BudokanClient = class {
   /**
    * Fetch registrations for a tournament.
    * Supports RPC fallback when API is unavailable.
-   * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings.
+   * Note: In RPC mode, `playerAddress` and `gameAddress` fields will be empty strings,
+   * and filter params (`playerAddress`, `gameTokenIds`, `hasSubmitted`, `isBanned`)
+   * are applied via on-chain viewer functions where supported.
    */
   async getTournamentRegistrations(tournamentId, params) {
     const rpcFallback = async () => {
       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);
+      }
       return viewerRegistrations(contract, tournamentId, offset, limit);
     };
     if (this.resolvedConfig.primarySource === "rpc") {