@nktkas/hyperliquid 0.13.0 → 0.13.2

package/esm/src/clients/wallet.js

@@ -1,27 +1,29 @@
 import { sorters } from "../utils/key_sort.js";
 import { signL1Action, signUserSignedAction, } from "../utils/signing.js";
-// ———————————————Errors———————————————
+// ——————————————— Errors ———————————————
 /** Error thrown when the API returns an error response. */
 export class ApiRequestError extends Error {
     constructor(response) {
-        let message = "";
+        let message = "Cannot process API request";
         if (response.status === "err") {
-            message = response.response;
+            message += `: ${response.response}`;
         }
         else {
             if ("statuses" in response.response.data) {
-                message = response.response.data.statuses
+                const errors = response.response.data.statuses
                     .reduce((acc, status, index) => {
                     if (typeof status === "object" && "error" in status) {
-                        acc.push(`[${index}] ${status.error}`);
+                        acc.push(`Order ${index} failed: ${status.error}`);
                     }
                     return acc;
-                }, [])
-                    .join(", ");
+                }, []);
+                if (errors.length > 0) {
+                    message += `: ${errors.join(", ")}`;
+                }
             }
             else {
                 if (typeof response.response.data.status === "object" && "error" in response.response.data.status) {
-                    message = response.response.data.status.error;
+                    message += `: ${response.response.data.status.error}`;
                 }
             }
         }
@@ -35,7 +37,7 @@ export class ApiRequestError extends Error {
         this.name = "ApiRequestError";
     }
 }
-// ———————————————Client———————————————
+// ——————————————— Client ———————————————
 /**
  * Wallet client for interacting with the Hyperliquid API.
  * @typeParam T - The transport used to connect to the Hyperliquid API.
@@ -72,10 +74,9 @@ export class WalletClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      * import { createWalletClient, custom } from "viem";
-     * import { arbitrum } from "viem/chains";
      *
      * const [account] = await window.ethereum.request({ method: "eth_requestAccounts" });
-     * const wallet = createWalletClient({ account, chain: arbitrum, transport: custom(window.ethereum) });
+     * const wallet = createWalletClient({ account, transport: custom(window.ethereum) });
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
@@ -120,10 +121,10 @@ export class WalletClient {
      * Approve an agent to sign on behalf of the master or sub-accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -143,7 +144,7 @@ export class WalletClient {
             ...args,
             type: "approveAgent",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             nonce: args.nonce ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {
@@ -167,10 +168,10 @@ export class WalletClient {
      * Approve a max fee rate for a builder address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -190,7 +191,7 @@ export class WalletClient {
             ...args,
             type: "approveBuilderFee",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             nonce: args.nonce ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {
@@ -214,10 +215,10 @@ export class WalletClient {
      * Modify multiple orders.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {OrderResponseSuccess} Successful variant of {@link OrderResponse} without error statuses.
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -265,10 +266,10 @@ export class WalletClient {
      * Cancel order(s).
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CancelResponseSuccess} Successful variant of {@link CancelResponse} without error statuses.
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -301,13 +302,57 @@ export class WalletClient {
         return response;
     }
     /**
-     * Cancel order(s) by Client Order ID.
+     * Deposit into staking balance.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CancelResponseSuccess} Successful variant of {@link CancelResponse} without error statuses.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.cDeposit({ wei: 100000000 });
+     * ```
+     */
+    async cDeposit(args, signal) {
+        const action = {
+            ...args,
+            type: "cDeposit",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
+            nonce: args.nonce ?? Date.now(),
+        };
+        const signature = await signUserSignedAction(this.wallet, action, {
+            "HyperliquidTransaction:CDeposit": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "wei", type: "uint64" },
+                { name: "nonce", type: "uint64" },
+            ],
+        }, parseInt(action.signatureChainId, 16));
+        const request = {
+            action,
+            signature,
+            nonce: action.nonce,
+        };
+        const response = await this.transport.request("action", request, signal);
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Cancel order(s) by cloid.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -339,13 +384,58 @@ export class WalletClient {
         this._validateResponse(response);
         return response;
     }
