@gala-chain/launchpad-sdk 0.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommentAPI.d.ts","sourceRoot":"","sources":["../../src/api/CommentAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAEL,mBAAmB,EAGnB,qBAAqB,EAItB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBADb,IAAI,EAAE,UAAU,EAChB,YAAY,CAAC,EAAE,YAAY,YAAA;IAO9C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0CnH;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8ChG;;;;;;;;;OASG;YACW,uBAAuB;IAIrC;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAenC;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGjD"}

package/dist/api/LaunchpadAPI.d.ts

@@ -0,0 +1,440 @@
+/**
+ * Launchpad API Controller
+ *
+ * This class provides access to all launchpad-related endpoints, handling
+ * file uploads, pool creation, data fetching, and analysis operations.
+ */
+import { HttpClient } from '../utils/http';
+import { ImageUploadOptions, ImageUploadResponse, FetchPoolOptions, FetchPoolResponse, GetAmountResponse, CheckPoolOptions, CheckPoolResponse, GetGraphResponse, GetTokenDistributionResponse, CreateSaleData, CreateSaleResponse, GetTokenBadgesResponse } from '../types/launchpad.dto';
+import { CalculatePreMintData, CalculatePreMintResponse } from '../types/trade.dto';
+/**
+ * Launchpad API controller for pool creation and management operations
+ *
+ * This controller provides access to all launchpad-related functionality including:
+ * - Image uploads for token branding
+ * - Pool creation and lifecycle management
+ * - Pool data fetching with filtering and pagination
+ * - Amount calculations for trading operations
+ * - Pool existence checking and validation
+ * - Historical graph data and analytics
+ *
+ * All methods include comprehensive input validation, automatic type conversion
+ * for backend compatibility, and detailed error handling.
+ *
+ * @category API Controllers
+ * @since 1.0.0
+ *
+ * @example Basic pool creation workflow
+ * ```typescript
+ * const sdk = new LaunchpadSDK({ wallet });
+ *
+ * // 1. Upload token image
+ * const uploadResult = await sdk.launchpad.uploadImage({
+ *   file: imageFile,
+ *   tokenName: 'mytoken'
+ * });
+ *
+ * // 2. Create the token sale
+ * const sale = await sdk.launchpad.createSale({
+ *   tokenName: 'mytoken',
+ *   tokenSymbol: 'MTK',
+ *   tokenDescription: 'My awesome token',
+ *   tokenImage: uploadResult.data?.imageUrl,
+ *   preBuyQuantity: '500'
+ * });
+ *
+ * console.log('Sale created:', sale.vaultAddress);
+ * ```
+ */
+export declare class LaunchpadAPI {
+    private readonly http;
+    private readonly bundleHttp?;
+    constructor(http: HttpClient, bundleHttp?: HttpClient | undefined);
+    /**
+     * Uploads an image for a token pool
+     *
+     * Uploads a token image that will be used for branding and display purposes.
+     * Supports both browser File objects and Node.js Buffer objects for maximum
+     * compatibility across environments.
+     *
+     * File Requirements:
+     * - Format: PNG, JPG, JPEG, WebP
+     * - Size: Maximum 5MB
+     * - Dimensions: Recommended 512x512px or higher
+     * - Aspect ratio: Square (1:1) recommended
+     *
+     * @category File Operations
+     * @param options Upload configuration object
+     * @param options.file Image file as File object (browser) or Buffer (Node.js)
+     * @param options.tokenName Token name for the image (must be valid token name format)
+     * @returns Promise that resolves to upload result containing image URL and metadata
+     * @throws {ValidationError} If token name format is invalid
+     * @throws {FileValidationError} If file doesn't meet requirements
+     * @throws {Error} If upload fails due to network or server issues
+     * @since 1.0.0
+     *
+     * @example Browser file upload
+     * ```typescript
+     * // From file input element
+     * const fileInput = document.querySelector('#image-upload') as HTMLInputElement;
+     * const file = fileInput.files?.[0];
+     *
+     * if (file) {
+     *   const result = await sdk.launchpad.uploadImage({
+     *     file,
+     *     tokenName: 'mytoken'
+     *   });
+     *   console.log('Image uploaded:', result.imageUrl);
+     * }
+     * ```
+     *
+     * @example Node.js buffer upload
+     * ```typescript
+     * import * as fs from 'fs';
+     *
+     * const imageBuffer = fs.readFileSync('./token-image.png');
+     * const result = await sdk.launchpad.uploadImage({
+     *   file: imageBuffer,
+     *   tokenName: 'mytoken'
+     * });
+     * console.log('Image URL:', result.imageUrl);
+     * ```
+     *
+     * @example With error handling
+     * ```typescript
+     * try {
+     *   const result = await sdk.launchpad.uploadImage({ file, tokenName });
+     *   return result.imageUrl;
+     * } catch (error) {
+     *   if (error instanceof FileValidationError) {
+     *     console.error('Invalid file:', error.message);
+     *   } else if (error instanceof ValidationError) {
+     *     console.error('Invalid token name:', error.message);
+     *   } else {
+     *     console.error('Upload failed:', error.message);
+     *   }
+     *   throw error;
+     * }
+     * ```
+     *
+     * @see {@link createSale} - Create token sale using uploaded image
+     */
+    uploadImageByTokenName(tokenName: string, options: ImageUploadOptions): Promise<ImageUploadResponse>;
+    /**
+     * Fetches pools with filtering and pagination
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/fetch-pool
+     *
+     * @param options Fetch options including type, search, and pagination
+     * @returns Promise<FetchPoolResponse> Pool data with pagination
+     */
+    fetchPools(options: FetchPoolOptions): Promise<FetchPoolResponse>;
+    /**
+     * Calculates amount for trading operations (PRIVATE - Internal use only)
+     *
+     * @private
+     * @param options Amount calculation options
+     * @returns Promise<GetAmountResponse> Calculated amount
+     */
+    private _getAmount;
+    /**
+     * Checks if a pool exists for given token name or symbol
+     *
+     * @param options Check options with token name and/or symbol
+     * @returns Promise<CheckPoolResponse> Pool existence result
+     */
+    checkPool(options: CheckPoolOptions): Promise<CheckPoolResponse>;
+    /**
+     * Fetches graph data for a token
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/get-graph-data
+     *
+     * @param options Graph data options
+     * @returns Promise<GetGraphResponse> Graph data points
+     */
+    getGraphDataByTokenName(tokenName: string, options?: {
+        from: number;
+        to: number;
+        resolution: number;
+    }): Promise<GetGraphResponse>;
+    /**
+     * Gets pools with flexible filtering options (unified method)
+     *
+     * @param options Filtering options including search, tokenName, type, pagination
+     * @returns Promise<FetchPoolResponse> Filtered pools
+     *
+     * @example
+     * ```typescript
+     * // Get recent pools
+     * const recent = await sdk.launchpad.getPools({ type: 'recent', page: 1, limit: 10 });
+     *
+     * // Get popular pools
+     * const popular = await sdk.launchpad.getPools({ type: 'popular', page: 1, limit: 10 });
+     *
+     * // Search pools
+     * const searched = await sdk.launchpad.getPools({ search: 'rocket', page: 1, limit: 5 });
+     *
+     * // Get specific token pools
+     * const tokenPools = await sdk.launchpad.getPools({ tokenName: 'ROCKETCH' });
+     * ```
+     */
+    getPools(options?: {
+        search?: string;
+        tokenName?: string;
+        type?: 'recent' | 'popular';
+        page?: number;
+        limit?: number;
+    }): Promise<FetchPoolResponse>;
+    /**
+     * Checks if a token name is available (convenience method)
+     *
+     * @param tokenName Token name to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenNameAvailable(tokenName: string): Promise<boolean>;
+    /**
+     * Checks if a token symbol is available (convenience method)
+     *
+     * @param symbol Token symbol to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenSymbolAvailable(symbol: string): Promise<boolean>;
+    /**
+     * Get buy token amount calculation with unified API (replaces getBuyWithNativeAmountByTokenName/getBuyExactTokenAmountByTokenName)
+     *
+     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param options Calculation options
+     * @param options.amount Amount to calculate (GALA for 'native', tokens for 'exact')
+     * @param options.type Calculation type: 'native' = GALA input, 'exact' = token output
+     * @returns Promise<GetAmountResponse> Calculated amount
+     * @throws ValidationError if parameters are invalid or token not found
+     *
+     * @example
+     * ```typescript
+     * // Calculate tokens received when spending 1 GALA
+     * const result = await sdk.launchpad.getBuyTokenAmount("dragnrkti", {
+     *   amount: "1000000000000000000", // 1 GALA in wei
+     *   type: "native"
+     * });
+     *
+     * // Calculate GALA cost for buying 100 tokens
+     * const result = await sdk.launchpad.getBuyTokenAmount("dragnrkti", {
+     *   amount: "100000000000000000000", // 100 tokens in wei
+     *   type: "exact"
+     * });
+     * ```
+     */
+    getBuyTokenAmount(tokenName: string, options: {
+        amount: string;
+        type: 'native' | 'exact';
+    }): Promise<GetAmountResponse>;
+    /**
+     * Get sell token amount calculation with unified API (replaces getSellExactTokenAmountByTokenName/getSellWithNativeAmountByTokenName)
+     *
+     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param options Calculation options
+     * @param options.amount Amount to calculate (tokens for 'exact', GALA for 'native')
+     * @param options.type Calculation type: 'exact' = token input, 'native' = GALA output
+     * @returns Promise<GetAmountResponse> Calculated amount
+     * @throws ValidationError if parameters are invalid or token not found
+     *
+     * @example
+     * ```typescript
+     * // Calculate GALA received when selling 50 tokens
+     * const result = await sdk.launchpad.getSellTokenAmount("dragnrkti", {
+     *   amount: "50000000000000000000", // 50 tokens in wei
+     *   type: "exact"
+     * });
+     *
+     * // Calculate tokens needed to receive 0.5 GALA
+     * const result = await sdk.launchpad.getSellTokenAmount("dragnrkti", {
+     *   amount: "500000000000000000", // 0.5 GALA in wei
+     *   type: "native"
+     * });
+     * ```
+     */
+    getSellTokenAmount(tokenName: string, options: {
+        amount: string;
+        type: 'exact' | 'native';
+    }): Promise<GetAmountResponse>;
+    /**
+     * Creates a new token sale using the bundle backend
+     *
+     * ✅ VERIFIED: Real API payload confirmed - endpoint /bundle with CreateSale method
+     *
+     * This method provides a clean interface for creating token sales by handling:
+     * - Optional image upload (if image is File/Buffer)
+     * - DTO signing with required fields and defaults
+     * - Bundle backend API call with proper request format
+     *
+     * @category Sale Operations
+     * @param data Sale creation configuration
+     * @param data.tokenName Unique token name (lowercase, alphanumeric, max 10 chars)
+     * @param data.tokenSymbol Token symbol (3-10 characters)
+     * @param data.tokenDescription Token description (max 500 characters)
+     * @param data.tokenImage Optional image - File, Buffer, or URL string
+     * @param data.preBuyQuantity Pre-buy quantity as decimal string
+     * @param data.websiteUrl Optional website URL
+     * @param data.telegramUrl Optional Telegram channel URL
+     * @param data.twitterUrl Optional Twitter profile URL
+     * @param data.tokenCategory Optional token category (defaults to 'Unit')
+     * @param data.tokenCollection Optional token collection (defaults to 'Token')
+     * @param data.reverseBondingCurveConfiguration Optional curve config (uses defaults)
+     * @returns Promise that resolves to sale creation result
+     * @throws {ValidationError} If any input validation fails
+     * @throws {Error} If sale creation fails due to network or signature issues
+     * @since 1.0.0
+     *
+     * @example Create a sale with image upload
+     * ```typescript
+     * const result = await sdk.launchpad.createTokenAndPool({
+     *   tokenName: 'mytoken',
+     *   tokenSymbol: 'MTK',
+     *   tokenDescription: 'My awesome token for trading',
+     *   tokenImage: imageFile, // File object from input
+     *   preBuyQuantity: '100',
+     *   websiteUrl: 'https://mytoken.com',
+     *   twitterUrl: 'https://twitter.com/mytoken'
+     * });
+     *
+     * console.log('Sale created successfully!');
+     * console.log('Sale ID:', result.data?.saleId);
+     * ```
+     *
+     * @example Create a sale with existing image URL
+     * ```typescript
+     * const result = await sdk.launchpad.createTokenAndPool({
+     *   tokenName: 'simpletoken',
+     *   tokenSymbol: 'SIMPLE',
+     *   tokenDescription: 'A simple token',
+     *   tokenImage: 'https://example.com/token-logo.png',
+     *   preBuyQuantity: '50',
+     *   websiteUrl: 'https://simple.com'
+     * });
+     * ```
+     *
+     * @example Minimal sale creation
+     * ```typescript
+     * const result = await sdk.launchpad.createTokenAndPool({
+     *   tokenName: 'minimal',
+     *   tokenSymbol: 'MIN',
+     *   tokenDescription: 'Minimal token configuration',
+     *   preBuyQuantity: '10'
+     *   // Uses all defaults for optional fields
+     * });
+     * ```
+     */
+    createTokenAndPool(data: CreateSaleData): Promise<CreateSaleResponse>;
+    /**
+     * Get token distribution showing top holders
+     *
+     * Retrieves the list of top token holders for a specific token,
+     * along with their balances and percentage of total supply.
+     *
+     * @param vaultAddress Token vault address in backend format (eth|40hex)
+     * @returns Promise resolving to token distribution data
+     *
+     * @example
+     * ```typescript
+     * const distribution = await launchpad.getTokenDistributionByTokenName('mytoken');
+     * console.log('Top holders:', distribution.data?.holders);
+     * ```
+     */
+    getTokenDistributionByTokenName(tokenName: string): Promise<GetTokenDistributionResponse>;
+    /**
+     * Gets badge achievements for a token
+     *
+     * This endpoint retrieves volume and engagement badges for a specific token.
+     * Badges indicate milestones in trading volume and community engagement.
+     *
+     * **Note**: This endpoint does not require authentication.
+     *
+     * @param tokenName The name of the token to get badges for
+     * @returns Promise<GetTokenBadgesResponse> Badge information
+     *
+     * @example
+     * ```typescript
+     * const badges = await launchpad.getTokenBadges('mytoken');
+     * console.log('Volume badges:', badges.data?.volumeBadge);
+     * console.log('Engagement badges:', badges.data?.engagementBadge);
+     * ```
+     */
+    getTokenBadgesByTokenName(tokenName: string): Promise<GetTokenBadgesResponse>;
+    /**
+     * Convenience method to check if a token has achieved a specific badge
+     *
+     * @param tokenName The token name to check
+     * @param badgeType Type of badge to check ('volume' or 'engagement')
+     * @param badgeName Specific badge name to check for
+     * @returns Promise<boolean> Whether the token has achieved this badge
+     *
+     * @example
+     * ```typescript
+     * const has10kVolume = await launchpad.hasTokenBadgeByTokenName('mytoken', 'volume', '10k');
+     * const hasCrowdEngagement = await launchpad.hasTokenBadgeByTokenName('mytoken', 'engagement', 'CROWD');
+     * ```
+     */
+    hasTokenBadgeByTokenName(tokenName: string, badgeType: 'volume' | 'engagement', badgeName: string): Promise<boolean>;
+    /**
+     * Calculates pre-mint token amounts using CallMemeTokenOut
+     *
+     * This method calculates how many tokens a user will receive for a given
+     * amount of GALA during the token launch phase. Used when the initial buy
+     * amount is greater than 0 in the launch form.
+     *
+     * **Note**: This endpoint does not require authentication and uses a fixed
+     * vault address for pre-mint calculations.
+     *
+     * @param data Pre-mint calculation data
+     * @returns Promise resolving to calculated token amounts and fees
+     *
+     * @example
+     * ```typescript
+     * const result = await launchpad.calculatePreMintTokens({
+     *   nativeTokenQuantity: '100'  // 100 GALA
+     * });
+     * console.log('Tokens to receive:', result.Data.calculatedQuantity);
+     * console.log('Fees:', result.Data.extraFees);
+     * ```
+     */
+    getInitialBuyAmount(data: CalculatePreMintData): Promise<CalculatePreMintResponse>;
+    /**
+     * Gets the authenticated user's address in backend format
+     *
+     * @returns Address in eth|{40-hex-chars} format
+     */
+    getAddress(): string;
+    /**
+     * Converts Ethereum address to backend format
+     *
+     * @param ethereumAddress Standard Ethereum address (0x...)
+     * @returns Address in backend format (eth|...)
+     */
+    formatAddressForBackend(ethereumAddress: string): string;
+    /**
+     * Validates a token name (exposed for external validation)
+     *
+     * @param tokenName Token name to validate
+     * @throws ValidationError if validation fails
+     */
+    validateTokenName(tokenName: string): void;
+    /**
+     * Validates pagination options (exposed for external validation)
+     *
+     * @param options Pagination options to validate
+     * @throws ValidationError if validation fails
+     */
+    validatePagination(options: FetchPoolOptions): void;
+    /**
+     * Resolves a token name to its vault address using cached resolution
+     *
+     * Uses the shared VaultCache for intelligent caching to eliminate
+     * redundant API calls for the same tokenName.
+     *
+     * @private
+     * @param tokenName Token name to resolve (e.g., 'dragnrkti', 'rocketri')
+     * @returns Promise<string | null> Vault address if found, null otherwise
+     */
+    private resolveTokenNameToVault;
+}
+//# sourceMappingURL=LaunchpadAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LaunchpadAPI.d.ts","sourceRoot":"","sources":["../../src/api/LaunchpadAPI.ts"],"names":[],"mappings":"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"}

