@block52/poker-vm-sdk 1.2.6 → 1.2.8

package/dist/index.d.ts

@@ -45218,6 +45218,7 @@ declare enum NonPlayerActionType {
     LEAVE = "leave",
     NEW_HAND = "new-hand",
     SIT_IN = "sit-in",
+    SIT_IN_AND_WAIT = "sit-in-and-wait",
     SIT_OUT = "sit-out",
     TOP_UP = "top-up"
 }
@@ -45229,6 +45230,7 @@ declare const AllPlayerActions: {
     LEAVE: NonPlayerActionType.LEAVE;
     NEW_HAND: NonPlayerActionType.NEW_HAND;
     SIT_IN: NonPlayerActionType.SIT_IN;
+    SIT_IN_AND_WAIT: NonPlayerActionType.SIT_IN_AND_WAIT;
     SIT_OUT: NonPlayerActionType.SIT_OUT;
     TOP_UP: NonPlayerActionType.TOP_UP;
     SMALL_BLIND: PlayerActionType.SMALL_BLIND;
@@ -45272,6 +45274,7 @@ declare enum PlayerStatus {
     SEATED = "seated",
     SITTING_OUT = "sitting-out",
     SITTING_IN = "sitting-in",
+    WAITING_FOR_BIG_BLIND = "waiting-for-big-blind",
     SHOWING = "showing"
 }
 type SitInMethod = "next-bb" | "post-now";
@@ -45974,7 +45977,8 @@ declare class PokerSolver {
     static evaluatePartialHand(cards: Card[]): HandEvaluation;
     /**
      * 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
      */
     private static evaluatePreflopHand;
     /**
@@ -46371,7 +46375,7 @@ interface RakeConfig {
  */
 interface SNGConfig {
     startingStack: bigint;
-    blindLevelDuration?: number;
+    blindLevelDuration: number;
 }
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities
@@ -46483,6 +46487,49 @@ declare class SigningCosmosClient extends CosmosClient {
         sequence: number;
         accountNumber: number;
     }>;
+    /**
+     * 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.
+     */
+    private resolveSignerData;
+    /**
+     * 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.
+     */
+    private signMsgOnly;
+    /**
+     * 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.
+     */
+    signJoinGame(gameId: string, seat: number, buyInAmount: bigint, signerData?: SignerData): Promise<{
+        base64: string;
+        sequence: number;
+        accountNumber: number;
+    }>;
+    /**
+     * Sign-only MsgLeaveGame (no broadcast) — the chain decides the refund
+     * from its own state; the message carries only {creator, gameId}. (#2325)
+     */
+    signLeaveGame(gameId: string, signerData?: SignerData): Promise<{
+        base64: string;
+        sequence: number;
+        accountNumber: number;
+    }>;
+    /**
+     * Sign-only MsgTopUp (no broadcast) — escrow deposit added to the player's
+     * stack; gateway relays it after PVM-verifying the optimistic apply. (#2325)
+     */
+    signTopUp(gameId: string, amount: bigint, signerData?: SignerData): Promise<{
+        base64: string;
+        sequence: number;
+        accountNumber: number;
+    }>;
     /**
      * Top up a player's stack at a table
      * The player must be seated at the table and have sufficient wallet balance.

package/dist/index.esm.js

@@ -55935,6 +55935,9 @@ var NonPlayerActionType;
     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";
 })(NonPlayerActionType || (NonPlayerActionType = {}));
@@ -55973,6 +55976,11 @@ var PlayerStatus;
     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";
 })(PlayerStatus || (PlayerStatus = {}));
 const SIT_IN_METHOD_NEXT_BB = "next-bb";
@@ -56428,10 +56436,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: HandType.ROYAL_FLUSH,
                     bestHand: sortedCards,
@@ -56589,7 +56597,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) {
@@ -56601,8 +56610,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) {
@@ -56611,25 +56618,8 @@ class PokerSolver {
             description = `Pocket ${rankName}s`;
             handType = 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 = 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 = HandType.HIGH_CARD;
         }
         // Sort cards by rank for bestHand
@@ -60823,6 +60813,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 === GameFormat.SIT_AND_GO || gameFormat === 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");
@@ -61186,6 +61195,94 @@ class SigningCosmosClient extends CosmosClient {
         const base64 = 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 = 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.