@provable-games/budokan-sdk 0.1.23 → 0.1.24

package/dist/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var starknet = require('starknet');
+var metagameSdk = require('@provable-games/metagame-sdk');
 
 // src/errors/index.ts
 var BudokanError = class extends Error {
@@ -546,16 +547,32 @@ var CHAINS = {
     viewerAddress: "0x013c8239361fdbd7ec26db2c83f4ff270c5bba83a0bc105b4005b676ff57fdbe"
   },
   sepolia: {
-    rpcUrl: "https://starknet-sepolia.public.blastapi.io",
+    rpcUrl: "https://api.cartridge.gg/x/starknet/sepolia/rpc/v0_10",
     apiBaseUrl: "https://budokan-api-sepolia.up.railway.app",
     wsUrl: "wss://budokan-api-sepolia.up.railway.app/ws",
-    budokanAddress: "0x017750a167b7c4968249d7db06dccc8b3908ef8954cb40cfe4d3c651ca0dcd1d",
-    viewerAddress: "0x03d5febe0042b943967074f4ebd850a6b5d50850cd3fb84fbd0eb66dadd9ddec"
+    budokanAddress: "0x074cc823c382d98e6b8d657aa86776a57d85e1dc2912d54d83a4fef147472683",
+    // Redeployed 2026-06-18 to match the upgraded #264/#269 budokan class —
+    // the prior viewer (0x03da56…) was built against the old budokan interface
+    // (called the removed `tournament_entries`) and reverted RPC reads.
+    viewerAddress: "0x06b2773d5f1f8bfa5aa3b698fbbaea0472b30af003ea6058330ed52a1acaa283"
   }
 };
 function getChainConfig(chain) {
   return CHAINS[chain];
 }
