@provable-games/budokan-sdk 0.1.21 → 0.1.22

package/dist/{client-0HDPKrdw.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 {

package/dist/{client-0HDPKrdw.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 {

package/dist/index.cjs

@@ -1125,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]);
@@ -1132,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)
       };
     }) ?? [];
@@ -4529,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 };
     };