@rabby-wallet/hyperliquid-sdk 1.0.0-beta.2 → 1.0.0-beta.20

package/README.md

@@ -32,8 +32,10 @@ const sdk = new HyperliquidSDK({
 // 获取所有中间价
 const prices = await sdk.info.getAllMids();
 
-// 获取市场元数据与资产上下文
-const [meta, assetCtxs] = await sdk.info.metaAndAssetCtxs();
+// 获取市场元数据与资产上下文 
+const canUseCache = true; //默认使用缓存，多次请求并发去重 ，需要刷新传false
+const [meta, assetCtxs] = await sdk.info.metaAndAssetCtxs(canUseCache);
+
 
 // 获取账户综合状态
 const account = await sdk.info.getClearingHouseState();

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

@@ -9,10 +9,11 @@ export declare class ExchangeClient {
     private agentPublicKey?;
     private agentName?;
     private readonly isTestnet;
-    private readonly masterAddress;
+    private masterAddress;
     private builder?;
     private readonly symbolConversion;
     constructor(config: ExchangeClientConfig);
+    initAccount(masterAddress: string, agentPrivateKey: string, agentPublicKey: string, agentName?: string): void;
     /**
      * Get the wallet address
      */
@@ -32,7 +33,7 @@ export declare class ExchangeClient {
      * need to update leverage before place order
      */
     marketOrderOpen(params: MarketOrderParams): Promise<OrderResponse>;
-    marketOrderClose(params: MarketOrderParams): Promise<OrderResponse>;
+    marketOrderClose(params: Omit<MarketOrderParams, 'tpTriggerPx' | 'slTriggerPx'>): Promise<OrderResponse>;
     /**
      * Place multiple orders at once
      */

package/dist/client/exchange-client.js

@@ -48,6 +48,7 @@ const http_client_1 = require("./http-client");
 const constants_1 = require("../types/constants");
 const signer_1 = require("../utils/signer");
 const symbolConversion_1 = require("./symbolConversion");
+const number_1 = require("../utils/number");
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -79,6 +80,12 @@ class ExchangeClient {
         }
         this.isTestnet = config.isTestnet || false;
     }
+    initAccount(masterAddress, agentPrivateKey, agentPublicKey, agentName) {
+        this.masterAddress = masterAddress;
+        this.agentPrivateKey = agentPrivateKey.startsWith('0x') ? agentPrivateKey : ethUtil.addHexPrefix(agentPrivateKey);
+        this.agentPublicKey = agentPublicKey.startsWith('0x') ? agentPublicKey : ethUtil.addHexPrefix(agentPublicKey);
+        this.agentName = agentName || '';
+    }
     /**
      * Get the wallet address
      */
@@ -163,7 +170,7 @@ class ExchangeClient {
         const decimals = ((_a = midPx.toString().split('.')[1]) === null || _a === void 0 ? void 0 : _a.length) || 0;
         const prepDecimals = Math.max(0, decimals - 1);
         const px = isBuy ? (Number(midPx) * (1 + slippage)).toFixed(prepDecimals) : (Number(midPx) * (1 - slippage)).toFixed(prepDecimals);
-        return px;
+        return (0, number_1.removeTrailingZeros)(px);
     }
     /**
      * Place a market order
@@ -174,11 +181,11 @@ class ExchangeClient {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const slippage = params.slippage || constants_1.SLIPPAGE;
-                const px = this.getSlippagePx(params.midPx, slippage, params.isBuy);
+                const px = this.getSlippagePx((0, number_1.removeTrailingZeros)(params.midPx), slippage, params.isBuy);
                 const orders = [{
                         coin: params.coin,
                         isBuy: params.isBuy,
-                        sz: params.size,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
                         limitPx: px,
                         reduceOnly: false,
                         orderType: { limit: { tif: 'Ioc' } },
@@ -187,13 +194,13 @@ class ExchangeClient {
                     const tpOrder = {
                         coin: params.coin,
                         isBuy: !params.isBuy,
-                        sz: params.size,
-                        limitPx: params.tpTriggerPx,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: (0, number_1.removeTrailingZeros)(params.tpTriggerPx),
                         reduceOnly: true,
                         orderType: {
                             trigger: {
                                 isMarket: true,
-                                triggerPx: params.tpTriggerPx,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.tpTriggerPx),
                                 tpsl: 'tp',
                             }
                         }
@@ -204,13 +211,13 @@ class ExchangeClient {
                     const slOrder = {
                         coin: params.coin,
                         isBuy: !params.isBuy,
-                        sz: params.size,
-                        limitPx: params.slTriggerPx,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
+                        limitPx: (0, number_1.removeTrailingZeros)(params.slTriggerPx),
                         reduceOnly: true,
                         orderType: {
                             trigger: {
                                 isMarket: true,
-                                triggerPx: params.slTriggerPx,
+                                triggerPx: (0, number_1.removeTrailingZeros)(params.slTriggerPx),
                                 tpsl: 'sl',
                             }
                         }
@@ -235,7 +242,7 @@ class ExchangeClient {
                 const orders = [{
                         coin: params.coin,
                         isBuy: params.isBuy,
-                        sz: params.size,
+                        sz: (0, number_1.removeTrailingZeros)(params.size),
                         limitPx: px,
                         reduceOnly: true,
                         orderType: { limit: { tif: 'Ioc' } },
@@ -266,8 +273,8 @@ class ExchangeClient {
                 return {
                     a: assetIndex,
                     b: order.isBuy,
-                    p: order.limitPx,
-                    s: order.sz,
+                    p: (0, number_1.removeTrailingZeros)(order.limitPx),
+                    s: (0, number_1.removeTrailingZeros)(order.sz),
                     r: order.reduceOnly || false,
                     t: order.orderType || { limit: { tif: 'Gtc' } },
                 };
@@ -299,12 +306,12 @@ class ExchangeClient {
                     coin: params.coin,
                     isBuy: !params.isBuy,
                     sz: '0',
-                    limitPx: this.getSlippagePx(params.tpTriggerPx, constants_1.SLIPPAGE, !params.isBuy),
+                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.tpTriggerPx), constants_1.SLIPPAGE, !params.isBuy),
                     reduceOnly: true,
                     orderType: {
                         trigger: {
                             isMarket: true,
-                            triggerPx: params.tpTriggerPx,
+                            triggerPx: (0, number_1.removeTrailingZeros)(params.tpTriggerPx),
                             tpsl: 'tp',
                         }
                     }
@@ -315,12 +322,12 @@ class ExchangeClient {
                     coin: params.coin,
                     isBuy: !params.isBuy,
                     sz: '0',
-                    limitPx: this.getSlippagePx(params.slTriggerPx, constants_1.SLIPPAGE, !params.isBuy),
+                    limitPx: this.getSlippagePx((0, number_1.removeTrailingZeros)(params.slTriggerPx), constants_1.SLIPPAGE, !params.isBuy),
                     reduceOnly: true,
                     orderType: {
                         trigger: {
                             isMarket: true,
-                            triggerPx: params.slTriggerPx,
+                            triggerPx: (0, number_1.removeTrailingZeros)(params.slTriggerPx),
                             tpsl: 'sl',
                         }
                     }
@@ -371,8 +378,8 @@ class ExchangeClient {
                 order: {
                     a: yield this.symbolConversion.getAssetIndex(params.coin),
                     b: params.isBuy,
-                    p: params.limitPx,
-                    s: params.sz,
+                    p: (0, number_1.removeTrailingZeros)(params.limitPx),
+                    s: (0, number_1.removeTrailingZeros)(params.sz),
                     r: params.reduceOnly || false,
                     t: params.orderType || { limit: { tif: 'Gtc' } },
                 },
@@ -469,19 +476,17 @@ class ExchangeClient {
         const action = {
             type: constants_1.ExchangeType.APPROVE_BUILDER_FEE,
             hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
-            signatureChainId: this.isTestnet ? '0x66eee' : '0x42161',
+            signatureChainId: this.isTestnet ? '0x66eee' : '0xa4b1',
+            maxFeeRate: params.maxFee || '0.1%',
             builder: params.builder.toLowerCase(),
-            maxFee: params.maxFee || '0.1%',
             nonce,
         };
         const { domain, types, primaryType, message } = (0, signer_1.prepareMasterSignData)({
             action,
             payloadTypes: [
-                { name: 'type', type: 'string' },
                 { name: 'hyperliquidChain', type: 'string' },
-                { name: 'signatureChainId', type: 'string' },
-                { name: 'builder', type: 'string' },
-                { name: 'maxFee', type: 'string' },
+                { name: 'maxFeeRate', type: 'string' },
+                { name: 'builder', type: 'address' },
                 { name: 'nonce', type: 'uint64' },
             ],
             primaryType: 'HyperliquidTransaction:ApproveBuilderFee',
@@ -502,10 +507,11 @@ class ExchangeClient {
      */
     sendApproveBuilderFee(params) {
         return __awaiter(this, void 0, void 0, function* () {
+            const splitSignature = (0, signer_1.splitSig)(params.signature);
             return this.httpClient.exchange({
                 action: params.action,
                 nonce: params.nonce,
-                signature: params.signature,
+                signature: splitSignature,
             });
         });
     }
@@ -517,17 +523,15 @@ class ExchangeClient {
         const action = {
             type: constants_1.ExchangeType.WITHDRAW,
             hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
-            signatureChainId: this.isTestnet ? '0x66eee' : '0x42161',
+            signatureChainId: this.isTestnet ? '0x66eee' : '0xa4b1',
             destination: params.destination,
             amount: params.amount,
-            time: Date.now(),
+            time: nonce,
         };
         const { domain, types, primaryType, message } = (0, signer_1.prepareMasterSignData)({
             action,
             payloadTypes: [
-                { name: 'type', type: 'string' },
                 { name: 'hyperliquidChain', type: 'string' },
-                { name: 'signatureChainId', type: 'string' },
                 { name: 'destination', type: 'string' },
                 { name: 'amount', type: 'string' },
                 { name: 'time', type: 'uint64' },
@@ -544,10 +548,11 @@ class ExchangeClient {
         };
     }
     sendWithdraw(params) {
+        const splitSignature = (0, signer_1.splitSig)(params.signature);
         return this.httpClient.exchange({
             action: params.action,
             nonce: params.nonce,
-            signature: params.signature,
+            signature: splitSignature,
         });
     }
 }

package/dist/client/http-client.js

@@ -41,7 +41,7 @@ class HttpClient {
                     throw new Error(`HTTP ${response.status}: ${response.statusText}`);
                 }
                 const result = yield response.json();
-                if (result.status === 'error') {
+                if (result.status === 'error' || result.status === 'fail' || result.status === 'err') {
                     throw new Error(JSON.stringify(result.response));
                 }
                 return result;

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

@@ -1,8 +1,8 @@
-import type { Meta, AssetCtx, ClearinghouseState, UserFills, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse } from '../types';
+import type { Meta, AssetCtx, ClearinghouseState, UserFills, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse, UserNonFundingLedgerUpdates, UserHistoricalOrders } from '../types';
 export interface InfoClientConfig {
     isTestnet?: boolean;
     timeout?: number;
-    masterAddress: string;
+    masterAddress?: string;
 }
 /**
  * Client for querying Hyperliquid info endpoints (perpetuals only)
@@ -10,31 +10,39 @@ export interface InfoClientConfig {
  */
 export declare class InfoClient {
     private readonly httpClient;
-    private readonly masterAddress;
+    private masterAddress?;
+    private metaAndAssetCtxsCache;
+    private metaAndAssetCtxsInFlight;
     constructor(config: InfoClientConfig);
     /**
      * Get all mid prices for all assets
      */
     getAllMids(): Promise<AllMids>;
+    initMasterAddress(masterAddress: string): void;
     /**
      * Get metadata and asset contexts
      */
-    metaAndAssetCtxs(): Promise<[Meta, AssetCtx[]]>;
+    metaAndAssetCtxs(canUseCache?: boolean): Promise<[Meta, AssetCtx[]]>;
     getClearingHouseState(address?: string): Promise<ClearinghouseState>;
     getFrontendOpenOrders(address?: string): Promise<OpenOrder[]>;
+    getUserNonFundingLedgerUpdates(address?: string, startTime?: number, endTime?: number): Promise<UserNonFundingLedgerUpdates[]>;
     /**
      * Get user's fill history
      */
-    getUserFills(address?: string): Promise<UserFills>;
+    getUserFills(address?: string, aggregateByTime?: boolean): Promise<UserFills>;
+    /**
+   * Get user's fill and cancel and other all orders history
+   */
+    getUserHistoricalOrders(address?: string, startTime?: number, endTime?: number): Promise<UserHistoricalOrders[]>;
     /**
      * Get candlestick data snapshot
      * Supported intervals: "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"
      */
-    candleSnapshot(coin: string, interval: string, startTime?: number, endTime?: number): Promise<CandleSnapshot>;
+    candleSnapshot(coin: string, interval: string, startTime: number, endTime: number): Promise<CandleSnapshot>;
     /**
-     * Check builder fee approval status
+     * Check max builder fee
      */
-    checkBuilderFeeApproval(builder: string, address?: string): Promise<any>;
+    getMaxBuilderFee(builder: string, address?: string): Promise<number>;
     /**
      * Get user role
      */

package/dist/client/info-client.js

@@ -18,6 +18,8 @@ const constants_1 = require("../types/constants");
  */
 class InfoClient {
     constructor(config) {
+        this.metaAndAssetCtxsCache = null;
+        this.metaAndAssetCtxsInFlight = null;
         this.masterAddress = config.masterAddress;
         this.httpClient = new http_client_1.HttpClient({
             isTestnet: config.isTestnet,
@@ -34,30 +36,58 @@ class InfoClient {
             });
         });
     }
+    initMasterAddress(masterAddress) {
+        this.masterAddress = masterAddress;
+    }
     /**
      * Get metadata and asset contexts
      */
     metaAndAssetCtxs() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.httpClient.info({
-                type: constants_1.InfoType.META_AND_ASSET_CTXS,
-            });
+        return __awaiter(this, arguments, void 0, function* (canUseCache = true) {
+            if (canUseCache && this.metaAndAssetCtxsCache) {
+                return this.metaAndAssetCtxsCache;
+            }
+            // De-duplicate concurrent requests
+            if (this.metaAndAssetCtxsInFlight) {
+                return this.metaAndAssetCtxsInFlight;
+            }
+            this.metaAndAssetCtxsInFlight = (() => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const [meta, assetCtxs] = yield this.httpClient.info({
+                        type: constants_1.InfoType.META_AND_ASSET_CTXS,
+                    });
+                    this.metaAndAssetCtxsCache = [meta, assetCtxs];
+                    return [meta, assetCtxs];
+                }
+                finally {
+                    this.metaAndAssetCtxsInFlight = null;
+                }
+            }))();
+            return this.metaAndAssetCtxsInFlight;
         });
     }
     getClearingHouseState(address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             return this.httpClient.info({
                 type: constants_1.InfoType.CLEARINGHOUSE_STATE,
-                user: address || this.masterAddress,
+                user,
             });
         });
     }
     // frontendOpenOrders
     getFrontendOpenOrders(address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             return this.httpClient.info({
                 type: constants_1.InfoType.FRONTEND_OPEN_ORDERS,
-                user: address || this.masterAddress,
+                user,
             });
         });
     }
