@basedone/core 0.2.7 → 0.3.0

package/dist/index.d.mts

@@ -1,7 +1,6 @@
-import { SpotToken, MarginTables, PerpsAssetCtx, SpotMeta, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
-import { Hex } from '@nktkas/hyperliquid/types';
-export { A as AllPerpsMeta, d as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, c as PerpsInstrument, P as PerpsMeta, a as PerpsMetaAndAssetCtxs, b as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-CgmiTuEX.mjs';
-export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantShippingSettings, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.mjs';
+import { SpotToken, MarginTables, PerpsAssetCtx, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
+export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpDex, b as PerpsInstrument, c as PerpsMeta, d as PerpsMetaAndAssetCtxs, e as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-BQzYwHDY.mjs';
+export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerNotification, CustomerNotificationsResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MarkNotificationsReadResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantBusinessType, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantReturnPolicyType, MerchantShippingSettings, MerchantSocialLinks, MerchantStatus, Message, MessageResponse, MessageStatsResponse, ORDER_STATUS_TRANSITIONS, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, canCancelOrder, formatPrice, getBackoffDelay, getNextStatuses, getStatusColor, getStatusLabel, getStatusProgress, isPickupOrder, isRetryableError, isValidAddress, isValidEmail, parseError, requiresTrackingInfo, retryWithBackoff, shouldNotifyCustomer, sleep, truncateAddress, validateStatusTransition } from './ecommerce.mjs';
 import 'axios';
 
 declare function encodeSlug(slug: string): bigint;
@@ -242,6 +241,9 @@ declare function getNextTierInfo(pupTokenAmount: number, normalizedAirDropAmount
 declare const USDC_SPOT_TOKEN: SpotToken;
 declare const TESTNET_USDC_SPOT_TOKEN: SpotToken;
 
+declare const ADMINS: string[];
+declare const ADMIN_WALLETS: string[];
+
 interface PerpsMeta {
     /** Trading universes available for perpetual trading. */
     universe: PerpsUniverse[];
@@ -270,18 +272,6 @@ interface PerpsUniverse {
     marginMode?: "strictIsolated" | "noCross";
 }
 
-interface PerpDex {
-    /** Short name of the perpetual dex. */
-    name: string;
-    /** Complete name of the perpetual dex. */
-    fullName: string;
-    /** Hex address of the dex deployer. */
-    deployer: Hex;
-    /** Hex address of the oracle updater, or null if not available. */
-    oracleUpdater: Hex | null;
-    feeRecipient: Hex | null;
-    assetToStreamingOiCap: [string, string][];
-}
 /**
  * Market information for trading operations
  */
@@ -327,23 +317,6 @@ interface TokenInfo {
     weiDecimals: number;
     tokenId: string;
 }
-/**
- * Configuration for MetadataClient
- */
-interface MetadataClientConfig {
-    /** List of HIP-3 DEX names to load metadata for */
-    hip3Dexs?: string[];
-    /** Whether to lazily initialize (fetch metadata on first use) */
-    lazyInit?: boolean;
-    /** Whether to use testnet (default: false for mainnet) */
-    isTestnet?: boolean;
-    /** Use static fallback data only, no API fetch */
-    onlyUseStaticFallback?: boolean;
-    /** Whether to use static fallback data if API fetch fails (default: true) */
-    useStaticFallback?: boolean;
-    /** Whether to enable debug logs (default: false) */
-    debug?: boolean;
-}
 /**
  * MetadataClient - Handles Hyperliquid metadata for trading operations
  *
@@ -359,132 +332,6 @@ interface MetadataClientConfig {
  * - HIP-3: 100000 + perp_dex_index * 10000 + index_in_meta
  */
 declare const ROOT_DEX = "hyperliquid";
-/**@deprecated use react sdk instead */
-declare class MetadataClient {
-    private infoClient;
-    private config;
-    private isTestnet;
-    private spotMeta;
-    private perpsMeta;
-    private perpDexs;
-    private staticMeta;
-    private hip3DexsMeta;
-    private perpsSymbolToIndex;
-    private spotTokenNameToIndex;
-    private spotPairToMarket;
-    private baseTokenToMarkets;
-    private quoteAssets;
-    private coinToMarket;
-    private hip3SymbolToMarket;
-    private dexNameToIndex;
-    private initialized;
-    private initializing;
-    constructor(config?: MetadataClientConfig);
-    /**
-     * Initialize metadata by fetching from Hyperliquid
-     */
-    initialize(): Promise<void>;
-    /**
-     * Load staticMeta.json for display overrides
-     * This is always loaded regardless of config.useStaticFallback
-     */
-    private loadStaticMetaOverrides;
-    /**
-     * Load static metadata from bundled JSON files
-     */
-    private loadStaticMetadata;
-    /**
-     * Build optimized lookup maps from raw metadata
-     * Called after metadata is loaded (from API or static files)
-     */
-    private buildLookupMaps;
-    /**
-     * Load metadata for a specific HIP-3 DEX
-     * Also builds optimized lookups for this DEX's markets
-     */
-    loadHip3Metadata(dexName: string): Promise<DexInfo>;
-    /**
-     * Build optimized lookups for HIP-3 markets of a specific DEX
-     */
-    private buildHip3MarketsForDex;
-    /**
-     * Ensure metadata is loaded (for lazy init)
-     */
-    private ensureInitialized;
-    /**
-     * Get market information by symbol
-     * Optimized: O(1) direct map lookup for most cases
-     * Lazily initialize hip-3 metadata if not already initialized
-     *
-     * @param symbol - Market symbol (e.g., "BTC", "PURR/USDC", "vntls:ABC")
-     * @param quoteAsset - Quote asset for spot markets (default: "USDC")
-     * @returns Market information or null if not found
-     */
-    getMarketBySymbolAsync(symbol: string, quoteAsset?: string): Promise<MarketInfo | null>;
-    getMarketByCoin(coin: string): MarketInfo | null;
-    /**
-     * Get perpetuals market information
-     * Optimized: O(1) map lookup instead of O(n) array search
-     */
-    getPerpsMarket(symbol: string): MarketInfo | null;
-    /**
-     * Get spot market information
-     * Optimized: O(1) map lookup instead of O(n) array searches
-     *
-     * @param baseSymbol - Base token symbol (e.g., "PURR", "UHYPE")
-     * @param quoteSymbol - Quote token symbol (default: "USDC")
-     */
-    getSpotMarket(baseSymbol: string, quoteSymbol?: string): MarketInfo | null;
-    /**
-     * Get HIP-3 market information
-     * Optimized: O(1) map lookup after DEX metadata is loaded
-     *
-     * @param symbol - HIP-3 market symbol (format: "dex:coin")
-     */
-    getHip3Market(symbol: string): Promise<MarketInfo | null>;
-    getHip3Dex(dexName: string): Promise<DexInfo | null>;
-    /**
-     * Get all available markets for a base token
-     * Optimized: O(1) map lookup instead of O(n) filter + map
-     * Useful for showing all quote asset options
-     */
-    getAllMarketsForBase(baseSymbol: string): MarketInfo[];
-    /**
-     * Get spot token information
-     * Optimized: O(1) map lookup instead of O(n) array search
-     */
-    getSpotTokenInfo(tokenSymbol: string): TokenInfo | null;
-    /**
-     * Get all available quote assets
-     * Optimized: O(1) pre-computed array instead of O(n) computation
-     */
-    getAvailableQuoteAssets(): string[];
-    /**
-     * Get raw metadata (for advanced use cases)
-     */
-    getRawMetadata(): {
-        spotMeta: SpotMeta | null;
-        perpsMeta: PerpsMeta | null;
-        perpDexs: (PerpDex | null)[];
-        hip3DexsMeta: {
-            [k: string]: DexInfo;
-        };
-        coinToMarket: {
-            [k: string]: MarketInfo;
-        };
-        hip3SymbolToMarket: {
-            [k: string]: MarketInfo;
-        };
-    };
-    /**
-     * Get network configuration
-     */
-    getNetworkInfo(): {
-        isTestnet: boolean;
-        useStaticFallback: boolean | undefined;
-        initialized: boolean;
-    };
-}
 
 declare const formatPriceAndSize: ({ px, sz, szDecimals, isSpot, }: {
     px: number;
@@ -652,4 +499,111 @@ declare function isStableQuoteToken(coin: string): boolean;
 declare function getDisplayMarketSymbol(coin: string | undefined, showCollateralTokenSymbol?: boolean, collateralTokenSymbol?: string): string | undefined;
 declare function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string): string | undefined;
 
-export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+/**
+ * User abstraction modes for controlling how spot and perps balances interact.
+ *
+ * - `disabled` (Standard): Separate perp and spot balances, separate DEX balances.
+ * - `unifiedAccount`: Single balance per asset collateralizing all cross margin positions.
+ * - `portfolioMargin`: Single portfolio unifying all eligible assets (pre-alpha).
+ * - `dexAbstraction`: Legacy mode (to be discontinued).
+ * - `default`: Server default (equivalent to standard/disabled for most users).
+ */
+type UserAbstractionMode = "unifiedAccount" | "portfolioMargin" | "disabled" | "default" | "dexAbstraction";
+/**
+ * Shorthand codes used with agent-based abstraction setting.
+ * - `i` = disabled (standard)
+ * - `u` = unifiedAccount
+ * - `p` = portfolioMargin
+ */
+type AgentAbstractionCode = "i" | "u" | "p";
+/**
+ * Settable abstraction modes (excludes read-only states like "default" and "dexAbstraction").
+ */
+type SettableAbstractionMode = "disabled" | "unifiedAccount" | "portfolioMargin";
+declare const ABSTRACTION_MODE_TO_AGENT_CODE: Record<SettableAbstractionMode, AgentAbstractionCode>;
+declare const AGENT_CODE_TO_ABSTRACTION_MODE: Record<AgentAbstractionCode, SettableAbstractionMode>;
+interface MultiverseMeta {
+    index: number;
+    collateralToken: number;
+}
+interface PerpDexAssetPosition {
+    position: {
+        leverage: {
+            type: string;
+        };
+        marginUsed: number;
+    };
+}
+interface PerpDexClearinghouseState {
+    clearinghouseState: {
+        crossMaintenanceMarginUsed: number;
+        assetPositions: PerpDexAssetPosition[];
+    };
+}
+interface SpotBalance {
+    token: number;
+    total: number;
+}
+
+declare const UserSetAbstractionTypes: {
+    "HyperliquidTransaction:UserSetAbstraction": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Query a user's current account abstraction mode.
+ */
+declare function getUserAbstraction(client: InfoClient, user: string): Promise<UserAbstractionMode>;
+/**
+ * Set account abstraction mode using the owner wallet (user-signed action).
+ *
+ * Requires EIP-712 signature from the account owner.
+ */
+declare function setUserAbstraction(client: ExchangeClient, abstraction: SettableAbstractionMode, user: string): Promise<SuccessResponse>;
+/**
+ * Set account abstraction mode using an agent wallet.
+ *
+ * Uses shorthand codes: "i" (disabled), "u" (unifiedAccount), "p" (portfolioMargin).
+ */
+declare function agentSetAbstraction(client: ExchangeClient, abstraction: SettableAbstractionMode): Promise<SuccessResponse>;
+
+/**
+ * Compute the unified account ratio for monitoring liquidation risk.
+ *
+ * The ratio represents cross maintenance margin used / available balance
+ * for the most leveraged collateral token. A higher ratio means closer
+ * to liquidation.
+ *
+ * @param multiverse - Map of DEX name to its metadata (index and collateral token)
+ * @param perpDexStates - Array of per-DEX clearinghouse states
+ * @param spotBalances - Array of spot balances per token
+ * @returns The maximum ratio across all collateral tokens (0 if no margin used)
+ */
+declare function computeUnifiedAccountRatio(multiverse: Record<string, MultiverseMeta>, perpDexStates: PerpDexClearinghouseState[], spotBalances: SpotBalance[]): number;
+
+interface PerpDexState {
+    totalVaultEquity: number;
+    perpsAtOpenInterestCap?: Array<string>;
+    leadingVaults?: Array<LeadingVault>;
+}
+interface WsWebData3 {
+    userState: {
+        abstraction: UserAbstractionMode;
+        agentAddress: string | null;
+        agentValidUntil: number | null;
+        serverTime: number;
+        cumLedger: number;
+        isVault: boolean;
+        user: string;
+        optOutOfSpotDusting?: boolean;
+        dexAbstractionEnabled?: boolean;
+    };
+    perpDexStates: Array<PerpDexState>;
+}
+interface LeadingVault {
+    address: string;
+    name: string;
+}
+
+export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import { SpotToken, MarginTables, PerpsAssetCtx, SpotMeta, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
-import { Hex } from '@nktkas/hyperliquid/types';
-export { A as AllPerpsMeta, d as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, c as PerpsInstrument, P as PerpsMeta, a as PerpsMetaAndAssetCtxs, b as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-CgmiTuEX.js';
-export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantShippingSettings, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.js';
+import { SpotToken, MarginTables, PerpsAssetCtx, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
+export { A as AllPerpsMeta, a as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, P as PerpDex, b as PerpsInstrument, c as PerpsMeta, d as PerpsMetaAndAssetCtxs, e as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-BQzYwHDY.js';
+export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, BrowsingLocation, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, CashAccountBalanceResponse, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerNotification, CustomerNotificationsResponse, CustomerSummary, DeleteBrowsingLocationResponse, DeliveryAddressResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, ExpiringGemBatch, FlashSale, FlashSaleAllowanceInfo, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GemHistoryItem, GemHistoryType, GemHistoryTypeFilter, GemSource, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetBrowsingLocationResponse, GetCouponResponse, GetExpiringGemsParams, GetExpiringGemsResponse, GetFlashSaleAllowanceParams, GetFlashSaleAllowanceResponse, GetGemBalanceResponse, GetGemHistoryParams, GetGemHistoryResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MarkNotificationsReadResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantBusinessType, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantReturnPolicyType, MerchantShippingSettings, MerchantSocialLinks, MerchantStatus, Message, MessageResponse, MessageStatsResponse, ORDER_STATUS_TRANSITIONS, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SaveBrowsingLocationRequest, SaveBrowsingLocationResponse, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, canCancelOrder, formatPrice, getBackoffDelay, getNextStatuses, getStatusColor, getStatusLabel, getStatusProgress, isPickupOrder, isRetryableError, isValidAddress, isValidEmail, parseError, requiresTrackingInfo, retryWithBackoff, shouldNotifyCustomer, sleep, truncateAddress, validateStatusTransition } from './ecommerce.js';
 import 'axios';
 
 declare function encodeSlug(slug: string): bigint;
@@ -242,6 +241,9 @@ declare function getNextTierInfo(pupTokenAmount: number, normalizedAirDropAmount
 declare const USDC_SPOT_TOKEN: SpotToken;
 declare const TESTNET_USDC_SPOT_TOKEN: SpotToken;
 
+declare const ADMINS: string[];
+declare const ADMIN_WALLETS: string[];
+
 interface PerpsMeta {
     /** Trading universes available for perpetual trading. */
     universe: PerpsUniverse[];
@@ -270,18 +272,6 @@ interface PerpsUniverse {
     marginMode?: "strictIsolated" | "noCross";
 }
 
-interface PerpDex {
-    /** Short name of the perpetual dex. */
-    name: string;
-    /** Complete name of the perpetual dex. */
-    fullName: string;
-    /** Hex address of the dex deployer. */
-    deployer: Hex;
-    /** Hex address of the oracle updater, or null if not available. */
-    oracleUpdater: Hex | null;
-    feeRecipient: Hex | null;
-    assetToStreamingOiCap: [string, string][];
-}
 /**
  * Market information for trading operations
  */
@@ -327,23 +317,6 @@ interface TokenInfo {
     weiDecimals: number;
     tokenId: string;
 }
-/**
- * Configuration for MetadataClient
- */
-interface MetadataClientConfig {
-    /** List of HIP-3 DEX names to load metadata for */
-    hip3Dexs?: string[];
-    /** Whether to lazily initialize (fetch metadata on first use) */
-    lazyInit?: boolean;
-    /** Whether to use testnet (default: false for mainnet) */
-    isTestnet?: boolean;
-    /** Use static fallback data only, no API fetch */
-    onlyUseStaticFallback?: boolean;
-    /** Whether to use static fallback data if API fetch fails (default: true) */
-    useStaticFallback?: boolean;
-    /** Whether to enable debug logs (default: false) */
-    debug?: boolean;
-}
 /**
  * MetadataClient - Handles Hyperliquid metadata for trading operations
  *
@@ -359,132 +332,6 @@ interface MetadataClientConfig {
  * - HIP-3: 100000 + perp_dex_index * 10000 + index_in_meta
  */
 declare const ROOT_DEX = "hyperliquid";
-/**@deprecated use react sdk instead */
-declare class MetadataClient {
-    private infoClient;
-    private config;
-    private isTestnet;
-    private spotMeta;
-    private perpsMeta;
-    private perpDexs;
-    private staticMeta;
-    private hip3DexsMeta;
-    private perpsSymbolToIndex;
-    private spotTokenNameToIndex;
-    private spotPairToMarket;
-    private baseTokenToMarkets;
-    private quoteAssets;
-    private coinToMarket;
-    private hip3SymbolToMarket;
-    private dexNameToIndex;
-    private initialized;
-    private initializing;
-    constructor(config?: MetadataClientConfig);
-    /**
-     * Initialize metadata by fetching from Hyperliquid
-     */
-    initialize(): Promise<void>;
-    /**
-     * Load staticMeta.json for display overrides
-     * This is always loaded regardless of config.useStaticFallback
-     */
-    private loadStaticMetaOverrides;
-    /**
-     * Load static metadata from bundled JSON files
-     */
-    private loadStaticMetadata;
-    /**
-     * Build optimized lookup maps from raw metadata
-     * Called after metadata is loaded (from API or static files)
-     */
-    private buildLookupMaps;
-    /**
-     * Load metadata for a specific HIP-3 DEX
-     * Also builds optimized lookups for this DEX's markets
-     */
-    loadHip3Metadata(dexName: string): Promise<DexInfo>;
-    /**
-     * Build optimized lookups for HIP-3 markets of a specific DEX
-     */
-    private buildHip3MarketsForDex;
-    /**
-     * Ensure metadata is loaded (for lazy init)
-     */
-    private ensureInitialized;
-    /**
-     * Get market information by symbol
-     * Optimized: O(1) direct map lookup for most cases
-     * Lazily initialize hip-3 metadata if not already initialized
-     *
-     * @param symbol - Market symbol (e.g., "BTC", "PURR/USDC", "vntls:ABC")
-     * @param quoteAsset - Quote asset for spot markets (default: "USDC")
-     * @returns Market information or null if not found
-     */
-    getMarketBySymbolAsync(symbol: string, quoteAsset?: string): Promise<MarketInfo | null>;
-    getMarketByCoin(coin: string): MarketInfo | null;
-    /**
-     * Get perpetuals market information
-     * Optimized: O(1) map lookup instead of O(n) array search
-     */
-    getPerpsMarket(symbol: string): MarketInfo | null;
-    /**
-     * Get spot market information
-     * Optimized: O(1) map lookup instead of O(n) array searches
-     *
-     * @param baseSymbol - Base token symbol (e.g., "PURR", "UHYPE")
-     * @param quoteSymbol - Quote token symbol (default: "USDC")
-     */
-    getSpotMarket(baseSymbol: string, quoteSymbol?: string): MarketInfo | null;
-    /**
-     * Get HIP-3 market information
-     * Optimized: O(1) map lookup after DEX metadata is loaded
-     *
-     * @param symbol - HIP-3 market symbol (format: "dex:coin")
-     */
-    getHip3Market(symbol: string): Promise<MarketInfo | null>;
-    getHip3Dex(dexName: string): Promise<DexInfo | null>;
-    /**
-     * Get all available markets for a base token
-     * Optimized: O(1) map lookup instead of O(n) filter + map
-     * Useful for showing all quote asset options
-     */
-    getAllMarketsForBase(baseSymbol: string): MarketInfo[];
-    /**
-     * Get spot token information
-     * Optimized: O(1) map lookup instead of O(n) array search
-     */
-    getSpotTokenInfo(tokenSymbol: string): TokenInfo | null;
-    /**
-     * Get all available quote assets
-     * Optimized: O(1) pre-computed array instead of O(n) computation
-     */
-    getAvailableQuoteAssets(): string[];
-    /**
-     * Get raw metadata (for advanced use cases)
-     */
-    getRawMetadata(): {
-        spotMeta: SpotMeta | null;
-        perpsMeta: PerpsMeta | null;
-        perpDexs: (PerpDex | null)[];
-        hip3DexsMeta: {
-            [k: string]: DexInfo;
-        };
-        coinToMarket: {
-            [k: string]: MarketInfo;
-        };
-        hip3SymbolToMarket: {
-            [k: string]: MarketInfo;
-        };
-    };
-    /**
-     * Get network configuration
-     */
-    getNetworkInfo(): {
-        isTestnet: boolean;
-        useStaticFallback: boolean | undefined;
-        initialized: boolean;
-    };
-}
 
 declare const formatPriceAndSize: ({ px, sz, szDecimals, isSpot, }: {
     px: number;
@@ -652,4 +499,111 @@ declare function isStableQuoteToken(coin: string): boolean;
 declare function getDisplayMarketSymbol(coin: string | undefined, showCollateralTokenSymbol?: boolean, collateralTokenSymbol?: string): string | undefined;
 declare function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string): string | undefined;
 
-export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+/**
+ * User abstraction modes for controlling how spot and perps balances interact.
+ *
+ * - `disabled` (Standard): Separate perp and spot balances, separate DEX balances.
+ * - `unifiedAccount`: Single balance per asset collateralizing all cross margin positions.
+ * - `portfolioMargin`: Single portfolio unifying all eligible assets (pre-alpha).
+ * - `dexAbstraction`: Legacy mode (to be discontinued).
+ * - `default`: Server default (equivalent to standard/disabled for most users).
+ */
+type UserAbstractionMode = "unifiedAccount" | "portfolioMargin" | "disabled" | "default" | "dexAbstraction";
+/**
+ * Shorthand codes used with agent-based abstraction setting.
+ * - `i` = disabled (standard)
+ * - `u` = unifiedAccount
+ * - `p` = portfolioMargin
+ */
+type AgentAbstractionCode = "i" | "u" | "p";
+/**
+ * Settable abstraction modes (excludes read-only states like "default" and "dexAbstraction").
+ */
+type SettableAbstractionMode = "disabled" | "unifiedAccount" | "portfolioMargin";
+declare const ABSTRACTION_MODE_TO_AGENT_CODE: Record<SettableAbstractionMode, AgentAbstractionCode>;
+declare const AGENT_CODE_TO_ABSTRACTION_MODE: Record<AgentAbstractionCode, SettableAbstractionMode>;
+interface MultiverseMeta {
+    index: number;
+    collateralToken: number;
+}
+interface PerpDexAssetPosition {
+    position: {
+        leverage: {
+            type: string;
+        };
+        marginUsed: number;
+    };
+}
+interface PerpDexClearinghouseState {
+    clearinghouseState: {
+        crossMaintenanceMarginUsed: number;
+        assetPositions: PerpDexAssetPosition[];
+    };
+}
+interface SpotBalance {
+    token: number;
+    total: number;
+}
+
+declare const UserSetAbstractionTypes: {
+    "HyperliquidTransaction:UserSetAbstraction": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Query a user's current account abstraction mode.
+ */
+declare function getUserAbstraction(client: InfoClient, user: string): Promise<UserAbstractionMode>;
+/**
+ * Set account abstraction mode using the owner wallet (user-signed action).
+ *
+ * Requires EIP-712 signature from the account owner.
+ */
+declare function setUserAbstraction(client: ExchangeClient, abstraction: SettableAbstractionMode, user: string): Promise<SuccessResponse>;
+/**
+ * Set account abstraction mode using an agent wallet.
+ *
+ * Uses shorthand codes: "i" (disabled), "u" (unifiedAccount), "p" (portfolioMargin).
+ */
+declare function agentSetAbstraction(client: ExchangeClient, abstraction: SettableAbstractionMode): Promise<SuccessResponse>;
+
+/**
+ * Compute the unified account ratio for monitoring liquidation risk.
+ *
+ * The ratio represents cross maintenance margin used / available balance
+ * for the most leveraged collateral token. A higher ratio means closer
+ * to liquidation.
+ *
+ * @param multiverse - Map of DEX name to its metadata (index and collateral token)
+ * @param perpDexStates - Array of per-DEX clearinghouse states
+ * @param spotBalances - Array of spot balances per token
+ * @returns The maximum ratio across all collateral tokens (0 if no margin used)
+ */
+declare function computeUnifiedAccountRatio(multiverse: Record<string, MultiverseMeta>, perpDexStates: PerpDexClearinghouseState[], spotBalances: SpotBalance[]): number;
+
+interface PerpDexState {
+    totalVaultEquity: number;
+    perpsAtOpenInterestCap?: Array<string>;
+    leadingVaults?: Array<LeadingVault>;
+}
+interface WsWebData3 {
+    userState: {
+        abstraction: UserAbstractionMode;
+        agentAddress: string | null;
+        agentValidUntil: number | null;
+        serverTime: number;
+        cumLedger: number;
+        isVault: boolean;
+        user: string;
+        optOutOfSpotDusting?: boolean;
+        dexAbstractionEnabled?: boolean;
+    };
+    perpDexStates: Array<PerpDexState>;
+}
+interface LeadingVault {
+    address: string;
+    name: string;
+}
+
+export { ABSTRACTION_MODE_TO_AGENT_CODE, ADMINS, ADMIN_WALLETS, AGENT_CODE_TO_ABSTRACTION_MODE, type AgentAbstractionCode, type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type LeadingVault, type MarketInfo, type MultiverseMeta, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDexAssetPosition, type PerpDexClearinghouseState, type PerpDexState, type PupEligibilityResult, ROOT_DEX, type SettableAbstractionMode, type SpotBalance, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, type UserAbstractionMode, UserDexAbstractionTypes, UserSetAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, type WsWebData3, XP_BOOST_PERCENTAGES, agentSetAbstraction, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, computeUnifiedAccountRatio, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getUserAbstraction, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, setUserAbstraction, stableQuoteTokens };