@block52/poker-vm-sdk 1.7.0 → 1.10.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,10 @@ declare enum NonPlayerActionType {
     SIT_OUT = "sit-out",
     TIMEOUT = "timeout",
     TIME_BANK = "time-bank",
-    TOP_UP = "top-up"
+    TOP_UP = "top-up",
+    START = "start",
+    REVEAL_BOARD = "reveal-board",
+    REVEAL_DEAL = "reveal-deal"
 }
 declare const AllPlayerActions: {
     DEAD_SMALL_BLIND: NonPlayerActionType.DEAD_SMALL_BLIND;
@@ -45265,6 +45276,9 @@ declare const AllPlayerActions: {
     TIMEOUT: NonPlayerActionType.TIMEOUT;
     TIME_BANK: NonPlayerActionType.TIME_BANK;
     TOP_UP: NonPlayerActionType.TOP_UP;
+    START: NonPlayerActionType.START;
+    REVEAL_BOARD: NonPlayerActionType.REVEAL_BOARD;
+    REVEAL_DEAL: NonPlayerActionType.REVEAL_DEAL;
     SMALL_BLIND: PlayerActionType.SMALL_BLIND;
     BIG_BLIND: PlayerActionType.BIG_BLIND;
     FOLD: PlayerActionType.FOLD;
@@ -45344,6 +45358,93 @@ type RakeConfigDTO = {
     rakeCap: string;
     owner?: string;
 };
+/**
+ * Blind structures (poker-vm#1734 via #2613 slice 2). A sit-and-go whose
+ * `gameOptions.blindStructure` is set takes its blinds, big-blind ante and
+ * level durations from the structure; absent, the blinds double every
+ * `blindLevelDuration` minutes as before. The engine derives every level from
+ * the structure with integer arithmetic (never from a persisted, escalated
+ * blind) and re-emits the current level as `smallBlind` / `bigBlind` /
+ * `nextSmallBlind` / `nextBigBlind` / `blindLevelDuration` / `ante`, so
+ * readers of those fields are unchanged. Amounts are chip-unit strings
+ * (Commandment 9). Mirrors pvm/go/engine/tournament.go field for field.
+ */
+type BlindPreset = "turbo" | "standard" | "deep_stack" | "hyper_turbo";
+declare const BLIND_PRESETS: readonly BlindPreset[];
+type BlindProgression = "double" | "linear" | "percentage" | "table";
+declare const BLIND_PROGRESSIONS: readonly BlindProgression[];
+/**
+ * The algorithmic ante rule: from `startLevel` (0-based) on, the big-blind
+ * ante is floor(bigBlind × bps / 10000). `bps: 10000` is the WSOP
+ * ante-equals-big-blind structure; #1734's "10% from level 4" is
+ * `{ startLevel: 4, bps: 1000 }`.
+ */
+type AnteRuleDTO = {
+    startLevel: number;
+    bps: number;
+};
+/**
+ * One blind level: a table-mode row as authored, and what the engine derives
+ * for any level of any progression. `level` is 0-based. A break level deals no
+ * hands; breaks need a tournament director, so a sit-and-go rejects them.
+ */
+type BlindLevelDTO = {
+    level: number;
+    smallBlind: string;
+    bigBlind: string;
+    ante: string;
+    durationMinutes: number;
+    isBreak: boolean;
+};
+/**
+ * A preset by name (#1734's library, engine data): turbo (double, 5 min,
+ * 25/50, ante 10% from level 4), standard (double, 10 min, 25/50, ante 10% from
+ * level 5), deep_stack (×1.5 per level rounded to 25, 15 min, 25/50, ante 12.5%
+ * from level 6), hyper_turbo (double, 3 min, 50/100, ante 10% from level 3).
+ * The engine resolves it into the concrete structure on the table's first
+ * action and persists that, so a later preset edit never changes a running
+ * table. No other field may be set alongside `preset`.
+ */
+type BlindStructurePresetDTO = {
+    preset: BlindPreset;
+};
+type AlgorithmicBlindStructureBase = {
+    startSmallBlind: string;
+    startBigBlind: string;
+    durationMinutes: number;
+    maxLevel?: number;
+    ante?: AnteRuleDTO;
+};
+/** sb_n = startSmallBlind × 2^n — bit-identical to the doubling a structure-less sit-and-go runs. */
+type DoubleBlindStructureDTO = AlgorithmicBlindStructureBase & {
+    progression: "double";
+};
+/** sb_n = startSmallBlind + step × n. */
+type LinearBlindStructureDTO = AlgorithmicBlindStructureBase & {
+    progression: "linear";
+    step: string;
+};
+/**
+ * sb_n = floor(sb_{n−1} × factorBps / 10000) rounded half-up to a multiple of
+ * `roundTo`, never less than sb_{n−1} + roundTo (so a coarse roundTo cannot
+ * stall the curve). `factorBps` must exceed 10000 (15000 = ×1.5 per level).
+ */
+type PercentageBlindStructureDTO = AlgorithmicBlindStructureBase & {
+    progression: "percentage";
+    factorBps: number;
+    roundTo: string;
+};
+/**
+ * Hand-crafted levels (the WSOP-style structure #1734 showed no formula can
+ * reproduce): each row carries its own blinds, ante and duration. Past the
+ * last row the schedule repeats it. The first and last rows may not be breaks.
+ */
+type TableBlindStructureDTO = {
+    progression: "table";
+    levels: BlindLevelDTO[];
+    maxLevel?: number;
+};
+type BlindStructureDTO = BlindStructurePresetDTO | DoubleBlindStructureDTO | LinearBlindStructureDTO | PercentageBlindStructureDTO | TableBlindStructureDTO;
 /**
  * GameOptions represents game configuration (internal use with BigInt).
  *
@@ -45364,6 +45465,7 @@ type GameOptions = {
     protocolFeeBps?: number;
     blindLevelDuration?: number;
     blindLevel?: number;
+    scheduledStartTime?: number;
     sngStartTime?: number;
     levelStartTime?: number;
     timeBankMs?: number;
@@ -45397,8 +45499,10 @@ type GameOptionsDTO = {
     protocolFeeBps?: number;
     blindLevelDuration?: number;
     blindLevel?: number;
+    blindStructure?: BlindStructureDTO;
     nextSmallBlind?: string;
     nextBigBlind?: string;
+    scheduledStartTime?: number;
     sngStartTime?: number;
     levelStartTime?: number;
     timeBankMs?: number;
@@ -45471,6 +45575,25 @@ type PayoutPlaceDTO = {
     place: number;
     amount: string;
 };
+/**
+ * The reveal a sealed hand is stopped on (poker-vm#2695): "board" = the next
+ * street is due from the dealer, "deal" = the deck is due at showdown, "" =
+ * nothing pending. While non-empty no player is next to act and player
+ * actions are rejected.
+ */
+type SealedAwaiting = "board" | "deal" | "";
+/**
+ * The sealed-hand (commit-reveal) state of the current hand — poker-vm#2695,
+ * phase 1 of the dealing design on #2643. Present as
+ * `TexasHoldemStateDTO.sealed` only on a commit-reveal hand; omitted on an
+ * ordinary hand. On a sealed hand `deck` is "" and each hidden hole card is
+ * "??" until `revealed` is true.
+ */
+type SealedDTO = {
+    awaiting: SealedAwaiting;
+    dealtSeats: number[];
+    revealed: boolean;
+};
 type TexasHoldemGameState = {
     type: string;
     address: string;
@@ -45515,6 +45638,7 @@ type TexasHoldemStateDTO = {
     availableSeats: number[];
     rakeCollected?: string;
     payouts?: PayoutPlaceDTO[];
+    sealed?: SealedDTO;
     signature: string;
 };
 /**
@@ -46621,6 +46745,7 @@ interface SNGConfig {
     startingStack: bigint;
     blindLevelDuration: number;
     entryFee?: bigint;
+    startTime?: number;
 }
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities
@@ -47228,5 +47353,5 @@ declare const Client: typeof IgniteClient & Constructor<{
 }>;
 declare const registry: Registry;
 
-export { AllPlayerActions, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, 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, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry, toValoperAddress, txFailureHash, txFailurePhase };
-export type { AccountDTO, ActionDTO, Block, BlockDTO, BlockHeader, BlockHeaderDTO, BlockID, BlockResponse, BurnResponseDTO, Card, CreateValidatorParams, EquityHand, EquityRequest, EquityResponse, EquityResult, ExecutionResult, GameListItem, GameOptions, GameOptionsDTO, GameOptionsResponse, GameStateResponse, GameStateResponseDTO, HandEvaluation, ISignedResponse, LegalActionDTO, PayoutPlaceDTO, PerformActionResponse, PlayerDTO, RPCRequest, RPCRequestParams, RPCResponse, RakeConfig, RakeConfigDTO, ResultDTO, SitInMethod, SitOutMethod, TexasHoldemGameState, TexasHoldemStateDTO, TransactionDTO, TransactionResponse, TxFailurePhase, WalletInfo, WinnerDTO, WithdrawResponseDTO };
+export { AllPlayerActions, BLIND_PRESETS, BLIND_PROGRESSIONS, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, 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, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry, toValoperAddress, txFailureHash, txFailurePhase };
+export type { AccountDTO, ActionDTO, AnteRuleDTO, BlindLevelDTO, BlindPreset, BlindProgression, BlindStructureDTO, BlindStructurePresetDTO, Block, BlockDTO, BlockHeader, BlockHeaderDTO, BlockID, BlockResponse, BurnResponseDTO, Card, CreateValidatorParams, DoubleBlindStructureDTO, EquityHand, EquityRequest, EquityResponse, EquityResult, ExecutionResult, GameListItem, GameOptions, GameOptionsDTO, GameOptionsResponse, GameStateResponse, GameStateResponseDTO, HandEvaluation, ISignedResponse, LegalActionDTO, LinearBlindStructureDTO, PayoutPlaceDTO, PercentageBlindStructureDTO, PerformActionResponse, PlayerDTO, RPCRequest, RPCRequestParams, RPCResponse, RakeConfig, RakeConfigDTO, ResultDTO, SealedAwaiting, SealedDTO, SitInMethod, SitOutMethod, TableBlindStructureDTO, TexasHoldemGameState, TexasHoldemStateDTO, TransactionDTO, TransactionResponse, TxFailurePhase, WalletInfo, WinnerDTO, WithdrawResponseDTO };

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,18 @@ 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";
+    // Sealed hands (poker-vm#2695, commit-reveal phase 1). Submitted by the
+    // dealer, never by a player. REVEAL_BOARD supplies the next street's cards
+    // (`cards=Xx-Yy-Zz`: 3 for the flop, 1 for the turn, 1 for the river) while
+    // `sealed.awaiting === "board"`. REVEAL_DEAL supplies the full deck
+    // (`deck=<52 cards>`) at showdown while `sealed.awaiting === "deal"`; the
+    // engine replays the deal in `sealed.dealtSeats` order and settles.
+    NonPlayerActionType["REVEAL_BOARD"] = "reveal-board";
+    NonPlayerActionType["REVEAL_DEAL"] = "reveal-deal";
 })(NonPlayerActionType || (NonPlayerActionType = {}));
 const AllPlayerActions = { ...PlayerActionType, ...NonPlayerActionType };
 /**
@@ -56163,6 +56193,8 @@ var TexasHoldemRound;
     TexasHoldemRound["SHOWDOWN"] = "showdown";
     TexasHoldemRound["END"] = "end";
 })(TexasHoldemRound || (TexasHoldemRound = {}));
+const BLIND_PRESETS = ["turbo", "standard", "deep_stack", "hyper_turbo"];
+const BLIND_PROGRESSIONS = ["double", "linear", "percentage", "table"];
 const SIT_OUT_METHOD_NEXT_HAND = "next-hand";
 const SIT_OUT_METHOD_NEXT_BB = "next-bb";
 var SUIT;
@@ -71004,6 +71036,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
  */
@@ -71135,6 +71187,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();
@@ -71172,6 +71225,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 = {
@@ -72122,5 +72178,5 @@ const registry = new Registry([
     ...msgTypes,
 ]);
 
-export { AllPlayerActions, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, MissingWalletError, NonPlayerActionType, Params$c as 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, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry, toValoperAddress, txFailureHash, txFailurePhase };
+export { AllPlayerActions, BLIND_PRESETS, BLIND_PROGRESSIONS, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, MissingWalletError, NonPlayerActionType, Params$c as 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, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry, toValoperAddress, txFailureHash, txFailurePhase };
 //# sourceMappingURL=index.esm.js.map