@gala-chain/launchpad-sdk 0.4.0

package/dist/utils/agent-config.d.ts

@@ -0,0 +1,206 @@
+/**
+ * 🤖 Agent Configuration Helper Utility
+ *
+ * Simplified configuration and setup utilities designed specifically for AI agents.
+ * Provides intelligent defaults, environment detection, and streamlined setup patterns.
+ *
+ * @category Agent Utilities
+ * @since 1.0.0
+ * @agent-capability Simplifies SDK setup and configuration for AI agents
+ * @agent-prerequisites Environment variables or configuration parameters
+ * @agent-example
+ * ```typescript
+ * import { AgentConfig } from '@gala-chain/launchpad-sdk';
+ *
+ * // Quick setup with intelligent defaults
+ * const { sdk, config } = await AgentConfig.quickSetup();
+ *
+ * // Verify everything is working
+ * const status = await AgentConfig.validateSetup(sdk);
+ * if (!status.ready) {
+ *   console.error('Setup issues:', status.issues);
+ * }
+ * ```
+ */
+import { LaunchpadSDK, LaunchpadSDKConfig } from '../LaunchpadSDK';
+import { GeneratedWallet } from './wallet';
+/**
+ * Environment types for different use cases
+ */
+export type AgentEnvironment = 'production' | 'development' | 'testing';
+/**
+ * Agent-specific configuration options
+ */
+export interface AgentSDKConfig {
+    /** Environment type - affects default URLs and settings */
+    environment?: AgentEnvironment;
+    /** Custom private key or 'generate' to create new wallet */
+    privateKey?: string | 'generate';
+    /** Custom base URL override */
+    baseUrl?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Agent identifier for logging and analytics */
+    agentId?: string;
+    /** Automatically validate setup after initialization */
+    autoValidate?: boolean;
+}
+/**
+ * Setup validation result
+ */
+export interface SetupValidation {
+    ready: boolean;
+    sdk: LaunchpadSDK;
+    wallet: GeneratedWallet;
+    issues: string[];
+    warnings: string[];
+    capabilities: {
+        canTrade: boolean;
+        canCreateTokens: boolean;
+        hasBalance: boolean;
+        connectionHealthy: boolean;
+    };
+}
+/**
+ * Agent configuration utility class
+ */
+export declare class AgentConfig {
+    /**
+     * Quick setup with intelligent defaults for AI agents
+     *
+     * This method provides the fastest path to a working SDK instance by:
+     * - Auto-detecting environment from NODE_ENV
+     * - Using PRIVATE_KEY env var or generating new wallet
+     * - Setting appropriate timeouts and debug levels
+     * - Validating the setup automatically
+     *
+     * @param config Optional configuration overrides
+     * @returns Promise resolving to SDK instance and configuration details
+     * @since 1.0.0
+     *
+     * @example Quick start for any environment
+     * ```typescript
+     * const { sdk, wallet, config } = await AgentConfig.quickSetup();
+     * console.log('Ready to trade with address:', sdk.getAddress());
+     * ```
+     *
+     * @example Production setup with existing wallet
+     * ```typescript
+     * const { sdk } = await AgentConfig.quickSetup({
+     *   environment: 'production',
+     *   privateKey: process.env.PRODUCTION_WALLET_KEY,
+     *   agentId: 'trading-bot-v1'
+     * });
+     * ```
+     *
+     * @example Development with auto-generated wallet
+     * ```typescript
+     * const { sdk, wallet } = await AgentConfig.quickSetup({
+     *   environment: 'development',
+     *   privateKey: 'generate',
+     *   debug: true
+     * });
+     * console.log('Save this key:', wallet.privateKey);
+     * ```
+     */
+    static quickSetup(config?: AgentSDKConfig): Promise<{
+        sdk: LaunchpadSDK;
+        wallet: GeneratedWallet;
+        config: LaunchpadSDKConfig;
+        validation?: SetupValidation;
+    }>;
+    /**
+     * Comprehensive setup validation for AI agents
+     *
+     * Performs thorough checks to ensure the SDK is ready for agent operations:
+     * - Network connectivity
+     * - Wallet authentication
+     * - Balance availability
+     * - API endpoint accessibility
+     * - Trading capabilities
+     *
+     * @param sdk Initialized SDK instance
+     * @param wallet Optional wallet for additional checks
+     * @returns Validation result with capabilities and issues
+     * @since 1.0.0
+     *
+     * @example Validate existing setup
+     * ```typescript
+     * const status = await AgentConfig.validateSetup(sdk);
+     * if (!status.ready) {
+     *   console.error('Issues found:', status.issues);
+     *   // Handle setup problems before proceeding
+     * }
+     * ```
+     *
+     * @example Check specific capabilities
+     * ```typescript
+     * const status = await AgentConfig.validateSetup(sdk);
+     * if (status.capabilities.canTrade) {
+     *   console.log('Trading operations available');
+     * }
+     * if (status.capabilities.canCreateTokens) {
+     *   console.log('Token creation available');
+     * }
+     * ```
+     */
+    static validateSetup(sdk: LaunchpadSDK, wallet?: GeneratedWallet): Promise<SetupValidation>;
+    /**
+     * Generate environment-specific configuration recommendations
+     *
+     * Provides tailored configuration suggestions based on intended use:
+     * - Production: Conservative timeouts, minimal logging
+     * - Development: Debug enabled, longer timeouts
+     * - Testing: Fast timeouts, comprehensive logging
+     *
+     * @param environment Target environment
+     * @param useCase Specific use case (trading, creation, monitoring)
+     * @returns Recommended configuration object
+     * @since 1.0.0
+     *
+     * @example Get production trading config
+     * ```typescript
+     * const config = AgentConfig.getRecommendedConfig('production', 'trading');
+     * const { sdk } = await AgentConfig.quickSetup(config);
+     * ```
+     */
+    static getRecommendedConfig(environment: AgentEnvironment, useCase?: 'trading' | 'creation' | 'monitoring' | 'general'): AgentSDKConfig;
+    /**
+     * Create configuration for multi-wallet scenarios
+     *
+     * Helps agents manage multiple wallets for different purposes:
+     * - Trading wallet with moderate balance
+     * - Creation wallet with high balance
+     * - Monitoring wallet (read-only)
+     *
+     * @param wallets Map of wallet names to private keys
+     * @param environment Target environment
+     * @returns Map of configured SDK instances
+     * @since 1.0.0
+     *
+     * @example Multi-wallet setup
+     * ```typescript
+     * const wallets = {
+     *   trader: process.env.TRADER_WALLET,
+     *   creator: process.env.CREATOR_WALLET,
+     *   monitor: 'generate' // Read-only operations
+     * };
+     *
+     * const sdks = await AgentConfig.multiWalletSetup(wallets, 'production');
+     *
+     * // Use appropriate wallet for each operation
+     * await sdks.trader.trade.buyTokens(...);
+     * await sdks.creator.launchpad.createSale(...);
+     * const pools = await sdks.monitor.launchpad.fetchPools(...);
+     * ```
+     */
+    static multiWalletSetup(wallets: Record<string, string>, environment?: AgentEnvironment): Promise<Record<string, LaunchpadSDK>>;
+    private static detectEnvironment;
+    private static setupWallet;
+    private static getDefaultBaseUrl;
+    private static getDefaultTimeout;
+    private static getEnvironmentDefaults;
+}
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/utils/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../src/utils/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAe,eAAe,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE;QACZ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,OAAO,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC;QACpB,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;WACU,UAAU,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC;QAC5D,GAAG,EAAE,YAAY,CAAC;QAClB,MAAM,EAAE,eAAe,CAAC;QACxB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,CAAC;IAkCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;WACU,aAAa,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA0EjG;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,oBAAoB,CACzB,WAAW,EAAE,gBAAgB,EAC7B,OAAO,GAAE,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,SAAqB,GACrE,cAAc;IA4CjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;WACU,gBAAgB,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,WAAW,GAAE,gBAAgC,GAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAkBxC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,OAAO,CAAC,MAAM,CAAC,WAAW;IAkB1B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAahC,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAmBtC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,85 @@
+import { SignatureAuth } from '../auth/SignatureAuth';
+import { RequestConfig, SDKConfig } from '../types/common';
+import { SigningType } from '@gala-chain/connect';
+/**
+ * HTTP client with automatic signature authentication
+ *
+ * This client automatically adds the `Sign` header to every request
+ * using wallet signatures generated by SignatureAuth.
+ */
+export declare class HttpClient {
+    private readonly axios;
+    private readonly auth;
+    private readonly debug;
+    constructor(auth: SignatureAuth, config?: SDKConfig);
+    /**
+     * Makes an authenticated HTTP request
+     *
+     * @param config Request configuration
+     * @returns Promise<T> Response data
+     */
+    request<T = any>(config: RequestConfig): Promise<T>;
+    /**
+     * Makes a GET request
+     */
+    get<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a POST request
+     */
+    post<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a PUT request
+     */
+    put<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a DELETE request
+     */
+    delete<T = any>(url: string, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a PATCH request
+     */
+    patch<T = any>(url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Gets the authenticated user's address in backend format (eth|address)
+     */
+    getAddress(): string;
+    /**
+     * Gets the authenticated user's Ethereum address (0x prefixed)
+     */
+    getEthereumAddress(): string;
+    /**
+     * Signs a message using the authenticated wallet
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Signs typed data using EIP-712 standard
+     */
+    signTypedData(domain: any, types: any, message: any): Promise<string>;
+    /**
+     * Signs a custom message (for endpoint-specific authentication)
+     *
+     * @param message The message to sign
+     * @returns Promise<{ signature: string; address: string; ethereumAddress: string }> Signature data
+     * @throws Error If signature generation fails
+     */
+    signCustomMessage(message: string): Promise<{
+        signature: string;
+        address: string;
+        ethereumAddress: string;
+    }>;
+    /**
+     * Signs a DTO using @gala-chain/connect SigningClient
+     * This automatically handles prefix calculation and EIP-712 signing
+     */
+    signWithGalaChain<T extends object>(method: string, dto: T, signingType?: SigningType): Promise<T & {
+        signature: string;
+        prefix?: string;
+        types: any;
+        domain: any;
+    }>;
+    /**
+     * Sets up axios interceptors for authentication and error handling
+     */
+    private setupInterceptors;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAiB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,IAAI,EAAE,aAAa,EAAE,MAAM,GAAE,SAAc;IAiBvD;;;;;OAKG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IA2DzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS3G;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS1F;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASzF;;OAEG;IACG,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS9G;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS3F;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3E;;;;;;OAMG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BlH;;;OAGG;IACG,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,GAAE,WAAyC,GAAG,OAAO,CAAC,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC;IAWvM;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAkF1B"}

package/dist/utils/multipart.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Utilities for handling multipart/form-data uploads
+ *
+ * This module provides cross-platform file upload support for both
+ * browser and Node.js environments.
+ */
+/**
+ * Error thrown when file validation fails
+ */
+export declare class FileValidationError extends Error {
+    filename?: string | undefined;
+    mimeType?: string | undefined;
+    constructor(message: string, filename?: string | undefined, mimeType?: string | undefined);
+}
+/**
+ * Validates a file against upload constraints
+ *
+ * @param file File or Buffer to validate
+ * @param filename Original filename (required for Buffer validation)
+ * @param mimeType MIME type (required for Buffer validation)
+ * @throws FileValidationError if validation fails
+ */
+export declare function validateFile(file: File | Buffer, filename?: string, mimeType?: string): void;
+/**
+ * Gets the file extension from a filename
+ *
+ * @param filename The filename to extract extension from
+ * @returns File extension including the dot (e.g., '.png')
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * Creates FormData for browser environments
+ *
+ * @param file File object to upload
+ * @param data Additional form fields
+ * @returns FormData object ready for upload
+ */
+export declare function createFormData(file: File, data?: Record<string, any>): FormData;
+/**
+ * Creates multipart form data for Node.js environments
+ *
+ * @param buffer Buffer containing file data
+ * @param filename Original filename
+ * @param mimeType MIME type of the file
+ * @param data Additional form fields
+ * @returns Object with data buffer and headers
+ */
+export declare function createMultipartFormData(buffer: Buffer, filename: string, mimeType: string, data?: Record<string, any>): {
+    data: Buffer;
+    headers: Record<string, string>;
+};
+/**
+ * Detects if this is a browser environment
+ */
+export declare function isBrowserEnvironment(): boolean;
+/**
+ * Detects if this is a Node.js environment
+ */
+export declare function isNodeEnvironment(): boolean;
+//# sourceMappingURL=multipart.d.ts.map

package/dist/utils/multipart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/utils/multipart.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IACR,QAAQ,CAAC,EAAE,MAAM;IAAS,QAAQ,CAAC,EAAE,MAAM;gBAAnE,OAAO,EAAE,MAAM,EAAS,QAAQ,CAAC,EAAE,MAAM,YAAA,EAAS,QAAQ,CAAC,EAAE,MAAM,YAAA;CAIhF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAyJ5F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,QAAQ,CAiB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAoCnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAkB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C"}

package/dist/utils/precision-math.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Precision-safe mathematical operations for cryptocurrency calculations
+ *
+ * This utility handles both decimal token amounts and wei values without
+ * losing precision in financial calculations. Critical for slippage protection
+ * and other DeFi operations where every wei matters.
+ */
+/**
+ * Safely calculates percentage adjustments on token amounts
+ * Handles both decimal values ("0.0005149") and wei values ("500000000000000000")
+ *
+ * @param value - Token amount as string (decimal or wei format)
+ * @param slippagePercent - Percentage to apply (e.g., 5 for 5%)
+ * @param increase - True to increase by percentage, false to decrease
+ * @returns Adjusted value as string, maintaining original precision
+ */
+export declare function calculateSlippageAmount(value: string, slippagePercent: number, increase: boolean): string;
+/**
+ * Utility to check if a value appears to be in wei format
+ * Wei values are typically large integers without decimal points
+ */
+export declare function isWeiFormat(value: string): boolean;
+/**
+ * Utility to check if a value appears to be in decimal format
+ * Decimal values contain a decimal point
+ */
+export declare function isDecimalFormat(value: string): boolean;
+/**
+ * Validates that a string represents a valid positive number
+ */
+export declare function isValidAmount(value: string): boolean;
+/**
+ * Safe conversion from any numeric string to a standardized format
+ * Handles edge cases and provides validation
+ */
+export declare function normalizeAmount(value: string): string;
+//# sourceMappingURL=precision-math.d.ts.map

package/dist/utils/precision-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision-math.d.ts","sourceRoot":"","sources":["../../src/utils/precision-math.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CA2BzG;AAkED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAcpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBrD"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Validation utilities for Launchpad API operations
+ *
+ * This module provides input validation to catch issues before making API calls,
+ * improving error messages and reducing unnecessary network requests.
+ */
+import { TokenUrls, CheckPoolOptions, FetchPoolOptions, GetAmountOptions, GetGraphOptions } from '../types/launchpad.dto';
+import { AddressFormat, EthereumAddress } from '../types/common';
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends Error {
+    field?: string | undefined;
+    code?: string | undefined;
+    constructor(message: string, field?: string | undefined, code?: string | undefined);
+}
+/**
+ * Validates a token name according to constraints
+ *
+ * @param tokenName Token name to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateTokenName(tokenName: string): void;
+/**
+ * Validates pagination parameters
+ *
+ * @param options Pagination options to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validatePagination(options: FetchPoolOptions): void;
+/**
+ * Validates address format
+ *
+ * @param address Address to validate
+ * @param fieldName Name of the field being validated
+ * @throws ValidationError if validation fails
+ */
+export declare function validateAddressFormat(address: string, fieldName?: string): void;
+/**
+ * Validates social media URLs
+ *
+ * @param urls URLs object to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateSocialUrls(urls: TokenUrls): void;
+/**
+ * Validates options for pool checking
+ *
+ * @param options Options to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateCheckPoolOptions(options: CheckPoolOptions): void;
+/**
+ * Validates options for amount calculation
+ *
+ * @param options Options to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateGetAmountOptions(options: GetAmountOptions): void;
+/**
+ * Validates options for graph data
+ *
+ * @param options Options to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateGetGraphOptions(options: GetGraphOptions): void;
+/**
+ * Validates create pool data (supports both CreatePoolData and CreateSaleData formats)
+ *
+ * @param data Pool creation data to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateCreatePoolData(data: any): void;
+/**
+ * Converts Ethereum address to backend format
+ *
+ * @param ethereumAddress Standard Ethereum address (0x...)
+ * @returns Address in backend format (eth|...)
+ */
+export declare function toBackendAddressFormat(ethereumAddress: string): AddressFormat;
+/**
+ * Converts backend address format to standard Ethereum address
+ *
+ * @param backendAddress Backend address format (eth|...)
+ * @returns Standard Ethereum address (0x...)
+ */
+export declare function fromBackendAddressFormat(backendAddress: string): string;
+/**
+ * Validates create sale data (for bundle backend)
+ *
+ * @param data Sale creation data to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateCreateSaleData(data: any): void;
+export declare function isValidEthereumAddress(address: string): boolean;
+export declare function isValidAddressFormat(address: string): address is AddressFormat;
+export declare function formatAddressForBackend(address: EthereumAddress): AddressFormat;
+export declare function formatAddressForEthereum(formattedAddress: AddressFormat): EthereumAddress;
+/**
+ * Generates a vault address for commenting on tokens
+ *
+ * Format: service|Token$Unit$[SYMBOL]$eth:[CREATOR_ADDRESS]$launchpad
+ *
+ * @param tokenSymbol Token symbol (e.g., "BOBA", "CMPASY")
+ * @param creatorAddress Creator's wallet address (without 0x prefix)
+ * @returns Vault address string for comment operations
+ *
+ * @example
+ * ```typescript
+ * const vaultAddress = generateTokenVaultAddress("BOBA", "9401b171307be656f00f9e18df756643fd3a91de");
+ * // Returns: "service|Token$Unit$BOBA$eth:9401b171307be656f00f9e18df756643fd3a91de$launchpad"
+ * ```
+ */
+export declare function generateTokenVaultAddress(tokenSymbol: string, creatorAddress: string): string;
+/**
+ * Extracts token symbol and creator address from a vault address
+ *
+ * @param vaultAddress Vault address to parse
+ * @returns Object with tokenSymbol and creatorAddress, or null if invalid format
+ *
+ * @example
+ * ```typescript
+ * const parsed = parseTokenVaultAddress("service|Token$Unit$BOBA$eth:9401b171307be656f00f9e18df756643fd3a91de$launchpad");
+ * // Returns: { tokenSymbol: "BOBA", creatorAddress: "9401b171307be656f00f9e18df756643fd3a91de" }
+ * ```
+ */
+export declare function parseTokenVaultAddress(vaultAddress: string): {
+    tokenSymbol: string;
+    creatorAddress: string;
+} | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACJ,KAAK,CAAC,EAAE,MAAM;IAAS,IAAI,CAAC,EAAE,MAAM;gBAA5D,OAAO,EAAE,MAAM,EAAS,KAAK,CAAC,EAAE,MAAM,YAAA,EAAS,IAAI,CAAC,EAAE,MAAM,YAAA;CAIzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA2BzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAwBlE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,IAAI,CAkB1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAyCxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA+BxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAoFxE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAoEtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAqJtD;AAiBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAsB7E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CA2CtD;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,aAAa,CAQ9E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAE/E;AAED,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,aAAa,GAAG,eAAe,CAEzF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAuB7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBnH"}