@block52/poker-vm-sdk 1.2.6 → 1.2.8

package/dist/index.js

@@ -55937,6 +55937,9 @@ exports.NonPlayerActionType = void 0;
     NonPlayerActionType["LEAVE"] = "leave";
     NonPlayerActionType["NEW_HAND"] = "new-hand";
     NonPlayerActionType["SIT_IN"] = "sit-in";
+    // Sit in and wait for the big blind — distinct action from SIT_IN (post now)
+    // so each has a single responsibility. Sets WAITING_FOR_BIG_BLIND. (#2139)
+    NonPlayerActionType["SIT_IN_AND_WAIT"] = "sit-in-and-wait";
     NonPlayerActionType["SIT_OUT"] = "sit-out";
     NonPlayerActionType["TOP_UP"] = "top-up";
 })(exports.NonPlayerActionType || (exports.NonPlayerActionType = {}));
@@ -55975,6 +55978,11 @@ exports.PlayerStatus = void 0;
     PlayerStatus["SEATED"] = "seated";
     PlayerStatus["SITTING_OUT"] = "sitting-out";
     PlayerStatus["SITTING_IN"] = "sitting-in";
+    // Joined/returning player who opted to wait for the big blind. Held across
+    // hands as a non-playing status (like SITTING_IN) until the button rotates
+    // the BB onto their seat, at which point reInit() activates them and they
+    // post the big blind via the normal ante flow. (#2139)
+    PlayerStatus["WAITING_FOR_BIG_BLIND"] = "waiting-for-big-blind";
     PlayerStatus["SHOWING"] = "showing";
 })(exports.PlayerStatus || (exports.PlayerStatus = {}));
 const SIT_IN_METHOD_NEXT_BB = "next-bb";
