@gala-chain/launchpad-sdk 9.0.0-rc.0 → 9.0.0-rc.2

package/dist/LaunchpadSDK.d.ts

@@ -1,9 +1,14 @@
 import type { GalaChainTokenClass, GalaChainTokenDetails, GalaChainTokenClassKey, HttpRequestor } from '@gala-chain/gala-core-sdk';
+import type * as CoreBridgeModule from '@gala-chain/gala-core-sdk/bridge';
 import type { BridgeableNetwork, BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeToken, BridgeTransaction, EstimateBridgeFeeParams, EthereumTransactionStatus, EthereumWalletBalanceResult, ExternalChainBalance, FetchBridgeableTokensOptions, FetchBridgeableTokensResult, FetchWrappableTokensOptions, FetchWrappableTokensResult, IsTokenBridgeableOptions, IsTokenBridgeableResult, IsTokenWrappableResult, SolanaTransactionStatus, SolanaWalletBalanceResult, UnwrapTokenOptions, WrappableToken, WrapTokenOptions, WrapUnwrapFeeEstimate, WrapUnwrapResult } from '@gala-chain/gala-core-sdk/bridge';
 import { Wallet } from 'ethers';
+import { type LaunchpadSession } from './auth/session';
 import type { Environment } from './config/environments';
 import { EventsBatcherService } from './services/EventsBatcherService';
-import type { StreamEventCallbacks } from './services/StreamWebSocketService';
+import type { StreamEventCallbacks } from './services/realtime/event-catalog';
+import type { RealtimeListener, Unsubscribe } from './services/StreamWebSocketService';
+import { StreamWebSocketService } from './services/StreamWebSocketService';
+import { type SocketFactory } from './launchpad/bundle-submission';
 import { LaunchpadWrites } from './launchpad/writes';
 import type { LaunchpadSigner } from './signing';
 import type { GetAIModerationOptions, GetAIModerationResult, GetAIModerationSettingsResult, GetAIModerationStatusResult, TriggerAIModerationOptions, TriggerAIModerationResult, UpdateAIModerationSettingsOptions, UpdateAIModerationSettingsResult } from './types/ai-moderation.dto';
