@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/constants/hyperLiquidConfig.cjs

@@ -0,0 +1,380 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WITHDRAWAL_PROGRESS_STAGES = exports.INITIAL_AMOUNT_UI_PROGRESS = exports.USDH_CONFIG = exports.HIP3_MARGIN_CONFIG = exports.MAINNET_HIP3_CONFIG = exports.TESTNET_HIP3_CONFIG = exports.HIP3_ASSET_MARKET_TYPES = exports.BASIS_POINTS_DIVISOR = exports.HIP3_ASSET_ID_CONFIG = exports.HYPERLIQUID_CONFIG = exports.CAIP_ASSET_NAMESPACES = exports.getSupportedAssets = exports.getBridgeInfo = exports.getCaipChainId = exports.getChainId = exports.getWebSocketEndpoint = exports.HYPERLIQUID_WITHDRAWAL_MINUTES = exports.DEPOSIT_CONFIG = exports.REFERRAL_CONFIG = exports.BUILDER_FEE_CONFIG = exports.HIP3_FEE_CONFIG = exports.FEE_RATES = exports.TRADING_DEFAULTS = exports.HYPERLIQUID_TRANSPORT_CONFIG = exports.HYPERLIQUID_BRIDGE_CONTRACTS = exports.HYPERLIQUID_ASSET_CONFIGS = exports.METAMASK_PERPS_ICONS_BASE_URL = exports.HYPERLIQUID_ASSET_ICONS_BASE_URL = exports.HYPERLIQUID_ENDPOINTS = exports.USDC_TOKEN_ICON_URL = exports.USDC_ARBITRUM_TESTNET_ADDRESS = exports.USDC_ARBITRUM_MAINNET_ADDRESS = exports.USDC_ETHEREUM_MAINNET_ADDRESS = exports.ARBITRUM_SEPOLIA_CHAIN_ID = exports.ZERO_BALANCE = exports.ZERO_ADDRESS = exports.TOKEN_DECIMALS = exports.USDC_DECIMALS = exports.USDC_NAME = exports.USDC_SYMBOL = exports.HYPERLIQUID_NETWORK_NAME = exports.HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = exports.HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = exports.HYPERLIQUID_TESTNET_CHAIN_ID = exports.HYPERLIQUID_MAINNET_CHAIN_ID = exports.ARBITRUM_TESTNET_CAIP_CHAIN_ID = exports.ARBITRUM_MAINNET_CAIP_CHAIN_ID = exports.ARBITRUM_TESTNET_CHAIN_ID = exports.ARBITRUM_MAINNET_CHAIN_ID = exports.ARBITRUM_MAINNET_CHAIN_ID_HEX = void 0;
+exports.PROGRESS_BAR_COMPLETION_DELAY_MS = void 0;
+// Network constants
+exports.ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1';
+exports.ARBITRUM_MAINNET_CHAIN_ID = '42161';
+exports.ARBITRUM_TESTNET_CHAIN_ID = '421614';
+exports.ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${exports.ARBITRUM_MAINNET_CHAIN_ID}`;
+exports.ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${exports.ARBITRUM_TESTNET_CHAIN_ID}`;
+// Hyperliquid chain constants
+exports.HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal
+exports.HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)
+exports.HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999';
+exports.HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998';
+exports.HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';
+// Token constants
+exports.USDC_SYMBOL = 'USDC';
+exports.USDC_NAME = 'USD Coin';
+exports.USDC_DECIMALS = 6;
+exports.TOKEN_DECIMALS = 18;
+exports.ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+exports.ZERO_BALANCE = '0x0';
+// Network constants
+exports.ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal
+// USDC token addresses
+exports.USDC_ETHEREUM_MAINNET_ADDRESS = '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';
+exports.USDC_ARBITRUM_MAINNET_ADDRESS = '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';
+exports.USDC_ARBITRUM_TESTNET_ADDRESS = '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';
+// USDC token icon URL using MetaMask's official Token Icons API
+// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png
+// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)
+exports.USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${exports.USDC_ETHEREUM_MAINNET_ADDRESS}.png`;
+// WebSocket endpoints
+exports.HYPERLIQUID_ENDPOINTS = {
+    mainnet: 'wss://api.hyperliquid.xyz/ws',
+    testnet: 'wss://api.hyperliquid-testnet.xyz/ws',
+};
+// Asset icons base URL (HyperLiquid CDN - fallback source)
+exports.HYPERLIQUID_ASSET_ICONS_BASE_URL = 'https://app.hyperliquid.xyz/coins/';
+// MetaMask-hosted Perps asset icons (primary source)
+// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999
+// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)
+// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)
+exports.METAMASK_PERPS_ICONS_BASE_URL = 'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';
+// Asset configurations for multichain abstraction
+exports.HYPERLIQUID_ASSET_CONFIGS = {
+    usdc: {
+        mainnet: `${exports.ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,
+        testnet: `${exports.ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,
+    },
+};
+// HyperLiquid bridge contract addresses for direct USDC deposits
+// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account
+exports.HYPERLIQUID_BRIDGE_CONTRACTS = {
+    mainnet: {
+        chainId: exports.ARBITRUM_MAINNET_CAIP_CHAIN_ID,
+        contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',
+    },
+    testnet: {
+        chainId: exports.ARBITRUM_TESTNET_CAIP_CHAIN_ID,
+        contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',
+    },
+};
+// SDK transport configuration
+exports.HYPERLIQUID_TRANSPORT_CONFIG = {
+    timeout: 10000,
+    keepAlive: { interval: 30000 },
+    reconnect: {
+        maxRetries: 5,
+        connectionTimeout: 10000,
+    },
+};
+// Trading configuration constants
+exports.TRADING_DEFAULTS = {
+    leverage: 3, // 3x default leverage
+    marginPercent: 10, // 10% fixed margin default
+    takeProfitPercent: 0.3, // 30% take profit
+    stopLossPercent: 0.1, // 10% stop loss
+    amount: {
+        mainnet: 10, // $10 minimum order size
+        testnet: 10, // $10 minimum order size
+    },
+};
+// Fee configuration
+// Note: These are base rates (Tier 0, no discounts)
+// Actual fees will be calculated based on user's volume tier and staking
+exports.FEE_RATES = {
+    taker: 0.00045, // 0.045% - Market orders and aggressive limit orders
+    maker: 0.00015, // 0.015% - Limit orders that add liquidity
+};
+/**
+ * HIP-3 dynamic fee calculation configuration
+ *
+ * HIP-3 (builder-deployed) perpetual markets have variable fees based on:
+ * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)
+ * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)
+ *
+ * Fee Formula (from HyperLiquid docs):
+ * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2
+ * - growthModeScale = growthMode ? 0.1 : 1
+ * - finalRate = baseRate * scaleIfHip3 * growthModeScale
+ *
+ * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode="enabled":
+ * - scaleIfHip3 = 1.0 * 2 = 2.0
+ * - growthModeScale = 0.1 (90% reduction)
+ * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
+ * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection
+ */
+exports.HIP3_FEE_CONFIG = {
+    /**
+     * Growth Mode multiplier - 90% fee reduction for assets in growth phase
+     * This is a protocol constant from HyperLiquid's fee formula
+     */
+    GrowthModeScale: 0.1,
+    /**
+     * Default deployerFeeScale when API is unavailable
+     * Most HIP-3 DEXs use 1.0, which results in 2x base fees
+     */
+    DefaultDeployerFeeScale: 1.0,
+    /**
+     * Cache TTL for perpDexs data (5 minutes)
+     * Fee scales rarely change, so longer cache is acceptable
+     */
+    PerpDexsCacheTtlMs: 5 * 60 * 1000,
+    /**
+     * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()
+     * Kept for backwards compatibility during migration
+     */
+    FeeMultiplier: 2,
+};
+const BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;
+// Builder fee configuration
+exports.BUILDER_FEE_CONFIG = {
+    // Test builder wallet
+    TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa',
+    // Production builder wallet
+    MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa',
+    // Fee in decimal (10 bp = 0.1%)
+    MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,
+    MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,
+    MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)
+        .toFixed(4)
+        .replace(/\.?0+$/u, '')}%`,
+};
+// Referral code configuration
+exports.REFERRAL_CONFIG = {
+    // Production referral code
+    MainnetCode: 'MMCSI',
+    // Development/testnet referral code
+    TestnetCode: 'MMCSITEST',
+};
+// Deposit constants
+exports.DEPOSIT_CONFIG = {
+    EstimatedGasLimit: 150000, // Estimated gas limit for bridge deposit
+    DefaultSlippage: 1, // 1% default slippage for bridge quotes
+    BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes
+    RefreshRate: 30000, // 30 seconds quote refresh rate
+    EstimatedTime: {
+        DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum
+        SameChainSwap: '30-60 seconds', // Swap on same chain before deposit
+    },
+};
+// Withdrawal constants (HyperLiquid-specific)
+exports.HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes
+// Configuration helpers
+function getWebSocketEndpoint(isTestnet) {
+    return isTestnet
+        ? exports.HYPERLIQUID_ENDPOINTS.testnet
+        : exports.HYPERLIQUID_ENDPOINTS.mainnet;
+}
+exports.getWebSocketEndpoint = getWebSocketEndpoint;
+function getChainId(isTestnet) {
+    return isTestnet ? exports.ARBITRUM_TESTNET_CHAIN_ID : exports.ARBITRUM_MAINNET_CHAIN_ID;
+}
+exports.getChainId = getChainId;
+function getCaipChainId(isTestnet) {
+    const network = isTestnet ? 'testnet' : 'mainnet';
+    return exports.HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;
+}
+exports.getCaipChainId = getCaipChainId;
+function getBridgeInfo(isTestnet) {
+    const network = isTestnet ? 'testnet' : 'mainnet';
+    return exports.HYPERLIQUID_BRIDGE_CONTRACTS[network];
+}
+exports.getBridgeInfo = getBridgeInfo;
+function getSupportedAssets(isTestnet) {
+    const network = isTestnet ? 'testnet' : 'mainnet';
+    return Object.values(exports.HYPERLIQUID_ASSET_CONFIGS).map((config) => config[network]);
+}
+exports.getSupportedAssets = getSupportedAssets;
+// CAIP asset namespace constants
+exports.CAIP_ASSET_NAMESPACES = {
+    Erc20: 'erc20',
+};
+/**
+ * HyperLiquid protocol-specific configuration
+ * Contains constants specific to HyperLiquid's perps exchange
+ */
+exports.HYPERLIQUID_CONFIG = {
+    // Exchange name used in predicted funding data
+    // HyperLiquid uses 'HlPerp' as their perps exchange identifier
+    ExchangeName: 'HlPerp',
+};
+/**
+ * HIP-3 multi-DEX asset ID calculation constants
+ * Per HIP-3-IMPLEMENTATION.md:
+ * - Main DEX: assetId = index (0, 1, 2, ...)
+ * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index
+ *
+ * This formula enables proper order routing across multiple DEXs:
+ * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)
+ * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999
+ * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999
+ *
+ * Supports up to 10 HIP-3 DEXs with 10000 assets each.
+ */
+exports.HIP3_ASSET_ID_CONFIG = {
+    // Base offset for HIP-3 asset IDs (100000)
+    // Ensures HIP-3 asset IDs don't conflict with main DEX indices
+    BaseAssetId: 100000,
+    // Multiplier for DEX index in asset ID calculation (10000)
+    // Allocates 10000 asset ID slots per DEX (0-9999)
+    DexMultiplier: 10000,
+};
+/**
+ * Basis points conversion constant
+ * 1 basis point (bp) = 0.01% = 0.0001 as decimal
+ * Used for fee discount calculations (e.g., 6500 bps = 65%)
+ */
+exports.BASIS_POINTS_DIVISOR = 10000;
+/**
+ * HIP-3 asset market type classifications (PRODUCTION DEFAULT)
+ *
+ * This is the production default configuration, can be overridden via feature flag
+ * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.
+ *
+ * Maps asset symbols (e.g., "xyz:TSLA") to their market type for badge display.
+ *
+ * Market type determines the badge shown in the UI:
+ * - 'equity': STOCK badge (stocks like TSLA, NVDA)
+ * - 'commodity': COMMODITY badge (commodities like GOLD)
+ * - 'forex': FOREX badge (forex pairs)
+ * - undefined: No badge for crypto or unmapped assets
+ *
+ * Format: 'dex:SYMBOL' → MarketType
+ * This allows flexible per-asset classification.
+ * Assets not listed here will have no market type (undefined).
+ */
+exports.HIP3_ASSET_MARKET_TYPES = {
+    // xyz DEX - Equities
+    'xyz:TSLA': 'equity',
+    'xyz:NVDA': 'equity',
+    'xyz:XYZ100': 'equity',
+    'xyz:INTC': 'equity',
+    'xyz:MU': 'equity',
+    'xyz:CRCL': 'equity',
+    'xyz:HOOD': 'equity',
+    'xyz:SNDK': 'equity',
+    'xyz:GOOGL': 'equity',
+    'xyz:COIN': 'equity',
+    'xyz:ORCL': 'equity',
+    'xyz:AMZN': 'equity',
+    'xyz:PLTR': 'equity',
+    'xyz:AAPL': 'equity',
+    'xyz:META': 'equity',
+    'xyz:AMD': 'equity',
+    'xyz:MSFT': 'equity',
+    'xyz:BABA': 'equity',
+    'xyz:RIVN': 'equity',
+    'xyz:NFLX': 'equity',
+    'xyz:COST': 'equity',
+    'xyz:LLY': 'equity',
+    'xyz:TSM': 'equity',
+    'xyz:SKHX': 'equity',
+    'xyz:MSTR': 'equity',
+    'xyz:CRWV': 'equity',
+    'xyz:SMSN': 'equity',
+    // xyz DEX - Commodities
+    'xyz:GOLD': 'commodity',
+    'xyz:SILVER': 'commodity',
+    'xyz:CL': 'commodity',
+    'xyz:COPPER': 'commodity',
+    'xyz:ALUMINIUM': 'commodity',
+    'xyz:URANIUM': 'commodity',
+    'xyz:USAR': 'commodity',
+    'xyz:NATGAS': 'commodity',
+    'xyz:PLATINUM': 'commodity',
+    // xyz DEX - Forex
+    'xyz:EUR': 'forex',
+    'xyz:JPY': 'forex',
+};
+/**
+ * Testnet-specific HIP-3 DEX configuration
+ *
+ * On testnet, there are many HIP-3 DEXs (test deployments from various builders).
+ * Subscribing to all of them causes connection/subscription overload and instability.
+ * This configuration limits which DEXs are discovered and subscribed to on testnet.
+ */
+exports.TESTNET_HIP3_CONFIG = {
+    /**
+     * Allowed DEX names for testnet
+     * Empty array = main DEX only (no HIP-3 DEXs)
+     * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']
+     */
+    EnabledDexs: ['xyz'],
+    /**
+     * Set to true to enable full HIP-3 discovery on testnet (not recommended)
+     * When false, only DEXs in ENABLED_DEXS are used
+     */
+    AutoDiscoverAll: false,
+};
+/**
+ * Mainnet-specific HIP-3 DEX configuration
+ *
+ * On mainnet, DEX filtering is dynamically determined from the allowlist markets
+ * feature flag. This avoids hardcoding DEX names and ensures consistency with
+ * the market filtering logic.
+ *
+ * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.
+ * When an allowlist is provided, DEXs are extracted from the allowlist patterns.
+ */
+exports.MAINNET_HIP3_CONFIG = {
+    /**
+     * Set to true to enable full HIP-3 discovery on mainnet
+     * When false, DEXs are filtered based on the allowlist markets feature flag
+     * (recommended for production to reduce subscription overhead)
+     */
+    AutoDiscoverAll: false,
+};
+/**
+ * HIP-3 margin management configuration
+ * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
+ *
+ * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * existing locked margin. This requires temporary over-funding when increasing positions,
+ * followed by automatic cleanup to minimize locked capital.
+ */
+exports.HIP3_MARGIN_CONFIG = {
+    /**
+     * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)
+     * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin
+     */
+    BufferMultiplier: 1.003,
+    /**
+     * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)
+     * Small buffer allows quick follow-up orders without transfers
+     */
+    RebalanceDesiredBuffer: 0.1,
+    /**
+     * Minimum excess threshold to trigger auto-rebalance (USDC amount)
+     * Prevents unnecessary transfers for tiny amounts
+     */
+    RebalanceMinThreshold: 0.1,
+};
+/**
+ * Configuration for USDH collateral handling on HIP-3 DEXs
+ * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically
+ *
+ * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC
+ */
+exports.USDH_CONFIG = {
+    /** Token name for USDH collateral */
+    TokenName: 'USDH',
+    /**
+     * Maximum slippage for USDC→USDH spot swap in basis points
+     * USDH is pegged 1:1 to USDC so slippage should be minimal
+     * 10 bps (0.1%) provides small buffer for spread
+     */
+    SwapSlippageBps: 10,
+};
+// Progress bar constants
+exports.INITIAL_AMOUNT_UI_PROGRESS = 10;
+exports.WITHDRAWAL_PROGRESS_STAGES = [
+    25, 35, 45, 55, 65, 75, 85, 90, 95, 98,
+];
+exports.PROGRESS_BAR_COMPLETION_DELAY_MS = 500;
+//# sourceMappingURL=hyperLiquidConfig.cjs.map

