@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.1

package/dist/LaunchpadSDK.d.ts

@@ -1,14 +1,16 @@
+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 { GSwap } from '@gala-chain/gswap-sdk';
-import type { BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeToken, BridgeTransaction, EstimateBridgeFeeParams, EthereumTransactionStatus, EthereumWalletBalanceResult, ExternalChainBalance, SolanaTransactionStatus, SolanaWalletBalanceResult } from './bridge/types/bridge.dto';
-import type { BridgeableNetwork, FetchBridgeableTokensOptions, FetchBridgeableTokensResult, IsTokenBridgeableOptions, IsTokenBridgeableResult } from './bridge/types/bridgeable-token.dto';
+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 { HttpRequestor } from './launchpad/bundle-submission';
 import type { LaunchpadSigner } from './signing';
-import { TokenWrites } from './tokens/transfers';
 import type { GetAIModerationOptions, GetAIModerationResult, GetAIModerationSettingsResult, GetAIModerationStatusResult, TriggerAIModerationOptions, TriggerAIModerationResult, UpdateAIModerationSettingsOptions, UpdateAIModerationSettingsResult } from './types/ai-moderation.dto';
 import type { ApiKeyData, ApiKeyListResponse, CreateApiKeyOptions, CreateApiKeyResponse, ListApiKeysOptions, UpdateApiKeyOptions } from './types/api-key.dto';
 import type { ActiveUsersResult, BanListResult, BanStatusResult, CreateBanOptions, CreateBanResult, CreateGlobalBanOptions, CreateGlobalBanResult, GetActiveUsersOptions, GetBanStatusOptions, GetGlobalBanOptions, GlobalBanListResult, GlobalBanStatusResult, ListBansOptions, ListGlobalBansOptions, RemoveBanOptions, RemoveBanResult, RemoveGlobalBanOptions, RemoveGlobalBanResult } from './types/ban.dto';
@@ -17,14 +19,14 @@ import type { FlushResult } from './types/cache-management.dto';
 import type { CreateChatMessageOptions, CreateChatMessageResult, GetChatMessagesOptions, GetChatMessagesResult, UpdateChatMessageOptions, UpdateChatMessageResult } from './types/chat-messages.dto';
 import type { GetClientFlagsResult } from './types/client-config.dto';
 import type { CommentsResult, CreateCommentOptions, CreateCommentResult, DeleteCommentResult, GetCommentsOptions, UpdateCommentOptions, UpdateCommentResult } from './types/comments.dto';
-import type { AddressFormat, ApiResponse, SDKConfig, TokenClassKey, TokenId } from './types/common';
+import type { AddressFormat, ApiResponse, SDKConfig, TokenId } from './types/common';
 import type { ActionFlagOptions, ActionFlagResult, CreateFlagOptions, CreateFlagResult, DismissFlagOptions, DismissFlagResult, FlagListResult, ListFlagsOptions, ListGlobalFlagsOptions } from './types/content-flag.dto';
 import type { AddContentReactionOptions, AddContentReactionResult, RemoveContentReactionOptions, RemoveContentReactionResult } from './types/content-reactions.dto';
 import type { FetchTokenStatsResult } from './types/engagement-stats.dto';
-import type { AmountCalculationResult, DexAggregatedVolumeSummary, DexSeason, FetchPoolsOptions, GalaChainTokenDetails, GraduationCalculationResult, GraphDataResult, LaunchTokenData, LeaderboardResult, PoolData, PoolsResult, SaleDetailsResult, TokenClassWithSupply, TokenDistributionResult, TokenHolder, TokenSpotPrice, TradeQuoteParams, UserHolderContext, ValidateTokenResponse } from './types/launchpad.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';
@@ -32,28 +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 type { FetchWrappableTokensOptions, FetchWrappableTokensResult, IsTokenWrappableResult, UnwrapTokenOptions, WrappableToken, WrapTokenOptions, WrapUnwrapFeeEstimate, WrapUnwrapResult, WrapUnwrapStatusResult } from './types/wrappable-token.dto';
 import { TransactionFailedError, WebSocketError, WebSocketTimeoutError } from './utils/websocket-errors';
-import type { WalletProvider } from './wallet/types';
+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 { FetchPriceHistoryOptions, PriceHistoryResult } from './types/priceHistory.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
  *
