@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/utils/hyperLiquidValidation.mjs

@@ -1,413 +0,0 @@
-import { isValidHexAddress } from "@metamask/utils";
-import { HYPERLIQUID_ASSET_CONFIGS, getSupportedAssets, TRADING_DEFAULTS } from "../constants/hyperLiquidConfig.mjs";
-import { HYPERLIQUID_ORDER_LIMITS } from "../constants/perpsConfig.mjs";
-import { PERPS_ERROR_CODES } from "../constants/perpsErrorCodes.mjs";
-/**
- * Validation utilities for HyperLiquid operations
- */
-/**
- * Create standardized error response.
- *
- * @param error - The error that occurred
- * @param defaultResponse - The default response object to use as template
- * @returns The error response with success=false and error message
- */
-export function createErrorResult(error, defaultResponse) {
-    return {
-        ...defaultResponse,
-        success: false,
-        error: error instanceof Error ? error.message : PERPS_ERROR_CODES.UNKNOWN_ERROR,
-    };
-}
-/**
- * Validate withdrawal parameters.
- *
- * @param params - Withdrawal parameters to validate
- * @param params.assetId - The CAIP asset ID to withdraw
- * @param params.amount - Amount to withdraw as string
- * @param params.destination - Optional destination hex address
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateWithdrawalParams(params, debugLogger) {
-    debugLogger?.log('validateWithdrawalParams: Starting validation', {
-        params,
-        hasAssetId: Boolean(params.assetId),
-        hasAmount: Boolean(params.amount),
-        hasDestination: Boolean(params.destination),
-    });
-    // Validate required parameters
-    if (!params.assetId) {
-        debugLogger?.log('validateWithdrawalParams: Missing assetId', {
-            error: PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,
-            params,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,
-        };
-    }
-    // Validate amount
-    if (!params.amount) {
-        debugLogger?.log('validateWithdrawalParams: Missing amount', {
-            error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,
-            params,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,
-        };
-    }
-    const amount = parseFloat(params.amount);
-    if (isNaN(amount) || amount <= 0) {
-        debugLogger?.log('validateWithdrawalParams: Invalid amount', {
-            error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,
-            amount: params.amount,
-            parsedAmount: amount,
-            isNaN: isNaN(amount),
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,
-        };
-    }
-    // Validate destination address if provided
-    if (params.destination && !isValidHexAddress(params.destination)) {
-        debugLogger?.log('validateWithdrawalParams: Invalid destination address', {
-            error: PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,
-            destination: params.destination,
-            isValidHex: isValidHexAddress(params.destination),
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,
-        };
-    }
-    debugLogger?.log('validateWithdrawalParams: All validations passed', {
-        assetId: params.assetId,
-        amount: params.amount,
-        destination: params.destination ?? 'will use user wallet',
-    });
-    return { isValid: true };
-}
-/**
- * Validate deposit parameters.
- *
- * @param params - Deposit parameters to validate
- * @param params.assetId - The CAIP asset ID to deposit
- * @param params.amount - Amount to deposit as string
- * @param params.isTestnet - Whether this is a testnet deposit
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateDepositParams(params, debugLogger) {
-    debugLogger?.log('validateDepositParams: Starting validation', {
-        params,
-        hasAssetId: Boolean(params.assetId),
-        hasAmount: Boolean(params.amount),
-        isTestnet: params.isTestnet,
-    });
-    // Validate required parameters
-    if (!params.assetId) {
-        debugLogger?.log('validateDepositParams: Missing assetId', {
-            error: PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,
-            params,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,
-        };
-    }
-    // Validate amount
-    if (!params.amount) {
-        debugLogger?.log('validateDepositParams: Missing amount', {
-            error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,
-            params,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,
-        };
-    }
-    const amount = parseFloat(params.amount);
-    if (isNaN(amount) || amount <= 0) {
-        debugLogger?.log('validateDepositParams: Invalid amount', {
-            error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,
-            amount: params.amount,
-            parsedAmount: amount,
-            isNaN: isNaN(amount),
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,
-        };
-    }
-    // Check minimum deposit amount
-    const minimumAmount = params.isTestnet
-        ? TRADING_DEFAULTS.amount.testnet
-        : TRADING_DEFAULTS.amount.mainnet;
-    debugLogger?.log('validateDepositParams: Checking minimum amount', {
-        amount,
-        minimumAmount,
-        isTestnet: params.isTestnet,
-        network: params.isTestnet ? 'testnet' : 'mainnet',
-    });
-    if (amount < minimumAmount) {
-        debugLogger?.log('validateDepositParams: Below minimum deposit', {
-            error: PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,
-            amount,
-            minimumAmount,
-            difference: minimumAmount - amount,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,
-        };
-    }
-    debugLogger?.log('validateDepositParams: All validations passed', {
-        assetId: params.assetId,
-        amount: params.amount,
-        parsedAmount: amount,
-        minimumAmount,
-        isTestnet: params.isTestnet,
-    });
-    return { isValid: true };
-}
-/**
- * Validate asset support for withdrawals using AssetRoute arrays.
- *
- * @param assetId - The CAIP asset ID to validate
- * @param supportedRoutes - Array of supported asset routes
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateAssetSupport(assetId, supportedRoutes, debugLogger) {
-    debugLogger?.log('validateAssetSupport: Checking asset support', {
-        assetId,
-        supportedRoutesCount: supportedRoutes.length,
-    });
-    const supportedAssetIds = supportedRoutes.map((route) => route.assetId);
-    // Check if asset is supported
-    const isSupported = supportedAssetIds.includes(assetId);
-    if (!isSupported) {
-        // Also check case-insensitive match for contract addresses
-        const isSupportedCaseInsensitive = supportedAssetIds.some((supportedId) => supportedId.toLowerCase() === assetId.toLowerCase());
-        if (!isSupportedCaseInsensitive) {
-            debugLogger?.log('validateAssetSupport: Asset not supported', {
-                error: PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,
-                assetId,
-                supportedAssetIds,
-                checkedCaseInsensitive: true,
-            });
-            return {
-                isValid: false,
-                error: PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,
-            };
-        }
-        debugLogger?.log('⚠️ validateAssetSupport: Asset supported with case mismatch', {
-            providedAssetId: assetId,
-            matchedAssetId: supportedAssetIds.find((id) => id.toLowerCase() === assetId.toLowerCase()),
-        });
-    }
-    debugLogger?.log('validateAssetSupport: Asset is supported', {
-        assetId,
-    });
-    return { isValid: true };
-}
-/**
- * Validate balance against withdrawal amount.
- *
- * @param withdrawAmount - The amount to withdraw
- * @param availableBalance - The available balance
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateBalance(withdrawAmount, availableBalance, debugLogger) {
-    debugLogger?.log('validateBalance: Checking balance sufficiency', {
-        withdrawAmount,
-        availableBalance,
-        difference: availableBalance - withdrawAmount,
-    });
-    if (withdrawAmount > availableBalance) {
-        const shortfall = withdrawAmount - availableBalance;
-        debugLogger?.log('validateBalance: Insufficient balance', {
-            error: PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,
-            withdrawAmount,
-            availableBalance,
-            shortfall,
-            percentageOfAvailable: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,
-        });
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,
-        };
-    }
-    const remainingBalance = availableBalance - withdrawAmount;
-    debugLogger?.log('validateBalance: Balance is sufficient', {
-        withdrawAmount,
-        availableBalance,
-        remainingBalance,
-        percentageUsed: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,
-    });
-    return { isValid: true };
-}
-/**
- * Apply filters to asset paths with comprehensive logging.
- *
- * @param assets - Array of CAIP asset IDs to filter
- * @param params - Filter parameters including chainId, symbol, and assetId
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Filtered array of CAIP asset IDs
- */
-export function applyPathFilters(assets, params, debugLogger) {
-    if (!params) {
-        debugLogger?.log('HyperLiquid: applyPathFilters - no params, returning all assets', { assets });
-        return assets;
-    }
-    let filtered = assets;
-    debugLogger?.log('HyperLiquid: applyPathFilters - starting filter', {
-        initialAssets: assets,
-        filterParams: params,
-    });
-    if (params.chainId) {
-        const before = filtered;
-        filtered = filtered.filter((asset) => asset.startsWith(params.chainId));
-        debugLogger?.log('HyperLiquid: applyPathFilters - chainId filter', {
-            chainId: params.chainId,
-            before,
-            after: filtered,
-        });
-    }
-    if (params.symbol && params.symbol in HYPERLIQUID_ASSET_CONFIGS) {
-        const config = HYPERLIQUID_ASSET_CONFIGS[params.symbol];
-        const isTestnet = params.isTestnet ?? false;
-        const selectedAsset = isTestnet ? config.testnet : config.mainnet;
-        const before = filtered;
-        filtered = [selectedAsset];
-        debugLogger?.log('HyperLiquid: applyPathFilters - symbol filter', {
-            symbol: params.symbol,
-            isTestnet,
-            config,
-            selectedAsset,
-            before,
-            after: filtered,
-        });
-    }
-    if (params.assetId) {
-        const before = filtered;
-        // Use case-insensitive comparison for asset ID matching to handle address case differences
-        filtered = filtered.filter((asset) => asset.toLowerCase() === params.assetId?.toLowerCase());
-        debugLogger?.log('HyperLiquid: applyPathFilters - assetId filter', {
-            assetId: params.assetId,
-            before,
-            after: filtered,
-            exactMatch: before.includes(params.assetId),
-            caseInsensitiveMatch: before.some((asset) => asset.toLowerCase() === params.assetId?.toLowerCase()),
-        });
-    }
-    debugLogger?.log('HyperLiquid: applyPathFilters - final result', {
-        initialAssets: assets,
-        finalFiltered: filtered,
-        filterParams: params,
-    });
-    return filtered;
-}
-/**
- * Get supported deposit/withdrawal paths with filtering.
- *
- * @param params - Filter parameters including isTestnet, chainId, symbol
- * @param debugLogger - Optional debug logger for detailed logging
- * @returns Array of supported CAIP asset IDs
- */
-export function getSupportedPaths(params, debugLogger) {
-    const isTestnet = params?.isTestnet ?? false;
-    const assets = getSupportedAssets(isTestnet);
-    const filteredAssets = applyPathFilters(assets, params, debugLogger);
-    debugLogger?.log('HyperLiquid: getSupportedPaths', {
-        isTestnet,
-        requestedParams: params,
-        allAssets: assets,
-        filteredAssets,
-        returnType: 'CaipAssetId[]',
-        example: filteredAssets[0],
-    });
-    return filteredAssets;
-}
-/**
- * Get maximum order value based on leverage and order type.
- * Based on HyperLiquid contract specifications.
- *
- * @param maxLeverage - The maximum leverage for the market
- * @param orderType - The order type (market or limit)
- * @returns Maximum order value in USD
- */
-export function getMaxOrderValue(maxLeverage, orderType) {
-    let marketLimit;
-    if (maxLeverage >= 25) {
-        marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.HighLeverage;
-    }
-    else if (maxLeverage >= 20) {
-        marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumHighLeverage;
-    }
-    else if (maxLeverage >= 10) {
-        marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumLeverage;
-    }
-    else {
-        marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.LowLeverage;
-    }
-    return orderType === 'limit'
-        ? marketLimit * HYPERLIQUID_ORDER_LIMITS.LimitOrderMultiplier
-        : marketLimit;
-}
-/**
- * Validate order parameters.
- * Basic validation - checks required fields are present.
- * Amount validation (size/USD) is handled by validateOrder.
- *
- * @param params - Order parameters to validate
- * @param params.coin - The trading pair coin symbol
- * @param params.size - The order size as string
- * @param params.price - The order price as string
- * @param params.orderType - The order type (market or limit)
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateOrderParams(params) {
-    if (!params.coin) {
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.ORDER_COIN_REQUIRED,
-        };
-    }
-    // Note: Size validation removed - validateOrder handles amount validation using USD as source of truth
-    // Require price for limit orders
-    if (params.orderType === 'limit' && !params.price) {
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.ORDER_LIMIT_PRICE_REQUIRED,
-        };
-    }
-    if (params.price && parseFloat(params.price) <= 0) {
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.ORDER_PRICE_POSITIVE,
-        };
-    }
-    return { isValid: true };
-}
-/**
- * Validate coin exists in asset mapping.
- *
- * @param coin - The coin symbol to validate
- * @param coinToAssetId - Map of coin symbols to asset IDs
- * @returns Validation result with isValid flag and optional error message
- */
-export function validateCoinExists(coin, coinToAssetId) {
-    if (!coinToAssetId.has(coin)) {
-        return {
-            isValid: false,
-            error: PERPS_ERROR_CODES.ORDER_UNKNOWN_COIN,
-        };
-    }
-    return { isValid: true };
-}
-//# sourceMappingURL=hyperLiquidValidation.mjs.map

