@gala-chain/launchpad-sdk 0.4.0

package/dist/api/WebSocketAPI.d.ts

@@ -0,0 +1,156 @@
+/**
+ * WebSocket API Controller
+ *
+ * This controller provides WebSocket-based real-time transaction monitoring
+ * for bundle transactions submitted to the bundle backend.
+ *
+ * @category API Controllers
+ * @since 2.0.0
+ */
+import { TransactionStatus, WebSocketConfig } from './services/WebSocketService';
+/**
+ * WebSocket API Controller for Real-time Transaction Monitoring
+ */
+export declare class WebSocketAPI {
+    private wsService;
+    private config;
+    private debug;
+    constructor(wsConfig: WebSocketConfig, debug?: boolean);
+    /**
+     * Initialize WebSocket connection using singleton manager
+     *
+     * @example
+     * ```typescript
+     * await sdk.websocket.connect();
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Monitor a transaction for completion
+     *
+     * @param transactionId Bundle transaction ID
+     * @param callback Status update callback
+     *
+     * @example
+     * ```typescript
+     * await sdk.websocket.monitorTransaction(txId, (status) => {
+     *   console.log(`Transaction ${status.transactionId}: ${status.status}`);
+     *   if (status.status === 'completed') {
+     *     console.log('Transaction completed!');
+     *   }
+     * });
+     * ```
+     */
+    monitorTransaction(transactionId: string, callback: (status: TransactionStatus) => void): Promise<void>;
+    /**
+     * Wait for transaction completion (Promise-based)
+     *
+     * @param transactionId Bundle transaction ID
+     * @returns Promise that resolves when transaction completes
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const result = await sdk.websocket.waitForTransaction(txId);
+     *   console.log('Transaction completed:', result);
+     * } catch (error) {
+     *   console.error('Transaction failed:', error);
+     * }
+     * ```
+     */
+    waitForTransaction(transactionId: string): Promise<TransactionStatus>;
+    /**
+     * Monitor multiple transactions
+     *
+     * @param transactionIds Array of transaction IDs
+     * @param callback Status update callback
+     *
+     * @example
+     * ```typescript
+     * await sdk.websocket.monitorTransactions([buyTxId, sellTxId], (status) => {
+     *   console.log(`${status.transactionId}: ${status.status}`);
+     * });
+     * ```
+     */
+    monitorTransactions(transactionIds: string[], callback: (status: TransactionStatus) => void): Promise<void>;
+    /**
+     * Wait for all transactions to complete
+     *
+     * @param transactionIds Array of transaction IDs
+     * @returns Promise that resolves when all transactions complete
+     *
+     * @example
+     * ```typescript
+     * const results = await sdk.websocket.waitForTransactions([buyTxId, sellTxId]);
+     * console.log('All transactions completed:', results);
+     * ```
+     */
+    waitForTransactions(transactionIds: string[]): Promise<TransactionStatus[]>;
+    /**
+     * Release reference to WebSocket connection
+     *
+     * Uses reference counting - connection is only closed when all
+     * SDK instances have released their references.
+     *
+     * @example
+     * ```typescript
+     * sdk.websocket.disconnect();
+     * ```
+     */
+    disconnect(): void;
+    /**
+     * Check connection status
+     *
+     * @returns True if WebSocket is connected
+     *
+     * @example
+     * ```typescript
+     * if (sdk.websocket.isConnected()) {
+     *   console.log('WebSocket is ready');
+     * }
+     * ```
+     */
+    isConnected(): boolean;
+    /**
+     * Get connection information for debugging
+     *
+     * @returns Array of connection info objects
+     *
+     * @example
+     * ```typescript
+     * const connections = sdk.websocket.getConnectionInfo();
+     * console.log('Active connections:', connections);
+     * ```
+     */
+    getConnectionInfo(): Array<{
+        url: string;
+        referenceCount: number;
+        isConnected: boolean;
+    }>;
+    /**
+     * Check if this instance has an active reference to a WebSocket connection
+     *
+     * @returns True if this instance has a WebSocket service reference
+     */
+    hasActiveReference(): boolean;
+    /**
+     * Cleanup all WebSocket connections (static method)
+     *
+     * Forces disconnection of all managed connections across all SDK instances.
+     * Useful for application shutdown or testing cleanup.
+     *
+     * @param debug Enable debug logging
+     *
+     * @example
+     * ```typescript
+     * WebSocketAPI.cleanupAll();
+     * ```
+     */
+    static cleanupAll(debug?: boolean): void;
+    /**
+     * Ensure WebSocket is connected
+     */
+    private ensureConnected;
+}
+export type { TransactionStatus } from './services/WebSocketService';
+//# sourceMappingURL=WebSocketAPI.d.ts.map

