@gala-chain/launchpad-sdk 4.0.17-beta.0 → 4.0.17-beta.10

package/dist/src/services/WrappableTokenService.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Wrappable Token Service
+ *
+ * Service for fetching and caching wrappable tokens from the DEX API.
+ * Provides methods to query which tokens can be wrapped/unwrapped
+ * and retrieves their counterpart tokens dynamically.
+ *
+ * ## Key Features
+ * - Dynamic token discovery (fetches from DEX API)
+ * - Permanent caching for token metadata
+ * - Separate balance methods for user-specific queries
+ *
+ * ## Caching Strategy
+ * - Token metadata is always cached (fetchWrappableTokens, fetchAllWrappableTokens)
+ * - Balance methods never cache (fetchWrappableTokenBalances, fetchAllWrappableTokenBalances)
+ * - Cache persists for entire SDK lifetime
+ *
+ * @category Services
+ * @since 4.0.18
+ */
+import { HttpClient } from '../utils/http.js';
+import type { TokenId } from '../types/common.js';
+import type { WrappableToken, FetchWrappableTokensOptions, FetchWrappableTokensResult, IsTokenWrappableResult, WrappableTokenCacheStats } from '../types/wrappable-token.dto.js';
+/**
+ * WrappableTokenService
+ *
+ * Fetches and caches wrappable token information from the DEX API.
+ * Provides efficient lookups for wrap/unwrap operations.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const service = new WrappableTokenService(dexApiHttp, true);
+ *
+ * // Fetch all wrappable tokens (cached)
+ * const result = await service.fetchAllWrappableTokens();
+ * console.log(`Found ${result.tokenCount} tokens`);
+ *
+ * // Fetch with balance data for a specific address (not cached)
+ * const withBalances = await service.fetchAllWrappableTokenBalances('eth|0x1234...');
+ * console.log(`Found ${withBalances.tokenCount} tokens with balances`);
+ *
+ * // Check if a specific token is wrappable (by tokenId)
+ * const isWrappable = await service.isTokenWrappable('$MUSIC|Unit|none|none');
+ * console.log(`MUSIC wrappable: ${isWrappable.isWrappable}`);
+ *
+ * // Get wrap counterpart
+ * const counterpart = await service.getWrapCounterpart('$MUSIC|Unit|none|none');
+ * console.log(`MUSIC counterpart: ${counterpart?.symbol}`); // GMUSIC
+ * ```
+ */
+export declare class WrappableTokenService {
+    private readonly dexApiHttp;
+    private readonly logger;
+    private readonly cache;
+    constructor(dexApiHttp: HttpClient, debugMode?: boolean);
+    /**
+     * Normalize tokenId to stringified format for lookups.
+     *
+     * Accepts:
+     * - Pipe-delimited string: "$MUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$MUSIC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     *
+     * @param tokenId - Token identifier
+     * @returns Normalized stringified TokenClassKey
+     * @throws ValidationError if tokenId format is invalid
+     */
+    private normalizeTokenId;
+    /**
+     * Fetch wrappable tokens with pagination (metadata only, cached)
+     *
+     * For user-specific balance data, use fetchWrappableTokenBalances() instead.
+     *
+     * @param options - Fetch options including offset and limit
+     * @returns Promise resolving to fetch result with tokens array
+     * @throws NetworkError if API request fails
+     */
+    fetchWrappableTokens(options?: FetchWrappableTokensOptions): Promise<FetchWrappableTokensResult>;
+    /**
+     * Fetch ALL wrappable tokens (auto-pagination, cached)
+     *
+     * Returns cached data if available, otherwise fetches from API.
+     * For user-specific balance data, use fetchAllWrappableTokenBalances() instead.
+     *
+     * @returns Promise resolving to fetch result with all tokens
+     * @throws NetworkError if API request fails
+     */
+    fetchAllWrappableTokens(): Promise<FetchWrappableTokensResult>;
+    /**
+     * Get a wrappable token by tokenId
+     *
+     * Uses cache for efficient lookup. If cache not populated, fetches first.
+     *
+     * @param tokenId - Token identifier (pipe-delimited or TokenClassKey)
+     * @returns Promise resolving to wrappable token or undefined
+     */
+    getWrappableToken(tokenId: TokenId): Promise<WrappableToken | undefined>;
+    /**
+     * Get the wrap counterpart for a token
+     *
+     * @param tokenId - Token identifier (pipe-delimited or TokenClassKey)
+     * @returns Promise resolving to counterpart token or undefined
+     *
+     * @example
+     * ```typescript
+     * // Get GMUSIC from MUSIC
+     * const counterpart = await service.getWrapCounterpart('$MUSIC|Unit|none|none');
+     * console.log(counterpart?.symbol); // "GMUSIC"
+     * ```
+     */
+    getWrapCounterpart(tokenId: TokenId): Promise<WrappableToken | undefined>;
+    /**
+     * Check if a token is wrappable
+     *
+     * @param tokenId - Token identifier (pipe-delimited or TokenClassKey)
+     * @returns Promise resolving to wrappability result
+     */
+    isTokenWrappable(tokenId: TokenId): Promise<IsTokenWrappableResult>;
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache statistics including token count and timestamp
+     */
+    getCacheStats(): WrappableTokenCacheStats;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Transform API response tokens to SDK format
+     *
+     * @param apiTokens - Raw API response tokens
+     * @returns Array of transformed wrappable tokens
+     */
+    private transformTokens;
+}
+//# sourceMappingURL=WrappableTokenService.d.ts.map

