@rabby-wallet/hyperliquid-sdk 1.0.0-beta.9 → 1.0.2

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
      */

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',
@@ -518,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' },

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, UserNonFundingLedgerUpdates } 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,7 +10,7 @@ export interface InfoClientConfig {
  */
 export declare class InfoClient {
     private readonly httpClient;
-    private readonly masterAddress;
+    private masterAddress?;
     private metaAndAssetCtxsCache;
     private metaAndAssetCtxsInFlight;
     constructor(config: InfoClientConfig);
@@ -18,6 +18,7 @@ export declare class InfoClient {
      * Get all mid prices for all assets
      */
     getAllMids(): Promise<AllMids>;
+    initMasterAddress(masterAddress: string): void;
     /**
      * Get metadata and asset contexts
      */
@@ -28,16 +29,20 @@ export declare class InfoClient {
     /**
      * 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

@@ -36,6 +36,9 @@ class InfoClient {
             });
         });
     }
+    initMasterAddress(masterAddress) {
+        this.masterAddress = masterAddress;
+    }
     /**
      * Get metadata and asset contexts
      */
@@ -65,18 +68,26 @@ class InfoClient {
     }
     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,
             });
         });
     }
@@ -89,9 +100,13 @@ class InfoClient {
     //   }
     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: address || this.masterAddress,
+                user,
                 startTime: startTime || 0,
                 endTime,
             });