@@ -68,14 +98,50 @@ class InfoClient {
     //       user: this.masterAddress,
     //     });
     //   }
+    getUserNonFundingLedgerUpdates(address, startTime, endTime) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
+            return this.httpClient.info({
+                type: constants_1.InfoType.USER_NON_FUNDING_LEDGER_UPDATES,
+                user,
+                startTime: startTime || 0,
+                endTime,
+            });
+        });
+    }
     /**
      * Get user's fill history
      */
-    getUserFills(address) {
+    getUserFills(address, aggregateByTime) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             return this.httpClient.info({
                 type: constants_1.InfoType.USER_FILLS,
-                user: address || this.masterAddress,
+                user,
+                aggregateByTime: aggregateByTime || true,
+            });
+        });
+    }
+    /**
+   * Get user's fill and cancel and other all orders history
+   */
+    getUserHistoricalOrders(address, startTime, endTime) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
+            return this.httpClient.info({
+                type: constants_1.InfoType.USER_HISTORICAL_ORDERS,
+                user,
+                startTime: startTime || 0,
+                endTime,
             });
         });
     }
@@ -87,26 +153,29 @@ class InfoClient {
         return __awaiter(this, void 0, void 0, function* () {
             // if no time range is specified, default to 24 hours ago 
             const now = Date.now();
-            const defaultStartTime = now - 24 * 60 * 60 * 1000; // 24 hours ago
             return this.httpClient.info({
                 type: constants_1.InfoType.CANDLES_SNAPSHOT,
                 req: {
                     coin,
                     interval,
-                    startTime: startTime || defaultStartTime,
-                    endTime: endTime || now,
+                    startTime: startTime,
+                    endTime: endTime !== null && endTime !== void 0 ? endTime : now,
                 },
             });
         });
     }
     /**
-     * Check builder fee approval status
+     * Check max builder fee
      */
