@pear-protocol/hyperliquid-sdk 0.0.74 → 0.0.76

package/dist/types.d.ts

@@ -97,7 +97,52 @@ export interface WatchlistItemDto {
 export interface ToggleWatchlistResponseDto {
     items: WatchlistItemDto[];
 }
-export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED' | 'TRIGGER_ORDER_FILLED' | 'TRIGGER_ORDER_FAILED';
+export type TriggerOrderNotificationType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME' | 'BTC_DOM';
+export interface TriggerOrderNotificationAsset {
+    asset: string;
+    side: 'LONG' | 'SHORT';
+    weight: number;
+}
+export interface BaseTriggerOrderNotificationParams {
+    order_id: string;
+    client_id: string;
+    order_type: 'TRIGGER';
+    trigger_type: TriggerOrderNotificationType;
+    usd_value: number;
+    leverage: number;
+    assets: TriggerOrderNotificationAsset[];
+    error?: string;
+}
+export interface PriceTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PRICE';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+}
+export interface PriceRatioTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+}
+export interface CrossAssetPriceTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'CROSS_ASSET_PRICE';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+    asset_name: string;
+}
+export interface PredictionMarketOutcomeTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'PREDICTION_MARKET_OUTCOME';
+    trigger_value: string | null;
+    market_code: string;
+    result: string;
+}
+export interface BtcDomTriggerParams extends BaseTriggerOrderNotificationParams {
+    trigger_type: 'BTC_DOM';
+    direction: 'MORE_THAN' | 'LESS_THAN' | null;
+    trigger_value: number | null;
+    current_btc_dominance: number;
+}
+export type TriggerOrderNotificationParams = PriceTriggerParams | PriceRatioTriggerParams | CrossAssetPriceTriggerParams | PredictionMarketOutcomeTriggerParams | BtcDomTriggerParams;
 export interface NotificationDto {
     id: string;
     address: string;
@@ -216,8 +261,11 @@ export interface PositionAssetDetailDto {
     collateralToken?: CollateralToken;
 }
 export interface TpSlThreshold {
-    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 /**
  * Open position data structure
@@ -253,34 +301,91 @@ export interface OrderAssetDto {
 /**
  * Order status
  */
-export type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
+export type OrderStatus = 'OPEN' | 'PROCESSING' | 'EXECUTED' | 'CANCELLED' | 'FAILED' | 'PARTIALLY_FILLED';
 /**
  * Order type
  */
-export type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
+export type OrderType = 'SYNC' | 'MARKET' | 'TRIGGER' | 'TWAP' | 'LADDER' | 'TP' | 'SL' | 'SPOT_MARKET' | 'SPOT_LIMIT' | 'SPOT_TWAP';
 /**
  * TP/SL trigger type
  */
-export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
-export type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
+export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+/**
+ * Trigger type for trigger orders
+ */
+export type TriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+export type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
+/**
+ * Market order parameters
+ */
+export interface MarketOrderParameters {
+    leverage?: number;
+    usdValue: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Trigger order parameters
+ */
+export interface TriggerOrderParameters {
+    leverage: number;
+    usdValue: number;
+    triggerType: TriggerType;
+    triggerValue: number;
+    direction: OrderDirection;
+    reduceOnly?: boolean;
+    assetName?: string;
+    marketCode?: string;
+    marketName?: string;
+}
+/**
+ * TWAP order parameters
+ */
+export interface TwapOrderParameters {
+    leverage: number;
+    usdValue: number;
+    duration: string;
+    intervalSeconds?: number;
+    chunkUsdValue: number;
+    randomizeExecution?: boolean;
+    reduceOnly?: boolean;
+}
+/**
+ * TP/SL order parameters
+ */
+export interface TpSlOrderParameters {
+    triggerType: TpSlTriggerType;
+    triggerValue: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Ladder order parameters
+ */
+export interface LadderOrderParameters {
+    leverage: number;
+    usdValue: number;
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Union type for all order parameters
+ */
+export type OrderParameters = MarketOrderParameters | TriggerOrderParameters | TwapOrderParameters | TpSlOrderParameters | LadderOrderParameters;
 /**
  * Open limit order data structure
  */
 export interface OpenLimitOrderDto {
     orderId: string;
     address: string;
-    clientId: string | null;
+    clientId?: string | null;
     positionId?: string | null;
-    leverage: number;
-    usdValue: number;
-    triggerValue?: number | null;
-    twapDuration?: string | null;
-    tpSlTriggerType?: TpSlTriggerType | null;
-    randomizeFlag: boolean;
-    reduceOnlyFlag: boolean;
-    status: OrderStatus;
+    parameters: OrderParameters;
     orderType: OrderType;
-    direction?: OrderDirection | null;
+    status: OrderStatus;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -447,7 +552,7 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs';
+export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs' | 'userFills';
 export interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
@@ -459,6 +564,7 @@ export interface HLChannelDataMap {
     };
     allDexsClearinghouseState: AllDexsClearinghouseStateData;
     allDexsAssetCtxs: AllDexsAssetCtxsData;
+    userFills: any;
 }
 export interface WebData3UserState {
     agentAddress?: string;

package/dist/utils/order-helpers.d.ts

@@ -0,0 +1,57 @@
+import type { OpenLimitOrderDto, TpSlTriggerType, TriggerType, OrderDirection } from '../types';
+/**
+ * Helper functions to safely extract values from order parameters
+ * based on the order type and parameter structure.
+ */
+/**
+ * Get leverage from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+export declare function getOrderLeverage(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get USD value from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+export declare function getOrderUsdValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get trigger value from order parameters (available for TP/SL and Trigger orders)
+ */
+export declare function getOrderTriggerValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get TP/SL trigger type from order parameters (only for TP/SL orders)
+ */
+export declare function getOrderTpSlTriggerType(order: OpenLimitOrderDto): TpSlTriggerType | undefined;
+/**
+ * Get trigger type from order parameters (for Trigger orders)
+ */
+export declare function getOrderTriggerType(order: OpenLimitOrderDto): TriggerType | undefined;
+/**
+ * Get order direction from order parameters (for Trigger orders)
+ */
+export declare function getOrderDirection(order: OpenLimitOrderDto): OrderDirection | undefined;
+/**
+ * Get reduce only flag from order parameters (available for all order types)
+ */
+export declare function getOrderReduceOnly(order: OpenLimitOrderDto): boolean;
+/**
+ * Get TWAP duration from order parameters (only for TWAP orders)
+ */
+export declare function getOrderTwapDuration(order: OpenLimitOrderDto): string | undefined;
+/**
+ * Get ladder config from order parameters (only for Ladder orders)
+ */
+export declare function getOrderLadderConfig(order: OpenLimitOrderDto): {
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+} | undefined;
+/**
+ * Check if the order is a BTC Dominance trigger order
+ */
+export declare function isBtcDomOrder(order: OpenLimitOrderDto): boolean;
+/**
+ * Get trailing info from TP/SL order parameters
+ */
+export declare function getOrderTrailingInfo(order: OpenLimitOrderDto): {
+    isTrailing: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+} | undefined;

package/package.json

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

package/dist/hooks/useAutoSyncFills.d.ts

@@ -1,19 +0,0 @@
-import type { SyncFillsResponseDto } from '../types';
-export interface AutoSyncFillsOptions {
-    baseUrl: string;
-    address: string | null;
-    intervalMs?: number;
-    aggregateByTime?: boolean;
-}
-export interface AutoSyncFillsState {
-    lastRunAt: number | null;
-    lastResult: SyncFillsResponseDto | null;
-    error: string | null;
-    isSyncing: boolean;
-    triggerSync: () => Promise<void>;
-}
-/**
- * Listens to address changes and periodically syncs user fills
- * Defaults: aggregate=true, interval=60s
- */
-export declare function useAutoSyncFills(options: AutoSyncFillsOptions): AutoSyncFillsState;