package/dist/src/services/WrappableTokenService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrappableTokenService.d.ts","sourceRoot":"","sources":["../../../src/services/WrappableTokenService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EAGd,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAQzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAGzB,UAAU,EAAE,UAAU,EACvC,SAAS,GAAE,OAAe;IAS5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;;;;;;;OAQG;IACG,oBAAoB,CACxB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IA4DtC;;;;;;;;OAQG;IACG,uBAAuB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IA2EpE;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAgB9E;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAO/E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuBzE;;;;OAIG;IACH,aAAa,IAAI,wBAAwB;IAIzC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAwCxB"}

package/dist/src/types/wrappable-token.dto.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Wrappable Token Types
+ *
+ * Type definitions for dynamically fetched wrappable tokens from DEX API.
+ * Wrappable tokens are token pairs where one can be wrapped/unwrapped into
+ * the other (e.g., MUSIC ↔ GMUSIC).
+ *
+ * @category Types
+ * @since 4.0.18
+ */
+import type { TokenId } from './common.js';
+/**
+ * Current USD price information from API response
+ */
+export interface WrappableTokenPrices {
+    /** Current USD price */
+    usd?: number;
+    /** 24-hour price change percentage */
+    usd24hChange?: number;
+    /** 24-hour trading volume in USD */
+    usd24hVol?: number;
+    /** Market cap in USD */
+    usdMarketCap?: number;
+    /** Timestamp of last price update */
+    lastUpdatedAt?: string;
+}
+/**
+ * Raw wrappable token response from DEX API /v1/tokens?wrappable=true
+ *
+ * This is the structure returned directly from the API.
+ */
+export interface WrappableTokenApiResponse {
+    /** Token symbol on GalaChain (e.g., "MUSIC", "GMUSIC") */
+    symbol: string;
+    /** Token display name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+    /** Token description */
+    description?: string;
+    /** Token image URL */
+    image?: string;
+    /** Pipe-delimited token class key (e.g., "$MUSIC|Unit|none|none") */
+    stringifiedTokenClassKey: string;
+    /** Token collection */
+    collection: string;
+    /** Token category */
+    category: string;
+    /** Token type */
+    type: string;
+    /** Additional key */
+    additionalKey: string;
+    /** Network (always "GC" for GalaChain) */
+    network: string;
+    /** Whether the token is verified */
+    verified: boolean;
+    /** Whether the token is swappable on DEX */
+    swappable: boolean;
+    /** Token channel (e.g., "music", "asset") */
+    channel?: string;
+    /** Whether the token is trending */
+    trending?: boolean;
+    /** Bridge destination chain ID (if bridgeable) */
+    bridgeDestinationChainId?: number;
+    /** Whether bridging is disabled */
+    disableBridge?: boolean;
+    /** Price symbol for external price sources */
+    priceSymbol?: string;
+    /** Whether price is known to external sources */
+    priceIsKnownToExternalPriceSource?: boolean;
+    /** Counterpart token's stringified TokenClassKey (e.g., "$GMUSIC|Unit|none|none") */
+    wrap: string;
+    /** Current USD prices (optional) */
+    currentPrices?: WrappableTokenPrices;
+    /** User's balance (only when address param provided) */
+    balance?: string;
+}
+/**
+ * Paginated response from /v1/tokens?wrappable=true API
+ */
+export interface WrappableTokensApiResponse {
+    /** Array of wrappable tokens */
+    tokens: WrappableTokenApiResponse[];
+}
+/**
+ * Processed wrappable token for SDK use
+ *
+ * This is the normalized structure used internally by the SDK.
+ */
+export interface WrappableToken {
+    /** Token symbol on GalaChain (e.g., "MUSIC", "GMUSIC") */
+    symbol: string;
+    /** Token display name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+    /** GalaChain token descriptor */
+    galaChainDescriptor: {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+    };
+    /** Pipe-delimited token class key */
+    stringifiedTokenClassKey: string;
+    /** Counterpart token's stringified TokenClassKey */
+    wrapCounterpart: string;
+    /** Whether the token is swappable on DEX */
+    swappable: boolean;
+    /** Whether the token is verified */
+    verified: boolean;
+    /** Token channel (e.g., "music", "asset") */
+    channel?: string;
+    /** Whether the token is trending */
+    trending?: boolean;
+    /** Token image URL */
+    image?: string;
+    /** Token description */
+    description?: string;
+    /** Current USD prices */
+    currentPrices?: WrappableTokenPrices;
+}
+/**
+ * Options for fetching wrappable tokens (metadata only, no balance)
+ */
+export interface FetchWrappableTokensOptions {
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Results per page (max: 1000, default: 1000) */
+    limit?: number;
+}
+/**
+ * Result of fetching wrappable tokens (metadata only, no balance)
+ */
+export interface FetchWrappableTokensResult {
+    /** Array of wrappable tokens */
+    tokens: WrappableToken[];
+    /** Timestamp when data was fetched */
+    fetchedAt: number;
+    /** Number of tokens returned */
+    tokenCount: number;
+}
+/**
+ * Options for getting a wrappable token by tokenId
+ */
+export interface GetWrappableTokenOptions {
+    /**
+     * Token identifier in flexible format.
+     *
+     * Accepts:
+     * - Pipe-delimited string: "$MUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$MUSIC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     *
+     * @example "$MUSIC|Unit|none|none"
+     * @example { collection: '$MUSIC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     */
+    tokenId: TokenId;
+}
+/**
+ * Result of checking if a token is wrappable
+ */
+export interface IsTokenWrappableResult {
+    /** Whether the token is wrappable */
+    isWrappable: boolean;
+    /** The queried token's stringified TokenClassKey */
+    tokenId: string;
+    /** Counterpart token's stringified TokenClassKey (if wrappable) */
+    wrapCounterpart?: string;
+}
+/**
+ * Cache statistics for wrappable tokens
+ */
+export interface WrappableTokenCacheStats {
+    /** Number of tokens in cache */
+    tokenCount: number;
+    /** Whether cache is populated */
+    isPopulated: boolean;
+    /** Timestamp when cache was last updated */
+    lastFetchedAt: number | null;
+}
+/**
+ * Options for wrapping a token (e.g., MUSIC → GMUSIC)
+ *
+ * Wrapping transfers a token from its native channel to the asset channel,
+ * converting it to its wrapped counterpart. This is required for tokens
+ * like MUSIC to be traded on the DEX.
+ *
+ * @example
+ * ```typescript
+ * const result = await sdk.wrapToken({
+ *   tokenId: 'MUSIC',
+ *   amount: '100.5',
+ * });
+ * ```
+ */
+export interface WrapTokenOptions {
+    /**
+     * Token to wrap (source token on native channel).
+     *
+     * Accepts:
+     * - Symbol: "MUSIC"
+     * - Pipe-delimited: "$MUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$MUSIC', ... }
+     */
+    tokenId: TokenId;
+    /** Amount to wrap (decimal string, e.g., "100.5") */
+    amount: string;
+    /** Optional recipient address (defaults to sender) */
+    recipient?: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+}
+/**
+ * Options for unwrapping a token (e.g., GMUSIC → MUSIC)
+ *
+ * Unwrapping transfers a token from the asset channel back to its native
+ * channel, converting it from the wrapped version to the original.
+ *
+ * @example
+ * ```typescript
+ * const result = await sdk.unwrapToken({
+ *   tokenId: 'GMUSIC',
+ *   amount: '50',
+ * });
+ * ```
+ */
+export interface UnwrapTokenOptions {
+    /**
+     * Token to unwrap (wrapped token on asset channel).
+     *
+     * Accepts:
+     * - Symbol: "GMUSIC"
+     * - Pipe-delimited: "$GMUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$GMUSIC', ... }
+     */
+    tokenId: TokenId;
+    /** Amount to unwrap (decimal string, e.g., "50") */
+    amount: string;
+    /** Optional recipient address (defaults to sender) */
+    recipient?: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+}
+/**
+ * Result of a wrap or unwrap operation
+ */
+export interface WrapUnwrapResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Transaction hash/ID for tracking */
+    transactionId?: string;
+    /** Source token symbol (e.g., "MUSIC" for wrap, "GMUSIC" for unwrap) */
+    fromToken: string;
+    /** Destination token symbol (e.g., "GMUSIC" for wrap, "MUSIC" for unwrap) */
+    toToken: string;
+    /** Amount transferred (decimal string) */
+    amount: string;
+    /** Source channel name (e.g., "music", "asset") */
+    fromChannel: string;
+    /** Destination channel name (e.g., "asset", "music") */
+    toChannel: string;
+    /** Fee paid for the operation (if any) */
+    fee?: string;
+    /** Timestamp when the operation completed (epoch ms) */
+    completedAt?: number;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Fee estimation for wrap/unwrap operations
+ *
+ * Wrap and unwrap operations may have different fee authorization types:
+ * - Wrap (→ asset): Uses `cross_channel_authorization` on source channel
+ * - Unwrap (→ native): Uses `automatic` authorization on asset channel
+ */
+export interface WrapUnwrapFeeEstimate {
+    /** Estimated fee amount (decimal string) */
+    fee: string;
+    /** Fee token symbol (usually "GALA") */
+    feeToken: string;
+    /** Fee authorization type used by the backend */
+    authorizationType: 'cross_channel_authorization' | 'automatic';
+    /** Channel where the fee is authorized/charged */
+    feeChannel: string;
+}
+/**
+ * Status of a wrap/unwrap operation
+ */
+export type WrapUnwrapStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Extended result with status polling information
+ */
+export interface WrapUnwrapStatusResult extends WrapUnwrapResult {
+    /** Current status of the operation */
+    status: WrapUnwrapStatus;
+    /** Number of confirmations (if applicable) */
+    confirmations?: number;
+    /** Estimated time remaining in ms (if available) */
+    estimatedTimeRemainingMs?: number;
+}
+//# sourceMappingURL=wrappable-token.dto.d.ts.map

