@provable-games/budokan-sdk 0.1.20 → 0.1.22

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

@@ -1,5 +1,5 @@
 import { RpcProvider } from 'starknet';
-import { EntryFee, EntryRequirement, QualificationProof } from '@provable-games/metagame-sdk';
+import { EntryFee, EntryRequirement } from '@provable-games/metagame-sdk';
 
 type DataSource = "api" | "rpc";
 interface BudokanClientConfig {
@@ -111,9 +111,20 @@ interface TournamentListParams {
     whitelistedExtensions?: string[];
     includePrizeSummary?: "summary" | boolean;
 }
+/**
+ * Discriminator for `QualificationEntry.qualificationKind`. Picks one of
+ * the two terminal variants of the on-chain `QualificationProof` enum
+ * (NFT, Extension). `nftTokenId` is populated only for `nft`;
+ * `extensionConfig` only for `extension`.
+ */
+type QualificationKind = "nft" | "extension";
 interface QualificationEntry {
     tournamentId: string;
-    qualificationProof: QualificationProof | null;
+    qualificationKind: QualificationKind;
+    /** Populated when `qualificationKind === "nft"`. u256 token id, decimal string. */
+    nftTokenId: string | null;
+    /** Populated when `qualificationKind === "extension"`. List of felt252 hex strings. */
+    extensionConfig: string[] | null;
     entryCount: number;
 }
 
@@ -141,23 +152,6 @@ interface Registration {
     isBanned: boolean;
 }
 
-type RewardType = {
-    Prize: {
-        tokenAddress: string;
-        tokenType: string;
-    };
-} | {
-    EntryFee: EntryFeeRewardType;
-};
-type EntryFeeRewardType = {
-    Position: number;
-} | {
-    TournamentCreator: Record<string, never>;
-} | {
-    GameCreator: Record<string, never>;
-} | {
-    Refund: string;
-};
 interface Prize {
     prizeId: string;
     tournamentId: string;
@@ -174,9 +168,25 @@ interface Prize {
     distributionCount: number | null;
     sponsorAddress: string;
 }
+/**
+ * Discriminator for `RewardClaim.claimKind`. Picks one of the six terminal
+ * variants of the on-chain `RewardType` enum (Prize::Single, Prize::Distributed,
+ * EntryFee::Position / TournamentCreator / GameCreator / Refund). The
+ * variant-specific fields below are populated only for the kinds that carry
+ * them; the two pure-marker creator kinds leave all four nullable fields null.
+ */
+type RewardClaimKind = "prize_single" | "prize_distributed" | "entry_fee_position" | "entry_fee_tournament_creator" | "entry_fee_game_creator" | "entry_fee_refund";
 interface RewardClaim {
     tournamentId: string;
-    rewardType: RewardType;
+    claimKind: RewardClaimKind;
+    /** Populated for `prize_single` and `prize_distributed`. Stringified u64. */
+    prizeId: string | null;
+    /** Populated for `prize_distributed`. */
+    payoutIndex: number | null;
+    /** Populated for `entry_fee_position`. */
+    position: number | null;
+    /** Populated for `entry_fee_refund`. felt252 hex string of the game token. */
+    refundTokenId: string | null;
     claimed: boolean;
 }
 interface PrizeAggregation {
@@ -191,23 +201,6 @@ interface RewardClaimSummary {
     totalUnclaimed: number;
 }
 
-interface ActivityEvent {
-    id: string;
-    eventType: string;
-    tournamentId: string | null;
-    playerAddress: string | null;
-    data: Record<string, unknown>;
-    blockNumber: string;
-    txHash: string;
-    eventIndex: number;
-}
-interface ActivityParams {
-    eventType?: string;
-    tournamentId?: string;
-    playerAddress?: string;
-    limit?: number;
-    offset?: number;
-}
 interface PlatformStats {
     totalTournaments: number;
     totalPrizes: number;
@@ -451,11 +444,6 @@ declare class BudokanClient {
      * API-only -- no RPC fallback available.
      */
     getTournamentPrizeAggregation(tournamentId: string): Promise<PrizeAggregation[]>;
-    /**
-     * Fetch activity events with optional filtering.
-     * API-only — no RPC fallback available.
-     */
-    getActivity(params?: ActivityParams): Promise<PaginatedResult<ActivityEvent>>;
     /**
      * Fetch platform-wide activity stats.
      * API-only — no RPC fallback available.
@@ -494,4 +482,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 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 };
+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 };

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

@@ -1,5 +1,5 @@
 import { RpcProvider } from 'starknet';
-import { EntryFee, EntryRequirement, QualificationProof } from '@provable-games/metagame-sdk';
+import { EntryFee, EntryRequirement } from '@provable-games/metagame-sdk';
 
 type DataSource = "api" | "rpc";
 interface BudokanClientConfig {
@@ -111,9 +111,20 @@ interface TournamentListParams {
     whitelistedExtensions?: string[];
     includePrizeSummary?: "summary" | boolean;
 }
+/**
+ * Discriminator for `QualificationEntry.qualificationKind`. Picks one of
+ * the two terminal variants of the on-chain `QualificationProof` enum
+ * (NFT, Extension). `nftTokenId` is populated only for `nft`;
+ * `extensionConfig` only for `extension`.
+ */
+type QualificationKind = "nft" | "extension";
 interface QualificationEntry {
     tournamentId: string;
-    qualificationProof: QualificationProof | null;
+    qualificationKind: QualificationKind;
+    /** Populated when `qualificationKind === "nft"`. u256 token id, decimal string. */
+    nftTokenId: string | null;
+    /** Populated when `qualificationKind === "extension"`. List of felt252 hex strings. */
+    extensionConfig: string[] | null;
     entryCount: number;
 }
 
@@ -141,23 +152,6 @@ interface Registration {
     isBanned: boolean;
 }
 
-type RewardType = {
-    Prize: {
-        tokenAddress: string;
-        tokenType: string;
-    };
-} | {
-    EntryFee: EntryFeeRewardType;
-};
-type EntryFeeRewardType = {
-    Position: number;
-} | {
-    TournamentCreator: Record<string, never>;
-} | {
-    GameCreator: Record<string, never>;
-} | {
-    Refund: string;
-};
 interface Prize {
     prizeId: string;
     tournamentId: string;
@@ -174,9 +168,25 @@ interface Prize {
     distributionCount: number | null;
     sponsorAddress: string;
 }
+/**
+ * Discriminator for `RewardClaim.claimKind`. Picks one of the six terminal
+ * variants of the on-chain `RewardType` enum (Prize::Single, Prize::Distributed,
+ * EntryFee::Position / TournamentCreator / GameCreator / Refund). The
+ * variant-specific fields below are populated only for the kinds that carry
+ * them; the two pure-marker creator kinds leave all four nullable fields null.
+ */
+type RewardClaimKind = "prize_single" | "prize_distributed" | "entry_fee_position" | "entry_fee_tournament_creator" | "entry_fee_game_creator" | "entry_fee_refund";
 interface RewardClaim {
     tournamentId: string;
-    rewardType: RewardType;
+    claimKind: RewardClaimKind;
+    /** Populated for `prize_single` and `prize_distributed`. Stringified u64. */
+    prizeId: string | null;
+    /** Populated for `prize_distributed`. */
+    payoutIndex: number | null;
+    /** Populated for `entry_fee_position`. */
+    position: number | null;
+    /** Populated for `entry_fee_refund`. felt252 hex string of the game token. */
+    refundTokenId: string | null;
     claimed: boolean;
 }
 interface PrizeAggregation {
@@ -191,23 +201,6 @@ interface RewardClaimSummary {
     totalUnclaimed: number;
 }
 
-interface ActivityEvent {
-    id: string;
-    eventType: string;
-    tournamentId: string | null;
-    playerAddress: string | null;
-    data: Record<string, unknown>;
-    blockNumber: string;
-    txHash: string;
-    eventIndex: number;
-}
-interface ActivityParams {
-    eventType?: string;
-    tournamentId?: string;
-    playerAddress?: string;
-    limit?: number;
-    offset?: number;
-}
 interface PlatformStats {
     totalTournaments: number;
     totalPrizes: number;
@@ -451,11 +444,6 @@ declare class BudokanClient {
      * API-only -- no RPC fallback available.
      */
     getTournamentPrizeAggregation(tournamentId: string): Promise<PrizeAggregation[]>;
-    /**
-     * Fetch activity events with optional filtering.
-     * API-only — no RPC fallback available.
-     */
-    getActivity(params?: ActivityParams): Promise<PaginatedResult<ActivityEvent>>;
     /**
      * Fetch platform-wide activity stats.
      * API-only — no RPC fallback available.
@@ -494,4 +482,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 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 };
+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 };

package/dist/index.cjs

@@ -369,23 +369,6 @@ function fetchOpts3(ctx) {
     timeout: ctx?.timeout
   };
 }
-async function getActivity(baseUrl, params, ctx) {
-  const qs = buildQueryString({
-    event_type: params?.eventType,
-    tournament_id: params?.tournamentId,
-    player_address: params?.playerAddress,
-    limit: params?.limit,
-    offset: params?.offset
-  });
-  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)),
-    total,
-    limit: resLimit,
-    offset: resOffset
-  };
-}
 async function getActivityStats(baseUrl, ctx) {
   const result = await apiFetch(
     `${baseUrl}/activity/stats`,
@@ -1142,6 +1125,84 @@ async function viewerPrizes(contract, tournamentId) {
     return result.map(parsePrize);
   }, contract.address);
 }
+function translateCairoRewardType(rewardType) {
+  if (!rewardType || typeof rewardType !== "object") {
+    throw new Error(`Unexpected RewardType payload: ${JSON.stringify(rewardType)}`);
+  }
+  const rt = rewardType;
+  const outer = typeof rt.activeVariant === "function" ? rt.activeVariant() : null;
+  const innerBag = typeof rt.activeVariant === "function" ? rt.variant : rt;
+  if (outer === "Prize" || innerBag.Prize !== void 0) {
+    const prize = innerBag.Prize;
+    const subVariant = typeof prize?.activeVariant === "function" ? prize.activeVariant() : null;
+    const subBag = typeof prize?.activeVariant === "function" ? prize.variant : prize;
+    if (subVariant === "Single" || subBag?.Single !== void 0) {
+      return {
+        claimKind: "prize_single",
+        prizeId: BigInt(subBag.Single).toString(),
+        payoutIndex: null,
+        position: null,
+        refundTokenId: null
+      };
+    }
+    if (subVariant === "Distributed" || subBag?.Distributed !== void 0) {
+      const distributed = subBag.Distributed;
+      const prizeId = distributed?.["0"] ?? distributed?.[0];
+      const payoutIndex = distributed?.["1"] ?? distributed?.[1];
+      return {
+        claimKind: "prize_distributed",
+        prizeId: BigInt(prizeId).toString(),
+        payoutIndex: Number(payoutIndex),
+        position: null,
+        refundTokenId: null
+      };
+    }
+  }
+  if (outer === "EntryFee" || innerBag.EntryFee !== void 0) {
+    const entryFee = innerBag.EntryFee;
+    const subVariant = typeof entryFee?.activeVariant === "function" ? entryFee.activeVariant() : null;
+    const subBag = typeof entryFee?.activeVariant === "function" ? entryFee.variant : entryFee;
+    if (subVariant === "Position" || subBag?.Position !== void 0) {
+      return {
+        claimKind: "entry_fee_position",
+        prizeId: null,
+        payoutIndex: null,
+        position: Number(subBag.Position),
+        refundTokenId: null
+      };
+    }
+    if (subVariant === "TournamentCreator" || subBag?.TournamentCreator !== void 0) {
+      return {
+        claimKind: "entry_fee_tournament_creator",
+        prizeId: null,
+        payoutIndex: null,
+        position: null,
+        refundTokenId: null
+      };
+    }
+    if (subVariant === "GameCreator" || subBag?.GameCreator !== void 0) {
+      return {
+        claimKind: "entry_fee_game_creator",
+        prizeId: null,
+        payoutIndex: null,
+        position: null,
+        refundTokenId: null
+      };
+    }
+    if (subVariant === "Refund" || subBag?.Refund !== void 0) {
+      return {
+        claimKind: "entry_fee_refund",
+        prizeId: null,
+        payoutIndex: null,
+        position: null,
+        refundTokenId: `0x${BigInt(subBag.Refund).toString(16)}`
+      };
+    }
+  }
+  throw new Error(
+    `Unrecognised on-chain RewardType variant: ${JSON.stringify(rewardType)}`
+  );
+}
 async function viewerRewardClaims(contract, tournamentId, offset, limit) {
   return wrapRpcCall(async () => {
     const result = await contract.call("tournament_reward_claims", [tournamentId, offset, limit]);
@@ -1149,7 +1210,7 @@ async function viewerRewardClaims(contract, tournamentId, offset, limit) {
     const claims = obj.claims?.map((raw) => {
       const claim = raw;
       return {
-        rewardType: claim.reward_type,
+        ...translateCairoRewardType(claim.reward_type),
         claimed: Boolean(claim.claimed)
       };
     }) ?? [];
@@ -4546,8 +4607,7 @@ var BudokanClient = class {
       const result = await viewerRewardClaims(contract, tournamentId, offset, limit);
       const data = result.claims.map((c) => ({
         tournamentId,
-        rewardType: c.rewardType,
-        claimed: c.claimed
+        ...c
       }));
       return { data, total: result.total, limit, offset };
     };
@@ -4598,13 +4658,6 @@ var BudokanClient = class {
     return getTournamentPrizeAggregation(this.resolvedConfig.apiBaseUrl, tournamentId, this.apiCtx);
   }
   // ---- Activity Queries (API-only, activity is indexed) ----
-  /**
-   * Fetch activity events with optional filtering.
-   * API-only — no RPC fallback available.
-   */
-  async getActivity(params) {
-    return getActivity(this.resolvedConfig.apiBaseUrl, params, this.apiCtx);
-  }
   /**
    * Fetch platform-wide activity stats.
    * API-only — no RPC fallback available.
@@ -4671,7 +4724,6 @@ exports.TournamentNotFoundError = TournamentNotFoundError;
 exports.WSManager = WSManager;
 exports.camelToSnake = camelToSnake;
 exports.createBudokanClient = createBudokanClient;
-exports.getActivity = getActivity;
 exports.getActivityStats = getActivityStats;
 exports.getChainConfig = getChainConfig;
 exports.getGameStats = getGameStats;