@provable-games/budokan-sdk 0.1.24 → 0.1.25

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './player-C2GE9Lop.cjs';
-export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, n as PlayerPlacement, o as PlayerRewards, S as Schedule, p as WSChannel, q as WSEventMessage, r as WSMessage, s as WSSubscribeMessage, t as WSUnsubscribeMessage, u as createBudokanClient } from './player-C2GE9Lop.cjs';
+import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler, i as TokenPrize, E as ExtensionPrize$1 } from './player-P6Dd1lNb.cjs';
+export { B as BudokanClient, j as BudokanClientConfig, C as ConnectionMode, k as ConnectionStatus, l as ConnectionStatusState, D as DataSource, m as Erc20Prize, n as Erc721Prize, G as GameConfig, L as LeaderboardConfig, o as LeaderboardEntry, p as Phase, q as PlayerPlacement, r as PlayerRewards, S as Schedule, s as WSChannel, t as WSEventMessage, u as WSMessage, v as WSSubscribeMessage, w as WSUnsubscribeMessage, x as createBudokanClient } from './player-P6Dd1lNb.cjs';
+import { ExtensionPrize, PrizeLike, Prize as Prize$1 } from '@provable-games/metagame-sdk';
 export { EntryFee } from '@provable-games/metagame-sdk';
 import 'starknet';
 
@@ -180,6 +181,80 @@ declare function camelToSnake<T>(obj: unknown): T;
 
 declare function withRetry<T>(fn: () => Promise<T>, attempts?: number, delay?: number): Promise<T>;
 
