@block52/poker-vm-sdk 1.2.10 → 1.2.13

package/dist/index.d.ts

@@ -45213,12 +45213,26 @@ declare enum PlayerActionType {
     BET = "bet",
     CALL = "call",
     RAISE = "raise",
+    /**
+     * @deprecated Not a dispatchable action. "All-in" is a UX label — going
+     * all-in is a BET/CALL/RAISE whose amount equals the player's whole stack
+     * (a short shove is an all-in-only RAISE, poker-vm#2353). The engine neither
+     * advertises ALL_IN in getLegalActions nor accepts it via performAction (the
+     * handler was removed, poker-vm#2353) — dispatching it throws.
+     *
+     * This member survives ONLY as the internal *recorded* action type:
+     * baseAction.execute rewrites a full-stack commit to ALL_IN, and round-end
+     * reopening + aggression detection (#2134) read it. Do not dispatch it and do
+     * not add new consumers.
+     *
+     * NOTE: distinct from the still-required `PlayerStatus.ALL_IN` (a player's
+     * state once their chips reach 0), which is NOT deprecated.
+     */
     ALL_IN = "all-in",
     MUCK = "muck",
     SHOW = "show"
 }
 declare enum NonPlayerActionType {
-    CLAIM = "claim",
     DEAD_SMALL_BLIND = "dead-small-blind",
     DEAL = "deal",
     FORCE_CLOSE = "force-close",
@@ -45231,7 +45245,6 @@ declare enum NonPlayerActionType {
     TOP_UP = "top-up"
 }
 declare const AllPlayerActions: {
-    CLAIM: NonPlayerActionType.CLAIM;
     DEAD_SMALL_BLIND: NonPlayerActionType.DEAD_SMALL_BLIND;
     DEAL: NonPlayerActionType.DEAL;
     FORCE_CLOSE: NonPlayerActionType.FORCE_CLOSE;
@@ -45414,6 +45427,15 @@ type ResultDTO = {
     playerId: string;
     payout: string;
 };
+/**
+ * A single place in a tournament (SNG/MTT) prize structure.
+ * This is the PROSPECTIVE payout by finishing place — distinct from ResultDTO,
+ * which records the SETTLED payout for an actual player once they finish.
+ */
+type PayoutPlaceDTO = {
+    place: number;
+    amount: string;
+};
 type TexasHoldemGameState = {
     type: string;
     address: string;
@@ -45457,6 +45479,7 @@ type TexasHoldemStateDTO = {
     legalActions: LegalActionDTO[];
     availableSeats: number[];
     rakeCollected?: string;
+    payouts?: PayoutPlaceDTO[];
     signature: string;
 };
 /**
@@ -46422,6 +46445,16 @@ declare class SigningCosmosClient extends CosmosClient {
      * Leave a poker game
      */
     leaveGame(gameId: string): Promise<string>;
+    /**
+     * Record a hand-end game-state snapshot on the chain (pokerchain#239).
+     *
+     * Signed and broadcast directly by the player who finished the position
+     * being recorded (e.g. the 4th-place finisher pushes the state that records
+     * 4th place), so a finished SNG's results reach the chain and the prize pool
+     * becomes claimable. `gameState` is the hand-end TexasHoldemStateDTO,
+     * JSON-encoded (the canonical shape the chain stores in GameStates).
+     */
+    recordHandEnd(gameId: string, gameState: string): Promise<string>;
     /**
      * Delete a poker game
      * Only the game creator can delete a game, and the game must have no active players
@@ -46868,4 +46901,4 @@ declare const Client: typeof IgniteClient & Constructor<{
 declare const registry: Registry;
 
 export { AllPlayerActions, BLOCK52_HD_PATH, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GameFormat, GameStatus, GameVariant, HandType, KEYS, MissingWalletError, NonPlayerActionType, Params, PlayerActionType, PlayerStatus, PokerGameIntegration, PokerSolver, RPCMethods, SIT_IN_METHOD_NEXT_BB, SIT_IN_METHOD_POST_NOW, SIT_OUT_METHOD_NEXT_BB, SIT_OUT_METHOD_NEXT_HAND, SUIT, SigningCosmosClient, TexasHoldemRound, WithdrawalRequest, createSigningClientFromMnemonic, createWalletFromMnemonic, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, isCashFormat, isEmptyAddress, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry };
-export type { AccountDTO, ActionDTO, Block, BlockDTO, BlockHeader, BlockHeaderDTO, BlockID, BlockResponse, BurnResponseDTO, Card, EquityHand, EquityRequest, EquityResponse, EquityResult, GameListItem, GameOptions, GameOptionsDTO, GameOptionsResponse, GameStateResponse, GameStateResponseDTO, HandEvaluation, ISignedResponse, LegalActionDTO, PerformActionResponse, PlayerDTO, RPCRequest, RPCRequestParams, RPCResponse, RakeConfig, RakeConfigDTO, ResultDTO, SitInMethod, SitOutMethod, TexasHoldemGameState, TexasHoldemStateDTO, TransactionDTO, TransactionResponse, WalletInfo, WinnerDTO, WithdrawResponseDTO };
+export type { AccountDTO, ActionDTO, Block, BlockDTO, BlockHeader, BlockHeaderDTO, BlockID, BlockResponse, BurnResponseDTO, Card, EquityHand, EquityRequest, EquityResponse, EquityResult, GameListItem, GameOptions, GameOptionsDTO, GameOptionsResponse, GameStateResponse, GameStateResponseDTO, HandEvaluation, ISignedResponse, LegalActionDTO, PayoutPlaceDTO, PerformActionResponse, PlayerDTO, RPCRequest, RPCRequestParams, RPCResponse, RakeConfig, RakeConfigDTO, ResultDTO, SitInMethod, SitOutMethod, TexasHoldemGameState, TexasHoldemStateDTO, TransactionDTO, TransactionResponse, WalletInfo, WinnerDTO, WithdrawResponseDTO };

package/dist/index.esm.js

@@ -3324,6 +3324,89 @@ const MsgLeaveGame = {
         return message;
     },
 };
+function createBaseMsgRecordHandEnd() {
+    return { creator: "", gameId: "", gameState: "" };
+}
+const MsgRecordHandEnd = {
+    encode(message, writer = new BinaryWriter()) {
+        if (message.creator !== "") {
+            writer.uint32(10).string(message.creator);
+        }
+        if (message.gameId !== "") {
+            writer.uint32(18).string(message.gameId);
+        }
+        if (message.gameState !== "") {
+            writer.uint32(26).string(message.gameState);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseMsgRecordHandEnd();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.creator = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.gameId = reader.string();
+                    continue;
+                }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.gameState = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            creator: isSet$2b(object.creator) ? globalThis.String(object.creator) : "",
+            gameId: isSet$2b(object.gameId) ? globalThis.String(object.gameId) : "",
+            gameState: isSet$2b(object.gameState) ? globalThis.String(object.gameState) : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.creator !== "") {
+            obj.creator = message.creator;
+        }
+        if (message.gameId !== "") {
+            obj.gameId = message.gameId;
+        }
+        if (message.gameState !== "") {
+            obj.gameState = message.gameState;
+        }
+        return obj;
+    },
+    create(base) {
+        return MsgRecordHandEnd.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseMsgRecordHandEnd();
+        message.creator = object.creator ?? "";
+        message.gameId = object.gameId ?? "";
+        message.gameState = object.gameState ?? "";
+        return message;
+    },
+};
 function createBaseMsgDealCards() {
     return { creator: "", gameId: "" };
 }
@@ -4376,6 +4459,7 @@ const msgTypes$u = [
     ["/pokerchain.poker.v1.MsgCreateGame", MsgCreateGame],
     ["/pokerchain.poker.v1.MsgJoinGame", MsgJoinGame],
     ["/pokerchain.poker.v1.MsgLeaveGame", MsgLeaveGame],
+    ["/pokerchain.poker.v1.MsgRecordHandEnd", MsgRecordHandEnd],
     ["/pokerchain.poker.v1.MsgDealCards", MsgDealCards],
     ["/pokerchain.poker.v1.MsgPerformAction", MsgPerformAction],
     ["/pokerchain.poker.v1.MsgMint", MsgMint],
@@ -55939,17 +56023,27 @@ var PlayerActionType;
     PlayerActionType["BET"] = "bet";
     PlayerActionType["CALL"] = "call";
     PlayerActionType["RAISE"] = "raise";
+    /**
+     * @deprecated Not a dispatchable action. "All-in" is a UX label — going
+     * all-in is a BET/CALL/RAISE whose amount equals the player's whole stack
+     * (a short shove is an all-in-only RAISE, poker-vm#2353). The engine neither
+     * advertises ALL_IN in getLegalActions nor accepts it via performAction (the
+     * handler was removed, poker-vm#2353) — dispatching it throws.
+     *
+     * This member survives ONLY as the internal *recorded* action type:
+     * baseAction.execute rewrites a full-stack commit to ALL_IN, and round-end
+     * reopening + aggression detection (#2134) read it. Do not dispatch it and do
+     * not add new consumers.
+     *
+     * NOTE: distinct from the still-required `PlayerStatus.ALL_IN` (a player's
+     * state once their chips reach 0), which is NOT deprecated.
+     */
     PlayerActionType["ALL_IN"] = "all-in";
     PlayerActionType["MUCK"] = "muck";
     PlayerActionType["SHOW"] = "show";
 })(PlayerActionType || (PlayerActionType = {}));
 var NonPlayerActionType;
 (function (NonPlayerActionType) {
-    // Terminal SNG/Tournament settlement: a decided-tournament finisher claims
-    // their prize-pool payout without leaving the (frozen) roster. Replaces the
-    // post-start LEAVE that used to remove the seat and destabilise the terminal
-    // state (#2318/#2184 root cause). (#2343)
-    NonPlayerActionType["CLAIM"] = "claim";
     NonPlayerActionType["DEAD_SMALL_BLIND"] = "dead-small-blind";
     NonPlayerActionType["DEAL"] = "deal";
     NonPlayerActionType["FORCE_CLOSE"] = "force-close";
@@ -60839,7 +60933,7 @@ class SigningCosmosClient extends CosmosClient {
         // 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
+        // zero (SngPayoutManager.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;
@@ -60991,6 +61085,37 @@ class SigningCosmosClient extends CosmosClient {
             throw error;
         }
     }
+    /**
+     * Record a hand-end game-state snapshot on the chain (pokerchain#239).
+     *
+     * Signed and broadcast directly by the player who finished the position
+     * being recorded (e.g. the 4th-place finisher pushes the state that records
+     * 4th place), so a finished SNG's results reach the chain and the prize pool
+     * becomes claimable. `gameState` is the hand-end TexasHoldemStateDTO,
+     * JSON-encoded (the canonical shape the chain stores in GameStates).
+     */
+    async recordHandEnd(gameId, gameState) {
+        await this.initializeSigningClient();
+        if (!this.signingClient || !this.wallet) {
+            throw new Error("Signing client not initialized");
+        }
+        const [account] = await this.wallet.getAccounts();
+        const creator = account.address;
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgRecordHandEnd",
+            value: { creator, gameId, gameState }
+        };
+        const fee = gaslessFee();
+        const memo = "Record hand end via SDK";
+        try {
+            const result = await this.signingClient.signAndBroadcast(creator, [msg], fee, memo);
+            return result.transactionHash;
+        }
+        catch (error) {
+            console.error("❌ Record hand end failed:", error);
+            throw error;
+        }
+    }
     /**
      * Delete a poker game
      * Only the game creator can delete a game, and the game must have no active players