@metamask-previews/perps-controller 0.0.0-preview-ce3ee897a → 0.0.0-preview-e4aa1532

package/dist/constants/hyperLiquidConfig.d.cts

@@ -0,0 +1,276 @@
+import type { CaipAssetId, CaipChainId, Hex } from "@metamask/utils";
+export type HyperLiquidEndpoints = {
+    mainnet: string;
+    testnet: string;
+};
+export type AssetNetworkConfig = {
+    mainnet: CaipAssetId;
+    testnet: CaipAssetId;
+};
+export type HyperLiquidAssetConfigs = {
+    usdc: AssetNetworkConfig;
+};
+export type BridgeContractConfig = {
+    chainId: CaipChainId;
+    contractAddress: Hex;
+};
+export type HyperLiquidBridgeContracts = {
+    mainnet: BridgeContractConfig;
+    testnet: BridgeContractConfig;
+};
+export type TransportReconnectConfig = {
+    maxRetries: number;
+    connectionTimeout: number;
+};
+export type TransportKeepAliveConfig = {
+    interval: number;
+};
+export type HyperLiquidTransportConfig = {
+    timeout: number;
+    keepAlive: TransportKeepAliveConfig;
+    reconnect: TransportReconnectConfig;
+};
+export type TradingAmountConfig = {
+    mainnet: number;
+    testnet: number;
+};
+export type TradingDefaultsConfig = {
+    leverage: number;
+    marginPercent: number;
+    takeProfitPercent: number;
+    stopLossPercent: number;
+    amount: TradingAmountConfig;
+};
+export type FeeRatesConfig = {
+    taker: number;
+    maker: number;
+};
+export type HyperLiquidNetwork = 'mainnet' | 'testnet';
+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 METAMASK_DEPOSIT_FEE = "$0.00";
+export declare const HYPERLIQUID_WITHDRAWAL_FEE = 1;
+export declare const METAMASK_WITHDRAWAL_FEE = 0;
+export declare const METAMASK_WITHDRAWAL_FEE_PLACEHOLDER = "$0.00";
+export declare const WITHDRAWAL_ESTIMATED_TIME = "5 minutes";
+export declare const ORDER_BOOK_SPREAD: {
+    DefaultBidMultiplier: number;
+    DefaultAskMultiplier: number;
+};
+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 declare const HYPERLIQUID_WITHDRAWAL_PROGRESS_INTERVAL_MS = 30000;
+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.
+ *
+ * On mainnet, full DEX discovery continues unchanged.
+ */
+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;
+};
+/**
+ * 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

package/dist/constants/hyperLiquidConfig.d.cts.map

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

package/dist/constants/hyperLiquidConfig.d.mts

@@ -0,0 +1,276 @@
+import type { CaipAssetId, CaipChainId, Hex } from "@metamask/utils";
+export type HyperLiquidEndpoints = {
+    mainnet: string;
+    testnet: string;
+};
+export type AssetNetworkConfig = {
+    mainnet: CaipAssetId;
+    testnet: CaipAssetId;
+};
+export type HyperLiquidAssetConfigs = {
+    usdc: AssetNetworkConfig;
+};
+export type BridgeContractConfig = {
+    chainId: CaipChainId;
+    contractAddress: Hex;
+};
+export type HyperLiquidBridgeContracts = {
+    mainnet: BridgeContractConfig;
+    testnet: BridgeContractConfig;
+};
+export type TransportReconnectConfig = {
+    maxRetries: number;
+    connectionTimeout: number;
+};
+export type TransportKeepAliveConfig = {
+    interval: number;
+};
+export type HyperLiquidTransportConfig = {
+    timeout: number;
+    keepAlive: TransportKeepAliveConfig;
+    reconnect: TransportReconnectConfig;
+};
+export type TradingAmountConfig = {
+    mainnet: number;
+    testnet: number;
+};
+export type TradingDefaultsConfig = {
+    leverage: number;
+    marginPercent: number;
+    takeProfitPercent: number;
+    stopLossPercent: number;
+    amount: TradingAmountConfig;
+};
+export type FeeRatesConfig = {
+    taker: number;
+    maker: number;
+};
+export type HyperLiquidNetwork = 'mainnet' | 'testnet';
+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 METAMASK_DEPOSIT_FEE = "$0.00";
+export declare const HYPERLIQUID_WITHDRAWAL_FEE = 1;
+export declare const METAMASK_WITHDRAWAL_FEE = 0;
+export declare const METAMASK_WITHDRAWAL_FEE_PLACEHOLDER = "$0.00";
+export declare const WITHDRAWAL_ESTIMATED_TIME = "5 minutes";
+export declare const ORDER_BOOK_SPREAD: {
+    DefaultBidMultiplier: number;
+    DefaultAskMultiplier: number;
+};
+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 declare const HYPERLIQUID_WITHDRAWAL_PROGRESS_INTERVAL_MS = 30000;
+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.
+ *
+ * On mainnet, full DEX discovery continues unchanged.
+ */
+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;
+};
+/**
+ * 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.mts.map

package/dist/constants/hyperLiquidConfig.d.mts.map

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