@@ -106,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
@@ -131,7 +166,7 @@ export interface LaunchpadSDKConfig extends SDKConfig {
      *
      * @example Using private key (Node.js/CLI)
      * ```typescript
-     * import { PrivateKeyProvider } from '@gala-chain/launchpad-sdk/wallet';
+     * import { PrivateKeyProvider } from '@gala-chain/gala-core-sdk/providers';
      *
      * const provider = new PrivateKeyProvider('0x...');
      * const sdk = new LaunchpadSDK({
@@ -142,7 +177,7 @@ export interface LaunchpadSDKConfig extends SDKConfig {
      *
      * @example Using browser wallet (React/Vue)
      * ```typescript
-     * import { ExternalWalletProvider, detectWallets } from '@gala-chain/launchpad-sdk/wallet';
+     * import { ExternalWalletProvider, detectWallets } from '@gala-chain/gala-core-sdk/providers';
      *
      * const { wallets } = await detectWallets();
      * const provider = new ExternalWalletProvider(wallets[0].provider);
@@ -270,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.
      *
@@ -282,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;
@@ -292,9 +357,15 @@ export declare class LaunchpadSDK {
     /** Default calculation mode for all amount calculations - 'local' for instant client-side bonding curve calculations */
     static readonly DEFAULT_CALCULATE_AMOUNT_MODE: 'local' | 'external';
     private wallet;
-    private readonly galaChainAddressOverride;
-    /** Declared identity: explicit `walletAddress`, else (without a wallet) the signer's own address. */
-    private readonly signerWalletAddress;
+    /** Declared `galaChainAddress` (e.g. a `client|` alias): the construction key's, dropped when the wallet changes. */
+    private galaChainAddressOverride;
+    /**
+     * Declared identity: explicit `walletAddress`, else (without a wallet) the signer's own address.
+     * Dropped when the wallet changes (it named the construction key, not the new one).
+     */
+    private signerWalletAddress;
+    /** The token-write signer and identity of an SDK with no wallet (`{ signer, walletAddress }`). */
+    private tokenWriter;
     private readonly auth;
     private readonly jwtAuth;
     private readonly sessionAuth;
@@ -310,33 +381,29 @@ export declare class LaunchpadSDK {
     private readonly maxAcceptableReverseBondingCurveFeeSlippageFactor;
     private readonly calculateAmountMode;
     private readonly logger;
-    private readonly dexClient;
     private readonly tokenResolverService;
     private readonly launchpadService;
-    private readonly galaChainService;
-    private readonly dexService;
-    private readonly bundleService;
+    /** Rebuilt whenever the wallet changes: its token writes sign as the wallet it was built with. */
+    private galaChainService;
+    private readonly priceService;
+    /** Signs bundle trades as the wallet: rebuilt when the wallet changes (see onWalletChanged). */
+    private bundleService;
+    /** The sell fee ceiling resolver every BundleService of this SDK uses. */
+    private readonly sellFeeCeiling;
     private readonly websocketService;
-    private readonly priceHistoryService;
     private readonly cache;
-    private _bridgeService?;
+    /** 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?;
-    private _wrapService?;
-    private _galaConnectClient?;
+    private _wrapService;
+    private _galaConnectClient;
     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;
@@ -353,6 +420,8 @@ export declare class LaunchpadSDK {
     private _weeklyChallengeService;
     private _oembedService;
     private _platformStatsService;
+    private _healthService;
+    private _eventsQueryService;
     private _notificationService;
     private _clientConfigService;
     private readonly nftCollectionService;
@@ -360,8 +429,6 @@ export declare class LaunchpadSDK {
     private readonly launchpadAPI;
     /** v6 launchpad write surface. */
     readonly launchpad: LaunchpadWrites;
-    /** v6 native token write surface. */
-    readonly tokens: TokenWrites;
     constructor(config: LaunchpadSDKConfig);
     /**
      * Creates a temporary SDK instance with a different wallet for privateKey override operations.
@@ -373,18 +440,6 @@ export declare class LaunchpadSDK {
      * @throws Error if privateKey format is invalid
      */
     private createOverrideSdk;
-    /**
-     * Access the shared GSwap DEX client.
-     *
-     * @returns The single `@gala-chain/gswap-sdk` client configured with this SDK's signer and hosts.
-     *
-     * @example
-     * ```typescript
-     * const quote = await sdk.dex.quoting.quoteExactInput('GALA', 'GUSDC', '1');
-     * console.log(quote.amountOut);
-     * ```
-     */
-    get dex(): GSwap;
     /**
      * Gets the authenticated user's address in backend format
      *
@@ -480,6 +535,11 @@ export declare class LaunchpadSDK {
      * ```
      */
     validateWallet(): Wallet;
+    /**
+     * Token writes (transfer, burn, lock, unlock) need the wallet, or (an SDK configured with
+     * `{ signer, walletAddress }`) a declared signer and identity. Same error as `validateWallet`.
+     */
+    private assertTokenWriter;
     /**
      * Sets or updates the wallet for the SDK
      *
@@ -516,6 +576,27 @@ export declare class LaunchpadSDK {
      * ```
      */
     setWallet(wallet: Wallet): void;
+    /**
+     * Everything the SDK built around the previous wallet's key or address follows the new one, so no
+     * write signs as, and no request is sent from, an identity the SDK no longer has:
+     * - an identity declared at construction (`walletAddress`, `galaChainAddress`) named the
+     *   construction key: it is dropped, and `getAddress()` is the new wallet's;
+     * - the token writes (transfer, burn, lock, unlock) and the bundle trades (`buyTokens`,
+     *   `sellTokens`) are rebuilt for the new wallet now;
+     * - the bridge service, the wrap service and the GalaConnect client (built on first use with the
+     *   wallet's key and address) are dropped, and the next bridge, wrap or GalaConnect call builds
+     *   them for the new wallet.
+     */
+    private onWalletChanged;
+    /** The bundle trading service, signing as the current wallet (none: trading is refused). */
+    private createBundleService;
+    /**
+     * The token writes (transfer, burn, lock, unlock) sign as the wallet the GalaChain service was
+     * built with, so the service is rebuilt whenever the wallet changes: a write never signs as, or
+     * is made from, an identity the SDK no longer has. A declared `{ signer, walletAddress }` identity
+     * from construction no longer applies once the wallet changes (no wallet then means no writes).
+     */
+    private rebuildTokenWrites;
     /**
      * Sets or updates the wallet provider for authentication
      *
@@ -526,7 +607,7 @@ export declare class LaunchpadSDK {
      *
      * @example
      * ```typescript
-     * import { ExternalWalletProvider, detectWallets } from '@gala-chain/launchpad-sdk/wallet';
+     * import { ExternalWalletProvider, detectWallets } from '@gala-chain/gala-core-sdk/providers';
      *
      * // Detect available wallets
      * const { wallets } = await detectWallets();
@@ -730,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
@@ -737,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}`);
      * ```
@@ -836,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
      *
@@ -1021,74 +1102,47 @@ export declare class LaunchpadSDK {
      */
     fetchUserHolderContext(tokenName: string, userAddress: string): Promise<UserHolderContext>;
     /**
-     * Fetch USD spot price for any token with smart routing
+     * Fetch a launchpad token's USD spot price.
      *
-     * Unified smart router that accepts either tokenName (launchpad tokens) or tokenId (DEX tokens).
-     * Automatically detects token type and routes to the correct backend:
-     * - **tokenName** → Launchpad token with graduation detection (bonding curve or DEX pricing)
-     * - **tokenId** → DEX Backend API `/market/price` (direct pricing)
+     * - A token still on its bonding curve: GALA's USD price divided by the tokens 1 GALA buys
+     *   (the launchpad backend's bonding-curve calculation).
+     * - A graduated token: its USD price on the swap backend.
      *
-     * @param params Options with either tokenName or tokenId (mutually exclusive)
-     * @returns Promise<TokenSpotPrice> Single token's spot price data
+     * Only launchpad tokens (by name) are priced here. Any token by class key, and GALA itself, is
+     * priced by gswap-sdk: `gSwap.market.getPrice('GALA|Unit|none|none')`.
      *
-     * @example Launchpad token by name (auto-detects graduation status)
-     * ```typescript
-     * const price = await sdk.fetchTokenPrice({ tokenName: 'galadog' });
-     * console.log(`${price.symbol}: $${price.price.toFixed(6)}`);
-     * // Returns DEX price for graduated tokens, bonding curve price for active tokens
-     * ```
+     * @param params The launchpad token's name
+     * @returns Promise<TokenSpotPrice> The token's symbol and USD price
      *
-     * @example DEX token by tokenId
+     * @example
      * ```typescript
-     * const price = await sdk.fetchTokenPrice({
-     *   tokenId: 'Token|Unit|GDOG|eth:0x...'
-     * });
+     * const price = await sdk.fetchTokenPrice({ tokenName: 'galadog' });
      * console.log(`${price.symbol}: $${price.price.toFixed(6)}`);
      * ```
      *
-     * @throws ValidationError if neither tokenName nor tokenId provided
-     * @throws ValidationError if both tokenName and tokenId provided
-     * @throws Error if API request fails or token not found
+     * @throws ValidationError if `tokenName` is missing or empty, or a `tokenId` is given
+     * @throws NetworkError if the calculation or a price read fails
      */
     fetchTokenPrice(params: FetchTokenSpotPriceParams): Promise<TokenSpotPrice>;
     /**
-     * Fetch current GALA token USD spot price
-     *
-     * Convenience method for fetching GALA price specifically via the DEX Backend API.
-     * Uses the smart router with the standard GALA token ID.
+     * Fetch comprehensive token details from GalaChain
      *
-     * @returns Promise<TokenSpotPrice> GALA spot price data with symbol and USD price
-     *
-     * @example
-     * ```typescript
-     * const galaPrice = await sdk.fetchGalaPrice();
-     * console.log(`GALA: $${galaPrice.price.toFixed(6)}`);
-     * ```
-     *
-     * @throws Error if GALA price not available
-     * @throws Error if DEX Backend API client not configured
-     */
-    fetchGalaPrice(): Promise<TokenSpotPrice>;
-    /**
-     * Fetch comprehensive token details from DEX API platform
-     *
-     * Queries the DEX API platform endpoint to retrieve complete token metadata
-     * including image, decimals, description, verification status, network information,
-     * and trading capabilities.
+     * Reads the token's GalaChain token class (symbol, decimals, name, image, description, network,
+     * contract address).
      *
      * Supports flexible token identification using either string or object format:
      * - String: `'GUSDC|Unit|none|eth:0x...'` (pipe-delimited)
      * - Object: `{ collection, category, type, additionalKey }`
      *
      * @param tokenId Token identifier in flexible format
-     * @returns Promise<TokenDetails> Comprehensive token metadata
+     * @returns Promise<GalaChainTokenDetails> The token class's details (gala-core-sdk's type)
      *
      * @example String format
      * ```typescript
      * const details = await sdk.fetchTokenDetails('GUSDC|Unit|none|none');
      * console.log(details.symbol);      // 'GUSDC'
      * console.log(details.decimals);    // 6
-     * console.log(details.verified);    // true
+     * console.log(details.network);     // the token's network
      * console.log(details.image);       // 'https://...'
      * ```
      *
@@ -1106,156 +1160,6 @@ export declare class LaunchpadSDK {
      * @throws {NetworkError} If API request fails or token not found
      */
     fetchTokenDetails(tokenId: TokenId): Promise<GalaChainTokenDetails>;
-    /**
-     * Fetch all available DEX leaderboard seasons
-     *
-     * Returns all season configurations with time ranges. Use season IDs
-     * to fetch specific leaderboards with `fetchDexLeaderboardBySeasonId()`.
-     *
-     * @category DEX Leaderboard
-     * @returns Promise<DexSeason[]> Array of all seasons
-     * @throws {NetworkError} If API request fails
-     * @since 3.X.0
-     *
-     * @example
-     * ```typescript
-     * const seasons = await sdk.fetchAllDexSeasons();
-     * console.log(`Found ${seasons.length} seasons`);
-     * seasons.forEach(s => {
-     *   console.log(`${s.name}: ${s.start} to ${s.end}`);
-     * });
-     * ```
-     */
-    fetchAllDexSeasons(): Promise<DexSeason[]>;
-    /**
-     * Find the currently active DEX leaderboard season
-     *
-     * Determines which season is active based on current time falling
-     * between season start and end dates. Returns null if no season
-     * is currently active.
-     *
-     * @category DEX Leaderboard
-     * @returns Promise<DexSeason | null> Current season or null
-     * @throws {NetworkError} If API request fails
-     * @since 3.X.0
-     *
-     * @example
-     * ```typescript
-     * const current = await sdk.fetchCurrentDexSeason();
-     * if (current) {
-     *   console.log(`Active: ${current.name} (ID: ${current.id})`);
-     * } else {
-     *   console.log('No active season');
-     * }
-     * ```
-     */
-    fetchCurrentDexSeason(): Promise<DexSeason | null>;
-    /**
-     * Fetch DEX leaderboard for a specific season
-     *
-     * Returns complete leaderboard rankings with XP metrics and achievement titles.
-     * Non-paginated response includes all entries (typically 100 participants).
-     *
-     * **XP Metrics:**
-     * - `totalXp`: Combined liquidity + trading XP
-     * - `liquidityXp`: Points from providing liquidity
-     * - `tradingXp`: Points from trading volume
-     *
-     * **Achievement Titles:**
-     * - Liquidity titles: Pool Explorer, Flow Enabler, Yield Artisan, etc.
-     * - Trading titles: Novice Trader, Rookie Trader, Elite Trader, etc.
-     * - Order indicates tier (1 = entry level, higher = more advanced)
-     *
-     * @category DEX Leaderboard
-     * @param seasonId Season identifier number (must be positive integer)
-     * @returns Promise<LeaderboardResult> Complete leaderboard with rankings and metrics
-     * @throws {RequiredFieldError} If seasonId is invalid
-     * @throws {NetworkError} If API request fails
-     * @since 3.X.0
-     *
-     * @example
-     * ```typescript
-     * // Fetch specific season leaderboard
-     * const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(4);
-     *
-     * // Display top trader
-     * const topTrader = leaderboard.entries[0];
-     * console.log(`Rank 1: ${topTrader.wallet}`);
-     * console.log(`Total XP: ${topTrader.totalXp}`);
-     * console.log(`Distribution: ${topTrader.distributionPercent}%`);
-     *
-     * // Find users with specific titles
-     * const whales = leaderboard.entries.filter(entry =>
-     *   entry.masteryTitles.some(t => t.name === 'Protocol Whale')
-     * );
-     * ```
-     */
-    fetchDexLeaderboardBySeasonId(seasonId: number): Promise<LeaderboardResult>;
-    /**
-     * Fetch leaderboard for the currently active season
-     *
-     * Convenience method that automatically determines the current season
-     * and fetches its leaderboard. Returns null if no season is active.
-     *
-     * Equivalent to:
-     * ```typescript
-     * const season = await sdk.fetchCurrentDexSeason();
-     * return season ? sdk.fetchDexLeaderboardBySeasonId(season.id) : null;
-     * ```
-     *
-     * @category DEX Leaderboard
-     * @returns Promise<LeaderboardResult | null> Current leaderboard or null
-     * @throws {NetworkError} If API request fails
-     * @since 3.X.0
-     *
-     * @example
-     * ```typescript
-     * // Get current leaderboard in one call
-     * const leaderboard = await sdk.fetchCurrentDexLeaderboard();
-     *
-     * if (leaderboard) {
-     *   console.log(`Season ${leaderboard.seasonId} leaders:`);
-     *   leaderboard.entries.slice(0, 10).forEach(entry => {
-     *     console.log(`${entry.rank}. ${entry.wallet}: ${entry.totalXp} XP`);
-     *   });
-     * } else {
-     *   console.log('No active season');
-     * }
-     * ```
-     */
-    fetchCurrentDexLeaderboard(): Promise<LeaderboardResult | null>;
-    /**
-     * Fetch DEX aggregated volume summary with trend metrics
-     *
-     * Returns platform-wide trading volume statistics across all DEX pools with
-     * 1-day, 7-day, and 30-day comparisons and percentage changes.
-     *
-     * **Use Cases:**
-     * - Monitor overall DEX trading activity
-     * - Identify volume trends and patterns
-     * - Compare performance across time periods
-     * - Detect market changes (increases/decreases)
-     *
-     * @category DEX Analytics
-     * @returns Promise<DexAggregatedVolumeSummary> Volume metrics with deltas
-     * @throws {NetworkError} If API request fails
-     * @since 4.0.0
-     *
-     * @example
-     * ```typescript
-     * const summary = await sdk.fetchDexAggregatedVolumeSummary();
-     * console.log(`Today's volume: $${summary.volume1d.toFixed(2)}`);
-     * console.log(`7-day change: ${(summary.volume7dDelta * 100).toFixed(2)}%`);
-     *
-     * // Analyze trend direction
-     * if (summary.volume1dDelta > 0) {
-     *   console.log('✅ Volume increasing');
-     * } else {
-     *   console.log('📉 Volume decreasing');
-     * }
-     * ```
-     */
-    fetchDexAggregatedVolumeSummary(): Promise<DexAggregatedVolumeSummary>;
     /**
      * Fetch the current launchpad token launch fee
      *
@@ -1292,7 +1196,7 @@ export declare class LaunchpadSDK {
      * - Token metadata (symbol, decimals, name)
      *
      * @param tokenClasses Array of token class keys to query
-     * @returns Promise<TokenClassWithSupply[]> Array of token classes with supply information
+     * @returns Promise<GalaChainTokenClass[]> Array of token classes with supply information
      * @throws {ValidationError} if tokenClasses array is empty
      * @throws {Error} if network request fails
      *
@@ -1319,7 +1223,7 @@ export declare class LaunchpadSDK {
      * @category Token Data
      * @since 3.32.0
      */
-    fetchTokenClassesWithSupply(tokenClasses: TokenClassKey[]): Promise<TokenClassWithSupply[]>;
+    fetchTokenClassesWithSupply(tokenClasses: GalaChainTokenClassKey[]): Promise<GalaChainTokenClass[]>;
     /**
      * Fetch pool details for a token - returns complete bonding curve pool state
      *
@@ -1452,33 +1356,28 @@ export declare class LaunchpadSDK {
      * market engagement. Data is aggregated by time period with buy/sell breakdowns.
      *
      * @category Trading Data
-     * @param options - Volume data options with required tokenName and optional time range
-     * @param options.tokenName - Token name to fetch volume data for (required)
-     * @param options.startDate - Start date for volume data range (optional)
-     * @param options.endDate - End date for volume data range (optional)
-     * @param options.interval - Time interval for aggregation (e.g., '1h', '1d', '1w') (optional)
-     * @returns Promise with graph data containing timestamps, volume amounts, and trade counts
-     * @throws {ValidationError} If tokenName is missing or invalid
+     * @param options - Volume data options
+     * @param options.tokenName - Token name to fetch volume data for
+     * @param options.from - Start of the range, a Unix timestamp in seconds (at least 173000000)
+     * @param options.to - End of the range, a Unix timestamp in seconds (at least 173000000)
+     * @param options.resolution - The chart resolution the backend aggregates by (at least 1)
+     * @returns `{ dataPoints }`: `{ timestamp, value, ... }` points, as the backend's chart returns them
+     * @throws {ValidationError} If tokenName is invalid, or `from`, `to` or `resolution` is missing
+     *   (`MISSING_GRAPH_OPTIONS`) or out of range: all three are required although the type marks
+     *   them optional
      * @throws {NetworkError} If API request fails
      * @since 4.0.4-beta.0
      *
-     * @example Fetch all-time volume
+     * @example Volume over the last 30 days
      * ```typescript
-     * const volumeData = await sdk.fetchVolumeData({ tokenName: 'anime' });
-     * console.log(`Total data points: ${volumeData.length}`);
-     * volumeData.forEach(point => {
-     *   console.log(`${point.timestamp}: $${point.volume} volume`);
-     * });
-     * ```
-     *
-     * @example Fetch volume for date range
-     * ```typescript
-     * const volumeData = await sdk.fetchVolumeData({
-     *   tokenName: 'mytoken',
-     *   startDate: new Date('2024-01-01'),
-     *   endDate: new Date('2024-01-31')
+     * const now = Math.floor(Date.now() / 1000);
+     * const { dataPoints } = await sdk.fetchVolumeData({
+     *   tokenName: 'anime',
+     *   from: now - 30 * 24 * 60 * 60,
+     *   to: now,
+     *   resolution: 5,
      * });
-     * console.log(`January volume: ${volumeData.reduce((sum, p) => sum + p.volume, 0)}`);
+     * dataPoints.forEach((point) => console.log(`${point.timestamp}: ${point.value}`));
      * ```
      */
     fetchVolumeData(options: FetchVolumeDataOptions): Promise<GraphDataResult>;
@@ -1575,14 +1474,32 @@ 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
+     * rather than run as the next wallet's identity.
+     *
+     * @throws ConfigurationError if `./bridge` (or its optional peers) cannot be loaded, or the wallet
+     * changed meanwhile
+     */
+    private coreBridge;
     /**
      * Lazy-initialize BridgeService when first needed.
      *
      * The BridgeService requires external chain configuration (Ethereum/Solana private keys)
      * which may not be available in all SDK usage scenarios. This method provides on-demand
-     * initialization to avoid requiring bridge configuration for non-bridge operations.
+     * initialization to avoid requiring bridge configuration for non-bridge operations. It is built
+     * for the wallet configured at its first use and dropped when the wallet changes.
      *
-     * @param options Optional configuration for Ethereum and Solana bridges
+     * @param bridge gala-core-sdk's `./bridge`, from {@link LaunchpadSDK.coreBridge}
      * @returns Configured BridgeService instance
      * @throws Error if no wallet is configured for GalaChain operations
      *
@@ -1596,6 +1513,7 @@ export declare class LaunchpadSDK {
      * and caches it permanently (tokens never change). This allows dynamic
      * contract address lookups without hardcoded values.
      *
+     * @param bridge gala-core-sdk's `./bridge`, from {@link LaunchpadSDK.coreBridge}
      * @returns Configured BridgeableTokenService instance
      *
      * @internal This is a private helper method for bridgeable token operations
@@ -1608,6 +1526,7 @@ export declare class LaunchpadSDK {
      * The service fetches wrappable tokens from DEX API (wrappable=true)
      * and caches them permanently for generic queries.
      *
+     * @param bridge gala-core-sdk's `./bridge`, from {@link LaunchpadSDK.coreBridge}
      * @returns Configured WrappableTokenService instance
      *
      * @internal This is a private helper method for wrappable token operations
@@ -1619,6 +1538,7 @@ export declare class LaunchpadSDK {
      * Lazily initializes the GalaConnectClient on first use.
      * Used for bridge and wrap/unwrap operations via the DEX API platform.
      *
+     * @param bridge gala-core-sdk's `./bridge`, from {@link LaunchpadSDK.coreBridge}
      * @returns Configured GalaConnectClient instance
      * @throws Error if wallet is not configured
      *
@@ -1632,8 +1552,9 @@ export declare class LaunchpadSDK {
      * The service handles cross-channel wrap/unwrap operations
      * (e.g., MUSIC → GMUSIC, GMUSIC → MUSIC).
      *
+     * @param bridge gala-core-sdk's `./bridge`, from {@link LaunchpadSDK.coreBridge}
      * @returns Configured WrapService instance
-     * @throws Error if wallet is not configured (wrap/unwrap requires signing)
+     * @throws Error if no wallet address is configured (the GalaConnect client needs one)
      *
      * @internal This is a private helper method for wrap/unwrap operations
      */
@@ -1739,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.
      *
@@ -1830,7 +1755,6 @@ export declare class LaunchpadSDK {
      * @internal
      */
     private getContentReactionService;
-    private toLegacyPinnedMessage;
     private buildMessageFetchOptions;
     private resolveReferralAddress;
     /**
@@ -1887,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.
      *
@@ -2061,7 +2000,7 @@ export declare class LaunchpadSDK {
      * @example Check bridge transaction status
      * ```typescript
      * const bridgeResult = await sdk.bridgeOut({
-     *   tokenId: 'Token|Unit|GALA|...',
+     *   tokenId: 'GALA|Unit|none|none',
      *   amount: '100',
      *   destinationChain: 'Ethereum',
      *   recipientAddress: '0x1234...',
@@ -2470,30 +2409,32 @@ export declare class LaunchpadSDK {
      * NOT an external bridge (Ethereum/Solana).
      *
      * @param options - Wrap options including tokenId and amount
-     * @returns Promise resolving to wrap operation result
-     * @throws ValidationError if token is not wrappable or already on asset channel
-     * @throws ValidationError if wallet is not configured
+     * @returns Promise resolving to the completed wrap
+     * @throws GalaSDKError (`@gala-chain/gala-core-sdk`): `TOKEN_NOT_WRAPPABLE`,
+     * `INVALID_WRAP_DIRECTION` (already on the asset channel), `INVALID_BRIDGE_OPTION` (no wallet),
+     * `BRIDGE_REQUEST_REJECTED` (GalaChain refused it: nothing locked), `BRIDGE_OUT_OUTCOME_UNKNOWN`
+     * (accepted, then failed: never wrap again)
      *
      * @since 4.0.18
      * @category Wrap/Unwrap
      *
      * @example Wrap MUSIC to GMUSIC
      * ```typescript
+     * // token ids are class keys (a bare symbol such as 'MUSIC' is refused)
      * const result = await sdk.wrapToken({
-     *   tokenId: 'MUSIC',
+     *   tokenId: '$MUSIC|Unit|none|none',
      *   amount: '100'
      * });
      * console.log(`Wrapped ${result.amount} ${result.fromToken} → ${result.toToken}`);
      * console.log(`Transaction: ${result.transactionId}`);
      * ```
      *
-     * @example With recipient and memo
+     * @example With a recipient
      * ```typescript
      * const result = await sdk.wrapToken({
      *   tokenId: '$MUSIC|Unit|none|none',
      *   amount: '50',
-     *   recipient: 'eth|0x1234...',
-     *   memo: 'Wrap for DEX trading'
+     *   recipient: 'eth|1234...',
      * });
      * ```
      */
@@ -2509,9 +2450,9 @@ export declare class LaunchpadSDK {
      * NOT an external bridge (Ethereum/Solana).
      *
      * @param options - Unwrap options including tokenId and amount
-     * @returns Promise resolving to unwrap operation result
-     * @throws ValidationError if token is not unwrappable or not on asset channel
-     * @throws ValidationError if wallet is not configured
+     * @returns Promise resolving to the completed unwrap
+     * @throws GalaSDKError (`@gala-chain/gala-core-sdk`): as {@link wrapToken}
+     * (`INVALID_WRAP_DIRECTION` for a token not on the asset channel)
      *
      * @since 4.0.18
      * @category Wrap/Unwrap
@@ -2519,7 +2460,7 @@ export declare class LaunchpadSDK {
      * @example Unwrap GMUSIC to MUSIC
      * ```typescript
      * const result = await sdk.unwrapToken({
-     *   tokenId: 'GMUSIC',
+     *   tokenId: '$GMUSIC|Unit|none|none',
      *   amount: '50'
      * });
      * console.log(`Unwrapped ${result.amount} ${result.fromToken} → ${result.toToken}`);
@@ -2532,17 +2473,17 @@ export declare class LaunchpadSDK {
      * Calculates expected fees for wrapping a token to the asset channel.
      * Wrap operations use `cross_channel_authorization` fee type.
      *
-     * @param tokenId - Token identifier (symbol, pipe-delimited string, or TokenClassKey)
+     * @param tokenId - Token class key (pipe-delimited string or TokenClassKey; a bare symbol is refused)
      * @param amount - Amount to wrap (decimal string)
      * @returns Promise resolving to fee estimate
-     * @throws ValidationError if token is not wrappable
+     * @throws GalaSDKError `TOKEN_NOT_WRAPPABLE`, `INVALID_WRAP_DIRECTION`, `INVALID_BRIDGE_AMOUNT`
      *
      * @since 4.0.18
      * @category Wrap/Unwrap
      *
      * @example Estimate wrap fee
      * ```typescript
-     * const estimate = await sdk.estimateWrapFee('MUSIC', '100');
+     * const estimate = await sdk.estimateWrapFee('$MUSIC|Unit|none|none', '100');
      * console.log(`Fee: ${estimate.fee} ${estimate.feeToken}`);
      * console.log(`Auth type: ${estimate.authorizationType}`);
      * ```
@@ -2554,44 +2495,22 @@ export declare class LaunchpadSDK {
      * Calculates expected fees for unwrapping a token back to its native channel.
      * Unwrap operations use `automatic` fee authorization.
      *
-     * @param tokenId - Token identifier (symbol, pipe-delimited string, or TokenClassKey)
+     * @param tokenId - Token class key (pipe-delimited string or TokenClassKey; a bare symbol is refused)
      * @param amount - Amount to unwrap (decimal string)
      * @returns Promise resolving to fee estimate
-     * @throws ValidationError if token is not unwrappable
+     * @throws GalaSDKError `TOKEN_NOT_WRAPPABLE`, `INVALID_WRAP_DIRECTION`, `INVALID_BRIDGE_AMOUNT`
      *
      * @since 4.0.18
      * @category Wrap/Unwrap
      *
      * @example Estimate unwrap fee
      * ```typescript
-     * const estimate = await sdk.estimateUnwrapFee('GMUSIC', '50');
+     * const estimate = await sdk.estimateUnwrapFee('$GMUSIC|Unit|none|none', '50');
      * console.log(`Fee: ${estimate.fee} ${estimate.feeToken}`);
      * console.log(`Auth type: ${estimate.authorizationType}`);
      * ```
      */
     estimateUnwrapFee(tokenId: TokenId, amount: string): Promise<WrapUnwrapFeeEstimate>;
-    /**
-     * Get status of a wrap/unwrap transaction
-     *
-     * Polls the bridge status endpoint to check the current state
-     * of a cross-channel wrap or unwrap operation.
-     *
-     * @param transactionId - Transaction ID from wrap/unwrap result
-     * @returns Transaction status
-     *
-     * @since 4.0.18
-     * @category Wrap/Unwrap
-     *
-     * @example Check wrap status
-     * ```typescript
-     * const status = sdk.getWrapStatus(result.transactionId);
-     * console.log(`Status: ${status.status}`);
-     * if (status.status === 'completed') {
-     *   console.log(`Completed at: ${new Date(status.completedAt)}`);
-     * }
-     * ```
-     */
-    getWrapStatus(transactionId: string): WrapUnwrapStatusResult;
     /**
      * Login with wallet signature to get JWT token.
      *
@@ -2630,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.
      *
@@ -2677,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.
@@ -2990,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}`);
      * });
      * ```
      */
@@ -3010,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}`);
      * ```
@@ -3214,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.
      *
@@ -3229,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.
      *
@@ -3250,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+)
      *
@@ -3276,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+)
      *
@@ -3285,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
      *
@@ -3295,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+)
      *
@@ -3318,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+)
      *
@@ -3710,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
      *   });
      * }
@@ -4915,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;
      * }
      * ```
      */
@@ -5291,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`);
@@ -5303,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.
      *
@@ -5746,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`);
@@ -5786,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
@@ -5802,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.
      *
@@ -5820,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.
      *
@@ -5868,7 +5882,7 @@ export declare class LaunchpadSDK {
      * }
      * ```
      */
-    getPinnedMessage(tokenName: string): Promise<GetPinnedMessageResult>;
+    getPinnedMessage(tokenName: string): Promise<PinnedMessageResult>;
     /**
      * Pin a message.
      *
@@ -6067,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
@@ -6078,7 +6092,7 @@ export declare class LaunchpadSDK {
      * @example Update messaging and comments
      * ```typescript
      * await sdk.updateTokenConfig('anime', {
-     *   messagesEnabled: true,
+     *   chatEnabled: true,
      *   commentsEnabled: false
      * });
      * ```
@@ -6136,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}`);
      * });