-    checkBuilderFeeApproval(builder, address) {
+    getMaxBuilderFee(builder, address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             return this.httpClient.info({
-                type: constants_1.InfoType.CHECK_BUILDER_FEE_APPROVAL,
-                user: address || this.masterAddress,
+                type: constants_1.InfoType.MAX_BUILDER_FEE,
+                user,
                 builder,
             });
         });
@@ -116,9 +185,13 @@ class InfoClient {
      */
     getUserRole(address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             const res = yield this.httpClient.info({
                 type: constants_1.InfoType.USER_ROLE,
-                user: address || this.masterAddress,
+                user,
             });
             return res;
         });
@@ -128,9 +201,13 @@ class InfoClient {
      */
     getUsersFees(address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             const res = yield this.httpClient.info({
                 type: constants_1.InfoType.USER_FEES,
-                user: address || this.masterAddress,
+                user,
             });
             // const perpFee = Number(res.userCrossRate) * (1 - Number(res.activeReferralDiscount));
             return res;
@@ -141,9 +218,13 @@ class InfoClient {
      */
     extraAgents(address) {
         return __awaiter(this, void 0, void 0, function* () {
+            const user = address || this.masterAddress;
+            if (!user) {
+                throw new Error('user address is empty');
+            }
             return this.httpClient.info({
                 type: constants_1.InfoType.EXTRA_AGENTS,
-                user: address || this.masterAddress,
+                user,
             });
         });
     }

package/dist/client/symbolConversion.d.ts

@@ -1,9 +1,11 @@
 import { HttpClientConfig } from "./http-client";
+import { InfoClient } from "./info-client";
 export declare class SymbolConversion {
     private assetToIndexMap;
     private httpClient;
     private initialized;
-    constructor(config: HttpClientConfig);
+    private infoClient?;
+    constructor(config: HttpClientConfig, infoClient?: InfoClient);
     initialize(): Promise<void>;
     private ensureInitialized;
     private refreshAssetMaps;

package/dist/client/symbolConversion.js

@@ -13,9 +13,10 @@ exports.SymbolConversion = void 0;
 const constants_1 = require("../types/constants");
 const http_client_1 = require("./http-client");
 class SymbolConversion {
-    constructor(config) {
+    constructor(config, infoClient) {
         this.assetToIndexMap = new Map();
         this.initialized = false;
+        this.infoClient = infoClient;
         this.httpClient = new http_client_1.HttpClient({
             isTestnet: config.isTestnet,
             timeout: config.timeout,
@@ -46,9 +47,15 @@ class SymbolConversion {
     refreshAssetMaps() {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const perpMeta = yield this.httpClient.info({
-                    type: constants_1.InfoType.META_AND_ASSET_CTXS,
-                });
+                let perpMeta = null;
+                if (!this.infoClient) {
+                    perpMeta = yield this.httpClient.info({
+                        type: constants_1.InfoType.META_AND_ASSET_CTXS,
+                    });
+                }
+                else {
+                    perpMeta = yield this.infoClient.metaAndAssetCtxs(false);
+                }
                 // Verify responses are valid before proceeding
                 if (!perpMeta ||
                     !perpMeta[0] ||

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

@@ -1,6 +1,6 @@
-import type { AllMids, L2Book, Candle, WsFill, WsOrder, WebData2 } from '../types';
+import type { AllMids, L2Book, Candle, WsOrder, WebData2, WsActiveAssetCtx, WsUserFills } from '../types';
 export interface WebSocketClientConfig {
-    masterAddress: string;
+    masterAddress?: string;
     isTestnet?: boolean;
     autoReconnect?: boolean;
     reconnectDelay?: number;
@@ -18,11 +18,11 @@ export declare class WebSocketClient {
     private readonly url;
     private readonly config;
     private subscriptions;
-    private subscriptionId;
     private reconnectAttempts;
     private isConnecting;
     private pendingSubscriptions;
     constructor(config: WebSocketClientConfig);
+    initMasterAddress(masterAddress: string): void;
     /**
      * Connect to the WebSocket
      */
@@ -43,6 +43,10 @@ export declare class WebSocketClient {
      * Subscribe to L2 order book for a specific coin
      */
     subscribeToL2Book(coin: string, callback: SubscriptionCallback<L2Book>): Subscription;
+    /**
+     * Subscribe to active asset ctx
+     */
+    subscribeToActiveAssetCtx(coin: string, callback: SubscriptionCallback<WsActiveAssetCtx>): Subscription;
     /**
      * Subscribe to trades for a specific coin
      */
@@ -54,7 +58,7 @@ export declare class WebSocketClient {
     /**
      * Subscribe to user fills
      */
-    subscribeToUserFills(callback: SubscriptionCallback<WsFill[]>): Subscription;
+    subscribeToUserFills(callback: SubscriptionCallback<WsUserFills>): Subscription;
     /**
      * Subscribe to user order updates
      */

package/dist/client/websocket-client.js

@@ -18,13 +18,21 @@ class WebSocketClient {
     constructor(config) {
         this.ws = null;
         this.subscriptions = new Map();
-        this.subscriptionId = 0;
         this.reconnectAttempts = 0;
         this.isConnecting = false;
         this.pendingSubscriptions = [];
-        this.config = Object.assign({ isTestnet: false, autoReconnect: true, reconnectDelay: 3000, maxReconnectAttempts: 5 }, config);
+        this.config = {
+            isTestnet: false,
+            autoReconnect: true,
+            reconnectDelay: 3000,
+            maxReconnectAttempts: 5,
+            masterAddress: config.masterAddress || '',
+        };
         this.url = this.config.isTestnet ? constants_1.WSS_URLS.TESTNET : constants_1.WSS_URLS.PRODUCTION;
     }
+    initMasterAddress(masterAddress) {
+        this.config.masterAddress = masterAddress;
+    }
     /**
      * Connect to the WebSocket
      */
@@ -57,13 +65,13 @@ class WebSocketClient {
                 this.ws.onopen = () => {
                     this.isConnecting = false;
                     this.reconnectAttempts = 0;
-                    console.log('WebSocket connected');
+                    console.log('hyperliquid sdk WebSocket connected');
                     // Resubscribe to pending subscriptions
-                    this.pendingSubscriptions.forEach(({ id, message, callback }) => {
+                    this.pendingSubscriptions.forEach(({ message, callback }) => {
                         var _a;
-                        this.subscriptions.set(id, callback);
                         if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-                            this.ws.send(JSON.stringify(message));
+                            this.subscriptions.set(message.subscription.type, callback);
+                            this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'subscribe' })));
                         }
                     });
                     this.pendingSubscriptions = [];
@@ -72,12 +80,10 @@ class WebSocketClient {
                 this.ws.onmessage = (event) => {
                     try {
                         const data = JSON.parse(event.data);
-                        if (data.method === 'subscription') {
-                            const subscriptionId = data.subscription;
-                            const callback = this.subscriptions.get(subscriptionId);
-                            if (callback) {
-                                callback(data.data);
-                            }
+                        const type = data.channel;
+                        const callback = this.subscriptions.get(type);
+                        if (callback) {
+                            callback(data.data);
                         }
                     }
                     catch (error) {
@@ -85,9 +91,10 @@ class WebSocketClient {
                     }
                 };
                 this.ws.onclose = () => {
+                    var _a;
                     this.isConnecting = false;
                     console.log('WebSocket disconnected');
-                    if (this.config.autoReconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {
+                    if (this.config.autoReconnect && this.reconnectAttempts < this.config.maxReconnectAttempts && ((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
                         this.reconnectAttempts++;
                         console.log(`Reconnecting... (${this.reconnectAttempts}/${this.config.maxReconnectAttempts})`);
                         setTimeout(() => this.connect(), this.config.reconnectDelay);
@@ -117,15 +124,13 @@ class WebSocketClient {
      */
     subscribe(message, callback) {
         var _a;
-        const id = ++this.subscriptionId;
-        const subscriptionMessage = Object.assign(Object.assign({}, message), { id });
         if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-            this.subscriptions.set(id, callback);
-            this.ws.send(JSON.stringify(Object.assign(Object.assign({}, subscriptionMessage), { method: 'subscribe' })));
+            this.subscriptions.set(message.subscription.type, callback);
+            this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'subscribe' })));
         }
         else {
             // Store pending subscription for when connection is established
-            this.pendingSubscriptions.push({ id, message: subscriptionMessage, callback });
+            this.pendingSubscriptions.push({ message, callback });
             // Auto-connect if not connected
             if (!this.isConnecting && (!this.ws || this.ws.readyState === WebSocket.CLOSED)) {
                 this.connect().catch(console.error);
@@ -134,12 +139,12 @@ class WebSocketClient {
         return {
             unsubscribe: () => {
                 var _a;
-                this.subscriptions.delete(id);
+                this.subscriptions.delete(message.subscription.type);
                 if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-                    this.ws.send(JSON.stringify(Object.assign(Object.assign({}, subscriptionMessage), { method: 'unsubscribe' })));
+                    this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'unsubscribe' })));
                 }
                 // Remove from pending subscriptions
-                this.pendingSubscriptions = this.pendingSubscriptions.filter(sub => sub.id !== id);
+                this.pendingSubscriptions = this.pendingSubscriptions.filter(sub => sub.message.subscription.type !== message.subscription.type);
             },
         };
     }
@@ -159,6 +164,14 @@ class WebSocketClient {
             subscription: { type: 'l2Book', coin },
         }, callback);
     }
+    /**
+     * Subscribe to active asset ctx
+     */
+    subscribeToActiveAssetCtx(coin, callback) {
+        return this.subscribe({
+            subscription: { type: 'activeAssetCtx', coin },
+        }, callback);
+    }
     /**
      * Subscribe to trades for a specific coin
      */
@@ -179,22 +192,31 @@ class WebSocketClient {
      * Subscribe to user fills
      */
     subscribeToUserFills(callback) {
+        if (!this.config.masterAddress) {
+            throw new Error('masterAddress is empty');
+        }
         return this.subscribe({
-            subscription: { type: 'userFills', user: this.config.masterAddress },
+            subscription: { type: 'userFills', user: this.config.masterAddress, aggregateByTime: true },
         }, callback);
     }
     /**
      * Subscribe to user order updates
      */
     subscribeToUserOrders(callback) {
+        if (!this.config.masterAddress) {
+            throw new Error('masterAddress is empty');
+        }
         return this.subscribe({
-            subscription: { type: 'userEvents', user: this.config.masterAddress },
+            subscription: { type: 'orderUpdates', user: this.config.masterAddress },
         }, callback);
     }
     /**
      * Subscribe to user funding updates
      */
     subscribeToUserFunding(callback) {
+        if (!this.config.masterAddress) {
+            throw new Error('masterAddress is empty');
+        }
         return this.subscribe({
             subscription: { type: 'userFundings', user: this.config.masterAddress },
         }, callback);
@@ -204,6 +226,9 @@ class WebSocketClient {
      * Includes positions, margin summary, open orders, and other user data
      */
     subscribeToWebData2(callback) {
+        if (!this.config.masterAddress) {
+            throw new Error('masterAddress is empty');
+        }
         return this.subscribe({
             subscription: { type: 'webData2', user: this.config.masterAddress },
         }, callback);

package/dist/hyperliquid-sdk.d.ts

@@ -4,7 +4,7 @@ import type { ClearinghouseState } from './types';
 import { WebSocketClient, WebSocketClientConfig } from './client/websocket-client';
 import { SymbolConversion } from './client/symbolConversion';
 export interface HyperliquidSDKConfig {
-    masterAddress: string;
+    masterAddress?: string;
     agentPrivateKey?: string;
     agentPublicKey?: string;
     agentName?: string;
@@ -22,14 +22,14 @@ export declare class HyperliquidSDK {
     exchange?: ExchangeClient;
     symbolConversion: SymbolConversion;
     readonly ws: WebSocketClient;
-    private readonly masterAddress;
+    private readonly masterAddress?;
     private readonly configParams;
     constructor(config: HyperliquidSDKConfig);
     /**
      * Get wallet address (only available if private key was provided)
      */
     get address(): string;
-    updateExchangeAgent(agentPrivateKey: string, agentPublicKey: string, agentName?: string): void;
+    initAccount(masterAddress: string, agentPrivateKey: string, agentPublicKey: string, agentName?: string): void;
     /**
      * Connect to WebSocket for real-time data
      */
@@ -46,8 +46,4 @@ export declare class HyperliquidSDK {
      * Quick helper: Get account summary with essential info
      */
     getAccountSummary(): Promise<ClearinghouseState>;
-    /**
-     * Quick helper: Get market overview
-     */
-    getMarketOverview(): Promise<any>;
 }

package/dist/hyperliquid-sdk.js

@@ -21,20 +21,19 @@ const symbolConversion_1 = require("./client/symbolConversion");
  */
 class HyperliquidSDK {
     constructor(config) {
-        // Initialize info client (always available)
-        this.symbolConversion = new symbolConversion_1.SymbolConversion({
-            isTestnet: config.isTestnet,
-            timeout: config.timeout,
-        });
         this.info = new info_client_1.InfoClient({
             masterAddress: config.masterAddress,
             isTestnet: config.isTestnet,
             timeout: config.timeout,
         });
+        this.symbolConversion = new symbolConversion_1.SymbolConversion({
+            isTestnet: config.isTestnet,
+            timeout: config.timeout,
+        }, this.info);
         this.masterAddress = config.masterAddress;
         this.configParams = config;
         // Initialize exchange client only if private key is provided
-        if (config.agentPrivateKey) {
+        if (config.masterAddress) {
             this.exchange = new exchange_client_1.ExchangeClient({
                 masterAddress: config.masterAddress,
                 agentPrivateKey: config.agentPrivateKey,
@@ -52,12 +51,25 @@ class HyperliquidSDK {
      * Get wallet address (only available if private key was provided)
      */
     get address() {
-        return this.masterAddress;
+        return this.masterAddress || '';
     }
-    updateExchangeAgent(agentPrivateKey, agentPublicKey, agentName) {
-        this.exchange = new exchange_client_1.ExchangeClient(Object.assign(Object.assign({}, this.configParams), { symbolConversion: this.symbolConversion, agentPrivateKey,
-            agentPublicKey,
-            agentName }));
+    initAccount(masterAddress, agentPrivateKey, agentPublicKey, agentName) {
+        this.info.initMasterAddress(masterAddress);
+        this.ws.initMasterAddress(masterAddress);
+        if (this.exchange) {
+            this.exchange.initAccount(masterAddress, agentPrivateKey, agentPublicKey, agentName);
+        }
+        else {
+            this.exchange = new exchange_client_1.ExchangeClient({
+                masterAddress,
+                symbolConversion: this.symbolConversion,
+                agentPrivateKey,
+                agentPublicKey,
+                agentName,
+                isTestnet: this.configParams.isTestnet,
+                timeout: this.configParams.timeout,
+            });
+        }
     }
     /**
      * Connect to WebSocket for real-time data
@@ -87,18 +99,5 @@ class HyperliquidSDK {
             return this.info.getClearingHouseState();
         });
     }
-    /**
-     * Quick helper: Get market overview
-     */
-    getMarketOverview() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const [meta, assetCtxs] = yield this.info.metaAndAssetCtxs();
-            return {
-                assets: meta.universe,
-                assetContexts: assetCtxs,
-                marginTables: meta.marginTables,
-            };
-        });
-    }
 }
 exports.HyperliquidSDK = HyperliquidSDK;

package/dist/types/constants.d.ts

@@ -27,6 +27,8 @@ export declare enum ExchangeType {
 }
 export declare enum InfoType {
     ALL_MIDS = "allMids",
+    USER_NON_FUNDING_LEDGER_UPDATES = "userNonFundingLedgerUpdates",
+    USER_HISTORICAL_ORDERS = "historicalOrders",
     USER_OPEN_ORDERS = "openOrders",
     USER_FILLS = "userFills",
     USER_FILLS_BY_TIME = "userFillsByTime",
@@ -35,14 +37,13 @@ export declare enum InfoType {
     CANDLES_SNAPSHOT = "candleSnapshot",
     META_AND_ASSET_CTXS = "metaAndAssetCtxs",
     USER_FUNDING = "userFunding",
-    USER_NON_FUNDING_LEDGER_UPDATES = "userNonFundingLedgerUpdates",
     FUNDING_HISTORY = "fundingHistory",
     CLEARINGHOUSE_STATE = "clearinghouseState",
     META = "meta",
     FRONTEND_OPEN_ORDERS = "frontendOpenOrders",
     PREDICTED_FUNDINGS = "predictedFundings",
     ACTIVE_ASSET_DATA = "activeAssetData",
-    CHECK_BUILDER_FEE_APPROVAL = "checkBuilderFeeApproval",
+    MAX_BUILDER_FEE = "maxBuilderFee",
     USER_FEES = "userFees",
     USER_ROLE = "userRole",
     EXTRA_AGENTS = "extraAgents"

package/dist/types/constants.js

@@ -35,6 +35,8 @@ var ExchangeType;
 var InfoType;
 (function (InfoType) {
     InfoType["ALL_MIDS"] = "allMids";
+    InfoType["USER_NON_FUNDING_LEDGER_UPDATES"] = "userNonFundingLedgerUpdates";
+    InfoType["USER_HISTORICAL_ORDERS"] = "historicalOrders";
     InfoType["USER_OPEN_ORDERS"] = "openOrders";
     InfoType["USER_FILLS"] = "userFills";
     InfoType["USER_FILLS_BY_TIME"] = "userFillsByTime";
@@ -43,14 +45,13 @@ var InfoType;
     InfoType["CANDLES_SNAPSHOT"] = "candleSnapshot";
     InfoType["META_AND_ASSET_CTXS"] = "metaAndAssetCtxs";
     InfoType["USER_FUNDING"] = "userFunding";
-    InfoType["USER_NON_FUNDING_LEDGER_UPDATES"] = "userNonFundingLedgerUpdates";
     InfoType["FUNDING_HISTORY"] = "fundingHistory";
     InfoType["CLEARINGHOUSE_STATE"] = "clearinghouseState";
     InfoType["META"] = "meta";
     InfoType["FRONTEND_OPEN_ORDERS"] = "frontendOpenOrders";
     InfoType["PREDICTED_FUNDINGS"] = "predictedFundings";
     InfoType["ACTIVE_ASSET_DATA"] = "activeAssetData";
-    InfoType["CHECK_BUILDER_FEE_APPROVAL"] = "checkBuilderFeeApproval";
+    InfoType["MAX_BUILDER_FEE"] = "maxBuilderFee";
     InfoType["USER_FEES"] = "userFees";
     InfoType["USER_ROLE"] = "userRole";
     InfoType["EXTRA_AGENTS"] = "extraAgents";

package/dist/types/index.d.ts

@@ -4,6 +4,33 @@ export type TriggerType = 'tp' | 'sl';
 export type Side = 'A' | 'B';
 export type AssetId = number;
 export type OrderId = number;
+export interface MarketOverview {
+    assets: AssetInfo[];
+    assetContexts: AssetCtx[];
+    marginTables: [number, MarginTable][];
+}
+export interface UserHistoricalOrders {
+    order: {
+        coin: string;
+        side: Side;
+        limitPx: string;
+        sz: string;
+        oid: number;
+        timestamp: number;
+        triggerCondition: string;
+        isTrigger: boolean;
+        triggerPx: string;
+        children: any;
+        isPositionTpsl: boolean;
+        reduceOnly: boolean;
+        orderType: string;
+        origSz: string;
+        tif: string;
+        cloid: string | null;
+    };
+    status: string;
+    statusTimestamp: number;
+}
 export interface OpenOrder {
     coin: string;
     side: Side;
@@ -52,6 +79,7 @@ export type OrderType = LimitOrderType | MarketOrderType | StopOrderType;
 export interface AssetInfo {
     name: string;
     szDecimals: number;
+    marginTableId: number;
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
@@ -121,6 +149,24 @@ export interface UserFill {
 export type UserFills = {
     [asset: string]: UserFill[];
 };
+export type UserNonFundingLedgerUpdates = {
+    time: number;
+    hash: string;
+    delta: {
+        type: string;
+        usdc?: string;
+        vault?: string;
+        user?: string;
+        token?: string;
+        amount?: string;
+        requestedUsd?: string;
+        commission?: string;
+        closingCost?: string;
+        basis?: string;
+        netWithdrawnUsd?: string;
+        toPerp?: boolean;
+    };
+};
 export interface OrderResponse {
     status: 'ok';
     response: {
@@ -133,6 +179,7 @@ export interface OrderResponse {
                 filled?: {
                     totalSz: string;
                     avgPx: string;
+                    oid: number;
                 };
                 error?: string;
             }>;
@@ -185,6 +232,11 @@ export interface WsOrder {
     children?: WsOrder[];
     user: string;
 }
+export interface WsUserFills {
+    isSnapshot?: boolean;
+    user: string;
+    fills: WsFill[];
+}
 export interface WsFill {
     coin: string;
     px: string;
@@ -199,8 +251,14 @@ export interface WsFill {
     crossed: boolean;
     fee: string;
     tid: number;
+    liquidation?: {
+        liquidatedUser: string;
+        markPx: string;
+        method: string;
+    };
 }
 export interface AssetCtx {
+    dayBaseVlm: string;
     dayNtlVlm: string;
     funding: string;
     impactPxs: [string, string];
@@ -219,6 +277,18 @@ export interface L2Book {
     levels: [WsLevel[], WsLevel[]];
     time: number;
 }
+export interface WsActiveAssetCtx {
+    coin: string;
+    ctx: {
+        dayNtlVlm: string;
+        prevDayPx: string;
+        markPx: string;
+        midPx?: string;
+        funding: string;
+        openInterest: string;
+        oraclePx: string;
+    };
+}
 export interface Candle {
     t: number;
     T: number;

package/dist/utils/number.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Removes trailing zeros from a string representation of a number.
+ * This is useful when working with price and size fields directly.
+ *
+ * Hyperliquid API requires that price ('p') and size ('s') fields do not contain trailing zeros.
+ * For example, "12345.0" should be "12345" and "0.123450" should be "0.12345".
+ * This function ensures that all numeric string values are properly formatted.
+ *
+ * @param value - The string value to normalize
+ * @returns The normalized string without trailing zeros
+ */
+export declare function removeTrailingZeros(value: string): string;

package/dist/utils/number.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeTrailingZeros = removeTrailingZeros;
+/**
+ * Removes trailing zeros from a string representation of a number.
+ * This is useful when working with price and size fields directly.
+ *
+ * Hyperliquid API requires that price ('p') and size ('s') fields do not contain trailing zeros.
+ * For example, "12345.0" should be "12345" and "0.123450" should be "0.12345".
+ * This function ensures that all numeric string values are properly formatted.
+ *
+ * @param value - The string value to normalize
+ * @returns The normalized string without trailing zeros
+ */
+function removeTrailingZeros(value) {
+    if (!value.includes('.'))
+        return value;
+    const normalized = value.replace(/\.?0+$/, '');
+    if (normalized === '-0')
+        return '0';
+    return normalized;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rabby-wallet/hyperliquid-sdk",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.20",
   "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",