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

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>;
     /**
@@ -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,
@@ -517,5 +543,12 @@ class ExchangeClient {
             nonce,
         };
     }
+    sendWithdraw(params) {
+        return this.httpClient.exchange({
+            action: params.action,
+            nonce: params.nonce,
+            signature: params.signature,
+        });
+    }
 }
 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') {
+                    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,6 @@ export interface InfoClientConfig {
 export declare class InfoClient {
     private readonly httpClient;
     private readonly masterAddress;
-    private readonly symbolConversion;
     constructor(config: InfoClientConfig);
     /**
      * Get all mid prices for all assets
@@ -23,12 +20,13 @@ export declare class InfoClient {
      * Get metadata and asset contexts
      */
     metaAndAssetCtxs(): Promise<[Meta, AssetCtx[]]>;
-    getClearingHouseState(): Promise<ClearinghouseState>;
-    getFrontendOpenOrders(): Promise<OpenOrder[]>;
+    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 +35,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

@@ -23,7 +23,6 @@ class InfoClient {
             isTestnet: config.isTestnet,
             timeout: config.timeout,
         });
-        this.symbolConversion = config.symbolConversion;
     }
     /**
      * Get all mid prices for all assets
@@ -45,20 +44,20 @@ class InfoClient {
             });
         });
     }
-    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 +68,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 +112,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 +149,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/websocket-client.d.ts

@@ -1,12 +1,10 @@
 import type { AllMids, L2Book, Candle, WsFill, WsOrder, WebData2 } from '../types';
-import { SymbolConversion } from './symbolConversion';
 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 {
@@ -24,7 +22,6 @@ export declare class WebSocketClient {
     private reconnectAttempts;
     private isConnecting;
     private pendingSubscriptions;
-    private symbolConversion;
     constructor(config: WebSocketClientConfig);
     /**
      * Connect to the WebSocket

package/dist/client/websocket-client.js

@@ -24,7 +24,6 @@ class WebSocketClient {
         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

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

package/dist/hyperliquid-sdk.js

@@ -30,7 +30,6 @@ class HyperliquidSDK {
             masterAddress: config.masterAddress,
             isTestnet: config.isTestnet,
             timeout: config.timeout,
-            symbolConversion: this.symbolConversion,
         });
         this.masterAddress = config.masterAddress;
         this.configParams = config;
@@ -47,7 +46,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)

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

@@ -121,6 +121,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: {
@@ -274,12 +292,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.3",
   "description": "Simplified Hyperliquid Perpetuals Trading SDK for Frontend Applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",