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

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

@@ -5,9 +5,9 @@ import type { OrderResponse, CancelResponse, ExchangeClientConfig, PlaceOrderPar
  */
 export declare class ExchangeClient {
     private readonly httpClient;
-    private agentPrivateKey;
-    private agentPublicKey;
-    private agentName;
+    private agentPrivateKey?;
+    private agentPublicKey?;
+    private agentName?;
     private readonly isTestnet;
     private readonly masterAddress;
     private builder?;
@@ -17,6 +17,8 @@ export declare class ExchangeClient {
      * Get the wallet address
      */
     get address(): string;
+    updateExchangeAgent(agentPrivateKey: string, agentPublicKey: string, agentName?: string): void;
+    private getAgentPrivateKey;
     updateBuilder(address: string, fee: number): Promise<any>;
     updateLeverage(params: UpdateLeverageParams): Promise<any>;
     /**
@@ -30,7 +32,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
      */
@@ -86,4 +88,5 @@ export declare class ExchangeClient {
      * Withdraw funds to L1 need use master wallet
      */
     prepareWithdraw(params: WithdrawParams): PrepareApproveBuilderFeeResult;
+    sendWithdraw(params: SendApproveParams): Promise<any>;
 }

package/dist/client/exchange-client.js

@@ -47,6 +47,7 @@ const ethUtil = __importStar(require("@ethereumjs/util"));
 const http_client_1 = require("./http-client");
 const constants_1 = require("../types/constants");
 const signer_1 = require("../utils/signer");
+const symbolConversion_1 = require("./symbolConversion");
 /**
  * Client for executing trades on Hyperliquid (perpetuals only)
  * Only includes essential trading APIs as specified
@@ -58,11 +59,25 @@ class ExchangeClient {
             isTestnet: config.isTestnet,
             timeout: config.timeout,
         });
-        this.agentPrivateKey = config.agentPrivateKey.startsWith('0x') ? config.agentPrivateKey : ethUtil.addHexPrefix(config.agentPrivateKey);
-        this.agentPublicKey = config.agentPublicKey.startsWith('0x') ? config.agentPublicKey : ethUtil.addHexPrefix(config.agentPublicKey);
-        this.agentName = config.agentName || 'Rabby';
+        if (!config.symbolConversion) {
+            this.symbolConversion = new symbolConversion_1.SymbolConversion({
+                isTestnet: config.isTestnet,
+                timeout: config.timeout,
+            });
+        }
+        else {
+            this.symbolConversion = config.symbolConversion;
+        }
+        if (config.agentPrivateKey) {
+            this.agentPrivateKey = config.agentPrivateKey.startsWith('0x') ? config.agentPrivateKey : ethUtil.addHexPrefix(config.agentPrivateKey);
+        }
+        if (config.agentPublicKey) {
+            this.agentPublicKey = config.agentPublicKey.startsWith('0x') ? config.agentPublicKey : ethUtil.addHexPrefix(config.agentPublicKey);
+        }
+        if (config.agentName) {
+            this.agentName = config.agentName;
+        }
         this.isTestnet = config.isTestnet || false;
-        this.symbolConversion = config.symbolConversion;
     }
     /**
      * Get the wallet address
@@ -70,6 +85,17 @@ class ExchangeClient {
     get address() {
         return this.masterAddress;
     }
+    updateExchangeAgent(agentPrivateKey, agentPublicKey, agentName) {
+        this.agentPrivateKey = agentPrivateKey.startsWith('0x') ? agentPrivateKey : ethUtil.addHexPrefix(agentPrivateKey);
+        this.agentPublicKey = agentPublicKey.startsWith('0x') ? agentPublicKey : ethUtil.addHexPrefix(agentPublicKey);
+        this.agentName = agentName || '';
+    }
+    getAgentPrivateKey() {
+        if (!this.agentPrivateKey) {
+            throw new Error('Agent private key is not set');
+        }
+        return this.agentPrivateKey;
+    }
     // 50 = '0.05%'
     updateBuilder(address, fee) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -91,7 +117,7 @@ class ExchangeClient {
                 isCross: params.isCross || false,
                 leverage: params.leverage,
             };
-            const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
                 action,
                 nonce,
@@ -124,7 +150,7 @@ class ExchangeClient {
                     f: this.builder.fee,
                 };
             }
-            const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
                 action,
                 nonce,
@@ -257,7 +283,7 @@ class ExchangeClient {
                     f: this.builder.fee,
                 };
             }
-            const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
                 action,
                 nonce,
@@ -326,7 +352,7 @@ class ExchangeClient {
                 type: constants_1.ExchangeType.CANCEL,
                 cancels: cancels,
             };
-            const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
                 action,
                 nonce,
@@ -355,7 +381,7 @@ class ExchangeClient {
                 type: constants_1.ExchangeType.MODIFY,
                 modifies: [modify],
             };
-            const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+            const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
             return this.httpClient.exchange({
                 action,
                 nonce,
@@ -374,7 +400,7 @@ class ExchangeClient {
                     type: constants_1.ExchangeType.SET_REFERRER,
                     code,
                 };
-                const signature = (0, signer_1.signL1AgentAction)(this.agentPrivateKey, action, this.isTestnet, nonce);
+                const signature = (0, signer_1.signL1AgentAction)(this.getAgentPrivateKey(), action, this.isTestnet, nonce);
                 return this.httpClient.exchange({
                     action,
                     nonce,
@@ -443,7 +469,7 @@ 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',
             builder: params.builder.toLowerCase(),
             maxFee: params.maxFee || '0.1%',
             nonce,
@@ -476,10 +502,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,
             });
         });
     }
@@ -491,7 +518,7 @@ 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(),
@@ -517,5 +544,13 @@ class ExchangeClient {
             nonce,
         };
     }
+    sendWithdraw(params) {
+        const splitSignature = (0, signer_1.splitSig)(params.signature);
+        return this.httpClient.exchange({
+            action: params.action,
+            nonce: params.nonce,
+            signature: splitSignature,
+        });
+    }
 }
 exports.ExchangeClient = ExchangeClient;

package/dist/client/http-client.js

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

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

@@ -1,10 +1,8 @@
-import type { Meta, AssetCtx, ClearinghouseState, UserFills, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse } from '../types';
-import { SymbolConversion } from './symbolConversion';
+import type { Meta, AssetCtx, ClearinghouseState, UserFills, CandleSnapshot, AllMids, ExtraAgent, OpenOrder, FeeResponse, UserNonFundingLedgerUpdates } from '../types';
 export interface InfoClientConfig {
     isTestnet?: boolean;
     timeout?: number;
     masterAddress: string;
-    symbolConversion: SymbolConversion;
 }
 /**
  * Client for querying Hyperliquid info endpoints (perpetuals only)
@@ -13,7 +11,8 @@ export interface InfoClientConfig {
 export declare class InfoClient {
     private readonly httpClient;
     private readonly masterAddress;
-    private readonly symbolConversion;
+    private metaAndAssetCtxsCache;
+    private metaAndAssetCtxsInFlight;
     constructor(config: InfoClientConfig);
     /**
      * Get all mid prices for all assets
@@ -22,13 +21,14 @@ export declare class InfoClient {
     /**
      * Get metadata and asset contexts
      */
-    metaAndAssetCtxs(): Promise<[Meta, AssetCtx[]]>;
-    getClearingHouseState(): Promise<ClearinghouseState>;
-    getFrontendOpenOrders(): Promise<OpenOrder[]>;
+    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(): Promise<UserFills>;
+    getUserFills(address?: string): Promise<UserFills>;
     /**
      * Get candlestick data snapshot
      * Supported intervals: "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"
@@ -37,13 +37,19 @@ export declare class InfoClient {
     /**
      * Check builder fee approval status
      */
-    checkBuilderFeeApproval(builder: string): Promise<any>;
+    checkBuilderFeeApproval(builder: string, address?: string): Promise<any>;
+    /**
+     * Get user role
+     */
+    getUserRole(address?: string): Promise<{
+        role: 'user' | 'agent' | 'vault' | 'subAccount' | 'missing';
+    }>;
     /**
      * Get user fees information
      */
-    getUsersFees(): Promise<FeeResponse>;
+    getUsersFees(address?: string): Promise<FeeResponse>;
     /**
      * Get user's approved persistent agents
      */
-    extraAgents(): Promise<ExtraAgent[]>;
+    extraAgents(address?: string): Promise<ExtraAgent[]>;
 }

package/dist/client/info-client.js

@@ -18,12 +18,13 @@ 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,
             timeout: config.timeout,
         });
