@block52/poker-vm-sdk 1.8.0 → 1.12.0

package/dist/index.d.ts

@@ -44960,6 +44960,14 @@ interface MsgCreateGame {
      * 0 = unscheduled: starts only when full. (poker-vm#2680)
      */
     startTime: Long;
+    /**
+     * Blind structure for a sit-and-go / tournament (field 22): JSON of the SDK's
+     * BlindStructureDTO — a preset ({"preset":"turbo"}) or an explicit double /
+     * linear / percentage / table structure. Empty = the blinds double every
+     * blind_level_duration minutes. Cash games must leave it empty.
+     * (poker-vm#1734, block52/pokerchain#434)
+     */
+    blindStructure: string;
 }
 declare const MsgCreateGame: MessageFns<MsgCreateGame>;
 /** MsgJoinGame defines the MsgJoinGame message. */
@@ -45258,7 +45266,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 +45285,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 +45366,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 +45507,7 @@ type GameOptionsDTO = {
     protocolFeeBps?: number;
     blindLevelDuration?: number;
     blindLevel?: number;
+    blindStructure?: BlindStructureDTO;
     nextSmallBlind?: string;
     nextBigBlind?: string;
     scheduledStartTime?: number;
@@ -45483,6 +45583,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 +45646,7 @@ type TexasHoldemStateDTO = {
     availableSeats: number[];
     rakeCollected?: string;
     payouts?: PayoutPlaceDTO[];
+    sealed?: SealedDTO;
     signature: string;
 };
 /**
@@ -46032,6 +46152,34 @@ declare const isEmptyAddress: (address: string | null | undefined) => boolean;
  */
 declare const isValidPlayerAddress: (address: string | null | undefined) => boolean;
 
+/**
+ * Parses the text form into the typed structure. Throws on anything the
+ * engine would refuse that can be seen without expanding levels; the engine
+ * validates the result again on load.
+ */
+declare function parseBlindStructure(text: string): BlindStructureDTO;
+/**
+ * The inverse of parseBlindStructure. A preset formats as `BLINDS <preset>`;
+ * anything else as a block under `name` (default "custom").
+ */
+declare function formatBlindStructure(structure: BlindStructureDTO, name?: string): string;
+/**
+ * #1734's preset library, as the engine resolves it (pvm/go/engine
+ * tournament_blinds.go blindPresets). The engine resolves a preset on the
+ * table's first action; `resolveBlindPreset` does the same client-side so the
+ * levels can be previewed before the table exists.
+ */
+declare const BLIND_PRESET_STRUCTURES: Readonly<Record<BlindPreset, Exclude<BlindStructureDTO, BlindStructurePresetDTO>>>;
+/** Replaces a preset with its concrete structure (a deep copy); anything else is returned as is. */
+declare function resolveBlindPreset(structure: BlindStructureDTO): Exclude<BlindStructureDTO, BlindStructurePresetDTO>;
+/**
+ * Level n (0-based) of a structure, exactly as the engine expands it: the cap
+ * (`maxLevel`) freezes the blinds while the level number keeps counting; a
+ * table schedule repeats its last row once it runs out; the ante rule applies
+ * from its start level. A preset must be resolved first (`resolveBlindPreset`).
+ */
+declare function expandBlindLevel(structure: BlindStructureDTO, n: number): BlindLevelDTO;
+
 /**
  * Poker hand types in order of strength (weakest to strongest)
  */
@@ -46634,6 +46782,7 @@ interface SNGConfig {
     blindLevelDuration: number;
     entryFee?: bigint;
     startTime?: number;
+    blindStructure?: BlindStructureDTO;
 }
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities
@@ -47241,5 +47390,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_PRESET_STRUCTURES, 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, expandBlindLevel, formatBlindStructure, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseBlindStructure, parseGameFormat, parseGameVariant, registry, resolveBlindPreset, 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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAkC/C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEV,CAAC;AAEH,QAAA,MAAM,QAAQ,UAiCZ,CAAA;AAGF,cAAc,6BAA6B,CAAA;AAG3C,cAAc,cAAc,CAAA;AAG5B,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGpG,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,sBAAsB,CAAA;AAGpC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGrE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIpI,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAC9I,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGvI,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGzF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,kBAAkB,EACnB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAkC/C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEV,CAAC;AAEH,QAAA,MAAM,QAAQ,UAiCZ,CAAA;AAGF,cAAc,6BAA6B,CAAA;AAG3C,cAAc,cAAc,CAAA;AAG5B,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGpG,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,sBAAsB,CAAA;AAGpC,cAAc,wBAAwB,CAAA;AAGtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGrE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIpI,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAC9I,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGvI,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGzF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,kBAAkB,EACnB,CAAA"}