package/dist/api/WebSocketAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketAPI.d.ts","sourceRoot":"","sources":["../../src/api/WebSocketAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAoB,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnG;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAU;gBAEX,QAAQ,EAAE,eAAe,EAAE,KAAK,GAAE,OAAe;IAK7D;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK3E;;;;;;;;;;;;OAYG;IACG,mBAAmB,CACvB,cAAc,EAAE,MAAM,EAAE,EACxB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;;;;;;OAWG;IACG,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAkCjF;;;;;;;;;;OAUG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;;;;;;;;OAWG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;;OAUG;IACH,iBAAiB,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAIzF;;;;OAIG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,GAAE,OAAe,GAAG,IAAI;IAI/C;;OAEG;YACW,eAAe;CAK9B;AAED,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/api/dto/BondingCurveDTOs.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Bonding Curve DTOs for Launchpad Trading Operations
+ *
+ * These DTOs extend ChainCallDTO from @gala-chain/connect and provide
+ * properly structured data transfer objects for bonding curve trading.
+ * Each DTO matches the exact format expected by the launchpad backend.
+ *
+ * ## DTO Structure:
+ * All DTOs inherit from ChainCallDTO which provides:
+ * - EIP-712 signature support
+ * - Proper serialization format
+ * - Type validation
+ * - Compatibility with @gala-chain/connect ecosystem
+ *
+ * ## Trading Operations:
+ * - BuyNativeDto: Buy tokens with exact GALA amount
+ * - BuyExactDto: Buy exact amount of tokens
+ * - SellExactDto: Sell exact amount of tokens
+ * - SellNativeDto: Sell tokens for exact GALA amount
+ *
+ * @category DTOs
+ * @since 2.0.0
+ */
+import { ChainCallDTO } from '@gala-chain/connect';
+/**
+ * Base interface for extra fees configuration
+ */
+export interface IExtraFeesDTO {
+    maxAcceptableReverseBondingCurveFee: string;
+}
+/**
+ * DTO for buying tokens with exact native (GALA) amount
+ * Corresponds to BuyWithNative method on the backend
+ *
+ * @example
+ * ```typescript
+ * const dto = new BuyNativeDto(
+ *   'service|Token$Unit$ANIME$eth:1234567890$launchpad',
+ *   '100.5',
+ *   '1342612.26269649' // Expected tokens based on bonding curve
+ * );
+ * ```
+ */
+export declare class BuyNativeDto extends ChainCallDTO {
+    readonly vaultAddress: string;
+    readonly nativeTokenQuantity: string;
+    readonly expectedToken: string;
+    readonly extraFees: IExtraFeesDTO;
+    uniqueKey?: string;
+    constructor(vaultAddress: string, nativeTokenQuantity: string, expectedToken?: string, extraFees?: IExtraFeesDTO);
+}
+/**
+ * DTO for buying exact amount of tokens
+ * Corresponds to BuyExactToken method on the backend
+ *
+ * @example
+ * ```typescript
+ * const dto = new BuyExactDto(
+ *   'service|Token$Unit$ANIME$eth:1234567890$launchpad',
+ *   '50.0',
+ *   { maxAcceptableReverseBondingCurveFee: '0.1' }
+ * );
+ * ```
+ */
+export declare class BuyExactDto extends ChainCallDTO {
+    readonly vaultAddress: string;
+    readonly tokenQuantity: string;
+    readonly expectedGala: string;
+    readonly extraFees: IExtraFeesDTO;
+    uniqueKey?: string;
+    constructor(vaultAddress: string, tokenQuantity: string, expectedGala: string, extraFees?: IExtraFeesDTO);
+}
+/**
+ * DTO for selling exact amount of tokens
+ * Corresponds to SellExactToken method on the backend
+ *
+ * @example
+ * ```typescript
+ * const dto = new SellExactDto(
+ *   'service|Token$Unit$ANIME$eth:1234567890$launchpad',
+ *   '25.0',
+ *   { maxAcceptableReverseBondingCurveFee: '0.05' }
+ * );
+ * ```
+ */
+export declare class SellExactDto extends ChainCallDTO {
+    readonly vaultAddress: string;
+    readonly tokenQuantity: string;
+    readonly extraFees: IExtraFeesDTO;
+    uniqueKey?: string;
+    constructor(vaultAddress: string, tokenQuantity: string, extraFees?: IExtraFeesDTO);
+}
+/**
+ * DTO for selling tokens to receive exact native (GALA) amount
+ * Corresponds to SellWithNative method on the backend
+ *
+ * @example
+ * ```typescript
+ * const dto = new SellNativeDto(
+ *   'service|Token$Unit$ANIME$eth:1234567890$launchpad',
+ *   '10.0'
+ * );
+ * ```
+ */
+export declare class SellNativeDto extends ChainCallDTO {
+    readonly vaultAddress: string;
+    readonly nativeTokenQuantity: string;
+    readonly expectedTokens: string;
+    uniqueKey?: string;
+    constructor(vaultAddress: string, nativeTokenQuantity: string, expectedTokens: string);
+}
+/**
+ * Namespace export for convenient access to all bonding curve DTOs
+ */
+export declare const BondingCurveDTOs: {
+    readonly BuyNativeDto: typeof BuyNativeDto;
+    readonly BuyExactDto: typeof BuyExactDto;
+    readonly SellExactDto: typeof SellExactDto;
+    readonly SellNativeDto: typeof SellNativeDto;
+};
+/**
+ * Type definitions for DTO parameters
+ */
+export type BuyNativeDtoParams = {
+    vaultAddress: string;
+    nativeTokenQuantity: string;
+};
+export type BuyExactDtoParams = {
+    vaultAddress: string;
+    tokenQuantity: string;
+    extraFees?: IExtraFeesDTO;
+};
+export type SellExactDtoParams = {
+    vaultAddress: string;
+    tokenQuantity: string;
+    extraFees?: IExtraFeesDTO;
+};
+export type SellNativeDtoParams = {
+    vaultAddress: string;
+    nativeTokenQuantity: string;
+};
+//# sourceMappingURL=BondingCurveDTOs.d.ts.map

