@pear-protocol/hyperliquid-sdk 0.1.0 → 0.1.1-9.2-pnl

package/dist/provider.d.ts

@@ -1,4 +1,4 @@
-import React, { ReactNode } from 'react';
+import React, { ReactNode } from "react";
 export interface PearHyperliquidContextType {
     clientId: string;
     apiBaseUrl: string;

package/dist/store/historicalPriceDataStore.d.ts

@@ -9,6 +9,8 @@ interface TokenHistoricalPriceData {
     candles: CandleData[];
     oldestTime: number | null;
     latestTime: number | null;
+    requestedRanges: HistoricalRange[];
+    noDataBefore: number | null;
 }
 interface HistoricalPriceDataState {
     historicalPriceData: Record<string, TokenHistoricalPriceData>;
@@ -16,6 +18,7 @@ interface HistoricalPriceDataState {
     addHistoricalPriceData: (symbol: string, interval: CandleInterval, candles: CandleData[], range: HistoricalRange) => void;
     hasHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => boolean;
     getHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => CandleData[];
+    getEffectiveDataBoundary: (symbols: string[], interval: CandleInterval) => number | null;
     setTokenLoading: (symbol: string, loading: boolean) => void;
     isTokenLoading: (symbol: string) => boolean;
     removeTokenPriceData: (symbol: string, interval: CandleInterval) => void;

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,10 @@ 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;
+    clearUserData: () => 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/store/userDataStore.d.ts

@@ -1,8 +1,9 @@
-import { PlatformAccountSummaryResponseDto, OpenLimitOrderDto, RawPositionDto, TradeHistoryDataDto, TwapMonitoringDto, NotificationDto, ExtraAgent, SpotState } from "../types";
+import { PlatformAccountSummaryResponseDto, OpenLimitOrderDto, RawPositionDto, TradeHistoryDataDto, TwapMonitoringDto, NotificationDto, ExtraAgent, SpotState, UserAbstraction } from "../types";
 interface UserDataState {
     accessToken: string | null;
     refreshToken: string | null;
     isAuthenticated: boolean;
+    isReady: boolean;
     address: string | null;
     tradeHistories: TradeHistoryDataDto[] | null;
     rawOpenPositions: RawPositionDto[] | null;
@@ -12,6 +13,7 @@ interface UserDataState {
     notifications: NotificationDto[] | null;
     userExtraAgents: ExtraAgent[] | null;
     spotState: SpotState | null;
+    userAbstractionMode: UserAbstraction | null;
     setAccessToken: (token: string | null) => void;
     setRefreshToken: (token: string | null) => void;
     setIsAuthenticated: (value: boolean) => void;
@@ -24,6 +26,8 @@ interface UserDataState {
     setTwapDetails: (value: TwapMonitoringDto[] | null) => void;
     setNotifications: (value: NotificationDto[] | null) => void;
     setSpotState: (value: SpotState | null) => void;
+    setUserAbstractionMode: (value: UserAbstraction | null) => void;
+    setIsReady: (value: boolean) => void;
     clean: () => void;
 }
 export declare const useUserData: import("zustand").UseBoundStore<import("zustand").StoreApi<UserDataState>>;

package/dist/types.d.ts

@@ -200,6 +200,7 @@ export interface TwapMonitoringDto {
 export interface TradeHistoryAssetDataDto {
     coin: string;
     entryWeight: number;
+    closeWeight: number;
     entryPrice: number;
     limitPrice: number;
     leverage: number;
@@ -255,7 +256,9 @@ export interface PositionAssetDetailDto {
     unrealizedPnl: number;
     liquidationPrice: number;
     initialWeight: number;
+    currentWeight: number;
     fundingPaid?: number;
+    targetWeight?: number;
     metadata?: TokenMetadata | null;
 }
 export interface TpSlThreshold {
@@ -563,6 +566,7 @@ export interface HLChannelDataMap {
     allDexsAssetCtxs: AllDexsAssetCtxsData;
     userFills: any;
 }
+export type UserAbstraction = 'dexAbstraction' | 'disabled' | 'unifiedAccount' | 'portfolioMargin';
 export interface WebData3UserState {
     agentAddress?: string;
     agentValidUntil?: number;
@@ -571,6 +575,7 @@ export interface WebData3UserState {
     isVault: boolean;
     user: string;
     dexAbstractionEnabled?: boolean;
+    abstraction: UserAbstraction;
 }
 export interface WebData3AssetCtx {
     funding: string;
@@ -628,8 +633,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
  */
@@ -729,6 +736,7 @@ export interface RawAssetDto {
     side: string;
     fundingPaid?: number;
     leverage: number;
+    targetWeight?: number;
 }
 /**
  * Raw position data from open-positions channel
@@ -804,6 +812,7 @@ export interface AssetMarketData {
 export interface PairAssetDto {
     asset: string;
     weight: number;
+    metadata?: TokenMetadata | null;
 }
 export interface ActiveAssetGroupItem {
     longAssets: PairAssetDto[];
@@ -817,7 +826,6 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
-    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -884,3 +892,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/http.d.ts

@@ -1,5 +1,5 @@
-import type { AxiosInstance } from 'axios';
-import { ApiErrorResponse } from '../types';
+import type { AxiosInstance } from "axios";
+import { ApiErrorResponse } from "../types";
 export declare function toApiError(error: unknown): ApiErrorResponse;
 export declare function joinUrl(baseUrl: string, path: string): string;
 /**

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.19.2-pnl",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",