package/dist/api/TradeAPI.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Trade API Controller
+ *
+ * This controller provides access to trade-related operations including:
+ * - Trade creation
+ * - Trade listing with filtering
+ * - Bundle API trading integration
+ *
+ * All methods include input validation and handle backend type inconsistencies.
+ */
+import { HttpClient } from '../utils/http';
+import type { LaunchpadAPI } from './LaunchpadAPI';
+import { GetTradesResponse, TradeListParams, FetchSaleDetailsResponse } from '../types/trade.dto';
+/**
+ * Trade API controller for trade operations
+ *
+ * Provides methods for:
+ * - Fetching trade listings with optional filtering
+ * - Fetching sale details from GalaChain
+ *
+ * @example
+ * ```typescript
+ * // Get trades for a token with pagination
+ * const trades = await sdk.trade.getTrades({
+ *   tokenName: "MyToken",
+ *   page: 1,
+ *   limit: 10
+ * });
+ *
+ * // Fetch sale details from GalaChain
+ * const saleDetails = await sdk.trade.fetchSaleDetails({
+ *   vaultAddress: "service|Token$Unit$MYSYMBOL$address$launchpad"
+ * });
+ * ```
+ */
+export declare class TradeAPI {
+    private readonly http;
+    private readonly galaChainHttp;
+    private readonly launchpadAPI?;
+    constructor(http: HttpClient, galaChainHttp: HttpClient, launchpadAPI?: LaunchpadAPI | undefined);
+    /**
+     * Gets trades for a token by its tokenName with pagination
+     *
+     * This method provides a clean, intuitive API for fetching token trades
+     * using the token name. Follows the same pattern as CommentAPI.
+     *
+     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @param params Optional pagination parameters (page, limit)
+     * @returns Promise<GetTradesResponse> Trades with pagination info
+     * @throws ValidationError if token name is invalid or not found
+     *
+     * @example
+     * ```typescript
+     * // Get first page of trades for dragnrkti token
+     * const trades = await sdk.trade.getTradesByTokenName("dragnrkti");
+     *
+     * // Get specific page with custom limit
+     * const moreTrades = await sdk.trade.getTradesByTokenName("dragnrkti", { page: 2, limit: 20 });
+     * ```
+     */
+    getTradesByTokenName(tokenName: string, params?: TradeListParams): Promise<GetTradesResponse>;
+    /**
+     * Validates pagination parameters
+     */
+    private validatePagination;
+    /**
+     * Validates TradeListParams for tokenName-based methods
+     */
+    private validateTradeListParams;
+    /**
+     * Validates fetch sale details data
+     */
+    private validateFetchSaleDetailsData;
+    /**
+     * Builds query parameters for trade listing
+     * Note: GET /trade/ expects page/limit as STRINGS (backend quirk)
+     *
+     * @private
+     * @param tokenName Token name to filter by
+     * @param page Page number
+     * @param limit Items per page
+     * @returns Query parameters object
+     */
+    private buildTradeQueryParams;
+    /**
+     * Gets current sale details for a token by its tokenName
+     *
+     * This method provides a clean, intuitive API for fetching current trading pool
+     * state using the token name. It automatically resolves the tokenName
+     * to the correct vault address internally.
+     *
+     * @param tokenName Token name (e.g., "dragnrkti", "rocketri", "unicornri")
+     * @returns Promise<FetchSaleDetailsResponse> Current trading pool state and bonding curve data
+     * @throws ValidationError if token name is invalid or not found
+     *
+     * @example
+     * ```typescript
+     * // Get current sale details for dragnrkti token
+     * const saleDetails = await sdk.trade.getSaleDetailsByTokenName("dragnrkti");
+     * console.log('Current GALA in vault:', saleDetails.Data.nativeTokenQuantity);
+     * console.log('Bonding curve config:', saleDetails.Data.reverseBondingCurveConfiguration);
+     * ```
+     */
+    getSaleDetailsByTokenName(tokenName: string): Promise<FetchSaleDetailsResponse>;
+    /**
+     * Internal method for fetching sale details by vault address
+     * Used internally by getSaleDetailsByTokenName after vault resolution
+     *
+     * @private
+     * @param data Fetch sale details data with vault address
+     * @returns Promise<FetchSaleDetailsResponse> Current trading pool state
+     */
+    private fetchSaleDetails;
+    /**
+     * Gets the authenticated user's address in backend format
+     *
+     * @returns Address in eth|{40-hex-chars} format
+     */
+    getAddress(): string;
+    /**
+     * Validates a vault address format (exposed for external validation)
+     *
+     * @param vaultAddress Vault address to validate
+     * @returns True if valid vault address format
+     */
+    validateVaultAddress(vaultAddress: string): boolean;
+    /**
+     * Validates a user address format (exposed for external validation)
+     *
+     * @param userAddress User address to validate
+     * @returns True if valid user address format
+     */
+    validateUserAddress(userAddress: string): boolean;
+    /**
+     * Validates an amount string format (exposed for external validation)
+     *
+     * @param amount Amount string to validate
+     * @returns True if valid amount format
+     */
+    validateAmount(amount: string): boolean;
+    /**
+     * Validates a trade type (exposed for external validation)
+     *
+     * @param tradeType Trade type to validate
+     * @returns True if valid trade type
+     */
+    validateTradeType(tradeType: string): boolean;
+    /**
+     * Resolves a token name to its vault address using cached resolution
+     *
+     * Uses the shared VaultCache for intelligent caching to eliminate
+     * redundant API calls for the same tokenName.
+     *
+     * @private
+     * @param tokenName Token name to resolve (e.g., 'dragnrkti', 'rocketri')
+     * @returns Promise<string | null> Vault address if found, null otherwise
+     */
+    private resolveTokenNameToVault;
+    /**
+     * Validates address format (supports both eth| and 0x formats)
+     */
+    private isValidAddress;
+}
+//# sourceMappingURL=TradeAPI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TradeAPI.d.ts","sourceRoot":"","sources":["../../src/api/TradeAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,iBAAiB,EAEjB,eAAe,EAEf,wBAAwB,EAOzB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAFb,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,UAAU,EACzB,YAAY,CAAC,EAAE,YAAY,YAAA;IAI9C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8BvG;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAsCpC;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;;;;;;;;;;;;;;;OAkBG;IACG,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAwBrF;;;;;;;OAOG;YACW,gBAAgB;IA0B9B;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAInD;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjD;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ7C;;;;;;;;;OASG;YACW,uBAAuB;IAQrC;;OAEG;IACH,OAAO,CAAC,cAAc;CAuBvB"}