package/dist/api/dto/BondingCurveDTOs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BondingCurveDTOs.d.ts","sourceRoot":"","sources":["../../../src/api/dto/BondingCurveDTOs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,SAAS,EAAE,aAAa,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGxB,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,EAC3B,aAAa,GAAE,MAAY,EAC3B,SAAS,GAAE,aAA4D;CAQ1E;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,SAAS,EAAE,aAAa,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGxB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,aAA4D;CAQ1E;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,SAAS,EAAE,aAAa,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGxB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,aAA4D;CAO1E;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,mBAAmB,EAAE,MAAM,CAAC;IAC5C,SAAgB,cAAc,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEd,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAMtF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC"}

package/dist/api/services/BundleService.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Bundle Service for Transaction Processing
+ *
+ * This service handles bundle transaction submission to the launchpad
+ * backend. It formats the request data in the exact structure expected
+ * by the bundle API and provides proper error handling.
+ *
+ * ## Bundle Transaction Format:
+ * ```json
+ * {
+ *   "signedDto": {
+ *     // Signed DTO with signature, types, domain
+ *   },
+ *   "stringsInstructions": [
+ *     // Array of resource tracking strings
+ *   ],
+ *   "method": "BuyWithNative" | "BuyExactToken" | "SellExactToken" | "SellWithNative"
+ * }
+ * ```
+ *
+ * ## Response Handling:
+ * - Success: Returns transaction ID for WebSocket monitoring
+ * - Error: Provides detailed error messages for debugging
+ *
+ * @category Services
+ * @since 2.0.0
+ */
+import { HttpClient } from '../../utils/http';
+import type { ApiResponse } from '../../types/common';
+/**
+ * Bundle transaction data structure
+ */
+export interface BundleTransactionData {
+    signedDto: any;
+    stringsInstructions: string[];
+    method: string;
+}
+/**
+ * Service for handling bundle transaction submission
+ */
+export declare class BundleService {
+    private httpClient;
+    private debug;
+    private readonly bundleEndpoint;
+    constructor(httpClient: HttpClient, debug?: boolean);
+    /**
+     * Submit a bundle transaction to the backend
+     *
+     * @param bundleData - Complete bundle transaction data
+     * @returns API response with transaction ID or error
+     *
+     * @example
+     * ```typescript
+     * const bundleData = {
+     *   signedDto: signedPayload,
+     *   stringsInstructions: [
+     *     '$service$Token$Unit$ANIME$none$launchpad',
+     *     '$tokenBalance$Token$Unit$ANIME$none$vaultAddress',
+     *     // ... more strings
+     *   ],
+     *   method: 'BuyWithNative'
+     * };
+     *
+     * const response = await bundleService.submitTransaction(bundleData);
+     * ```
+     */
+    submitTransaction(bundleData: BundleTransactionData): Promise<ApiResponse>;
+    /**
+     * Validate bundle transaction data
+     */
+    private validateBundleData;
+    /**
+     * Format bundle request for API submission
+     */
+    private formatBundleRequest;
+    /**
+     * Handle bundle API response
+     */
+    private handleBundleResponse;
+    /**
+     * Format error message for consistent error handling
+     */
+    private formatErrorMessage;
+    /**
+     * Get bundle transaction status
+     *
+     * @param transactionId - Transaction ID returned from submitTransaction
+     * @returns Transaction status information
+     */
+    getTransactionStatus(transactionId: string): Promise<ApiResponse>;
+    /**
+     * Cancel a pending bundle transaction
+     *
+     * @param transactionId - Transaction ID to cancel
+     * @returns Cancellation result
+     */
+    cancelTransaction(transactionId: string): Promise<ApiResponse>;
+    /**
+     * Get bundle service health status
+     *
+     * @returns Service health information
+     */
+    getHealthStatus(): Promise<ApiResponse>;
+}
+//# sourceMappingURL=BundleService.d.ts.map

