@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/utils/errors.d.ts

@@ -0,0 +1,548 @@
+/**
+ * Common Error Classes
+ *
+ * Base error classes used throughout the SDK for validation and operation failures.
+ * Extracted to a separate module to prevent circular dependencies.
+ *
+ * @category Utilities
+ * @since 3.6.5
+ */
+/**
+ * Standard error codes for ValidationError
+ *
+ * Use these constants instead of string literals for:
+ * - IDE autocomplete support
+ * - Typo prevention
+ * - Consistent error handling across the SDK
+ *
+ * @example
+ * ```typescript
+ * import { ValidationError, ERROR_CODES } from '../utils/errors';
+ *
+ * throw new ValidationError('tokenName is required', 'tokenName', ERROR_CODES.REQUIRED);
+ * ```
+ *
+ * @since 6.3.0
+ */
+export declare const ERROR_CODES: {
+    /** Field is null, undefined, or missing */
+    readonly REQUIRED: "REQUIRED";
+    /** Field has wrong type (string expected, got number, etc.) */
+    readonly INVALID_TYPE: "INVALID_TYPE";
+    /** Field value is outside acceptable range or set */
+    readonly INVALID_VALUE: "INVALID_VALUE";
+    /** Field doesn't match required pattern (regex) */
+    readonly INVALID_FORMAT: "INVALID_FORMAT";
+    /** Field length is below minimum */
+    readonly TOO_SHORT: "TOO_SHORT";
+    /** Field length exceeds maximum */
+    readonly TOO_LONG: "TOO_LONG";
+    /** Numeric value exceeds maximum */
+    readonly TOO_LARGE: "TOO_LARGE";
+    /** Numeric value is below minimum */
+    readonly TOO_SMALL: "TOO_SMALL";
+    /** Array is empty when it shouldn't be */
+    readonly EMPTY_ARRAY: "EMPTY_ARRAY";
+    /** Array exceeds maximum length */
+    readonly ARRAY_TOO_LARGE: "ARRAY_TOO_LARGE";
+    /** Value is zero when non-zero expected */
+    readonly ZERO_VALUE: "ZERO_VALUE";
+    /** Tick spacing doesn't match fee tier requirements */
+    readonly INVALID_TICK_SPACING: "INVALID_TICK_SPACING";
+    /** Fee tier is not valid (500, 3000, 10000) */
+    readonly INVALID_FEE_TIER: "INVALID_FEE_TIER";
+    /** Price range is invalid (min >= max) */
+    readonly INVALID_RANGE: "INVALID_RANGE";
+    /** HTTP request parameters are invalid */
+    readonly INVALID_PARAMETERS: "INVALID_PARAMETERS";
+    /** Resource (position, pool, etc.) not found */
+    readonly NOT_FOUND: "NOT_FOUND";
+    /** Position data is malformed or incomplete */
+    readonly INVALID_DATA: "INVALID_DATA";
+};
+/**
+ * Type for error codes - use for type-safe error code handling
+ *
+ * @example
+ * ```typescript
+ * function handleError(code: ErrorCode) {
+ *   switch (code) {
+ *     case ERROR_CODES.REQUIRED:
+ *       return 'This field is required';
+ *     case ERROR_CODES.INVALID_FORMAT:
+ *       return 'Invalid format';
+ *     // ... other cases
+ *   }
+ * }
+ * ```
+ */
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * Error thrown when validation fails
+ *
+ * This error is used throughout the SDK to indicate that input validation
+ * has failed. It provides structured information about what failed and why.
+ *
+ * @example Basic validation error
+ * ```typescript
+ * throw new ValidationError(
+ *   'Token name must be between 3 and 20 characters',
+ *   'tokenName',
+ *   'INVALID_TOKEN_NAME'
+ * );
+ * ```
+ *
+ * @example Catching validation errors
+ * ```typescript
+ * try {
+ *   validateTokenName(name);
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log(`Field: ${error.field}`);
+ *     console.log(`Code: ${error.code}`);
+ *     console.log(`Message: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ValidationError extends Error {
+    field?: string | undefined;
+    code?: string | undefined;
+    /**
+     * Creates a new ValidationError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param field - Optional field name that failed validation
+     * @param code - Optional error code for programmatic handling (e.g., 'INVALID_TOKEN_NAME')
+     */
+    constructor(message: string, field?: string | undefined, code?: string | undefined);
+}
+/**
+ * Error thrown when network operations fail
+ *
+ * This error is used for HTTP request failures, API communication errors,
+ * and network connectivity issues. It captures the HTTP status code and
+ * original error for debugging.
+ *
+ * @example HTTP request failure
+ * ```typescript
+ * throw new NetworkError(
+ *   'Failed to fetch pool data',
+ *   404,
+ *   originalError
+ * );
+ * ```
+ *
+ * @example Catching network errors
+ * ```typescript
+ * try {
+ *   await api.fetchPools();
+ * } catch (error) {
+ *   if (error instanceof NetworkError) {
+ *     if (error.statusCode === 404) {
+ *       console.log('Resource not found');
+ *     } else if (error.statusCode && error.statusCode >= 500) {
+ *       console.log('Server error, retry later');
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class NetworkError extends Error {
+    statusCode?: number | undefined;
+    originalError?: Error | undefined;
+    /**
+     * Creates a new NetworkError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param statusCode - Optional HTTP status code (404, 500, etc.)
+     * @param originalError - Optional original error that caused this failure
+     */
+    constructor(message: string, statusCode?: number | undefined, originalError?: Error | undefined);
+}
+/**
+ * Error thrown when SDK configuration is invalid
+ *
+ * This error is used during SDK initialization when configuration parameters
+ * are missing, malformed, or incompatible. It helps users identify and fix
+ * configuration issues quickly.
+ *
+ * @example Invalid configuration
+ * ```typescript
+ * throw new ConfigurationError(
+ *   'Invalid timeout value: must be between 1000 and 300000',
+ *   'timeout'
+ * );
+ * ```
+ *
+ * @example Catching configuration errors
+ * ```typescript
+ * try {
+ *   const sdk = new LaunchpadSDK(config);
+ * } catch (error) {
+ *   if (error instanceof ConfigurationError) {
+ *     console.log(`Fix config field: ${error.field}`);
+ *     console.log(`Issue: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class ConfigurationError extends Error {
+    field?: string | undefined;
+    /**
+     * Creates a new ConfigurationError
+     *
+     * @param message - Human-readable error message describing the configuration issue
+     * @param field - Optional configuration field name that is invalid
+     */
+    constructor(message: string, field?: string | undefined);
+}
+/**
+ * Error thrown when blockchain transactions fail
+ *
+ * This error is used for transaction-related failures including submission errors,
+ * execution failures, and invalid transaction states. It captures the transaction ID
+ * and error code for debugging and recovery.
+ *
+ * @example Transaction execution failure
+ * ```typescript
+ * throw new TransactionError(
+ *   'Transaction reverted: insufficient balance',
+ *   'abc123',
+ *   'INSUFFICIENT_BALANCE'
+ * );
+ * ```
+ *
+ * @example Catching transaction errors
+ * ```typescript
+ * try {
+ *   const result = await sdk.buy(options);
+ * } catch (error) {
+ *   if (error instanceof TransactionError) {
+ *     console.log(`Transaction ${error.transactionId} failed`);
+ *     console.log(`Error code: ${error.code}`);
+ *     // Implement retry logic or user notification
+ *   }
+ * }
+ * ```
+ */
+export declare class TransactionError extends Error {
+    transactionId?: string | undefined;
+    code?: string | undefined;
+    /**
+     * Creates a new TransactionError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param transactionId - Optional transaction identifier for tracking
+     * @param code - Optional error code for programmatic handling
+     */
+    constructor(message: string, transactionId?: string | undefined, code?: string | undefined);
+}
+/**
+ * Error thrown when GSwap SDK quote operations fail
+ *
+ * This error is thrown during quote generation (exact input or exact output).
+ * It preserves the original GSwap SDK error for detailed diagnostics.
+ *
+ * @example Quote generation failure
+ * ```typescript
+ * throw new GSwapQuoteError(
+ *   'Failed to get quote for GALA to GUSDC swap',
+ *   originalGSwapError,
+ *   'POOL_NOT_FOUND'
+ * );
+ * ```
+ *
+ * @example Catching quote errors
+ * ```typescript
+ * try {
+ *   const quote = await service.getSwapQuoteExactInput({ fromToken: 'GALA', toToken: 'GUSDC', amount: '100' });
+ * } catch (error) {
+ *   if (error instanceof GSwapQuoteError) {
+ *     console.log(`Quote failed: ${error.message}`);
+ *     console.log(`GSwap error: ${error.code}`);
+ *     // Implement user notification
+ *   }
+ * }
+ * ```
+ */
+export declare class GSwapQuoteError extends Error {
+    originalError: unknown;
+    code?: string | undefined;
+    /**
+     * Creates a new GSwapQuoteError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param originalError - The original error from GSwap SDK
+     * @param code - Optional error code from GSwap SDK for programmatic handling
+     */
+    constructor(message: string, originalError: unknown, code?: string | undefined);
+}
+/**
+ * Error thrown when GSwap SDK swap execution fails
+ *
+ * This error is thrown during token swap execution (buy/sell operations).
+ * It preserves the original GSwap SDK error and transaction details.
+ *
+ * @example Swap execution failure
+ * ```typescript
+ * throw new GSwapSwapError(
+ *   'Token swap failed: insufficient balance',
+ *   originalGSwapError,
+ *   'txHash123',
+ *   'INSUFFICIENT_BALANCE'
+ * );
+ * ```
+ *
+ * @example Catching swap errors
+ * ```typescript
+ * try {
+ *   const result = await service.executeSwap(swapParams);
+ * } catch (error) {
+ *   if (error instanceof GSwapSwapError) {
+ *     console.log(`Swap failed: ${error.message}`);
+ *     if (error.transactionHash) {
+ *       console.log(`TX: ${error.transactionHash}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class GSwapSwapError extends Error {
+    originalError: unknown;
+    transactionHash?: string | undefined;
+    code?: string | undefined;
+    /**
+     * Creates a new GSwapSwapError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param originalError - The original error from GSwap SDK
+     * @param transactionHash - Optional transaction hash for transaction tracking
+     * @param code - Optional error code from GSwap SDK for programmatic handling
+     */
+    constructor(message: string, originalError: unknown, transactionHash?: string | undefined, code?: string | undefined);
+}
+/**
+ * Error thrown when GSwap SDK pool operations fail
+ *
+ * This error is thrown when pool-related queries fail, including:
+ * - Pool information retrieval
+ * - Available token swaps querying
+ * - Pool data access errors
+ *
+ * @example Pool query failure
+ * ```typescript
+ * throw new GSwapPoolError(
+ *   'Pool not found for GALA/GUSDC pair',
+ *   originalGSwapError,
+ *   'GALA',
+ *   'GUSDC',
+ *   'POOL_NOT_FOUND'
+ * );
+ * ```
+ *
+ * @example Catching pool errors
+ * ```typescript
+ * try {
+ *   const poolInfo = await service.getPoolInfo('GALA', 'GUSDC');
+ * } catch (error) {
+ *   if (error instanceof GSwapPoolError) {
+ *     console.log(`Pool error: ${error.message}`);
+ *     if (error.code === 'POOL_NOT_FOUND') {
+ *       console.log(`No pool for ${error.tokenA}/${error.tokenB}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class GSwapPoolError extends Error {
+    originalError: unknown;
+    tokenA?: string | undefined;
+    tokenB?: string | undefined;
+    code?: string | undefined;
+    /**
+     * Creates a new GSwapPoolError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param originalError - The original error from GSwap SDK
+     * @param tokenA - Optional token A symbol in the pool pair
+     * @param tokenB - Optional token B symbol in the pool pair
+     * @param code - Optional error code from GSwap SDK for programmatic handling
+     */
+    constructor(message: string, originalError: unknown, tokenA?: string | undefined, tokenB?: string | undefined, code?: string | undefined);
+}
+/**
+ * Error thrown when GSwap SDK asset/balance operations fail
+ *
+ * This error is thrown when asset-related queries fail, including:
+ * - User asset/balance retrieval
+ * - Portfolio data access errors
+ * - Asset validation failures
+ *
+ * @example Asset query failure
+ * ```typescript
+ * throw new GSwapAssetError(
+ *   'Failed to fetch user assets',
+ *   originalGSwapError,
+ *   'userAddress123',
+ *   'NETWORK_ERROR'
+ * );
+ * ```
+ *
+ * @example Catching asset errors
+ * ```typescript
+ * try {
+ *   const assets = await service.getUserAssets(walletAddress);
+ * } catch (error) {
+ *   if (error instanceof GSwapAssetError) {
+ *     console.log(`Asset query failed: ${error.message}`);
+ *     console.log(`Wallet: ${error.walletAddress}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class GSwapAssetError extends Error {
+    originalError: unknown;
+    walletAddress?: string | undefined;
+    code?: string | undefined;
+    /**
+     * Creates a new GSwapAssetError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param originalError - The original error from GSwap SDK
+     * @param walletAddress - Optional wallet address being queried
+     * @param code - Optional error code from GSwap SDK for programmatic handling
+     */
+    constructor(message: string, originalError: unknown, walletAddress?: string | undefined, code?: string | undefined);
+}
+/**
+ * Error thrown when GSwap SDK liquidity position operations fail
+ *
+ * This error is thrown when position management operations fail, including:
+ * - Position queries (getUserPositions, getPosition, getPositionById)
+ * - Liquidity addition (addLiquidityByPrice, addLiquidityByTicks)
+ * - Liquidity removal (removeLiquidity)
+ * - Fee collection (collectPositionFees)
+ * - Position estimation (estimateRemoveLiquidity)
+ *
+ * @example Position operation failure
+ * ```typescript
+ * throw new GSwapPositionError(
+ *   'Failed to add liquidity to GALA/GUSDC pool',
+ *   originalGSwapError,
+ *   'INSUFFICIENT_BALANCE'
+ * );
+ * ```
+ *
+ * @example Catching position errors
+ * ```typescript
+ * try {
+ *   const result = await service.addLiquidityByPrice({ token0: 'GALA', token1: 'GUSDC', ... });
+ * } catch (error) {
+ *   if (error instanceof GSwapPositionError) {
+ *     console.log(`Position operation failed: ${error.message}`);
+ *     console.log(`Error code: ${error.code}`);
+ *     // Implement user notification or recovery logic
+ *   }
+ * }
+ * ```
+ */
+export declare class GSwapPositionError extends Error {
+    originalError: unknown;
+    code?: string | undefined;
+    /**
+     * Creates a new GSwapPositionError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param originalError - The original error from GSwap SDK
+     * @param code - Optional error code from GSwap SDK for programmatic handling
+     */
+    constructor(message: string, originalError: unknown, code?: string | undefined);
+}
+/**
+ * Error thrown when DEX quote operations fail
+ *
+ * This error is thrown during DEX quote calculations (local and external),
+ * composite pool data fetching, and related operations. It captures the
+ * operation context for debugging and recovery.
+ *
+ * @example Quote calculation failure
+ * ```typescript
+ * throw new DexQuoteError(
+ *   'Failed to calculate quote for GALA/BENE swap',
+ *   {
+ *     fromToken: 'GALA|Unit|none|none',
+ *     toToken: 'Token|Unit|BENE|client:123',
+ *     amount: '1000'
+ *   }
+ * );
+ * ```
+ *
+ * @example Catching quote errors
+ * ```typescript
+ * try {
+ *   const quote = await sdk.calculateDexPoolQuoteExactAmountLocal({
+ *     compositePoolData: composite,
+ *     fromToken: 'GALA|Unit|none|none',
+ *     toToken: 'Token|Unit|BENE|client:123',
+ *     amount: '1000'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof DexQuoteError) {
+ *     console.log(`Quote failed: ${error.message}`);
+ *     if (error.context) {
+ *       console.log(`Tokens: ${error.context.fromToken} → ${error.context.toToken}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class DexQuoteError extends ValidationError {
+    context?: unknown | undefined;
+    /**
+     * Creates a new DexQuoteError
+     *
+     * @param message - Human-readable error message describing what failed
+     * @param context - Optional context object with operation details (tokens, amounts, etc.)
+     */
+    constructor(message: string, context?: unknown | undefined);
+}
+/**
+ * Error thrown when a DEX pool is not found
+ *
+ * This error is thrown when attempting to access or fetch data for a DEX pool
+ * that does not exist, typically during composite pool data retrieval or pool
+ * discovery operations.
+ *
+ * @example Pool not found
+ * ```typescript
+ * throw new DexPoolNotFoundError(
+ *   'Pool not found: GALA/BENE with fee 3000'
+ * );
+ * ```
+ *
+ * @example Catching pool not found errors
+ * ```typescript
+ * try {
+ *   const composite = await sdk.fetchCompositePoolData({
+ *     token0: 'GALA|Unit|none|none',
+ *     token1: 'Token|Unit|BENE|client:123',
+ *     fee: 3000
+ *   });
+ * } catch (error) {
+ *   if (error instanceof DexPoolNotFoundError) {
+ *     console.log('Pool does not exist. Create it first with liquidity.');
+ *     // Implement pool creation or alternative routing
+ *   }
+ * }
+ * ```
+ */
+export declare class DexPoolNotFoundError extends ValidationError {
+    /**
+     * Creates a new DexPoolNotFoundError
+     *
+     * @param message - Human-readable error message describing which pool was not found
+     */
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW;IACtB,2CAA2C;;IAE3C,+DAA+D;;IAE/D,qDAAqD;;IAErD,mDAAmD;;IAEnD,oCAAoC;;IAEpC,mCAAmC;;IAEnC,oCAAoC;;IAEpC,qCAAqC;;IAErC,0CAA0C;;IAE1C,mCAAmC;;IAEnC,2CAA2C;;IAE3C,uDAAuD;;IAEvD,+CAA+C;;IAE/C,0CAA0C;;IAE1C,0CAA0C;;IAE1C,gDAAgD;;IAEhD,+CAA+C;;CAEvC,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAU/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAU5B,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IAV9B;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IASlC,KAAK,CAAC,EAAE,MAAM;IARvB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAUhC,aAAa,CAAC,EAAE,MAAM;IACtB,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAU/B,aAAa,EAAE,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,EAAE,OAAO,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAW9B,aAAa,EAAE,OAAO;IACtB,eAAe,CAAC,EAAE,MAAM;IACxB,IAAI,CAAC,EAAE,MAAM;IAZtB;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,EAAE,OAAO,EACtB,eAAe,CAAC,EAAE,MAAM,YAAA,EACxB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAY9B,aAAa,EAAE,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM;IACf,MAAM,CAAC,EAAE,MAAM;IACf,IAAI,CAAC,EAAE,MAAM;IAdtB;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,EAAE,OAAO,EACtB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAW/B,aAAa,EAAE,OAAO;IACtB,aAAa,CAAC,EAAE,MAAM;IACtB,IAAI,CAAC,EAAE,MAAM;IAZtB;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,EAAE,OAAO,EACtB,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAUlC,aAAa,EAAE,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,EAAE,OAAO,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAUvC,OAAO,CAAC,EAAE,OAAO;IAT1B;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EAER,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAI5B"}

package/dist/utils/http-factory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * HTTP Client Factory
+ *
+ * Factory function for creating standardized HTTP clients with consistent configuration.
+ * Eliminates boilerplate axios.create() calls across services.
+ *
+ * @category Utilities
+ * @since 6.6.0
+ */
+import type { AxiosInstance } from 'axios';
+/**
+ * Creates a standardized HTTP client (AxiosInstance) with baseURL and timeout configuration
+ *
+ * Factory function that eliminates repeated axios.create() boilerplate by providing
+ * consistent default configuration across all HTTP clients.
+ *
+ * @param baseUrl Base URL for all requests made by this client
+ * @param timeout Request timeout in milliseconds (default: 30000)
+ * @returns Configured AxiosInstance ready for HTTP requests
+ *
+ * @example Basic usage
+ * ```typescript
+ * const httpClient = createHttpExecutor('https://api.example.com', 30000);
+ * const response = await httpClient.get('/data');
+ * ```
+ *
+ * @example Default timeout
+ * ```typescript
+ * const httpClient = createHttpExecutor('https://api.example.com');
+ * // Uses default 30000ms timeout
+ * ```
+ *
+ * @since 6.6.0
+ */
+export declare function createHttpExecutor(baseUrl: string, timeout?: number): AxiosInstance;
+//# sourceMappingURL=http-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-factory.d.ts","sourceRoot":"","sources":["../../src/utils/http-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAc,GACtB,aAAa,CAQf"}

package/dist/utils/http.d.ts

@@ -0,0 +1,97 @@
+import { SigningType } from '@gala-chain/connect';
+import type { SignatureAuth } from '../auth/SignatureAuth';
+import type { RequestConfig, SDKConfig } from '../types/common';
+import type { EIP712Domain, EIP712Types } from '../types/trade.dto';
+/**
+ * HTTP client with optional signature authentication
+ *
+ * This client automatically adds the `Sign` header to every request
+ * using wallet signatures generated by SignatureAuth when a wallet is configured.
+ *
+ * In read-only mode (no wallet), the client skips authentication headers
+ * and allows querying public data endpoints.
+ */
+export declare class HttpClient {
+    private readonly axios;
+    private readonly auth;
+    private readonly debug;
+    private readonly logger;
+    private requestInterceptorId;
+    private responseInterceptorId;
+    constructor(auth: SignatureAuth | undefined, 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, unknown>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a POST request
+     */
+    post<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a PUT request
+     */
+    put<T = any>(url: string, data?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a DELETE request
+     */
+    delete<T = any>(url: string, params?: Record<string, unknown>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Makes a PATCH request
+     */
+    patch<T = any>(url: string, data?: unknown, 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: EIP712Domain, types: EIP712Types, message: Record<string, unknown>): 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: EIP712Types;
+        domain: EIP712Domain;
+    }>;
+    /**
+     * Sets up axios interceptors for authentication and error handling
+     */
+    private setupInterceptors;
+    /**
+     * Cleanup method to eject interceptors and prevent memory leaks
+     * Should be called when the HttpClient instance is no longer needed
+     */
+    cleanup(): void;
+}
+//# 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":"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"}