@nktkas/hyperliquid 0.19.2 → 0.21.0

package/{esm/src/clients/wallet.d.ts → script/src/clients/exchange.d.ts}

@@ -1,9 +1,10 @@
-import { type Hex, HyperliquidError, type IRequestTransport, type MaybePromise } from "../base.js";
-import type { ApproveAgentRequest, ApproveBuilderFeeRequest, BatchModifyRequest, CancelByCloidRequest, CancelRequest, CDepositRequest, ConvertToMultiSigUserRequest_Signers, CreateSubAccountRequest, CreateVaultRequest, CSignerActionRequest_JailSelf, CSignerActionRequest_UnjailSelf, CValidatorActionRequest_ChangeProfile, CValidatorActionRequest_Register, CValidatorActionRequest_Unregister, CWithdrawRequest, EvmUserModifyRequest, ModifyRequest, MultiSigRequest, OrderRequest, PerpDeployRequest_RegisterAsset, PerpDeployRequest_SetOracle, PerpDexClassTransferRequest, RegisterReferrerRequest, ReserveRequestWeightRequest, ScheduleCancelRequest, SetDisplayNameRequest, SetReferrerRequest, SpotDeployRequest_Genesis, SpotDeployRequest_RegisterHyperliquidity, SpotDeployRequest_RegisterSpot, SpotDeployRequest_RegisterToken2, SpotDeployRequest_SetDeployerTradingFeeShare, SpotDeployRequest_UserGenesis, SpotSendRequest, SpotUserRequest, SubAccountSpotTransferRequest, SubAccountTransferRequest, TokenDelegateRequest, TwapCancelRequest, TwapOrderRequest, UpdateIsolatedMarginRequest, UpdateLeverageRequest, UsdClassTransferRequest, UsdSendRequest, VaultDistributeRequest, VaultModifyRequest, VaultTransferRequest, Withdraw3Request } from "../types/exchange/requests.js";
+import { type Hex, HyperliquidError, type MaybePromise } from "../base.js";
+import type { IRequestTransport } from "../transports/base.js";
+import type { ApproveAgentRequest, ApproveBuilderFeeRequest, BaseExchangeRequest, BatchModifyRequest, CancelByCloidRequest, CancelRequest, CDepositRequest, ConvertToMultiSigUserRequest_Signers, CreateSubAccountRequest, CreateVaultRequest, CSignerActionRequest_JailSelf, CSignerActionRequest_UnjailSelf, CValidatorActionRequest_ChangeProfile, CValidatorActionRequest_Register, CValidatorActionRequest_Unregister, CWithdrawRequest, EvmUserModifyRequest, ModifyRequest, MultiSigRequest, OrderRequest, PerpDeployRequest_RegisterAsset, PerpDeployRequest_SetOracle, PerpDexClassTransferRequest, RegisterReferrerRequest, ReserveRequestWeightRequest, ScheduleCancelRequest, SetDisplayNameRequest, SetReferrerRequest, SpotDeployRequest_Genesis, SpotDeployRequest_RegisterHyperliquidity, SpotDeployRequest_RegisterSpot, SpotDeployRequest_RegisterToken2, SpotDeployRequest_SetDeployerTradingFeeShare, SpotDeployRequest_UserGenesis, SpotSendRequest, SpotUserRequest, SubAccountSpotTransferRequest, SubAccountTransferRequest, TokenDelegateRequest, TwapCancelRequest, TwapOrderRequest, UpdateIsolatedMarginRequest, UpdateLeverageRequest, UsdClassTransferRequest, UsdSendRequest, VaultDistributeRequest, VaultModifyRequest, VaultTransferRequest, Withdraw3Request } from "../types/exchange/requests.js";
 import type { CancelResponse, CreateSubAccountResponse, CreateVaultResponse, ErrorResponse, OrderResponse, SuccessResponse, TwapCancelResponse, TwapOrderResponse } from "../types/exchange/responses.js";
 import { type AbstractWallet } from "../signing.js";