@@ -6145,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>;
@@ -6309,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
      *
@@ -6338,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
@@ -6355,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
@@ -6380,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
@@ -6502,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
@@ -6533,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
      *
@@ -6543,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
      *
@@ -6553,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)
      *
@@ -6563,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.
      *
@@ -6585,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';
@@ -6598,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.
@@ -6789,33 +6822,6 @@ export declare class LaunchpadSDK {
         tokenName?: string;
         banStatus?: 'BANNED' | 'UNBANNED';
     }): () => void;
-    /**
-     * Watch for new DEX pool creation by polling sdk.dex.pools.getPools() and diffing against
-     * the previously-seen pool set.
-     *
-     * There is no push event for this anywhere in the platform (no STREAM_EVENTS entry, no
-     * StreamWebSocketService/StreamingEventService method) - this is the only way to detect new
-     * pools. The first poll only establishes a baseline (every existing pool would otherwise be
-     * reported as "new"); callback only fires for pools that appear on a LATER poll.
-     *
-     * @param callback - Called for each newly-detected pool
-     * @param filters - intervalMs (poll frequency, default 30000), minTVL, tokens (client-side)
-     * @returns Cleanup function that stops polling
-     *
-     * @since 7.1.0
-     * @category WebSocket
-     */
-    onDexPoolCreation(callback: (pool: {
-        poolRef: string;
-        token0: string;
-        token1: string;
-        fee: number;
-        tvlUsd: number | undefined;
-    }) => void, filters?: {
-        intervalMs?: number;
-        minTVL?: number;
-        tokens?: string[];
-    }): () => void;
     /**
      * Subscribe to content flagged events (overseer)
      *
@@ -6825,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
      *
@@ -6835,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
      *
@@ -6845,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
      *
@@ -6855,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
      *
@@ -6865,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
      *
@@ -6875,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
      *
@@ -6885,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)
      *
@@ -6895,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
      *
@@ -6905,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
      *
@@ -6915,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
      *
@@ -6925,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
      *
@@ -6935,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
      *
@@ -6945,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
      *
@@ -6955,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)
      *
@@ -6965,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
      *
@@ -6975,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
      *
@@ -6985,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
      *
@@ -6995,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
      *
@@ -7005,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
      *
@@ -7015,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
      *
@@ -7025,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
      *
@@ -7035,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
      *
@@ -7045,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
      *
@@ -7055,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
      *
@@ -7065,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
      *
@@ -7075,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
      *
@@ -7097,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.
      *
@@ -7114,12 +7120,12 @@ export declare class LaunchpadSDK {
      *
      * @example Estimate fee for bridging GALA to Ethereum
      * ```typescript
+     * // the fee does not depend on the amount bridged
      * const fee = await sdk.estimateBridgeFee({
      *   tokenId: 'GALA|Unit|none|none',
      *   destinationChain: 'Ethereum',
-     *   amount: '100',
      * });
-     * console.log(`Fee: ${fee.totalFee} GALA`);
+     * console.log(`Fee: ${fee.estimatedFeeInGala} GALA`);
      * ```
      */
     estimateBridgeFee(params: EstimateBridgeFeeParams): Promise<BridgeFeeEstimate>;
