@block52/poker-vm-sdk 1.1.18 → 1.2.0

package/dist/index.d.ts

@@ -46417,6 +46417,32 @@ declare class SigningCosmosClient extends CosmosClient {
      * @param data - Optional data string (e.g., entropy for deal action)
      */
     performAction(gameId: string, action: string, amount?: bigint, data?: string): Promise<string>;
+    /**
+     * Fast-path variant of {@link performAction}. Broadcasts in SYNC mode —
+     * returns as soon as the tx passes CheckTx (mempool admission), without
+     * waiting for block inclusion. Typical return latency is ~50–100ms vs
+     * 5+ seconds for {@link performAction}.
+     *
+     * **The tx is NOT yet executed when this returns.** The caller MUST
+     * reconcile authoritative state via the chain's WebSocket push, which
+     * fires after block commit. Pair this with optimistic UI rendering
+     * and a rollback path for the case where CheckTx succeeds but the
+     * tx fails at DeliverTx (rare — illegal action that escaped local
+     * validation, or block-time consensus surprises).
+     *
+     * Use cases:
+     *   - Frontend action submission where perceived latency matters.
+     *   - Any caller that has an independent path (WS, polling) to
+     *     learn the action's authoritative outcome.
+     *
+     * Do NOT use this for code paths that need the post-DeliverTx
+     * `events` or `rawLog` — those are only populated by the BLOCK
+     * variant. See block52/poker-vm#2104.
+     *
+     * Returns the tx hash on CheckTx success; throws if CheckTx
+     * rejects (invalid signature, malformed msg, insufficient gas).
+     */
+    performActionSync(gameId: string, action: string, amount?: bigint, data?: string): Promise<string>;
     /**
      * 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

@@ -57995,6 +57995,64 @@ class SigningCosmosClient extends CosmosClient {
             throw error;
         }
     }
+    /**
+     * Fast-path variant of {@link performAction}. Broadcasts in SYNC mode —
+     * returns as soon as the tx passes CheckTx (mempool admission), without
+     * waiting for block inclusion. Typical return latency is ~50–100ms vs
+     * 5+ seconds for {@link performAction}.
+     *
+     * **The tx is NOT yet executed when this returns.** The caller MUST
+     * reconcile authoritative state via the chain's WebSocket push, which
+     * fires after block commit. Pair this with optimistic UI rendering
+     * and a rollback path for the case where CheckTx succeeds but the
+     * tx fails at DeliverTx (rare — illegal action that escaped local
+     * validation, or block-time consensus surprises).
+     *
+     * Use cases:
+     *   - Frontend action submission where perceived latency matters.
+     *   - Any caller that has an independent path (WS, polling) to
+     *     learn the action's authoritative outcome.
+     *
+     * Do NOT use this for code paths that need the post-DeliverTx
+     * `events` or `rawLog` — those are only populated by the BLOCK
+     * variant. See block52/poker-vm#2104.
+     *
+     * Returns the tx hash on CheckTx success; throws if CheckTx
+     * rejects (invalid signature, malformed msg, insufficient gas).
+     */
+    async performActionSync(gameId, action, amount = 0n, data) {
+        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;
+        // Same msg shape as performAction — only the broadcast mode differs.
+        const msgPerformAction = {
+            player,
+            gameId,
+            action,
+            amount: Long.fromString(amount.toString(), true),
+            data: data || ""
+        };
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgPerformAction",
+            value: msgPerformAction
+        };
+        const fee = gaslessFee();
+        const memo = `Poker action (sync): ${action}`;
+        try {
+            // signAndBroadcastSync returns just the txhash, no DeliverTx
+            // result. The caller waits on the WS push for the
+            // authoritative outcome.
+            const txHash = await this.signingClient.signAndBroadcastSync(player, [msg], fee, memo);
+            return txHash;
+        }
+        catch (error) {
+            console.error("❌ Action (sync) failed at CheckTx:", error);
+            throw error;
+        }
+    }
     /**
      * Top up a player's stack at a table
      * The player must be seated at the table and have sufficient wallet balance.