package/dist/utils/hyperLiquidValidation.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hyperLiquidValidation.mjs","sourceRoot":"","sources":["../../src/utils/hyperLiquidValidation.ts"],"names":[],"mappings":"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","sourcesContent":["import { isValidHexAddress } from '@metamask/utils';\nimport type { CaipAssetId } from '@metamask/utils';\n\nimport {\n  HYPERLIQUID_ASSET_CONFIGS,\n  getSupportedAssets,\n  TRADING_DEFAULTS,\n} from '../constants/hyperLiquidConfig';\nimport { HYPERLIQUID_ORDER_LIMITS } from '../constants/perpsConfig';\nimport { PERPS_ERROR_CODES } from '../constants/perpsErrorCodes';\nimport type { GetSupportedPathsParams, PerpsDebugLogger } from '../types';\n\n/**\n * Optional debug logger for validation functions.\n * When provided, enables detailed logging for debugging.\n * When omitted, validation runs silently.\n */\nexport type ValidationDebugLogger = PerpsDebugLogger | undefined;\n\n/**\n * Validation utilities for HyperLiquid operations\n */\n\n/**\n * Create standardized error response.\n *\n * @param error - The error that occurred\n * @param defaultResponse - The default response object to use as template\n * @returns The error response with success=false and error message\n */\nexport function createErrorResult<\n  Response extends { success: boolean; error?: string },\n>(error: unknown, defaultResponse: Response): Response {\n  return {\n    ...defaultResponse,\n    success: false,\n    error:\n      error instanceof Error ? error.message : PERPS_ERROR_CODES.UNKNOWN_ERROR,\n  };\n}\n\n/**\n * Validate withdrawal parameters.\n *\n * @param params - Withdrawal parameters to validate\n * @param params.assetId - The CAIP asset ID to withdraw\n * @param params.amount - Amount to withdraw as string\n * @param params.destination - Optional destination hex address\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateWithdrawalParams(\n  params: {\n    assetId?: CaipAssetId;\n    amount?: string;\n    destination?: `0x${string}`;\n  },\n  debugLogger?: ValidationDebugLogger,\n): { isValid: boolean; error?: string } {\n  debugLogger?.log('validateWithdrawalParams: Starting validation', {\n    params,\n    hasAssetId: Boolean(params.assetId),\n    hasAmount: Boolean(params.amount),\n    hasDestination: Boolean(params.destination),\n  });\n\n  // Validate required parameters\n  if (!params.assetId) {\n    debugLogger?.log('validateWithdrawalParams: Missing assetId', {\n      error: PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,\n      params,\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.WITHDRAW_ASSET_ID_REQUIRED,\n    };\n  }\n\n  // Validate amount\n  if (!params.amount) {\n    debugLogger?.log('validateWithdrawalParams: Missing amount', {\n      error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,\n      params,\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_REQUIRED,\n    };\n  }\n\n  const amount = parseFloat(params.amount);\n  if (isNaN(amount) || amount <= 0) {\n    debugLogger?.log('validateWithdrawalParams: Invalid amount', {\n      error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,\n      amount: params.amount,\n      parsedAmount: amount,\n      isNaN: isNaN(amount),\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.WITHDRAW_AMOUNT_POSITIVE,\n    };\n  }\n\n  // Validate destination address if provided\n  if (params.destination && !isValidHexAddress(params.destination)) {\n    debugLogger?.log('validateWithdrawalParams: Invalid destination address', {\n      error: PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,\n      destination: params.destination,\n      isValidHex: isValidHexAddress(params.destination),\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.WITHDRAW_INVALID_DESTINATION,\n    };\n  }\n\n  debugLogger?.log('validateWithdrawalParams: All validations passed', {\n    assetId: params.assetId,\n    amount: params.amount,\n    destination: params.destination ?? 'will use user wallet',\n  });\n\n  return { isValid: true };\n}\n\n/**\n * Validate deposit parameters.\n *\n * @param params - Deposit parameters to validate\n * @param params.assetId - The CAIP asset ID to deposit\n * @param params.amount - Amount to deposit as string\n * @param params.isTestnet - Whether this is a testnet deposit\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateDepositParams(\n  params: {\n    assetId?: CaipAssetId;\n    amount?: string;\n    isTestnet?: boolean;\n  },\n  debugLogger?: ValidationDebugLogger,\n): { isValid: boolean; error?: string } {\n  debugLogger?.log('validateDepositParams: Starting validation', {\n    params,\n    hasAssetId: Boolean(params.assetId),\n    hasAmount: Boolean(params.amount),\n    isTestnet: params.isTestnet,\n  });\n\n  // Validate required parameters\n  if (!params.assetId) {\n    debugLogger?.log('validateDepositParams: Missing assetId', {\n      error: PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,\n      params,\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.DEPOSIT_ASSET_ID_REQUIRED,\n    };\n  }\n\n  // Validate amount\n  if (!params.amount) {\n    debugLogger?.log('validateDepositParams: Missing amount', {\n      error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,\n      params,\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_REQUIRED,\n    };\n  }\n\n  const amount = parseFloat(params.amount);\n  if (isNaN(amount) || amount <= 0) {\n    debugLogger?.log('validateDepositParams: Invalid amount', {\n      error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,\n      amount: params.amount,\n      parsedAmount: amount,\n      isNaN: isNaN(amount),\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.DEPOSIT_AMOUNT_POSITIVE,\n    };\n  }\n\n  // Check minimum deposit amount\n  const minimumAmount = params.isTestnet\n    ? TRADING_DEFAULTS.amount.testnet\n    : TRADING_DEFAULTS.amount.mainnet;\n\n  debugLogger?.log('validateDepositParams: Checking minimum amount', {\n    amount,\n    minimumAmount,\n    isTestnet: params.isTestnet,\n    network: params.isTestnet ? 'testnet' : 'mainnet',\n  });\n\n  if (amount < minimumAmount) {\n    debugLogger?.log('validateDepositParams: Below minimum deposit', {\n      error: PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,\n      amount,\n      minimumAmount,\n      difference: minimumAmount - amount,\n    });\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.DEPOSIT_MINIMUM_AMOUNT,\n    };\n  }\n\n  debugLogger?.log('validateDepositParams: All validations passed', {\n    assetId: params.assetId,\n    amount: params.amount,\n    parsedAmount: amount,\n    minimumAmount,\n    isTestnet: params.isTestnet,\n  });\n\n  return { isValid: true };\n}\n\n/**\n * Validate asset support for withdrawals using AssetRoute arrays.\n *\n * @param assetId - The CAIP asset ID to validate\n * @param supportedRoutes - Array of supported asset routes\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateAssetSupport(\n  assetId: CaipAssetId,\n  supportedRoutes: { assetId: CaipAssetId }[],\n  debugLogger?: ValidationDebugLogger,\n): { isValid: boolean; error?: string } {\n  debugLogger?.log('validateAssetSupport: Checking asset support', {\n    assetId,\n    supportedRoutesCount: supportedRoutes.length,\n  });\n\n  const supportedAssetIds = supportedRoutes.map((route) => route.assetId);\n\n  // Check if asset is supported\n  const isSupported = supportedAssetIds.includes(assetId);\n\n  if (!isSupported) {\n    // Also check case-insensitive match for contract addresses\n    const isSupportedCaseInsensitive = supportedAssetIds.some(\n      (supportedId) => supportedId.toLowerCase() === assetId.toLowerCase(),\n    );\n\n    if (!isSupportedCaseInsensitive) {\n      debugLogger?.log('validateAssetSupport: Asset not supported', {\n        error: PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,\n        assetId,\n        supportedAssetIds,\n        checkedCaseInsensitive: true,\n      });\n\n      return {\n        isValid: false,\n        error: PERPS_ERROR_CODES.WITHDRAW_ASSET_NOT_SUPPORTED,\n      };\n    }\n\n    debugLogger?.log(\n      '⚠️ validateAssetSupport: Asset supported with case mismatch',\n      {\n        providedAssetId: assetId,\n        matchedAssetId: supportedAssetIds.find(\n          (id) => id.toLowerCase() === assetId.toLowerCase(),\n        ),\n      },\n    );\n  }\n\n  debugLogger?.log('validateAssetSupport: Asset is supported', {\n    assetId,\n  });\n\n  return { isValid: true };\n}\n\n/**\n * Validate balance against withdrawal amount.\n *\n * @param withdrawAmount - The amount to withdraw\n * @param availableBalance - The available balance\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateBalance(\n  withdrawAmount: number,\n  availableBalance: number,\n  debugLogger?: ValidationDebugLogger,\n): { isValid: boolean; error?: string } {\n  debugLogger?.log('validateBalance: Checking balance sufficiency', {\n    withdrawAmount,\n    availableBalance,\n    difference: availableBalance - withdrawAmount,\n  });\n\n  if (withdrawAmount > availableBalance) {\n    const shortfall = withdrawAmount - availableBalance;\n\n    debugLogger?.log('validateBalance: Insufficient balance', {\n      error: PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,\n      withdrawAmount,\n      availableBalance,\n      shortfall,\n      percentageOfAvailable: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,\n    });\n\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.WITHDRAW_INSUFFICIENT_BALANCE,\n    };\n  }\n\n  const remainingBalance = availableBalance - withdrawAmount;\n  debugLogger?.log('validateBalance: Balance is sufficient', {\n    withdrawAmount,\n    availableBalance,\n    remainingBalance,\n    percentageUsed: `${((withdrawAmount / availableBalance) * 100).toFixed(2)}%`,\n  });\n\n  return { isValid: true };\n}\n\n/**\n * Apply filters to asset paths with comprehensive logging.\n *\n * @param assets - Array of CAIP asset IDs to filter\n * @param params - Filter parameters including chainId, symbol, and assetId\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Filtered array of CAIP asset IDs\n */\nexport function applyPathFilters(\n  assets: CaipAssetId[],\n  params?: GetSupportedPathsParams,\n  debugLogger?: ValidationDebugLogger,\n): CaipAssetId[] {\n  if (!params) {\n    debugLogger?.log(\n      'HyperLiquid: applyPathFilters - no params, returning all assets',\n      { assets },\n    );\n    return assets;\n  }\n\n  let filtered = assets;\n\n  debugLogger?.log('HyperLiquid: applyPathFilters - starting filter', {\n    initialAssets: assets,\n    filterParams: params,\n  });\n\n  if (params.chainId) {\n    const before = filtered;\n    filtered = filtered.filter((asset) =>\n      asset.startsWith(params.chainId as string),\n    );\n    debugLogger?.log('HyperLiquid: applyPathFilters - chainId filter', {\n      chainId: params.chainId,\n      before,\n      after: filtered,\n    });\n  }\n\n  if (params.symbol && params.symbol in HYPERLIQUID_ASSET_CONFIGS) {\n    const config =\n      HYPERLIQUID_ASSET_CONFIGS[\n        params.symbol as keyof typeof HYPERLIQUID_ASSET_CONFIGS\n      ];\n    const isTestnet = params.isTestnet ?? false;\n    const selectedAsset = isTestnet ? config.testnet : config.mainnet;\n    const before = filtered;\n    filtered = [selectedAsset];\n    debugLogger?.log('HyperLiquid: applyPathFilters - symbol filter', {\n      symbol: params.symbol,\n      isTestnet,\n      config,\n      selectedAsset,\n      before,\n      after: filtered,\n    });\n  }\n\n  if (params.assetId) {\n    const before = filtered;\n    // Use case-insensitive comparison for asset ID matching to handle address case differences\n    filtered = filtered.filter(\n      (asset) => asset.toLowerCase() === params.assetId?.toLowerCase(),\n    );\n    debugLogger?.log('HyperLiquid: applyPathFilters - assetId filter', {\n      assetId: params.assetId,\n      before,\n      after: filtered,\n      exactMatch: before.includes(params.assetId),\n      caseInsensitiveMatch: before.some(\n        (asset) => asset.toLowerCase() === params.assetId?.toLowerCase(),\n      ),\n    });\n  }\n\n  debugLogger?.log('HyperLiquid: applyPathFilters - final result', {\n    initialAssets: assets,\n    finalFiltered: filtered,\n    filterParams: params,\n  });\n\n  return filtered;\n}\n\n/**\n * Get supported deposit/withdrawal paths with filtering.\n *\n * @param params - Filter parameters including isTestnet, chainId, symbol\n * @param debugLogger - Optional debug logger for detailed logging\n * @returns Array of supported CAIP asset IDs\n */\nexport function getSupportedPaths(\n  params?: GetSupportedPathsParams,\n  debugLogger?: ValidationDebugLogger,\n): CaipAssetId[] {\n  const isTestnet = params?.isTestnet ?? false;\n  const assets = getSupportedAssets(isTestnet);\n  const filteredAssets = applyPathFilters(assets, params, debugLogger);\n\n  debugLogger?.log('HyperLiquid: getSupportedPaths', {\n    isTestnet,\n    requestedParams: params,\n    allAssets: assets,\n    filteredAssets,\n    returnType: 'CaipAssetId[]',\n    example: filteredAssets[0],\n  });\n\n  return filteredAssets;\n}\n\n/**\n * Get maximum order value based on leverage and order type.\n * Based on HyperLiquid contract specifications.\n *\n * @param maxLeverage - The maximum leverage for the market\n * @param orderType - The order type (market or limit)\n * @returns Maximum order value in USD\n */\nexport function getMaxOrderValue(\n  maxLeverage: number,\n  orderType: 'market' | 'limit',\n): number {\n  let marketLimit: number;\n\n  if (maxLeverage >= 25) {\n    marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.HighLeverage;\n  } else if (maxLeverage >= 20) {\n    marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumHighLeverage;\n  } else if (maxLeverage >= 10) {\n    marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.MediumLeverage;\n  } else {\n    marketLimit = HYPERLIQUID_ORDER_LIMITS.MarketOrderLimits.LowLeverage;\n  }\n\n  return orderType === 'limit'\n    ? marketLimit * HYPERLIQUID_ORDER_LIMITS.LimitOrderMultiplier\n    : marketLimit;\n}\n\n/**\n * Validate order parameters.\n * Basic validation - checks required fields are present.\n * Amount validation (size/USD) is handled by validateOrder.\n *\n * @param params - Order parameters to validate\n * @param params.coin - The trading pair coin symbol\n * @param params.size - The order size as string\n * @param params.price - The order price as string\n * @param params.orderType - The order type (market or limit)\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateOrderParams(params: {\n  coin?: string;\n  size?: string;\n  price?: string;\n  orderType?: 'market' | 'limit';\n}): { isValid: boolean; error?: string } {\n  if (!params.coin) {\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.ORDER_COIN_REQUIRED,\n    };\n  }\n\n  // Note: Size validation removed - validateOrder handles amount validation using USD as source of truth\n\n  // Require price for limit orders\n  if (params.orderType === 'limit' && !params.price) {\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.ORDER_LIMIT_PRICE_REQUIRED,\n    };\n  }\n\n  if (params.price && parseFloat(params.price) <= 0) {\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.ORDER_PRICE_POSITIVE,\n    };\n  }\n\n  return { isValid: true };\n}\n\n/**\n * Validate coin exists in asset mapping.\n *\n * @param coin - The coin symbol to validate\n * @param coinToAssetId - Map of coin symbols to asset IDs\n * @returns Validation result with isValid flag and optional error message\n */\nexport function validateCoinExists(\n  coin: string,\n  coinToAssetId: Map<string, number>,\n): { isValid: boolean; error?: string } {\n  if (!coinToAssetId.has(coin)) {\n    return {\n      isValid: false,\n      error: PERPS_ERROR_CODES.ORDER_UNKNOWN_COIN,\n    };\n  }\n\n  return { isValid: true };\n}\n"]}

package/dist/utils/idUtils.cjs

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateTransactionId = exports.generateOrderId = exports.generateWithdrawalId = exports.generateDepositId = exports.generatePerpsId = void 0;
-const uuid_1 = require("uuid");
-/**
- * Generates a unique ID for Perps-related entities
- * Uses UUID v4 for consistency and uniqueness across the application
- *
- * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')
- * @returns A unique ID string
- *
- * @example
- * generatePerpsId() // "550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('deposit') // "deposit-550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('withdrawal') // "withdrawal-550e8400-e29b-41d4-a716-446655440000"
- */
-const generatePerpsId = (prefix) => {
-    const id = (0, uuid_1.v4)();
-    return prefix ? `${prefix}-${id}` : id;
-};
-exports.generatePerpsId = generatePerpsId;
-/**
- * Generates a unique ID for deposit requests
- *
- * @returns A unique deposit ID string
- */
-const generateDepositId = () => (0, exports.generatePerpsId)('deposit');
-exports.generateDepositId = generateDepositId;
-/**
- * Generates a unique ID for withdrawal requests
- *
- * @returns A unique withdrawal ID string
- */
-const generateWithdrawalId = () => (0, exports.generatePerpsId)('withdrawal');
-exports.generateWithdrawalId = generateWithdrawalId;
-/**
- * Generates a unique ID for orders
- *
- * @returns A unique order ID string
- */
-const generateOrderId = () => (0, exports.generatePerpsId)('order');
-exports.generateOrderId = generateOrderId;
-/**
- * Generates a unique ID for transactions
- *
- * @returns A unique transaction ID string
- */
-const generateTransactionId = () => (0, exports.generatePerpsId)('transaction');
-exports.generateTransactionId = generateTransactionId;
-//# sourceMappingURL=idUtils.cjs.map

package/dist/utils/idUtils.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"idUtils.cjs","sourceRoot":"","sources":["../../src/utils/idUtils.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAEpC;;;;;;;;;;;GAWG;AACI,MAAM,eAAe,GAAG,CAAC,MAAe,EAAU,EAAE;IACzD,MAAM,EAAE,GAAG,IAAA,SAAM,GAAE,CAAC;IACpB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC,CAAC;AAHW,QAAA,eAAe,mBAG1B;AAEF;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,IAAA,uBAAe,EAAC,SAAS,CAAC,CAAC;AAA7D,QAAA,iBAAiB,qBAA4C;AAE1E;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,GAAW,EAAE,CAAC,IAAA,uBAAe,EAAC,YAAY,CAAC,CAAC;AAAnE,QAAA,oBAAoB,wBAA+C;AAEhF;;;;GAIG;AACI,MAAM,eAAe,GAAG,GAAW,EAAE,CAAC,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;AAAzD,QAAA,eAAe,mBAA0C;AAEtE;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAChD,IAAA,uBAAe,EAAC,aAAa,CAAC,CAAC;AADpB,QAAA,qBAAqB,yBACD","sourcesContent":["import { v4 as uuidv4 } from 'uuid';\n\n/**\n * Generates a unique ID for Perps-related entities\n * Uses UUID v4 for consistency and uniqueness across the application\n *\n * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')\n * @returns A unique ID string\n *\n * @example\n * generatePerpsId() // \"550e8400-e29b-41d4-a716-446655440000\"\n * generatePerpsId('deposit') // \"deposit-550e8400-e29b-41d4-a716-446655440000\"\n * generatePerpsId('withdrawal') // \"withdrawal-550e8400-e29b-41d4-a716-446655440000\"\n */\nexport const generatePerpsId = (prefix?: string): string => {\n  const id = uuidv4();\n  return prefix ? `${prefix}-${id}` : id;\n};\n\n/**\n * Generates a unique ID for deposit requests\n *\n * @returns A unique deposit ID string\n */\nexport const generateDepositId = (): string => generatePerpsId('deposit');\n\n/**\n * Generates a unique ID for withdrawal requests\n *\n * @returns A unique withdrawal ID string\n */\nexport const generateWithdrawalId = (): string => generatePerpsId('withdrawal');\n\n/**\n * Generates a unique ID for orders\n *\n * @returns A unique order ID string\n */\nexport const generateOrderId = (): string => generatePerpsId('order');\n\n/**\n * Generates a unique ID for transactions\n *\n * @returns A unique transaction ID string\n */\nexport const generateTransactionId = (): string =>\n  generatePerpsId('transaction');\n"]}

package/dist/utils/idUtils.d.cts

@@ -1,38 +0,0 @@
-/**
- * Generates a unique ID for Perps-related entities
- * Uses UUID v4 for consistency and uniqueness across the application
- *
- * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')
- * @returns A unique ID string
- *
- * @example
- * generatePerpsId() // "550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('deposit') // "deposit-550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('withdrawal') // "withdrawal-550e8400-e29b-41d4-a716-446655440000"
- */
-export declare const generatePerpsId: (prefix?: string) => string;
-/**
- * Generates a unique ID for deposit requests
- *
- * @returns A unique deposit ID string
- */
-export declare const generateDepositId: () => string;
-/**
- * Generates a unique ID for withdrawal requests
- *
- * @returns A unique withdrawal ID string
- */
-export declare const generateWithdrawalId: () => string;
-/**
- * Generates a unique ID for orders
- *
- * @returns A unique order ID string
- */
-export declare const generateOrderId: () => string;
-/**
- * Generates a unique ID for transactions
- *
- * @returns A unique transaction ID string
- */
-export declare const generateTransactionId: () => string;
-//# sourceMappingURL=idUtils.d.cts.map

package/dist/utils/idUtils.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"idUtils.d.cts","sourceRoot":"","sources":["../../src/utils/idUtils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,YAAa,MAAM,KAAG,MAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAoC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAAuC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,MAAkC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,MACT,CAAC"}

package/dist/utils/idUtils.d.mts

@@ -1,38 +0,0 @@
-/**
- * Generates a unique ID for Perps-related entities
- * Uses UUID v4 for consistency and uniqueness across the application
- *
- * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')
- * @returns A unique ID string
- *
- * @example
- * generatePerpsId() // "550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('deposit') // "deposit-550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('withdrawal') // "withdrawal-550e8400-e29b-41d4-a716-446655440000"
- */
-export declare const generatePerpsId: (prefix?: string) => string;
-/**
- * Generates a unique ID for deposit requests
- *
- * @returns A unique deposit ID string
- */
-export declare const generateDepositId: () => string;
-/**
- * Generates a unique ID for withdrawal requests
- *
- * @returns A unique withdrawal ID string
- */
-export declare const generateWithdrawalId: () => string;
-/**
- * Generates a unique ID for orders
- *
- * @returns A unique order ID string
- */
-export declare const generateOrderId: () => string;
-/**
- * Generates a unique ID for transactions
- *
- * @returns A unique transaction ID string
- */
-export declare const generateTransactionId: () => string;
-//# sourceMappingURL=idUtils.d.mts.map

package/dist/utils/idUtils.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"idUtils.d.mts","sourceRoot":"","sources":["../../src/utils/idUtils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,YAAa,MAAM,KAAG,MAGjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAAoC,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAAuC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAO,MAAkC,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,MACT,CAAC"}

package/dist/utils/idUtils.mjs

@@ -1,42 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-/**
- * Generates a unique ID for Perps-related entities
- * Uses UUID v4 for consistency and uniqueness across the application
- *
- * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')
- * @returns A unique ID string
- *
- * @example
- * generatePerpsId() // "550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('deposit') // "deposit-550e8400-e29b-41d4-a716-446655440000"
- * generatePerpsId('withdrawal') // "withdrawal-550e8400-e29b-41d4-a716-446655440000"
- */
-export const generatePerpsId = (prefix) => {
-    const id = uuidv4();
-    return prefix ? `${prefix}-${id}` : id;
-};
-/**
- * Generates a unique ID for deposit requests
- *
- * @returns A unique deposit ID string
- */
-export const generateDepositId = () => generatePerpsId('deposit');
-/**
- * Generates a unique ID for withdrawal requests
- *
- * @returns A unique withdrawal ID string
- */
-export const generateWithdrawalId = () => generatePerpsId('withdrawal');
-/**
- * Generates a unique ID for orders
- *
- * @returns A unique order ID string
- */
-export const generateOrderId = () => generatePerpsId('order');
-/**
- * Generates a unique ID for transactions
- *
- * @returns A unique transaction ID string
- */
-export const generateTransactionId = () => generatePerpsId('transaction');
-//# sourceMappingURL=idUtils.mjs.map

package/dist/utils/idUtils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"idUtils.mjs","sourceRoot":"","sources":["../../src/utils/idUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,aAAa;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAe,EAAU,EAAE;IACzD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAW,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAChD,eAAe,CAAC,aAAa,CAAC,CAAC","sourcesContent":["import { v4 as uuidv4 } from 'uuid';\n\n/**\n * Generates a unique ID for Perps-related entities\n * Uses UUID v4 for consistency and uniqueness across the application\n *\n * @param prefix - Optional prefix to add to the ID (e.g., 'deposit', 'withdrawal', 'order')\n * @returns A unique ID string\n *\n * @example\n * generatePerpsId() // \"550e8400-e29b-41d4-a716-446655440000\"\n * generatePerpsId('deposit') // \"deposit-550e8400-e29b-41d4-a716-446655440000\"\n * generatePerpsId('withdrawal') // \"withdrawal-550e8400-e29b-41d4-a716-446655440000\"\n */\nexport const generatePerpsId = (prefix?: string): string => {\n  const id = uuidv4();\n  return prefix ? `${prefix}-${id}` : id;\n};\n\n/**\n * Generates a unique ID for deposit requests\n *\n * @returns A unique deposit ID string\n */\nexport const generateDepositId = (): string => generatePerpsId('deposit');\n\n/**\n * Generates a unique ID for withdrawal requests\n *\n * @returns A unique withdrawal ID string\n */\nexport const generateWithdrawalId = (): string => generatePerpsId('withdrawal');\n\n/**\n * Generates a unique ID for orders\n *\n * @returns A unique order ID string\n */\nexport const generateOrderId = (): string => generatePerpsId('order');\n\n/**\n * Generates a unique ID for transactions\n *\n * @returns A unique transaction ID string\n */\nexport const generateTransactionId = (): string =>\n  generatePerpsId('transaction');\n"]}