@rabby-wallet/hyperliquid-sdk 1.1.2-beta.9 → 1.1.3

package/README.md

@@ -1,140 +1,140 @@
-# Hyperliquid Perpetuals SDK
-
-一个简化的 Hyperliquid 永续合约交易 SDK，专为前端应用设计。
-
-## 特性
-
-- ✅ 仅核心API：最重要的交易与查询能力
-- ✅ 永续合约专用：不包含现货功能
-- ✅ TypeScript：完善的类型定义
-- ✅ WebSocket：实时数据订阅
-- ✅ 前端友好：基于 fetch API 的轻量实现
-
-## 安装
-
-```bash
-yarn add @debank/hyperliquid-perp-sdk
-# or
-npm i @debank/hyperliquid-perp-sdk
-```
-
-## 快速开始
-
-### 仅查询（无需私钥）
-```ts
-import { HyperliquidSDK } from '@debank/hyperliquid-perp-sdk';
-
-const sdk = new HyperliquidSDK({
-  masterAddress: '0xYourEOA',
-  isTestnet: true,
-});
-
-// 获取所有中间价
-const prices = await sdk.info.getAllMids();
-
-// 获取市场元数据与资产上下文 
-const canUseCache = true; //默认使用缓存，多次请求并发去重 ，需要刷新传false
-const [meta, assetCtxs] = await sdk.info.metaAndAssetCtxs(canUseCache);
-
-
-// 获取账户综合状态
-const account = await sdk.info.getClearingHouseState();
-```
-
-### 交易（需要提供代理私钥、公钥、名称）
-```ts
-const sdk = new HyperliquidSDK({
-  masterAddress: '0xYourEOA',
-  agentPrivateKey: '0xYourAgentPrivKey',
-  agentPublicKey: '0xYourAgentPubKey',
-  agentName: 'MyAgent',
-  isTestnet: true,
-});
-
-// 限价下单
-await sdk.exchange!.placeOrder({
-  coin: 'BTC',
-  isBuy: true,
-  sz: '0.1',
-  limitPx: '45000',
-  orderType: { limit: { tif: 'Gtc' } },
-});
-
-// 批量下单
-await sdk.exchange!.multiOrder({
-  orders: [
-    { coin: 'ETH', isBuy: true,  sz: '1',   limitPx: '3000', orderType: { limit: { tif: 'Ioc' } } },
-    { coin: 'SOL', isBuy: false, sz: '10',  limitPx: '150',  orderType: { limit: { tif: 'Ioc' } } },
-  ],
-});
-
-// 市价开仓（带可选的 TP/SL 触发单）
-await sdk.exchange!.marketOrderOpen({
-  coin: 'BTC',
-  isBuy: true,
-  size: '0.05',
-  midPx: '45200',
-  tpTriggerPx: '47000',
-  slTriggerPx: '44000',
-  // slippage 默认 0.08
-});
-
-// 市价平仓
-await sdk.exchange!.marketOrderClose({
-  coin: 'BTC',
-  isBuy: false,
-  size: '0.05',
-  midPx: '45000',
-});
-
-// 绑定 TP/SL 到已有持仓（按位置绑定）
-await sdk.exchange!.bindTpslByOrderId({
-  coin: 'BTC',
-  isBuy: true, // 持仓方向
-  tpTriggerPx: '47000',
-  slTriggerPx: '44000',
-});
-
-// 更新杠杆
-await sdk.exchange!.updateLeverage({
-  coin: 'BTC',
-  leverage: 5,
-  isCross: true,
-});
-
-// 撤单（可批量）
-await sdk.exchange!.cancelOrder([
-  { coin: 'BTC', oid: 12345 },
-  { coin: 'ETH', oid: 67890 },
-]);
-```
-
-### 授权持久化代理（主钱包签名）
-```ts
-// 准备主钱包签名的 EIP-712 数据（Approve Agent）
-const approve = sdk.exchange!.prepareApproveAgent();
-// 业务方使用主钱包签名（示例）
-const signature = await mainWallet.signTypedData(approve.domain, approve.types, approve.message);
-// 发送请求
-await sdk.exchange!.sendApproveAgent({ action: approve.message, nonce: approve.nonce, signature });
-
-// 准备并签名 Builder 费用
-const builderFee = sdk.exchange!.prepareApproveBuilderFee({ builder: '0xBuilder', maxFee: '0.1%' });
-const sig2 = await mainWallet.signTypedData(builderFee.domain, builderFee.types, builderFee.message);
-await sdk.exchange!.sendApproveBuilderFee({ action: builderFee.message, nonce: builderFee.nonce, signature: sig2 });
-```
-
-### WebSocket 实时数据
-```ts
-await sdk.connectWebSocket();
-
-// 订阅价格
-sdk.ws.subscribeToAllMids((prices) => {
-  console.log('价格更新:', prices);
-});
-
-// 订阅用户综合数据
-sdk.ws.subscribeToWebData2('0xYourEOA', (webData2) => {
-  console.log('用户数据:', webData2);
-});
+# Hyperliquid Perpetuals SDK
+
+一个简化的 Hyperliquid 永续合约交易 SDK，专为前端应用设计。
+
+## 特性
+
+- ✅ 仅核心API：最重要的交易与查询能力
+- ✅ 永续合约专用：不包含现货功能
+- ✅ TypeScript：完善的类型定义
+- ✅ WebSocket：实时数据订阅
+- ✅ 前端友好：基于 fetch API 的轻量实现
+
+## 安装
+
+```bash
+yarn add @debank/hyperliquid-perp-sdk
+# or
+npm i @debank/hyperliquid-perp-sdk
+```
+
+## 快速开始
+
+### 仅查询（无需私钥）
+```ts
+import { HyperliquidSDK } from '@debank/hyperliquid-perp-sdk';
+
+const sdk = new HyperliquidSDK({
+  masterAddress: '0xYourEOA',
+  isTestnet: true,
+});
+
+// 获取所有中间价
+const prices = await sdk.info.getAllMids();
+
+// 获取市场元数据与资产上下文 
+const canUseCache = true; //默认使用缓存，多次请求并发去重 ，需要刷新传false
+const [meta, assetCtxs] = await sdk.info.metaAndAssetCtxs(canUseCache);
+
+
+// 获取账户综合状态
+const account = await sdk.info.getClearingHouseState();
+```
+
+### 交易（需要提供代理私钥、公钥、名称）
+```ts
+const sdk = new HyperliquidSDK({
+  masterAddress: '0xYourEOA',
+  agentPrivateKey: '0xYourAgentPrivKey',
+  agentPublicKey: '0xYourAgentPubKey',
+  agentName: 'MyAgent',
+  isTestnet: true,
+});
+
+// 限价下单
+await sdk.exchange!.placeOrder({
+  coin: 'BTC',
+  isBuy: true,
+  sz: '0.1',
+  limitPx: '45000',
+  orderType: { limit: { tif: 'Gtc' } },
+});
+
+// 批量下单
+await sdk.exchange!.multiOrder({
+  orders: [
+    { coin: 'ETH', isBuy: true,  sz: '1',   limitPx: '3000', orderType: { limit: { tif: 'Ioc' } } },
+    { coin: 'SOL', isBuy: false, sz: '10',  limitPx: '150',  orderType: { limit: { tif: 'Ioc' } } },
+  ],
+});
+
+// 市价开仓（带可选的 TP/SL 触发单）
+await sdk.exchange!.marketOrderOpen({
+  coin: 'BTC',
+  isBuy: true,
+  size: '0.05',
+  midPx: '45200',
+  tpTriggerPx: '47000',
+  slTriggerPx: '44000',
+  // slippage 默认 0.08
+});
+
+// 市价平仓
+await sdk.exchange!.marketOrderClose({
+  coin: 'BTC',
+  isBuy: false,
+  size: '0.05',
+  midPx: '45000',
+});
+
+// 绑定 TP/SL 到已有持仓（按位置绑定）
+await sdk.exchange!.bindTpslByOrderId({
+  coin: 'BTC',
+  isBuy: true, // 持仓方向
+  tpTriggerPx: '47000',
+  slTriggerPx: '44000',
+});
+
+// 更新杠杆
+await sdk.exchange!.updateLeverage({
+  coin: 'BTC',
+  leverage: 5,
+  isCross: true,
+});
+
+// 撤单（可批量）
+await sdk.exchange!.cancelOrder([
+  { coin: 'BTC', oid: 12345 },
+  { coin: 'ETH', oid: 67890 },
+]);
+```
+
+### 授权持久化代理（主钱包签名）
+```ts
+// 准备主钱包签名的 EIP-712 数据（Approve Agent）
+const approve = sdk.exchange!.prepareApproveAgent();
+// 业务方使用主钱包签名（示例）
+const signature = await mainWallet.signTypedData(approve.domain, approve.types, approve.message);
+// 发送请求
+await sdk.exchange!.sendApproveAgent({ action: approve.message, nonce: approve.nonce, signature });
+
+// 准备并签名 Builder 费用
+const builderFee = sdk.exchange!.prepareApproveBuilderFee({ builder: '0xBuilder', maxFee: '0.1%' });
+const sig2 = await mainWallet.signTypedData(builderFee.domain, builderFee.types, builderFee.message);
+await sdk.exchange!.sendApproveBuilderFee({ action: builderFee.message, nonce: builderFee.nonce, signature: sig2 });
+```
+
+### WebSocket 实时数据
+```ts
+await sdk.connectWebSocket();
+
+// 订阅价格
+sdk.ws.subscribeToAllMids((prices) => {
+  console.log('价格更新:', prices);
+});
+
+// 订阅用户综合数据
+sdk.ws.subscribeToWebData2('0xYourEOA', (webData2) => {
+  console.log('用户数据:', webData2);
+});
 ```

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, PlaceTPSlMarketOrderParams, PlaceTPSlLimitOrderParams } from '../types';
+import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderParams, MultiOrderParams, CancelOrderParams, ModifyOrderParams, WithdrawParams, ApproveBuilderFeeParams, PrepareApproveBuilderFeeResult, SendApproveParams, MarketOrderParams, UpdateLeverageParams, BindTpslByOrderIdParams, UpdateIsolatedMarginParams, TwapOrderParams, TwapCancelParams, TwapOrderResponse, PlaceTPSlMarketOrderParams, PlaceTPSlLimitOrderParams, ClearinghouseState, UpdateTpslByOrderIdParams, LimitOrderParams } from '../types';
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -10,11 +10,19 @@ export declare class ExchangeClient {
     private agentPublicKey?;
     private agentName?;
     private readonly isTestnet;
+    slippage: number;
     private masterAddress;
     private builder?;
     private readonly symbolConversion;
     constructor(config: ExchangeClientConfig);
     initAccount(masterAddress: string, agentPrivateKey?: string, agentPublicKey?: string, agentName?: string): void;
+    /**
+     * Set the slippage for the exchange client
+     * default is 0.08
+     * 0 - 0.1
+     * @param slippage - The slippage to set
+     */
+    setSlippage(slippage?: number): void;
     initOrUpdateAgent(agentPrivateKey: string, agentPublicKey: string, agentName?: string): void;
     /**
      * Check if agent is set
@@ -47,7 +55,7 @@ export declare class ExchangeClient {
      * @param isBuy - True for buy orders, false for sell orders
      * @param szDecimals - Size decimals from meta endpoint (default 0)
      */
-    private getSlippagePx;
+    getSlippagePx(midPx: string, slippage: number, isBuy: boolean, szDecimals?: number): string;
     /**
      * Round a number to specified decimal places
      */
@@ -59,6 +67,16 @@ export declare class ExchangeClient {
      */
     marketOrderOpen(params: MarketOrderParams): Promise<OrderResponse>;
     marketOrderClose(params: Omit<MarketOrderParams, 'tpTriggerPx' | 'slTriggerPx'>): Promise<OrderResponse>;
+    /**
+     * Place a market order
+     * default slippage is 0.08
+     * need to update leverage before place order
+     */
+    limitOrderOpen(params: LimitOrderParams): Promise<OrderResponse>;
+    closeAllPositions(clearinghouseState: ClearinghouseState, slippage?: number, builder?: {
+        address: string;
+        fee: number;
+    }): Promise<OrderResponse>;
     /**
      * Place a take profit or stop loss market order
      * default slippage is 0.08
@@ -66,7 +84,6 @@ export declare class ExchangeClient {
     placeTPSlMarketOrder(params: PlaceTPSlMarketOrderParams): Promise<OrderResponse>;
     /**
  * Place a take profit or stop loss limit order
- * default slippage is 0.08
  */
     placeTPSlLimitOrder(params: PlaceTPSlLimitOrderParams): Promise<OrderResponse>;
     /**
@@ -74,6 +91,7 @@ export declare class ExchangeClient {
      */
     multiOrder(params: MultiOrderParams): Promise<OrderResponse>;
     bindTpslByOrderId(params: BindTpslByOrderIdParams): Promise<OrderResponse>;
+    updateTpslByOrderId(params: UpdateTpslByOrderIdParams): Promise<OrderResponse>;
     /**
      * Cancel order(s)
      */
@@ -81,7 +99,8 @@ export declare class ExchangeClient {
     /**
      * Modify an existing order
      */
-    modifyOrder(params: ModifyOrderParams): Promise<any>;
+    modifyOrder(params: ModifyOrderParams): Promise<OrderResponse>;
+    batchModifyOrder(params: ModifyOrderParams[]): Promise<OrderResponse>;
     updateIsolatedMargin(params: UpdateIsolatedMarginParams): Promise<any>;
     prepareSetReferrer(code: string): {
         typedData: import("@metamask/eth-sig-util").TypedMessage<import("@metamask/eth-sig-util").MessageTypes>;

package/dist/client/exchange-client.js

@@ -55,6 +55,7 @@ const number_1 = require("../utils/number");
  */
 class ExchangeClient {
     constructor(config) {
+        this.slippage = constants_1.SLIPPAGE;
         this.masterAddress = config.masterAddress;
         this.httpClient = new http_client_1.HttpClient({
             isTestnet: config.isTestnet,
@@ -93,6 +94,21 @@ class ExchangeClient {
             this.agentName = undefined;
         }
     }
+    /**
+     * Set the slippage for the exchange client
+     * default is 0.08
+     * 0 - 0.1
+     * @param slippage - The slippage to set
+     */
+    setSlippage(slippage = constants_1.SLIPPAGE) {
+        if (Number.isNaN(slippage)) {
+            throw new Error('Slippage must be a number');
+        }
+        if (slippage < 0 || slippage > 0.1) {
+            throw new Error('Slippage must be between 0 and 0.1');
+        }
+        this.slippage = slippage;
+    }
     initOrUpdateAgent(agentPrivateKey, agentPublicKey, agentName) {
         this.agentPrivateKey = agentPrivateKey.startsWith('0x') ? agentPrivateKey : ethUtil.addHexPrefix(agentPrivateKey);
         this.agentPublicKey = agentPublicKey.startsWith('0x') ? agentPublicKey : ethUtil.addHexPrefix(agentPublicKey);
@@ -222,7 +238,7 @@ class ExchangeClient {
     marketOrderOpen(params) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const slippage = params.slippage || constants_1.SLIPPAGE;
+                const slippage = params.slippage || this.slippage;
                 const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
                 const px = this.getSlippagePx((0, number_1.removeTrailingZeros)(params.midPx), slippage, params.isBuy, szDecimals);
                 const orders = [{
@@ -231,14 +247,14 @@ class ExchangeClient {
                         sz: (0, number_1.removeTrailingZeros)(params.size),
                         limitPx: px,
                         reduceOnly: params.reduceOnly || false,
-                        orderType: { limit: { tif: 'Ioc' } },
+                        orderType: { limit: { tif: 'FrontendMarket' } },
                     }];
                 if (params.tpTriggerPx) {
                     const tpOrder = {
                         coin: params.coin,
                         isBuy: !params.isBuy,
                         sz: (0, number_1.removeTrailingZeros)(params.size),
-                        limitPx: (0, number_1.removeTrailingZeros)(params.tpTriggerPx),
+                        limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tpTriggerPx), slippage, !params.isBuy, szDecimals),
                         reduceOnly: true,
                         orderType: {
                             trigger: {
@@ -255,7 +271,7 @@ class ExchangeClient {
                         coin: params.coin,
                         isBuy: !params.isBuy,
                         sz: (0, number_1.removeTrailingZeros)(params.size),
-                        limitPx: (0, number_1.removeTrailingZeros)(params.slTriggerPx),
+                        limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.slTriggerPx), slippage, !params.isBuy, szDecimals),
                         reduceOnly: true,
                         orderType: {
                             trigger: {
@@ -267,9 +283,11 @@ class ExchangeClient {
                     };
                     orders.push(slOrder);
                 }
+                const hasTpOrSl = params.slTriggerPx || params.tpTriggerPx;
                 const res = yield this.multiOrder({
                     orders,
                     builder: params.builder,
+                    grouping: hasTpOrSl ? 'normalTpsl' : 'na',
                 });
                 return res;
             }
@@ -280,8 +298,9 @@ class ExchangeClient {
     }
     marketOrderClose(params) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             try {
-                const slippage = params.slippage || constants_1.SLIPPAGE;
+                const slippage = params.slippage || this.slippage;
                 const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
                 const px = this.getSlippagePx(params.midPx, slippage, params.isBuy, szDecimals);
                 const orders = [{
@@ -289,7 +308,7 @@ class ExchangeClient {
                         isBuy: params.isBuy,
                         sz: (0, number_1.removeTrailingZeros)(params.size),
                         limitPx: px,
-                        reduceOnly: true,
+                        reduceOnly: (_a = params.reduceOnly) !== null && _a !== void 0 ? _a : true,
                         orderType: { limit: { tif: 'Ioc' } },
                     }];
                 const res = yield this.multiOrder({
@@ -303,6 +322,105 @@ class ExchangeClient {
             }
         });
     }
+    /**
+     * Place a market order
+     * default slippage is 0.08
+     * need to update leverage before place order
+     */
+    limitOrderOpen(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const slippage = params.slippage || this.slippage;
+                const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
+                // const px = this.getSlippagePx(removeTrailingZeros(params.limitPx), slippage, params.isBuy, szDecimals);
+                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: { limit: { tif: params.tif || 'Gtc' } },
+                    }];
+                if (params.tpTriggerPx) {
+                    const tpOrder = {
+                        coin: params.coin,
+                        isBuy: !params.isBuy,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tpTriggerPx), slippage, !params.isBuy, szDecimals),
+                        reduceOnly: true,
+                        orderType: {
+                            trigger: {
+                                isMarket: true,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.tpTriggerPx),
+                                tpsl: 'tp',
+                            }
+                        },
+                    };
+                    orders.push(tpOrder);
+                }
+                if (params.slTriggerPx) {
+                    const slOrder = {
+                        coin: params.coin,
+                        isBuy: !params.isBuy,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.slTriggerPx), slippage, !params.isBuy, szDecimals),
+                        reduceOnly: true,
+                        orderType: {
+                            trigger: {
+                                isMarket: true,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.slTriggerPx),
+                                tpsl: 'sl',
+                            }
+                        }
+                    };
+                    orders.push(slOrder);
+                }
+                const hasTpOrSl = params.slTriggerPx || params.tpTriggerPx;
+                const res = yield this.multiOrder({
+                    orders,
+                    builder: params.builder,
+                    grouping: hasTpOrSl ? 'normalTpsl' : 'na',
+                });
+                return res;
+            }
+            catch (error) {
+                throw error;
+            }
+        });
+    }
+    closeAllPositions(clearinghouseState_1) {
+        return __awaiter(this, arguments, void 0, function* (clearinghouseState, slippage = constants_1.SLIPPAGE, builder) {
+            try {
+                const closeOrders = [];
+                for (const position of clearinghouseState.assetPositions) {
+                    const item = position.position;
+                    if (parseFloat(item.szi) !== 0) {
+                        const isBuy = parseFloat(item.szi) < 0;
+                        const size = Math.abs(parseFloat(item.szi));
+                        const markPx = parseFloat(item.positionValue) / size;
+                        const szDecimals = yield this.symbolConversion.getAssetSzDecimals(item.coin);
+                        const px = this.getSlippagePx(markPx.toString(), slippage, isBuy, szDecimals);
+                        closeOrders.push({
+                            coin: item.coin,
+                            isBuy,
+                            sz: (0, number_1.removeTrailingZeros)(size.toString()),
+                            limitPx: px,
+                            reduceOnly: true,
+                            orderType: { limit: { tif: 'Ioc' } },
+                        });
+                    }
+                }
+                const res = yield this.multiOrder({
+                    orders: closeOrders,
+                    builder,
+                });
+                return res;
+            }
+            catch (error) {
+                throw error;
+            }
+        });
+    }
     /**
      * Place a take profit or stop loss market order
      * default slippage is 0.08
@@ -310,7 +428,7 @@ class ExchangeClient {
     placeTPSlMarketOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const slippage = params.slippage || constants_1.SLIPPAGE;
+                const slippage = params.slippage || this.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 = [{
@@ -340,7 +458,6 @@ class ExchangeClient {
     }
     /**
  * Place a take profit or stop loss limit order
- * default slippage is 0.08
  */
     placeTPSlLimitOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -421,13 +538,14 @@ class ExchangeClient {
     bindTpslByOrderId(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let orders = [];
+            const slippage = params.slippage || this.slippage;
             const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
             if (params.tpTriggerPx) {
                 orders.push({
                     coin: params.coin,
                     isBuy: !params.isBuy,
                     sz: '0',
-                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tpTriggerPx), constants_1.SLIPPAGE, !params.isBuy, szDecimals),
+                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tpTriggerPx), slippage, !params.isBuy, szDecimals),
                     reduceOnly: true,
                     orderType: {
                         trigger: {
@@ -443,7 +561,7 @@ class ExchangeClient {
                     coin: params.coin,
                     isBuy: !params.isBuy,
                     sz: '0',
-                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.slTriggerPx), constants_1.SLIPPAGE, !params.isBuy, szDecimals),
+                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.slTriggerPx), slippage, !params.isBuy, szDecimals),
                     reduceOnly: true,
                     orderType: {
                         trigger: {
@@ -464,6 +582,54 @@ class ExchangeClient {
             });
         });
     }
+    updateTpslByOrderId(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let orders = [];
+            const szDecimals = yield this.symbolConversion.getAssetSzDecimals(params.coin);
+            const isBuy = !params.isBuy;
+            const slippage = params.slippage || this.slippage;
+            if (params.tp) {
+                const limitPx = params.tp.limitPx || this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tp.triggerPx), slippage, isBuy, szDecimals);
+                orders.push({
+                    oid: params.tp.oid,
+                    coin: params.coin,
+                    isBuy,
+                    sz: '0',
+                    limitPx,
+                    reduceOnly: true,
+                    orderType: {
+                        trigger: {
+                            isMarket: true,
+                            triggerPx: (0, number_1.removeTrailingZeros)(params.tp.triggerPx),
+                            tpsl: 'tp',
+                        }
+                    }
+                });
+            }
+            if (params.sl) {
+                const limitPx = params.sl.limitPx || this.getSlippagePx((0, number_1.removeTrailingZeros)(params.sl.triggerPx), slippage, isBuy, szDecimals);
+                orders.push({
+                    oid: params.sl.oid,
+                    coin: params.coin,
+                    isBuy,
+                    sz: '0',
+                    limitPx,
+                    reduceOnly: true,
+                    orderType: {
+                        trigger: {
+                            isMarket: true,
+                            triggerPx: (0, number_1.removeTrailingZeros)(params.sl.triggerPx),
+                            tpsl: 'sl',
+                        }
+                    }
+                });
+            }
+            if (orders.length === 0) {
+                throw new Error('Must have at least one tp or sl');
+            }
+            return this.batchModifyOrder(orders);
+        });
+    }
     /**
      * Cancel order(s)
      */
@@ -495,7 +661,8 @@ class ExchangeClient {
     modifyOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const nonce = Date.now();
-            const modify = {
+            const action = {
+                type: constants_1.ExchangeType.MODIFY,
                 oid: params.oid,
                 order: {
                     a: yield this.symbolConversion.getAssetIndex(params.coin),
@@ -506,9 +673,39 @@ class ExchangeClient {
                     t: params.orderType || { limit: { tif: 'Gtc' } },
                 },
             };
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
+            return this.httpClient.exchange({
+                action,
+                nonce,
+                signature,
+            });
+        });
+    }
+    batchModifyOrder(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const nonce = Date.now();
+            const assetIndexCache = new Map();
+            const modifies = yield Promise.all(params.map((param) => __awaiter(this, void 0, void 0, function* () {
+                let assetIndex = assetIndexCache.get(param.coin);
+                if (assetIndex === undefined) {
+                    assetIndex = yield this.symbolConversion.getAssetIndex(param.coin);
+                    assetIndexCache.set(param.coin, assetIndex);
+                }
+                return {
+                    oid: param.oid,
+                    order: {
+                        a: assetIndex,
+                        b: param.isBuy,
+                        p: (0, number_1.removeTrailingZeros)(param.limitPx),
+                        s: (0, number_1.removeTrailingZeros)(param.sz),
+                        r: param.reduceOnly || false,
+                        t: param.orderType || { limit: { tif: 'Gtc' } },
+                    }
+                };
+            })));
             const action = {
-                type: constants_1.ExchangeType.MODIFY,
-                modifies: [modify],
+                type: constants_1.ExchangeType.BATCH_MODIFY,
+                modifies,
             };
             const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
@@ -758,12 +955,11 @@ class ExchangeClient {
     cancelTwapOrder(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const nonce = Date.now();
+            const a = yield this.symbolConversion.getAssetIndex(params.coin);
             const action = {
                 type: constants_1.ExchangeType.TWAP_CANCEL,
-                twap: {
-                    a: yield this.symbolConversion.getAssetIndex(params.coin),
-                    t: params.twapId,
-                },
+                a,
+                t: params.twapId,
             };
             const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({

package/dist/client/http-client.js

@@ -52,7 +52,7 @@ class HttpClient {
                     if (error.name === 'AbortError') {
                         throw new Error('Request timeout');
                     }
-                    throw new Error(`API Error: ${error.message}`);
+                    throw new Error(error.message);
                 }
                 throw new Error('Unknown API error');
             }

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

@@ -1,4 +1,4 @@
-import type { Meta, AssetCtx, ClearinghouseState, UserFills, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse, UserNonFundingLedgerUpdates, UserHistoricalOrders, ReferralResponse, L2BookSnapshot, UserTwapSliceFill, FundingHistoryItem, UserFunding } from '../types';
+import type { Meta, AssetCtx, ClearinghouseState, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse, UserNonFundingLedgerUpdates, UserHistoricalOrders, ReferralResponse, L2BookSnapshot, UserTwapSliceFill, FundingHistoryItem, UserFunding, WsFill } from '../types';
 export interface InfoClientConfig {
     isTestnet?: boolean;
     timeout?: number;
@@ -29,7 +29,7 @@ export declare class InfoClient {
     /**
      * Get user's fill history
      */
-    getUserFills(address?: string, aggregateByTime?: boolean): Promise<UserFills>;
+    getUserFills(address?: string, aggregateByTime?: boolean): Promise<WsFill[]>;
     /**
      * Get user's fill and cancel and other all orders history
      */

package/dist/types/index.d.ts

@@ -209,6 +209,21 @@ export interface OrderResponse {
         };
     };
 }
+export interface LimitOrderParams {
+    coin: string;
+    isBuy: boolean;
+    size: string;
+    limitPx: string;
+    tif: Tif;
+    reduceOnly?: boolean;
+    tpTriggerPx?: string;
+    slTriggerPx?: string;
+    slippage?: number;
+    builder?: {
+        address: string;
+        fee: number;
+    };
+}
 export interface MarketOrderParams {
     coin: string;
     isBuy: boolean;
@@ -452,11 +467,27 @@ export interface BindTpslByOrderIdParams {
     slTriggerPx?: string;
     coin: string;
     isBuy: boolean;
+    slippage?: number;
     builder?: {
         address: string;
         fee: number;
     };
 }
+export interface UpdateTpslByOrderIdParams {
+    tp?: {
+        oid: OrderId;
+        triggerPx: string;
+        limitPx?: string;
+    };
+    sl?: {
+        oid: OrderId;
+        triggerPx: string;
+        limitPx?: string;
+    };
+    coin: string;
+    isBuy: boolean;
+    slippage?: number;
+}
 export interface MultiOrderParams {
     orders: PlaceOrderParams[];
     grouping?: "na" | "normalTpsl" | "positionTpsl";
@@ -559,7 +590,7 @@ export interface TwapOrderResponse {
     response: {
         type: 'twapOrder';
         data?: {
-            statuses?: {
+            status?: {
                 running?: {
                     twapId?: number;
                 };
@@ -568,60 +599,77 @@ export interface TwapOrderResponse {
         };
     };
 }
-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;
@@ -649,3 +697,4 @@ export interface UserFunding {
 export interface Notification {
     notification: string;
 }
+export {};

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "@rabby-wallet/hyperliquid-sdk",
-  "version": "1.1.2-beta.9",
-  "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "rimraf dist && tsc",
-    "preversion": "npm run build",
-    "prepublishOnly": "npm run build"
-  },
-  "author": "",
-  "license": "UNLICENSED",
-  "dependencies": {
-    "@ethereumjs/util": "9.0.0",
-    "@metamask/eth-sig-util": "5.1.0",
-    "@msgpack/msgpack": "3.1.2",
-    "@noble/hashes": "1.8.0",
-    "ethereum-cryptography": "2.2.1"
-  },
-  "devDependencies": {
-    "@types/node": "24.3.1",
-    "prettier": "2.7.1",
-    "rimraf": "6.0.0",
-    "typescript": "5.9.2"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "packageManager": "yarn@1.22.22"
-}
+{
+  "name": "@rabby-wallet/hyperliquid-sdk",
+  "version": "1.1.3",
+  "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "preversion": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "author": "",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@ethereumjs/util": "9.0.0",
+    "@metamask/eth-sig-util": "5.1.0",
+    "@msgpack/msgpack": "3.1.2",
+    "@noble/hashes": "1.8.0",
+    "ethereum-cryptography": "2.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.3.1",
+    "prettier": "2.7.1",
+    "rimraf": "6.0.0",
+    "typescript": "5.9.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "packageManager": "yarn@1.22.22"
+}