-/** Parameters for the {@linkcode WalletClient} constructor. */
-export interface WalletClientParameters<T extends IRequestTransport = IRequestTransport, W extends AbstractWallet = AbstractWallet> {
+/** Parameters for the {@linkcode ExchangeClient} constructor. */
+export interface ExchangeClientParameters<T extends IRequestTransport = IRequestTransport, W extends AbstractWallet = AbstractWallet> {
     /** The transport used to connect to the Hyperliquid API. */
     transport: T;
     /** The `viem`, `ethers.js`, or `window.ethereum` wallet used for signing transactions. */
@@ -32,112 +33,112 @@ export interface WalletClientParameters<T extends IRequestTransport = IRequestTr
      */
     nonceManager?: () => MaybePromise<number>;
 }
-/** Parameters for the {@linkcode WalletClient.approveAgent} method. */
+/** Parameters for the {@linkcode ExchangeClient.approveAgent} method. */
 export type ApproveAgentParameters = Omit<ApproveAgentRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.approveBuilderFee} method. */
+/** Parameters for the {@linkcode ExchangeClient.approveBuilderFee} method. */
 export type ApproveBuilderFeeParameters = Omit<ApproveBuilderFeeRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.batchModify} method. */
+/** Parameters for the {@linkcode ExchangeClient.batchModify} method. */
 export type BatchModifyParameters = Omit<BatchModifyRequest["action"], "type"> & Partial<Pick<BatchModifyRequest, "vaultAddress">> & Partial<Pick<BatchModifyRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.cancel} method. */
+/** Parameters for the {@linkcode ExchangeClient.cancel} method. */
 export type CancelParameters = Omit<CancelRequest["action"], "type"> & Partial<Pick<CancelRequest, "vaultAddress">> & Partial<Pick<CancelRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.cancelByCloid} method. */
+/** Parameters for the {@linkcode ExchangeClient.cancelByCloid} method. */
 export type CancelByCloidParameters = Omit<CancelByCloidRequest["action"], "type"> & Partial<Pick<CancelByCloidRequest, "vaultAddress">> & Partial<Pick<CancelByCloidRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.cDeposit} method. */
+/** Parameters for the {@linkcode ExchangeClient.cDeposit} method. */
 export type CDepositParameters = Omit<CDepositRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.convertToMultiSigUser} method. */
+/** Parameters for the {@linkcode ExchangeClient.convertToMultiSigUser} method. */
 export type ConvertToMultiSigUserParameters = NonNullable<ConvertToMultiSigUserRequest_Signers>;
-/** Parameters for the {@linkcode WalletClient.createSubAccount} method. */
+/** Parameters for the {@linkcode ExchangeClient.createSubAccount} method. */
 export type CreateSubAccountParameters = Omit<CreateSubAccountRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.createVault} method. */
+/** Parameters for the {@linkcode ExchangeClient.createVault} method. */
 export type CreateVaultParameters = Omit<CreateVaultRequest["action"], "type" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.cSignerAction} method. */
+/** Parameters for the {@linkcode ExchangeClient.cSignerAction} method. */
 export type CSignerActionParameters = CSignerActionParameters_JailSelf | CSignerActionParameters_UnjailSelf;
-/** One of the parameters for the {@linkcode WalletClient.cSignerAction} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.cSignerAction} method. */
 export type CSignerActionParameters_JailSelf = Omit<CSignerActionRequest_JailSelf["action"], "type"> & Partial<Pick<CSignerActionRequest_JailSelf, "expiresAfter">>;
-/** One of the parameters for the {@linkcode WalletClient.cSignerAction} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.cSignerAction} method. */
 export type CSignerActionParameters_UnjailSelf = Omit<CSignerActionRequest_UnjailSelf["action"], "type"> & Partial<Pick<CSignerActionRequest_UnjailSelf, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.cValidatorAction} method. */
+/** Parameters for the {@linkcode ExchangeClient.cValidatorAction} method. */
 export type CValidatorActionParameters = CValidatorActionParameters_ChangeProfile | CValidatorActionParameters_Register | CValidatorActionParameters_Unregister;
-/** One of the parameters for the {@linkcode WalletClient.cValidatorAction} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.cValidatorAction} method. */
 export type CValidatorActionParameters_ChangeProfile = Omit<CValidatorActionRequest_ChangeProfile["action"], "type"> & Partial<Pick<CValidatorActionRequest_ChangeProfile, "expiresAfter">>;
-/** One of the parameters for the {@linkcode WalletClient.cValidatorAction} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.cValidatorAction} method. */
 export type CValidatorActionParameters_Register = Omit<CValidatorActionRequest_Register["action"], "type"> & Partial<Pick<CValidatorActionRequest_Register, "expiresAfter">>;
