@rabby-wallet/hyperliquid-sdk 1.0.0-beta.17 → 1.0.0-beta.19

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

@@ -80,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
      */

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
      */
@@ -29,6 +30,10 @@ export declare class InfoClient {
      * Get user's fill history
      */
     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"

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,
             });
@@ -102,13 +117,34 @@ class InfoClient {
      */
     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,
+            });
+        });
+    }
     /**
      * Get candlestick data snapshot
      * Supported intervals: "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"
@@ -134,9 +170,13 @@ class InfoClient {
      */
     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.MAX_BUILDER_FEE,
-                user: address || this.masterAddress,
+                user,
                 builder,
             });
         });
@@ -146,9 +186,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;
         });
@@ -158,9 +202,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;
@@ -171,9 +219,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, WsOrder, WebData2, WsActiveAssetCtx, WsUserFills } from '../types';
 export interface WebSocketClientConfig {
-    masterAddress: string;
+    masterAddress?: string;
     isTestnet?: boolean;
     autoReconnect?: boolean;
     reconnectDelay?: number;
@@ -22,6 +22,7 @@ export declare class WebSocketClient {
     private isConnecting;
     private pendingSubscriptions;
     constructor(config: WebSocketClientConfig);
+    initMasterAddress(masterAddress: string): void;
     /**
      * Connect to the WebSocket
      */

package/dist/client/websocket-client.js

@@ -21,9 +21,18 @@ class WebSocketClient {
         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
      */
@@ -183,6 +192,9 @@ 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, aggregateByTime: true },
         }, callback);
@@ -191,6 +203,9 @@ class WebSocketClient {
      * 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);
@@ -199,6 +214,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);
@@ -208,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
      */

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",

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";

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;
@@ -229,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/package.json

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