@dimcool/sdk 0.1.26 → 0.1.27

package/README.md

@@ -1287,57 +1287,30 @@ const signedTx = await sdk.wallet.signTransaction(unsignedTx);
 
 **Note:** The transaction amount is automatically set to match the lobby's `betAmount`. The transaction is partially signed by the fee payer (server) and requires the user's signature.
 
-### `submitDepositAndJoinQueue(lobbyId: string, signedTransaction: string, lobbies: Lobbies): Promise<Lobby>`
+### `depositForLobbySync(lobbyId: string): Promise<DepositForLobbyResponse>`
 
-Submit a signed deposit transaction and automatically join the queue when the deposit is confirmed. This is a convenience method that combines deposit submission, confirmation waiting, and queue joining.
+Zero-polling deposit variant using server-side `awaitConfirmation`. Only 2 HTTP calls total with no client-side polling. Ideal for agents and bots.
 
 ```typescript
-const finalLobby = await sdk.escrow.submitDepositAndJoinQueue(
-  lobbyId,
-  signedTxBase64,
-  sdk.lobbies,
-);
+const result = await sdk.escrow.depositForLobbySync(lobbyId);
+// result: { signature: string, status: 'confirmed', canProceedToQueue: true }
 ```
 
 **Parameters:**
 
 - `lobbyId: string` - The lobby ID
-- `signedTransaction: string` - The signed transaction (base64 encoded)
-- `lobbies: Lobbies` - The lobbies service instance (from `sdk.lobbies`)
 
 **Returns:**
 
-- `Promise<Lobby>` - The lobby with updated status (will be 'queued' or 'active' if full)
+- `Promise<DepositForLobbyResponse>` - The deposit result with confirmed status
 
 **Behavior:**
 
-1. Submits the signed deposit transaction to the Solana network
-2. Polls deposit status until all deposits are confirmed (max 30 seconds)
-3. Automatically joins the matchmaking queue when deposits are confirmed
-4. Returns the updated lobby
-
-**Example:**
-
-```typescript
-// After signing the transaction from playAgain()
-const signedTxBase64 = signedTx.serialize().toString('base64');
-const finalLobby = await sdk.escrow.submitDepositAndJoinQueue(
-  lobby.id,
-  signedTxBase64,
-  sdk.lobbies,
-);
-
-// Lobby is now in queue or active if full
-console.log(`Lobby status: ${finalLobby.status}`);
-```
-
-**Error Handling:**
+1. Calls `prepareAndStartDeposit` to prepare the unsigned transaction (1 HTTP call)
+2. Signs the transaction locally and submits with `awaitConfirmation=true` (1 HTTP call)
+3. Server waits for on-chain confirmation before returning
 
-- Throws an error if deposit confirmation times out (30 seconds)
-- Throws an error if deposit submission fails
-- Throws an error if queue joining fails
-
-**Note:** This method is typically used after `playAgain()` to complete the "Play Again" flow in one call.
+**Note:** Requires `sdk.wallet.setSigner()` to be configured. The server auto-joins the matchmaking queue when all deposits are confirmed.
 
 ### `submitDeposit(lobbyId: string, signedTransaction: string): Promise<SubmitDepositResponse>`
 
@@ -1740,25 +1713,11 @@ const { lobby, unsignedTransaction } = await sdk.lobbies.playAgain(
   sdk.escrow,
 );
 