package/dist/constants/hyperLiquidConfig.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidConfig.cjs","sourceRoot":"","sources":["../../src/constants/hyperLiquidConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipAssetId, CaipChainId, Hex } from '@metamask/utils';\n\nimport type {\n  HyperLiquidNetwork,\n  HyperLiquidEndpoints,\n  HyperLiquidAssetConfigs,\n  BridgeContractConfig,\n  HyperLiquidBridgeContracts,\n  HyperLiquidTransportConfig,\n  TradingDefaultsConfig,\n  FeeRatesConfig,\n} from '../types/perps-types';\n\n// Network constants\nexport const ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1';\nexport const ARBITRUM_MAINNET_CHAIN_ID = '42161';\nexport const ARBITRUM_TESTNET_CHAIN_ID = '421614';\nexport const ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_MAINNET_CHAIN_ID}`;\nexport const ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_TESTNET_CHAIN_ID}`;\n\n// Hyperliquid chain constants\nexport const HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal\nexport const HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)\nexport const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999' as CaipChainId;\nexport const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998' as CaipChainId;\nexport const HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';\n\n// Token constants\nexport const USDC_SYMBOL = 'USDC';\nexport const USDC_NAME = 'USD Coin';\nexport const USDC_DECIMALS = 6;\nexport const TOKEN_DECIMALS = 18;\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\nexport const ZERO_BALANCE = '0x0';\n\n// Network constants\nexport const ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal\n\n// USDC token addresses\nexport const USDC_ETHEREUM_MAINNET_ADDRESS =\n  '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';\nexport const USDC_ARBITRUM_MAINNET_ADDRESS =\n  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';\nexport const USDC_ARBITRUM_TESTNET_ADDRESS =\n  '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';\n\n// USDC token icon URL using MetaMask's official Token Icons API\n// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png\n// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)\nexport const USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${USDC_ETHEREUM_MAINNET_ADDRESS}.png`;\n\n// WebSocket endpoints\nexport const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints = {\n  mainnet: 'wss://api.hyperliquid.xyz/ws',\n  testnet: 'wss://api.hyperliquid-testnet.xyz/ws',\n};\n\n// Asset icons base URL (HyperLiquid CDN - fallback source)\nexport const HYPERLIQUID_ASSET_ICONS_BASE_URL =\n  'https://app.hyperliquid.xyz/coins/';\n\n// MetaMask-hosted Perps asset icons (primary source)\n// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999\n// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)\n// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)\nexport const METAMASK_PERPS_ICONS_BASE_URL =\n  'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';\n\n// Asset configurations for multichain abstraction\nexport const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs = {\n  usdc: {\n    mainnet: `${ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,\n    testnet: `${ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,\n  },\n};\n\n// HyperLiquid bridge contract addresses for direct USDC deposits\n// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account\nexport const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts = {\n  mainnet: {\n    chainId: ARBITRUM_MAINNET_CAIP_CHAIN_ID,\n    contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',\n  },\n  testnet: {\n    chainId: ARBITRUM_TESTNET_CAIP_CHAIN_ID,\n    contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',\n  },\n};\n\n// SDK transport configuration\nexport const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig = {\n  timeout: 10_000,\n  keepAlive: { interval: 30_000 },\n  reconnect: {\n    maxRetries: 5,\n    connectionTimeout: 10_000,\n  },\n};\n\n// Trading configuration constants\nexport const TRADING_DEFAULTS: TradingDefaultsConfig = {\n  leverage: 3, // 3x default leverage\n  marginPercent: 10, // 10% fixed margin default\n  takeProfitPercent: 0.3, // 30% take profit\n  stopLossPercent: 0.1, // 10% stop loss\n  amount: {\n    mainnet: 10, // $10 minimum order size\n    testnet: 10, // $10 minimum order size\n  },\n};\n\n// Fee configuration\n// Note: These are base rates (Tier 0, no discounts)\n// Actual fees will be calculated based on user's volume tier and staking\nexport const FEE_RATES: FeeRatesConfig = {\n  taker: 0.00045, // 0.045% - Market orders and aggressive limit orders\n  maker: 0.00015, // 0.015% - Limit orders that add liquidity\n};\n\n/**\n * HIP-3 dynamic fee calculation configuration\n *\n * HIP-3 (builder-deployed) perpetual markets have variable fees based on:\n * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)\n * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)\n *\n * Fee Formula (from HyperLiquid docs):\n * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2\n * - growthModeScale = growthMode ? 0.1 : 1\n * - finalRate = baseRate * scaleIfHip3 * growthModeScale\n *\n * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode=\"enabled\":\n * - scaleIfHip3 = 1.0 * 2 = 2.0\n * - growthModeScale = 0.1 (90% reduction)\n * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)\n *\n * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers\n * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection\n */\nexport const HIP3_FEE_CONFIG = {\n  /**\n   * Growth Mode multiplier - 90% fee reduction for assets in growth phase\n   * This is a protocol constant from HyperLiquid's fee formula\n   */\n  GrowthModeScale: 0.1,\n\n  /**\n   * Default deployerFeeScale when API is unavailable\n   * Most HIP-3 DEXs use 1.0, which results in 2x base fees\n   */\n  DefaultDeployerFeeScale: 1.0,\n\n  /**\n   * Cache TTL for perpDexs data (5 minutes)\n   * Fee scales rarely change, so longer cache is acceptable\n   */\n  PerpDexsCacheTtlMs: 5 * 60 * 1000,\n\n  /**\n   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()\n   * Kept for backwards compatibility during migration\n   */\n  FeeMultiplier: 2,\n} as const;\n\nconst BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;\n\n// Builder fee configuration\nexport const BUILDER_FEE_CONFIG = {\n  // Test builder wallet\n  TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa' as Hex,\n  // Production builder wallet\n  MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa' as Hex,\n  // Fee in decimal (10 bp = 0.1%)\n  MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,\n  MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,\n  MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)\n    .toFixed(4)\n    .replace(/\\.?0+$/u, '')}%`,\n};\n\n// Referral code configuration\nexport const REFERRAL_CONFIG = {\n  // Production referral code\n  MainnetCode: 'MMCSI',\n  // Development/testnet referral code\n  TestnetCode: 'MMCSITEST',\n};\n\n// Deposit constants\nexport const DEPOSIT_CONFIG = {\n  EstimatedGasLimit: 150000, // Estimated gas limit for bridge deposit\n  DefaultSlippage: 1, // 1% default slippage for bridge quotes\n  BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes\n  RefreshRate: 30000, // 30 seconds quote refresh rate\n  EstimatedTime: {\n    DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum\n    SameChainSwap: '30-60 seconds', // Swap on same chain before deposit\n  },\n};\n\n// Withdrawal constants (HyperLiquid-specific)\nexport const HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes\n\n// Type helpers\nexport type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;\n\n// Configuration helpers\nexport function getWebSocketEndpoint(isTestnet: boolean): string {\n  return isTestnet\n    ? HYPERLIQUID_ENDPOINTS.testnet\n    : HYPERLIQUID_ENDPOINTS.mainnet;\n}\n\nexport function getChainId(isTestnet: boolean): string {\n  return isTestnet ? ARBITRUM_TESTNET_CHAIN_ID : ARBITRUM_MAINNET_CHAIN_ID;\n}\n\nexport function getCaipChainId(isTestnet: boolean): CaipChainId {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;\n}\n\nexport function getBridgeInfo(isTestnet: boolean): BridgeContractConfig {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network];\n}\n\nexport function getSupportedAssets(isTestnet?: boolean): CaipAssetId[] {\n  const network = isTestnet ? 'testnet' : 'mainnet';\n  return Object.values(HYPERLIQUID_ASSET_CONFIGS).map(\n    (config) => config[network],\n  );\n}\n\n// CAIP asset namespace constants\nexport const CAIP_ASSET_NAMESPACES = {\n  Erc20: 'erc20',\n} as const;\n\n/**\n * HyperLiquid protocol-specific configuration\n * Contains constants specific to HyperLiquid's perps exchange\n */\nexport const HYPERLIQUID_CONFIG = {\n  // Exchange name used in predicted funding data\n  // HyperLiquid uses 'HlPerp' as their perps exchange identifier\n  ExchangeName: 'HlPerp',\n} as const;\n\n/**\n * HIP-3 multi-DEX asset ID calculation constants\n * Per HIP-3-IMPLEMENTATION.md:\n * - Main DEX: assetId = index (0, 1, 2, ...)\n * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index\n *\n * This formula enables proper order routing across multiple DEXs:\n * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)\n * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999\n * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999\n *\n * Supports up to 10 HIP-3 DEXs with 10000 assets each.\n */\nexport const HIP3_ASSET_ID_CONFIG = {\n  // Base offset for HIP-3 asset IDs (100000)\n  // Ensures HIP-3 asset IDs don't conflict with main DEX indices\n  BaseAssetId: 100000,\n\n  // Multiplier for DEX index in asset ID calculation (10000)\n  // Allocates 10000 asset ID slots per DEX (0-9999)\n  DexMultiplier: 10000,\n} as const;\n\n/**\n * Basis points conversion constant\n * 1 basis point (bp) = 0.01% = 0.0001 as decimal\n * Used for fee discount calculations (e.g., 6500 bps = 65%)\n */\nexport const BASIS_POINTS_DIVISOR = 10000;\n\n/**\n * HIP-3 asset market type classifications (PRODUCTION DEFAULT)\n *\n * This is the production default configuration, can be overridden via feature flag\n * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.\n *\n * Maps asset symbols (e.g., \"xyz:TSLA\") to their market type for badge display.\n *\n * Market type determines the badge shown in the UI:\n * - 'equity': STOCK badge (stocks like TSLA, NVDA)\n * - 'commodity': COMMODITY badge (commodities like GOLD)\n * - 'forex': FOREX badge (forex pairs)\n * - undefined: No badge for crypto or unmapped assets\n *\n * Format: 'dex:SYMBOL' → MarketType\n * This allows flexible per-asset classification.\n * Assets not listed here will have no market type (undefined).\n */\nexport const HIP3_ASSET_MARKET_TYPES: Record<\n  string,\n  'equity' | 'commodity' | 'forex' | 'crypto'\n> = {\n  // xyz DEX - Equities\n  'xyz:TSLA': 'equity',\n  'xyz:NVDA': 'equity',\n  'xyz:XYZ100': 'equity',\n  'xyz:INTC': 'equity',\n  'xyz:MU': 'equity',\n  'xyz:CRCL': 'equity',\n  'xyz:HOOD': 'equity',\n  'xyz:SNDK': 'equity',\n  'xyz:GOOGL': 'equity',\n  'xyz:COIN': 'equity',\n  'xyz:ORCL': 'equity',\n  'xyz:AMZN': 'equity',\n  'xyz:PLTR': 'equity',\n  'xyz:AAPL': 'equity',\n  'xyz:META': 'equity',\n  'xyz:AMD': 'equity',\n  'xyz:MSFT': 'equity',\n  'xyz:BABA': 'equity',\n  'xyz:RIVN': 'equity',\n  'xyz:NFLX': 'equity',\n  'xyz:COST': 'equity',\n  'xyz:LLY': 'equity',\n  'xyz:TSM': 'equity',\n  'xyz:SKHX': 'equity',\n  'xyz:MSTR': 'equity',\n  'xyz:CRWV': 'equity',\n  'xyz:SMSN': 'equity',\n\n  // xyz DEX - Commodities\n  'xyz:GOLD': 'commodity',\n  'xyz:SILVER': 'commodity',\n  'xyz:CL': 'commodity',\n  'xyz:COPPER': 'commodity',\n  'xyz:ALUMINIUM': 'commodity',\n  'xyz:URANIUM': 'commodity',\n  'xyz:USAR': 'commodity',\n  'xyz:NATGAS': 'commodity',\n  'xyz:PLATINUM': 'commodity',\n\n  // xyz DEX - Forex\n  'xyz:EUR': 'forex',\n  'xyz:JPY': 'forex',\n} as const;\n\n/**\n * Testnet-specific HIP-3 DEX configuration\n *\n * On testnet, there are many HIP-3 DEXs (test deployments from various builders).\n * Subscribing to all of them causes connection/subscription overload and instability.\n * This configuration limits which DEXs are discovered and subscribed to on testnet.\n */\nexport const TESTNET_HIP3_CONFIG = {\n  /**\n   * Allowed DEX names for testnet\n   * Empty array = main DEX only (no HIP-3 DEXs)\n   * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']\n   */\n  EnabledDexs: ['xyz'] as string[],\n\n  /**\n   * Set to true to enable full HIP-3 discovery on testnet (not recommended)\n   * When false, only DEXs in ENABLED_DEXS are used\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * Mainnet-specific HIP-3 DEX configuration\n *\n * On mainnet, DEX filtering is dynamically determined from the allowlist markets\n * feature flag. This avoids hardcoding DEX names and ensures consistency with\n * the market filtering logic.\n *\n * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.\n * When an allowlist is provided, DEXs are extracted from the allowlist patterns.\n */\nexport const MAINNET_HIP3_CONFIG = {\n  /**\n   * Set to true to enable full HIP-3 discovery on mainnet\n   * When false, DEXs are filtered based on the allowlist markets feature flag\n   * (recommended for production to reduce subscription overhead)\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * HIP-3 margin management configuration\n * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin\n *\n * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating\n * existing locked margin. This requires temporary over-funding when increasing positions,\n * followed by automatic cleanup to minimize locked capital.\n */\nexport const HIP3_MARGIN_CONFIG = {\n  /**\n   * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)\n   * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin\n   */\n  BufferMultiplier: 1.003,\n\n  /**\n   * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)\n   * Small buffer allows quick follow-up orders without transfers\n   */\n  RebalanceDesiredBuffer: 0.1,\n\n  /**\n   * Minimum excess threshold to trigger auto-rebalance (USDC amount)\n   * Prevents unnecessary transfers for tiny amounts\n   */\n  RebalanceMinThreshold: 0.1,\n} as const;\n\n/**\n * Configuration for USDH collateral handling on HIP-3 DEXs\n * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically\n *\n * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC\n */\nexport const USDH_CONFIG = {\n  /** Token name for USDH collateral */\n  TokenName: 'USDH',\n\n  /**\n   * Maximum slippage for USDC→USDH spot swap in basis points\n   * USDH is pegged 1:1 to USDC so slippage should be minimal\n   * 10 bps (0.1%) provides small buffer for spread\n   */\n  SwapSlippageBps: 10,\n} as const;\n\n// Progress bar constants\nexport const INITIAL_AMOUNT_UI_PROGRESS = 10;\nexport const WITHDRAWAL_PROGRESS_STAGES = [\n  25, 35, 45, 55, 65, 75, 85, 90, 95, 98,\n];\nexport const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;\n"]}

