@provable-games/budokan-sdk 0.1.24 → 0.1.26

package/dist/{player-C2GE9Lop.d.cts → player-CbAYHoW8.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;
@@ -70,6 +78,14 @@ interface Tournament {
     } | null;
     entryRequirement: EntryRequirement | null;
     leaderboardConfig: LeaderboardConfig | null;
+    /**
+     * Lifecycle phase derived from the schedule + on-chain creation time.
+     * Populated by `getTournament`/`getTournaments` (computed at read time via
+     * `tournamentPhase`); `null` when the creation time is unknown. Because it's
+     * time-derived, treat it as a snapshot for the moment it was read — call
+     * `tournamentPhase(t)` to re-evaluate later.
+     */
+    phase: Phase | null;
     entryCount: number;
     prizeCount: number;
     submissionCount: number;
@@ -189,14 +205,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;
@@ -341,7 +383,7 @@ declare class ConnectionStatus {
  * // RPC-only (bypass API entirely)
  * const client = new BudokanClient({
  *   primarySource: "rpc",
- *   rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet/rpc/v0_10",
+ *   rpcUrl: "https://rpc.provable.games/rpc",
  *   viewerAddress: "0x...",
  * });
  * ```
@@ -542,4 +584,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 PlayerPlacement as j, type Phase as k, type BudokanClientConfig as l, ConnectionStatus as m, type ConnectionStatusState as n, type Erc20Prize as o, type Erc721Prize as p, type LeaderboardEntry 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-CbAYHoW8.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;
@@ -70,6 +78,14 @@ interface Tournament {
     } | null;
     entryRequirement: EntryRequirement | null;
     leaderboardConfig: LeaderboardConfig | null;
+    /**
+     * Lifecycle phase derived from the schedule + on-chain creation time.
+     * Populated by `getTournament`/`getTournaments` (computed at read time via
+     * `tournamentPhase`); `null` when the creation time is unknown. Because it's
+     * time-derived, treat it as a snapshot for the moment it was read — call
+     * `tournamentPhase(t)` to re-evaluate later.
+     */
+    phase: Phase | null;
     entryCount: number;
     prizeCount: number;
     submissionCount: number;
@@ -189,14 +205,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;
@@ -341,7 +383,7 @@ declare class ConnectionStatus {
  * // RPC-only (bypass API entirely)
  * const client = new BudokanClient({
  *   primarySource: "rpc",
- *   rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet/rpc/v0_10",
+ *   rpcUrl: "https://rpc.provable.games/rpc",
  *   viewerAddress: "0x...",
  * });
  * ```
@@ -542,4 +584,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 PlayerPlacement as j, type Phase as k, type BudokanClientConfig as l, ConnectionStatus as m, type ConnectionStatusState as n, type Erc20Prize as o, type Erc721Prize as p, type LeaderboardEntry 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

@@ -199,11 +199,37 @@ function snakeToCamel(obj) {
   return obj;
 }
 
+// src/phase/index.ts
+function tournamentPhase(t, nowSeconds) {
+  const createdAt = Number(t.createdAtOnchain ?? NaN);
+  if (!Number.isFinite(createdAt)) return null;
+  const regStartDelay = Number(t.registrationStartDelay ?? t.schedule?.registrationStartDelay ?? 0);
+  const regEndDelay = Number(t.registrationEndDelay ?? t.schedule?.registrationEndDelay ?? 0);
+  const gameStartDelay = Number(t.gameStartDelay ?? t.schedule?.gameStartDelay ?? 0);
+  const gameEndDelay = Number(t.gameEndDelay ?? t.schedule?.gameEndDelay ?? 0);
+  const submissionDuration = Number(t.submissionDuration ?? t.schedule?.submissionDuration ?? 0);
+  const now = Math.floor(Date.now() / 1e3);
+  const hasReg = regStartDelay > 0 || regEndDelay > 0;
+  const regStart = createdAt + regStartDelay;
+  const regEnd = regStart + regEndDelay;
+  const gameStart = createdAt + gameStartDelay;
+  const gameEnd = gameStart + gameEndDelay;
+  const subEnd = gameEnd + submissionDuration;
+  if (hasReg && now < regStart) return "scheduled";
+  if (hasReg && now < regEnd) return "registration";
+  if (now < gameStart) return "staging";
+  if (now < gameEnd) return "live";
+  if (now < subEnd) return "submission";
+  return "finalized";
+}
+
 // src/api/tournaments.ts
 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;
+  const phase = t.phase ?? tournamentPhase(t);
+  return { ...t, id, tournamentId: id, protocolFeeShare, phase };
 }
 function fetchOpts(ctx) {
   return {
@@ -528,7 +554,7 @@ var WSManager = class {
 // src/chains/constants.ts
 var CHAINS = {
   mainnet: {
-    rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet/rpc/v0_10",
+    rpcUrl: "https://rpc.provable.games/rpc",
     apiBaseUrl: "https://budokan-api-production.up.railway.app",
     wsUrl: "wss://budokan-api-production.up.railway.app/ws",
     budokanAddress: "0x0596ced030e74ebc37f33607f07ecd5a62eff22cdc4ae31fe2d724040c1bdc0b",
@@ -807,7 +833,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 +931,8 @@ function parseTournament(raw, entryCount) {
     leaderboardGameMustBeOver: gameMustBeOver,
     entryFeeToken,
     entryFeeAmount,
+    // Protocol-fee bps snapshot, surfaced by the viewer's TournamentFullState.
+    protocolFeeShare,
     hasEntryRequirement,
     schedule: {
       registrationStartDelay,
@@ -926,6 +954,14 @@ function parseTournament(raw, entryCount) {
     entryFeeExtension,
     entryRequirement,
     leaderboardConfig: { ascending, gameMustBeOver },
+    phase: tournamentPhase({
+      createdAtOnchain: createdAtStr,
+      registrationStartDelay,
+      registrationEndDelay,
+      gameStartDelay,
+      gameEndDelay,
+      submissionDuration
+    }),
     entryCount,
     prizeCount: 0,
     // Not available from viewer
@@ -1071,7 +1107,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 +1284,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 +1759,10 @@ var budokanViewer_default = [
       {
         name: "phase",
         type: "budokan_interfaces::budokan::Phase"
+      },
+      {
+        name: "protocol_fee_bps",
+        type: "core::integer::u16"
       }
     ]
   },
@@ -1989,6 +2033,10 @@ var budokanViewer_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -3367,6 +3415,10 @@ var budokan_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -4655,6 +4707,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 +4934,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"
       }
     ]
   }