@block52/poker-vm-sdk 1.8.0 → 1.10.0

package/dist/index.d.ts

@@ -45258,7 +45258,9 @@ declare enum NonPlayerActionType {
     TIMEOUT = "timeout",
     TIME_BANK = "time-bank",
     TOP_UP = "top-up",
-    START = "start"
+    START = "start",
+    REVEAL_BOARD = "reveal-board",
+    REVEAL_DEAL = "reveal-deal"
 }
 declare const AllPlayerActions: {
     DEAD_SMALL_BLIND: NonPlayerActionType.DEAD_SMALL_BLIND;
@@ -45275,6 +45277,8 @@ declare const AllPlayerActions: {
     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;
@@ -45354,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).
  *
@@ -45408,6 +45499,7 @@ type GameOptionsDTO = {
     protocolFeeBps?: number;
     blindLevelDuration?: number;
     blindLevel?: number;
+    blindStructure?: BlindStructureDTO;
     nextSmallBlind?: string;
     nextBigBlind?: string;
     scheduledStartTime?: number;
@@ -45483,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;
@@ -45527,6 +45638,7 @@ type TexasHoldemStateDTO = {
     availableSeats: number[];
     rakeCollected?: string;
     payouts?: PayoutPlaceDTO[];
+    sealed?: SealedDTO;
     signature: string;
 };
 /**
@@ -47241,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

@@ -56113,6 +56113,14 @@ var NonPlayerActionType;
     // 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 };
 /**
@@ -56185,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;
@@ -72168,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