package/dist/api/services/BundleService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundleService.d.ts","sourceRoot":"","sources":["../../../src/api/services/BundleService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,GAAG,CAAC;IACf,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;GAEG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK;IAJf,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAa;gBAGlC,UAAU,EAAE,UAAU,EACtB,KAAK,GAAE,OAAe;IAGhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmDhF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiD1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;;;OAKG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiCvE;;;;;OAKG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiCpE;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;CA4B9C"}

package/dist/api/services/SignatureService.d.ts

@@ -0,0 +1,71 @@
+/**
+ * EIP-712 Signature Service for Bonding Curve Transactions
+ *
+ * This service handles EIP-712 signature generation for all wallet types
+ * supported by the Gala ecosystem. It replicates the exact signature
+ * generation process used in the frontend to ensure compatibility.
+ *
+ * ## Supported Wallets:
+ * - MetaMask (signTypedData)
+ * - TrustWallet (signMessage with serialization)
+ * - GalaWallet (custom implementation)
+ *
+ * ## Key Features:
+ * - Dynamic EIP-712 type generation
+ * - Personal sign prefix calculation
+ * - Wallet-specific signature handling
+ * - Full compatibility with frontend implementation
+ *
+ * @category Services
+ * @since 2.0.0
+ */
+/**
+ * Wallet preference enumeration
+ */
+export declare enum WalletPreference {
+    METAMASK = 0,
+    TRUST_WALLET = 1,
+    GALA_WALLET = 2
+}
+/**
+ * Service for handling EIP-712 signatures for bonding curve operations
+ */
+export declare class SignatureService {
+    private walletProvider;
+    private debug;
+    constructor(walletProvider: any, debug?: boolean);
+    /**
+     * Sign a DTO using EIP-712 with the appropriate wallet method
+     *
+     * @param dto - The DTO to sign (extends ChainCallDTO)
+     * @param methodName - The method name for type generation
+     * @param walletAddress - The user's wallet address
+     * @param walletPreference - Wallet type preference
+     * @returns Signed payload ready for bundle submission
+     */
+    signDTO(dto: any, methodName: string, walletAddress: string, walletPreference?: WalletPreference): Promise<any>;
+    /**
+     * Sign with MetaMask/ethers.js using signTypedData
+     */
+    private signWithMetaMask;
+    /**
+     * Sign with TrustWallet using signMessage
+     */
+    private signWithTrustWallet;
+    /**
+     * Sign with GalaWallet using custom implementation
+     * Falls back to MetaMask signing in non-browser environments
+     */
+    private signWithGalaWallet;
+    /**
+     * Generate EIP-712 types from DTO structure
+     * Dynamically creates type definitions based on DTO fields
+     * EXACTLY matches frontend implementation from readWriteUtils.ts
+     */
+    private generateEIP712Types;
+    /**
+     * Detect wallet preference from provider
+     */
+    detectWalletPreference(): WalletPreference;
+}
+//# sourceMappingURL=SignatureService.d.ts.map