-/** One of the parameters for the {@linkcode WalletClient.cValidatorAction} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.cValidatorAction} method. */
 export type CValidatorActionParameters_Unregister = Omit<CValidatorActionRequest_Unregister["action"], "type"> & Partial<Pick<CValidatorActionRequest_Unregister, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.cWithdraw} method. */
+/** Parameters for the {@linkcode ExchangeClient.cWithdraw} method. */
 export type CWithdrawParameters = Omit<CWithdrawRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.evmUserModify} method. */
+/** Parameters for the {@linkcode ExchangeClient.evmUserModify} method. */
 export type EvmUserModifyParameters = Omit<EvmUserModifyRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.modify} method. */
+/** Parameters for the {@linkcode ExchangeClient.modify} method. */
 export type ModifyParameters = Omit<ModifyRequest["action"], "type"> & Partial<Pick<ModifyRequest, "vaultAddress">> & Partial<Pick<ModifyRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.multiSig} method. */
+/** Parameters for the {@linkcode ExchangeClient.multiSig} method. */
 export type MultiSigParameters = Omit<MultiSigRequest["action"], "type" | "signatureChainId"> & Partial<Pick<MultiSigRequest, "vaultAddress">> & Partial<Pick<MultiSigRequest, "expiresAfter">> & {
     /** Must be the same for all signers. */
     nonce: number;
 };
-/** Parameters for the {@linkcode WalletClient.order} method. */
+/** Parameters for the {@linkcode ExchangeClient.order} method. */
 export type OrderParameters = Omit<OrderRequest["action"], "type"> & Partial<Pick<OrderRequest, "vaultAddress">> & Partial<Pick<OrderRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.perpDeploy} method. */
+/** Parameters for the {@linkcode ExchangeClient.perpDeploy} method. */
 export type PerpDeployParameters = PerpDeployParameters_RegisterAsset | PerpDeployParameters_SetOracle;
-/** One of the parameters for the {@linkcode WalletClient.perpDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.perpDeploy} method. */
 export type PerpDeployParameters_RegisterAsset = Omit<PerpDeployRequest_RegisterAsset["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.perpDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.perpDeploy} method. */
 export type PerpDeployParameters_SetOracle = Omit<PerpDeployRequest_SetOracle["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.perpDexClassTransfer} method. */
+/** Parameters for the {@linkcode ExchangeClient.perpDexClassTransfer} method. */
 export type PerpDexClassTransferParameters = Omit<PerpDexClassTransferRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.registerReferrer} method. */
+/** Parameters for the {@linkcode ExchangeClient.registerReferrer} method. */
 export type RegisterReferrerParameters = Omit<RegisterReferrerRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.reserveRequestWeight} method. */
+/** Parameters for the {@linkcode ExchangeClient.reserveRequestWeight} method. */
 export type ReserveRequestWeightParameters = Omit<ReserveRequestWeightRequest["action"], "type"> & Partial<Pick<ReserveRequestWeightRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.scheduleCancel} method. */
+/** Parameters for the {@linkcode ExchangeClient.scheduleCancel} method. */
 export type ScheduleCancelParameters = Omit<ScheduleCancelRequest["action"], "type"> & Partial<Pick<ScheduleCancelRequest, "vaultAddress">> & Partial<Pick<ScheduleCancelRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.setDisplayName} method. */
+/** Parameters for the {@linkcode ExchangeClient.setDisplayName} method. */
 export type SetDisplayNameParameters = Omit<SetDisplayNameRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.setReferrer} method. */
