@rabby-wallet/hyperliquid-sdk 1.1.2-beta.1 → 1.1.2-beta.10

package/dist/client/exchange-client.d.ts

@@ -1,5 +1,5 @@
 import { ExchangeType } from '../types/constants';
-import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderParams, MultiOrderParams, CancelOrderParams, ModifyOrderParams, WithdrawParams, ApproveBuilderFeeParams, PrepareApproveBuilderFeeResult, SendApproveParams, MarketOrderParams, UpdateLeverageParams, BindTpslByOrderIdParams, UpdateIsolatedMarginParams, TwapOrderParams, TwapCancelParams, TwapOrderResponse } from '../types';
+import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderParams, MultiOrderParams, CancelOrderParams, ModifyOrderParams, WithdrawParams, ApproveBuilderFeeParams, PrepareApproveBuilderFeeResult, SendApproveParams, MarketOrderParams, UpdateLeverageParams, BindTpslByOrderIdParams, UpdateIsolatedMarginParams, TwapOrderParams, TwapCancelParams, TwapOrderResponse, PlaceTPSlMarketOrderParams, PlaceTPSlLimitOrderParams } from '../types';
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -59,6 +59,16 @@ export declare class ExchangeClient {
      */
     marketOrderOpen(params: MarketOrderParams): Promise<OrderResponse>;
     marketOrderClose(params: Omit<MarketOrderParams, 'tpTriggerPx' | 'slTriggerPx'>): Promise<OrderResponse>;
+    /**
+     * Place a take profit or stop loss market order
+     * default slippage is 0.08
+     */
+    placeTPSlMarketOrder(params: PlaceTPSlMarketOrderParams): Promise<OrderResponse>;
+    /**
+ * Place a take profit or stop loss limit order
+ * default slippage is 0.08
+ */
+    placeTPSlLimitOrder(params: PlaceTPSlLimitOrderParams): Promise<OrderResponse>;
     /**
      * Place multiple orders at once
      */

package/dist/client/exchange-client.js

@@ -230,7 +230,7 @@ class ExchangeClient {
                         isBuy: params.isBuy,
                         sz: (0, number_1.removeTrailingZeros)(params.size),
                         limitPx: px,
-                        reduceOnly: false,
+                        reduceOnly: params.reduceOnly || false,
                         orderType: { limit: { tif: 'Ioc' } },
                     }];
                 if (params.tpTriggerPx) {
@@ -303,6 +303,73 @@ class ExchangeClient {
             }
         });
     }
+    /**
+     * Place a take profit or stop loss market order
+     * default slippage is 0.08
+     */
+    placeTPSlMarketOrder(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const slippage = params.slippage || constants_1.SLIPPAGE;
+                const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
+                const px = this.getSlippagePx((0, number_1.removeTrailingZeros)(params.triggerPx), slippage, params.isBuy, szDecimals);
+                const orders = [{
+                        coin: params.coin,
+                        isBuy: params.isBuy,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: px,
+                        reduceOnly: params.reduceOnly || false,
+                        orderType: {
+                            trigger: {
+                                isMarket: true,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.triggerPx),
+                                tpsl: params.tpsl,
+                            },
+                        },
+                    }];
+                const res = yield this.multiOrder({
+                    orders,
+                    builder: params.builder,
+                });
+                return res;
+            }
+            catch (error) {
+                throw error;
+            }
+        });
+    }
+    /**
+ * Place a take profit or stop loss limit order
+ * default slippage is 0.08
+ */
+    placeTPSlLimitOrder(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const orders = [{
+                        coin: params.coin,
+                        isBuy: params.isBuy,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: (0, number_1.removeTrailingZeros)(params.limitPx),
+                        reduceOnly: params.reduceOnly || false,
+                        orderType: {
+                            trigger: {
+                                isMarket: false,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.triggerPx),
+                                tpsl: params.tpsl,
+                            },
+                        },
+                    }];
+                const res = yield this.multiOrder({
+                    orders,
+                    builder: params.builder,
+                });
+                return res;
+            }
+            catch (error) {
+                throw error;
+            }
+        });
+    }
     /**
      * Place multiple orders at once
      */
