@pear-protocol/hyperliquid-sdk 0.1.0 → 0.1.3

package/dist/store/hyperliquidDataStore.d.ts

@@ -1,5 +1,5 @@
-import { ActiveAssetData, CandleChartData, CandleData, ClearinghouseState, TokenMetadata, UniverseAsset, WebData3AssetCtx, WsAllMidsData } from '../types';
-type TokenMetadataBySymbol = Record<string, TokenMetadata | null>;
+import { ActiveAssetData, CandleChartData, CandleData, ClearinghouseState, UniverseAsset, WebData3AssetCtx, WsAllMidsData, PerpDexsResponse } from '../types';
+import { TokenMetadataBySymbol } from '../utils/token-metadata-extractor';
 interface HyperliquidDataState {
     allMids: WsAllMidsData | null;
     activeAssetData: Record<string, ActiveAssetData> | null;
@@ -10,6 +10,9 @@ interface HyperliquidDataState {
     rawClearinghouseStates: [string, ClearinghouseState][] | null;
     perpMetaAssets: UniverseAsset[] | null;
     tokenMetadata: TokenMetadataBySymbol;
+    perpDexs: PerpDexsResponse | null;
+    perpMetasByDex: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex: Map<string, WebData3AssetCtx[]> | null;
     setAllMids: (value: WsAllMidsData | null) => void;
     setActiveAssetData: (value: Record<string, ActiveAssetData> | null | ((prev: Record<string, ActiveAssetData> | null) => Record<string, ActiveAssetData> | null)) => void;
     deleteActiveAssetData: (key: string) => void;
@@ -22,6 +25,9 @@ interface HyperliquidDataState {
     setAggregatedClearingHouseState: (value: ClearinghouseState | null) => void;
     setRawClearinghouseStates: (value: [string, ClearinghouseState][] | null) => void;
     setPerpMetaAssets: (value: UniverseAsset[] | null) => void;
+    setPerpDexs: (value: PerpDexsResponse | null) => void;
+    setPerpMetasByDex: (value: Map<string, UniverseAsset[]> | null) => void;
+    setAssetContextsByDex: (value: Map<string, WebData3AssetCtx[]> | null) => void;
 }
 export declare const useHyperliquidData: import("zustand").UseBoundStore<import("zustand").StoreApi<HyperliquidDataState>>;
 export {};

package/dist/store/tokenSelectionMetadataStore.d.ts

@@ -1,4 +1,4 @@
-import type { TokenSelection, TokenMetadata, ActiveAssetsResponse, UniverseAsset } from "../types";
+import type { TokenSelection, TokenMetadata, ActiveAssetsResponse } from "../types";
 export interface TokenSelectionMetadataState {
     isPriceDataReady: boolean;
     isLoading: boolean;
@@ -12,10 +12,9 @@ export interface TokenSelectionMetadataState {
     volume: string;
     sumNetFunding: number;
     maxLeverage: number;
-    minMargin: number;
+    minSize: Record<string, number>;
     leverageMatched: boolean;
     recompute: (args: {
-        perpMetaAssets: UniverseAsset[] | null;
         tokenMetadata: Record<string, TokenMetadata | null>;
         marketData: ActiveAssetsResponse | null;
         longTokens: TokenSelection[];

package/dist/types.d.ts

@@ -628,8 +628,10 @@ export interface AssetCtx {
  * Collateral token type
  * 0 = USDC
  * 360 = USDH
+ * 235 = USDE
+ * 268 = USDT0
  */
-export type CollateralToken = 'USDC' | 'USDH';
+export type CollateralToken = 'USDC' | 'USDH' | 'USDE' | 'USDT0';
 /**
  * Universe asset metadata
  */
@@ -804,6 +806,7 @@ export interface AssetMarketData {
 export interface PairAssetDto {
     asset: string;
     weight: number;
+    metadata?: TokenMetadata | null;
 }
 export interface ActiveAssetGroupItem {
     longAssets: PairAssetDto[];
@@ -817,7 +820,6 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
-    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -884,3 +886,64 @@ export interface TokenEntry {
     symbol: string;
     data: AssetMarketData;
 }
+export interface PerpDex {
+    name: string;
+    fullName: string;
+    deployer: string;
+    oracleUpdater: string | null;
+    feeRecipient: string | null;
+    deployerFeeScale: string;
+    assetToStreamingOiCap: [string, string][];
+    assetToFundingMultiplier: [string, string][];
+    subDeployers: [string, string[]][];
+    lastDeployerFeeScaleChangeTime: string;
+}
+export type PerpDexsResponse = (PerpDex | null)[];
+export interface SpotBalances {
+    [coin: string]: number;
+}
+export interface AvailableToTrades {
+    [collateralCoin: string]: number;
+}
+export type ExecutionType = "MARKET" | "TRIGGER" | "TWAP" | "LADDER" | "TP" | "SL" | "SPOT_MARKET" | "SPOT_LIMIT" | "SPOT_TWAP";
+export type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE" | "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO";
+export interface PairAssetInput {
+    asset: string;
+    weight?: number;
+}
+export interface TpSlThresholdInput {
+    type: TpSlThresholdType;
+    value?: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+}
+export interface LadderConfigInput {
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+}
+export interface CreatePositionRequestInput {
+    slippage: number;
+    executionType: ExecutionType;
+    leverage: number;
+    usdValue: number;
+    longAssets?: PairAssetInput[];
+    shortAssets?: PairAssetInput[];
+    triggerValue?: string | number;
+    triggerType?: TriggerType;
+    direction?: "MORE_THAN" | "LESS_THAN";
+    assetName?: string;
+    marketCode?: string;
+    twapDuration?: number;
+    twapIntervalSeconds?: number;
+    randomizeExecution?: boolean;
+    referralCode?: string;
+    ladderConfig?: LadderConfigInput;
+    takeProfit?: TpSlThresholdInput | null;
+    stopLoss?: TpSlThresholdInput | null;
+}
+export interface CreatePositionResponseDto {
+    orderId: string;
+    fills?: ExternalFillDto[];
+}

package/dist/utils/position-validator.d.ts

@@ -1,4 +1,4 @@
-import type { PairAssetInput } from "../clients/positions";
+import { PairAssetInput } from "../types";
 /**
  * Minimum USD value required per asset when creating a position
  */

package/dist/utils/token-metadata-extractor.d.ts

@@ -3,26 +3,6 @@ import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebD
  * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 export declare class TokenMetadataExtractor {
-    /**
-     * Extracts comprehensive token metadata
-     * @param symbol - Token symbol (e.g., "BTC", "TSLA")
-     * @param perpMetaAssets - Aggregated universe assets (flattened across dexes)
-     * @param finalAssetContexts - Aggregated asset contexts (flattened across dexes)
-     * @param allMids - AllMids data containing current prices
-     * @param activeAssetData - Optional active asset data containing leverage information
-     * @returns TokenMetadata or null if token not found
-     */
-    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null, finalAtOICaps?: string[] | null): TokenMetadata | null;
-    /**
-     * Extracts metadata for multiple tokens
-     * @param tokens - Array of token strings (e.g., "BTC", "TSLA")
-     * @param perpMetaAssets - Aggregated universe assets
-     * @param finalAssetContexts - Aggregated asset contexts
-     * @param allMids - AllMids data
-     * @param activeAssetData - Optional active asset data containing leverage information
-     * @returns Record of token string to TokenMetadata (keys match input tokens exactly)
-     */
-    static extractMultipleTokensMetadata(tokens: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null, finalAtOICaps?: string[] | null): Record<string, TokenMetadata | null>;
     /**
      * Checks if token data is available in aggregated universe assets
      * @param symbol - Token symbol
@@ -30,4 +10,39 @@ export declare class TokenMetadataExtractor {
      * @returns boolean indicating if token exists in universe
      */
     static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
+    /**
+     * Extracts token metadata using DEX-aware lookup (correctly matches perpMetas to assetContexts)
+     * @param symbol - Token symbol (e.g., "BTC", "TSLA")
+     * @param perpMetasByDex - Map of DEX name to UniverseAsset[]
+     * @param assetContextsByDex - Map of DEX name to WebData3AssetCtx[]
+     * @param allMids - AllMids data containing current prices
+     * @param activeAssetData - Optional active asset data containing leverage information
+     * @param finalAtOICaps - Optional array of symbols at OI caps
+     * @returns TokenMetadata or null if token not found
+     */
+    static extractTokenMetadataByDex(symbol: string, perpMetasByDex: Map<string, UniverseAsset[]>, assetContextsByDex: Map<string, WebData3AssetCtx[]>, allMids: WsAllMidsData, activeAssetData?: Record<string, ActiveAssetData> | null, finalAtOICaps?: string[] | null): TokenMetadata | null;
 }
+export type TokenMetadataBySymbol = Record<string, TokenMetadata | null>;
+export type TokenMetadataInputs = {
+    perpMetaAssets: UniverseAsset[] | null;
+    finalAssetContexts: WebData3AssetCtx[] | null;
+    allMids: WsAllMidsData | null;
+    activeAssetData: Record<string, ActiveAssetData> | null;
+    finalAtOICaps: string[] | null;
+    perpMetasByDex?: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex?: Map<string, WebData3AssetCtx[]> | null;
+};
+export type RefreshTokenMetadataOptions = {
+    symbols?: string[];
+    oiCapsOnly?: boolean;
+};
+export declare const refreshTokenMetadata: (state: {
+    perpMetaAssets: UniverseAsset[] | null;
+    finalAssetContexts: WebData3AssetCtx[] | null;
+    allMids: WsAllMidsData | null;
+    activeAssetData: Record<string, ActiveAssetData> | null;
+    finalAtOICaps: string[] | null;
+    tokenMetadata: TokenMetadataBySymbol;
+    perpMetasByDex?: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex?: Map<string, WebData3AssetCtx[]> | null;
+}, overrides: Partial<TokenMetadataInputs>, options?: RefreshTokenMetadataOptions) => TokenMetadataBySymbol;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",