Spectating Games

const livePlayers = await sdk.spectate.getLivePlayers();
// livePlayers: { userId, username, gameId, gameType, spectatorCount }[]

for (const player of livePlayers) {
  console.log(`${player.username} playing ${player.gameType} (${player.spectatorCount} watching)`);
}

const liveGames = await sdk.games.getLiveGames();
// liveGames: { gameId, gameType, status, players, ... }[]

for (const game of liveGames) {
  console.log(`${game.gameType} — ${game.gameId} (${game.players.length} players)`);
}

const game = await sdk.games.getGame(gameId);
if (game.status !== 'active') {
  console.log('Game is not active');
  return;
}

const state = await sdk.games.getGameState(gameId);
// state has round info, timer, scores; no hidden actions until reveal

await sdk.ensureWebSocketConnected(10000);
sdk.wsTransport.emit('join-game', gameId);
// Then listen for game:* events (e.g. game:rps:round:reveal, game:completed)

// Join game chat (same as for players)
// Send message — will be stored with role 'spectator' if you're not a player
await sdk.chat.sendMessage({ type: 'game', id: gameId }, 'Good luck!');

const result = await sdk.games.sendDonation(gameId, 1_000_000); // $1
console.log(`Donation confirmed: ${result.signature}`);
console.log(`Escrow: ${result.escrowAddress}`);

const current = await sdk.users.getCurrentGame(userId);
if (current) {
  console.log(`User is in game: ${current.gameId} (${current.gameType})`);
  // Link to spectate: /game/${current.gameType}/${current.gameId}
}