+type MetagameTokenPrize = Prize$1;
+type MetagameExtensionPrize = ExtensionPrize;
+type MetagamePrizeLike = PrizeLike;
+declare function isRawTokenPrize(prize: Prize): prize is TokenPrize;
+declare function isRawExtensionPrize(prize: Prize): prize is ExtensionPrize$1;
+declare function isTokenPrize(prize: Prize): prize is TokenPrize;
+declare function isExtensionPrize(prize: Prize): prize is ExtensionPrize$1;
+/**
+ * Returns true when a prize is a valid Budokan token/extension prize and has a
+ * hydrated leaderboard position suitable for the metagame prize shape.
+ */
+declare function isMetagameAdaptablePrize(prize: Prize): prize is TokenPrize | ExtensionPrize$1;
+/**
+ * Returns validated raw token prizes. Extension records are skipped without
+ * validation; malformed `erc20`/`erc721` records throw instead of being
+ * silently dropped. RPC records with `payoutPosition === 0` are returned here
+ * for raw token-prize visibility.
+ */
+declare function getRawTokenPrizes(prizes: readonly Prize[]): TokenPrize[];
+/**
+ * Returns validated hydrated token prizes. Extension records are skipped
+ * without validation, and valid raw token prizes with `payoutPosition === 0`
+ * are skipped; malformed `erc20`/`erc721` records throw instead of being
+ * silently dropped.
+ */
+declare function getTokenPrizes(prizes: readonly Prize[]): TokenPrize[];
+/**
+ * Converts a guard-validated Budokan token prize into the Metagame SDK token
+ * prize shape. Metagame token prizes do not carry Budokan distribution fields,
+ * so distributed ERC20 prizes are represented by their aggregate `amount` at
+ * `payoutPosition`; use the original Budokan `Prize` for payout-split math.
+ * For ERC721 prizes, metagame-sdk@0.1.13 uses `amount` to carry the token ID.
+ * Throws when `payoutPosition` is zero because the RPC path uses zero for
+ * unhydrated token-prize positions and metagame positions are leaderboard slots.
+ */
+declare function toMetagameTokenPrize(prize: TokenPrize): MetagameTokenPrize;
+/**
+ * Converts a guard-validated Budokan extension prize into the Metagame SDK
+ * extension-prize shape. Throws when `payoutPosition` is zero because metagame
+ * positions are leaderboard slots and the RPC path uses zero for unhydrated
+ * prize positions.
+ */
+declare function toMetagameExtensionPrize(prize: ExtensionPrize$1): MetagameExtensionPrize;
+/**
+ * Converts supported Budokan prize variants into Metagame SDK prize shapes.
+ * Throws when a prize has malformed fields or an unhydrated payout position.
+ * Raw-but-valid zero-position prizes throw the unhydrated-position error.
+ * See `toMetagameTokenPrize` for token prize distribution behavior.
+ */
+declare function toMetagamePrize(prize: Prize): MetagamePrizeLike;
+/**
+ * Non-throwing metagame adapter. Returns null for malformed prize records and
+ * for valid RPC-sourced prizes whose `payoutPosition` is not hydrated yet.
+ */
+declare function tryToMetagamePrize(prize: Prize): MetagamePrizeLike | null;
+/**
+ * Converts supported Budokan prize variants into Metagame SDK prize shapes.
+ * Throws when any prize has malformed fields or an unhydrated payout position.
+ * See `toMetagameTokenPrize` for token prize distribution behavior.
+ */
+declare function toMetagamePrizes(prizes: readonly Prize[]): MetagamePrizeLike[];
+/**
+ * Non-throwing batch metagame adapter. Skips malformed records and valid
+ * RPC-sourced prizes whose `payoutPosition` is not hydrated yet.
+ */
+declare function tryToMetagamePrizes(prizes: readonly Prize[]): MetagamePrizeLike[];
+/**
+ * Converts Budokan token prizes into Metagame SDK token prize shapes. Extension
+ * records are skipped without validation. Throws for malformed token records
+ * and unhydrated token positions. See `toMetagameTokenPrize` for distribution
+ * behavior.
+ */
+declare function toMetagameTokenPrizes(prizes: readonly Prize[]): MetagameTokenPrize[];
+
 interface ChainConfig {
     rpcUrl: string;
     apiBaseUrl: string;
@@ -517,6 +592,8 @@ type RewardType = {
     kind: "entry_fee_tournament_creator";
 } | {
     kind: "entry_fee_game_creator";
+} | {
+    kind: "entry_fee_protocol_fee";
 } | {
     kind: "entry_fee_refund";
     tokenId: string;
@@ -725,4 +802,4 @@ interface TournamentValidatorConfig {
  */
 declare function buildTournamentValidatorConfig(cfg: TournamentValidatorConfig): string[];
 
-export { type AddPrizeArgs, BudokanApiError, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, type Call, type ChainConfig, type CreateTournamentArgs, DataSourceError, type DistributionSpec, type EnterTournamentArgs, type EntryFeeArgs, type EntryRequirementArgs, type EntryRequirementSpec, type Erc20BalanceConfig, type ExtensionPresetKind, type GameDefaults, type MerkleConfig, type OpusTrovesConfig, PaginatedResult, PlatformStats, Prize, PrizeAggregation, type PrizeSpec, PrizeStats, QualificationEntry, type ReceiptWithEvents, Registration, RewardClaim, RewardClaimSummary, type RewardType, RpcError, type TokenTypeSpec, Tournament, TournamentListParams, TournamentNotFoundError, type TournamentRequirementType, type TournamentValidatorConfig, WSEventHandler, WSManager, WSSubscribeOptions, type WhitelistChain, type WhitelistedGame, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isGameWhitelisted, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, tournamentPageUrl, u256ToLowHigh, withRetry };
+export { type AddPrizeArgs, BudokanApiError, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, type Call, type ChainConfig, type CreateTournamentArgs, DataSourceError, type DistributionSpec, type EnterTournamentArgs, type EntryFeeArgs, type EntryRequirementArgs, type EntryRequirementSpec, type Erc20BalanceConfig, type ExtensionPresetKind, ExtensionPrize$1 as ExtensionPrize, type GameDefaults, type MerkleConfig, type MetagameExtensionPrize, type MetagamePrizeLike, type MetagameTokenPrize, type OpusTrovesConfig, PaginatedResult, PlatformStats, Prize, PrizeAggregation, type PrizeSpec, PrizeStats, QualificationEntry, type ReceiptWithEvents, Registration, RewardClaim, RewardClaimSummary, type RewardType, RpcError, TokenPrize, type TokenTypeSpec, Tournament, TournamentListParams, TournamentNotFoundError, type TournamentRequirementType, type TournamentValidatorConfig, WSEventHandler, WSManager, WSSubscribeOptions, type WhitelistChain, type WhitelistedGame, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getRawTokenPrizes, getTokenPrizes, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isExtensionPrize, isGameWhitelisted, isMetagameAdaptablePrize, isRawExtensionPrize, isRawTokenPrize, isTokenPrize, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, toMetagameExtensionPrize, toMetagamePrize, toMetagamePrizes, toMetagameTokenPrize, toMetagameTokenPrizes, tournamentPageUrl, tryToMetagamePrize, tryToMetagamePrizes, u256ToLowHigh, withRetry };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler } from './player-C2GE9Lop.js';
-export { B as BudokanClient, i as BudokanClientConfig, C as ConnectionMode, j as ConnectionStatus, k as ConnectionStatusState, D as DataSource, G as GameConfig, L as LeaderboardConfig, l as LeaderboardEntry, m as Phase, n as PlayerPlacement, o as PlayerRewards, S as Schedule, p as WSChannel, q as WSEventMessage, r as WSMessage, s as WSSubscribeMessage, t as WSUnsubscribeMessage, u as createBudokanClient } from './player-C2GE9Lop.js';
+import { T as Tournament, P as PrizeAggregation, a as Prize, b as PaginatedResult, Q as QualificationEntry, R as Registration, c as RewardClaim, d as RewardClaimSummary, e as TournamentListParams, f as PlatformStats, g as PrizeStats, W as WSSubscribeOptions, h as WSEventHandler, i as TokenPrize, E as ExtensionPrize$1 } from './player-P6Dd1lNb.js';
+export { B as BudokanClient, j as BudokanClientConfig, C as ConnectionMode, k as ConnectionStatus, l as ConnectionStatusState, D as DataSource, m as Erc20Prize, n as Erc721Prize, G as GameConfig, L as LeaderboardConfig, o as LeaderboardEntry, p as Phase, q as PlayerPlacement, r as PlayerRewards, S as Schedule, s as WSChannel, t as WSEventMessage, u as WSMessage, v as WSSubscribeMessage, w as WSUnsubscribeMessage, x as createBudokanClient } from './player-P6Dd1lNb.js';
+import { ExtensionPrize, PrizeLike, Prize as Prize$1 } from '@provable-games/metagame-sdk';
 export { EntryFee } from '@provable-games/metagame-sdk';
 import 'starknet';
 
@@ -180,6 +181,80 @@ declare function camelToSnake<T>(obj: unknown): T;
 
 declare function withRetry<T>(fn: () => Promise<T>, attempts?: number, delay?: number): Promise<T>;
 
+type MetagameTokenPrize = Prize$1;
+type MetagameExtensionPrize = ExtensionPrize;
+type MetagamePrizeLike = PrizeLike;
+declare function isRawTokenPrize(prize: Prize): prize is TokenPrize;
+declare function isRawExtensionPrize(prize: Prize): prize is ExtensionPrize$1;
+declare function isTokenPrize(prize: Prize): prize is TokenPrize;
+declare function isExtensionPrize(prize: Prize): prize is ExtensionPrize$1;
+/**
+ * Returns true when a prize is a valid Budokan token/extension prize and has a
+ * hydrated leaderboard position suitable for the metagame prize shape.
+ */
+declare function isMetagameAdaptablePrize(prize: Prize): prize is TokenPrize | ExtensionPrize$1;
+/**
+ * Returns validated raw token prizes. Extension records are skipped without
+ * validation; malformed `erc20`/`erc721` records throw instead of being
+ * silently dropped. RPC records with `payoutPosition === 0` are returned here
+ * for raw token-prize visibility.
+ */
+declare function getRawTokenPrizes(prizes: readonly Prize[]): TokenPrize[];
+/**
+ * Returns validated hydrated token prizes. Extension records are skipped
+ * without validation, and valid raw token prizes with `payoutPosition === 0`
+ * are skipped; malformed `erc20`/`erc721` records throw instead of being
+ * silently dropped.
+ */
+declare function getTokenPrizes(prizes: readonly Prize[]): TokenPrize[];
+/**
+ * Converts a guard-validated Budokan token prize into the Metagame SDK token
+ * prize shape. Metagame token prizes do not carry Budokan distribution fields,
+ * so distributed ERC20 prizes are represented by their aggregate `amount` at
+ * `payoutPosition`; use the original Budokan `Prize` for payout-split math.
+ * For ERC721 prizes, metagame-sdk@0.1.13 uses `amount` to carry the token ID.
+ * Throws when `payoutPosition` is zero because the RPC path uses zero for
+ * unhydrated token-prize positions and metagame positions are leaderboard slots.
+ */
+declare function toMetagameTokenPrize(prize: TokenPrize): MetagameTokenPrize;
+/**
+ * Converts a guard-validated Budokan extension prize into the Metagame SDK
+ * extension-prize shape. Throws when `payoutPosition` is zero because metagame
+ * positions are leaderboard slots and the RPC path uses zero for unhydrated
+ * prize positions.
+ */
+declare function toMetagameExtensionPrize(prize: ExtensionPrize$1): MetagameExtensionPrize;
+/**
+ * Converts supported Budokan prize variants into Metagame SDK prize shapes.
+ * Throws when a prize has malformed fields or an unhydrated payout position.
+ * Raw-but-valid zero-position prizes throw the unhydrated-position error.
+ * See `toMetagameTokenPrize` for token prize distribution behavior.
+ */
+declare function toMetagamePrize(prize: Prize): MetagamePrizeLike;
+/**
+ * Non-throwing metagame adapter. Returns null for malformed prize records and
+ * for valid RPC-sourced prizes whose `payoutPosition` is not hydrated yet.
+ */
+declare function tryToMetagamePrize(prize: Prize): MetagamePrizeLike | null;
+/**
+ * Converts supported Budokan prize variants into Metagame SDK prize shapes.
+ * Throws when any prize has malformed fields or an unhydrated payout position.
+ * See `toMetagameTokenPrize` for token prize distribution behavior.
+ */
+declare function toMetagamePrizes(prizes: readonly Prize[]): MetagamePrizeLike[];
+/**
+ * Non-throwing batch metagame adapter. Skips malformed records and valid
+ * RPC-sourced prizes whose `payoutPosition` is not hydrated yet.
+ */
+declare function tryToMetagamePrizes(prizes: readonly Prize[]): MetagamePrizeLike[];
+/**
+ * Converts Budokan token prizes into Metagame SDK token prize shapes. Extension
+ * records are skipped without validation. Throws for malformed token records
+ * and unhydrated token positions. See `toMetagameTokenPrize` for distribution
+ * behavior.
+ */
+declare function toMetagameTokenPrizes(prizes: readonly Prize[]): MetagameTokenPrize[];
+
 interface ChainConfig {
     rpcUrl: string;
     apiBaseUrl: string;
@@ -517,6 +592,8 @@ type RewardType = {
     kind: "entry_fee_tournament_creator";
 } | {
     kind: "entry_fee_game_creator";
+} | {
+    kind: "entry_fee_protocol_fee";
 } | {
     kind: "entry_fee_refund";
     tokenId: string;
@@ -725,4 +802,4 @@ interface TournamentValidatorConfig {
  */
 declare function buildTournamentValidatorConfig(cfg: TournamentValidatorConfig): string[];
 
-export { type AddPrizeArgs, BudokanApiError, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, type Call, type ChainConfig, type CreateTournamentArgs, DataSourceError, type DistributionSpec, type EnterTournamentArgs, type EntryFeeArgs, type EntryRequirementArgs, type EntryRequirementSpec, type Erc20BalanceConfig, type ExtensionPresetKind, type GameDefaults, type MerkleConfig, type OpusTrovesConfig, PaginatedResult, PlatformStats, Prize, PrizeAggregation, type PrizeSpec, PrizeStats, QualificationEntry, type ReceiptWithEvents, Registration, RewardClaim, RewardClaimSummary, type RewardType, RpcError, type TokenTypeSpec, Tournament, TournamentListParams, TournamentNotFoundError, type TournamentRequirementType, type TournamentValidatorConfig, WSEventHandler, WSManager, WSSubscribeOptions, type WhitelistChain, type WhitelistedGame, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isGameWhitelisted, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, tournamentPageUrl, u256ToLowHigh, withRetry };
+export { type AddPrizeArgs, BudokanApiError, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, type Call, type ChainConfig, type CreateTournamentArgs, DataSourceError, type DistributionSpec, type EnterTournamentArgs, type EntryFeeArgs, type EntryRequirementArgs, type EntryRequirementSpec, type Erc20BalanceConfig, type ExtensionPresetKind, ExtensionPrize$1 as ExtensionPrize, type GameDefaults, type MerkleConfig, type MetagameExtensionPrize, type MetagamePrizeLike, type MetagameTokenPrize, type OpusTrovesConfig, PaginatedResult, PlatformStats, Prize, PrizeAggregation, type PrizeSpec, PrizeStats, QualificationEntry, type ReceiptWithEvents, Registration, RewardClaim, RewardClaimSummary, type RewardType, RpcError, TokenPrize, type TokenTypeSpec, Tournament, TournamentListParams, TournamentNotFoundError, type TournamentRequirementType, type TournamentValidatorConfig, WSEventHandler, WSManager, WSSubscribeOptions, type WhitelistChain, type WhitelistedGame, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getRawTokenPrizes, getTokenPrizes, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isExtensionPrize, isGameWhitelisted, isMetagameAdaptablePrize, isRawExtensionPrize, isRawTokenPrize, isTokenPrize, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, toMetagameExtensionPrize, toMetagamePrize, toMetagamePrizes, toMetagameTokenPrize, toMetagameTokenPrizes, tournamentPageUrl, tryToMetagamePrize, tryToMetagamePrizes, u256ToLowHigh, withRetry };

package/dist/index.js

@@ -213,7 +213,8 @@ function camelToSnake(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 {
@@ -830,7 +831,7 @@ function phaseToRpcArg(phase) {
   }
   return new 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);
@@ -928,6 +929,8 @@ function parseTournament(raw, entryCount) {
     leaderboardGameMustBeOver: gameMustBeOver,
     entryFeeToken,
     entryFeeAmount,
+    // Protocol-fee bps snapshot, surfaced by the viewer's TournamentFullState.
+    protocolFeeShare,
     hasEntryRequirement,
     schedule: {
       registrationStartDelay,
@@ -1094,7 +1097,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 () => {
@@ -1270,6 +1274,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",
@@ -1742,6 +1749,10 @@ var budokanViewer_default = [
       {
         name: "phase",
         type: "budokan_interfaces::budokan::Phase"
+      },
+      {
+        name: "protocol_fee_bps",
+        type: "core::integer::u16"
       }
     ]
   },
@@ -2012,6 +2023,10 @@ var budokanViewer_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -3390,6 +3405,10 @@ var budokan_default = [
       {
         name: "Refund",
         type: "core::felt252"
+      },
+      {
+        name: "ProtocolFee",
+        type: "()"
       }
     ]
   },
@@ -4678,6 +4697,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"
       }
     ]
   },
@@ -4900,6 +4924,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"
       }
     ]
   }
@@ -5367,6 +5493,185 @@ function createBudokanClient(config) {
   return new BudokanClient(config);
 }
 
+// src/utils/prizes.ts
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function isNonNegativeIntegerString(value) {
+  if (!isNonEmptyString(value) || value.trim() !== value) return false;
+  if (!/^\d+$/.test(value)) return false;
+  try {
+    return BigInt(value) >= 0n;
+  } catch {
+    return false;
+  }
+}
+function isNonNegativeIntegerNumber(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isPositiveIntegerNumber(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function isDistributionType(value) {
+  return value === "linear" || value === "exponential" || value === "uniform" || value === "custom";
+}
+function hasNoDistributionFields(prize) {
+  return prize.distributionType === null && prize.distributionWeight === null && prize.distributionShares === null && prize.distributionCount === null;
+}
+function hasValidDistributionFields(prize) {
+  if (prize.distributionType === null) return hasNoDistributionFields(prize);
+  if (!isDistributionType(prize.distributionType)) return false;
+  if (!isPositiveIntegerNumber(prize.distributionCount)) return false;
+  if (prize.distributionType === "custom") {
+    return prize.distributionWeight === null && Array.isArray(prize.distributionShares) && prize.distributionShares.length === prize.distributionCount && prize.distributionShares.every(isNonNegativeIntegerNumber) && prize.distributionShares.reduce((sum, share) => sum + share, 0) === 1e4;
+  }
+  if (prize.distributionType === "uniform") {
+    return prize.distributionWeight === null && prize.distributionShares === null;
+  }
+  return isNonNegativeIntegerNumber(prize.distributionWeight) && prize.distributionShares === null;
+}
+function hasBasePrizeFields(prize) {
+  return isNonNegativeIntegerString(prize.prizeId) && isNonNegativeIntegerString(prize.tournamentId) && Number.isInteger(prize.payoutPosition) && prize.payoutPosition >= 0 && isNonEmptyString(prize.sponsorAddress);
+}
+function hasExtensionConfig(value) {
+  return value === null || Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function describePrize(prize) {
+  const prizeId = isNonEmptyString(prize.prizeId) ? prize.prizeId : "<invalid>";
+  return `prizeId=${prizeId}, tokenType=${prize.tokenType}`;
+}
+function malformedTokenPrizeError(action, prize) {
+  return new TypeError(
+    `Cannot ${action} malformed Budokan token prize (${describePrize(prize)})`
+  );
+}
+function malformedExtensionPrizeError(action, prize) {
+  return new TypeError(
+    `Cannot ${action} malformed Budokan extension prize (${describePrize(prize)})`
+  );
+}
+function assertMetagameTokenPosition(prize) {
+  if (Number.isInteger(prize.payoutPosition) && prize.payoutPosition > 0) {
+    return;
+  }
+  if (prize.payoutPosition !== 0) {
+    throw new TypeError(
+      `Cannot adapt Budokan token prize with invalid payout position (${describePrize(prize)})`
+    );
+  }
+  throw new TypeError(
+    `Cannot adapt Budokan token prize with unhydrated payout position (${describePrize(prize)})`
+  );
+}
+function assertMetagameExtensionPosition(prize) {
+  if (Number.isInteger(prize.payoutPosition) && prize.payoutPosition > 0) {
+    return;
+  }
+  if (prize.payoutPosition !== 0) {
+    throw new TypeError(
+      `Cannot adapt Budokan extension prize with invalid payout position (${describePrize(prize)})`
+    );
+  }
+  throw new TypeError(
+    `Cannot adapt Budokan extension prize with unhydrated payout position (${describePrize(prize)})`
+  );
+}
+function hasHydratedPayoutPosition(prize) {
+  return prize.payoutPosition > 0;
+}
+function isRawTokenPrize(prize) {
+  if (!hasBasePrizeFields(prize) || !isNonEmptyString(prize.tokenAddress)) {
+    return false;
+  }
+  return prize.tokenType === "erc20" ? isNonNegativeIntegerString(prize.amount) && prize.tokenId === null && prize.extensionAddress === null && prize.extensionConfig === null && hasValidDistributionFields(prize) : prize.tokenType === "erc721" && prize.amount === null && isNonNegativeIntegerString(prize.tokenId) && prize.extensionAddress === null && prize.extensionConfig === null && hasNoDistributionFields(prize);
+}
+function isRawExtensionPrize(prize) {
+  return hasBasePrizeFields(prize) && prize.tokenType === "extension" && prize.tokenAddress === null && prize.amount === null && prize.tokenId === null && hasNoDistributionFields(prize) && isNonEmptyString(prize.extensionAddress) && hasExtensionConfig(prize.extensionConfig);
+}
+function isTokenPrize(prize) {
+  return isRawTokenPrize(prize) && hasHydratedPayoutPosition(prize);
+}
+function isExtensionPrize(prize) {
+  return isRawExtensionPrize(prize) && hasHydratedPayoutPosition(prize);
+}
+function isMetagameAdaptablePrize(prize) {
+  return isTokenPrize(prize) || isExtensionPrize(prize);
+}
+function getRawTokenPrizes(prizes) {
+  return prizes.flatMap((prize) => {
+    if (isRawTokenPrize(prize)) return [prize];
+    if (prize.tokenType === "extension") return [];
+    throw malformedTokenPrizeError("read", prize);
+  });
+}
+function getTokenPrizes(prizes) {
+  return prizes.flatMap((prize) => {
+    if (isTokenPrize(prize)) return [prize];
+    if (isRawTokenPrize(prize) || prize.tokenType === "extension") return [];
+    throw malformedTokenPrizeError("read", prize);
+  });
+}
+function toMetagameTokenPrize(prize) {
+  assertMetagameTokenPosition(prize);
+  if (!isRawTokenPrize(prize)) {
+    throw malformedTokenPrizeError("adapt", prize);
+  }
+  const adapted = {
+    id: prize.prizeId,
+    position: prize.payoutPosition,
+    tokenAddress: prize.tokenAddress,
+    tokenType: prize.tokenType,
+    // Metagame token prizes use `amount` as the token id for ERC721 entries.
+    amount: prize.tokenType === "erc20" ? prize.amount : prize.tokenId,
+    sponsorAddress: prize.sponsorAddress
+  };
+  return adapted;
+}
+function toMetagameExtensionPrize(prize) {
+  assertMetagameExtensionPosition(prize);
+  if (!isRawExtensionPrize(prize)) {
+    throw malformedExtensionPrizeError("adapt", prize);
+  }
+  const adapted = {
+    id: prize.prizeId,
+    position: prize.payoutPosition,
+    tokenAddress: null,
+    tokenType: "extension",
+    amount: null,
+    sponsorAddress: prize.sponsorAddress,
+    extensionAddress: prize.extensionAddress,
+    extensionConfig: prize.extensionConfig
+  };
+  return adapted;
+}
+function toMetagamePrize(prize) {
+  if (isRawTokenPrize(prize)) return toMetagameTokenPrize(prize);
+  if (isRawExtensionPrize(prize)) return toMetagameExtensionPrize(prize);
+  throw new TypeError(
+    `Cannot adapt malformed Budokan prize (${describePrize(prize)})`
+  );
+}
+function tryToMetagamePrize(prize) {
+  if (!isMetagameAdaptablePrize(prize)) return null;
+  return prize.tokenType === "extension" ? toMetagameExtensionPrize(prize) : toMetagameTokenPrize(prize);
+}
+function toMetagamePrizes(prizes) {
+  return prizes.map(toMetagamePrize);
+}
+function tryToMetagamePrizes(prizes) {
+  return prizes.flatMap((prize) => {
+    const adapted = tryToMetagamePrize(prize);
+    return adapted ? [adapted] : [];
+  });
+}
+function toMetagameTokenPrizes(prizes) {
+  return prizes.flatMap((prize) => {
+    if (isRawTokenPrize(prize)) return [toMetagameTokenPrize(prize)];
+    if (prize.tokenType === "extension") return [];
+    throw malformedTokenPrizeError("adapt", prize);
+  });
+}
+
 // src/games/whitelist.ts
 var STRK = "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d";
 var MAINNET_GAMES_RAW = [
@@ -5753,6 +6058,9 @@ function pushRewardTypeFelts(out, reward) {
     case "entry_fee_refund":
       out.push("0x1", "0x0", "0x3", num.toHex(reward.tokenId));
       return;
+    case "entry_fee_protocol_fee":
+      out.push("0x1", "0x0", "0x4");
+      return;
     case "entry_fee_extension": {
       out.push("0x1", "0x1");
       if (reward.tokenId !== void 0) {
@@ -5862,6 +6170,6 @@ function buildTournamentValidatorConfig(cfg) {
   return [qualifierType, qualifyingMode, topPositions, ...cfg.tournamentIds];
 }
 
-export { BudokanApiError, BudokanClient, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, ConnectionStatus, DataSourceError, RpcError, TournamentNotFoundError, WSManager, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, createBudokanClient, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isGameWhitelisted, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, tournamentPageUrl, u256ToLowHigh, withRetry };
+export { BudokanApiError, BudokanClient, BudokanConnectionError, BudokanError, BudokanTimeoutError, CHAINS, ConnectionStatus, DataSourceError, RpcError, TournamentNotFoundError, WSManager, buildAddPrizeCall, buildClaimRewardCall, buildCreateTournamentCall, buildEnterTournamentCall, buildErc20ApproveCall, buildErc20BalanceConfig, buildMerkleConfig, buildOpusTrovesConfig, buildSubmitScoreCall, buildTournamentValidatorConfig, camelToSnake, createBudokanClient, explorerAddressUrl, explorerBaseUrl, explorerTxUrl, extensionAddressFor, findWhitelistedGame, getActivityStats, getChainConfig, getGameDefaults, getGameStats, getGameTournaments, getPrizeStats, getRawTokenPrizes, getTokenPrizes, getTournament, getTournamentPrizeAggregation, getTournamentPrizes, getTournamentQualifications, getTournamentRegistrations, getTournamentRewardClaims, getTournamentRewardClaimsSummary, getTournaments, getWhitelistedGames, isExtensionPrize, isGameWhitelisted, isMetagameAdaptablePrize, isRawExtensionPrize, isRawTokenPrize, isTokenPrize, normalizeAddress, parseTournamentIdFromReceipt, snakeToCamel, toMetagameExtensionPrize, toMetagamePrize, toMetagamePrizes, toMetagameTokenPrize, toMetagameTokenPrizes, tournamentPageUrl, tryToMetagamePrize, tryToMetagamePrizes, u256ToLowHigh, withRetry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map