+function explorerBaseUrl(chain) {
+  if (chain === "sepolia") return "https://sepolia.voyager.online";
+  return "https://voyager.online";
+}
+function explorerTxUrl(chain, txHash) {
+  return `${explorerBaseUrl(chain)}/tx/${txHash}`;
+}
+function explorerAddressUrl(chain, address) {
+  return `${explorerBaseUrl(chain)}/contract/${address}`;
+}
+function tournamentPageUrl(chain, tournamentId) {
+  return `https://budokan.gg/tournament/${tournamentId}?network=${chain}`;
+}
 
 // src/datasource/health.ts
 var ConnectionStatus = class {
@@ -851,23 +868,36 @@ function parseTournament(raw, entryCount) {
   const lc = obj.leaderboard_config;
   const ascending = Boolean(lc?.ascending);
   const gameMustBeOver = Boolean(lc?.game_must_be_over);
-  const entryFeeRaw = parseOption(obj.entry_fee);
+  const entryFeeKind = parseOption(obj.entry_fee);
   let entryFeeToken = null;
   let entryFeeAmount = null;
   let entryFee = null;
-  if (entryFeeRaw) {
-    const ef = entryFeeRaw;
-    entryFeeToken = starknet.num.toHex(ef.token_address);
-    entryFeeAmount = String(ef.amount ?? "0");
-    entryFee = {
-      tokenAddress: entryFeeToken,
-      amount: entryFeeAmount,
-      tournamentCreatorShare: Number(ef.tournament_creator_share ?? 0),
-      gameCreatorShare: Number(ef.game_creator_share ?? 0),
-      refundShare: Number(ef.refund_share ?? 0),
-      distribution: ef.distribution ?? null,
-      distributionCount: Number(ef.distribution_count ?? 0)
-    };
+  let entryFeeKindTag = null;
+  let entryFeeExtension = null;
+  if (entryFeeKind) {
+    const variantBag = entryFeeKind.variant ?? entryFeeKind;
+    const ef = variantBag.BuiltIn;
+    const ext = variantBag.Extension;
+    if (ef) {
+      entryFeeKindTag = "builtin";
+      entryFeeToken = starknet.num.toHex(ef.token_address);
+      entryFeeAmount = String(ef.amount ?? "0");
+      entryFee = {
+        tokenAddress: entryFeeToken,
+        amount: entryFeeAmount,
+        tournamentCreatorShare: Number(ef.tournament_creator_share ?? 0),
+        gameCreatorShare: Number(ef.game_creator_share ?? 0),
+        refundShare: Number(ef.refund_share ?? 0),
+        distribution: ef.distribution ?? null,
+        distributionCount: Number(ef.distribution_count ?? 0)
+      };
+    } else if (ext) {
+      entryFeeKindTag = "extension";
+      entryFeeExtension = {
+        address: starknet.num.toHex(ext.address),
+        config: Array.isArray(ext.config) ? ext.config.map((x) => starknet.num.toHex(x)) : []
+      };
+    }
   }
   const entryRequirement = parseOption(obj.entry_requirement);
   const hasEntryRequirement = entryRequirement !== null;
@@ -917,6 +947,8 @@ function parseTournament(raw, entryCount) {
       renderer
     },
     entryFee,
+    entryFeeKind: entryFeeKindTag,
+    entryFeeExtension,
     entryRequirement,
     leaderboardConfig: { ascending, gameMustBeOver },
     entryCount,
@@ -947,8 +979,40 @@ function parseRegistration(raw, tournamentId) {
   };
 }
 function parsePrize(raw) {
-  const obj = raw;
-  const tokenTypeData = obj.token_type;
+  const record = raw;
+  const prizeEnum = record.prize;
+  if (!prizeEnum) {
+    throw new Error(`PrizeRecord missing prize field: ${JSON.stringify(raw)}`);
+  }
+  const activePrize = typeof prizeEnum.activeVariant === "function" ? prizeEnum.activeVariant() : prizeEnum.Token !== void 0 ? "Token" : prizeEnum.Extension !== void 0 ? "Extension" : null;
+  const prizeVariantBag = prizeEnum.variant ?? prizeEnum;
+  if (activePrize === "Extension") {
+    const ext = prizeVariantBag.Extension;
+    return {
+      prizeId: String(record.id ?? "0"),
+      tournamentId: String(record.context_id ?? "0"),
+      payoutPosition: 0,
+      tokenAddress: null,
+      tokenType: "extension",
+      amount: null,
+      tokenId: null,
+      distributionType: null,
+      distributionWeight: null,
+      distributionShares: null,
+      distributionCount: null,
+      sponsorAddress: starknet.num.toHex(record.sponsor_address),
+      extensionAddress: ext?.address != null ? starknet.num.toHex(ext.address) : null,
+      extensionConfig: Array.isArray(ext?.config) ? ext.config.map((x) => starknet.num.toHex(x)) : null
+    };
+  }
+  if (activePrize !== "Token") {
+    throw new Error(`Unrecognised Prize variant: ${JSON.stringify(prizeEnum)}`);
+  }
+  const tokenPayload = prizeVariantBag.Token;
+  if (!tokenPayload) {
+    throw new Error(`Prize::Token missing payload: ${JSON.stringify(prizeEnum)}`);
+  }
+  const tokenTypeData = tokenPayload.token_type;
   let tokenType = "erc20";
   let amount = null;
   let tokenId = null;
@@ -989,10 +1053,10 @@ function parsePrize(raw) {
     }
   }
   return {
-    prizeId: String(obj.id ?? "0"),
-    tournamentId: String(obj.context_id ?? "0"),
+    prizeId: String(record.id ?? "0"),
+    tournamentId: String(record.context_id ?? "0"),
     payoutPosition,
-    tokenAddress: starknet.num.toHex(obj.token_address),
+    tokenAddress: starknet.num.toHex(tokenPayload.token_address),
     tokenType,
     amount,
     tokenId,
@@ -1000,7 +1064,9 @@ function parsePrize(raw) {
     distributionWeight,
     distributionShares,
     distributionCount,
-    sponsorAddress: starknet.num.toHex(obj.sponsor_address)
+    sponsorAddress: starknet.num.toHex(record.sponsor_address),
+    extensionAddress: null,
+    extensionConfig: null
   };
 }
 function parseOption(raw) {
@@ -1125,6 +1191,20 @@ async function viewerPrizes(contract, tournamentId) {
     return result.map(parsePrize);
   }, contract.address);
 }
+function rewardClaim(partial) {
+  return {
+    prizeId: null,
+    payoutIndex: null,
+    position: null,
+    refundTokenId: null,
+    extensionTokenId: null,
+    extensionParams: null,
+    ...partial
+  };
+}
+function spanToHex(v) {
+  return Array.isArray(v) ? v.map((x) => starknet.num.toHex(x)) : [];
+}
 function translateCairoRewardType(rewardType) {
   if (!rewardType || typeof rewardType !== "object") {
     throw new Error(`Unexpected RewardType payload: ${JSON.stringify(rewardType)}`);
@@ -1133,70 +1213,70 @@ function translateCairoRewardType(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 prizeClaim = innerBag.Prize;
+    const pcBag = typeof prizeClaim?.activeVariant === "function" ? prizeClaim.variant : prizeClaim;
+    if (pcBag?.Token === void 0 && pcBag?.Extension !== void 0) {
+      const ext = pcBag.Extension;
+      const tokenId = parseOption(ext.token_id);
+      return rewardClaim({
+        claimKind: "prize_extension",
+        prizeId: BigInt(ext.prize_id ?? 0).toString(),
+        extensionTokenId: tokenId != null ? starknet.num.toHex(tokenId) : null,
+        extensionParams: spanToHex(ext.payout_params)
+      });
+    }
+    const prize = pcBag?.Token ?? prizeClaim;
     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 {
+      return rewardClaim({
         claimKind: "prize_single",
-        prizeId: BigInt(subBag.Single).toString(),
-        payoutIndex: null,
-        position: null,
-        refundTokenId: null
-      };
+        prizeId: BigInt(subBag.Single).toString()
+      });
     }
     if (subVariant === "Distributed" || subBag?.Distributed !== void 0) {
       const distributed = subBag.Distributed;
       const prizeId = distributed?.["0"] ?? distributed?.[0];
       const payoutIndex = distributed?.["1"] ?? distributed?.[1];
-      return {
+      return rewardClaim({
         claimKind: "prize_distributed",
         prizeId: BigInt(prizeId).toString(),
-        payoutIndex: Number(payoutIndex),
-        position: null,
-        refundTokenId: null
-      };
+        payoutIndex: Number(payoutIndex)
+      });
     }
   }
   if (outer === "EntryFee" || innerBag.EntryFee !== void 0) {
-    const entryFee = innerBag.EntryFee;
+    const entryFeeClaim = innerBag.EntryFee;
+    const efBag = typeof entryFeeClaim?.activeVariant === "function" ? entryFeeClaim.variant : entryFeeClaim;
+    if (efBag?.Token === void 0 && efBag?.Extension !== void 0) {
+      const ext = efBag.Extension;
+      const tokenId = parseOption(ext.token_id);
+      return rewardClaim({
+        claimKind: "entry_fee_extension",
+        extensionTokenId: tokenId != null ? starknet.num.toHex(tokenId) : null,
+        extensionParams: spanToHex(ext.claim_params)
+      });
+    }
+    const entryFee = efBag?.Token ?? entryFeeClaim;
     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 {
+      return rewardClaim({
         claimKind: "entry_fee_position",
-        prizeId: null,
-        payoutIndex: null,
-        position: Number(subBag.Position),
-        refundTokenId: null
-      };
+        position: Number(subBag.Position)
+      });
     }
     if (subVariant === "TournamentCreator" || subBag?.TournamentCreator !== void 0) {
-      return {
-        claimKind: "entry_fee_tournament_creator",
-        prizeId: null,
-        payoutIndex: null,
-        position: null,
-        refundTokenId: null
-      };
+      return rewardClaim({ claimKind: "entry_fee_tournament_creator" });
     }
     if (subVariant === "GameCreator" || subBag?.GameCreator !== void 0) {
-      return {
-        claimKind: "entry_fee_game_creator",
-        prizeId: null,
-        payoutIndex: null,
-        position: null,
-        refundTokenId: null
-      };
+      return rewardClaim({ claimKind: "entry_fee_game_creator" });
     }
     if (subVariant === "Refund" || subBag?.Refund !== void 0) {
-      return {
+      return rewardClaim({
         claimKind: "entry_fee_refund",
-        prizeId: null,
-        payoutIndex: null,
-        position: null,
         refundTokenId: `0x${BigInt(subBag.Refund).toString(16)}`
-      };
+      });
     }
   }
   throw new Error(
@@ -1207,13 +1287,15 @@ async function viewerRewardClaims(contract, tournamentId, offset, limit) {
   return wrapRpcCall(async () => {
     const result = await contract.call("tournament_reward_claims", [tournamentId, offset, limit]);
     const obj = result;
-    const claims = obj.claims?.map((raw) => {
-      const claim = raw;
-      return {
-        ...translateCairoRewardType(claim.reward_type),
-        claimed: Boolean(claim.claimed)
-      };
-    }) ?? [];
+    const claims = (obj.claims ?? []).map(
+      (raw) => {
+        const claim = raw;
+        return {
+          ...translateCairoRewardType(claim.reward_type),
+          claimed: Boolean(claim.claimed)
+        };
+      }
+    );
     return {
       claims,
       total: Number(obj.total ?? 0),
@@ -1493,20 +1575,6 @@ var budokanViewer_default = [
       }
     ]
   },
-  {
-    type: "enum",
-    name: "core::option::Option::<budokan_interfaces::budokan::EntryFee>",
-    variants: [
-      {
-        name: "Some",
-        type: "budokan_interfaces::budokan::EntryFee"
-      },
-      {
-        name: "None",
-        type: "()"
-      }
-    ]
-  },
   {
     type: "struct",
     name: "core::array::Span::<core::felt252>",
@@ -1531,6 +1599,34 @@ var budokanViewer_default = [
       }
     ]
   },
+  {
+    type: "enum",
+    name: "budokan_interfaces::budokan::EntryFeeKind",
+    variants: [
+      {
+        name: "BuiltIn",
+        type: "budokan_interfaces::budokan::EntryFee"
+      },
+      {
+        name: "Extension",
+        type: "metagame_extensions_interfaces::extension::ExtensionConfig"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>",
+    variants: [
+      {
+        name: "Some",
+        type: "budokan_interfaces::budokan::EntryFeeKind"
+      },
+      {
+        name: "None",
+        type: "()"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "game_components_interfaces::entry_requirement::EntryRequirementType",
@@ -1621,7 +1717,7 @@ var budokanViewer_default = [
       },
       {
         name: "entry_fee",
-        type: "core::option::Option::<budokan_interfaces::budokan::EntryFee>"
+        type: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>"
       },
       {
         name: "entry_requirement",
@@ -1777,7 +1873,49 @@ var budokanViewer_default = [
   },
   {
     type: "struct",
-    name: "game_components_interfaces::prize::PrizeData",
+    name: "game_components_interfaces::prize::TokenPrizePayload",
+    members: [
+      {
+        name: "token_address",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "token_type",
+        type: "game_components_interfaces::prize::TokenTypeData"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::prize::ExtensionPrizePayload",
+    members: [
+      {
+        name: "address",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "config",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "game_components_interfaces::prize::Prize",
+    variants: [
+      {
+        name: "Token",
+        type: "game_components_interfaces::prize::TokenPrizePayload"
+      },
+      {
+        name: "Extension",
+        type: "game_components_interfaces::prize::ExtensionPrizePayload"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::prize::PrizeRecord",
     members: [
       {
         name: "id",
@@ -1788,16 +1926,12 @@ var budokanViewer_default = [
         type: "core::integer::u64"
       },
       {
-        name: "token_address",
+        name: "sponsor_address",
         type: "core::starknet::contract_address::ContractAddress"
       },
       {
-        name: "token_type",
-        type: "game_components_interfaces::prize::TokenTypeData"
-      },
-      {
-        name: "sponsor_address",
-        type: "core::starknet::contract_address::ContractAddress"
+        name: "prize",
+        type: "game_components_interfaces::prize::Prize"
       }
     ]
   },
@@ -1815,6 +1949,52 @@ var budokanViewer_default = [
       }
     ]
   },
+  {
+    type: "enum",
+    name: "core::option::Option::<core::felt252>",
+    variants: [
+      {
+        name: "Some",
+        type: "core::felt252"
+      },
+      {
+        name: "None",
+        type: "()"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "budokan_interfaces::budokan::ExtensionPrizeClaim",
+    members: [
+      {
+        name: "prize_id",
+        type: "core::integer::u64"
+      },
+      {
+        name: "token_id",
+        type: "core::option::Option::<core::felt252>"
+      },
+      {
+        name: "payout_params",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "budokan_interfaces::budokan::PrizeClaim",
+    variants: [
+      {
+        name: "Token",
+        type: "game_components_interfaces::prize::PrizeType"
+      },
+      {
+        name: "Extension",
+        type: "budokan_interfaces::budokan::ExtensionPrizeClaim"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "budokan_interfaces::budokan::EntryFeeRewardType",
@@ -1837,17 +2017,45 @@ var budokanViewer_default = [
       }
     ]
   },
+  {
+    type: "struct",
+    name: "budokan_interfaces::budokan::ExtensionEntryFeeClaim",
+    members: [
+      {
+        name: "token_id",
+        type: "core::option::Option::<core::felt252>"
+      },
+      {
+        name: "claim_params",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "budokan_interfaces::budokan::EntryFeeClaim",
+    variants: [
+      {
+        name: "Token",
+        type: "budokan_interfaces::budokan::EntryFeeRewardType"
+      },
+      {
+        name: "Extension",
+        type: "budokan_interfaces::budokan::ExtensionEntryFeeClaim"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "budokan_interfaces::budokan::RewardType",
     variants: [
       {
         name: "Prize",
-        type: "game_components_interfaces::prize::PrizeType"
+        type: "budokan_interfaces::budokan::PrizeClaim"
       },
       {
         name: "EntryFee",
-        type: "budokan_interfaces::budokan::EntryFeeRewardType"
+        type: "budokan_interfaces::budokan::EntryFeeClaim"
       }
     ]
   },
@@ -2138,6 +2346,62 @@ var budokanViewer_default = [
         ],
         state_mutability: "view"
       },
+      {
+        type: "function",
+        name: "tournament_registrations_by_owner",
+        inputs: [
+          {
+            name: "tournament_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "owner",
+            type: "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            name: "offset",
+            type: "core::integer::u32"
+          },
+          {
+            name: "limit",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "budokan_interfaces::viewer::RegistrationResult"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "tournament_registrations_by_token_ids",
+        inputs: [
+          {
+            name: "tournament_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "token_ids",
+            type: "core::array::Array::<core::felt252>"
+          },
+          {
+            name: "offset",
+            type: "core::integer::u32"
+          },
+          {
+            name: "limit",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "budokan_interfaces::viewer::RegistrationResult"
+          }
+        ],
+        state_mutability: "view"
+      },
       {
         type: "function",
         name: "leaderboard",
@@ -2173,7 +2437,7 @@ var budokanViewer_default = [
         ],
         outputs: [
           {
-            type: "core::array::Array::<game_components_interfaces::prize::PrizeData>"
+            type: "core::array::Array::<game_components_interfaces::prize::PrizeRecord>"
           }
         ],
         state_mutability: "view"
@@ -2434,26 +2698,60 @@ var budokan_default = [
   },
   {
     type: "impl",
-    name: "GameContextImpl",
-    interface_name: "game_components_interfaces::metagame::context::IMetagameContext"
-  },
-  {
-    type: "enum",
-    name: "core::bool",
-    variants: [
-      {
-        name: "False",
-        type: "()"
-      },
-      {
-        name: "True",
-        type: "()"
-      }
-    ]
+    name: "BudokanRewardsAdminImpl",
+    interface_name: "budokan::budokan::Budokan::IBudokanRewardsAdmin"
   },
   {
     type: "interface",
-    name: "game_components_interfaces::metagame::context::IMetagameContext",
+    name: "budokan::budokan::Budokan::IBudokanRewardsAdmin",
+    items: [
+      {
+        type: "function",
+        name: "set_rewards_class_hash",
+        inputs: [
+          {
+            name: "new_class_hash",
+            type: "core::starknet::class_hash::ClassHash"
+          }
+        ],
+        outputs: [],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "rewards_class_hash",
+        inputs: [],
+        outputs: [
+          {
+            type: "core::starknet::class_hash::ClassHash"
+          }
+        ],
+        state_mutability: "view"
+      }
+    ]
+  },
+  {
+    type: "impl",
+    name: "GameContextImpl",
+    interface_name: "game_components_interfaces::metagame::context::IMetagameContext"
+  },
+  {
+    type: "enum",
+    name: "core::bool",
+    variants: [
+      {
+        name: "False",
+        type: "()"
+      },
+      {
+        name: "True",
+        type: "()"
+      }
+    ]
+  },
+  {
+    type: "interface",
+    name: "game_components_interfaces::metagame::context::IMetagameContext",
     items: [
       {
         type: "function",
@@ -2516,11 +2814,11 @@ var budokan_default = [
     members: [
       {
         name: "name",
-        type: "core::byte_array::ByteArray"
+        type: "core::felt252"
       },
       {
         name: "value",
-        type: "core::byte_array::ByteArray"
+        type: "core::felt252"
       }
     ]
   },
@@ -2748,50 +3046,54 @@ var budokan_default = [
     ]
   },
   {
-    type: "enum",
-    name: "core::option::Option::<budokan_interfaces::budokan::EntryFee>",
-    variants: [
-      {
-        name: "Some",
-        type: "budokan_interfaces::budokan::EntryFee"
-      },
+    type: "struct",
+    name: "core::array::Span::<core::felt252>",
+    members: [
       {
-        name: "None",
-        type: "()"
+        name: "snapshot",
+        type: "@core::array::Array::<core::felt252>"
       }
     ]
   },
   {
     type: "struct",
-    name: "core::array::Span::<core::starknet::contract_address::ContractAddress>",
+    name: "metagame_extensions_interfaces::extension::ExtensionConfig",
     members: [
       {
-        name: "snapshot",
-        type: "@core::array::Array::<core::starknet::contract_address::ContractAddress>"
+        name: "address",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "config",
+        type: "core::array::Span::<core::felt252>"
       }
     ]
   },
   {
-    type: "struct",
-    name: "core::array::Span::<core::felt252>",
-    members: [
+    type: "enum",
+    name: "budokan_interfaces::budokan::EntryFeeKind",
+    variants: [
       {
-        name: "snapshot",
-        type: "@core::array::Array::<core::felt252>"
+        name: "BuiltIn",
+        type: "budokan_interfaces::budokan::EntryFee"
+      },
+      {
+        name: "Extension",
+        type: "metagame_extensions_interfaces::extension::ExtensionConfig"
       }
     ]
   },
   {
-    type: "struct",
-    name: "interfaces::extension::ExtensionConfig",
-    members: [
+    type: "enum",
+    name: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>",
+    variants: [
       {
-        name: "address",
-        type: "core::starknet::contract_address::ContractAddress"
+        name: "Some",
+        type: "budokan_interfaces::budokan::EntryFeeKind"
       },
       {
-        name: "config",
-        type: "core::array::Span::<core::felt252>"
+        name: "None",
+        type: "()"
       }
     ]
   },
@@ -2805,7 +3107,7 @@ var budokan_default = [
       },
       {
         name: "extension",
-        type: "interfaces::extension::ExtensionConfig"
+        type: "metagame_extensions_interfaces::extension::ExtensionConfig"
       }
     ]
   },
@@ -2885,7 +3187,7 @@ var budokan_default = [
       },
       {
         name: "entry_fee",
-        type: "core::option::Option::<budokan_interfaces::budokan::EntryFee>"
+        type: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>"
       },
       {
         name: "entry_requirement",
@@ -2927,6 +3229,20 @@ var budokan_default = [
       }
     ]
   },
+  {
+    type: "enum",
+    name: "core::option::Option::<core::felt252>",
+    variants: [
+      {
+        name: "Some",
+        type: "core::felt252"
+      },
+      {
+        name: "None",
+        type: "()"
+      }
+    ]
+  },
   {
     type: "struct",
     name: "core::integer::u256",
@@ -2959,10 +3275,6 @@ var budokan_default = [
         name: "NFT",
         type: "game_components_interfaces::entry_requirement::NFTQualification"
       },
-      {
-        name: "Address",
-        type: "core::starknet::contract_address::ContractAddress"
-      },
       {
         name: "Extension",
         type: "core::array::Span::<core::felt252>"
@@ -2983,6 +3295,38 @@ var budokan_default = [
       }
     ]
   },
+  {
+    type: "enum",
+    name: "core::option::Option::<core::array::Span::<core::felt252>>",
+    variants: [
+      {
+        name: "Some",
+        type: "core::array::Span::<core::felt252>"
+      },
+      {
+        name: "None",
+        type: "()"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "budokan_interfaces::budokan::TournamentRecipientParams",
+    members: [
+      {
+        name: "player_address",
+        type: "core::option::Option::<core::starknet::contract_address::ContractAddress>"
+      },
+      {
+        name: "qualifier",
+        type: "core::option::Option::<core::starknet::contract_address::ContractAddress>"
+      },
+      {
+        name: "qualification",
+        type: "core::option::Option::<game_components_interfaces::entry_requirement::QualificationProof>"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "game_components_interfaces::prize::PrizeType",
@@ -2997,6 +3341,38 @@ var budokan_default = [
       }
     ]
   },
+  {
+    type: "struct",
+    name: "budokan_interfaces::budokan::ExtensionPrizeClaim",
+    members: [
+      {
+        name: "prize_id",
+        type: "core::integer::u64"
+      },
+      {
+        name: "token_id",
+        type: "core::option::Option::<core::felt252>"
+      },
+      {
+        name: "payout_params",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "budokan_interfaces::budokan::PrizeClaim",
+    variants: [
+      {
+        name: "Token",
+        type: "game_components_interfaces::prize::PrizeType"
+      },
+      {
+        name: "Extension",
+        type: "budokan_interfaces::budokan::ExtensionPrizeClaim"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "budokan_interfaces::budokan::EntryFeeRewardType",
@@ -3019,17 +3395,45 @@ var budokan_default = [
       }
     ]
   },
+  {
+    type: "struct",
+    name: "budokan_interfaces::budokan::ExtensionEntryFeeClaim",
+    members: [
+      {
+        name: "token_id",
+        type: "core::option::Option::<core::felt252>"
+      },
+      {
+        name: "claim_params",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "budokan_interfaces::budokan::EntryFeeClaim",
+    variants: [
+      {
+        name: "Token",
+        type: "budokan_interfaces::budokan::EntryFeeRewardType"
+      },
+      {
+        name: "Extension",
+        type: "budokan_interfaces::budokan::ExtensionEntryFeeClaim"
+      }
+    ]
+  },
   {
     type: "enum",
     name: "budokan_interfaces::budokan::RewardType",
     variants: [
       {
         name: "Prize",
-        type: "game_components_interfaces::prize::PrizeType"
+        type: "budokan_interfaces::budokan::PrizeClaim"
       },
       {
         name: "EntryFee",
-        type: "budokan_interfaces::budokan::EntryFeeRewardType"
+        type: "budokan_interfaces::budokan::EntryFeeClaim"
       }
     ]
   },
@@ -3091,16 +3495,8 @@ var budokan_default = [
   },
   {
     type: "struct",
-    name: "game_components_interfaces::prize::PrizeData",
+    name: "game_components_interfaces::prize::TokenPrizePayload",
     members: [
-      {
-        name: "id",
-        type: "core::integer::u64"
-      },
-      {
-        name: "context_id",
-        type: "core::integer::u64"
-      },
       {
         name: "token_address",
         type: "core::starknet::contract_address::ContractAddress"
@@ -3108,10 +3504,34 @@ var budokan_default = [
       {
         name: "token_type",
         type: "game_components_interfaces::prize::TokenTypeData"
-      },
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::prize::ExtensionPrizePayload",
+    members: [
       {
-        name: "sponsor_address",
+        name: "address",
         type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "config",
+        type: "core::array::Span::<core::felt252>"
+      }
+    ]
+  },
+  {
+    type: "enum",
+    name: "game_components_interfaces::prize::Prize",
+    variants: [
+      {
+        name: "Token",
+        type: "game_components_interfaces::prize::TokenPrizePayload"
+      },
+      {
+        name: "Extension",
+        type: "game_components_interfaces::prize::ExtensionPrizePayload"
       }
     ]
   },
@@ -3146,38 +3566,6 @@ var budokan_default = [
         ],
         state_mutability: "view"
       },
-      {
-        type: "function",
-        name: "tournament_entries",
-        inputs: [
-          {
-            name: "tournament_id",
-            type: "core::integer::u64"
-          }
-        ],
-        outputs: [
-          {
-            type: "core::integer::u32"
-          }
-        ],
-        state_mutability: "view"
-      },
-      {
-        type: "function",
-        name: "get_leaderboard",
-        inputs: [
-          {
-            name: "tournament_id",
-            type: "core::integer::u64"
-          }
-        ],
-        outputs: [
-          {
-            type: "core::array::Array::<core::felt252>"
-          }
-        ],
-        state_mutability: "view"
-      },
       {
         type: "function",
         name: "current_phase",
@@ -3232,7 +3620,7 @@ var budokan_default = [
           },
           {
             name: "entry_fee",
-            type: "core::option::Option::<budokan_interfaces::budokan::EntryFee>"
+            type: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>"
           },
           {
             name: "entry_requirement",
@@ -3268,16 +3656,24 @@ var budokan_default = [
           },
           {
             name: "player_name",
-            type: "core::felt252"
+            type: "core::option::Option::<core::felt252>"
           },
           {
             name: "player_address",
-            type: "core::starknet::contract_address::ContractAddress"
+            type: "core::option::Option::<core::starknet::contract_address::ContractAddress>"
+          },
+          {
+            name: "qualifier",
+            type: "core::option::Option::<core::starknet::contract_address::ContractAddress>"
           },
           {
             name: "qualification",
             type: "core::option::Option::<game_components_interfaces::entry_requirement::QualificationProof>"
           },
+          {
+            name: "entry_fee_pay_params",
+            type: "core::option::Option::<core::array::Span::<core::felt252>>"
+          },
           {
             name: "salt",
             type: "core::integer::u16"
@@ -3296,7 +3692,39 @@ var budokan_default = [
       },
       {
         type: "function",
-        name: "ban_entry",
+        name: "enter_tournament_for_recipients",
+        inputs: [
+          {
+            name: "tournament_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "recipients",
+            type: "core::array::Array::<budokan_interfaces::budokan::TournamentRecipientParams>"
+          },
+          {
+            name: "player_name",
+            type: "core::option::Option::<core::felt252>"
+          },
+          {
+            name: "salt",
+            type: "core::integer::u16"
+          },
+          {
+            name: "metadata_value",
+            type: "core::integer::u16"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::array::Array::<core::felt252>"
+          }
+        ],
+        state_mutability: "external"
+      },
+      {
+        type: "function",
+        name: "ban_entry",
         inputs: [
           {
             name: "tournament_id",
@@ -3359,12 +3787,8 @@ var budokan_default = [
             type: "core::integer::u64"
           },
           {
-            name: "token_address",
-            type: "core::starknet::contract_address::ContractAddress"
-          },
-          {
-            name: "token_type",
-            type: "game_components_interfaces::prize::TokenTypeData"
+            name: "prize",
+            type: "game_components_interfaces::prize::Prize"
           },
           {
             name: "position",
@@ -3373,7 +3797,7 @@ var budokan_default = [
         ],
         outputs: [
           {
-            type: "game_components_interfaces::prize::PrizeData"
+            type: "core::integer::u64"
           }
         ],
         state_mutability: "external"
@@ -3547,6 +3971,14 @@ var budokan_default = [
       {
         name: "additional_shares",
         type: "core::array::Span::<game_components_interfaces::entry_fee::AdditionalShare>"
+      },
+      {
+        name: "distribution",
+        type: "core::option::Option::<game_components_interfaces::distribution::Distribution>"
+      },
+      {
+        name: "distribution_count",
+        type: "core::integer::u32"
       }
     ]
   },
@@ -3644,60 +4076,330 @@ var budokan_default = [
         ],
         outputs: [
           {
-            type: "game_components_interfaces::entry_requirement::QualificationEntries"
+            type: "game_components_interfaces::entry_requirement::QualificationEntries"
+          }
+        ],
+        state_mutability: "view"
+      }
+    ]
+  },
+  {
+    type: "impl",
+    name: "PrizeImpl",
+    interface_name: "game_components_interfaces::prize::IPrize"
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::prize::PrizeRecord",
+    members: [
+      {
+        name: "id",
+        type: "core::integer::u64"
+      },
+      {
+        name: "context_id",
+        type: "core::integer::u64"
+      },
+      {
+        name: "sponsor_address",
+        type: "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        name: "prize",
+        type: "game_components_interfaces::prize::Prize"
+      }
+    ]
+  },
+  {
+    type: "interface",
+    name: "game_components_interfaces::prize::IPrize",
+    items: [
+      {
+        type: "function",
+        name: "get_prize",
+        inputs: [
+          {
+            name: "prize_id",
+            type: "core::integer::u64"
+          }
+        ],
+        outputs: [
+          {
+            type: "game_components_interfaces::prize::PrizeRecord"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "get_total_prizes",
+        inputs: [],
+        outputs: [
+          {
+            type: "core::integer::u64"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "is_prize_claimed",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "prize_type",
+            type: "game_components_interfaces::prize::PrizeType"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::bool"
+          }
+        ],
+        state_mutability: "view"
+      }
+    ]
+  },
+  {
+    type: "impl",
+    name: "RegistrationImpl",
+    interface_name: "game_components_interfaces::registration::IRegistration"
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::registration::Registration",
+    members: [
+      {
+        name: "context_id",
+        type: "core::integer::u64"
+      },
+      {
+        name: "entry_id",
+        type: "core::integer::u32"
+      },
+      {
+        name: "game_token_id",
+        type: "core::felt252"
+      },
+      {
+        name: "has_submitted",
+        type: "core::bool"
+      },
+      {
+        name: "is_banned",
+        type: "core::bool"
+      }
+    ]
+  },
+  {
+    type: "interface",
+    name: "game_components_interfaces::registration::IRegistration",
+    items: [
+      {
+        type: "function",
+        name: "get_entry",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "entry_id",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "game_components_interfaces::registration::Registration"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "entry_exists",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "entry_id",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::bool"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "is_token_banned",
+        inputs: [
+          {
+            name: "token_id",
+            type: "core::felt252"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::bool"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "get_entry_count",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::integer::u32"
+          }
+        ],
+        state_mutability: "view"
+      }
+    ]
+  },
+  {
+    type: "impl",
+    name: "LeaderboardImpl",
+    interface_name: "game_components_interfaces::leaderboard::ILeaderboard"
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::structs::leaderboard::LeaderboardEntry",
+    members: [
+      {
+        name: "id",
+        type: "core::felt252"
+      },
+      {
+        name: "score",
+        type: "core::integer::u64"
+      }
+    ]
+  },
+  {
+    type: "struct",
+    name: "game_components_interfaces::structs::leaderboard::LeaderboardStoreConfig",
+    members: [
+      {
+        name: "max_entries",
+        type: "core::integer::u32"
+      },
+      {
+        name: "ascending",
+        type: "core::bool"
+      },
+      {
+        name: "game_address",
+        type: "core::starknet::contract_address::ContractAddress"
+      }
+    ]
+  },
+  {
+    type: "interface",
+    name: "game_components_interfaces::leaderboard::ILeaderboard",
+    items: [
+      {
+        type: "function",
+        name: "get_leaderboard_entries",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::array::Array::<game_components_interfaces::structs::leaderboard::LeaderboardEntry>"
+          }
+        ],
+        state_mutability: "view"
+      },
+      {
+        type: "function",
+        name: "get_leaderboard_entry",
+        inputs: [
+          {
+            name: "context_id",
+            type: "core::integer::u64"
+          },
+          {
+            name: "position",
+            type: "core::integer::u32"
+          }
+        ],
+        outputs: [
+          {
+            type: "game_components_interfaces::structs::leaderboard::LeaderboardEntry"
           }
         ],
         state_mutability: "view"
-      }
-    ]
-  },
-  {
-    type: "impl",
-    name: "PrizeImpl",
-    interface_name: "game_components_interfaces::prize::IPrize"
-  },
-  {
-    type: "interface",
-    name: "game_components_interfaces::prize::IPrize",
-    items: [
+      },
       {
         type: "function",
-        name: "get_prize",
+        name: "get_top_leaderboard_entries",
         inputs: [
           {
-            name: "prize_id",
+            name: "context_id",
             type: "core::integer::u64"
+          },
+          {
+            name: "count",
+            type: "core::integer::u32"
           }
         ],
         outputs: [
           {
-            type: "game_components_interfaces::prize::PrizeData"
+            type: "core::array::Array::<game_components_interfaces::structs::leaderboard::LeaderboardEntry>"
           }
         ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "get_total_prizes",
-        inputs: [],
-        outputs: [
+        name: "get_position",
+        inputs: [
           {
+            name: "context_id",
             type: "core::integer::u64"
+          },
+          {
+            name: "token_id",
+            type: "core::felt252"
+          }
+        ],
+        outputs: [
+          {
+            type: "core::option::Option::<core::integer::u32>"
           }
         ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "is_prize_claimed",
+        name: "qualifies",
         inputs: [
           {
             name: "context_id",
             type: "core::integer::u64"
           },
           {
-            name: "prize_type",
-            type: "game_components_interfaces::prize::PrizeType"
+            name: "score",
+            type: "core::integer::u64"
           }
         ],
         outputs: [
@@ -3706,116 +4408,75 @@ var budokan_default = [
           }
         ],
         state_mutability: "view"
-      }
-    ]
-  },
-  {
-    type: "impl",
-    name: "RegistrationImpl",
-    interface_name: "game_components_interfaces::registration::IRegistration"
-  },
-  {
-    type: "struct",
-    name: "game_components_interfaces::registration::Registration",
-    members: [
-      {
-        name: "context_id",
-        type: "core::integer::u64"
-      },
-      {
-        name: "entry_id",
-        type: "core::integer::u32"
-      },
-      {
-        name: "game_token_id",
-        type: "core::felt252"
-      },
-      {
-        name: "has_submitted",
-        type: "core::bool"
       },
-      {
-        name: "is_banned",
-        type: "core::bool"
-      }
-    ]
-  },
-  {
-    type: "interface",
-    name: "game_components_interfaces::registration::IRegistration",
-    items: [
       {
         type: "function",
-        name: "get_entry",
+        name: "is_full",
         inputs: [
           {
             name: "context_id",
             type: "core::integer::u64"
-          },
-          {
-            name: "entry_id",
-            type: "core::integer::u32"
           }
         ],
         outputs: [
           {
-            type: "game_components_interfaces::registration::Registration"
+            type: "core::bool"
           }
         ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "entry_exists",
+        name: "get_leaderboard_length",
         inputs: [
           {
             name: "context_id",
             type: "core::integer::u64"
-          },
-          {
-            name: "entry_id",
-            type: "core::integer::u32"
           }
         ],
         outputs: [
           {
-            type: "core::bool"
+            type: "core::integer::u32"
           }
         ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "is_entry_banned",
+        name: "get_config",
         inputs: [
           {
             name: "context_id",
             type: "core::integer::u64"
-          },
-          {
-            name: "entry_id",
-            type: "core::integer::u32"
           }
         ],
         outputs: [
           {
-            type: "core::bool"
+            type: "game_components_interfaces::structs::leaderboard::LeaderboardStoreConfig"
           }
         ],
         state_mutability: "view"
       },
       {
         type: "function",
-        name: "get_entry_count",
+        name: "find_position",
         inputs: [
           {
             name: "context_id",
             type: "core::integer::u64"
+          },
+          {
+            name: "score",
+            type: "core::integer::u64"
+          },
+          {
+            name: "token_id",
+            type: "core::felt252"
           }
         ],
         outputs: [
           {
-            type: "core::integer::u32"
+            type: "core::option::Option::<core::integer::u32>"
           }
         ],
         state_mutability: "view"
@@ -3959,6 +4620,12 @@ var budokan_default = [
     kind: "enum",
     variants: []
   },
+  {
+    type: "event",
+    name: "openzeppelin_security::reentrancyguard::ReentrancyGuardComponent::Event",
+    kind: "enum",
+    variants: []
+  },
   {
     type: "event",
     name: "budokan::events::TournamentCreated",
@@ -3974,11 +4641,6 @@ var budokan_default = [
         type: "core::starknet::contract_address::ContractAddress",
         kind: "key"
       },
-      {
-        name: "created_at",
-        type: "core::integer::u64",
-        kind: "data"
-      },
       {
         name: "created_by",
         type: "core::starknet::contract_address::ContractAddress",
@@ -3995,28 +4657,28 @@ var budokan_default = [
         kind: "data"
       },
       {
-        name: "schedule",
-        type: "budokan_interfaces::budokan::Schedule",
+        name: "config",
+        type: "core::felt252",
         kind: "data"
       },
       {
-        name: "game_config",
-        type: "budokan_interfaces::budokan::GameConfig",
+        name: "client_url",
+        type: "core::option::Option::<core::byte_array::ByteArray>",
         kind: "data"
       },
       {
-        name: "entry_fee",
-        type: "core::option::Option::<budokan_interfaces::budokan::EntryFee>",
+        name: "renderer",
+        type: "core::option::Option::<core::starknet::contract_address::ContractAddress>",
         kind: "data"
       },
       {
-        name: "entry_requirement",
-        type: "core::option::Option::<game_components_interfaces::entry_requirement::EntryRequirement>",
+        name: "entry_fee",
+        type: "core::option::Option::<budokan_interfaces::budokan::EntryFeeKind>",
         kind: "data"
       },
       {
-        name: "leaderboard_config",
-        type: "budokan_interfaces::budokan::LeaderboardConfig",
+        name: "entry_requirement",
+        type: "core::option::Option::<game_components_interfaces::entry_requirement::EntryRequirement>",
         kind: "data"
       }
     ]
@@ -4036,11 +4698,6 @@ var budokan_default = [
         type: "core::felt252",
         kind: "key"
       },
-      {
-        name: "game_address",
-        type: "core::starknet::contract_address::ContractAddress",
-        kind: "data"
-      },
       {
         name: "player_address",
         type: "core::starknet::contract_address::ContractAddress",
@@ -4050,22 +4707,12 @@ var budokan_default = [
         name: "entry_number",
         type: "core::integer::u32",
         kind: "data"
-      },
-      {
-        name: "has_submitted",
-        type: "core::bool",
-        kind: "data"
-      },
-      {
-        name: "is_banned",
-        type: "core::bool",
-        kind: "data"
       }
     ]
   },
   {
     type: "event",
-    name: "budokan::events::LeaderboardUpdated",
+    name: "budokan::events::TournamentEntryStateChanged",
     kind: "struct",
     members: [
       {
@@ -4074,8 +4721,18 @@ var budokan_default = [
         kind: "key"
       },
       {
-        name: "token_ids",
-        type: "core::array::Span::<core::felt252>",
+        name: "game_token_id",
+        type: "core::felt252",
+        kind: "key"
+      },
+      {
+        name: "has_submitted",
+        type: "core::bool",
+        kind: "data"
+      },
+      {
+        name: "is_banned",
+        type: "core::bool",
         kind: "data"
       }
     ]
@@ -4101,13 +4758,8 @@ var budokan_default = [
         kind: "data"
       },
       {
-        name: "token_address",
-        type: "core::starknet::contract_address::ContractAddress",
-        kind: "data"
-      },
-      {
-        name: "token_type",
-        type: "game_components_interfaces::prize::TokenTypeData",
+        name: "prize",
+        type: "game_components_interfaces::prize::Prize",
         kind: "data"
       },
       {
@@ -4216,6 +4868,11 @@ var budokan_default = [
         type: "game_components_metagame::prize::prize_component::PrizeComponent::Event",
         kind: "flat"
       },
+      {
+        name: "ReentrancyGuardEvent",
+        type: "openzeppelin_security::reentrancyguard::ReentrancyGuardComponent::Event",
+        kind: "flat"
+      },
       {
         name: "TournamentCreated",
         type: "budokan::events::TournamentCreated",
@@ -4227,8 +4884,8 @@ var budokan_default = [
         kind: "nested"
       },
       {
-        name: "LeaderboardUpdated",
-        type: "budokan::events::LeaderboardUpdated",
+        name: "TournamentEntryStateChanged",
+        type: "budokan::events::TournamentEntryStateChanged",
         kind: "nested"
       },
       {
@@ -4396,6 +5053,7 @@ var BudokanClient = class {
             if (prizes.length === 0) return t;
             const tokenMap = /* @__PURE__ */ new Map();
             for (const p of prizes) {
+              if (p.tokenType === "extension" || p.tokenAddress == null) continue;
               const key = p.tokenAddress;
               const existing = tokenMap.get(key);
               if (existing) {
@@ -4711,6 +5369,501 @@ function createBudokanClient(config) {
   return new BudokanClient(config);
 }
 
+// src/games/whitelist.ts
+var STRK = "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d";
+var MAINNET_GAMES_RAW = [
+  {
+    contractAddress: "0x4de0351ceab4ecd50be6ee09329b0dcb3b96a9da88cc158f453823a389722fa",
+    name: "Death Mountain",
+    url: "https://deathmountain.gg/",
+    playUrl: "https://deathmountain.gg/play?id=",
+    watchLink: "https://deathmountain.gg/watch?id=",
+    replayLink: "https://deathmountain.gg/replay?id=",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK,
+    defaultGameFeePercentage: 5,
+    averageGasCostUsd: 0.25
+  },
+  {
+    contractAddress: "0x642f228f70b1ca7edb4ab7ff0bab067369c2e276ddc2570ca18802d4e758edc",
+    name: "zKube",
+    imageUrl: "https://zkube-budokan-sepolia.vercel.app/assets/logo.png",
+    url: "https://zkube.io",
+    playUrl: "https://zkube.io/play/",
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK
+  }
+];
+var SEPOLIA_GAMES_RAW = [
+  {
+    contractAddress: "0x04359aee29873cd9603207d29b4140468bac3e042aa10daab2e1a8b2dd60ef7b",
+    name: "Dark Shuffle",
+    imageUrl: "https://darkshuffle.dev/favicon.svg",
+    url: "https://darkshuffle.dev",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK
+  },
+  {
+    contractAddress: "0x07ae26eecf0274aabb31677753ff3a4e15beec7268fa1b104f73ce3c89202831",
+    name: "Death Mountain",
+    imageUrl: "https://darkshuffle.dev/favicon.svg",
+    url: "https://lootsurvivor.io/",
+    playUrl: "https://lootsurvivor.io/survivor/play?id=",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK
+  },
+  {
+    contractAddress: "0x012ccc9a2d76c836d088203f6e9d62e22d1a9f7479d1aea8b503a1036c0f4487",
+    name: "Nums",
+    url: "https://nums-blond.vercel.app/",
+    playUrl: "https://nums-blond.vercel.app/",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK
+  },
+  {
+    contractAddress: "0x3a2ea07f0f49c770035eed9a010eb3d1e1bc3cb92e1d47eef2ad75a25c6bdb2",
+    name: "Number Guess",
+    url: "https://funfactory.gg/games/1",
+    playUrl: "https://funfactory.gg/tokens/{tokenId}/play",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK,
+    objectImage: true
+  },
+  {
+    contractAddress: "0x5e02a1f750b3fa0e835d454705b664ecb23166cdb49459b1c96c1e3eaf9a2f4",
+    name: "zKube",
+    imageUrl: "https://zkube-budokan-sepolia.vercel.app/assets/logo.png",
+    url: "https://zkube-budokan-sepolia.vercel.app",
+    playUrl: "https://zkube-budokan-sepolia.vercel.app/play/",
+    controllerOnly: true,
+    minEntryFeeUsd: 0.25,
+    defaultEntryFeeToken: STRK
+  }
+];
+var MAINNET_GAMES = MAINNET_GAMES_RAW.map(canonicalize);
+var SEPOLIA_GAMES = SEPOLIA_GAMES_RAW.map(canonicalize);
+function canonicalize(game) {
+  return {
+    ...game,
+    contractAddress: normalizeAddress(game.contractAddress),
+    defaultEntryFeeToken: game.defaultEntryFeeToken ? normalizeAddress(game.defaultEntryFeeToken) : void 0
+  };
+}
+function getWhitelistedGames(chain) {
+  const list = chain === "mainnet" ? MAINNET_GAMES : SEPOLIA_GAMES;
+  return list.map((g) => ({ ...g })).sort((a, b) => {
+    const aDisabled = a.disabled ?? false;
+    const bDisabled = b.disabled ?? false;
+    if (aDisabled !== bDisabled) return aDisabled ? 1 : -1;
+    return a.name.localeCompare(b.name);
+  });
+}
+function findWhitelistedGame(chain, contractAddress) {
+  const target = normalizeAddress(contractAddress);
+  return getWhitelistedGames(chain).find((g) => g.contractAddress === target);
+}
+function isGameWhitelisted(chain, contractAddress) {
+  return findWhitelistedGame(chain, contractAddress) !== void 0;
+}
+function getGameDefaults(chain, contractAddress) {
+  const game = findWhitelistedGame(chain, contractAddress);
+  return {
+    minEntryFeeUsd: game?.minEntryFeeUsd ?? 0.25,
+    defaultEntryFeeToken: game?.defaultEntryFeeToken ?? STRK,
+    defaultGameFeePercentage: game?.defaultGameFeePercentage ?? 1,
+    averageGasCostUsd: game?.averageGasCostUsd,
+    leaderboardAscending: game?.leaderboardAscending ?? false,
+    leaderboardGameMustBeOver: game?.leaderboardGameMustBeOver ?? false
+  };
+}
+function buildErc20ApproveCall(tokenAddress, spender, amount) {
+  return {
+    contractAddress: tokenAddress,
+    entrypoint: "approve",
+    calldata: starknet.CallData.compile([spender, starknet.uint256.bnToUint256(amount)])
+  };
+}
+function buildEnterTournamentCall(budokanAddress, args) {
+  const calldata = [
+    starknet.num.toHex(args.tournamentId)
+    // tournament_id u64
+  ];
+  if (args.playerName) {
+    calldata.push("0x0", felt252FromShortString(args.playerName));
+  } else {
+    calldata.push("0x1");
+  }
+  if (args.playerAddress) {
+    calldata.push("0x0", args.playerAddress);
+  } else {
+    calldata.push("0x1");
+  }
+  if (args.qualifier) {
+    calldata.push("0x0", args.qualifier);
+  } else {
+    calldata.push("0x1");
+  }
+  calldata.push("0x1");
+  if (args.entryFeePayParams && args.entryFeePayParams.length > 0) {
+    calldata.push(
+      "0x0",
+      starknet.num.toHex(args.entryFeePayParams.length),
+      ...args.entryFeePayParams
+    );
+  } else {
+    calldata.push("0x1");
+  }
+  calldata.push(starknet.num.toHex(args.salt ?? 0));
+  calldata.push(starknet.num.toHex(args.metadataValue ?? 0));
+  return {
+    contractAddress: budokanAddress,
+    entrypoint: "enter_tournament",
+    calldata
+  };
+}
+function buildSubmitScoreCall(budokanAddress, args) {
+  return {
+    contractAddress: budokanAddress,
+    entrypoint: "submit_score",
+    calldata: starknet.CallData.compile([args.tournamentId, args.tokenId, args.position])
+  };
+}
+function buildClaimRewardCall(budokanAddress, args) {
+  const calldata = [starknet.num.toHex(args.tournamentId)];
+  pushRewardTypeFelts(calldata, args.reward);
+  return {
+    contractAddress: budokanAddress,
+    entrypoint: "claim_reward",
+    calldata
+  };
+}
+function buildCreateTournamentCall(budokanAddress, args) {
+  const calldata = starknet.CallData.compile({
+    creator_rewards_address: args.creatorRewardsAddress,
+    metadata: {
+      // name is a felt252 (≤31 ASCII bytes). starknet.js packs short
+      // ASCII strings into a single felt automatically.
+      name: args.name,
+      // description is a Cairo ByteArray (multi-felt: data words +
+      // pending word + pending word length). A plain JS string serializes
+      // to a single felt and the deserializer reverts — wrap explicitly.
+      description: starknet.byteArray.byteArrayFromString(args.description)
+    },
+    schedule: {
+      registration_start_delay: args.schedule.registrationStartDelay,
+      registration_end_delay: args.schedule.registrationEndDelay,
+      game_start_delay: args.schedule.gameStartDelay,
+      game_end_delay: args.schedule.gameEndDelay,
+      submission_duration: args.schedule.submissionDuration
+    },
+    game_config: {
+      game_address: args.gameAddress,
+      settings_id: args.settingsId,
+      soulbound: false,
+      paymaster: false,
+      // Options must be CairoOption — see file header for why.
+      client_url: new starknet.CairoOption(starknet.CairoOptionVariant.None),
+      renderer: new starknet.CairoOption(starknet.CairoOptionVariant.None)
+    },
+    entry_fee: encodeEntryFeeOption(args.entryFee),
+    entry_requirement: encodeEntryRequirementOption(args.entryRequirement),
+    leaderboard_config: {
+      ascending: args.leaderboard.ascending,
+      game_must_be_over: args.leaderboard.gameMustBeOver
+    },
+    salt: args.salt ?? 0,
+    metadata_value: args.metadataValue ?? 0
+  });
+  return {
+    contractAddress: budokanAddress,
+    entrypoint: "create_tournament",
+    calldata
+  };
+}
+function buildAddPrizeCall(budokanAddress, args) {
+  const prize = encodePrize(args.prize);
+  const position = args.prize.kind === "token" && args.prize.position !== void 0 ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, args.prize.position) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
+  const calldata = starknet.CallData.compile({
+    tournament_id: args.tournamentId,
+    prize,
+    position
+  });
+  return {
+    contractAddress: budokanAddress,
+    entrypoint: "add_prize",
+    calldata
+  };
+}
+function encodePrize(spec) {
+  if (spec.kind === "token") {
+    return new starknet.CairoCustomEnum({
+      Token: {
+        token_address: spec.tokenAddress,
+        token_type: encodeTokenType(spec.tokenType)
+      },
+      Extension: void 0
+    });
+  }
+  return new starknet.CairoCustomEnum({
+    Token: void 0,
+    Extension: {
+      address: spec.address,
+      config: spec.config
+    }
+  });
+}
+function encodeTokenType(spec) {
+  if (spec.kind === "erc20") {
+    if (spec.distribution && spec.distributionCount === void 0) {
+      throw new Error(
+        "TokenTypeSpec.erc20: distributionCount is required when distribution is set"
+      );
+    }
+    const distribution = spec.distribution ? new starknet.CairoOption(
+      starknet.CairoOptionVariant.Some,
+      encodeDistribution(spec.distribution)
+    ) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
+    const distributionCount = spec.distribution && spec.distributionCount !== void 0 ? new starknet.CairoOption(
+      starknet.CairoOptionVariant.Some,
+      spec.distributionCount
+    ) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
+    return new starknet.CairoCustomEnum({
+      erc20: {
+        amount: spec.amount,
+        distribution,
+        distribution_count: distributionCount
+      },
+      erc721: void 0
+    });
+  }
+  return new starknet.CairoCustomEnum({
+    erc20: void 0,
+    erc721: { id: spec.tokenId }
+  });
+}
+function encodeEntryFeeOption(fee) {
+  if (!fee) return new starknet.CairoOption(starknet.CairoOptionVariant.None);
+  const builtIn = {
+    token_address: fee.tokenAddress,
+    amount: fee.amount,
+    tournament_creator_share: fee.tournamentCreatorShare,
+    game_creator_share: fee.gameCreatorShare,
+    refund_share: fee.refundShare,
+    distribution: encodeDistribution(fee.distribution),
+    distribution_count: fee.distributionCount
+  };
+  return new starknet.CairoOption(
+    starknet.CairoOptionVariant.Some,
+    new starknet.CairoCustomEnum({ BuiltIn: builtIn, Extension: void 0 })
+  );
+}
+function encodeEntryRequirementOption(req) {
+  if (!req)
+    return new starknet.CairoOption(starknet.CairoOptionVariant.None);
+  return new starknet.CairoOption(starknet.CairoOptionVariant.Some, {
+    entry_limit: req.entryLimit,
+    entry_requirement_type: encodeEntryRequirementType(req.type)
+  });
+}
+function encodeEntryRequirementType(spec) {
+  if (spec.kind === "token") {
+    return new starknet.CairoCustomEnum({
+      token: spec.tokenAddress,
+      extension: void 0
+    });
+  }
+  if (spec.kind === "extension") {
+    return new starknet.CairoCustomEnum({
+      token: void 0,
+      extension: {
+        address: spec.address,
+        config: spec.config
+      }
+    });
+  }
+  throw new Error(
+    `Unsupported entry requirement kind: ${spec.kind}`
+  );
+}
+function scaleWeight(client) {
+  return Math.round(client * 10);
+}
+function encodeDistribution(d) {
+  if (d.kind === "linear") {
+    return new starknet.CairoCustomEnum({
+      Linear: scaleWeight(d.weight),
+      Exponential: void 0,
+      Uniform: void 0,
+      Custom: void 0
+    });
+  }
+  if (d.kind === "exponential") {
+    return new starknet.CairoCustomEnum({
+      Linear: void 0,
+      Exponential: scaleWeight(d.weight),
+      Uniform: void 0,
+      Custom: void 0
+    });
+  }
+  return new starknet.CairoCustomEnum({
+    Linear: void 0,
+    Exponential: void 0,
+    Uniform: {},
+    Custom: void 0
+  });
+}
+function pushRewardTypeFelts(out, reward) {
+  switch (reward.kind) {
+    case "prize_single":
+      out.push("0x0", "0x0", "0x0", starknet.num.toHex(reward.prizeId));
+      return;
+    case "prize_distributed":
+      out.push(
+        "0x0",
+        "0x0",
+        "0x1",
+        starknet.num.toHex(reward.prizeId),
+        starknet.num.toHex(reward.payoutPosition)
+      );
+      return;
+    case "prize_extension":
+      out.push("0x0", "0x1", starknet.num.toHex(reward.prizeId));
+      if (reward.tokenId !== void 0) {
+        out.push("0x0", reward.tokenId);
+      } else {
+        out.push("0x1");
+      }
+      out.push(
+        starknet.num.toHex(reward.payoutParams.length),
+        ...reward.payoutParams.map((p) => starknet.num.toHex(p))
+      );
+      return;
+    case "entry_fee_position":
+      out.push("0x1", "0x0", "0x0", starknet.num.toHex(reward.position));
+      return;
+    case "entry_fee_tournament_creator":
+      out.push("0x1", "0x0", "0x1");
+      return;
+    case "entry_fee_game_creator":
+      out.push("0x1", "0x0", "0x2");
+      return;
+    case "entry_fee_refund":
+      out.push("0x1", "0x0", "0x3", starknet.num.toHex(reward.tokenId));
+      return;
+    case "entry_fee_extension": {
+      out.push("0x1", "0x1");
+      if (reward.tokenId !== void 0) {
+        out.push("0x0", reward.tokenId);
+      } else {
+        out.push("0x1");
+      }
+      out.push(
+        starknet.num.toHex(reward.claimParams.length),
+        ...reward.claimParams.map((p) => starknet.num.toHex(p))
+      );
+      return;
+    }
+  }
+}
+var TOURNAMENT_CREATED_SELECTOR = starknet.hash.getSelectorFromName(
+  "TournamentCreated"
+);
+function parseTournamentIdFromReceipt(receipt, budokanAddress) {
+  const normalise = (addr) => addr.toLowerCase().replace(/^0x0*/, "0x");
+  const normContract = normalise(budokanAddress);
+  const createdSelector = BigInt(TOURNAMENT_CREATED_SELECTOR);
+  for (const event of receipt.events ?? []) {
+    if (!event.from_address || !event.keys || event.keys.length < 2) continue;
+    if (normalise(event.from_address) !== normContract) continue;
+    if (BigInt(event.keys[0]) !== createdSelector) continue;
+    return BigInt(event.keys[1]);
+  }
+  return void 0;
+}
+function felt252FromShortString(s) {
+  if (s.length > 31)
+    throw new Error(`String too long for felt252: ${s.length} bytes`);
+  let value = 0n;
+  for (const char of s) {
+    const code = char.charCodeAt(0);
+    if (code > 127) throw new Error("Felt252 short strings must be ASCII");
+    value = value << 8n | BigInt(code);
+  }
+  return "0x" + value.toString(16);
+}
+function sdkChainId(chain) {
+  return chain === "mainnet" ? "SN_MAIN" : "SN_SEPOLIA";
+}
+function extensionAddressFor(chain, kind) {
+  const table = metagameSdk.getExtensionAddresses(sdkChainId(chain));
+  switch (kind) {
+    case "merkle":
+      if (!table.merkleValidator)
+        throw new Error(`No merkleValidator address for ${chain}`);
+      return table.merkleValidator;
+    case "erc20Balance":
+      if (!table.erc20BalanceValidator)
+        throw new Error(`No erc20BalanceValidator address for ${chain}`);
+      return table.erc20BalanceValidator;
+    case "opusTroves":
+      if (!table.opusTrovesValidator)
+        throw new Error(`No opusTrovesValidator address for ${chain}`);
+      return table.opusTrovesValidator;
+    case "tournament":
+      if (!table.tournamentValidator)
+        throw new Error(`No tournamentValidator address for ${chain}`);
+      return table.tournamentValidator;
+  }
+}
+var U256_MAX = (1n << 256n) - 1n;
+function u256ToLowHigh(value) {
+  if (value < 0n) throw new Error("u256 cannot be negative");
+  if (value > U256_MAX)
+    throw new Error(`Value exceeds u256 max: ${value.toString()}`);
+  const MASK = (1n << 128n) - 1n;
+  return [(value & MASK).toString(), (value >> 128n).toString()];
+}
+function buildErc20BalanceConfig(cfg) {
+  const [minLo, minHi] = u256ToLowHigh(cfg.minThreshold);
+  const [maxLo, maxHi] = u256ToLowHigh(cfg.maxThreshold);
+  const [vpeLo, vpeHi] = u256ToLowHigh(cfg.valuePerEntry);
+  return [
+    cfg.tokenAddress,
+    minLo,
+    minHi,
+    maxLo,
+    maxHi,
+    vpeLo,
+    vpeHi,
+    String(cfg.maxEntries),
+    cfg.bannable ? "1" : "0"
+  ];
+}
+function buildOpusTrovesConfig(cfg) {
+  return [
+    String(cfg.assetAddresses.length),
+    ...cfg.assetAddresses,
+    cfg.threshold.toString(),
+    cfg.valuePerEntry.toString(),
+    String(cfg.maxEntries),
+    cfg.bannable ? "1" : "0"
+  ];
+}
+function buildMerkleConfig(cfg) {
+  return [String(cfg.treeId)];
+}
+function buildTournamentValidatorConfig(cfg) {
+  const qualifierType = cfg.requirement === "won" ? "1" : "0";
+  const qualifyingMode = String(cfg.qualifyingMode ?? 0);
+  const topPositions = cfg.requirement === "won" ? String(cfg.topPositions) : "0";
+  return [qualifierType, qualifyingMode, topPositions, ...cfg.tournamentIds];
+}
+
 exports.BudokanApiError = BudokanApiError;
 exports.BudokanClient = BudokanClient;
 exports.BudokanConnectionError = BudokanConnectionError;
@@ -4722,10 +5875,26 @@ exports.DataSourceError = DataSourceError;
 exports.RpcError = RpcError;
 exports.TournamentNotFoundError = TournamentNotFoundError;
 exports.WSManager = WSManager;
+exports.buildAddPrizeCall = buildAddPrizeCall;
+exports.buildClaimRewardCall = buildClaimRewardCall;
+exports.buildCreateTournamentCall = buildCreateTournamentCall;
+exports.buildEnterTournamentCall = buildEnterTournamentCall;
+exports.buildErc20ApproveCall = buildErc20ApproveCall;
+exports.buildErc20BalanceConfig = buildErc20BalanceConfig;
+exports.buildMerkleConfig = buildMerkleConfig;
+exports.buildOpusTrovesConfig = buildOpusTrovesConfig;
+exports.buildSubmitScoreCall = buildSubmitScoreCall;
+exports.buildTournamentValidatorConfig = buildTournamentValidatorConfig;
 exports.camelToSnake = camelToSnake;
 exports.createBudokanClient = createBudokanClient;
+exports.explorerAddressUrl = explorerAddressUrl;
+exports.explorerBaseUrl = explorerBaseUrl;
+exports.explorerTxUrl = explorerTxUrl;
+exports.extensionAddressFor = extensionAddressFor;
+exports.findWhitelistedGame = findWhitelistedGame;
 exports.getActivityStats = getActivityStats;
 exports.getChainConfig = getChainConfig;
+exports.getGameDefaults = getGameDefaults;
 exports.getGameStats = getGameStats;
 exports.getGameTournaments = getGameTournaments;
 exports.getPrizeStats = getPrizeStats;
@@ -4737,8 +5906,13 @@ exports.getTournamentRegistrations = getTournamentRegistrations;
 exports.getTournamentRewardClaims = getTournamentRewardClaims;
 exports.getTournamentRewardClaimsSummary = getTournamentRewardClaimsSummary;
 exports.getTournaments = getTournaments;
+exports.getWhitelistedGames = getWhitelistedGames;
+exports.isGameWhitelisted = isGameWhitelisted;
 exports.normalizeAddress = normalizeAddress;
+exports.parseTournamentIdFromReceipt = parseTournamentIdFromReceipt;
 exports.snakeToCamel = snakeToCamel;
+exports.tournamentPageUrl = tournamentPageUrl;
+exports.u256ToLowHigh = u256ToLowHigh;
 exports.withRetry = withRetry;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map