package/dist/api/services/SignatureService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureService.d.ts","sourceRoot":"","sources":["../../../src/api/services/SignatureService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAyBH;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,QAAQ,IAAI;IACZ,YAAY,IAAI;IAChB,WAAW,IAAI;CAChB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,KAAK;gBADL,cAAc,EAAE,GAAG,EACnB,KAAK,GAAE,OAAe;IAGhC;;;;;;;;OAQG;IACG,OAAO,CACX,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,gBAAgB,GAAE,gBAA4C,GAC7D,OAAO,CAAC,GAAG,CAAC;IA4Df;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;YACW,mBAAmB;IAoBjC;;;OAGG;YACW,kBAAkB;IA8ChC;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAyE3B;;OAEG;IACH,sBAAsB,IAAI,gBAAgB;CAmB3C"}

package/dist/api/services/TokenClassKeyService.d.ts

@@ -0,0 +1,116 @@
+/**
+ * TokenClassKey Service for String Instructions Generation
+ *
+ * This service handles the generation of stringsInstructions arrays
+ * for bundle transactions. It creates the proper resource tracking
+ * strings that match the exact format used by the frontend.
+ *
+ * ## String Instructions Format:
+ * 1. launchPadSalePreBuy: $service$[tokenKey]$launchpad
+ * 2. memetokenBalancePool: $tokenBalance$[tokenKey]$[vaultAddress]
+ * 3. memetokenBalanceUser: $tokenBalance$[tokenKey]$[vaultAddress]
+ * 4. poolNativeBalance: $tokenBalance$[galaKey]$[vaultAddress]
+ * 5. userNativeBalance: $tokenBalance$[galaKey]$[vaultAddress]
+ *
+ * ## TokenClassKey Structure:
+ * - collection: 'Token' (for launchpad tokens) or 'GALA' (for native)
+ * - category: 'Unit'
+ * - type: Token symbol or 'none'
+ * - additionalKey: 'none'
+ *
+ * @category Services
+ * @since 2.0.0
+ */
+import { TokenClassKey } from '@gala-chain/api';
+/**
+ * Service for generating TokenClassKey and stringsInstructions
+ */
+export declare class TokenClassKeyService {
+    private debug;
+    constructor(debug?: boolean);
+    /**
+     * Generate stringsInstructions array for a vault address
+     *
+     * Creates the 5-element array required for bundle transactions:
+     * [launchPadSalePreBuy, memetokenBalancePool, memetokenBalanceUser, poolNativeBalance, userNativeBalance]
+     *
+     * @param vaultAddress - Vault address in format: service|Token$Unit$SYMBOL$eth:address$launchpad
+     * @returns Array of strings for resource tracking
+     *
+     * @example
+     * ```typescript
+     * const instructions = service.generateStringsInstructions(
+     *   'service|Token$Unit$ANIME$eth:1234567890$launchpad'
+     * );
+     * // Returns:
+     * // [
+     * //   '$service$Token$Unit$ANIME$none$launchpad',
+     * //   '$tokenBalance$Token$Unit$ANIME$none$service|Token$Unit$ANIME$eth:1234567890$launchpad',
+     * //   '$tokenBalance$Token$Unit$ANIME$none$service|Token$Unit$ANIME$eth:1234567890$launchpad',
+     * //   '$tokenBalance$GALA$Unit$none$none$service|Token$Unit$ANIME$eth:1234567890$launchpad',
+     * //   '$tokenBalance$GALA$Unit$none$none$service|Token$Unit$ANIME$eth:1234567890$launchpad'
+     * // ]
+     * ```
+     */
+    generateStringsInstructions(vaultAddress: string): string[];
+    /**
+     * Create TokenClassKey instance for a token
+     * CRITICAL: Uses lowercase token symbol to match frontend format
+     *
+     * @param tokenSymbol - Token symbol (e.g., 'ANIME', 'CLAUDE') - will be converted to lowercase
+     * @returns TokenClassKey instance with lowercase symbol
+     * @note This standardizes on lowercase internally regardless of input casing
+     */
+    createTokenInstance(tokenSymbol: string): TokenClassKey;
+    /**
+     * Create TokenClassKey instance for GALA (native token)
+     *
+     * @returns TokenClassKey instance for GALA
+     */
+    createGalaInstance(): TokenClassKey;
+    /**
+     * Extract token symbol from vault address
+     *
+     * @param vaultAddress - Vault address in format: service|Token$Unit$SYMBOL$eth:address$launchpad
+     * @returns Token symbol
+     *
+     * @example
+     * ```typescript
+     * const symbol = service.extractTokenSymbolFromVault(
+     *   'service|Token$Unit$ANIME$eth:1234567890$launchpad'
+     * );
+     * // Returns: 'ANIME'
+     * ```
+     */
+    extractTokenSymbolFromVault(vaultAddress: string): string;
+    /**
+     * Validate vault address format
+     *
+     * @param vaultAddress - Vault address to validate
+     * @returns true if valid, throws error if invalid
+     */
+    validateVaultAddress(vaultAddress: string): boolean;
+    /**
+     * Generate TokenClassKey string representation
+     *
+     * @param collection - Collection name
+     * @param category - Category name
+     * @param type - Type name
+     * @param additionalKey - Additional key
+     * @returns String key in format: collection$category$type$additionalKey
+     */
+    generateTokenClassKeyString(collection: string, category: string, type: string, additionalKey: string): string;
+    /**
+     * Parse TokenClassKey from string representation
+     *
+     * @param stringKey - String key in format: collection$category$type$additionalKey
+     * @returns Parsed TokenClassKey components
+     */
+    parseTokenClassKeyString(stringKey: string): {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+    };
+}
+//# sourceMappingURL=TokenClassKeyService.d.ts.map

package/dist/api/services/TokenClassKeyService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenClassKeyService.d.ts","sourceRoot":"","sources":["../../../src/api/services/TokenClassKeyService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,KAAK;gBAAL,KAAK,GAAE,OAAe;IAE1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IA0C3D;;;;;;;OAOG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAkBvD;;;;OAIG;IACH,kBAAkB,IAAI,aAAa;IAgBnC;;;;;;;;;;;;;OAaG;IACH,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IA4BzD;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAkCnD;;;;;;;;OAQG;IACH,2BAA2B,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,MAAM;IAIT;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG;QAC3C,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;KACvB;CAaF"}