@block52/poker-vm-sdk 1.6.0 → 1.8.0

package/dist/index.d.ts

@@ -44952,6 +44952,14 @@ interface MsgCreateGame {
      * (block52/pokerchain#407)
      */
     bettingLimit: string;
+    /**
+     * Scheduled start for a sit-and-go, unix seconds (field 21). With it,
+     * min_players may be below max_players: the tournament starts when the table
+     * fills or at this time with at least min_players registered, and is
+     * cancelled with refunds if fewer have registered 15 minutes after it.
+     * 0 = unscheduled: starts only when full. (poker-vm#2680)
+     */
+    startTime: Long;
 }
 declare const MsgCreateGame: MessageFns<MsgCreateGame>;
 /** MsgJoinGame defines the MsgJoinGame message. */
@@ -45249,7 +45257,8 @@ declare enum NonPlayerActionType {
     SIT_OUT = "sit-out",
     TIMEOUT = "timeout",
     TIME_BANK = "time-bank",
-    TOP_UP = "top-up"
+    TOP_UP = "top-up",
+    START = "start"
 }
 declare const AllPlayerActions: {
     DEAD_SMALL_BLIND: NonPlayerActionType.DEAD_SMALL_BLIND;
@@ -45265,6 +45274,7 @@ declare const AllPlayerActions: {
     TIMEOUT: NonPlayerActionType.TIMEOUT;
     TIME_BANK: NonPlayerActionType.TIME_BANK;
     TOP_UP: NonPlayerActionType.TOP_UP;
+    START: NonPlayerActionType.START;
     SMALL_BLIND: PlayerActionType.SMALL_BLIND;
     BIG_BLIND: PlayerActionType.BIG_BLIND;
     FOLD: PlayerActionType.FOLD;
@@ -45364,6 +45374,7 @@ type GameOptions = {
     protocolFeeBps?: number;
     blindLevelDuration?: number;
     blindLevel?: number;
+    scheduledStartTime?: number;
     sngStartTime?: number;
     levelStartTime?: number;
     timeBankMs?: number;
@@ -45399,6 +45410,7 @@ type GameOptionsDTO = {
     blindLevel?: number;
     nextSmallBlind?: string;
     nextBigBlind?: string;
+    scheduledStartTime?: number;
     sngStartTime?: number;
     levelStartTime?: number;
     timeBankMs?: number;
@@ -46073,6 +46085,16 @@ declare class PokerSolver {
      * Find the best 5-card hand from 7 cards
      */
     static findBestHand(cards: Card[]): HandEvaluation;
+    /**
+     * 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: Card[], communityCards: Card[]): HandEvaluation;
+    /**
+     * Best hand for a variant from hole cards and a full 5-card board.
+     */
+    private static bestHandForVariant;
     /**
      * Evaluate a hand with any number of cards (2-7)
      * This is useful for showing hand strength during all betting rounds
@@ -46154,12 +46176,14 @@ declare class PokerSolver {
     static calculateWinPercentages(handA: Card[], handB: Card[], communityCards?: Card[], simulations?: number): [number, number, number];
     /**
      * 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: Card[][], communityCards?: Card[], simulations?: number): {
+    static calculateMultiPlayerEquity(hands: Card[][], communityCards?: Card[], simulations?: number, variant?: GameVariant): {
         winPercentages: number[];
         tiePercentage: number;
     };
@@ -46609,6 +46633,7 @@ interface SNGConfig {
     startingStack: bigint;
     blindLevelDuration: number;
     entryFee?: bigint;
+    startTime?: number;
 }
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities

package/dist/index.esm.js

@@ -2846,6 +2846,7 @@ function createBaseMsgCreateGame() {
         entryFee: Long.UZERO,
         name: "",
         bettingLimit: "",
+        startTime: Long.ZERO,
     };
 }
 const MsgCreateGame = {
@@ -2907,6 +2908,9 @@ const MsgCreateGame = {
         if (message.bettingLimit !== "") {
             writer.uint32(162).string(message.bettingLimit);
         }
+        if (!message.startTime.equals(Long.ZERO)) {
+            writer.uint32(168).int64(message.startTime.toString());
+        }
         return writer;
     },
     decode(input, length) {
@@ -3049,6 +3053,13 @@ const MsgCreateGame = {
                     message.bettingLimit = reader.string();
                     continue;
                 }
+                case 21: {
+                    if (tag !== 168) {
+                        break;
+                    }
+                    message.startTime = Long.fromString(reader.int64().toString());
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -3078,6 +3089,7 @@ const MsgCreateGame = {
             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) : "",
+            startTime: isSet$2b(object.startTime) ? Long.fromValue(object.startTime) : Long.ZERO,
         };
     },
     toJSON(message) {
@@ -3139,6 +3151,9 @@ const MsgCreateGame = {
         if (message.bettingLimit !== "") {
             obj.bettingLimit = message.bettingLimit;
         }
+        if (!message.startTime.equals(Long.ZERO)) {
+            obj.startTime = (message.startTime || Long.ZERO).toString();
+        }
         return obj;
     },
     create(base) {
@@ -3184,6 +3199,9 @@ const MsgCreateGame = {
         message.gameVariant = object.gameVariant ?? "";
         message.name = object.name ?? "";
         message.bettingLimit = object.bettingLimit ?? "";
+        message.startTime = (object.startTime !== undefined && object.startTime !== null)
+            ? Long.fromValue(object.startTime)
+            : Long.ZERO;
         message.entryFee = (object.entryFee !== undefined && object.entryFee !== null)
             ? Long.fromValue(object.entryFee)
             : Long.UZERO;
@@ -56091,6 +56109,10 @@ var NonPlayerActionType;
     // current turn. Rejected off-turn, past the deadline, or with no bank left.
     NonPlayerActionType["TIME_BANK"] = "time-bank";
     NonPlayerActionType["TOP_UP"] = "top-up";
+    // Scheduled single-table tournament (poker-vm#2680): any registered player
+    // starts the sit-and-go once gameOptions.scheduledStartTime has passed and
+    // at least minPlayers are seated. Offered in legalActions when it is due.
+    NonPlayerActionType["START"] = "start";
 })(NonPlayerActionType || (NonPlayerActionType = {}));
 const AllPlayerActions = { ...PlayerActionType, ...NonPlayerActionType };
 /**
@@ -56772,6 +56794,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 === 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
@@ -57166,12 +57223,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");
@@ -57179,9 +57238,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) {
@@ -57208,10 +57268,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
@@ -70969,6 +71026,26 @@ function gaslessFee(gasLimit = DEFAULT_GAS_LIMIT) {
         gas: gasLimit.toString()
     };
 }
+/**
+ * Fail fast on a sit-and-go field the chain would refuse (poker-vm#2680):
+ * seats 2..9, min <= max, and a flexible field (min < max) needs a scheduled
+ * start in the future. Mirrors x/poker/keeper/msg_server_create_game.go.
+ */
+function assertCreatableSngField(minPlayers, maxPlayers, sngConfig, nowSeconds = Math.floor(Date.now() / 1000)) {
+    if (maxPlayers < 2 || maxPlayers > 9) {
+        throw new Error(`sit-and-go maxPlayers must be 2..9; got ${maxPlayers}.`);
+    }
+    if (minPlayers < 2 || minPlayers > maxPlayers) {
+        throw new Error(`sit-and-go minPlayers must be 2..maxPlayers (${maxPlayers}); got ${minPlayers}.`);
+    }
+    const startTime = sngConfig?.startTime;
+    if (minPlayers !== maxPlayers && !startTime) {
+        throw new Error("sit-and-go with minPlayers < maxPlayers needs sngConfig.startTime (a scheduled start).");
+    }
+    if (startTime !== undefined && startTime <= nowSeconds) {
+        throw new Error(`sngConfig.startTime ${startTime} must be in the future (now ${nowSeconds}).`);
+    }
+}
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities
  */
@@ -71100,6 +71177,7 @@ class SigningCosmosClient extends CosmosClient {
             if (!sngConfig.blindLevelDuration || sngConfig.blindLevelDuration <= 0) {
                 throw new Error(`${gameFormat} games require a positive blindLevelDuration; got ${sngConfig.blindLevelDuration}.`);
             }
+            assertCreatableSngField(minPlayers, maxPlayers, sngConfig);
         }
         assertCreatableBettingLimit(bettingLimit);
         await this.initializeSigningClient();
@@ -71137,6 +71215,9 @@ class SigningCosmosClient extends CosmosClient {
             // Betting structure (block52/pokerchain#407). "" = the variant's default
             // on chain, and an empty proto3 string is not encoded at all.
             bettingLimit: bettingLimit ?? "",
+            // Scheduled start (poker-vm#2680), unix seconds. 0 = unscheduled, and
+            // a zero proto3 int64 is not encoded at all.
+            startTime: sngConfig?.startTime ? Long.fromNumber(sngConfig.startTime) : Long.ZERO,
         });
         // Create the transaction message
         const msg = {