package/dist/constants/hyperLiquidConfig.d.cts

@@ -0,0 +1,236 @@
+import type { CaipAssetId, CaipChainId } from "@metamask/utils";
+import type { HyperLiquidEndpoints, HyperLiquidAssetConfigs, BridgeContractConfig, HyperLiquidBridgeContracts, HyperLiquidTransportConfig, TradingDefaultsConfig, FeeRatesConfig } from "../types/perps-types.cjs";
+export declare const ARBITRUM_MAINNET_CHAIN_ID_HEX = "0xa4b1";
+export declare const ARBITRUM_MAINNET_CHAIN_ID = "42161";
+export declare const ARBITRUM_TESTNET_CHAIN_ID = "421614";
+export declare const ARBITRUM_MAINNET_CAIP_CHAIN_ID = "eip155:42161";
+export declare const ARBITRUM_TESTNET_CAIP_CHAIN_ID = "eip155:421614";
+export declare const HYPERLIQUID_MAINNET_CHAIN_ID = "0x3e7";
+export declare const HYPERLIQUID_TESTNET_CHAIN_ID = "0x3e6";
+export declare const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID: `${string}:${string}`;
+export declare const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID: `${string}:${string}`;
+export declare const HYPERLIQUID_NETWORK_NAME = "Hyperliquid";
+export declare const USDC_SYMBOL = "USDC";
+export declare const USDC_NAME = "USD Coin";
+export declare const USDC_DECIMALS = 6;
+export declare const TOKEN_DECIMALS = 18;
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const ZERO_BALANCE = "0x0";
+export declare const ARBITRUM_SEPOLIA_CHAIN_ID = "0x66eee";
+export declare const USDC_ETHEREUM_MAINNET_ADDRESS = "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48";
+export declare const USDC_ARBITRUM_MAINNET_ADDRESS = "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+export declare const USDC_ARBITRUM_TESTNET_ADDRESS = "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+export declare const USDC_TOKEN_ICON_URL = "https://static.cx.metamask.io/api/v1/tokenIcons/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png";
+export declare const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints;
+export declare const HYPERLIQUID_ASSET_ICONS_BASE_URL = "https://app.hyperliquid.xyz/coins/";
+export declare const METAMASK_PERPS_ICONS_BASE_URL = "https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/";
+export declare const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs;
+export declare const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts;
+export declare const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig;
+export declare const TRADING_DEFAULTS: TradingDefaultsConfig;
+export declare const FEE_RATES: FeeRatesConfig;
+/**
+ * HIP-3 dynamic fee calculation configuration
+ *
+ * HIP-3 (builder-deployed) perpetual markets have variable fees based on:
+ * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)
+ * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)
+ *
+ * Fee Formula (from HyperLiquid docs):
+ * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2
+ * - growthModeScale = growthMode ? 0.1 : 1
+ * - finalRate = baseRate * scaleIfHip3 * growthModeScale
+ *
+ * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode="enabled":
+ * - scaleIfHip3 = 1.0 * 2 = 2.0
+ * - growthModeScale = 0.1 (90% reduction)
+ * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
+ * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection
+ */
+export declare const HIP3_FEE_CONFIG: {
+    /**
+     * Growth Mode multiplier - 90% fee reduction for assets in growth phase
+     * This is a protocol constant from HyperLiquid's fee formula
+     */
+    readonly GrowthModeScale: 0.1;
+    /**
+     * Default deployerFeeScale when API is unavailable
+     * Most HIP-3 DEXs use 1.0, which results in 2x base fees
+     */
+    readonly DefaultDeployerFeeScale: 1;
+    /**
+     * Cache TTL for perpDexs data (5 minutes)
+     * Fee scales rarely change, so longer cache is acceptable
+     */
+    readonly PerpDexsCacheTtlMs: number;
+    /**
+     * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()
+     * Kept for backwards compatibility during migration
+     */
+    readonly FeeMultiplier: 2;
+};
+export declare const BUILDER_FEE_CONFIG: {
+    TestnetBuilder: `0x${string}`;
+    MainnetBuilder: `0x${string}`;
+    MaxFeeDecimal: number;
+    MaxFeeTenthsBps: number;
+    MaxFeeRate: string;
+};
+export declare const REFERRAL_CONFIG: {
+    MainnetCode: string;
+    TestnetCode: string;
+};
+export declare const DEPOSIT_CONFIG: {
+    EstimatedGasLimit: number;
+    DefaultSlippage: number;
+    BridgeQuoteTimeout: number;
+    RefreshRate: number;
+    EstimatedTime: {
+        DirectDeposit: string;
+        SameChainSwap: string;
+    };
+};
+export declare const HYPERLIQUID_WITHDRAWAL_MINUTES = 5;
+export type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;
+export declare function getWebSocketEndpoint(isTestnet: boolean): string;
+export declare function getChainId(isTestnet: boolean): string;
+export declare function getCaipChainId(isTestnet: boolean): CaipChainId;
+export declare function getBridgeInfo(isTestnet: boolean): BridgeContractConfig;
+export declare function getSupportedAssets(isTestnet?: boolean): CaipAssetId[];
+export declare const CAIP_ASSET_NAMESPACES: {
+    readonly Erc20: "erc20";
+};
+/**
+ * HyperLiquid protocol-specific configuration
+ * Contains constants specific to HyperLiquid's perps exchange
+ */
+export declare const HYPERLIQUID_CONFIG: {
+    readonly ExchangeName: "HlPerp";
+};
+/**
+ * HIP-3 multi-DEX asset ID calculation constants
+ * Per HIP-3-IMPLEMENTATION.md:
+ * - Main DEX: assetId = index (0, 1, 2, ...)
+ * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index
+ *
+ * This formula enables proper order routing across multiple DEXs:
+ * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)
+ * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999
+ * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999
+ *
+ * Supports up to 10 HIP-3 DEXs with 10000 assets each.
+ */
+export declare const HIP3_ASSET_ID_CONFIG: {
+    readonly BaseAssetId: 100000;
+    readonly DexMultiplier: 10000;
+};
+/**
+ * Basis points conversion constant
+ * 1 basis point (bp) = 0.01% = 0.0001 as decimal
+ * Used for fee discount calculations (e.g., 6500 bps = 65%)
+ */
+export declare const BASIS_POINTS_DIVISOR = 10000;
+/**
+ * HIP-3 asset market type classifications (PRODUCTION DEFAULT)
+ *
+ * This is the production default configuration, can be overridden via feature flag
+ * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.
+ *
+ * Maps asset symbols (e.g., "xyz:TSLA") to their market type for badge display.
+ *
+ * Market type determines the badge shown in the UI:
+ * - 'equity': STOCK badge (stocks like TSLA, NVDA)
+ * - 'commodity': COMMODITY badge (commodities like GOLD)
+ * - 'forex': FOREX badge (forex pairs)
+ * - undefined: No badge for crypto or unmapped assets
+ *
+ * Format: 'dex:SYMBOL' → MarketType
+ * This allows flexible per-asset classification.
+ * Assets not listed here will have no market type (undefined).
+ */
+export declare const HIP3_ASSET_MARKET_TYPES: Record<string, 'equity' | 'commodity' | 'forex' | 'crypto'>;
+/**
+ * Testnet-specific HIP-3 DEX configuration
+ *
+ * On testnet, there are many HIP-3 DEXs (test deployments from various builders).
+ * Subscribing to all of them causes connection/subscription overload and instability.
+ * This configuration limits which DEXs are discovered and subscribed to on testnet.
+ */
+export declare const TESTNET_HIP3_CONFIG: {
+    /**
+     * Allowed DEX names for testnet
+     * Empty array = main DEX only (no HIP-3 DEXs)
+     * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']
+     */
+    readonly EnabledDexs: string[];
+    /**
+     * Set to true to enable full HIP-3 discovery on testnet (not recommended)
+     * When false, only DEXs in ENABLED_DEXS are used
+     */
+    readonly AutoDiscoverAll: false;
+};
+/**
+ * Mainnet-specific HIP-3 DEX configuration
+ *
+ * On mainnet, DEX filtering is dynamically determined from the allowlist markets
+ * feature flag. This avoids hardcoding DEX names and ensures consistency with
+ * the market filtering logic.
+ *
+ * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.
+ * When an allowlist is provided, DEXs are extracted from the allowlist patterns.
+ */
+export declare const MAINNET_HIP3_CONFIG: {
+    /**
+     * Set to true to enable full HIP-3 discovery on mainnet
+     * When false, DEXs are filtered based on the allowlist markets feature flag
+     * (recommended for production to reduce subscription overhead)
+     */
+    readonly AutoDiscoverAll: false;
+};
+/**
+ * HIP-3 margin management configuration
+ * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
+ *
+ * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * existing locked margin. This requires temporary over-funding when increasing positions,
+ * followed by automatic cleanup to minimize locked capital.
+ */
+export declare const HIP3_MARGIN_CONFIG: {
+    /**
+     * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)
+     * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin
+     */
+    readonly BufferMultiplier: 1.003;
+    /**
+     * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)
+     * Small buffer allows quick follow-up orders without transfers
+     */
+    readonly RebalanceDesiredBuffer: 0.1;
+    /**
+     * Minimum excess threshold to trigger auto-rebalance (USDC amount)
+     * Prevents unnecessary transfers for tiny amounts
+     */
+    readonly RebalanceMinThreshold: 0.1;
+};
+/**
+ * Configuration for USDH collateral handling on HIP-3 DEXs
+ * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically
+ *
+ * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC
+ */
+export declare const USDH_CONFIG: {
+    /** Token name for USDH collateral */
+    readonly TokenName: "USDH";
+    /**
+     * Maximum slippage for USDC→USDH spot swap in basis points
+     * USDH is pegged 1:1 to USDC so slippage should be minimal
+     * 10 bps (0.1%) provides small buffer for spread
+     */
+    readonly SwapSlippageBps: 10;
+};
+export declare const INITIAL_AMOUNT_UI_PROGRESS = 10;
+export declare const WITHDRAWAL_PROGRESS_STAGES: number[];
+export declare const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;
+//# sourceMappingURL=hyperLiquidConfig.d.cts.map