@@ -100,11 +115,33 @@ class InfoClient {
     /**
      * 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,
             });
         });
     }
@@ -116,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,
             });
         });
@@ -145,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;
         });
@@ -157,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;
@@ -170,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/websocket-client.d.ts

@@ -1,6 +1,6 @@
-import type { AllMids, L2Book, Candle, WsFill, WsOrder, WebData2, WsActiveAssetCtx } 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,14 +18,27 @@ export declare class WebSocketClient {
     private readonly url;
     private readonly config;
     private subscriptions;
+    private activeSubscriptions;
     private reconnectAttempts;
     private isConnecting;
+    private isManualDisconnect;
     private pendingSubscriptions;
+    private heartbeatInterval;
+    private readonly HEARTBEAT_INTERVAL;
     constructor(config: WebSocketClientConfig);
+    initMasterAddress(masterAddress: string): void;
     /**
      * Connect to the WebSocket
      */
     connect(): Promise<void>;
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    private startHeartbeat;
+    /**
+     * Stop heartbeat
+     */
+    private stopHeartbeat;
     /**
      * Disconnect from the WebSocket
      */
@@ -57,7 +70,7 @@ export declare class WebSocketClient {
     /**
      * Subscribe to user fills
      */
-    subscribeToUserFills(callback: SubscriptionCallback<WsFill[]>): Subscription;
+    subscribeToUserFills(callback: SubscriptionCallback<WsUserFills>): Subscription;
     /**
      * Subscribe to user order updates
      */
@@ -79,4 +92,12 @@ export declare class WebSocketClient {
      * Get current connection state
      */
     get readyState(): number;
+    /**
+     * Get list of active subscription types
+     */
+    getActiveSubscriptions(): string[];
+    /**
+     * Reset reconnection attempts and enable auto-reconnect
+     */
+    resetReconnectState(): void;
 }

package/dist/client/websocket-client.js

@@ -18,12 +18,25 @@ class WebSocketClient {
     constructor(config) {
         this.ws = null;
         this.subscriptions = new Map();
+        this.activeSubscriptions = new Map();
         this.reconnectAttempts = 0;
         this.isConnecting = false;
+        this.isManualDisconnect = false; // 标记是否为主动断开连接
         this.pendingSubscriptions = [];
-        this.config = Object.assign({ isTestnet: false, autoReconnect: true, reconnectDelay: 3000, maxReconnectAttempts: 5 }, config);
+        this.heartbeatInterval = null;
+        this.HEARTBEAT_INTERVAL = 50000; // 50秒发送一次心跳，小于60秒超时
+        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
      */
@@ -56,21 +69,31 @@ class WebSocketClient {
                 this.ws.onopen = () => {
                     this.isConnecting = false;
                     this.reconnectAttempts = 0;
+                    this.isManualDisconnect = false; // 重置手动断开标志
                     console.log('hyperliquid sdk WebSocket connected');
+                    // Start heartbeat
+                    this.startHeartbeat();
                     // Resubscribe to pending subscriptions
                     this.pendingSubscriptions.forEach(({ message, callback }) => {
                         var _a;
                         if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
                             this.subscriptions.set(message.subscription.type, callback);
+                            this.activeSubscriptions.set(message.subscription.type, { message, callback });
                             this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'subscribe' })));
                         }
                     });
                     this.pendingSubscriptions = [];
+                    console.log(`Resubscribed to ${this.activeSubscriptions.size} channels after reconnection`);
                     resolve();
                 };
                 this.ws.onmessage = (event) => {
                     try {
                         const data = JSON.parse(event.data);
+                        // Handle pong response
+                        if (data.channel === 'pong') {
+                            // console.log('Received pong from server'); // 可以注释掉以减少日志输出
+                            return;
+                        }
                         const type = data.channel;
                         const callback = this.subscriptions.get(type);
                         if (callback) {
@@ -84,43 +107,91 @@ class WebSocketClient {
                 this.ws.onclose = () => {
                     this.isConnecting = false;
                     console.log('WebSocket disconnected');
-                    if (this.config.autoReconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {
-                        this.reconnectAttempts++;
-                        console.log(`Reconnecting... (${this.reconnectAttempts}/${this.config.maxReconnectAttempts})`);
-                        setTimeout(() => this.connect(), this.config.reconnectDelay);
+                    // Stop heartbeat
+                    this.stopHeartbeat();
+                    // Only attempt reconnection if it's not a manual disconnect
+                    if (!this.isManualDisconnect && this.config.autoReconnect) {
+                        // Save current active subscriptions to pending for reconnection
+                        if (this.activeSubscriptions.size > 0) {
+                            this.activeSubscriptions.forEach((subscription, type) => {
+                                const existingPending = this.pendingSubscriptions.find(sub => sub.message.subscription.type === type);
+                                if (!existingPending) {
+                                    this.pendingSubscriptions.push(subscription);
+                                }
+                            });
+                        }
+                        if (this.reconnectAttempts < this.config.maxReconnectAttempts) {
+                            this.reconnectAttempts++;
+                            console.log(`Reconnecting... (${this.reconnectAttempts}/${this.config.maxReconnectAttempts})`);
+                            setTimeout(() => this.connect(), this.config.reconnectDelay);
+                        }
+                        else {
+                            console.error('Max reconnection attempts reached. Connection failed.');
+                        }
+                    }
+                    else if (this.isManualDisconnect) {
+                        this.isManualDisconnect = false; // Reset flag
                     }
                 };
                 this.ws.onerror = (error) => {
                     this.isConnecting = false;
+                    this.stopHeartbeat();
                     console.error('WebSocket error:', error);
                     reject(error);
                 };
             });
         });
     }
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    startHeartbeat() {
+        this.stopHeartbeat(); // Clear any existing heartbeat
+        this.heartbeatInterval = setInterval(() => {
+            var _a;
+            if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({ method: 'ping' }));
+            }
+        }, this.HEARTBEAT_INTERVAL);
+    }
+    /**
+     * Stop heartbeat
+     */
+    stopHeartbeat() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+    }
     /**
      * Disconnect from the WebSocket
      */
     disconnect() {
+        this.isManualDisconnect = true; // 标记为主动断开
+        this.stopHeartbeat();
         if (this.ws) {
             this.ws.close();
             this.ws = null;
         }
         this.subscriptions.clear();
+        this.activeSubscriptions.clear();
         this.pendingSubscriptions = [];
+        this.reconnectAttempts = 0; // 重置重连计数
     }
     /**
      * Subscribe to a channel
      */
     subscribe(message, callback) {
         var _a;
+        const subscriptionData = { message, callback };
         if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
             this.subscriptions.set(message.subscription.type, callback);
+            this.activeSubscriptions.set(message.subscription.type, subscriptionData);
             this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'subscribe' })));
         }
         else {
             // Store pending subscription for when connection is established
-            this.pendingSubscriptions.push({ message, callback });
+            this.pendingSubscriptions.push(subscriptionData);
             // Auto-connect if not connected
             if (!this.isConnecting && (!this.ws || this.ws.readyState === WebSocket.CLOSED)) {
                 this.connect().catch(console.error);
@@ -129,12 +200,14 @@ class WebSocketClient {
         return {
             unsubscribe: () => {
                 var _a;
-                this.subscriptions.delete(message.subscription.type);
+                const type = message.subscription.type;
+                this.subscriptions.delete(type);
+                this.activeSubscriptions.delete(type);
                 if (((_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
                     this.ws.send(JSON.stringify(Object.assign(Object.assign({}, message), { method: 'unsubscribe' })));
                 }
                 // Remove from pending subscriptions
-                this.pendingSubscriptions = this.pendingSubscriptions.filter(sub => sub.message.subscription.type !== message.subscription.type);
+                this.pendingSubscriptions = this.pendingSubscriptions.filter(sub => sub.message.subscription.type !== type);
             },
         };
     }
@@ -182,14 +255,20 @@ 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: 'orderUpdates', user: this.config.masterAddress },
         }, callback);
@@ -198,6 +277,9 @@ class WebSocketClient {
      * 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);
@@ -207,6 +289,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);
@@ -225,5 +310,18 @@ class WebSocketClient {
         var _a, _b;
         return (_b = (_a = this.ws) === null || _a === void 0 ? void 0 : _a.readyState) !== null && _b !== void 0 ? _b : WebSocket.CLOSED;
     }
+    /**
+     * Get list of active subscription types
+     */
+    getActiveSubscriptions() {
+        return Array.from(this.activeSubscriptions.keys());
+    }
+    /**
+     * Reset reconnection attempts and enable auto-reconnect
+     */
+    resetReconnectState() {
+        this.reconnectAttempts = 0;
+        this.isManualDisconnect = false;
+    }
 }
 exports.WebSocketClient = WebSocketClient;

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
      */

package/dist/hyperliquid-sdk.js

@@ -33,7 +33,7 @@ class HyperliquidSDK {
         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,
@@ -51,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

package/dist/types/constants.d.ts

@@ -28,6 +28,7 @@ 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",
@@ -42,7 +43,7 @@ export declare enum InfoType {
     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

@@ -36,6 +36,7 @@ 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";
@@ -50,7 +51,7 @@ var InfoType;
     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

@@ -9,6 +9,28 @@ export interface MarketOverview {
     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;
@@ -210,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;
@@ -224,6 +251,11 @@ export interface WsFill {
     crossed: boolean;
     fee: string;
     tid: number;
+    liquidation?: {
+        liquidatedUser: string;
+        markPx: string;
+        method: string;
+    };
 }
 export interface AssetCtx {
     dayBaseVlm: string;

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.9",
+  "version": "1.0.2",
   "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",