@@ -20,8 +25,8 @@ import type { AddContentReactionOptions, AddContentReactionResult, RemoveContent
 import type { FetchTokenStatsResult } from './types/engagement-stats.dto';
 import type { AmountCalculationResult, FetchPoolsOptions, GraduationCalculationResult, GraphDataResult, LaunchTokenData, PoolData, PoolsResult, SaleDetailsResult, TokenDistributionResult, TokenHolder, TokenSpotPrice, TradeQuoteParams, UserHolderContext, ValidateTokenResponse } from './types/launchpad.dto';
 import type { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensResult } from './types/lock.dto';
-import type { CreateMessageOptions, CreateMessageResult, DeleteMessageResult, FetchMessagesOptions, FetchMessagesResult, GetPinnedMessageResult, MessageStats, PinMessageResult, UpdateMessageOptions, UpdateMessageResult, UpdateTokenConfigOptions } from './types/messages.dto';
-import type { TokenConfigData } from './types/token-config.dto';
+import type { CreateMessageOptions, CreateMessageResult, DeleteMessageResult, FetchMessagesOptions, FetchMessagesResult, MessageStats, MessageType, PinMessageResult, PinnedMessageResult, UpdateMessageOptions, UpdateMessageResult } from './types/messages.dto';
+import type { TokenConfigData, UpdateTokenConfigOptions } from './types/token-config.dto';
 import type { ClaimModeratorInviteOptions, ClaimModeratorInviteResult, CreateModeratorInviteOptions, CreateModeratorInviteResult, GetModeratedTokensOptions, ListModeratorInvitesOptions, ModeratedTokensResult, ModeratorInviteListResult, PublicInviteInfo, UpdateInviteRoleOptions, UpdateInviteRoleResult, UpdateModeratorInviteOptions, UpdateModeratorInviteResult } from './types/moderator.dto';
 import type { ClaimCollectionParams, ClaimCollectionResult, CreateTokenClassParams, CreateTokenClassResult, EstimateMintFeeParams, EstimateNftFeesParams, FetchTokenClassesParams, MintNftParams, MintNftResult, NftBalance, NftCollectionAuthorization, NftFeeEstimate, NftTokenClassWithSupply } from './types/nft.dto';
 import type { GetNotificationPreferencesResult, RegisterPushTokenParams, RegisterPushTokenResult, UnregisterPushTokenResult, UpdateNotificationPreferencesParams, UpdateNotificationPreferencesResult } from './types/notification.dto';
@@ -29,26 +34,26 @@ import type { GetHomeOEmbedJsonResult, GetHomeOEmbedOptions, GetPoolOEmbedJsonRe
 import type { BanStatsResponse, CreateOverseerDirectOptions, CreateOverseerInviteOptions, FlagStatsResponse, InviteStatsResponse, ListOverseerInvitesOptions, ListOverseersOptions, ListUsersOptions, Overseer, OverseerInviteWithUrl, OverseerStatusResponse, OverseerSummaryResponse, PaginatedOverseerInvites, PaginatedOverseers, PublicOverseerInviteInfo, TokenBanStatsResponse, UsersListResponse, UserStatsResponse, UserSummaryResponse } from './types/overseer.dto';
 import type { PlatformConfig, UpdatePlatformConfigOptions } from './types/platform-config.dto';
 import type { GetPlatformStatsResult } from './types/platform-stats.dto';
+import type { EventStats, QueryEventsOptions, QueryEventsResult } from './types/events.dto';
+import type { HealthCheckResponse } from './types/health.dto';
 import type { GetRestrictedNamesResult, UpdateRestrictedNamesRequest, UpdateRestrictedNamesResult } from './types/restricted-names.dto';
 import type { TokenLaunchResult, TradeResult } from './types/result.types';
-import type { LoginResponse, RefreshResponse, SessionInfo } from './types/session-auth.dto';
+import type { LoginRequest, LoginResponse, RefreshResponse, SessionInfo } from './types/session-auth.dto';
 import type { AddSimulcastTargetOptions, AddSimulcastTargetResult, FetchRecordingsOptions, GetStreamRoleOptions, GetTokenAccessOptions, GlobalStreamingStatus, RecordingDownloadResult, RecordingsResult, ResetStreamKeyResult, SimulcastTargetsResult, StartStreamResult, StreamCredentialsResult, StreamRoleResponse, StreamSubscribedEvent, TokenAccessResult } from './types/streaming.dto';
 import type { BanTokenOptions, BanTokenResult, GetTokenBanOptions, ListTokenBansOptions, TokenBanListResult, TokenBanStatusResult, UnbanTokenOptions, UnbanTokenResult } from './types/token-ban.dto';
 import type { PoolDetailsData, TradesResult } from './types/trade.dto';
 import type { GetTradesOptions, TradesQueryResult } from './types/trades-query.dto';
 import type { GalaChainTransferReceipt, TransferGalaData, TransferTokenData } from './types/transfer.dto';
-import type { AllReferralsResult, AvailableBalanceResult, FetchReferralsOptions, FetchReferralsSummaryOptions, FetchTokenBalanceOptions, GetManagedTokensOptions, LockedBalanceResult, ManagedTokensResult, ReferralsResult, ReferralsSummaryResult, ReferralUrlResult, TokenBalanceResult, UpdateProfileData, UploadProfileImageOptions, UserTokenListResult } from './types/user.dto';
+import type { AllReferralsResult, AvailableBalanceResult, FetchReferralsOptions, FetchReferralsSummaryOptions, FetchTokenBalanceOptions, GetManagedTokensOptions, LockedBalanceResult, ManagedTokensResult, PublicUserProfile, ReferralCode, ReferralsResult, ReferralsSummaryResult, ReferralUrlResult, TokenBalanceResult, UpdateProfileData, UploadProfileImageOptions, UserGalaBalance, UserTokenListResult } from './types/user.dto';
 import type { BalanceUpdatedPayload, ChatMessagePayload, ChatStatusPayload, ConnectedClient, ConnectedClientsResponse, DownloadReadyPayload, FeatureStatusPayload, GetConnectedClientsOptions, ModeratorAddedPayload, ModeratorRemovedPayload, RecordingsCountUpdatedPayload, EmitWebSocketEventRequest, RecordingStatusPayload, SiteConfigChangedPayload, StreamCountdownPayload, StreamStatusPayload, TokenBannedPayload, TokenUnbannedPayload, TradeExecutedPayload, TypingIndicatorPayload, UserProfileUpdatedPayload, ViewerCountPayload } from './types/websocket-admin.dto';
-import type { EngagementStatsUpdatedEvent } from './types/websocket-events.dto';
 import type { CommentCreatedEvent, HolderCountUpdatedEvent, ModeratorAddedEvent, PoolMetadataUpdatedEvent, TokenBannedEvent, TradeExecutedEvent } from './types/websocket-events.dto';
 import type { GetTokenWeeklyHistoryOptions, GetTokenWeeklyHistoryResult, GetWeeklyChallengeOptions, GetWeeklyChallengeResult } from './types/weekly-challenge.dto';
 import { TransactionFailedError, WebSocketError, WebSocketTimeoutError } from './utils/websocket-errors';
 import { type WalletProvider } from '@gala-chain/gala-core-sdk/providers';
 export { TransactionFailedError, WebSocketError, WebSocketTimeoutError, };
 import type { BuyTokenOptions, CalculateBuyAmountForGraduationOptions, CalculateBuyAmountLocalOptions, CalculateBuyAmountOptions, CalculateSellAmountLocalOptions, CalculateSellAmountOptions, FetchTokensCreatedOptions, FetchTokensHeldOptions, FetchTokenSpotPriceParams, FetchTradesOptions, FetchVolumeDataOptions, GraduateTokenOptions, SellTokenOptions, UploadImageByTokenNameOptions } from './types/options.dto';
-import type { GetPinnedMessageResult as LegacyGetPinnedMessageResult, PinMessageResult as LegacyPinMessageResult, UnpinMessageResult as LegacyUnpinMessageResult } from './types/stream-chat.dto';
+import type { ChatStatusResponse, GetPinnedMessageResult, UnpinMessageResult } from './types/stream-chat.dto';
 import type { AvailableRolesResponse } from './types/streaming.dto';
-import type { AuthenticatedEvent, BanEnforcementEvent, ChatStatusChangedEvent, ConnectionEvent, ContentFlaggedEvent, ContentReactionAddedEvent, ContentReactionRemovedEvent, DownloadReadyEvent, FlagResolvedEvent, RecordingsCountUpdatedEvent, RecordingStatusChangedEvent, RoomLeftEvent, RoomSubscribedEvent, SimulcastStatusChangedEvent, StreamChatDeletedEvent, StreamChatMessageEvent, StreamChatPinnedEvent, StreamChatUnpinnedEvent, StreamChatUpdatedEvent, StreamControlStatusChangedEvent, StreamCountdownUpdatedEvent, StreamLanguageUpdatedEvent, StreamReactionEvent, StreamStatusChangedEvent, TokenSubscribedEvent, TokenUnsubscribedEvent, UserBannedEvent, UserTypingEvent, UserUnbannedEvent, ViewerCountChangedEvent } from './types/streaming-events.dto';
 /**
  * Configuration for initializing the Launchpad SDK
  *
@@ -101,10 +106,45 @@ export type LaunchpadSDKConfigResponse = Omit<LaunchpadSDKConfig, 'wallet' | 'wa
 export interface LaunchpadSDKConfig extends SDKConfig {
     /** Native or typed-data signer used by the v6 write surfaces. */
     signer?: LaunchpadSigner;
+    /**
+     * An app-owned launchpad-backend session (a browser app's httpOnly-cookie JWT session). Every
+     * launchpad-backend request then takes its bearer from the session, a 401 is handed to the session
+     * (one retry with the token it returns), those requests carry the browser's cookies, and the SDK
+     * stores no token: log in with {@link LaunchpadSDK.loginWithSignature}, refresh with
+     * {@link LaunchpadSDK.refreshToken}, end it with {@link LaunchpadSDK.logout}. Exclusive with
+     * `accessToken`. Pair it with `signer` + `walletAddress` (never `wallet` / `walletProvider`, which
+     * sign every request).
+     *
+     * @since 9.0.0
+     */
+    session?: LaunchpadSession;
     /** Registered GalaChain address used as the write sender and bundler header. */
     walletAddress?: string;
     /** Fetch-compatible requestor used by v6 write surfaces and tests. */
     httpRequestor?: HttpRequestor;
+    /**
+     * The app's own bundler socket (socket.io to the bundle backend, with the app's reconnect
+     * settings), for the confirmation of `sdk.launchpad` writes. Called once per `wait()` with the
+     * bundle base URL; the SDK adds its listener for the bundle's event on the socket returned and
+     * removes it when the wait ends, and never disconnects it. Without it each `wait()` opens a socket
+     * of its own and closes it afterwards.
+     *
+     * @since 9.0.0
+     */
+    bundleSocketFactory?: SocketFactory;
+    /**
+     * Loads gala-core-sdk's `./bridge`, which the bridge and wrap methods (`bridgeOut`, `bridgeIn`,
+     * `wrapToken`, `getSupportedBridgeTokens`, the external-chain balances, ...) run on:
+     * `bridge: () => import('@gala-chain/gala-core-sdk/bridge')`. That module loads `ethers`,
+     * `@solana/web3.js` and `@solana/spl-token` (core's optional peers), so launchpad-sdk never
+     * names it itself: an app that does not pass this loader bundles and installs no Solana, and its
+     * bridge and wrap calls throw a `ConfigurationError` naming this option. Loaded once per SDK, at
+     * the first such call; a failed load (the peers are not installed) is a `ConfigurationError`
+     * naming them, tried again at the next call.
+     *
+     * @since 9.0.0
+     */
+    bridge?: CoreBridgeLoader;
     /**
      * The ethers wallet for authentication (optional)
      * - Required for: Trading (buy/sell), transfers, token creation, profile updates
@@ -265,6 +305,26 @@ export interface LaunchpadSDKConfig extends SDKConfig {
      * ```
      */
     streamWebSocketUrl?: string;
+    /**
+     * How many times the stream socket retries a lost connection before giving up (default 5;
+     * `Infinity` never gives up, which is what a long-lived browser app wants).
+     *
+     * @since 9.0.0
+     */
+    streamReconnectAttempts?: number;
+    /**
+     * The stream socket's delay before its first reconnection attempt in ms (default 2000; the delay
+     * grows toward `streamReconnectDelayMax`).
+     *
+     * @since 9.0.0
+     */
+    streamReconnectDelay?: number;
+    /**
+     * The longest delay between the stream socket's reconnection attempts in ms (socket.io's default 5000).
+     *
+     * @since 9.0.0
+     */
+    streamReconnectDelayMax?: number;
     /**
      * Optional Admin API key for stream management operations.
      *
@@ -277,6 +337,16 @@ export interface LaunchpadSDKConfig extends SDKConfig {
      */
     streamAdminApiKey?: string;
 }
+/** gala-core-sdk's `./bridge` module. */
+type CoreBridge = typeof CoreBridgeModule;
+/**
+ * Loads gala-core-sdk's `./bridge` for the bridge and wrap methods: `LaunchpadSDKConfig.bridge`.
+ * Pass `() => import('@gala-chain/gala-core-sdk/bridge')` (a page without a bundler: a function
+ * resolving to the bridge module it loaded itself; gala-core-sdk ships no script-tag build of it).
+ *
+ * @since 9.0.0
+ */
+export type CoreBridgeLoader = () => Promise<CoreBridge>;
 export declare class LaunchpadSDK {
     /** Default slippage tolerance factor (15%) - Higher for volatile bonding curve tokens */
     static readonly DEFAULT_SLIPPAGE_TOLERANCE_FACTOR = 0.15;
@@ -324,6 +394,8 @@ export declare class LaunchpadSDK {
     private readonly cache;
     /** Counts wallet changes: a bridge call that started under one wallet never runs under the next. */
     private walletGeneration;
+    /** The load of gala-core-sdk's `./bridge` through `config.bridge`; cleared when it fails. */
+    private coreBridgeLoad;
     private _bridgeService;
     private _bridgeableTokenService?;
     private _wrappableTokenService?;
@@ -332,16 +404,6 @@ export declare class LaunchpadSDK {
     private _streamingService;
     private _streamChatService;
     private _streamWebSocketService;
-    /** Per-token room refcount shared across every watchTokenRoomEvent() event type, so the
-     * room is only left via unsubscribeFromStream() once nothing is still watching it. */
-    private _tokenRoomRefCounts;
-    /** Fan-out listener sets, keyed by `${eventKey}:${tokenName}`, so concurrent watchers of the
-     * SAME event+token never clobber each other's single roomCallbacks slot on StreamWebSocketService. */
-    private _tokenRoomListeners;
-    /** The single real subscribeXxx() unsubscribe per `${eventKey}:${tokenName}`, shared by every
-     * watcher of that key so whichever watcher leaves LAST releases it (not just the first one). */
-    private _tokenRoomUnsubscribers;
-    private _streamingEventService;
     private _banService;
     private _tokenBanService;
     private _aiModerationService;
@@ -358,6 +420,8 @@ export declare class LaunchpadSDK {
     private _weeklyChallengeService;
     private _oembedService;
     private _platformStatsService;
+    private _healthService;
+    private _eventsQueryService;
     private _notificationService;
     private _clientConfigService;
     private readonly nftCollectionService;
@@ -747,6 +811,10 @@ export declare class LaunchpadSDK {
      * (reverse bonding curve fees, vault addresses) for every pool returned. This enables
      * instant local calculations without additional API calls.
      *
+     * Options are those `GET /v1/tokens` accepts: `type` RECENT / POPULAR / RECORDINGS /
+     * SECONDS_STREAMED and `streamStatus` IDLE / ACTIVE / DISABLED (any case), `pageSize` 1 to 100
+     * (default 10); anything else is a `ValidationError` before a request is made.
+     *
      * @category Pool Information
      * @param options Optional filters for pool fetching
      * @returns Promise<PoolsResult> with pagination metadata
@@ -754,7 +822,7 @@ export declare class LaunchpadSDK {
      *
      * @example Basic pool fetching
      * ```typescript
-     * const result = await sdk.fetchPools({ type: 'recent', pageSize: 20 });
+     * const result = await sdk.fetchPools({ type: 'RECENT', pageSize: 20 });
      * console.log(`Fetched ${result.items.length} pools`);
      * console.log(`Total pools: ${result.total}`);
      * ```
@@ -853,11 +921,7 @@ export declare class LaunchpadSDK {
      * console.log('Calculated 10 prices instantly using cached metadata');
      * ```
      */
-    fetchAllPools(options?: {
-        search?: string;
-        tokenName?: string;
-        type?: 'recent' | 'popular';
-    }): Promise<PoolsResult>;
+    fetchAllPools(options?: Omit<FetchPoolsOptions, 'cursor' | 'pageSize'>): Promise<PoolsResult>;
     /**
      * Fetch token ownership distribution with holder percentages
      *
@@ -1410,6 +1474,14 @@ export declare class LaunchpadSDK {
      * ```
      */
     fetchGalaBalance(address?: string): Promise<TokenBalanceResult | null>;
+    /**
+     * gala-core-sdk's `./bridge` from the `bridge` loader of the config, loaded once (a failed load
+     * is cleared and tried again at the next call).
+     *
+     * @throws ConfigurationError (`field: 'bridge'`) when no loader was configured, or it failed (the
+     * module's optional peers are not installed) or did not give the module
+     */
+    private loadCoreBridge;
     /**
      * gala-core-sdk's `./bridge` for a bridge or wrap call (see `loadCoreBridge`). The call was made
      * with the SDK's wallet of NOW: if the wallet changes while the module loads, the call is refused
@@ -1588,6 +1660,10 @@ export declare class LaunchpadSDK {
      * @since 9.0.0
      */
     private getPlatformStatsService;
+    /** Lazily created HealthService (public `GET /health`). @internal */
+    private getHealthService;
+    /** Lazily created EventsQueryService (stored events, Admin API key or Overseer). @internal */
+    private getEventsQueryService;
     /**
      * Get or create the NotificationService instance.
      *
@@ -1679,7 +1755,6 @@ export declare class LaunchpadSDK {
      * @internal
      */
     private getContentReactionService;
-    private toLegacyPinnedMessage;
     private buildMessageFetchOptions;
     private resolveReferralAddress;
     /**
@@ -1736,12 +1811,27 @@ export declare class LaunchpadSDK {
      */
     private getStreamWebSocketService;
     /**
-     * Get the streaming event service
+     * The token the stream socket authenticates with, asked for at every authentication (including the
+     * one after a reconnect), so a refreshed token is the one used: an app `session` is its own authority
+     * (`session.accessToken()`); otherwise the SDK's own session, refreshed or renewed when it is near
+     * expiry (`ensureValidToken()`).
+     */
+    private streamSocketToken;
+    /**
+     * The realtime socket: one registry of subscribers for every event the backend emits (token rooms,
+     * comment rooms, the global feed, the overseers' firehose, a connection's own user and overseer
+     * rooms). Every `subscribe*` method on it is synchronous, returns that subscriber's own unsubscribe,
+     * serves any number of subscribers per event, and joins a room on its first subscriber and leaves it on
+     * its last. It also has `connect`, `authenticate`, `deauthenticate`, `onConnectionStateChange`,
+     * `onReconnect` and the chat / reaction / typing senders.
      *
-     * @internal
-     * @since 5.12.0
+     * Created on first use.
+     *
+     * @throws ConfigurationError if `streamWebSocketUrl` is not configured
+     * @since 9.0.0
+     * @category WebSocket
      */
-    private getStreamingEventService;
+    get realtime(): StreamWebSocketService;
     /**
      * Fetch a single ERC-20 token balance on Ethereum.
      *
@@ -2459,6 +2549,35 @@ export declare class LaunchpadSDK {
      * ```
      */
     login(): Promise<LoginResponse>;
+    /**
+     * Log in with a signature the caller made: a browser wallet signs the login message
+     * (`Sign in to Launchpad t:<ms>`, {@link JWT_CONSTANTS}) itself, so an SDK built with only a
+     * `signer` has nothing to sign it with. `publicKey` registers a `client|` alias's key.
+     *
+     * With an app `session` the login asks for a cookie session (the refresh token becomes an httpOnly
+     * cookie and is absent from the answer) and nothing is stored in the SDK: hand the answer to the
+     * session. Without one the tokens are stored as {@link login} stores them. A failure is an
+     * `AuthError` carrying the backend's `statusCode`.
+     *
+     * @since 9.0.0
+     * @category Authentication
+     *
+     * @example
+     * ```typescript
+     * const message = `Sign in to Launchpad t:${Date.now()}`;
+     * const signature = await provider.signMessage(message);
+     * const { accessToken, refreshExpiresIn } = await sdk.loginWithSignature({ address, message, signature });
+     * ```
+     */
+    loginWithSignature(request: LoginRequest): Promise<LoginResponse>;
+    /**
+     * Log in as `address` without a signature: the backend's development bypass, accepted by
+     * non-production deployments only. Session handling as in {@link loginWithSignature}.
+     *
+     * @since 9.0.0
+     * @category Authentication
+     */
+    loginWithDevBypass(address: string): Promise<LoginResponse>;
     /**
      * Refresh the current JWT token.
      *
@@ -2506,9 +2625,14 @@ export declare class LaunchpadSDK {
      * await sdk.logout({ allDevices: true });
      * console.log('Logged out from all devices');
      * ```
+     *
+     * With an app `session` the logout always reaches the server (`POST /auth/logout`, the cookie
+     * naming the session to revoke), carries `options.accessToken` as its bearer when given, and
+     * throws an `AuthError` (with the backend's `statusCode`) when it fails.
      */
     logout(options?: {
         allDevices?: boolean;
+        accessToken?: string | null;
     }): Promise<void>;
     /**
      * Check if user is authenticated with valid JWT.
@@ -2819,7 +2943,7 @@ export declare class LaunchpadSDK {
      * ```typescript
      * const { targets } = await sdk.getSimulcastTargets('mytoken');
      * targets.forEach(t => {
-     *   console.log(`${t.platform}: ${t.status}`);
+     *   console.log(`${t.passthrough ?? t.url}: ${t.status}`);
      * });
      * ```
      */
@@ -2839,11 +2963,11 @@ export declare class LaunchpadSDK {
      *
      * @example Add YouTube simulcast
      * ```typescript
-     * const target = await sdk.addSimulcastTarget({
+     * const { target } = await sdk.addSimulcastTarget({
      *   tokenName: 'mytoken',
-     *   platform: 'YOUTUBE',
+     *   platform: 'youtube',
      *   streamKey: 'xxxx-xxxx-xxxx-xxxx',
-     *   rtmpUrl: 'rtmp://a.rtmp.youtube.com/live2',
+     *   url: 'rtmp://a.rtmp.youtube.com/live2',
      * });
      * console.log(`Added target: ${target.id}`);
      * ```
@@ -3043,6 +3167,25 @@ export declare class LaunchpadSDK {
      *
      * Deprecated: Chat status is now included in token details (GET /v1/tokens/:tokenName)
      */
+    /**
+     * The chat status of a token (`GET /live/:tokenName/chat`, public): whether chat is on, why it is
+     * off (`reason`: `'global'` or `'token'`) and the slow-mode interval (`slowModeSeconds`, 0 = off).
+     *
+     * @param tokenName - Token name
+     * @returns The token's chat status
+     * @throws ValidationError if the token name is invalid
+     *
+     * @since 9.0.0
+     * @category Chat
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.getChatStatus('mytoken');
+     * if (!status.enabled) console.log('Chat is off:', status.reason);
+     * console.log('Slow mode:', status.slowModeSeconds ?? 0, 's');
+     * ```
+     */
+    getChatStatus(tokenName: string): Promise<ChatStatusResponse>;
     /**
      * Disable chat for a specific token.
      *
@@ -3058,11 +3201,7 @@ export declare class LaunchpadSDK {
      * @since 5.4.0 - Added dual-auth support (Admin API key OR JWT owner)
      * @category Chat
      */
-    disableChat(tokenName: string): Promise<{
-        enabled: boolean;
-        tokenName: string;
-        status?: string;
-    }>;
+    disableChat(tokenName: string): Promise<ChatStatusResponse>;
     /**
      * Enable chat for a specific token.
      *
@@ -3079,11 +3218,7 @@ export declare class LaunchpadSDK {
      * @since 5.4.0 - Added dual-auth support (Admin API key OR JWT owner)
      * @category Chat
      */
-    enableChat(tokenName: string): Promise<{
-        enabled: boolean;
-        tokenName: string;
-        status?: string;
-    }>;
+    enableChat(tokenName: string): Promise<ChatStatusResponse>;
     /**
      * Get the currently pinned chat message for a token (v6.x.0+)
      *
@@ -3105,7 +3240,7 @@ export declare class LaunchpadSDK {
      * }
      * ```
      */
-    getPinnedChatMessage(tokenName: string): Promise<LegacyGetPinnedMessageResult>;
+    getPinnedChatMessage(tokenName: string): Promise<GetPinnedMessageResult>;
     /**
      * Pin a chat message for a token (v6.x.0+)
      *
@@ -3114,7 +3249,8 @@ export declare class LaunchpadSDK {
      *
      * @param tokenName Token name (lowercase)
      * @param messageId ID of the message to pin
-     * @returns Pinned message result with confirmation
+     * @returns The token's pinned message as read back after the pin. `pinnedMessage` is null when
+     *   another moderator unpinned it between the two requests.
      * @throws {ValidationError} If token name or message ID is invalid
      * @throws {Error} If user is not authorized to pin messages
      *
@@ -3124,10 +3260,10 @@ export declare class LaunchpadSDK {
      * @example Pin a message
      * ```typescript
      * const result = await sdk.pinChatMessage('mytoken', 'msg123');
-     * console.log('Message pinned:', result.pinnedMessage.id);
+     * console.log('Message pinned:', result.pinnedMessage?.messageId);
      * ```
      */
-    pinChatMessage(tokenName: string, messageId: string): Promise<LegacyPinMessageResult>;
+    pinChatMessage(tokenName: string, messageId: string): Promise<GetPinnedMessageResult>;
     /**
      * Unpin the currently pinned chat message for a token (v6.x.0+)
      *
@@ -3147,7 +3283,7 @@ export declare class LaunchpadSDK {
      * console.log('Message unpinned');
      * ```
      */
-    unpinChatMessage(tokenName: string): Promise<LegacyUnpinMessageResult>;
+    unpinChatMessage(tokenName: string): Promise<UnpinMessageResult>;
     /**
      * Set slow mode interval for a token's chat (v8.x.0+)
      *
@@ -3539,7 +3675,7 @@ export declare class LaunchpadSDK {
      * // Paginate through keys (cursor-based)
      * if (result.pageInfo.hasNextPage) {
      *   const page2 = await sdk.listApiKeys({
-     *     cursor: result.pageInfo.nextCursor,
+     *     cursor: result.pageInfo.endCursor ?? undefined,
      *     pageSize: 10
      *   });
      * }
@@ -4744,7 +4880,7 @@ export declare class LaunchpadSDK {
      *   const result = await sdk.listTokenBans({ cursor, pageSize: 20 });
      *   console.log('Bans:', result.items.map(b => b.tokenName));
      *   hasMore = result.pageInfo.hasNextPage;
-     *   cursor = result.pageInfo.nextCursor;
+     *   cursor = result.pageInfo.endCursor ?? undefined;
      * }
      * ```
      */
@@ -5120,8 +5256,7 @@ export declare class LaunchpadSDK {
      * const { stats } = await sdk.getPlatformStats();
      *
      * // Display volume in millions
-     * const vol24h = parseFloat(stats.galaVolume24h);
-     * console.log(`24h Volume: ${(vol24h / 1_000_000).toFixed(2)}M GALA`);
+     * console.log(`24h Volume: ${(stats.galaVolume24h / 1_000_000).toFixed(2)}M GALA`);
      *
      * // Display token count
      * console.log(`${stats.totalTokens} tokens on platform`);
@@ -5132,6 +5267,55 @@ export declare class LaunchpadSDK {
      * ```
      */
     getPlatformStats(): Promise<GetPlatformStatsResult>;
+    /**
+     * The launchpad backend's dependency health (`GET /health`). Public: no Authorization header.
+     *
+     * A critical dependency being down answers HTTP 503, which throws a `NetworkError`.
+     *
+     * @returns Overall status and the state of each dependency
+     * @since 9.0.0
+     * @category Health
+     *
+     * @example
+     * ```typescript
+     * const health = await sdk.getHealth();
+     * console.log(health.status, health.database?.status, health.redis?.status);
+     * ```
+     */
+    getHealth(): Promise<HealthCheckResponse>;
+    /**
+     * Aggregate event statistics (`GET /v1/events/stats`). Admin API key or Overseer JWT.
+     *
+     * @returns Event totals, today's count, unique users and tokens, and the count per event type
+     * @throws ConfigurationError if neither an admin API key nor a JWT is configured
+     * @since 9.0.0
+     * @category Events
+     *
+     * @example
+     * ```typescript
+     * const stats = await sdk.getEventStats();
+     * console.log(stats.totalEvents, stats.eventsByType);
+     * ```
+     */
+    getEventStats(): Promise<EventStats>;
+    /**
+     * One page of stored events (`GET /v1/events`). Admin API key or Overseer JWT. Paging is offset
+     * style (`page`, `limit` 1..100), not a cursor.
+     *
+     * @param options - Filters (user, token, event types, dates, search), paging and sorting
+     * @returns `{ data, pagination: { page, limit, total, totalPages } }`
+     * @throws ValidationError for an out-of-range limit / page or an unknown sort, preset or source
+     * @throws ConfigurationError if neither an admin API key nor a JWT is configured
+     * @since 9.0.0
+     * @category Events
+     *
+     * @example
+     * ```typescript
+     * const page = await sdk.queryEvents({ tokenName: 'anime', eventTypes: ['token_buy'], page: 1, limit: 50 });
+     * console.log(page.pagination.total, page.data[0]?.eventType);
+     * ```
+     */
+    queryEvents(options?: QueryEventsOptions): Promise<QueryEventsResult>;
     /**
      * Register a push notification device token.
      *
@@ -5575,7 +5759,7 @@ export declare class LaunchpadSDK {
      * @example Get chat messages for a token
      * ```typescript
      * const { messages, pageInfo } = await sdk.fetchMessages({
-     *   type: 'CHAT',
+     *   type: 'CHAT_MESSAGE',
      *   tokenName: 'anime'
      * });
      * console.log(`Found ${pageInfo.totalCount} chat messages`);
@@ -5615,11 +5799,11 @@ export declare class LaunchpadSDK {
      * @example Create a chat message
      * ```typescript
      * const result = await sdk.createMessage({
-     *   type: 'CHAT',
+     *   type: 'CHAT_MESSAGE',
      *   tokenName: 'anime',
      *   content: 'Hello world!'
      * });
-     * console.log('Created message ID:', result.message.id);
+     * console.log('Created message ID:', result.message.messageId);
      * ```
      *
      * @example Create a comment
@@ -5631,7 +5815,7 @@ export declare class LaunchpadSDK {
      * });
      * ```
      */
-    createMessage(options: CreateMessageOptions): Promise<CreateMessageResult>;
+    createMessage<T extends MessageType>(options: CreateMessageOptions<T>): Promise<CreateMessageResult<T>>;
     /**
      * Update a message's content.
      *
@@ -5649,12 +5833,13 @@ export declare class LaunchpadSDK {
      * @example Update a message
      * ```typescript
      * const result = await sdk.updateMessage('msg-1234567890123-abc...', {
-     *   content: 'Updated message content'
+     *   content: 'Updated message content',
+     *   type: 'COMMENT'
      * });
      * console.log('Updated at:', result.message.updatedAt);
      * ```
      */
-    updateMessage(id: string, options: UpdateMessageOptions): Promise<UpdateMessageResult>;
+    updateMessage<T extends MessageType = MessageType>(id: string, options: UpdateMessageOptions<T>): Promise<UpdateMessageResult<T>>;
     /**
      * Delete a message.
      *
@@ -5697,7 +5882,7 @@ export declare class LaunchpadSDK {
      * }
      * ```
      */
-    getPinnedMessage(tokenName: string): Promise<GetPinnedMessageResult>;
+    getPinnedMessage(tokenName: string): Promise<PinnedMessageResult>;
     /**
      * Pin a message.
      *
@@ -5896,7 +6081,7 @@ export declare class LaunchpadSDK {
      *
      * @example Disable chat for a token
      * ```typescript
-     * await sdk.updateTokenConfig('anime', { messagesEnabled: false });
+     * await sdk.updateTokenConfig('anime', { chatEnabled: false });
      * ```
      *
      * @example Enable comments for a token
@@ -5907,7 +6092,7 @@ export declare class LaunchpadSDK {
      * @example Update messaging and comments
      * ```typescript
      * await sdk.updateTokenConfig('anime', {
-     *   messagesEnabled: true,
+     *   chatEnabled: true,
      *   commentsEnabled: false
      * });
      * ```
@@ -5965,8 +6150,8 @@ export declare class LaunchpadSDK {
      *
      * @example Get all trades for a token
      * ```typescript
-     * const { trades, meta } = await sdk.getTrades({ tokenName: 'anime' });
-     * console.log(`Found ${meta.totalItems} trades`);
+     * const { trades, pageInfo } = await sdk.getTrades({ tokenName: 'anime' });
+     * console.log(`Found ${trades.length} trades, more: ${pageInfo.hasNextPage}`);
      * trades.forEach(trade => {
      *   console.log(`${trade.txnType}: ${trade.inputAmount} -> ${trade.outputAmount}`);
      * });
@@ -5974,20 +6159,20 @@ export declare class LaunchpadSDK {
      *
      * @example Get all trades by a user
      * ```typescript
-     * const { trades, meta } = await sdk.getTrades({
+     * const { trades, pageInfo } = await sdk.getTrades({
      *   userAddress: 'eth|1234567890abcdef...'
      * });
-     * console.log(`User has ${meta.totalItems} trades across all tokens`);
+     * console.log(`${trades.length} trades across all tokens, more: ${pageInfo.hasNextPage}`);
      * ```
      *
      * @example Get a user's trades on a specific token with pagination
      * ```typescript
-     * const { trades, meta } = await sdk.getTrades({
+     * const page = await sdk.getTrades({
      *   tokenName: 'anime',
      *   userAddress: 'eth|1234567890abcdef...',
      *   pageSize: 20
      * });
-     * console.log(`Page ${meta.currentPage} of ${meta.totalPages}`);
+     * console.log(`${page.trades.length} trades, next cursor: ${page.pageInfo.endCursor}`);
      * ```
      */
     getTrades(options: GetTradesOptions): Promise<TradesQueryResult>;
@@ -6138,10 +6323,12 @@ export declare class LaunchpadSDK {
     /**
      * Connect to the stream WebSocket server.
      *
-     * Establishes a WebSocket connection for real-time stream events.
-     * Must be called before subscribing to streams or sending chat messages.
+     * Establishes a WebSocket connection for real-time stream events. Idempotent and safe to call
+     * concurrently (one socket). Subscribing opens it by itself, so calling this is only needed to wait for
+     * the connection.
      *
-     * @param callbacks - Event callback handlers
+     * @param callbacks - Event callback handlers: each becomes its own subscriber of its event on every token
+     * (they join no room, and replace nothing registered before); `disconnectStreamWebSocket()` removes them
      * @returns Promise resolving when connected
      * @throws Error if streamWebSocketUrl is not configured
      *
@@ -6167,12 +6354,16 @@ export declare class LaunchpadSDK {
     /**
      * Authenticate the stream WebSocket connection.
      *
-     * Required before sending chat messages via WebSocket.
-     * Uses the configured wallet for authentication.
+     * Required before sending chat messages via WebSocket, and for the user and overseer events.
+     * Opens the connection if it is not open. With an app `session` the token is `session.accessToken()`,
+     * otherwise the SDK's own session token (refreshed when near expiry); pass `token` to use a specific
+     * one, e.g. right after the app refreshed its JWT. After a reconnect the socket re-authenticates
+     * itself with the token current at that moment.
      *
-     * @returns Promise resolving when authenticated
-     * @throws Error if not connected
-     * @throws Error if wallet is not configured
+     * @param token - JWT to authenticate with (default: the session's current token)
+     * @returns Promise resolving `true` once the server confirms; `false` when the server rejects the
+     * token, does not answer within 10 seconds, the connection drops, there is no token, or a newer
+     * `authenticateStreamWebSocket` / `deauthenticateStreamWebSocket` call replaced this one
      *
      * @since 5.1.0
      * @category WebSocket
@@ -6184,15 +6375,30 @@ export declare class LaunchpadSDK {
      * // Now can send chat messages via WebSocket
      * ```
      */
-    authenticateStreamWebSocket(): Promise<void>;
+    authenticateStreamWebSocket(token?: string): Promise<boolean>;
+    /**
+     * Forget the stream socket's authenticated identity (call it when the wallet disconnects).
+     *
+     * Cancels a pending authentication and stops re-authenticating on reconnect. The server has no message
+     * that drops a connection's identity, so an authenticated socket is closed and opened again: your
+     * subscriptions stay registered and are joined again on the new connection.
+     *
+     * @since 9.0.0
+     * @category WebSocket
+     */
+    deauthenticateStreamWebSocket(): void;
     /**
      * Subscribe to real-time events for a stream.
      *
-     * Joins the stream room to receive status updates, viewer counts, and chat messages.
+     * Joins the stream room and registers each callback in `callbacks` as a subscriber of that token.
+     * Calling it again for a token ADDS callbacks (it replaces nothing). The room is joined once however
+     * many callers share it; use the `sdk.realtime.subscribe*` methods for subscriptions that are released
+     * one by one.
      *
      * @param tokenName - Token name (lowercase)
-     * @returns Promise resolving when subscribed
-     * @throws Error if not connected
+     * @param callbacks - Event callbacks for this token
+     * @returns Promise resolving when the server confirms the room
+     * @throws Error if the connection fails or the server does not confirm within 10 seconds
      *
      * @since 5.1.0
      * @category WebSocket
@@ -6209,13 +6415,12 @@ export declare class LaunchpadSDK {
      */
     subscribeToStream(tokenName: string, callbacks?: StreamEventCallbacks): Promise<StreamSubscribedEvent>;
     /**
-     * Unsubscribe from a stream's events.
+     * Remove what `subscribeToStream` registered for a token.
      *
-     * Leaves the stream room and stops receiving events.
+     * The token's room is left when no subscriber of any kind remains for it; other subscribers (from
+     * `sdk.realtime.subscribe*`) are untouched.
      *
      * @param tokenName - Token name (lowercase)
-     * @returns Promise resolving when unsubscribed
-     * @throws Error if not connected
      *
      * @since 5.1.0
      * @category WebSocket
@@ -6331,7 +6536,8 @@ export declare class LaunchpadSDK {
     /**
      * Disconnect from the stream WebSocket server.
      *
-     * Closes the WebSocket connection and cleans up resources.
+     * Closes the WebSocket connection and releases everything it holds: every subscriber, listener and
+     * timer. Unsubscribe functions handed out earlier stay harmless; subscribing again opens a new socket.
      *
      * @since 5.1.0
      * @category WebSocket
@@ -6362,7 +6568,7 @@ export declare class LaunchpadSDK {
      * });
      * ```
      */
-    onStreamStatusChanged(callback: (event: StreamStatusChangedEvent) => void | Promise<void>): () => void;
+    onStreamStatusChanged(callback: RealtimeListener<'STREAM_STATUS'>): Unsubscribe;
     /**
      * Subscribe to user ban events
      *
@@ -6372,7 +6578,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onUserBanned(callback: (event: UserBannedEvent) => void | Promise<void>): () => void;
+    onUserBanned(callback: RealtimeListener<'USER_BANNED'>): Unsubscribe;
     /**
      * Subscribe to user unban events
      *
@@ -6382,7 +6588,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onUserUnbanned(callback: (event: UserUnbannedEvent) => void | Promise<void>): () => void;
+    onUserUnbanned(callback: RealtimeListener<'USER_UNBANNED'>): Unsubscribe;
     /**
      * Subscribe to ban enforcement events (kick, mute, ban)
      *
@@ -6392,7 +6598,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onBanEnforcement(callback: (event: BanEnforcementEvent) => void | Promise<void>): () => void;
+    onBanEnforcement(callback: RealtimeListener<'BAN_ENFORCEMENT'>): Unsubscribe;
     /**
      * Watch all user ban/unban/enforcement events, normalized into a single stream.
      *
@@ -6414,10 +6620,13 @@ export declare class LaunchpadSDK {
      */
     watchBanEnforcement(callback: (event: {
         actionType: 'BANNED' | 'UNBANNED' | 'ENFORCEMENT';
-        userAddress: string;
-        tokenName: string;
+        /** Absent on the copy the backend sends to the banned user themselves (only overseers see it). */
+        userAddress: string | null;
+        /** `null`: a global ban. */
+        tokenName: string | null;
         reason: string | null;
-        timestamp?: string;
+        /** ISO 8601 expiry of a temporary ban. */
+        expiresAt?: string;
     }) => void, filters?: {
         userAddress?: string;
         actionType?: 'BANNED' | 'UNBANNED' | 'ENFORCEMENT';
@@ -6427,15 +6636,10 @@ export declare class LaunchpadSDK {
     /**
      * Shared implementation for watching a per-token stream room event.
      *
-     * The underlying StreamWebSocketService methods (subscribeCommentCreated, etc.) each store
-     * exactly ONE callback slot per event per token - a second concurrent subscribe on the same
-     * event+token would silently replace the first, and the first's cleanup would then delete
-     * the second's still-active callback. This maintains its own fan-out listener Set per
-     * (eventKey, tokenName) so concurrent watchers never clobber each other, calls the real
-     * subscribeXxx() only once per key, and only actually leaves the token's stream room
-     * (unsubscribeFromStream) once every event type's listeners for that token have cleared -
-     * otherwise a short-lived MCP tool call's cleanup could tear down a room another concurrent
-     * watcher on the same token still needs.
+     * The StreamWebSocketService registry serves any number of subscribers per event and token, joins a
+     * token's room on its first subscriber and leaves it on its last, so a watcher is one subscribe call
+     * (the socket opens by itself) and its cleanup is that subscriber's own unsubscribe: another watcher of
+     * the same event and token, or of another event of the same token, is untouched.
      *
      * Requires `filters.tokenName`: these are all per-token room events, so there is no way to
      * "watch every token" the way a genuinely global event (e.g. onLaunchpadTokenCreation) can.
@@ -6627,7 +6831,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onContentFlagged(callback: (event: ContentFlaggedEvent) => void | Promise<void>): () => void;
+    onContentFlagged(callback: RealtimeListener<'CONTENT_FLAGGED'>): Unsubscribe;
     /**
      * Subscribe to flag resolved events
      *
@@ -6637,7 +6841,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onFlagResolved(callback: (event: FlagResolvedEvent) => void | Promise<void>): () => void;
+    onFlagResolved(callback: RealtimeListener<'FLAG_RESOLVED'>): Unsubscribe;
     /**
      * Subscribe to new stream chat messages
      *
@@ -6647,7 +6851,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamChatMessage(callback: (event: StreamChatMessageEvent) => void | Promise<void>): () => void;
+    onStreamChatMessage(callback: RealtimeListener<'STREAM_CHAT_MESSAGE'>): Unsubscribe;
     /**
      * Subscribe to stream chat message updates
      *
@@ -6657,7 +6861,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamChatUpdated(callback: (event: StreamChatUpdatedEvent) => void | Promise<void>): () => void;
+    onStreamChatUpdated(callback: RealtimeListener<'STREAM_CHAT_UPDATED'>): Unsubscribe;
     /**
      * Subscribe to stream chat message deletions
      *
@@ -6667,7 +6871,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamChatDeleted(callback: (event: StreamChatDeletedEvent) => void | Promise<void>): () => void;
+    onStreamChatDeleted(callback: RealtimeListener<'STREAM_CHAT_DELETED'>): Unsubscribe;
     /**
      * Subscribe to stream chat message pins
      *
@@ -6677,7 +6881,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamChatPinned(callback: (event: StreamChatPinnedEvent) => void | Promise<void>): () => void;
+    onStreamChatPinned(callback: RealtimeListener<'STREAM_CHAT_PINNED'>): Unsubscribe;
     /**
      * Subscribe to stream chat message unpins
      *
@@ -6687,7 +6891,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamChatUnpinned(callback: (event: StreamChatUnpinnedEvent) => void | Promise<void>): () => void;
+    onStreamChatUnpinned(callback: RealtimeListener<'STREAM_CHAT_UNPINNED'>): Unsubscribe;
     /**
      * Subscribe to chat status changes (enable/disable)
      *
@@ -6697,7 +6901,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onChatStatusChanged(callback: (event: ChatStatusChangedEvent) => void | Promise<void>): () => void;
+    onChatStatusChanged(callback: RealtimeListener<'CHAT_STATUS_CHANGED'>): Unsubscribe;
     /**
      * Subscribe to viewer count changes
      *
@@ -6707,7 +6911,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onViewerCountChanged(callback: (event: ViewerCountChangedEvent) => void | Promise<void>): () => void;
+    onViewerCountChanged(callback: RealtimeListener<'VIEWER_COUNT'>): Unsubscribe;
     /**
      * Subscribe to recording status changes
      *
@@ -6717,7 +6921,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onRecordingStatusChanged(callback: (event: RecordingStatusChangedEvent) => void | Promise<void>): () => void;
+    onRecordingStatusChanged(callback: RealtimeListener<'RECORDING_STATUS'>): Unsubscribe;
     /**
      * Subscribe to simulcast target status changes
      *
@@ -6727,7 +6931,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onSimulcastStatusChanged(callback: (event: SimulcastStatusChangedEvent) => void | Promise<void>): () => void;
+    onSimulcastStatusChanged(callback: RealtimeListener<'SIMULCAST_STATUS'>): Unsubscribe;
     /**
      * Subscribe to download ready events
      *
@@ -6737,7 +6941,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onDownloadReady(callback: (event: DownloadReadyEvent) => void | Promise<void>): () => void;
+    onDownloadReady(callback: RealtimeListener<'DOWNLOAD_READY'>): Unsubscribe;
     /**
      * Subscribe to recordings count updates
      *
@@ -6747,7 +6951,7 @@ export declare class LaunchpadSDK {
      * @since 9.0.0
      * @category WebSocket
      */
-    onRecordingsCountUpdated(callback: (event: RecordingsCountUpdatedEvent) => void | Promise<void>): () => void;
+    onRecordingsCountUpdated(callback: RealtimeListener<'RECORDINGS_COUNT_UPDATED'>): Unsubscribe;
     /**
      * Subscribe to user typing indicators
      *
@@ -6757,7 +6961,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onUserTyping(callback: (event: UserTypingEvent) => void | Promise<void>): () => void;
+    onUserTyping(callback: RealtimeListener<'USER_TYPING'>): Unsubscribe;
     /**
      * Subscribe to stream reactions (emoji)
      *
@@ -6767,7 +6971,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamReaction(callback: (event: StreamReactionEvent) => void | Promise<void>): () => void;
+    onStreamReaction(callback: RealtimeListener<'STREAM_REACTION'>): Unsubscribe;
     /**
      * Subscribe to content reaction additions
      *
@@ -6777,7 +6981,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onContentReactionAdded(callback: (event: ContentReactionAddedEvent) => void | Promise<void>): () => void;
+    onContentReactionAdded(callback: RealtimeListener<'CONTENT_REACTION_ADDED'>): Unsubscribe;
     /**
      * Subscribe to content reaction removals
      *
@@ -6787,7 +6991,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onContentReactionRemoved(callback: (event: ContentReactionRemovedEvent) => void | Promise<void>): () => void;
+    onContentReactionRemoved(callback: RealtimeListener<'CONTENT_REACTION_REMOVED'>): Unsubscribe;
     /**
      * Subscribe to stream countdown updates
      *
@@ -6797,7 +7001,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamCountdownUpdated(callback: (event: StreamCountdownUpdatedEvent) => void | Promise<void>): () => void;
+    onStreamCountdownUpdated(callback: RealtimeListener<'STREAM_COUNTDOWN_UPDATED'>): Unsubscribe;
     /**
      * Subscribe to stream language updates
      *
@@ -6807,7 +7011,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamLanguageUpdated(callback: (event: StreamLanguageUpdatedEvent) => void | Promise<void>): () => void;
+    onStreamLanguageUpdated(callback: RealtimeListener<'STREAM_LANGUAGE_UPDATED'>): Unsubscribe;
     /**
      * Subscribe to stream control status changes
      *
@@ -6817,7 +7021,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onStreamControlStatusChanged(callback: (event: StreamControlStatusChangedEvent) => void | Promise<void>): () => void;
+    onStreamControlStatusChanged(callback: RealtimeListener<'STREAM_CONTROL_STATUS_CHANGED'>): Unsubscribe;
     /**
      * Subscribe to WebSocket connection events
      *
@@ -6827,7 +7031,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onConnection(callback: (event: ConnectionEvent) => void | Promise<void>): () => void;
+    onConnection(callback: RealtimeListener<'connection'>): Unsubscribe;
     /**
      * Subscribe to WebSocket authentication events
      *
@@ -6837,7 +7041,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onAuthenticated(callback: (event: AuthenticatedEvent) => void | Promise<void>): () => void;
+    onAuthenticated(callback: RealtimeListener<'authenticated'>): Unsubscribe;
     /**
      * Subscribe to token stream room subscription events
      *
@@ -6847,7 +7051,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onTokenSubscribed(callback: (event: TokenSubscribedEvent) => void | Promise<void>): () => void;
+    onTokenSubscribed(callback: RealtimeListener<'token_subscribed'>): Unsubscribe;
     /**
      * Subscribe to token stream room unsubscription events
      *
@@ -6857,7 +7061,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onTokenUnsubscribed(callback: (event: TokenUnsubscribedEvent) => void | Promise<void>): () => void;
+    onTokenUnsubscribed(callback: RealtimeListener<'token_unsubscribed'>): Unsubscribe;
     /**
      * Subscribe to comment room subscription events
      *
@@ -6867,7 +7071,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onRoomSubscribed(callback: (event: RoomSubscribedEvent) => void | Promise<void>): () => void;
+    onRoomSubscribed(callback: RealtimeListener<'room_subscribed'>): Unsubscribe;
     /**
      * Subscribe to comment room unsubscription events
      *
@@ -6877,7 +7081,7 @@ export declare class LaunchpadSDK {
      * @since 5.12.0
      * @category WebSocket
      */
-    onRoomLeft(callback: (event: RoomLeftEvent) => void | Promise<void>): () => void;
+    onRoomLeft(callback: RealtimeListener<'room_left'>): Unsubscribe;
     /**
      * Subscribe to engagement stats update events
      *
@@ -6899,7 +7103,7 @@ export declare class LaunchpadSDK {
      * });
      * ```
      */
-    onEngagementStatsUpdated(callback: (event: EngagementStatsUpdatedEvent) => void): () => void;
+    onEngagementStatsUpdated(callback: RealtimeListener<'ENGAGEMENT_STATS_UPDATED'>): Unsubscribe;
     /**
      * Estimate bridge fees for a cross-chain transfer.
      *
@@ -7687,7 +7891,7 @@ export declare class LaunchpadSDK {
      *
      * @category Token Creation
      * @param data - Token launch configuration
-     * @param data.tokenName - Unique token name (3-20 lowercase alphanumeric, required)
+     * @param data.tokenName - Unique token name (1-25 letters and digits, required)
      * @param data.tokenSymbol - Token symbol (3-6 characters, required)
      * @param data.tokenDescription - Token description (optional)
      * @param data.tokenImage - Image URL or path (optional)
@@ -7776,49 +7980,33 @@ export declare class LaunchpadSDK {
      */
     launchToken(data: LaunchTokenData): Promise<TokenLaunchResult>;
     /**
-     * Upload a token image to the launchpad server
-     *
-     * Uploads an image file from the local filesystem for a specific token. The image is stored on the
-     * launchpad server and can be displayed in the UI and API responses. Supports common image formats
-     * (PNG, JPG, GIF) and automatically handles image validation and optimization.
+     * Upload a token image (`POST /v1/tokens/:tokenName/image`)
      *
-     * **Important:** This method is only available in Node.js environments (not in browsers).
-     * Use for backend applications, build scripts, or CLI tools that manage token metadata.
-     *
-     * **Requires wallet configuration** for authentication. Use optional `privateKey` parameter
-     * to override the default wallet for this operation.
+     * Takes the image as a browser `File` or a Node.js `Buffer` and answers the URL it is served from.
+     * The route needs only the logged-in session's bearer: it works on an SDK configured with a signer
+     * and a wallet address (and a `session`, or after `login()`), with no `wallet`. The token must be
+     * the caller's to manage; the backend answers 403 otherwise.
      *
      * @category Main SDK
-     * @param options - Image upload options with required tokenName and imagePath
-     * @param options.tokenName - Token name to upload image for (3-20 lowercase alphanumeric)
-     * @param options.imagePath - Absolute filesystem path to the image file (e.g., '/path/to/image.png')
-     * @param options.privateKey - Optional private key override for this operation (format: 0x + 64 hex characters)
+     * @param options - `{ tokenName, options: { file } }`
+     * @param options.tokenName - Token name to upload the image for (letters and digits, the path name the pool lookup resolves)
+     * @param options.options.file - The image: a `File` (browser) or `Buffer` (Node.js), PNG or JPEG
+     * @param options.privateKey - Optional private key override for this operation (format: 0x + 64 hex characters); signs in as that wallet
      * @returns Promise<string> URL where the image is hosted and can be accessed
-     * @throws {ValidationError} If tokenName is invalid, imagePath doesn't exist, or wallet not configured
-     * @throws {FileError} If image file cannot be read or is too large
-     * @throws {NetworkError} If upload request fails
+     * @throws {ValidationError} If tokenName is invalid or the file is not an image
+     * @throws {ConfigurationError} If there is no session or logged-in token
+     * @throws {NetworkError} If upload request fails (the backend's answer is kept: its size limit, 403, 404)
      * @since 4.0.4-beta.0
+     * @since 9.0.0 - needs no `wallet` (it threw "Wallet is required" on a signer-plus-address SDK)
      *
-     * @example Upload image from file
+     * @example Upload an image
      * ```typescript
-     * import path from 'path';
-     *
      * const imageUrl = await sdk.uploadTokenImage({
      *   tokenName: 'mytoken',
-     *   imagePath: path.join(process.cwd(), 'token-image.png')
+     *   options: { file: imageBuffer }
      * });
-     *
      * console.log(`Image uploaded: ${imageUrl}`);
      * ```
-     *
-     * @example Upload with private key override
-     * ```typescript
-     * const imageUrl = await sdk.uploadTokenImage({
-     *   tokenName: 'mytoken',
-     *   imagePath: '/absolute/path/to/image.png',
-     *   privateKey: process.env.ALTERNATIVE_PRIVATE_KEY
-     * });
-     * ```
      */
     uploadTokenImage(options: UploadImageByTokenNameOptions): Promise<string>;
     /**
@@ -7853,7 +8041,7 @@ export declare class LaunchpadSDK {
      * attempting to launch a token to prevent registration failures.
      *
      * @category Token Validation
-     * @param tokenName - Token name to check availability for (3-20 lowercase alphanumeric characters)
+     * @param tokenName - Token name to check availability for (letters and digits, up to 25 characters)
      * @returns Promise resolving to true if name is available, false if already taken
      * @throws {ValidationError} If tokenName format is invalid
      * @throws {NetworkError} If API request fails
@@ -7963,9 +8151,9 @@ export declare class LaunchpadSDK {
     /**
      * Fetch user profile information by wallet address
      *
-     * Retrieves public profile metadata for a specific wallet address, including name,
-     * profile image URL, and other user-provided information. Returns null if no profile
-     * has been created for the address.
+     * `GET /v1/users/:address` (public, no authentication): name, profile image, bio, aggregated stats
+     * and the four badge ladders. An address with no profile row still answers a profile (`fullName`,
+     * `profileImage` and `bio` are null).
      *
      * **Supports both address formats:**
      * - Standard Ethereum format: `0x...` (64 hex characters after 0x prefix)
@@ -7973,29 +8161,25 @@ export declare class LaunchpadSDK {
      *
      * @category Main SDK
      * @param address - Optional wallet address in 0x... or eth|... format. Defaults to current SDK wallet address.
-     * @returns Promise<UserProfile | null> User profile data with name, image, and metadata, or null if no profile exists
+     * @returns The public profile (the `data` of the backend's envelope)
      * @throws {ValidationError} If wallet is not configured and no address is provided
-     * @throws {NetworkError} If launchpad API request fails
+     * @throws {NetworkError} If launchpad API request fails, or answers a body that is not a profile
      * @since 4.0.4-beta.0
+     * @since 9.0.0 - typed `PublicUserProfile` (it returned the whole `{ data }` envelope as `unknown`)
      *
      * @example Fetch current user's profile
      * ```typescript
      * const profile = await sdk.fetchProfile();
-     * if (profile) {
-     *   console.log(`User: ${profile.fullName}`);
-     *   console.log(`Image: ${profile.profileImage}`);
-     * } else {
-     *   console.log('No profile created yet');
-     * }
+     * console.log(`User: ${profile.fullName}, tokens created: ${profile.stats.tokensCreated}`);
      * ```
      *
      * @example Fetch profile for specific address
      * ```typescript
      * const profile = await sdk.fetchProfile('eth|742d35Cc6634C0532925a3b8D0Ea2c76f94C31C0');
-     * console.log(`Profile owner: ${profile?.fullName}`);
+     * console.log(`Profile owner: ${profile.fullName}`);
      * ```
      */
-    fetchProfile(address?: string): Promise<unknown>;
+    fetchProfile(address?: string): Promise<PublicUserProfile>;
     /**
      * Fetch the current user's referral URL
      *
@@ -8157,17 +8341,17 @@ export declare class LaunchpadSDK {
      * Only the wallet owner can update their own profile. Changes take effect immediately after
      * successful submission to the launchpad server.
      *
-     * **Requires wallet configuration** for authentication. Use optional `privateKey` parameter
-     * to override the default wallet for this operation.
+     * **Requires a JWT** (the backend updates the user of the token). Only the fields given are sent:
+     * an omitted field is left as it is, `profileImage: ''` clears the image.
      *
      * @category Main SDK
-     * @param data - Profile update data with wallet address and fields to update
-     * @param data.address - Wallet address to update profile for (required, 0x... or eth|... format)
-     * @param data.fullName - User's full name (optional, max 100 characters)
-     * @param data.profileImage - Profile image URL (optional, can be empty string to clear)
+     * @param data - Profile update data (at least one of fullName and profileImage)
+     * @param data.address - Optional (0x... or eth|... format); validated, not sent
+     * @param data.fullName - User's full name (optional, 2 to 20 letters, a second word allowed)
+     * @param data.profileImage - Profile image URL (optional, `''` clears it, null leaves it)
      * @param data.privateKey - Optional private key override for this operation (format: 0x + 64 hex characters)
      * @returns Promise<void> No return data - throws on failure
-     * @throws {ValidationError} If address format is invalid, wallet not configured, or user is not authorized
+     * @throws {ValidationError} If the address or name is invalid or nothing is given
      * @throws {NetworkError} If launchpad API request fails
      * @since 4.0.4-beta.0
      *
@@ -8200,55 +8384,30 @@ export declare class LaunchpadSDK {
      */
     updateProfile(data: UpdateProfileData): Promise<void>;
     /**
-     * Upload a profile image for a user wallet
-     *
-     * Uploads an image file from the local filesystem as a user's profile picture. The image is stored on the
-     * launchpad server and displayed in user profiles and UI throughout the platform. Supports common image formats
-     * (PNG, JPG, GIF) and automatically handles image validation and optimization.
-     *
-     * **Important:** This method is only available in Node.js environments (not in browsers).
-     * Use for backend applications, build scripts, or CLI tools that manage user profiles.
+     * Upload a profile image for the logged-in user (`POST /v1/users/me/image`)
      *
-     * **Requires wallet configuration** for authentication. The wallet owner can only upload an image for their own profile.
-     * Use optional `privateKey` parameter to override the default wallet for this operation.
+     * Takes the image as a browser `File` or a Node.js `Buffer` and answers the URL it is served from.
+     * The backend uploads for the user of the session JWT, so the route needs no address and no `wallet`:
+     * it works on an SDK configured with a signer and a wallet address (and a `session`, or after
+     * `login()`). An `address` that is given is validated and only names the multipart file.
      *
      * @category Main SDK
      * @param options - Profile image upload options
-     * @param options.imagePath - Absolute filesystem path to the image file (e.g., '/path/to/profile-pic.png')
-     * @param options.address - Optional wallet address for profile (0x... or eth|... format). Defaults to current SDK wallet address.
-     * @param options.privateKey - Optional private key override for this operation (format: 0x + 64 hex characters)
+     * @param options.file - The image: a `File` (browser) or `Buffer` (Node.js), PNG or JPEG
+     * @param options.address - Optional address (0x... or eth|... or client|...); validated, not sent
+     * @param options.privateKey - Optional private key override for this operation (format: 0x + 64 hex characters); signs in as that wallet
      * @returns Promise<string> URL where the profile image is hosted and can be accessed
-     * @throws {ValidationError} If imagePath doesn't exist, wallet not configured, or user is not authorized
-     * @throws {FileError} If image file cannot be read or is too large
-     * @throws {NetworkError} If upload request fails
+     * @throws {ValidationError} If the address is not a valid address
+     * @throws {ConfigurationError} If there is no session or logged-in token
+     * @throws {NetworkError} If upload request fails (the backend's answer is kept: its size limit, 400 for a bad format)
      * @since 4.0.4-beta.0
+     * @since 9.0.0 - needs no `wallet` and no address (it threw "Wallet is required" on a signer-plus-address SDK)
      *
-     * @example Upload profile image from file
+     * @example Upload a profile image
      * ```typescript
-     * import path from 'path';
-     *
-     * const imageUrl = await sdk.uploadProfileImage({
-     *   imagePath: path.join(process.cwd(), 'profile-picture.png')
-     * });
-     *
+     * const imageUrl = await sdk.uploadProfileImage({ file: imageBuffer });
      * console.log(`Profile image uploaded: ${imageUrl}`);
      * ```
-     *
-     * @example Upload image for specific address
-     * ```typescript
-     * const imageUrl = await sdk.uploadProfileImage({
-     *   imagePath: '/absolute/path/to/profile.png',
-     *   address: 'eth|742d35Cc6634C0532925a3b8D0Ea2c76f94C31C0'
-     * });
-     * ```
-     *
-     * @example Upload with private key override
-     * ```typescript
-     * const imageUrl = await sdk.uploadProfileImage({
-     *   imagePath: '/absolute/path/to/profile.png',
-     *   privateKey: process.env.ALTERNATIVE_PRIVATE_KEY
-     * });
-     * ```
      */
     uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
     /**
@@ -8356,6 +8515,42 @@ export declare class LaunchpadSDK {
      * ```
      */
     getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
+    /**
+     * A user's GALA balance and its USD value, as the launchpad backend reads them from the chain
+     * (`GET /v1/users/:address/gala-balance`). Public; the backend never caches it. For a chain read
+     * through the gateway instead, use {@link LaunchpadSDK.fetchGalaBalance}.
+     *
+     * @param address - The user's address (`eth|...`, `0x...` or `client|...`)
+     * @returns `{ name: 'GALA', quantity, price, holdingPrice }`
+     * @throws ValidationError if no address is given
+     * @throws NetworkError if the backend cannot read the balance or the GALA price
+     * @since 9.0.0
+     * @category User Management
+     *
+     * @example
+     * ```typescript
+     * const gala = await sdk.getUserGalaBalance('eth|1234567890abcdef1234567890abcdef12345678');
+     * console.log(`${gala.quantity} GALA = $${gala.holdingPrice}`);
+     * ```
+     */
+    getUserGalaBalance(address: string): Promise<UserGalaBalance>;
+    /**
+     * The authenticated user's referral code (`GET /v1/connect/users/referrals/code`, JWT session;
+     * the backend asks Gala Connect for the wallet of the token). Not {@link LaunchpadSDK.fetchReferralUrl},
+     * which is the DEX API's link for the SDK wallet.
+     *
+     * @returns `{ code, username? }`
+     * @throws ConfigurationError if no JWT session is configured
+     * @since 9.0.0
+     * @category User Management
+     *
+     * @example
+     * ```typescript
+     * const { code } = await sdk.fetchReferralCode();
+     * console.log(`https://pump.gala.com/?ref=${code}`);
+     * ```
+     */
+    fetchReferralCode(): Promise<ReferralCode>;
     /**
      * Transfer GALA tokens between wallets
      *