package/dist/src/types/wrappable-token.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappable-token.dto.d.ts","sourceRoot":"","sources":["../../../src/types/wrappable-token.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,gCAAgC;IAChC,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,mBAAmB,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,qCAAqC;IACrC,wBAAwB,EAAE,MAAM,CAAC;IACjC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,gCAAgC;IAChC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;OASG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAMD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,iBAAiB,EAAE,6BAA6B,GAAG,WAAW,CAAC;IAC/D,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,sCAAsC;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "4.0.17-beta.0",
+  "version": "4.0.17-beta.10",
   "description": "TypeScript SDK for Gala Launchpad Backend API - 100+ public methods with 373+ fully documented APIs supporting optional wallet (read-only and full-access modes). Production-ready DeFi token launchpad integration with AgentConfig setup, GalaChain trading, GSwap DEX integration, price history, token creation, DEX pool discovery, WebSocket event watchers, and comprehensive user operations. Multi-format output (ESM, CJS, UMD).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -66,6 +66,7 @@
     "demo:utilities:balances": "tsx examples/utilities/balances.ts",
     "demo:utilities:key-derivation": "tsx examples/utilities/key-derivation.ts",
     "demo:utilities:price-history": "tsx examples/utilities/price-history.ts",
+    "demo:utilities:wrappable-tokens": "tsx examples/utilities/wrappable-tokens.ts",
     "demo:dex": "tsx examples/dex/swap-workflow.ts",
     "demo:dex:pools": "tsx examples/dex/pool-discovery.ts",
     "demo:dex:pricing": "tsx examples/dex/pools-with-pricing.ts",
@@ -115,6 +116,10 @@
     "demo:bridge:sol:roundtrip": "tsx examples/bridge/solana-roundtrip.ts",
     "demo:bridge:balances": "tsx examples/bridge/wallet-balances.ts",
     "demo:bridge:bridgeable": "tsx examples/bridge/bridgeable-tokens.ts",
+    "demo:bridge:tx-status": "tsx examples/bridge/transaction-status.ts",
+    "demo:wrap": "tsx examples/bridge/wrap-unwrap.ts",
+    "demo:wrap:discovery": "tsx examples/bridge/wrap-discovery.ts",
+    "demo:wrap:fees": "tsx examples/bridge/wrap-fee-estimation.ts",
     "test:demos:core": "npm run demo && npm run demo:read-only && npm run demo:authenticated && npm run demo:privatekey-override",
     "test:demos:dex": "npm run demo:dex:pools && npm run demo:dex:pricing && npm run demo:dex:quotes && npm run demo:dex && npm run demo:dex:roundtrip",
     "test:demos:liquidity": "npm run demo:liquidity:all",