+    /**
+     * Withdraw from staking balance.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#withdraw-from-staking
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.cWithdraw({ wei: 100000000 });
+     * ```
+     */
+    async cWithdraw(args, signal) {
+        const action = {
+            ...args,
+            type: "cWithdraw",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
+            nonce: args.nonce ?? Date.now(),
+        };
+        const signature = await signUserSignedAction(this.wallet, action, {
+            "HyperliquidTransaction:CWithdraw": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "wei", type: "uint64" },
+                { name: "nonce", type: "uint64" },
+            ],
+        }, parseInt(action.signatureChainId, 16));
+        const request = {
+            action,
+            signature,
+            nonce: action.nonce,
+        };
+        const response = await this.transport.request("action", request, signal);
+        this._validateResponse(response);
+        return response;
+    }
     /**
      * Create a sub-account.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CreateSubAccountResponse} Response for creating a sub-account.
+     * @returns Response for creating a sub-account.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -355,9 +445,7 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.createSubAccount({
-     *   name: "subAccountName",
-     * });
+     * const result = await client.createSubAccount({ name: "subAccountName" });
      * ```
      */
     async createSubAccount(args, signal) {
@@ -377,10 +465,10 @@ export class WalletClient {
      * Modify an order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -426,10 +514,10 @@ export class WalletClient {
      * Place an order(s).
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {OrderResponseSuccess} Successful variant of {@link OrderResponse} without error statuses.
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -478,10 +566,10 @@ export class WalletClient {
      * Schedule a time to cancel all open orders.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -491,9 +579,7 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.scheduleCancel({
-     *   time: Date.now() + 3600000, // Schedule cancellation 1 hour from now
-     * });
+     * const result = await client.scheduleCancel({ time: Date.now() + 3600000 });
      * ```
      */
     async scheduleCancel(args = {}, signal) {
@@ -514,9 +600,10 @@ export class WalletClient {
      * Set a referral code.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -526,9 +613,7 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.setReferrer({
-     *   code: "TEST",
-     * });
+     * const result = await client.setReferrer({ code: "TEST" });
      * ```
      */
     async setReferrer(args, signal) {
@@ -548,10 +633,10 @@ export class WalletClient {
      * Transfer a spot asset on L1 to another address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-spot-transfer | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-spot-transfer
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -573,7 +658,7 @@ export class WalletClient {
             ...args,
             type: "spotSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             time: args.time ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {
@@ -598,9 +683,10 @@ export class WalletClient {
      * Transfer between sub-accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -630,14 +716,64 @@ export class WalletClient {
         this._validateResponse(response);
         return response;
     }
+    /**
+     * Delegate or undelegate stake from a validator.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.tokenDelegate({
+     *   validator: "0x...",
+     *   isUndelegate: true,
+     *   wei: 100000000,
+     * });
+     * ```
+     */
+    async tokenDelegate(args, signal) {
+        const action = {
+            ...args,
+            type: "tokenDelegate",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
+            nonce: args.nonce ?? Date.now(),
+        };
+        const signature = await signUserSignedAction(this.wallet, action, {
+            "HyperliquidTransaction:TokenDelegate": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "validator", type: "address" },
+                { name: "wei", type: "uint64" },
+                { name: "isUndelegate", type: "bool" },
+                { name: "nonce", type: "uint64" },
+            ],
+        }, parseInt(action.signatureChainId, 16));
+        const request = {
+            action,
+            signature,
+            nonce: action.nonce,
+        };
+        const response = await this.transport.request("action", request, signal);
+        this._validateResponse(response);
+        return response;
+    }
     /**
      * Cancel a TWAP order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {TwapCancelResponseSuccess} Successful variant of {@link TwapCancelResponse} without error status.
+     * @returns Successful variant of {@link TwapCancelResponse} without error status.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -671,10 +807,10 @@ export class WalletClient {
      * Place a TWAP order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {TwapOrderResponseSuccess} Successful variant of {@link TwapOrderResponse} without error status.
+     * @returns Successful variant of {@link TwapOrderResponse} without error status.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -712,10 +848,10 @@ export class WalletClient {
      * Update isolated margin for a position.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -750,10 +886,10 @@ export class WalletClient {
      * Update leverage for cross or isolated margin.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -788,10 +924,10 @@ export class WalletClient {
      * Transfer funds between Spot and Perp accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -812,7 +948,7 @@ export class WalletClient {
             ...args,
             type: "usdClassTransfer",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             nonce: args.nonce ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {
@@ -836,10 +972,10 @@ export class WalletClient {
      * Transfer USDC on L1 to another address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -860,7 +996,7 @@ export class WalletClient {
             ...args,
             type: "usdSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             time: args.time ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {
@@ -881,13 +1017,13 @@ export class WalletClient {
         return response;
     }
     /**
-     * Transfer funds to/from a vault.
+     * Add or remove funds from a vault.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -921,10 +1057,10 @@ export class WalletClient {
      * Initiate a withdrawal request.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -945,7 +1081,7 @@ export class WalletClient {
             ...args,
             type: "withdraw3",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1"),
             time: args.time ?? Date.now(),
         };
         const signature = await signUserSignedAction(this.wallet, action, {

package/esm/src/transports/http/http_transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/http/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAM7B,QAAQ,EAAE,QAAQ;IAAS,YAAY,CAAC,EAAE,MAAM;IALnE;;;;OAIG;gBACgB,QAAQ,EAAE,QAAQ,EAAS,YAAY,CAAC,EAAE,MAAM,YAAA;CAItE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,2IAA2I;IAC3I,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAElF;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzF;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,iBAAiB,EAAE,oBAAoB;IACzE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtF,oDAAoD;IACpD,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,GAAG,UAAU,EAAE,MAAM,CAAC,CAItE;IAEF;;;OAGG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAQ1C;;;;;;;;OAQG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CA6CpH"}
+{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/http/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAM7B,QAAQ,EAAE,QAAQ;IAAS,YAAY,CAAC,EAAE,MAAM;IALnE;;;;OAIG;gBACgB,QAAQ,EAAE,QAAQ,EAAS,YAAY,CAAC,EAAE,MAAM,YAAA;CAOtE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,2IAA2I;IAC3I,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAElF;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzF;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,iBAAiB,EAAE,oBAAoB;IACzE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtF,oDAAoD;IACpD,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,GAAG,UAAU,EAAE,MAAM,CAAC,CAItE;IAEF;;;OAGG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAQ1C;;;;;;;;OAQG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CA6CpH"}

package/esm/src/transports/http/http_transport.js

@@ -11,7 +11,10 @@ export class HttpRequestError extends TransportError {
      * @param responseBody - The raw response body content, if available.
      */
     constructor(response, responseBody) {
-        super(`HTTP request failed. Status: ${response.status}. Body: ${responseBody}`);
+        let message = `HTTP request failed: status ${response.status}`;
+        if (responseBody)
+            message += `, body "${responseBody}"`;
+        super(message);
         Object.defineProperty(this, "response", {
             enumerable: true,
             configurable: true,

package/esm/src/transports/websocket/hyperliquid_event_target.d.ts

@@ -1,56 +1,62 @@
 import { TypedEventTarget } from "../../../deps/jsr.io/@derzade/typescript-event-target/1.1.1/mod.js";
+import type { TxDetails } from "../../types/explorer/common.js";
+import type { WsBlockDetails } from "../../types/subscriptions/common.js";
 /**
  * Base system events and dynamic channel events for Hyperliquid WebSocket API.
  */
 export interface HyperliquidEventMap {
-    /** Subscription created/removed event */
+    /** Subscription created/removed event. */
     subscriptionResponse: CustomEvent<{
-        /** Type of subscription operation */
+        /** Type of subscription operation. */
         method: "subscribe" | "unsubscribe";
-        /** Original subscription request */
+        /** Original subscription request. */
         subscription: unknown;
     }>;
-    /** Response to post request event */
+    /** Response to post request event. */
     post: CustomEvent<{
-        /** Unique request identifier */
+        /** Unique request identifier. */
         id: number;
-        /** Server response */
+        /** Server response. */
         response: 
-        /** Response containing requested information */
+        /** Response containing requested information. */
         {
-            /** Indicates that this is an informational response */
+            /** Indicates that this is an informational response. */
             type: "info";
-            /** Contains the information data */
+            /** Contains the information data. */
             payload: {
-                /** Type of information being returned */
+                /** Type of information being returned. */
                 type: string;
-                /** Information specific data */
+                /** Information specific data. */
                 data: unknown;
             };
         }
-        /** Response containing action result */
+        /** Response containing action result. */
          | {
-            /** Indicates that this is an action response */
+            /** Indicates that this is an action response. */
             type: "action";
-            /** Contains the action result data */
+            /** Contains the action result data. */
             payload: {
-                /** Response status indicating success or failure of the action */
+                /** Response status indicating success or failure of the action. */
                 status: "ok" | "err";
-                /** Success data or error message */
+                /** Success data or error message. */
                 response: {
-                    /** Type of operation */
+                    /** Type of operation. */
                     type: string;
-                    /** Specific data for the operation */
+                    /** Specific data for the operation. */
                     data?: unknown;
                 } | string;
             };
         };
     }>;
-    /** Error response for message event */
+    /** Error response for message event. */
     error: CustomEvent<string>;
-    /** Pong response event */
+    /** Pong response event. */
     pong: CustomEvent<undefined>;
-    /** Subscribed channel events */
+    /** Block explorer update event. */
+    _explorerBlock: CustomEvent<WsBlockDetails[]>;
+    /** Transaction explorer update event. */
+    _explorerTxs: CustomEvent<TxDetails[]>;
+    /** Subscribed channel event. */
     [key: string]: CustomEvent<unknown>;
 }
 /**