@provable-games/budokan-sdk 0.1.24 → 0.1.25

package/dist/{player-C2GE9Lop.d.cts → player-P6Dd1lNb.d.cts}

@@ -53,6 +53,14 @@ interface Tournament {
     leaderboardGameMustBeOver: boolean | null;
     entryFeeToken: string | null;
     entryFeeAmount: string | null;
+    /**
+     * Effective protocol-fee rate (basis points) snapshotted for this tournament
+     * at creation — the slice of the built-in entry-fee pool routed to the DAO
+     * buyback/treasury. `0` when no protocol fee applies. Sourced from the
+     * `TournamentCreated` event via the indexer/API; `null` over the RPC/viewer
+     * data source (the per-tournament snapshot has no on-chain getter).
+     */
+    protocolFeeShare: number | null;
     hasEntryRequirement: boolean | null;
     schedule: Schedule | null;
     gameConfig: GameConfig | null;
@@ -189,14 +197,40 @@ interface Prize {
     /** Opaque `Span<felt252>` config; only set when `tokenType === "extension"`. */
     extensionConfig: string[] | null;
 }
+type Erc20Prize = Prize & {
+    tokenType: "erc20";
+    tokenAddress: string;
+    amount: string;
+    tokenId: null;
+    extensionAddress: null;
+    extensionConfig: null;
+};
+type Erc721Prize = Prize & {
+    tokenType: "erc721";
+    tokenAddress: string;
+    amount: null;
+    tokenId: string;
+    extensionAddress: null;
+    extensionConfig: null;
+};
+type TokenPrize = Erc20Prize | Erc721Prize;
+type ExtensionPrize = Prize & {
+    tokenType: "extension";
+    tokenAddress: null;
+    amount: null;
+    tokenId: null;
+    extensionAddress: string;
+    extensionConfig: string[] | null;
+};
 /**
- * Discriminator for `RewardClaim.claimKind`. Picks one of the six terminal
+ * Discriminator for `RewardClaim.claimKind`. Picks one of the seven 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.
+ * EntryFee::Position / TournamentCreator / GameCreator / Refund / ProtocolFee).
+ * The variant-specific fields below are populated only for the kinds that carry
+ * them; the three pure-marker kinds (tournament_creator, game_creator,
+ * protocol_fee) 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" | "prize_extension" | "entry_fee_extension";
+type RewardClaimKind = "prize_single" | "prize_distributed" | "entry_fee_position" | "entry_fee_tournament_creator" | "entry_fee_game_creator" | "entry_fee_protocol_fee" | "entry_fee_refund" | "prize_extension" | "entry_fee_extension";
 interface RewardClaim {
     tournamentId: string;
     claimKind: RewardClaimKind;
@@ -542,4 +576,4 @@ interface PlayerRewards {
     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 };
+export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type ExtensionPrize as E, 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 TokenPrize as i, type BudokanClientConfig as j, ConnectionStatus as k, type ConnectionStatusState as l, type Erc20Prize as m, type Erc721Prize as n, type LeaderboardEntry as o, type Phase as p, type PlayerPlacement as q, type PlayerRewards as r, type WSChannel as s, type WSEventMessage as t, type WSMessage as u, type WSSubscribeMessage as v, type WSUnsubscribeMessage as w, createBudokanClient as x };

package/dist/{player-C2GE9Lop.d.ts → player-P6Dd1lNb.d.ts}

@@ -53,6 +53,14 @@ interface Tournament {
     leaderboardGameMustBeOver: boolean | null;
     entryFeeToken: string | null;
     entryFeeAmount: string | null;
+    /**
+     * Effective protocol-fee rate (basis points) snapshotted for this tournament
+     * at creation — the slice of the built-in entry-fee pool routed to the DAO
+     * buyback/treasury. `0` when no protocol fee applies. Sourced from the
+     * `TournamentCreated` event via the indexer/API; `null` over the RPC/viewer
+     * data source (the per-tournament snapshot has no on-chain getter).
+     */
+    protocolFeeShare: number | null;
     hasEntryRequirement: boolean | null;
     schedule: Schedule | null;
     gameConfig: GameConfig | null;
@@ -189,14 +197,40 @@ interface Prize {
     /** Opaque `Span<felt252>` config; only set when `tokenType === "extension"`. */
     extensionConfig: string[] | null;
 }
+type Erc20Prize = Prize & {
+    tokenType: "erc20";
+    tokenAddress: string;
+    amount: string;
+    tokenId: null;
+    extensionAddress: null;
+    extensionConfig: null;
+};
+type Erc721Prize = Prize & {
+    tokenType: "erc721";
+    tokenAddress: string;
+    amount: null;
+    tokenId: string;
+    extensionAddress: null;
+    extensionConfig: null;
+};
+type TokenPrize = Erc20Prize | Erc721Prize;
+type ExtensionPrize = Prize & {
+    tokenType: "extension";
+    tokenAddress: null;
+    amount: null;
+    tokenId: null;
+    extensionAddress: string;
+    extensionConfig: string[] | null;
+};
 /**
- * Discriminator for `RewardClaim.claimKind`. Picks one of the six terminal
+ * Discriminator for `RewardClaim.claimKind`. Picks one of the seven 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.
+ * EntryFee::Position / TournamentCreator / GameCreator / Refund / ProtocolFee).
+ * The variant-specific fields below are populated only for the kinds that carry
+ * them; the three pure-marker kinds (tournament_creator, game_creator,
+ * protocol_fee) 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" | "prize_extension" | "entry_fee_extension";
+type RewardClaimKind = "prize_single" | "prize_distributed" | "entry_fee_position" | "entry_fee_tournament_creator" | "entry_fee_game_creator" | "entry_fee_protocol_fee" | "entry_fee_refund" | "prize_extension" | "entry_fee_extension";
 interface RewardClaim {
     tournamentId: string;
     claimKind: RewardClaimKind;
@@ -542,4 +576,4 @@ interface PlayerRewards {
     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 };
+export { BudokanClient as B, type ConnectionMode as C, type DataSource as D, type ExtensionPrize as E, 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 TokenPrize as i, type BudokanClientConfig as j, ConnectionStatus as k, type ConnectionStatusState as l, type Erc20Prize as m, type Erc721Prize as n, type LeaderboardEntry as o, type Phase as p, type PlayerPlacement as q, type PlayerRewards as r, type WSChannel as s, type WSEventMessage as t, type WSMessage as u, type WSSubscribeMessage as v, type WSUnsubscribeMessage as w, createBudokanClient as x };

package/dist/react.cjs

@@ -203,7 +203,8 @@ function snakeToCamel(obj) {
 function normalizeTournament(raw) {
   const t = snakeToCamel(raw);
   const id = t.id ?? t.tournamentId;
-  return { ...t, id, tournamentId: id };
+  const protocolFeeShare = t.protocolFeeShare ?? t.entryFee?.protocolFeeShare ?? null;
+  return { ...t, id, tournamentId: id, protocolFeeShare };
 }
 function fetchOpts(ctx) {
   return {
@@ -807,7 +808,7 @@ function phaseToRpcArg(phase) {
   }
   return new starknet.CairoCustomEnum(variants);
 }
-function parseTournament(raw, entryCount) {
+function parseTournament(raw, entryCount, protocolFeeShare = null) {
   const obj = raw;
   const id = String(obj.id ?? "0");
   const createdAt = Number(obj.created_at ?? 0);
@@ -905,6 +906,8 @@ function parseTournament(raw, entryCount) {
     leaderboardGameMustBeOver: gameMustBeOver,
     entryFeeToken,
     entryFeeAmount,
+    // Protocol-fee bps snapshot, surfaced by the viewer's TournamentFullState.
+    protocolFeeShare,
     hasEntryRequirement,
     schedule: {
       registrationStartDelay,
@@ -1071,7 +1074,8 @@ function parseFilterResult(raw) {
 function parseTournamentFullState(raw) {
   const obj = raw;
   const entryCount = Number(obj.entry_count ?? 0);
-  return parseTournament(obj.tournament, entryCount);
+  const protocolFeeShare = obj.protocol_fee_bps != null ? Number(obj.protocol_fee_bps) : null;
+  return parseTournament(obj.tournament, entryCount, protocolFeeShare);
 }
 async function viewerTournaments(contract, offset, limit) {
   return wrapRpcCall(async () => {
@@ -1247,6 +1251,9 @@ function translateCairoRewardType(rewardType) {
     if (subVariant === "GameCreator" || subBag?.GameCreator !== void 0) {
       return rewardClaim({ claimKind: "entry_fee_game_creator" });
     }
+    if (subVariant === "ProtocolFee" || subBag?.ProtocolFee !== void 0) {
+      return rewardClaim({ claimKind: "entry_fee_protocol_fee" });
+    }
     if (subVariant === "Refund" || subBag?.Refund !== void 0) {
       return rewardClaim({
         claimKind: "entry_fee_refund",
@@ -1719,6 +1726,10 @@ var budokanViewer_default = [
       {
         name: "phase",
         type: "budokan_interfaces::budokan::Phase"
+      },
+      {
+        name: "protocol_fee_bps",
+        type: "core::integer::u16"
       }
     ]
   },
@@ -1989,6 +2000,10 @@ var budokanViewer_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -3367,6 +3382,10 @@ var budokan_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -4655,6 +4674,11 @@ var budokan_default = [
         name: "entry_requirement",
         type: "core::option::Option::<game_components_interfaces::entry_requirement::EntryRequirement>",
         kind: "data"
+      },
+      {
+        name: "protocol_fee_bps",
+        type: "core::integer::u16",
+        kind: "data"
       }
     ]
   },
@@ -4877,6 +4901,108 @@ var budokan_default = [
         name: "QualificationEntriesUpdated",
         type: "budokan::events::QualificationEntriesUpdated",
         kind: "nested"
+      },
+      {
+        name: "ProtocolFeeBpsUpdated",
+        type: "budokan::events::ProtocolFeeBpsUpdated",
+        kind: "nested"
+      },
+      {
+        name: "ProtocolFeeRecipientUpdated",
+        type: "budokan::events::ProtocolFeeRecipientUpdated",
+        kind: "nested"
+      }
+    ]
+  },
+  {
+    type: "interface",
+    name: "budokan::budokan::Budokan::IBudokanProtocolFeeAdmin",
+    items: [
+      {
+        type: "function",
+        name: "set_protocol_fee_bps",
+        inputs: [
+          {
+            name: "bps",
+            type: "core::integer::u16"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "set_protocol_fee_recipient",
+        inputs: [
+          {
+            name: "recipient",
+            type: "core::starknet::contract_address::ContractAddress"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "protocol_fee_bps",
+        inputs: [],
+        outputs: [
+          {
+            type: "core::integer::u16"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "protocol_fee_recipient",
+        inputs: [],
+        outputs: [
+          {
+            type: "core::starknet::contract_address::ContractAddress"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "tournament_protocol_fee_bps",
+        inputs: [
+          {
+            name: "tournament_id",
+            type: "core::integer::u64"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::integer::u16"
+          }
+        ],
+        state_mutability: "view"
+      }
+    ]
+  },
+  {
+    type: "event",
+    name: "budokan::events::ProtocolFeeBpsUpdated",
+    kind: "struct",
+    members: [
+      {
+        name: "bps",
+        type: "core::integer::u16",
+        kind: "data"
+      }
+    ]
+  },
+  {
+    type: "event",
+    name: "budokan::events::ProtocolFeeRecipientUpdated",
+    kind: "struct",
+    members: [
+      {
+        name: "recipient",
+        type: "core::starknet::contract_address::ContractAddress",
+        kind: "key"
       }
     ]
   }