@@ -662,12 +729,14 @@ class ExchangeClient {
             const nonce = Date.now();
             const action = {
                 type: constants_1.ExchangeType.TWAP_ORDER,
-                a: yield this.symbolConversion.getAssetIndex(params.coin),
-                b: params.isBuy,
-                s: (0, number_1.removeTrailingZeros)(params.sz),
-                r: params.reduceOnly || false,
-                m: params.durationMillis,
-                t: params.randomizeDelay || false,
+                twap: {
+                    a: yield this.symbolConversion.getAssetIndex(params.coin),
+                    b: params.isBuy,
+                    s: (0, number_1.removeTrailingZeros)(params.sz),
+                    r: params.reduceOnly || false,
+                    m: params.durationMins,
+                    t: params.randomizeDelay || false,
+                },
             };
             if (params.builder) {
                 action.builder = {
@@ -691,8 +760,10 @@ class ExchangeClient {
             const nonce = Date.now();
             const action = {
                 type: constants_1.ExchangeType.TWAP_CANCEL,
-                a: yield this.symbolConversion.getAssetIndex(params.coin),
-                t: params.twapId,
+                twap: {
+                    a: yield this.symbolConversion.getAssetIndex(params.coin),
+                    t: params.twapId,
+                },
             };
             const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({

package/dist/client/websocket-client.d.ts

@@ -1,4 +1,4 @@
-import type { L2Book, Candle, WsOrder, WebData2, WsActiveAssetCtx, WsUserFills, WsClearinghouseState, Notification, WsTwapStates, WsOpenOrders, WsUserTwapSliceFills, WsUserTwapHistory, wsUserNonFundingLedgerUpdates, WsAllMids, WsTrade } from '../types';
+import type { L2Book, Candle, WsOrder, WebData2, WsActiveAssetCtx, WsUserFills, WsClearinghouseState, Notification, WsTwapStates, WsOpenOrders, WsUserTwapSliceFills, WsUserTwapHistory, wsUserNonFundingLedgerUpdates, WsAllMids, WsTrade, WsActiveAssetData, WsUserHistoricalOrders, WsUserFunding } from '../types';
 export interface WebSocketClientConfig {
     masterAddress?: string;
     isTestnet?: boolean;
@@ -79,6 +79,12 @@ export declare class WebSocketClient {
      * Subscribe to active asset ctx
      */
     subscribeToActiveAssetCtx(coin: string, callback: SubscriptionCallback<WsActiveAssetCtx>): Subscription;
+    /**
+     * Subscribe to active asset data
+     * user: string;
+     * coin: string;
+     */
+    subscribeToActiveAssetData(coin: string, user: string, callback: SubscriptionCallback<WsActiveAssetData>): Subscription;
     /**
      * Subscribe to trades for a specific coin
      */
@@ -92,13 +98,18 @@ export declare class WebSocketClient {
      */
     subscribeToUserFills(callback: SubscriptionCallback<WsUserFills>): Subscription;
     /**
+     * Subscribe to user fills
+     */
+    subscribeToUserHistoricalOrders(callback: SubscriptionCallback<WsUserHistoricalOrders>): Subscription;
+    /**
+     * @deprecated
      * Subscribe to user order updates
      */
     subscribeToUserOrders(callback: SubscriptionCallback<WsOrder[]>): Subscription;
     /**
      * Subscribe to user funding updates
      */
-    subscribeToUserFunding(callback: SubscriptionCallback<any>): Subscription;
+    subscribeToUserFunding(callback: SubscriptionCallback<WsUserFunding>): Subscription;
     /**
      * Subscribe to webData2 - comprehensive user data updates
      * Includes positions, margin summary, open orders, and other user data

package/dist/client/websocket-client.js

@@ -327,6 +327,16 @@ class WebSocketClient {
             subscription: { type: constants_1.WsSubscriptionType.ACTIVE_ASSET_CTX, coin },
         }, callback);
     }
+    /**
+     * Subscribe to active asset data
+     * user: string;
+     * coin: string;
+     */
+    subscribeToActiveAssetData(coin, user, callback) {
+        return this.subscribe({
+            subscription: { type: constants_1.WsSubscriptionType.ACTIVE_ASSET_DATA, coin, user },
+        }, callback);
+    }
     /**
      * Subscribe to trades for a specific coin
      */
@@ -355,6 +365,18 @@ class WebSocketClient {
         }, callback);
     }
     /**
+     * Subscribe to user fills
+     */
+    subscribeToUserHistoricalOrders(callback) {
+        if (!this.config.masterAddress) {
+            throw new Error('masterAddress is empty');
+        }
+        return this.subscribe({
+            subscription: { type: constants_1.WsSubscriptionType.USER_HISTORICAL_ORDERS, user: this.config.masterAddress },
+        }, callback);
+    }
+    /**
+     * @deprecated
      * Subscribe to user order updates
      */
     subscribeToUserOrders(callback) {

package/dist/types/constants.d.ts

@@ -79,6 +79,7 @@ export declare enum WsSubscriptionType {
     TRADES = "trades",
     CANDLE = "candle",
     ACTIVE_ASSET_CTX = "activeAssetCtx",
+    ACTIVE_ASSET_DATA = "activeAssetData",
     USER_FILLS = "userFills",
     ORDER_UPDATES = "orderUpdates",
     USER_FUNDINGS = "userFundings",
@@ -89,5 +90,6 @@ export declare enum WsSubscriptionType {
     OPEN_ORDERS = "openOrders",
     USER_NON_FUNDING_LEDGER_UPDATES = "userNonFundingLedgerUpdates",
     USER_TWAP_SLICE_FILLS = "userTwapSliceFills",
-    USER_TWAP_HISTORY = "userTwapHistory"
+    USER_TWAP_HISTORY = "userTwapHistory",
+    USER_HISTORICAL_ORDERS = "userHistoricalOrders"
 }

package/dist/types/constants.js

@@ -94,6 +94,7 @@ var WsSubscriptionType;
     WsSubscriptionType["TRADES"] = "trades";
     WsSubscriptionType["CANDLE"] = "candle";
     WsSubscriptionType["ACTIVE_ASSET_CTX"] = "activeAssetCtx";
+    WsSubscriptionType["ACTIVE_ASSET_DATA"] = "activeAssetData";
     WsSubscriptionType["USER_FILLS"] = "userFills";
     WsSubscriptionType["ORDER_UPDATES"] = "orderUpdates";
     WsSubscriptionType["USER_FUNDINGS"] = "userFundings";
@@ -105,4 +106,5 @@ var WsSubscriptionType;
     WsSubscriptionType["USER_NON_FUNDING_LEDGER_UPDATES"] = "userNonFundingLedgerUpdates";
     WsSubscriptionType["USER_TWAP_SLICE_FILLS"] = "userTwapSliceFills";
     WsSubscriptionType["USER_TWAP_HISTORY"] = "userTwapHistory";
+    WsSubscriptionType["USER_HISTORICAL_ORDERS"] = "userHistoricalOrders";
 })(WsSubscriptionType || (exports.WsSubscriptionType = WsSubscriptionType = {}));

package/dist/types/index.d.ts

@@ -31,6 +31,18 @@ export interface UserHistoricalOrders {
     status: string;
     statusTimestamp: number;
 }
+export interface WsUserFunding {
+    isSnapshot?: boolean;
+    user: string;
+    fundings: {
+        coin: string;
+        fundingRate: string;
+        nSamples: any;
+        szi: string;
+        time: number;
+        usdc: string;
+    }[];
+}
 export interface OpenOrder {
     coin: string;
     side: Side;
@@ -46,6 +58,7 @@ export interface OpenOrder {
     orderType: 'Take Profit Market' | 'Stop Market';
     origSz: '0.0';
     tif: null;
+    children?: OpenOrder[];
 }
 export interface OrderRequest {
     asset: AssetId;
@@ -201,6 +214,7 @@ export interface MarketOrderParams {
     isBuy: boolean;
     size: string;
     midPx: string;
+    reduceOnly?: boolean;
     tpTriggerPx?: string;
     slTriggerPx?: string;
     slippage?: number;
@@ -251,6 +265,11 @@ export interface WsUserFills {
     user: string;
     fills: WsFill[];
 }
+export interface WsUserHistoricalOrders {
+    isSnapshot?: boolean;
+    user: string;
+    orderHistory: UserHistoricalOrders[];
+}
 export interface WsFill {
     coin: string;
     px: string;
@@ -300,12 +319,47 @@ export interface WsActiveAssetCtx {
         dayNtlVlm: string;
         prevDayPx: string;
         markPx: string;
+        impactPxs: [string, string];
         midPx?: string;
         funding: string;
         openInterest: string;
         oraclePx: string;
     };
 }
+export interface WsActiveAssetData {
+    availableToTrade: [string, string];
+    coin: string;
+    leverage: Leverage;
+    markPx: string;
+    maxTradeSzs: [string, string];
+    user: string;
+}
+export interface PlaceTPSlMarketOrderParams {
+    coin: string;
+    isBuy: boolean;
+    size: string;
+    triggerPx: string;
+    tpsl: 'tp' | 'sl';
+    slippage?: number;
+    reduceOnly?: boolean;
+    builder?: {
+        address: string;
+        fee: number;
+    };
+}
+export interface PlaceTPSlLimitOrderParams {
+    coin: string;
+    isBuy: boolean;
+    size: string;
+    triggerPx: string;
+    limitPx: string;
+    tpsl: 'tp' | 'sl';
+    reduceOnly?: boolean;
+    builder?: {
+        address: string;
+        fee: number;
+    };
+}
 export interface WsTrade {
     coin: string;
     hash: string;
@@ -405,7 +459,7 @@ export interface BindTpslByOrderIdParams {
 }
 export interface MultiOrderParams {
     orders: PlaceOrderParams[];
-    grouping?: string;
+    grouping?: "na" | "normalTpsl" | "positionTpsl";
     builder?: {
         address: string;
         fee: number;
@@ -489,7 +543,7 @@ export interface TwapOrderParams {
     isBuy: boolean;
     sz: string;
     reduceOnly?: boolean;
-    durationMillis: number;
+    durationMins: number;
     randomizeDelay?: boolean;
     builder?: {
         address: string;
@@ -504,65 +558,87 @@ export interface TwapOrderResponse {
     status: 'ok';
     response: {
         type: 'twapOrder';
-        data: {
-            twapId: number;
+        data?: {
+            statuses?: {
+                running?: {
+                    twapId?: number;
+                };
+            };
+            error?: string;
         };
     };
 }
-export interface TwapState {
-    twapId: number;
-    coin: string;
-    isBuy: boolean;
-    sz: string;
-    reduceOnly: boolean;
-    totalSz: string;
-    executedSz: string;
-    remainingSz: string;
-    startTime: number;
-    endTime: number;
-    status: 'active' | 'completed' | 'cancelled';
-}
+type TwapStateArray = [
+    number,
+    {
+        coin: string;
+        user: string;
+        side: Side;
+        sz: string;
+        executedSz: string;
+        executedNtl: string;
+        minutes: number;
+        reduceOnly: boolean;
+        randomize: boolean;
+        timestamp: number;
+    }
+];
 export interface WsTwapStates {
     dex: string;
     user: string;
-    states?: TwapState[];
+    states: TwapStateArray[];
 }
 export interface WsOpenOrders {
     user: string;
     orders?: OpenOrder[];
 }
+export interface UserTwapSliceFill {
+    fill: {
+        closedPnl: string;
+        coin: string;
+        crossed: boolean;
+        dir: string;
+        fee: string;
+        feeToken: string;
+        hash: string;
+        oid: number;
+        px: string;
+        side: Side;
+        startPosition: string;
+        sz: string;
+        tid: number;
+        time: number;
+    };
+    twapId: number;
+}
 export interface WsUserTwapSliceFills {
     user: string;
-    fills?: UserTwapSliceFill[];
+    isSnapshot?: boolean;
+    twapSliceFills: UserTwapSliceFill[];
 }
 export interface WsUserTwapHistory {
     user: string;
-    history?: UserTwapHistory[];
-}
-export interface UserTwapSliceFill {
-    coin: string;
-    px: string;
-    sz: string;
-    side: Side;
-    time: number;
-    hash: string;
-    oid: number;
-    crossed: boolean;
-    fee: string;
-    tid: number;
-    twapId: number;
+    isSnapshot?: boolean;
+    history: UserTwapHistory[];
 }
 export interface UserTwapHistory {
+    state: {
+        coin: string;
+        executedNtl: string;
+        executedSz: string;
+        minutes: number;
+        randomize: boolean;
+        reduceOnly: boolean;
+        side: Side;
+        sz: string;
+        timestamp: number;
+        user: string;
+    };
+    status: {
+        status: 'finished' | 'terminated' | 'activated';
+    };
+    time: number;
     twapId: number;
-    user: string;
-    coin: string;
-    side: Side;
-    sz: string;
-    totalFilled: string;
-    avgFillPx: string;
-    startTime: number;
-    endTime: number;
-    status: string;
 }
 export interface L2BookSnapshot {
     coin: string;
@@ -575,13 +651,19 @@ export interface FundingHistoryItem {
     premium: string;
     time: number;
 }
-export interface UserFunding {
-    time: number;
+export interface UserFundingDelta {
     coin: string;
-    usdc: string;
-    szi: string;
     fundingRate: string;
+    szi: string;
+    type: 'funding';
+    usdc: string;
+}
+export interface UserFunding {
+    delta: UserFundingDelta;
+    hash: string;
+    time: number;
 }
 export interface Notification {
     notification: string;
 }
+export {};

package/dist/types/index.js

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rabby-wallet/hyperliquid-sdk",
-  "version": "1.1.2-beta.1",
+  "version": "1.1.2-beta.10",
   "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,6 @@
     "dist"
   ],
   "publishConfig": {
-
     "access": "public"
   },
   "scripts": {