@@ -7182,8 +7188,7 @@ export declare class LaunchpadSDK {
      *
      * Checks the current status of a cross-chain bridge transaction.
      *
-     * @param transactionHash - Transaction hash to check
-     * @param chainHint - Optional chain hint for faster lookup
+     * @param transactionHash - Transaction hash to check (one GalaConnect status read, any chain)
      * @returns Promise resolving to bridge status
      *
      * @since 4.0.16
@@ -7191,14 +7196,11 @@ export declare class LaunchpadSDK {
      *
      * @example Check bridge status
      * ```typescript
-     * const status = await sdk.getBridgeStatus(
-     *   '0x1234...abcd',
-     *   'Ethereum'
-     * );
+     * const status = await sdk.getBridgeStatus('0x1234...abcd');
      * console.log(`Status: ${status.status}`);
      * ```
      */
-    getBridgeStatus(transactionHash: string, chainHint?: 'Ethereum' | 'Solana'): Promise<BridgeStatus>;
+    getBridgeStatus(transactionHash: string): Promise<BridgeStatus>;
     /**
      * Get list of tokens supported for bridging.
      *
@@ -7357,7 +7359,7 @@ export declare class LaunchpadSDK {
      *   type: 'exact'
      * });
      * console.log('GALA needed:', result.amount);
-     * console.log('Total cost with fees:', result.totalCost);
+     * console.log('Fees:', result.transactionFee, result.gasFee);
      * ```
      *
      * @example Performance-optimized with local calculation
@@ -7697,7 +7699,7 @@ export declare class LaunchpadSDK {
      * **Use simple `tokenName`** (e.g., `"anime"`), NOT full TokenClassKey format.
      *
      * This method is for **bonding curve tokens only** (pre-graduation). For DEX trading
-     * of graduated tokens, use `sdk.dex.swaps.swap()` (the {@link GSwap} client exposed via {@link dex}) with full TokenClassKey format.
+     * of graduated tokens, use `@gala-chain/gswap-sdk` (`new GSwap({ signer }).swaps.swap()`) with full TokenClassKey format.
      *
      * ```typescript
      * // ✅ CORRECT - Simple token name
@@ -7818,7 +7820,7 @@ export declare class LaunchpadSDK {
      * **Use simple `tokenName`** (e.g., `"anime"`), NOT full TokenClassKey format.
      *
      * This method is for **bonding curve tokens only** (pre-graduation). For DEX trading
-     * of graduated tokens, use `sdk.dex.swaps.swap()` (the {@link GSwap} client exposed via {@link dex}) with full TokenClassKey format.
+     * of graduated tokens, use `@gala-chain/gswap-sdk` (`new GSwap({ signer }).swaps.swap()`) with full TokenClassKey format.
      *
      * ```typescript
      * // ✅ CORRECT - Simple token name
@@ -7978,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.
-     *
-     * **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.
+     * Upload a token image (`POST /v1/tokens/:tokenName/image`)
      *
-     * **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>;
     /**
@@ -8165,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)
@@ -8175,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
      *
@@ -8359,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
      *
@@ -8402,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>;
     /**
@@ -8559,78 +8516,41 @@ export declare class LaunchpadSDK {
      */
     getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
     /**
-     * Fetch historical price data for DEX tokens via DEX Backend API
+     * 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}.
      *
-     * Retrieves paginated historical price snapshots for a token with optional
-     * date range filtering. This method is Node.js-only and queries the DEX
-     * Backend API for price history data.
-     *
-     * @param options Price history fetch options including token key, dates, and pagination
-     * @returns Promise<PriceHistoryResult> Price snapshots with pagination metadata
-     * @throws ConfigurationError if dexBackendBaseUrl not configured
-     * @throws NetworkError if API request fails
-     * @throws ValidationError if parameters are invalid
-     *
-     * @category Price History
-     * @since 3.13.0
+     * @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
-     * // Fetch price history for a DEX token
-     * const history = await sdk.fetchPriceHistory({
-     *   tokenClassKey: {
-     *     collection: 'GUSDC',
-     *     category: 'Unit',
-     *     type: 'none',
-     *     additionalKey: 'none'
-     *   },
-     *   from: new Date('2024-01-01'),
-     *   to: new Date('2024-01-31'),
-     *   pageSize: 20
-     * });
-     *
-     * console.log(`Found ${history.snapshots.length} price snapshots`);
-     * console.log(`Total: ${history.total}, Page ${history.page} of ${history.totalPages}`);
+     * const gala = await sdk.getUserGalaBalance('eth|1234567890abcdef1234567890abcdef12345678');
+     * console.log(`${gala.quantity} GALA = $${gala.holdingPrice}`);
      * ```
      */
-    fetchPriceHistory(options: FetchPriceHistoryOptions): Promise<PriceHistoryResult>;
+    getUserGalaBalance(address: string): Promise<UserGalaBalance>;
     /**
-     * Fetch all historical price snapshots for a token (automatic pagination)
-     *
-     * Convenience method that automatically handles pagination by fetching all price history
-     * snapshots across all pages and returning them in a single result. This method internally
-     * loops through pages using the maximum page size (100 items) for efficiency.
-     *
-     * Only available for DEX tokens with price snapshot data on the DEX Backend API.
+     * 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.
      *
-     * @param options Fetch options (pagination is handled automatically)
-     * @returns Promise<PriceHistoryResult> containing all price snapshots in combined result
-     *
-     * @throws NetworkError if API query fails
-     * @throws ValidationError if parameters are invalid
-     *
-     * @category Price History
-     * @since 3.14.0
+     * @returns `{ code, username? }`
+     * @throws ConfigurationError if no JWT session is configured
+     * @since 9.0.0
+     * @category User Management
      *
      * @example
      * ```typescript
-     * // Fetch all price history for a DEX token (automatic pagination)
-     * const allHistory = await sdk.fetchAllPriceHistory({
-     *   tokenId: {
-     *     collection: 'GUSDC',
-     *     category: 'Unit',
-     *     type: 'none',
-     *     additionalKey: 'none'
-     *   },
-     *   from: new Date('2024-01-01'),
-     *   to: new Date('2024-12-31')
-     * });
-     *
-     * console.log(`Found ${allHistory.snapshots.length} price snapshots`);
-     * console.log(`Total: ${allHistory.total}`);
+     * const { code } = await sdk.fetchReferralCode();
+     * console.log(`https://pump.gala.com/?ref=${code}`);
      * ```
      */
-    fetchAllPriceHistory(options: Omit<FetchPriceHistoryOptions, 'page' | 'limit'>): Promise<PriceHistoryResult>;
+    fetchReferralCode(): Promise<ReferralCode>;
     /**
      * Transfer GALA tokens between wallets
      *
@@ -8712,7 +8632,7 @@ export declare class LaunchpadSDK {
      *
      * @throws {TransferError} When token name cannot be resolved
      */
-    resolveTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    resolveTokenClassKey(tokenName: string): Promise<GalaChainTokenClassKey>;
     /**
      * Convert token name to TokenClassKey (explicit alias for resolveTokenClassKey)
      *
@@ -8746,7 +8666,7 @@ export declare class LaunchpadSDK {
      *
      * @throws {TransferError} When token name cannot be resolved
      */
-    convertTokenNameToTokenClassKey(tokenName: string): Promise<TokenClassKey>;
+    convertTokenNameToTokenClassKey(tokenName: string): Promise<GalaChainTokenClassKey>;
     /**
      * Lock tokens on GalaChain (batch operation)
      *