@block52/poker-vm-sdk 1.5.1 → 1.7.0

package/dist/index.js

@@ -2847,6 +2847,7 @@ function createBaseMsgCreateGame() {
         gameVariant: "",
         entryFee: Long.UZERO,
         name: "",
+        bettingLimit: "",
     };
 }
 const MsgCreateGame = {
@@ -2905,6 +2906,9 @@ const MsgCreateGame = {
         if (message.name !== "") {
             writer.uint32(154).string(message.name);
         }
+        if (message.bettingLimit !== "") {
+            writer.uint32(162).string(message.bettingLimit);
+        }
         return writer;
     },
     decode(input, length) {
@@ -3040,6 +3044,13 @@ const MsgCreateGame = {
                     message.name = reader.string();
                     continue;
                 }
+                case 20: {
+                    if (tag !== 162) {
+                        break;
+                    }
+                    message.bettingLimit = reader.string();
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -3068,6 +3079,7 @@ const MsgCreateGame = {
             gameVariant: isSet$2b(object.gameVariant) ? globalThis.String(object.gameVariant) : "",
             entryFee: isSet$2b(object.entryFee) ? Long.fromValue(object.entryFee) : Long.UZERO,
             name: isSet$2b(object.name) ? globalThis.String(object.name) : "",
+            bettingLimit: isSet$2b(object.bettingLimit) ? globalThis.String(object.bettingLimit) : "",
         };
     },
     toJSON(message) {
@@ -3126,6 +3138,9 @@ const MsgCreateGame = {
         if (message.name !== "") {
             obj.name = message.name;
         }
+        if (message.bettingLimit !== "") {
+            obj.bettingLimit = message.bettingLimit;
+        }
         return obj;
     },
     create(base) {
@@ -3170,6 +3185,7 @@ const MsgCreateGame = {
         message.blindLevelDuration = object.blindLevelDuration ?? 0;
         message.gameVariant = object.gameVariant ?? "";
         message.name = object.name ?? "";
+        message.bettingLimit = object.bettingLimit ?? "";
         message.entryFee = (object.entryFee !== undefined && object.entryFee !== null)
             ? Long.fromValue(object.entryFee)
             : Long.UZERO;
@@ -56097,6 +56113,17 @@ exports.GameVariant = void 0;
     GameVariant["TEXAS_HOLDEM"] = "texas-holdem";
     GameVariant["OMAHA"] = "omaha";
 })(exports.GameVariant || (exports.GameVariant = {}));
+/**
+ * BettingLimit — the table's betting structure. Orthogonal to GameVariant: any
+ * variant can be played at any limit (pot-limit Omaha, pot-limit Hold'em,
+ * fixed-limit Hold'em, …). Absent on GameOptions ⇒ no-limit (current behavior).
+ */
+exports.BettingLimit = void 0;
+(function (BettingLimit) {
+    BettingLimit["NO_LIMIT"] = "no-limit";
+    BettingLimit["POT_LIMIT"] = "pot-limit";
+    BettingLimit["FIXED_LIMIT"] = "fixed-limit";
+})(exports.BettingLimit || (exports.BettingLimit = {}));
 exports.GameStatus = void 0;
 (function (GameStatus) {
     GameStatus["WAITING_FOR_PLAYERS"] = "waiting-for-players";
@@ -56468,6 +56495,30 @@ const parseGameVariant = (value) => {
             return "unknown";
     }
 };
+/**
+ * The betting structure a table plays. The engine treats an absent
+ * `gameOptions.bettingLimit` as no-limit (poker-vm#2652), so this mirrors that
+ * rule rather than inventing a default (block52/pokerchain#407).
+ *
+ * @param options - the table's gameOptions (or anything carrying bettingLimit)
+ * @returns the table's BettingLimit
+ */
+const getBettingLimit = (options) => {
+    return options?.bettingLimit ?? exports.BettingLimit.NO_LIMIT;
+};
+/**
+ * Check whether a table is pot-limit (its max bet or raise is the pot cap).
+ */
+const isPotLimit = (options) => {
+    return getBettingLimit(options) === exports.BettingLimit.POT_LIMIT;
+};
+/**
+ * How many hole cards a variant deals each player: 4 for Omaha, 2 for Texas
+ * Hold'em. Mirrors the engine's HoleCardsPerPlayer (poker-vm#2650).
+ */
+const holeCardsPerPlayer = (variant) => {
+    return variant === exports.GameVariant.OMAHA ? 4 : 2;
+};
 
 /**
  * Check if a specific action is available in the legal actions list.
@@ -56723,6 +56774,41 @@ class PokerSolver {
         }
         return bestHand;
     }
+    /**
+     * Find the best Omaha hand: EXACTLY 2 of the 4 hole cards and EXACTLY 3 of
+     * the 5 board cards — C(4,2) x C(5,3) = 60 candidates, ranked like Hold'em.
+     * Mirrors the engine's FindBestOmahaHand (poker-vm#2650).
+     */
+    static findBestOmahaHand(holeCards, communityCards) {
+        if (holeCards.length !== 4) {
+            throw new Error("Omaha requires exactly 4 hole cards");
+        }
+        if (communityCards.length !== 5) {
+            throw new Error("Omaha requires exactly 5 community cards");
+        }
+        let bestHand = null;
+        for (const pair of this.getCombinationsFlexible(holeCards, 2)) {
+            for (const triple of this.getCombinationsFlexible(communityCards, 3)) {
+                const evaluation = this.evaluateHand([...pair, ...triple]);
+                if (!bestHand || this.compareHands(evaluation, bestHand) > 0) {
+                    bestHand = evaluation;
+                }
+            }
+        }
+        if (!bestHand) {
+            throw new Error("Failed to evaluate hand");
+        }
+        return bestHand;
+    }
+    /**
+     * Best hand for a variant from hole cards and a full 5-card board.
+     */
+    static bestHandForVariant(variant, holeCards, communityCards) {
+        if (variant === exports.GameVariant.OMAHA) {
+            return this.findBestOmahaHand(holeCards, communityCards);
+        }
+        return this.findBestHand([...holeCards, ...communityCards]);
+    }
     /**
      * Evaluate a hand with any number of cards (2-7)
      * This is useful for showing hand strength during all betting rounds
@@ -57117,12 +57203,14 @@ class PokerSolver {
     }
     /**
      * Calculate win percentages for multiple players (2+) using Monte Carlo simulation
-     * @param hands Array of hole cards for each player (each must have exactly 2 cards)
+     * @param hands Array of hole cards for each player (2 each for Hold'em, 4 for Omaha)
      * @param communityCards Current community cards (0-5 cards)
      * @param simulations Number of simulations to run (default: 10000)
+     * @param variant The table's variant; omitted = Texas Hold'em. Omaha hands are
+     *   scored with the two-plus-three rule (ui#769).
      * @returns Object containing win percentages for each player and overall tie percentage
      */
-    static calculateMultiPlayerEquity(hands, communityCards = [], simulations = 10000) {
+    static calculateMultiPlayerEquity(hands, communityCards = [], simulations = 10000, variant) {
         // Validate inputs
         if (hands.length < 2) {
             throw new Error("Need at least 2 hands to calculate equity");
@@ -57130,9 +57218,10 @@ class PokerSolver {
         if (hands.length > 10) {
             throw new Error("Maximum 10 hands supported");
         }
+        const holeCount = holeCardsPerPlayer(variant);
         for (let i = 0; i < hands.length; i++) {
-            if (hands[i].length !== 2) {
-                throw new Error(`Hand ${i} must have exactly 2 cards`);
+            if (hands[i].length !== holeCount) {
+                throw new Error(`Hand ${i} must have exactly ${holeCount} cards`);
             }
         }
         if (communityCards.length > 5) {
@@ -57159,10 +57248,7 @@ class PokerSolver {
             // Deal remaining community cards
             const fullCommunityCards = [...communityCards, ...shuffledDeck.slice(0, cardsNeeded)];
             // Evaluate all hands
-            const evaluations = hands.map(hand => {
-                const fullHand = [...hand, ...fullCommunityCards];
-                return this.findBestHand(fullHand);
-            });
+            const evaluations = hands.map(hand => this.bestHandForVariant(variant, hand, fullCommunityCards));
             // Find winners using existing findWinners method
             const winnerIndices = this.findWinners(evaluations);
             // Update win counters
@@ -71025,9 +71111,14 @@ class SigningCosmosClient extends CosmosClient {
         return this.sendTokens(fromAddress, toAddress, amount, undefined, memo);
     }
     /**
-     * Create a new poker game
+     * Create a new poker game.
+     *
+     * `bettingLimit` is the table's betting structure (block52/pokerchain#407).
+     * Omit it for the variant's default: pot-limit for omaha (PLO), no-limit for
+     * texas-holdem. Omitted, the field is not encoded at all, so a chain without
+     * it accepts the tx unchanged. Fixed-limit is not playable yet (poker-vm#2654).
      */
-    async createGame(gameFormat, gameVariant, minPlayers, maxPlayers, minBuyInB52USDC, maxBuyInB52USDC, smallBlindB52USDC, bigBlindB52USDC, timeout, rakeConfig, sngConfig, name) {
+    async createGame(gameFormat, gameVariant, minPlayers, maxPlayers, minBuyInB52USDC, maxBuyInB52USDC, smallBlindB52USDC, bigBlindB52USDC, timeout, rakeConfig, sngConfig, name, bettingLimit) {
         // Validate SNG/Tournament config BEFORE any network work — fail fast.
         // SNG/Tournament games are DEFINED by startingStack + blindLevelDuration.
         // Refuse to create one with missing/zero values rather than silently
@@ -71047,6 +71138,7 @@ class SigningCosmosClient extends CosmosClient {
                 throw new Error(`${gameFormat} games require a positive blindLevelDuration; got ${sngConfig.blindLevelDuration}.`);
             }
         }
+        assertCreatableBettingLimit(bettingLimit);
         await this.initializeSigningClient();
         if (!this.signingClient || !this.wallet) {
             throw new Error("Signing client not initialized");
@@ -71079,6 +71171,9 @@ class SigningCosmosClient extends CosmosClient {
             // Optional ENS-style table name (block52/pokerchain#337). Empty = unnamed
             // (no fee); a non-empty name costs $0.10/char and must be globally unique.
             name: name ?? "",
+            // Betting structure (block52/pokerchain#407). "" = the variant's default
+            // on chain, and an empty proto3 string is not encoded at all.
+            bettingLimit: bettingLimit ?? "",
         });
         // Create the transaction message
         const msg = {
@@ -71098,6 +71193,7 @@ class SigningCosmosClient extends CosmosClient {
             smallBlind: smallBlindB52USDC.toString(),
             bigBlind: bigBlindB52USDC.toString(),
             timeout,
+            ...(bettingLimit && { bettingLimit }),
             ...(rakeConfig && {
                 rakeFreeThreshold: rakeConfig.rakeFreeThreshold.toString(),
                 rakePercentage: rakeConfig.rakePercentage,
@@ -71974,6 +72070,21 @@ async function createSigningClientFromMnemonic(config, mnemonic) {
     });
     return createSigningCosmosClient(config, wallet);
 }
+/**
+ * Throws for a betting limit a table cannot be created with (block52/pokerchain#407).
+ * Undefined is allowed: the chain applies the variant's default.
+ */
+function assertCreatableBettingLimit(bettingLimit) {
+    if (bettingLimit === undefined) {
+        return;
+    }
+    if (bettingLimit === exports.BettingLimit.FIXED_LIMIT) {
+        throw new Error("Fixed-limit tables are not available yet (poker-vm#2654).");
+    }
+    if (bettingLimit !== exports.BettingLimit.NO_LIMIT && bettingLimit !== exports.BettingLimit.POT_LIMIT) {
+        throw new Error(`Invalid betting limit: ${bettingLimit}.`);
+    }
+}
 
 // Generated by Ignite ignite.com/cli
 const Client = IgniteClient.plugin([
@@ -72036,6 +72147,7 @@ exports.SigningCosmosClient = SigningCosmosClient;
 exports.TxExecutionError = TxExecutionError;
 exports.ValidatorBond = ValidatorBond;
 exports.WithdrawalRequest = WithdrawalRequest;
+exports.assertCreatableBettingLimit = assertCreatableBettingLimit;
 exports.assertExecuted = assertExecuted;
 exports.buildMsgCreateValidator = buildMsgCreateValidator;
 exports.computeGameNameFee = computeGameNameFee;
@@ -72047,14 +72159,17 @@ exports.formatGameVariantDisplay = formatGameVariantDisplay;
 exports.generateWallet = generateWallet;
 exports.getActionByType = getActionByType;
 exports.getAddressFromMnemonic = getAddressFromMnemonic;
+exports.getBettingLimit = getBettingLimit;
 exports.getDefaultCosmosConfig = getDefaultCosmosConfig;
 exports.getGameFormat = getGameFormat;
 exports.getGameFormatForCosmos = getGameFormatForCosmos;
 exports.getGameFormatFromObject = getGameFormatFromObject;
 exports.getGameVariant = getGameVariant;
 exports.hasAction = hasAction;
+exports.holeCardsPerPlayer = holeCardsPerPlayer;
 exports.isCashFormat = isCashFormat;
 exports.isEmptyAddress = isEmptyAddress;
+exports.isPotLimit = isPotLimit;
 exports.isSitAndGoFormat = isSitAndGoFormat;
 exports.isTournamentFormat = isTournamentFormat;
 exports.isValidMnemonic = isValidMnemonic;