-        this.symbolConversion = config.symbolConversion;
     }
     /**
      * Get all mid prices for all assets
@@ -39,26 +40,43 @@ class InfoClient {
      * 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() {
+    getClearingHouseState(address) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.httpClient.info({
                 type: constants_1.InfoType.CLEARINGHOUSE_STATE,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
             });
         });
     }
     // frontendOpenOrders
-    getFrontendOpenOrders() {
+    getFrontendOpenOrders(address) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.httpClient.info({
                 type: constants_1.InfoType.FRONTEND_OPEN_ORDERS,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
             });
         });
     }
@@ -69,14 +87,24 @@ class InfoClient {
     //       user: this.masterAddress,
     //     });
     //   }
+    getUserNonFundingLedgerUpdates(address, startTime, endTime) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.httpClient.info({
+                type: constants_1.InfoType.USER_NON_FUNDING_LEDGER_UPDATES,
+                user: address || this.masterAddress,
+                startTime: startTime || 0,
+                endTime,
+            });
+        });
+    }
     /**
      * Get user's fill history
      */
-    getUserFills() {
+    getUserFills(address) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.httpClient.info({
                 type: constants_1.InfoType.USER_FILLS,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
             });
         });
     }
@@ -103,23 +131,35 @@ class InfoClient {
     /**
      * Check builder fee approval status
      */
-    checkBuilderFeeApproval(builder) {
+    checkBuilderFeeApproval(builder, address) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.httpClient.info({
                 type: constants_1.InfoType.CHECK_BUILDER_FEE_APPROVAL,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
                 builder,
             });
         });
     }