+/** Parameters for the {@linkcode ExchangeClient.setReferrer} method. */
 export type SetReferrerParameters = Omit<SetReferrerRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** Parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters = SpotDeployParameters_Genesis | SpotDeployParameters_RegisterHyperliquidity | SpotDeployParameters_RegisterSpot | SpotDeployParameters_RegisterToken2 | SpotDeployParameters_SetDeployerTradingFeeShare | SpotDeployParameters_UserGenesis;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_Genesis = Omit<SpotDeployRequest_Genesis["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_RegisterHyperliquidity = Omit<SpotDeployRequest_RegisterHyperliquidity["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_RegisterSpot = Omit<SpotDeployRequest_RegisterSpot["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_RegisterToken2 = Omit<SpotDeployRequest_RegisterToken2["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_SetDeployerTradingFeeShare = Omit<SpotDeployRequest_SetDeployerTradingFeeShare["action"], "type">;
-/** One of the parameters for the {@linkcode WalletClient.spotDeploy} method. */
+/** One of the parameters for the {@linkcode ExchangeClient.spotDeploy} method. */
 export type SpotDeployParameters_UserGenesis = Omit<SpotDeployRequest_UserGenesis["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.spotSend} method. */
+/** Parameters for the {@linkcode ExchangeClient.spotSend} method. */
 export type SpotSendParameters = Omit<SpotSendRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "time">;
-/** Parameters for the {@linkcode WalletClient.spotUser} method. */
+/** Parameters for the {@linkcode ExchangeClient.spotUser} method. */
 export type SpotUserParameters = Omit<SpotUserRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.subAccountSpotTransfer} method. */
+/** Parameters for the {@linkcode ExchangeClient.subAccountSpotTransfer} method. */
 export type SubAccountSpotTransferParameters = Omit<SubAccountSpotTransferRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.subAccountTransfer} method. */
+/** Parameters for the {@linkcode ExchangeClient.subAccountTransfer} method. */
 export type SubAccountTransferParameters = Omit<SubAccountTransferRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.tokenDelegate} method. */
+/** Parameters for the {@linkcode ExchangeClient.tokenDelegate} method. */
 export type TokenDelegateParameters = Omit<TokenDelegateRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.twapCancel} method. */
+/** Parameters for the {@linkcode ExchangeClient.twapCancel} method. */
 export type TwapCancelParameters = Omit<TwapCancelRequest["action"], "type"> & Partial<Pick<TwapCancelRequest, "vaultAddress">> & Partial<Pick<TwapCancelRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.twapOrder} method. */
+/** Parameters for the {@linkcode ExchangeClient.twapOrder} method. */
 export type TwapOrderParameters = TwapOrderRequest["action"]["twap"] & Partial<Pick<TwapOrderRequest, "vaultAddress">> & Partial<Pick<TwapOrderRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.updateIsolatedMargin} method. */
+/** Parameters for the {@linkcode ExchangeClient.updateIsolatedMargin} method. */
 export type UpdateIsolatedMarginParameters = Omit<UpdateIsolatedMarginRequest["action"], "type"> & Partial<Pick<UpdateIsolatedMarginRequest, "vaultAddress">> & Partial<Pick<UpdateIsolatedMarginRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.updateLeverage} method. */
+/** Parameters for the {@linkcode ExchangeClient.updateLeverage} method. */
 export type UpdateLeverageParameters = Omit<UpdateLeverageRequest["action"], "type"> & Partial<Pick<UpdateLeverageRequest, "vaultAddress">> & Partial<Pick<UpdateLeverageRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.usdClassTransfer} method. */
+/** Parameters for the {@linkcode ExchangeClient.usdClassTransfer} method. */
 export type UsdClassTransferParameters = Omit<UsdClassTransferRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "nonce">;
-/** Parameters for the {@linkcode WalletClient.usdSend} method. */
+/** Parameters for the {@linkcode ExchangeClient.usdSend} method. */
 export type UsdSendParameters = Omit<UsdSendRequest["action"], "type" | "hyperliquidChain" | "signatureChainId" | "time">;
-/** Parameters for the {@linkcode WalletClient.vaultDistribute} method. */
+/** Parameters for the {@linkcode ExchangeClient.vaultDistribute} method. */
 export type VaultDistributeParameters = Omit<VaultDistributeRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.vaultModify} method. */
+/** Parameters for the {@linkcode ExchangeClient.vaultModify} method. */
 export type VaultModifyParameters = Omit<VaultModifyRequest["action"], "type">;
-/** Parameters for the {@linkcode WalletClient.vaultTransfer} method. */
+/** Parameters for the {@linkcode ExchangeClient.vaultTransfer} method. */
 export type VaultTransferParameters = Omit<VaultTransferRequest["action"], "type"> & Partial<Pick<VaultTransferRequest, "expiresAfter">>;
