@block52/poker-vm-sdk 1.2.7 → 1.2.9

package/dist/index.d.ts

@@ -44938,6 +44938,13 @@ declare const MsgJoinGame: MessageFns<MsgJoinGame>;
 interface MsgLeaveGame {
     creator: string;
     gameId: string;
+    /**
+     * finishing_order: place-1-first player addresses for an SNG that finalized
+     * off-chain (WS-first money-movers, poker-vm#2325). Empty for cash games and
+     * for SNGs the chain already finalized. The chain validates this ordering
+     * and recomputes payouts with its own prize-pool math. (pokerchain#229)
+     */
+    finishingOrder: string[];
 }
 declare const MsgLeaveGame: MessageFns<MsgLeaveGame>;
 /** MsgDealCards defines the MsgDealCards message. */
@@ -46487,6 +46494,57 @@ 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). For cash games and SNGs the chain
+     * already finalized, the chain decides the refund from its own state and
+     * the message carries only {creator, gameId}. (#2325)
+     *
+     * For an SNG that finalized off-chain (WS-first money-movers — the gateway
+     * never relays the tournament-ending gameplay action, so the chain's
+     * Results are empty), pass `finishingOrder`: the place-1-first list of
+     * player addresses. The chain validates the ordering and recomputes the
+     * payouts from its own prize-pool math — this message supplies only the
+     * ORDER, never any amount. (pokerchain#229)
+     */
+    signLeaveGame(gameId: string, signerData?: SignerData, finishingOrder?: string[]): 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

@@ -3240,7 +3240,7 @@ const MsgJoinGame = {
     },
 };
 function createBaseMsgLeaveGame() {
-    return { creator: "", gameId: "" };
+    return { creator: "", gameId: "", finishingOrder: [] };
 }
 const MsgLeaveGame = {
     encode(message, writer = new BinaryWriter()) {
@@ -3250,6 +3250,9 @@ const MsgLeaveGame = {
         if (message.gameId !== "") {
             writer.uint32(18).string(message.gameId);
         }
+        for (const v of message.finishingOrder) {
+            writer.uint32(26).string(v);
+        }
         return writer;
     },
     decode(input, length) {
@@ -3273,6 +3276,13 @@ const MsgLeaveGame = {
                     message.gameId = reader.string();
                     continue;
                 }
+                case 3: {
+                    if (tag !== 26) {
+                        break;
+                    }
+                    message.finishingOrder.push(reader.string());
+                    continue;
+                }
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -3285,6 +3295,9 @@ const MsgLeaveGame = {
         return {
             creator: isSet$2b(object.creator) ? globalThis.String(object.creator) : "",
             gameId: isSet$2b(object.gameId) ? globalThis.String(object.gameId) : "",
+            finishingOrder: globalThis.Array.isArray(object?.finishingOrder)
+                ? object.finishingOrder.map((e) => globalThis.String(e))
+                : [],
         };
     },
     toJSON(message) {
@@ -3295,6 +3308,9 @@ const MsgLeaveGame = {
         if (message.gameId !== "") {
             obj.gameId = message.gameId;
         }
+        if (message.finishingOrder?.length) {
+            obj.finishingOrder = message.finishingOrder;
+        }
         return obj;
     },
     create(base) {
@@ -3304,6 +3320,7 @@ const MsgLeaveGame = {
         const message = createBaseMsgLeaveGame();
         message.creator = object.creator ?? "";
         message.gameId = object.gameId ?? "";
+        message.finishingOrder = object.finishingOrder?.map((e) => e) || [];
         return message;
     },
 };
@@ -61195,6 +61212,103 @@ 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). For cash games and SNGs the chain
+     * already finalized, the chain decides the refund from its own state and
+     * the message carries only {creator, gameId}. (#2325)
+     *
+     * For an SNG that finalized off-chain (WS-first money-movers — the gateway
+     * never relays the tournament-ending gameplay action, so the chain's
+     * Results are empty), pass `finishingOrder`: the place-1-first list of
+     * player addresses. The chain validates the ordering and recomputes the
+     * payouts from its own prize-pool math — this message supplies only the
+     * ORDER, never any amount. (pokerchain#229)
+     */
+    async signLeaveGame(gameId, signerData, finishingOrder = []) {
+        await this.initializeSigningClient();
+        const [account] = await this.wallet.getAccounts();
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgLeaveGame",
+            value: {
+                creator: account.address,
+                gameId,
+                finishingOrder
+            }
+        };
+        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.