@@ -56430,10 +56438,10 @@ class PokerSolver {
         const isFlush = suitCounts.size === 1;
         const isStraight = this.isStraight(sortedCards);
         const isLowStraight = this.isLowStraight(sortedCards); // A-2-3-4-5
-        // Check for straight flush and royal flush
-        if (isFlush && isStraight) {
-            const highRank = this.getHighRank(sortedCards[0].rank);
-            if (highRank === 14 && this.getHighRank(sortedCards[1].rank) === 13) {
+        // Check for straight flush and royal flush (including the wheel A-2-3-4-5)
+        if (isFlush && (isStraight || isLowStraight)) {
+            // Royal flush is the high-ace straight only (A-K-Q-J-T), never the wheel
+            if (isStraight && this.getHighRank(sortedCards[0].rank) === 14 && this.getHighRank(sortedCards[1].rank) === 13) {
                 return {
                     handType: exports.HandType.ROYAL_FLUSH,
                     bestHand: sortedCards,
@@ -56591,7 +56599,8 @@ class PokerSolver {
     }
     /**
      * Evaluate preflop hand (2 hole cards only)
-     * Returns descriptive hand names like "Pocket Aces", "Suited Connectors"
+     * Returns descriptive hand names like "Pocket Aces" for pairs, or a simple
+     * "X high" description (e.g. "6 high") for everything else
      */
     static evaluatePreflopHand(cards) {
         if (cards.length !== 2) {
@@ -56603,8 +56612,6 @@ class PokerSolver {
         const highRank = Math.max(rank1, rank2);
         const lowRank = Math.min(rank1, rank2);
         const isPair = rank1 === rank2;
-        const isSuited = card1.suit === card2.suit;
-        const gap = highRank - lowRank;
         let description;
         let handType;
         if (isPair) {
@@ -56613,25 +56620,8 @@ class PokerSolver {
             description = `Pocket ${rankName}s`;
             handType = exports.HandType.PAIR;
         }
-        else if (isSuited) {
-            if (gap === 1) {
-                description = `${this.formatRank(highRank)} - ${this.formatRank(lowRank)} Suited Connectors`;
-            }
-            else if (gap === 2) {
-                description = `${this.formatRank(highRank)} - ${this.formatRank(lowRank)} Suited One-Gapper`;
-            }
-            else {
-                description = `${this.formatRank(highRank)} - ${this.formatRank(lowRank)} Suited`;
-            }
-            handType = exports.HandType.HIGH_CARD;
-        }
         else {
-            if (gap === 1) {
-                description = `${this.formatRank(highRank)} - ${this.formatRank(lowRank)} Connectors`;
-            }
-            else {
-                description = `${this.formatRank(highRank)} - ${this.formatRank(lowRank)} Offsuit`;
-            }
+            description = `${this.formatRank(highRank)} high`;
             handType = exports.HandType.HIGH_CARD;
         }
         // Sort cards by rank for bestHand
@@ -60825,6 +60815,25 @@ class SigningCosmosClient extends CosmosClient {
      * Create a new poker game
      */
     async createGame(gameFormat, gameVariant, minPlayers, maxPlayers, minBuyInB52USDC, maxBuyInB52USDC, smallBlindB52USDC, bigBlindB52USDC, timeout, rakeConfig, sngConfig) {
+        // 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
+        // defaulting (Long.UZERO / 0) — a zero startingStack makes the prize pool
+        // zero (PayoutManager.totalPrizePool = startingStack * runners) and pays
+        // the winner $0; a zero blindLevelDuration breaks blind escalation.
+        // No defaults — fail loud at creation (Commandment #7). (#2282)
+        const isSng = gameFormat === exports.GameFormat.SIT_AND_GO || gameFormat === exports.GameFormat.TOURNAMENT;
+        if (isSng) {
+            if (!sngConfig) {
+                throw new Error(`${gameFormat} games require an sngConfig (startingStack + blindLevelDuration).`);
+            }
+            if (sngConfig.startingStack <= 0n) {
+                throw new Error(`${gameFormat} games require a positive startingStack; got ${sngConfig.startingStack}.`);
+            }
+            if (!sngConfig.blindLevelDuration || sngConfig.blindLevelDuration <= 0) {
+                throw new Error(`${gameFormat} games require a positive blindLevelDuration; got ${sngConfig.blindLevelDuration}.`);
+            }
+        }
         await this.initializeSigningClient();
         if (!this.signingClient || !this.wallet) {
             throw new Error("Signing client not initialized");
@@ -61188,6 +61197,94 @@ class SigningCosmosClient extends CosmosClient {
         const base64 = encoding.toBase64(txExports.TxRaw.encode(txRaw).finish());
         return { base64, sequence: explicit.sequence, accountNumber: explicit.accountNumber };
     }
+    /**
+     * Resolves the signer data (account number + sequence + chain id) for a
+     * sign-only message: uses the caller-supplied data when present (the
+     * gateway settlement path tracks sequence locally so optimistic actions
+     * don't query the stale committed value), else queries the account once.
+     */
+    async resolveSignerData(player, signerData) {
+        if (signerData) {
+            return signerData;
+        }
+        const accountInfo = await this.getAccount(player);
+        return {
+            accountNumber: Number(accountInfo.account.account_number),
+            sequence: Number(accountInfo.account.sequence),
+            chainId: this.config.chainId
+        };
+    }
+    /**
+     * Signs a single cosmos message (no broadcast) and returns the base64 TxRaw
+     * plus the signer data used — the sign-only primitive the money-mover
+     * helpers below share with signPerformAction's gateway-settlement pattern.
+     */
+    async signMsgOnly(msg, memo, signerData) {
+        await this.initializeSigningClient();
+        if (!this.signingClient || !this.wallet) {
+            throw new Error("Signing client not initialized");
+        }
+        const [account] = await this.wallet.getAccounts();
+        const player = account.address;
+        const explicit = await this.resolveSignerData(player, signerData);
+        const txRaw = await this.signingClient.sign(player, [msg], gaslessFee(), memo, explicit);
+        const base64 = encoding.toBase64(txExports.TxRaw.encode(txRaw).finish());
+        return { base64, sequence: explicit.sequence, accountNumber: explicit.accountNumber };
+    }
+    /**
+     * Sign-only MsgJoinGame: builds and signs the player's buy-in tx WITHOUT
+     * broadcasting, returning the base64 TxRaw for the gateway to relay
+     * (WS-first money-mover settlement, block52/poker-vm#2325). The player is
+     * the signer — the gateway never moves funds on their behalf. Mirrors
+     * joinGame()'s message shape and signPerformAction()'s sign-only return.
+     */
+    async signJoinGame(gameId, seat, buyInAmount, signerData) {
+        await this.initializeSigningClient();
+        const [account] = await this.wallet.getAccounts();
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgJoinGame",
+            value: {
+                player: account.address,
+                gameId,
+                seat: Long.fromNumber(seat, true),
+                buyInAmount: Long.fromString(buyInAmount.toString(), true)
+            }
+        };
+        return this.signMsgOnly(msg, "Join poker game (relay)", signerData);
+    }
+    /**
+     * Sign-only MsgLeaveGame (no broadcast) — the chain decides the refund
+     * from its own state; the message carries only {creator, gameId}. (#2325)
+     */
+    async signLeaveGame(gameId, signerData) {
+        await this.initializeSigningClient();
+        const [account] = await this.wallet.getAccounts();
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgLeaveGame",
+            value: {
+                creator: account.address,
+                gameId
+            }
+        };
+        return this.signMsgOnly(msg, "Leave poker game (relay)", signerData);
+    }
+    /**
+     * Sign-only MsgTopUp (no broadcast) — escrow deposit added to the player's
+     * stack; gateway relays it after PVM-verifying the optimistic apply. (#2325)
+     */
+    async signTopUp(gameId, amount, signerData) {
+        await this.initializeSigningClient();
+        const [account] = await this.wallet.getAccounts();
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgTopUp",
+            value: {
+                player: account.address,
+                gameId,
+                amount: Long.fromString(amount.toString(), true)
+            }
+        };
+        return this.signMsgOnly(msg, "Top up poker stack (relay)", signerData);
+    }
     /**
      * Top up a player's stack at a table
      * The player must be seated at the table and have sufficient wallet balance.