-/** Parameters for the {@linkcode WalletClient.withdraw3} method. */
+/** Parameters for the {@linkcode ExchangeClient.withdraw3} method. */
 export type Withdraw3Parameters = Omit<Withdraw3Request["action"], "type" | "hyperliquidChain" | "signatureChainId" | "time">;
 /** Successful variant of {@linkcode CancelResponse} without error statuses. */
 export type CancelResponseSuccess = CancelResponse & {
@@ -185,27 +186,17 @@ export declare class ApiRequestError extends HyperliquidError {
     constructor(response: ErrorResponse | OrderResponse | CancelResponse | TwapOrderResponse | TwapCancelResponse);
 }
 /**
- * Wallet client for interacting with the Hyperliquid API.
+ * Exchange client for interacting with the Hyperliquid API.
  * @typeParam T The transport used to connect to the Hyperliquid API.
  * @typeParam W The WalletClient/Account ([viem](https://viem.sh/docs/clients/wallet)) or Signer ([ethers.js](https://docs.ethers.io/v6/api/providers/#Signer)) used for signing transactions.
  */
-export declare class WalletClient<T extends IRequestTransport = IRequestTransport, W extends AbstractWallet = AbstractWallet> implements AsyncDisposable {
-    /** The transport used to connect to the Hyperliquid API. */
+export declare class ExchangeClient<T extends IRequestTransport = IRequestTransport, W extends AbstractWallet = AbstractWallet> implements ExchangeClientParameters, AsyncDisposable {
     transport: T;
-    /** The `viem`, `ethers.js`, or `window.ethereum` wallet used for signing transactions. */
     wallet: W;
-    /** Specifies whether the client uses testnet. */
     isTestnet: boolean;
-    /** Sets a default vaultAddress to be used if no vaultAddress is explicitly passed to a method. */
     defaultVaultAddress?: Hex;
-    /** Sets a default expiresAfter to be used if no expiresAfter is explicitly passed to a method. */
     defaultExpiresAfter?: number | (() => MaybePromise<number>);
-    /**
-     * The network that will be used to sign transactions.
-     * Must match the network of the {@link wallet}.
-     */
     signatureChainId: Hex | (() => MaybePromise<Hex>);
-    /** Function to get the next nonce for signing transactions. */
     nonceManager: () => MaybePromise<number>;
     /**
      * Initialises a new instance.
@@ -219,7 +210,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      * const wallet = privateKeyToAccount("0x...");
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      * ```
      *
      * @example Private key via [ethers.js](https://docs.ethers.org/v6/api/wallet/#Wallet) or [ethers.js v5](https://docs.ethers.org/v5/api/signer/#Wallet)
@@ -230,7 +221,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      * const wallet = new ethers.Wallet("0x...");
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      * ```
      *
      * @example External wallet (e.g. MetaMask) via [viem](https://viem.sh/docs/clients/wallet#optional-hoist-the-account)
@@ -242,7 +233,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      * const wallet = createWalletClient({ account, transport: custom(window.ethereum) });
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      * ```
      *
      * @example External wallet (e.g. MetaMask) via `window.ethereum` directly
@@ -250,10 +241,10 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      * import * as hl from "@nktkas/hyperliquid";
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet: window.ethereum, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet: window.ethereum, transport });
      * ```
      */
-    constructor(args: WalletClientParameters<T, W>);
+    constructor(args: ExchangeClientParameters<T, W>);
     /**
      * Approve an agent to sign on behalf of the master account.
      * @param args - The parameters for the request.
@@ -269,7 +260,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.approveAgent({ agentAddress: "0x...", agentName: "agentName" });
      * ```
@@ -290,7 +281,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.approveBuilderFee({ maxFeeRate: "0.01%", builder: "0x..." });
      * ```
@@ -311,7 +302,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.batchModify({
      *   modifies: [{
@@ -349,7 +340,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.cancel({
      *   cancels: [{
@@ -375,7 +366,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.cancelByCloid({
      *   cancels: [
@@ -400,7 +391,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.cDeposit({ wei: 1 * 1e8 });
      * ```
@@ -421,7 +412,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.claimRewards();
      * ```
@@ -442,7 +433,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.convertToMultiSigUser({
      *   authorizedUsers: ["0x...", "0x..."],
@@ -466,7 +457,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.createSubAccount({ name: "subAccountName" });
      * ```
@@ -487,7 +478,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.createVault({
      *   name: "VaultName",
@@ -512,7 +503,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * // Jail self
      * const result = await client.cSignerAction({ jailSelf: null });
@@ -537,7 +528,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * // Change validator profile
      * const result = await client.cValidatorAction({
@@ -567,7 +558,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.cWithdraw({ wei: 1 * 1e8 });
      * ```
@@ -588,7 +579,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.evmUserModify({ usingBigBlocks: true });
      * ```
@@ -609,7 +600,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.modify({
      *   oid: 123,
@@ -645,7 +636,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const multiSigUser = "0x..."; // Multi-sig user address
      *
@@ -687,7 +678,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.order({
      *   orders: [{
@@ -734,7 +725,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.perpDexClassTransfer({
      *   dex: "test",
@@ -760,7 +751,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.registerReferrer({ code: "TEST" });
      * ```
@@ -781,7 +772,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.reserveRequestWeight({ weight: 10 });
      * ```
@@ -802,7 +793,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.scheduleCancel({ time: Date.now() + 3600000 });
      * ```
@@ -824,7 +815,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.setDisplayName({ displayName: "My Name" });
      * ```
@@ -845,7 +836,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.setReferrer({ code: "TEST" });
      * ```
@@ -881,7 +872,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.spotSend({
      *   destination: "0x...",
@@ -906,7 +897,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.spotUser({ toggleSpotDusting: { optOut: false } });
      * ```
@@ -927,7 +918,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.subAccountSpotTransfer({
      *   subAccountUser: "0x...",
@@ -953,7 +944,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.subAccountTransfer({
      *   subAccountUser: "0x...",
@@ -978,7 +969,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.tokenDelegate({
      *   validator: "0x...",
@@ -1003,7 +994,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.twapCancel({
      *   a: 0, // Asset index
@@ -1027,7 +1018,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.twapOrder({
      *   a: 0, // Asset index
@@ -1055,7 +1046,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.updateIsolatedMargin({ asset: 0, isBuy: true, ntli: 1 * 1e6 });
      * ```
@@ -1076,7 +1067,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.updateLeverage({ asset: 0, isCross: true, leverage: 5 });
      * ```
@@ -1097,7 +1088,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.usdClassTransfer({ amount: "1", toPerp: true });
      * ```
@@ -1118,7 +1109,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.usdSend({ destination: "0x...", amount: "1" });
      * ```
@@ -1139,7 +1130,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.vaultDistribute({ vaultAddress: "0x...", usd: 10 * 1e6 });
      * ```
@@ -1160,7 +1151,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.vaultModify({
      *   vaultAddress: "0x...",
@@ -1185,7 +1176,7 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.vaultTransfer({
      *   vaultAddress: "0x...",
@@ -1210,12 +1201,20 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
      *
      * const wallet = privateKeyToAccount("0x...");
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
-     * const client = new hl.WalletClient({ wallet, transport });
+     * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const result = await client.withdraw3({ destination: "0x...", amount: "1" });
      * ```
      */
     withdraw3(args: Withdraw3Parameters, signal?: AbortSignal): Promise<SuccessResponse>;
+    /** Send an API request and validate the response. */
+    protected _request(payload: {
+        action: BaseExchangeRequest["action"];
+        signature: BaseExchangeRequest["signature"];
+        nonce: BaseExchangeRequest["nonce"];
+        vaultAddress?: Hex;
+        expiresAfter?: number;
+    }, signal?: AbortSignal): Promise<SuccessResponse | CancelResponseSuccess | CreateSubAccountResponse | CreateVaultResponse | OrderResponseSuccess | TwapOrderResponseSuccess | TwapCancelResponseSuccess>;
     /** Formats a decimal number as a string, removing trailing zeros. */
     protected _formatDecimal(numStr: string): string;
     /** Guesses the chain ID based on the wallet type or the isTestnet flag. */
@@ -1230,4 +1229,4 @@ export declare class WalletClient<T extends IRequestTransport = IRequestTranspor
     protected _validateResponse(response: SuccessResponse | ErrorResponse | CancelResponse | CreateSubAccountResponse | CreateVaultResponse | OrderResponse | TwapOrderResponse | TwapCancelResponse): asserts response is SuccessResponse | CancelResponseSuccess | CreateSubAccountResponse | CreateVaultResponse | OrderResponseSuccess | TwapOrderResponseSuccess | TwapCancelResponseSuccess;
     [Symbol.asyncDispose](): Promise<void>;
 }
-//# sourceMappingURL=wallet.d.ts.map
+//# sourceMappingURL=exchange.d.ts.map