+    /**
+     * Get user role
+     */
+    getUserRole(address) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.httpClient.info({
+                type: constants_1.InfoType.USER_ROLE,
+                user: address || this.masterAddress,
+            });
+            return res;
+        });
+    }
     /**
      * Get user fees information
      */
-    getUsersFees() {
+    getUsersFees(address) {
         return __awaiter(this, void 0, void 0, function* () {
             const res = yield this.httpClient.info({
                 type: constants_1.InfoType.USER_FEES,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
             });
             // const perpFee = Number(res.userCrossRate) * (1 - Number(res.activeReferralDiscount));
             return res;
@@ -128,11 +168,11 @@ class InfoClient {
     /**
      * Get user's approved persistent agents
      */
-    extraAgents() {
+    extraAgents(address) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.httpClient.info({
                 type: constants_1.InfoType.EXTRA_AGENTS,
-                user: this.masterAddress,
+                user: address || this.masterAddress,
             });
         });
     }

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,12 +1,10 @@
-import type { AllMids, L2Book, Candle, WsFill, WsOrder, WebData2 } from '../types';
-import { SymbolConversion } from './symbolConversion';
+import type { AllMids, L2Book, Candle, WsFill, WsOrder, WebData2, WsActiveAssetCtx } from '../types';
 export interface WebSocketClientConfig {
     masterAddress: string;
     isTestnet?: boolean;
     autoReconnect?: boolean;
     reconnectDelay?: number;
     maxReconnectAttempts?: number;
-    symbolConversion: SymbolConversion;
 }
 export type SubscriptionCallback<T = any> = (data: T) => void;
 export interface Subscription {
@@ -20,11 +18,9 @@ export declare class WebSocketClient {
     private readonly url;
     private readonly config;
     private subscriptions;
-    private subscriptionId;
     private reconnectAttempts;
     private isConnecting;
     private pendingSubscriptions;
-    private symbolConversion;
     constructor(config: WebSocketClientConfig);
     /**
      * Connect to the WebSocket
@@ -46,6 +42,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
      */

package/dist/client/websocket-client.js

@@ -18,13 +18,11 @@ 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.url = this.config.isTestnet ? constants_1.WSS_URLS.TESTNET : constants_1.WSS_URLS.PRODUCTION;
-        this.symbolConversion = config.symbolConversion;
     }
     /**
      * Connect to the WebSocket
@@ -58,13 +56,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 = [];
@@ -73,12 +71,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) {
@@ -118,15 +114,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);
@@ -135,12 +129,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);
             },
         };
     }
@@ -160,6 +154,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
      */
@@ -189,7 +191,7 @@ class WebSocketClient {
      */
     subscribeToUserOrders(callback) {
         return this.subscribe({
-            subscription: { type: 'userEvents', user: this.config.masterAddress },
+            subscription: { type: 'orderUpdates', user: this.config.masterAddress },
         }, callback);
     }
     /**

package/dist/hyperliquid-sdk.d.ts

@@ -29,7 +29,7 @@ export declare class HyperliquidSDK {
      * Get wallet address (only available if private key was provided)
      */
     get address(): string;
-    updateExchangeAgent(agentPrivateKey: string, agentPublicKey: string, agentName: string): void;
+    updateExchangeAgent(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,17 +21,15 @@ 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,
-            symbolConversion: this.symbolConversion,
         });
+        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
@@ -47,7 +45,7 @@ class HyperliquidSDK {
             });
         }
         // Initialize WebSocket client (full functionality preserved)
-        this.ws = new websocket_client_1.WebSocketClient(Object.assign({ masterAddress: config.masterAddress, isTestnet: config.isTestnet, symbolConversion: this.symbolConversion }, config.wsConfig));
+        this.ws = new websocket_client_1.WebSocketClient(Object.assign({ masterAddress: config.masterAddress, isTestnet: config.isTestnet }, config.wsConfig));
     }
     /**
      * Get wallet address (only available if private key was provided)
@@ -88,18 +86,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,7 @@ export declare enum ExchangeType {
 }
 export declare enum InfoType {
     ALL_MIDS = "allMids",
+    USER_NON_FUNDING_LEDGER_UPDATES = "userNonFundingLedgerUpdates",
     USER_OPEN_ORDERS = "openOrders",
     USER_FILLS = "userFills",
     USER_FILLS_BY_TIME = "userFillsByTime",
@@ -35,7 +36,6 @@ 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",
@@ -44,6 +44,7 @@ export declare enum InfoType {
     ACTIVE_ASSET_DATA = "activeAssetData",
     CHECK_BUILDER_FEE_APPROVAL = "checkBuilderFeeApproval",
     USER_FEES = "userFees",
+    USER_ROLE = "userRole",
     EXTRA_AGENTS = "extraAgents"
 }
 export declare enum OrderType {

package/dist/types/constants.js

@@ -35,6 +35,7 @@ var ExchangeType;
 var InfoType;
 (function (InfoType) {
     InfoType["ALL_MIDS"] = "allMids";
+    InfoType["USER_NON_FUNDING_LEDGER_UPDATES"] = "userNonFundingLedgerUpdates";
     InfoType["USER_OPEN_ORDERS"] = "openOrders";
     InfoType["USER_FILLS"] = "userFills";
     InfoType["USER_FILLS_BY_TIME"] = "userFillsByTime";
@@ -43,7 +44,6 @@ 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";
@@ -52,6 +52,7 @@ var InfoType;
     InfoType["ACTIVE_ASSET_DATA"] = "activeAssetData";
     InfoType["CHECK_BUILDER_FEE_APPROVAL"] = "checkBuilderFeeApproval";
     InfoType["USER_FEES"] = "userFees";
+    InfoType["USER_ROLE"] = "userRole";
     InfoType["EXTRA_AGENTS"] = "extraAgents";
 })(InfoType || (exports.InfoType = InfoType = {}));
 // Order types

package/dist/types/index.d.ts

@@ -4,6 +4,11 @@ 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 OpenOrder {
     coin: string;
     side: Side;
@@ -52,6 +57,7 @@ export type OrderType = LimitOrderType | MarketOrderType | StopOrderType;
 export interface AssetInfo {
     name: string;
     szDecimals: number;
+    marginTableId: number;
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
@@ -121,6 +127,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 +157,7 @@ export interface OrderResponse {
                 filled?: {
                     totalSz: string;
                     avgPx: string;
+                    oid: number;
                 };
                 error?: string;
             }>;
@@ -201,6 +226,7 @@ export interface WsFill {
     tid: number;
 }
 export interface AssetCtx {
+    dayBaseVlm: string;
     dayNtlVlm: string;
     funding: string;
     impactPxs: [string, string];
@@ -219,6 +245,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;
@@ -274,12 +312,12 @@ export interface ExtraAgent {
 }
 export interface ExchangeClientConfig {
     masterAddress: string;
-    agentPrivateKey: string;
-    agentPublicKey: string;
+    agentPrivateKey?: string;
+    agentPublicKey?: string;
     agentName?: string;
     isTestnet?: boolean;
     timeout?: number;
-    symbolConversion: SymbolConversion;
+    symbolConversion?: SymbolConversion;
 }
 export interface PlaceOrderParams {
     coin: string;

package/package.json

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