-// Decode and sign the transaction
-const binaryString = atob(unsignedTransaction);
-const bytes = new Uint8Array(binaryString.length);
-for (let i = 0; i < binaryString.length; i++) {
-  bytes[i] = binaryString.charCodeAt(i);
-}
-const unsignedTx = Transaction.from(bytes);
-const signedTx = await sdk.wallet.signTransaction(unsignedTx);
-
-// Submit deposit and join queue
-const signedTxBase64 = signedTx.serialize().toString('base64');
-const finalLobby = await sdk.escrow.submitDepositAndJoinQueue(
-  lobby.id,
-  signedTxBase64,
-  sdk.lobbies,
-);
+// Deposit using the sync (server-awaited) variant
+const result = await sdk.escrow.depositForLobbySync(lobby.id);
 ```
 
-**Note:** After signing the transaction, use `submitDepositAndJoinQueue()` to complete the flow and automatically join the matchmaking queue.
+**Note:** After `playAgain()`, use `depositForLobbySync()` (for agents) or `depositForLobby()` (for React hooks) to complete the deposit flow. The server auto-joins the matchmaking queue when all deposits are confirmed.
 
 ### Admin Methods
 

package/dist/index.cjs

@@ -1153,19 +1153,18 @@ var Lobbies = class {
     return this.http.delete(`/lobbies/admin/${lobbyId}`);
   }
   /**
-   * Play again: Create a new lobby, start deposits, and prepare deposit transaction
-   * Returns the lobby and unsigned transaction that needs to be signed
+   * Play again: Create a new lobby and prepare deposit in one flow.
+   * Returns the lobby and unsigned transaction that needs to be signed.
    * @param gameType - The game type to play again
    * @param betAmount - The bet amount (same as previous game)
    * @param escrow - The escrow service instance (from sdk.escrow)
    */
   async playAgain(gameType, betAmount, escrow) {
     const lobby = await this.createLobby(gameType, betAmount);
-    await escrow.startDeposits(lobby.id);
-    const prepareResponse = await escrow.prepareDepositTransaction(lobby.id);
+    const { transaction } = await escrow.prepareAndStartDeposit(lobby.id);
     return {
       lobby,
-      unsignedTransaction: prepareResponse.transaction
+      unsignedTransaction: transaction
     };
   }
 };
@@ -2057,6 +2056,17 @@ var Escrow = class {
       `/escrow/lobby/${lobbyId}/deposit/prepare`
     );
   }
+  /**
+   * Combined prepare-and-start: validates lobby, transitions waiting→preparing,
+   * initializes depositStatus, and prepares the unsigned transaction in one call.
+   * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
+   */
+  async prepareAndStartDeposit(lobbyId) {
+    return this.http.post(
+      `/escrow/lobby/${lobbyId}/deposit/prepare-and-start`,
+      {}
+    );
+  }
   /**
    * Submit a signed deposit transaction
    * The transaction will be submitted to the Solana network and confirmed
@@ -2087,7 +2097,7 @@ var Escrow = class {
     );
   }
   /**
-   * One-call lobby deposit: start deposits, prepare, sign, submit, and poll until
+   * One-call lobby deposit: prepare-and-start, sign, submit, and poll until
    * the current user's deposit is confirmed. Requires sdk.wallet.setSigner() to be set.
    * Returns when all required deposits are confirmed and the lobby can proceed to queue.
    *
@@ -2099,8 +2109,7 @@ var Escrow = class {
         "No signer configured. Use sdk.wallet.setSigner(...) first."
       );
     }
-    await this.startDeposits(lobbyId);
-    const { transaction } = await this.prepareDepositTransaction(lobbyId);
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
     const unsignedTx = import_web35.Transaction.from(base64ToBytes(transaction));
     let signature;
     if (this.wallet.isSignAndSendMode()) {
@@ -2122,7 +2131,7 @@ var Escrow = class {
       if (status.allConfirmed && status.canProceedToQueue) {
         return {
           signature,
-          status: "pending",
+          status: "confirmed",
           canProceedToQueue: true
         };
       }
@@ -2134,6 +2143,39 @@ var Escrow = class {
       canProceedToQueue: false
     };
   }
+  /**
+   * Zero-polling deposit variant using server-side awaitConfirmation.
+   * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+   *
+   * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
+   */
+  async depositForLobbySync(lobbyId) {
+    if (!this.wallet.hasSigner()) {
+      throw new Error(
+        "No signer configured. Use sdk.wallet.setSigner(...) first."
+      );
+    }
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
+    const unsignedTx = import_web35.Transaction.from(base64ToBytes(transaction));
+    let signature;
+    if (this.wallet.isSignAndSendMode()) {
+      signature = await this.wallet.signAndSendTransaction(unsignedTx);
+      await this.http.post(
+        `/escrow/lobby/${lobbyId}/deposit/confirm-signature?awaitConfirmation=true`,
+        { signature }
+      );
+    } else {
+      const signedTx = await this.wallet.signTransaction(unsignedTx);
+      const signedBase64 = bytesToBase64(
+        signedTx.serialize({ requireAllSignatures: false })
+      );
+      const result = await this.http.post(`/escrow/lobby/${lobbyId}/deposit/submit?awaitConfirmation=true`, {
+        signedTransaction: signedBase64
+      });
+      signature = result.signature;
+    }
+    return { signature, status: "confirmed", canProceedToQueue: true };
+  }
   async claimLobbyDepositRefund(lobbyId, depositSignature) {
     return this.http.post(
       `/escrow/lobby/${lobbyId}/deposit/${depositSignature}/claim-refund`,
@@ -2146,33 +2188,6 @@ var Escrow = class {
       {}
     );
   }
-  /**
-   * Submit a signed deposit transaction and wait until the lobby is queued/active.
-   *
-   * Note: the backend may auto-transition the lobby to the queue once deposits are confirmed.
-   * In that case, calling /join-queue from the client would be redundant and can fail with
-   * "Current status: queued".
-   * @param lobbyId - The lobby ID
-   * @param signedTransaction - The signed transaction (base64 encoded)
-   * @param lobbies - The lobbies service instance (from sdk.lobbies) to read lobby status
-   */
-  async submitDepositAndJoinQueue(lobbyId, signedTransaction, lobbies) {
-    await this.submitDeposit(lobbyId, signedTransaction);
-    const MAX_WAIT_TIME = 3e4;
-    const POLL_INTERVAL = 1e3;
-    const startTime = Date.now();
-    while (Date.now() - startTime < MAX_WAIT_TIME) {
-      const status = await this.getDepositStatus(lobbyId);
-      if (status.allConfirmed && status.canProceedToQueue) {
-        const lobby = await lobbies.getLobby(lobbyId);
-        if (lobby.status === "queued" || lobby.status === "active") {
-          return lobby;
-        }
-      }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL));
-    }
-    throw new Error("Deposit confirmation timeout");
-  }
 };
 
 // src/daily.ts
@@ -2821,8 +2836,14 @@ var _StandaloneWsTransport = class _StandaloneWsTransport extends BaseWsTranspor
         connecting: false,
         error: null
       });
+      const wasReconnect = this.reconnectAttempts > 0;
       this.reconnectAttempts = 0;
       this.onReconnect();
+      if (wasReconnect) {
+        this.dispatchEvent("connection:reconnected", {
+          timestamp: Date.now()
+        });
+      }
     });
     socket.on("disconnect", (reason) => {
       this.updateConnectionState({ connected: false, connecting: false });
@@ -2970,7 +2991,8 @@ function createLobbyStore(transport) {
   const store = createSdkStore({
     lobbiesById: {},
     matchedEvent: null,
-    typingByLobbyId: {}
+    typingByLobbyId: {},
+    depositStatusByLobbyId: {}
   });
   const setBaseState = (lobbies) => {
     const lobbiesById = {};
@@ -3050,6 +3072,15 @@ function createLobbyStore(transport) {
           };
         });
         break;
+      case "lobby:deposit:updated":
+        store.updateState((state) => ({
+          ...state,
+          depositStatusByLobbyId: {
+            ...state.depositStatusByLobbyId,
+            [event.payload.lobbyId]: event.payload
+          }
+        }));
+        break;
       case "lobby:typing:start":
       case "lobby:typing:stop":
         store.updateState((state) => {
@@ -3078,12 +3109,22 @@ function createLobbyStore(transport) {
       }
     }
   );
+  const subscribeDepositUpdate = (lobbyId, callback) => store.subscribeSelector(
+    (state) => state.depositStatusByLobbyId[lobbyId],
+    () => {
+      const data = store.getState().depositStatusByLobbyId[lobbyId];
+      if (data) {
+        callback(data);
+      }
+    }
+  );
   return {
     store,
     setBaseState,
     applyWsEvent,
     joinLobby,
-    subscribeMatched
+    subscribeMatched,
+    subscribeDepositUpdate
   };
 }
 
@@ -3369,7 +3410,6 @@ function createGameActionsStore(transport) {
           ...current,
           roundState: {
             ...current.roundState,
-            phase: "completed",
             timeRemaining: 0,
             actions: timedOutUser ? {
               ...current.roundState.actions,
@@ -3891,6 +3931,7 @@ var WS_EVENT_NAMES = [
   "lobby:queue:joined",
   "lobby:queue:cancelled",
   "lobby:matched",
+  "lobby:deposit:updated",
   "lobby:typing:start",
   "lobby:typing:stop",
   "game:updated",
@@ -3967,6 +4008,11 @@ function decodeWsEvent(eventName, payload) {
         event: "lobby:matched",
         payload
       };
+    case "lobby:deposit:updated":
+      return {
+        event: "lobby:deposit:updated",
+        payload
+      };
     case "lobby:typing:start":
     case "lobby:typing:stop":
       return {

package/dist/index.d.cts

@@ -1199,7 +1199,7 @@ interface QueueStats {
     totalQueuedLobbies: number;
 }
 type ChatMessageType = 'user' | 'system';
-type SystemMessageType = 'player_joined' | 'player_left' | 'bet_changed' | 'call_joined' | 'call_left' | 'global_help' | 'global_challenge' | 'global_tip' | 'spectator_donation';
+type SystemMessageType = 'player_joined' | 'player_left' | 'bet_changed' | 'call_joined' | 'call_left' | 'global_help' | 'global_challenge' | 'global_tip' | 'spectator_donation' | 'challenge_accepted' | 'challenge_declined';
 interface ChatMessageReply {
     id: string;
     userId?: string;
@@ -1264,15 +1264,14 @@ declare class Lobbies {
         message: string;
     }>;
     /**
-     * Play again: Create a new lobby, start deposits, and prepare deposit transaction
-     * Returns the lobby and unsigned transaction that needs to be signed
+     * Play again: Create a new lobby and prepare deposit in one flow.
+     * Returns the lobby and unsigned transaction that needs to be signed.
      * @param gameType - The game type to play again
      * @param betAmount - The bet amount (same as previous game)
      * @param escrow - The escrow service instance (from sdk.escrow)
      */
     playAgain(gameType: string, betAmount: MoneyMinor, escrow: {
-        startDeposits: (id: string) => Promise<void>;
-        prepareDepositTransaction: (id: string) => Promise<{
+        prepareAndStartDeposit: (id: string) => Promise<{
             transaction: string;
             message: string;
         }>;
@@ -1288,6 +1287,8 @@ interface GameType {
     maxPlayers: number;
     minPlayers: number;
     description?: string;
+    /** Agent-facing instructions including game pace (how fast the game is). */
+    detailedInstructions?: string;
     available: boolean;
     betOptions?: BetOption[];
 }
@@ -1418,6 +1419,7 @@ declare class Games {
         success: boolean;
         bothReady: boolean;
         newGameId?: string;
+        newLobbyId?: string;
     }>;
     /**
      * Cancel a rematch request
@@ -1701,7 +1703,7 @@ declare class Tips {
     send(recipientUsername: string, amount: number): Promise<SendTipResponse>;
 }
 
-type WsEventName = 'lobby:created' | 'lobby:updated' | 'lobby:player:joined' | 'lobby:player:left' | 'lobby:player:connected' | 'lobby:player:disconnected' | 'lobby:bet:updated' | 'lobby:invitation' | 'lobby:deleted' | 'lobby:queue:joined' | 'lobby:queue:cancelled' | 'lobby:matched' | 'lobby:typing:start' | 'lobby:typing:stop' | 'game:updated' | 'game:completed' | 'game:paid' | 'game:abandoned' | 'game:turn' | 'game:move' | 'game:state' | 'game:player:connected' | 'game:player:disconnected' | 'game:rps:starting' | 'game:rps:round:started' | 'game:rps:action:received' | 'game:rps:timer:cutoff' | 'game:rps:round:reveal' | 'game:rps:round:completed' | 'game:rps:timeout' | 'game:rematch:requested' | 'game:rematch:cancelled' | 'game:rematch:started' | 'game:rematch:lobby:created' | 'game:pot:updated' | 'game:market:price:updated' | 'game:market:order:filled' | 'game:market:resolved' | 'spectator:count:updated' | 'chat:message' | 'chat:reaction' | 'chat:read' | 'chat:typing' | 'notification';
+type WsEventName = 'lobby:created' | 'lobby:updated' | 'lobby:player:joined' | 'lobby:player:left' | 'lobby:player:connected' | 'lobby:player:disconnected' | 'lobby:bet:updated' | 'lobby:invitation' | 'lobby:deleted' | 'lobby:queue:joined' | 'lobby:queue:cancelled' | 'lobby:matched' | 'lobby:deposit:updated' | 'lobby:typing:start' | 'lobby:typing:stop' | 'game:updated' | 'game:completed' | 'game:paid' | 'game:abandoned' | 'game:turn' | 'game:move' | 'game:state' | 'game:player:connected' | 'game:player:disconnected' | 'game:rps:starting' | 'game:rps:round:started' | 'game:rps:action:received' | 'game:rps:timer:cutoff' | 'game:rps:round:reveal' | 'game:rps:round:completed' | 'game:rps:timeout' | 'game:rematch:requested' | 'game:rematch:cancelled' | 'game:rematch:started' | 'game:rematch:lobby:created' | 'game:pot:updated' | 'game:market:price:updated' | 'game:market:order:filled' | 'game:market:resolved' | 'spectator:count:updated' | 'chat:message' | 'chat:reaction' | 'chat:read' | 'chat:typing' | 'notification';
 type GameTurnPayload = {
     turn: number;
     currentPlayerId: string;
@@ -1804,6 +1806,12 @@ type MarketResolvedPayload = {
     resolvedOutcome: string | null;
     isDraw: boolean;
 };
+type LobbyDepositUpdatedPayload = {
+    lobbyId: string;
+    userId: string;
+    status: string;
+    allConfirmed: boolean;
+};
 type WsEvent = {
     event: 'lobby:created';
     payload: Lobby;
@@ -1863,6 +1871,9 @@ type WsEvent = {
         gameType: string;
         matchedLobbies: Lobby[];
     };
+} | {
+    event: 'lobby:deposit:updated';
+    payload: LobbyDepositUpdatedPayload;
 } | {
     event: 'lobby:typing:start';
     payload: {
@@ -2137,6 +2148,12 @@ declare class Escrow {
      * Returns an unsigned transaction that needs to be signed by the user
      */
     prepareDepositTransaction(lobbyId: string): Promise<PrepareDepositResponse>;
+    /**
+     * Combined prepare-and-start: validates lobby, transitions waiting→preparing,
+     * initializes depositStatus, and prepares the unsigned transaction in one call.
+     * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
+     */
+    prepareAndStartDeposit(lobbyId: string): Promise<PrepareDepositResponse>;
     /**
      * Submit a signed deposit transaction
      * The transaction will be submitted to the Solana network and confirmed
@@ -2153,13 +2170,20 @@ declare class Escrow {
         status: string;
     }>;
     /**
-     * One-call lobby deposit: start deposits, prepare, sign, submit, and poll until
+     * One-call lobby deposit: prepare-and-start, sign, submit, and poll until
      * the current user's deposit is confirmed. Requires sdk.wallet.setSigner() to be set.
      * Returns when all required deposits are confirmed and the lobby can proceed to queue.
      *
      * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
      */
     depositForLobby(lobbyId: string): Promise<DepositForLobbyResponse>;
+    /**
+     * Zero-polling deposit variant using server-side awaitConfirmation.
+     * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+     *
+     * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
+     */
+    depositForLobbySync(lobbyId: string): Promise<DepositForLobbyResponse>;
     claimLobbyDepositRefund(lobbyId: string, depositSignature: string): Promise<{
         signature: string;
         status: string;
@@ -2168,25 +2192,6 @@ declare class Escrow {
         signature: string;
         status: string;
     }>;
-    /**
-     * Submit a signed deposit transaction and wait until the lobby is queued/active.
-     *
-     * Note: the backend may auto-transition the lobby to the queue once deposits are confirmed.
-     * In that case, calling /join-queue from the client would be redundant and can fail with
-     * "Current status: queued".
-     * @param lobbyId - The lobby ID
-     * @param signedTransaction - The signed transaction (base64 encoded)
-     * @param lobbies - The lobbies service instance (from sdk.lobbies) to read lobby status
-     */
-    submitDepositAndJoinQueue(lobbyId: string, signedTransaction: string, lobbies: {
-        getLobby: (id: string) => Promise<{
-            id: string;
-            status: string;
-        }>;
-    }): Promise<{
-        id: string;
-        status: string;
-    }>;
 }
 
 interface DailyRoom {
@@ -2560,6 +2565,7 @@ type LobbyStoreState = {
     lobbiesById: Record<string, Lobby>;
     matchedEvent: LobbyMatchedEvent | null;
     typingByLobbyId: Record<string, string[]>;
+    depositStatusByLobbyId: Record<string, LobbyDepositUpdatedPayload>;
 };
 type LobbyStore = {
     store: SdkStore<LobbyStoreState>;
@@ -2567,6 +2573,7 @@ type LobbyStore = {
     applyWsEvent: (event: WsEvent) => void;
     joinLobby: (lobbyId: string) => () => void;
     subscribeMatched: (callback: (event: LobbyMatchedEvent) => void) => () => void;
+    subscribeDepositUpdate: (lobbyId: string, callback: (data: LobbyDepositUpdatedPayload) => void) => () => void;
 };
 declare function createLobbyStore(transport: WsTransport): LobbyStore;
 
@@ -2830,4 +2837,4 @@ declare class HttpClient implements IHttpClient {
     private payChallenge;
 }
 
-export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IHttpClient, type ILogger, type IStorage, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };
+export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IHttpClient, type ILogger, type IStorage, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };

package/dist/index.d.ts

@@ -1199,7 +1199,7 @@ interface QueueStats {
     totalQueuedLobbies: number;
 }
 type ChatMessageType = 'user' | 'system';
-type SystemMessageType = 'player_joined' | 'player_left' | 'bet_changed' | 'call_joined' | 'call_left' | 'global_help' | 'global_challenge' | 'global_tip' | 'spectator_donation';
+type SystemMessageType = 'player_joined' | 'player_left' | 'bet_changed' | 'call_joined' | 'call_left' | 'global_help' | 'global_challenge' | 'global_tip' | 'spectator_donation' | 'challenge_accepted' | 'challenge_declined';
 interface ChatMessageReply {
     id: string;
     userId?: string;
@@ -1264,15 +1264,14 @@ declare class Lobbies {
         message: string;
     }>;
     /**
-     * Play again: Create a new lobby, start deposits, and prepare deposit transaction
-     * Returns the lobby and unsigned transaction that needs to be signed
+     * Play again: Create a new lobby and prepare deposit in one flow.
+     * Returns the lobby and unsigned transaction that needs to be signed.
      * @param gameType - The game type to play again
      * @param betAmount - The bet amount (same as previous game)
      * @param escrow - The escrow service instance (from sdk.escrow)
      */
     playAgain(gameType: string, betAmount: MoneyMinor, escrow: {
-        startDeposits: (id: string) => Promise<void>;
-        prepareDepositTransaction: (id: string) => Promise<{
+        prepareAndStartDeposit: (id: string) => Promise<{
             transaction: string;
             message: string;
         }>;
@@ -1288,6 +1287,8 @@ interface GameType {
     maxPlayers: number;
     minPlayers: number;
     description?: string;
+    /** Agent-facing instructions including game pace (how fast the game is). */
+    detailedInstructions?: string;
     available: boolean;
     betOptions?: BetOption[];
 }
@@ -1418,6 +1419,7 @@ declare class Games {
         success: boolean;
         bothReady: boolean;
         newGameId?: string;
+        newLobbyId?: string;
     }>;
     /**
      * Cancel a rematch request
@@ -1701,7 +1703,7 @@ declare class Tips {
     send(recipientUsername: string, amount: number): Promise<SendTipResponse>;
 }
 
-type WsEventName = 'lobby:created' | 'lobby:updated' | 'lobby:player:joined' | 'lobby:player:left' | 'lobby:player:connected' | 'lobby:player:disconnected' | 'lobby:bet:updated' | 'lobby:invitation' | 'lobby:deleted' | 'lobby:queue:joined' | 'lobby:queue:cancelled' | 'lobby:matched' | 'lobby:typing:start' | 'lobby:typing:stop' | 'game:updated' | 'game:completed' | 'game:paid' | 'game:abandoned' | 'game:turn' | 'game:move' | 'game:state' | 'game:player:connected' | 'game:player:disconnected' | 'game:rps:starting' | 'game:rps:round:started' | 'game:rps:action:received' | 'game:rps:timer:cutoff' | 'game:rps:round:reveal' | 'game:rps:round:completed' | 'game:rps:timeout' | 'game:rematch:requested' | 'game:rematch:cancelled' | 'game:rematch:started' | 'game:rematch:lobby:created' | 'game:pot:updated' | 'game:market:price:updated' | 'game:market:order:filled' | 'game:market:resolved' | 'spectator:count:updated' | 'chat:message' | 'chat:reaction' | 'chat:read' | 'chat:typing' | 'notification';
+type WsEventName = 'lobby:created' | 'lobby:updated' | 'lobby:player:joined' | 'lobby:player:left' | 'lobby:player:connected' | 'lobby:player:disconnected' | 'lobby:bet:updated' | 'lobby:invitation' | 'lobby:deleted' | 'lobby:queue:joined' | 'lobby:queue:cancelled' | 'lobby:matched' | 'lobby:deposit:updated' | 'lobby:typing:start' | 'lobby:typing:stop' | 'game:updated' | 'game:completed' | 'game:paid' | 'game:abandoned' | 'game:turn' | 'game:move' | 'game:state' | 'game:player:connected' | 'game:player:disconnected' | 'game:rps:starting' | 'game:rps:round:started' | 'game:rps:action:received' | 'game:rps:timer:cutoff' | 'game:rps:round:reveal' | 'game:rps:round:completed' | 'game:rps:timeout' | 'game:rematch:requested' | 'game:rematch:cancelled' | 'game:rematch:started' | 'game:rematch:lobby:created' | 'game:pot:updated' | 'game:market:price:updated' | 'game:market:order:filled' | 'game:market:resolved' | 'spectator:count:updated' | 'chat:message' | 'chat:reaction' | 'chat:read' | 'chat:typing' | 'notification';
 type GameTurnPayload = {
     turn: number;
     currentPlayerId: string;
@@ -1804,6 +1806,12 @@ type MarketResolvedPayload = {
     resolvedOutcome: string | null;
     isDraw: boolean;
 };
+type LobbyDepositUpdatedPayload = {
+    lobbyId: string;
+    userId: string;
+    status: string;
+    allConfirmed: boolean;
+};
 type WsEvent = {
     event: 'lobby:created';
     payload: Lobby;
@@ -1863,6 +1871,9 @@ type WsEvent = {
         gameType: string;
         matchedLobbies: Lobby[];
     };
+} | {
+    event: 'lobby:deposit:updated';
+    payload: LobbyDepositUpdatedPayload;
 } | {
     event: 'lobby:typing:start';
     payload: {
@@ -2137,6 +2148,12 @@ declare class Escrow {
      * Returns an unsigned transaction that needs to be signed by the user
      */
     prepareDepositTransaction(lobbyId: string): Promise<PrepareDepositResponse>;
+    /**
+     * Combined prepare-and-start: validates lobby, transitions waiting→preparing,
+     * initializes depositStatus, and prepares the unsigned transaction in one call.
+     * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
+     */
+    prepareAndStartDeposit(lobbyId: string): Promise<PrepareDepositResponse>;
     /**
      * Submit a signed deposit transaction
      * The transaction will be submitted to the Solana network and confirmed
@@ -2153,13 +2170,20 @@ declare class Escrow {
         status: string;
     }>;
     /**
-     * One-call lobby deposit: start deposits, prepare, sign, submit, and poll until
+     * One-call lobby deposit: prepare-and-start, sign, submit, and poll until
      * the current user's deposit is confirmed. Requires sdk.wallet.setSigner() to be set.
      * Returns when all required deposits are confirmed and the lobby can proceed to queue.
      *
      * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
      */
     depositForLobby(lobbyId: string): Promise<DepositForLobbyResponse>;
+    /**
+     * Zero-polling deposit variant using server-side awaitConfirmation.
+     * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+     *
+     * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
+     */
+    depositForLobbySync(lobbyId: string): Promise<DepositForLobbyResponse>;
     claimLobbyDepositRefund(lobbyId: string, depositSignature: string): Promise<{
         signature: string;
         status: string;
@@ -2168,25 +2192,6 @@ declare class Escrow {
         signature: string;
         status: string;
     }>;
-    /**
-     * Submit a signed deposit transaction and wait until the lobby is queued/active.
-     *
-     * Note: the backend may auto-transition the lobby to the queue once deposits are confirmed.
-     * In that case, calling /join-queue from the client would be redundant and can fail with
-     * "Current status: queued".
-     * @param lobbyId - The lobby ID
-     * @param signedTransaction - The signed transaction (base64 encoded)
-     * @param lobbies - The lobbies service instance (from sdk.lobbies) to read lobby status
-     */
-    submitDepositAndJoinQueue(lobbyId: string, signedTransaction: string, lobbies: {
-        getLobby: (id: string) => Promise<{
-            id: string;
-            status: string;
-        }>;
-    }): Promise<{
-        id: string;
-        status: string;
-    }>;
 }
 
 interface DailyRoom {
@@ -2560,6 +2565,7 @@ type LobbyStoreState = {
     lobbiesById: Record<string, Lobby>;
     matchedEvent: LobbyMatchedEvent | null;
     typingByLobbyId: Record<string, string[]>;
+    depositStatusByLobbyId: Record<string, LobbyDepositUpdatedPayload>;
 };
 type LobbyStore = {
     store: SdkStore<LobbyStoreState>;
@@ -2567,6 +2573,7 @@ type LobbyStore = {
     applyWsEvent: (event: WsEvent) => void;
     joinLobby: (lobbyId: string) => () => void;
     subscribeMatched: (callback: (event: LobbyMatchedEvent) => void) => () => void;
+    subscribeDepositUpdate: (lobbyId: string, callback: (data: LobbyDepositUpdatedPayload) => void) => () => void;
 };
 declare function createLobbyStore(transport: WsTransport): LobbyStore;
 
@@ -2830,4 +2837,4 @@ declare class HttpClient implements IHttpClient {
     private payChallenge;
 }
 
-export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IHttpClient, type ILogger, type IStorage, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };
+export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IHttpClient, type ILogger, type IStorage, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };

package/dist/index.js

@@ -1101,19 +1101,18 @@ var Lobbies = class {
     return this.http.delete(`/lobbies/admin/${lobbyId}`);
   }
   /**
-   * Play again: Create a new lobby, start deposits, and prepare deposit transaction
-   * Returns the lobby and unsigned transaction that needs to be signed
+   * Play again: Create a new lobby and prepare deposit in one flow.
+   * Returns the lobby and unsigned transaction that needs to be signed.
    * @param gameType - The game type to play again
    * @param betAmount - The bet amount (same as previous game)
    * @param escrow - The escrow service instance (from sdk.escrow)
    */
   async playAgain(gameType, betAmount, escrow) {
     const lobby = await this.createLobby(gameType, betAmount);
-    await escrow.startDeposits(lobby.id);
-    const prepareResponse = await escrow.prepareDepositTransaction(lobby.id);
+    const { transaction } = await escrow.prepareAndStartDeposit(lobby.id);
     return {
       lobby,
-      unsignedTransaction: prepareResponse.transaction
+      unsignedTransaction: transaction
     };
   }
 };
@@ -2005,6 +2004,17 @@ var Escrow = class {
       `/escrow/lobby/${lobbyId}/deposit/prepare`
     );
   }
+  /**
+   * Combined prepare-and-start: validates lobby, transitions waiting→preparing,
+   * initializes depositStatus, and prepares the unsigned transaction in one call.
+   * Eliminates one HTTP round-trip vs startDeposits() + prepareDepositTransaction().
+   */
+  async prepareAndStartDeposit(lobbyId) {
+    return this.http.post(
+      `/escrow/lobby/${lobbyId}/deposit/prepare-and-start`,
+      {}
+    );
+  }
   /**
    * Submit a signed deposit transaction
    * The transaction will be submitted to the Solana network and confirmed
@@ -2035,7 +2045,7 @@ var Escrow = class {
     );
   }
   /**
-   * One-call lobby deposit: start deposits, prepare, sign, submit, and poll until
+   * One-call lobby deposit: prepare-and-start, sign, submit, and poll until
    * the current user's deposit is confirmed. Requires sdk.wallet.setSigner() to be set.
    * Returns when all required deposits are confirmed and the lobby can proceed to queue.
    *
@@ -2047,8 +2057,7 @@ var Escrow = class {
         "No signer configured. Use sdk.wallet.setSigner(...) first."
       );
     }
-    await this.startDeposits(lobbyId);
-    const { transaction } = await this.prepareDepositTransaction(lobbyId);
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
     const unsignedTx = Transaction5.from(base64ToBytes(transaction));
     let signature;
     if (this.wallet.isSignAndSendMode()) {
@@ -2070,7 +2079,7 @@ var Escrow = class {
       if (status.allConfirmed && status.canProceedToQueue) {
         return {
           signature,
-          status: "pending",
+          status: "confirmed",
           canProceedToQueue: true
         };
       }
@@ -2082,6 +2091,39 @@ var Escrow = class {
       canProceedToQueue: false
     };
   }
+  /**
+   * Zero-polling deposit variant using server-side awaitConfirmation.
+   * 2 HTTP calls total, 0 client-side polling. Ideal for agents.
+   *
+   * Automatically uses signAndSendTransaction or signTransaction based on signer capability.
+   */
+  async depositForLobbySync(lobbyId) {
+    if (!this.wallet.hasSigner()) {
+      throw new Error(
+        "No signer configured. Use sdk.wallet.setSigner(...) first."
+      );
+    }
+    const { transaction } = await this.prepareAndStartDeposit(lobbyId);
+    const unsignedTx = Transaction5.from(base64ToBytes(transaction));
+    let signature;
+    if (this.wallet.isSignAndSendMode()) {
+      signature = await this.wallet.signAndSendTransaction(unsignedTx);
+      await this.http.post(
+        `/escrow/lobby/${lobbyId}/deposit/confirm-signature?awaitConfirmation=true`,
+        { signature }
+      );
+    } else {
+      const signedTx = await this.wallet.signTransaction(unsignedTx);
+      const signedBase64 = bytesToBase64(
+        signedTx.serialize({ requireAllSignatures: false })
+      );
+      const result = await this.http.post(`/escrow/lobby/${lobbyId}/deposit/submit?awaitConfirmation=true`, {
+        signedTransaction: signedBase64
+      });
+      signature = result.signature;
+    }
+    return { signature, status: "confirmed", canProceedToQueue: true };
+  }
   async claimLobbyDepositRefund(lobbyId, depositSignature) {
     return this.http.post(
       `/escrow/lobby/${lobbyId}/deposit/${depositSignature}/claim-refund`,
@@ -2094,33 +2136,6 @@ var Escrow = class {
       {}
     );
   }
-  /**
-   * Submit a signed deposit transaction and wait until the lobby is queued/active.
-   *
-   * Note: the backend may auto-transition the lobby to the queue once deposits are confirmed.
-   * In that case, calling /join-queue from the client would be redundant and can fail with
-   * "Current status: queued".
-   * @param lobbyId - The lobby ID
-   * @param signedTransaction - The signed transaction (base64 encoded)
-   * @param lobbies - The lobbies service instance (from sdk.lobbies) to read lobby status
-   */
-  async submitDepositAndJoinQueue(lobbyId, signedTransaction, lobbies) {
-    await this.submitDeposit(lobbyId, signedTransaction);
-    const MAX_WAIT_TIME = 3e4;
-    const POLL_INTERVAL = 1e3;
-    const startTime = Date.now();
-    while (Date.now() - startTime < MAX_WAIT_TIME) {
-      const status = await this.getDepositStatus(lobbyId);
-      if (status.allConfirmed && status.canProceedToQueue) {
-        const lobby = await lobbies.getLobby(lobbyId);
-        if (lobby.status === "queued" || lobby.status === "active") {
-          return lobby;
-        }
-      }
-      await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL));
-    }
-    throw new Error("Deposit confirmation timeout");
-  }
 };
 
 // src/daily.ts
@@ -2769,8 +2784,14 @@ var _StandaloneWsTransport = class _StandaloneWsTransport extends BaseWsTranspor
         connecting: false,
         error: null
       });
+      const wasReconnect = this.reconnectAttempts > 0;
       this.reconnectAttempts = 0;
       this.onReconnect();
+      if (wasReconnect) {
+        this.dispatchEvent("connection:reconnected", {
+          timestamp: Date.now()
+        });
+      }
     });
     socket.on("disconnect", (reason) => {
       this.updateConnectionState({ connected: false, connecting: false });
@@ -2918,7 +2939,8 @@ function createLobbyStore(transport) {
   const store = createSdkStore({
     lobbiesById: {},
     matchedEvent: null,
-    typingByLobbyId: {}
+    typingByLobbyId: {},
+    depositStatusByLobbyId: {}
   });
   const setBaseState = (lobbies) => {
     const lobbiesById = {};
@@ -2998,6 +3020,15 @@ function createLobbyStore(transport) {
           };
         });
         break;
+      case "lobby:deposit:updated":
+        store.updateState((state) => ({
+          ...state,
+          depositStatusByLobbyId: {
+            ...state.depositStatusByLobbyId,
+            [event.payload.lobbyId]: event.payload
+          }
+        }));
+        break;
       case "lobby:typing:start":
       case "lobby:typing:stop":
         store.updateState((state) => {
@@ -3026,12 +3057,22 @@ function createLobbyStore(transport) {
       }
     }
   );
+  const subscribeDepositUpdate = (lobbyId, callback) => store.subscribeSelector(
+    (state) => state.depositStatusByLobbyId[lobbyId],
+    () => {
+      const data = store.getState().depositStatusByLobbyId[lobbyId];
+      if (data) {
+        callback(data);
+      }
+    }
+  );
   return {
     store,
     setBaseState,
     applyWsEvent,
     joinLobby,
-    subscribeMatched
+    subscribeMatched,
+    subscribeDepositUpdate
   };
 }
 
@@ -3317,7 +3358,6 @@ function createGameActionsStore(transport) {
           ...current,
           roundState: {
             ...current.roundState,
-            phase: "completed",
             timeRemaining: 0,
             actions: timedOutUser ? {
               ...current.roundState.actions,
@@ -3839,6 +3879,7 @@ var WS_EVENT_NAMES = [
   "lobby:queue:joined",
   "lobby:queue:cancelled",
   "lobby:matched",
+  "lobby:deposit:updated",
   "lobby:typing:start",
   "lobby:typing:stop",
   "game:updated",
@@ -3915,6 +3956,11 @@ function decodeWsEvent(eventName, payload) {
         event: "lobby:matched",
         payload
       };
+    case "lobby:deposit:updated":
+      return {
+        event: "lobby:deposit:updated",
+        payload
+      };
     case "lobby:typing:start":
     case "lobby:typing:stop":
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/sdk",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",