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

package/dist/LaunchpadSDK.d.ts

@@ -1,14 +1,11 @@
+import type { GalaChainTokenClass, GalaChainTokenDetails, GalaChainTokenClassKey, HttpRequestor } from '@gala-chain/gala-core-sdk';
+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 { Environment } from './config/environments';
 import { EventsBatcherService } from './services/EventsBatcherService';
 import type { StreamEventCallbacks } from './services/StreamWebSocketService';
 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,11 +14,11 @@ 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';
@@ -45,12 +42,10 @@ import type { BalanceUpdatedPayload, ChatMessagePayload, ChatStatusPayload, Conn
 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 { 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';
@@ -131,7 +126,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 +137,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);
@@ -292,9 +287,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,20 +311,24 @@ 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;
+    private _bridgeService;
     private _bridgeableTokenService?;
     private _wrappableTokenService?;
-    private _wrapService?;
-    private _galaConnectClient?;
+    private _wrapService;
+    private _galaConnectClient;
     private _streamingService;
     private _streamChatService;
     private _streamWebSocketService;
@@ -360,8 +365,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 +376,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 +471,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 +512,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 +543,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();
@@ -1021,74 +1038,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.
-     *
-     * @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
+     * Fetch comprehensive token details from GalaChain
      *
-     * 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 +1096,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 +1132,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 +1159,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 +1292,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
-     * ```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
+     * @example Volume over the last 30 days
      * ```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 +1410,24 @@ export declare class LaunchpadSDK {
      * ```
      */
     fetchGalaBalance(address?: string): Promise<TokenBalanceResult | null>;
+    /**
+     * 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 +1441,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 +1454,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 +1466,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 +1480,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
      */
@@ -2061,7 +1910,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 +2319,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 +2360,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 +2370,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 +2383,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 +2405,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.
      *
@@ -6789,33 +6618,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)
      *
@@ -7114,12 +6916,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 +6984,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 +6992,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 +7155,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 +7495,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 +7616,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
@@ -8558,79 +8356,6 @@ export declare class LaunchpadSDK {
      * ```
      */
     getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
-    /**
-     * Fetch historical price data for DEX tokens via DEX Backend API
-     *
-     * 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
-     *
-     * @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}`);
-     * ```
-     */
-    fetchPriceHistory(options: FetchPriceHistoryOptions): Promise<PriceHistoryResult>;
-    /**
-     * 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.
-     *
-     * @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
-     *
-     * @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}`);
-     * ```
-     */
-    fetchAllPriceHistory(options: Omit<FetchPriceHistoryOptions, 'page' | 'limit'>): Promise<PriceHistoryResult>;
     /**
      * Transfer GALA tokens between wallets
      *
@@ -8712,7 +8437,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 +8471,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)
      *