@nktkas/hyperliquid 0.23.0 → 0.24.0

package/script/src/clients/exchange.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExchangeClient = exports.ApiRequestError = void 0;
 const base_js_1 = require("../base.js");
 const mod_js_1 = require("../signing/mod.js");
-/** Error thrown when the API returns an error response. */
+/** Custom error class for API request errors. */
 class ApiRequestError extends base_js_1.HyperliquidError {
     response;
     constructor(response) {
@@ -118,15 +118,6 @@ class ExchangeClient {
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet, transport });
      * ```
-     *
-     * @example External wallet (e.g. MetaMask) via [`window.ethereum`](https://eips.ethereum.org/EIPS/eip-1193)
-     * ```ts
-     * import * as hl from "@nktkas/hyperliquid";
-     *
-     * const ethereum = (window as any).ethereum;
-     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
-     * const exchClient = new hl.ExchangeClient({ wallet: ethereum, transport });
-     * ```
      */
     constructor(args) {
         this.transport = args.transport;
@@ -134,13 +125,13 @@ class ExchangeClient {
         this.isTestnet = args.isTestnet ?? false;
         this.defaultVaultAddress = args.defaultVaultAddress;
         this.defaultExpiresAfter = args.defaultExpiresAfter;
-        this.signatureChainId = args.signatureChainId ?? this._guessSignatureChainId;
+        this.signatureChainId = args.signatureChainId ?? (() => (0, mod_js_1.getWalletChainId)(this.wallet));
         this.nonceManager = args.nonceManager ?? new NonceManager().getNonce;
     }
     /**
      * Approve an agent to sign on behalf of the master account.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -151,42 +142,27 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.approveAgent({ agentAddress: "0x...", agentName: "..." });
      * ```
      */
-    async approveAgent(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async approveAgent(params, opts) {
         const action = mod_js_1.actionSorter.approveAgent({
             type: "approveAgent",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        if (action.agentName === "")
-            action.agentName = null;
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Approve a maximum fee rate for a builder.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -197,40 +173,27 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.approveBuilderFee({ maxFeeRate: "0.01%", builder: "0x..." });
      * ```
      */
-    async approveBuilderFee(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async approveBuilderFee(params, opts) {
         const action = mod_js_1.actionSorter.approveBuilderFee({
             type: "approveBuilderFee",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Modify multiple orders.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link OrderResponse} without error statuses.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -241,7 +204,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -262,30 +225,19 @@ class ExchangeClient {
      * });
      * ```
      */
-    async batchModify(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.batchModify({ type: "batchModify", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async batchModify(params, opts) {
+        const action = mod_js_1.actionSorter.batchModify({
+            type: "batchModify",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Cancel order(s).
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link CancelResponse} without error statuses.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -296,7 +248,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -307,30 +259,19 @@ class ExchangeClient {
      * });
      * ```
      */
-    async cancel(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.cancel({ type: "cancel", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async cancel(params, opts) {
+        const action = mod_js_1.actionSorter.cancel({
+            type: "cancel",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Cancel order(s) by cloid.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link CancelResponse} without error statuses.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -341,7 +282,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -352,30 +293,19 @@ class ExchangeClient {
      * });
      * ```
      */
-    async cancelByCloid(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.cancelByCloid({ type: "cancelByCloid", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async cancelByCloid(params, opts) {
+        const action = mod_js_1.actionSorter.cancelByCloid({
+            type: "cancelByCloid",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Transfer native token from the user's spot account into staking for delegating to validators.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -386,40 +316,26 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.cDeposit({ wei: 1 * 1e8 });
      * ```
      */
-    async cDeposit(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async cDeposit(params, opts) {
         const action = mod_js_1.actionSorter.cDeposit({
             type: "cDeposit",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Claim rewards from referral program.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -430,33 +346,24 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.claimRewards();
      * ```
      */
-    async claimRewards(signal) {
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.claimRewards({ type: "claimRewards" });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async claimRewards(opts) {
+        const action = mod_js_1.actionSorter.claimRewards({
+            type: "claimRewards",
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Convert a single-signature account to a multi-signature account or vice versa.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -467,47 +374,36 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * // Convert to multi-sig user
      * await exchClient.convertToMultiSigUser({
-     *   authorizedUsers: ["0x...", "0x...", "0x..."],
-     *   threshold: 2,
+     *   signers: {
+     *     authorizedUsers: ["0x...", "0x...", "0x..."],
+     *     threshold: 2,
+     *   },
      * });
      *
      * // Convert to single-sig user
-     * await exchClient.convertToMultiSigUser(null);
+     * await exchClient.convertToMultiSigUser({ signers: null });
      * ```
      */
-    async convertToMultiSigUser(args, signal) {
-        // Destructure the parameters
-        const actionArgs = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async convertToMultiSigUser(params, opts) {
         const action = mod_js_1.actionSorter.convertToMultiSigUser({
             type: "convertToMultiSigUser",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            signers: JSON.stringify(actionArgs),
-            nonce,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Create a sub-account.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Response for creating a sub-account.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -518,35 +414,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * const data = await exchClient.createSubAccount({ name: "..." });
      * ```
      */
-    async createSubAccount(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.createSubAccount({ type: "createSubAccount", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async createSubAccount(params, opts) {
+        const action = mod_js_1.actionSorter.createSubAccount({
+            type: "createSubAccount",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Create a vault.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Response for creating a vault.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -557,35 +443,30 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
-     * const data = await exchClient.createVault({ name: "...", description: "...", initialUsd: 100 * 1e6 });
+     * const data = await exchClient.createVault({
+     *   name: "...",
+     *   description: "...",
+     *   initialUsd: 100 * 1e6,
+     *   nonce: Date.now(),
+     * });
      * ```
      */
-    async createVault(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.createVault({ type: "createVault", nonce, ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async createVault(params, opts) {
+        const action = mod_js_1.actionSorter.createVault({
+            type: "createVault",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Jail or unjail self as a validator signer.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -596,7 +477,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -607,29 +488,18 @@ class ExchangeClient {
      * await exchClient.cSignerAction({ unjailSelf: null });
      * ```
      */
-    async cSignerAction(args, signal) {
-        // Destructure the parameters
-        const { expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.CSignerAction({ type: "CSignerAction", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            expiresAfter,
+    async cSignerAction(params, opts) {
+        const action = mod_js_1.actionSorter.CSignerAction({
+            type: "CSignerAction",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Action related to validator management.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -640,17 +510,21 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * // Change validator profile
      * await exchClient.cValidatorAction({
      *   changeProfile: {
+     *     node_ip: { Ip: "1.2.3.4" },
      *     name: "...",
      *     description: "...",
      *     unjailed: true,
-     *   }
+     *     disable_delegations: false,
+     *     commission_bps: null,
+     *     signer: null,
+     *   },
      * });
      *
      * // Register a new validator
@@ -673,29 +547,18 @@ class ExchangeClient {
      * await exchClient.cValidatorAction({ unregister: null });
      * ```
      */
-    async cValidatorAction(args, signal) {
-        // Destructure the parameters
-        const { expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.CValidatorAction({ type: "CValidatorAction", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            expiresAfter,
+    async cValidatorAction(params, opts) {
+        const action = mod_js_1.actionSorter.CValidatorAction({
+            type: "CValidatorAction",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Transfer native token from staking into the user's spot account.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -706,79 +569,56 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.cWithdraw({ wei: 1 * 1e8 });
      * ```
      */
-    async cWithdraw(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async cWithdraw(params, opts) {
         const action = mod_js_1.actionSorter.cWithdraw({
             type: "cWithdraw",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Configure block type for EVM transactions.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Response for creating a sub-account.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
      * @throws {TransportError} When the transport layer throws an error.
      *
-     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/evm/dual-block-architecture
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * const data = await exchClient.evmUserModify({ usingBigBlocks: true });
      * ```
      */
-    async evmUserModify(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.evmUserModify({ type: "evmUserModify", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async evmUserModify(params, opts) {
+        const action = mod_js_1.actionSorter.evmUserModify({
+            type: "evmUserModify",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Modify an order.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -789,7 +629,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -807,30 +647,19 @@ class ExchangeClient {
      * });
      * ```
      */
-    async modify(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.modify({ type: "modify", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async modify(params, opts) {
+        const action = mod_js_1.actionSorter.modify({
+            type: "modify",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * A multi-signature request.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Any successful response.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -850,20 +679,36 @@ class ExchangeClient {
      * const exchClient = new hl.ExchangeClient({ wallet, transport });
      *
      * const nonce = Date.now();
-     * const action = {
+     * const action = actionSorter.scheduleCancel({
      *   type: "scheduleCancel",
      *   time: Date.now() + 10000,
-     * } as const;
-     *
-     * // Create the required number of signatures
-     * const signature = await signL1Action({
-     *   wallet,
-     *   action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
-     *   nonce,
      * });
      *
+     * // Create the required number of signatures
+     * const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+     *   return await signL1Action({
+     *     wallet: signerPrivKey as `0x${string}`,
+     *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
+     *     nonce,
+     *   });
+     * }));
+     *
+     * // or user-signed action
+     * // const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+     * //   return await signUserSignedAction({
+     * //     wallet: signerPrivKey as `0x${string}`,
+     * //     action: {
+     * //       ...action,
+     * //       payloadMultiSigUser: multiSigUser,
+     * //       outerSigner: wallet.address,
+     * //     },
+     * //     types: userSignedActionEip712Types[action.type],
+     * //   });
+     * // }));
+     *
+     * // Then use signatures in the `multiSig` action
      * const data = await exchClient.multiSig({
-     *   signatures: [signature],
+     *   signatures,
      *   payload: {
      *     multiSigUser,
      *     outerSigner: wallet.address,
@@ -873,36 +718,21 @@ class ExchangeClient {
      * });
      * ```
      */
-    async multiSig(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), nonce, ...actionArgs } = args;
-        // Construct an action
+    async multiSig(params_and_nonce, opts) {
+        const { nonce, ...params } = params_and_nonce;
         const action = mod_js_1.actionSorter.multiSig({
             type: "multiSig",
             signatureChainId: await this._getSignatureChainId(),
-            ...actionArgs,
-        });
-        // Sign the action
-        // deno-lint-ignore no-explicit-any
-        const actionWithoutType = structuredClone(action);
-        delete actionWithoutType.type;
-        const signature = await (0, mod_js_1.signMultiSigAction)({
-            wallet: this.wallet,
-            action: actionWithoutType,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeMultiSigAction({ action, vaultAddress, expiresAfter, nonce }, opts?.signal);
     }
     /**
      * Place an order(s).
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link OrderResponse} without error statuses.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -913,7 +743,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -933,30 +763,19 @@ class ExchangeClient {
      * });
      * ```
      */
-    async order(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.order({ type: "order", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async order(params, opts) {
+        const action = mod_js_1.actionSorter.order({
+            type: "order",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Deploying HIP-3 assets.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -967,7 +786,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -982,120 +801,93 @@ class ExchangeClient {
      *       onlyIsolated: false,
      *     },
      *     dex: "test",
+     *     schema: null,
      *   },
      * });
      * ```
      */
-    async perpDeploy(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.perpDeploy({ type: "perpDeploy", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async perpDeploy(params, opts) {
+        const action = mod_js_1.actionSorter.perpDeploy({
+            type: "perpDeploy",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
-     * Transfer funds between Spot account and Perp dex account.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * Create a referral code.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
      * @throws {TransportError} When the transport layer throws an error.
      *
-     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
-     * await exchClient.perpDexClassTransfer({ dex: "test", token: "USDC", amount: "1", toPerp: true });
+     * await exchClient.registerReferrer({ code: "..." });
      * ```
      */
-    async perpDexClassTransfer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.PerpDexClassTransfer({
-            type: "PerpDexClassTransfer",
-            hyperliquidChain: this._getHyperliquidChain(),
-            signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+    async registerReferrer(params, opts) {
+        const action = mod_js_1.actionSorter.registerReferrer({
+            type: "registerReferrer",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
-     * Transfer collateral tokens between different perp dexes for the same user.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * Reserve additional rate-limited actions for a fee.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
      * @throws {TransportError} When the transport layer throws an error.
      *
-     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-perp-account-to-perp-account-for-builder-deployed-dex
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#reserve-additional-actions
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
-     * await exchClient.perpDexTransfer({ sourceDex: "", destinationDex: "test", amount: "1" });
+     * await exchClient.reserveRequestWeight({ weight: 10 });
      * ```
      */
-    async perpDexTransfer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.PerpDexTransfer({
-            type: "PerpDexTransfer",
-            hyperliquidChain: this._getHyperliquidChain(),
-            signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
+    async reserveRequestWeight(params, opts) {
+        const action = mod_js_1.actionSorter.reserveRequestWeight({
+            type: "reserveRequestWeight",
+            ...params,
         });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
+    }
+    async scheduleCancel(params_or_opts, maybeOpts) {
+        const isFirstArgParams = params_or_opts && "time" in params_or_opts;
+        const params = isFirstArgParams ? params_or_opts : {};
+        const opts = isFirstArgParams ? maybeOpts : params_or_opts;
+        const action = mod_js_1.actionSorter.scheduleCancel({
+            type: "scheduleCancel",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
-     * Create a referral code.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * Set the display name in the leaderboard.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1106,136 +898,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
-     * await exchClient.registerReferrer({ code: "..." });
+     * await exchClient.setDisplayName({ displayName: "..." });
      * ```
      */
-    async registerReferrer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.registerReferrer({ type: "registerReferrer", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async setDisplayName(params, opts) {
+        const action = mod_js_1.actionSorter.setDisplayName({
+            type: "setDisplayName",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
-    }
-    /**
-     * Reserve additional rate-limited actions for a fee.
-     * @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 unsuccessful response.
-     * @throws {TransportError} When the transport layer throws an error.
-     *
-     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#reserve-additional-actions
-     * @example
-     * ```ts
-     * import * as hl from "@nktkas/hyperliquid";
-     *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
-     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
-     * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
-     *
-     * await exchClient.reserveRequestWeight({ weight: 10 });
-     * ```
-     */
-    async reserveRequestWeight(args, signal) {
-        // Destructure the parameters
-        const { expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.reserveRequestWeight({ type: "reserveRequestWeight", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            expiresAfter,
-        });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
-    }
-    async scheduleCancel(args_or_signal, maybeSignal) {
-        const args = args_or_signal instanceof AbortSignal ? {} : args_or_signal ?? {};
-        const signal = args_or_signal instanceof AbortSignal ? args_or_signal : maybeSignal;
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.scheduleCancel({ type: "scheduleCancel", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
-        });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
-    }
-    /**
-     * Set the display name in the leaderboard.
-     * @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 unsuccessful response.
-     * @throws {TransportError} When the transport layer throws an error.
-     *
-     * @see null
-     * @example
-     * ```ts
-     * import * as hl from "@nktkas/hyperliquid";
-     *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
-     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
-     * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
-     *
-     * await exchClient.setDisplayName({ displayName: "..." });
-     * ```
-     */
-    async setDisplayName(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.setDisplayName({ type: "setDisplayName", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-        });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Set a referral code.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1246,35 +927,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.setReferrer({ code: "..." });
      * ```
      */
-    async setReferrer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.setReferrer({ type: "setReferrer", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async setReferrer(params, opts) {
+        const action = mod_js_1.actionSorter.setReferrer({
+            type: "setReferrer",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Deploying HIP-1 and HIP-2 assets.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1285,7 +956,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -1302,28 +973,18 @@ class ExchangeClient {
      * });
      * ```
      */
-    async spotDeploy(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.spotDeploy({ type: "spotDeploy", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async spotDeploy(params, opts) {
+        const action = mod_js_1.actionSorter.spotDeploy({
+            type: "spotDeploy",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Send spot assets to another address.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1334,7 +995,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -1345,33 +1006,20 @@ class ExchangeClient {
      * });
      * ```
      */
-    async spotSend(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async spotSend(params, opts) {
         const action = mod_js_1.actionSorter.spotSend({
             type: "spotSend",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            time: nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            time: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Opt Out of Spot Dusting.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1382,35 +1030,54 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.spotUser({ toggleSpotDusting: { optOut: false } });
      * ```
      */
-    async spotUser(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.spotUser({ type: "spotUser", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async spotUser(params, opts) {
+        const action = mod_js_1.actionSorter.spotUser({
+            type: "spotUser",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
+    }
+    /**
+     * Modify a sub-account's.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
+     * @returns Successful response without specific data.
+     *
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
+     *
+     * await exchClient.subAccountModify({ subAccountUser: "0x...", name: "..."  });
+     * ```
+     */
+    async subAccountModify(params, opts) {
+        const action = mod_js_1.actionSorter.subAccountModify({
+            type: "subAccountModify",
+            ...params,
+        });
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Transfer between sub-accounts (spot).
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1421,7 +1088,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -1433,28 +1100,18 @@ class ExchangeClient {
      * });
      * ```
      */
-    async subAccountSpotTransfer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.subAccountSpotTransfer({ type: "subAccountSpotTransfer", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async subAccountSpotTransfer(params, opts) {
+        const action = mod_js_1.actionSorter.subAccountSpotTransfer({
+            type: "subAccountSpotTransfer",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Transfer between sub-accounts (perpetual).
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1465,35 +1122,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.subAccountTransfer({ subAccountUser: "0x...", isDeposit: true, usd: 1 * 1e6 });
      * ```
      */
-    async subAccountTransfer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.subAccountTransfer({ type: "subAccountTransfer", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async subAccountTransfer(params, opts) {
+        const action = mod_js_1.actionSorter.subAccountTransfer({
+            type: "subAccountTransfer",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Delegate or undelegate native tokens to or from a validator.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1504,40 +1151,27 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.tokenDelegate({ validator: "0x...", isUndelegate: true, wei: 1 * 1e8 });
      * ```
      */
-    async tokenDelegate(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async tokenDelegate(params, opts) {
         const action = mod_js_1.actionSorter.tokenDelegate({
             type: "tokenDelegate",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Cancel a TWAP order.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link TwapCancelResponse} without error status.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1548,37 +1182,26 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * const data = await exchClient.twapCancel({ a: 0, t: 1 });
      * ```
      */
-    async twapCancel(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.twapCancel({ type: "twapCancel", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async twapCancel(params, opts) {
+        const action = mod_js_1.actionSorter.twapCancel({
+            type: "twapCancel",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Place a TWAP order.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful variant of {@link TwapOrderResponse} without error status.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1589,44 +1212,35 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * const data = await exchClient.twapOrder({
-     *   a: 0,
-     *   b: true,
-     *   s: "1",
-     *   r: false,
-     *   m: 10,
-     *   t: true,
+     *   twap: {
+     *     a: 0,
+     *     b: true,
+     *     s: "1",
+     *     r: false,
+     *     m: 10,
+     *     t: true,
+     *   },
      * });
      * ```
      */
-    async twapOrder(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.twapOrder({ type: "twapOrder", twap: { ...actionArgs } });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async twapOrder(params, opts) {
+        const action = mod_js_1.actionSorter.twapOrder({
+            type: "twapOrder",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Add or remove margin from isolated position.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1637,37 +1251,26 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.updateIsolatedMargin({ asset: 0, isBuy: true, ntli: 1 * 1e6 });
      * ```
      */
-    async updateIsolatedMargin(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.updateIsolatedMargin({ type: "updateIsolatedMargin", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async updateIsolatedMargin(params, opts) {
+        const action = mod_js_1.actionSorter.updateIsolatedMargin({
+            type: "updateIsolatedMargin",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Update cross or isolated leverage on a coin.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1678,37 +1281,26 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.updateLeverage({ asset: 0, isCross: true, leverage: 5 });
      * ```
      */
-    async updateLeverage(args, signal) {
-        // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.updateLeverage({ type: "updateLeverage", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            vaultAddress,
-            expiresAfter,
+    async updateLeverage(params, opts) {
+        const action = mod_js_1.actionSorter.updateLeverage({
+            type: "updateLeverage",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const vaultAddress = opts?.vaultAddress ?? this.defaultVaultAddress;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, vaultAddress, expiresAfter }, opts?.signal);
     }
     /**
      * Transfer funds between Spot account and Perp account.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1719,40 +1311,27 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.usdClassTransfer({ amount: "1", toPerp: true });
      * ```
      */
-    async usdClassTransfer(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async usdClassTransfer(params, opts) {
         const action = mod_js_1.actionSorter.usdClassTransfer({
             type: "usdClassTransfer",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            nonce,
-            ...actionArgs,
+            nonce: await this.nonceManager(),
+            ...params,
         });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
-        });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Send usd to another address.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1763,40 +1342,27 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.usdSend({ destination: "0x...", amount: "1" });
      * ```
      */
-    async usdSend(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async usdSend(params, opts) {
         const action = mod_js_1.actionSorter.usdSend({
             type: "usdSend",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            time: nonce,
-            ...actionArgs,
-        });
-        // Sign the action
-        const signature = await (0, mod_js_1.signUserSignedAction)({
-            wallet: this.wallet,
-            action,
-            types: mod_js_1.userSignedActionEip712Types[action.type],
+            time: await this.nonceManager(),
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        return await this._executeUserSignedAction({ action }, opts?.signal);
     }
     /**
      * Distribute funds from a vault between followers.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1807,35 +1373,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.vaultDistribute({ vaultAddress: "0x...", usd: 10 * 1e6 });
      * ```
      */
-    async vaultDistribute(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.vaultDistribute({ type: "vaultDistribute", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async vaultDistribute(params, opts) {
+        const action = mod_js_1.actionSorter.vaultDistribute({
+            type: "vaultDistribute",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Modify a vault's configuration.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1846,7 +1402,7 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
@@ -1857,28 +1413,18 @@ class ExchangeClient {
      * });
      * ```
      */
-    async vaultModify(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.vaultModify({ type: "vaultModify", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
+    async vaultModify(params, opts) {
+        const action = mod_js_1.actionSorter.vaultModify({
+            type: "vaultModify",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Deposit or withdraw from a vault.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1889,36 +1435,25 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.vaultTransfer({ vaultAddress: "0x...", isDeposit: true, usd: 10 * 1e6 });
      * ```
      */
-    async vaultTransfer(args, signal) {
-        // Destructure the parameters
-        const { expiresAfter = await this._getDefaultExpiresAfter(), ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
-        const action = mod_js_1.actionSorter.vaultTransfer({ type: "vaultTransfer", ...actionArgs });
-        // Sign the action
-        const signature = await (0, mod_js_1.signL1Action)({
-            wallet: this.wallet,
-            action,
-            nonce,
-            isTestnet: this.isTestnet,
-            expiresAfter,
+    async vaultTransfer(params, opts) {
+        const action = mod_js_1.actionSorter.vaultTransfer({
+            type: "vaultTransfer",
+            ...params,
         });
-        // Send a request
-        const response = await this.transport.request("exchange", { action, signature, nonce, expiresAfter }, signal);
-        this._validateResponse(response);
-        return response;
+        const expiresAfter = opts?.expiresAfter ?? await this._getDefaultExpiresAfter();
+        return await this._executeL1Action({ action, expiresAfter }, opts?.signal);
     }
     /**
      * Initiate a withdrawal request.
-     * @param args - The parameters for the request.
-     * @param signal - An optional abort signal.
+     * @param params - Action-specific parameters.
+     * @param opts - Request execution options.
      * @returns Successful response without specific data.
      *
      * @throws {ApiRequestError} When the API returns an unsuccessful response.
@@ -1929,26 +1464,44 @@ class ExchangeClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      *
-     * const privateKey = "0x..."; // or `viem`, `ethers`
+     * const privateKey = "0x..."; // `viem`, `ethers`, or private key directly`
      * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
      * const exchClient = new hl.ExchangeClient({ wallet: privateKey, transport });
      *
      * await exchClient.withdraw3({ destination: "0x...", amount: "1" });
      * ```
      */
-    async withdraw3(args, signal) {
-        // Destructure the parameters
-        const { ...actionArgs } = args;
-        // Construct an action
-        const nonce = await this.nonceManager();
+    async withdraw3(params, opts) {
         const action = mod_js_1.actionSorter.withdraw3({
             type: "withdraw3",
             hyperliquidChain: this._getHyperliquidChain(),
             signatureChainId: await this._getSignatureChainId(),
-            time: nonce,
-            ...actionArgs,
+            time: await this.nonceManager(),
+            ...params,
         });
-        // Sign the action
+        return await this._executeUserSignedAction({ action }, opts?.signal);
+    }
+    async _executeL1Action(request, signal) {
+        const { action, vaultAddress, expiresAfter } = request;
+        // Sign an L1 action
+        const nonce = await this.nonceManager();
+        const signature = await (0, mod_js_1.signL1Action)({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+            vaultAddress,
+            expiresAfter,
+        });
+        // Send a request
+        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
+        this._validateResponse(response);
+        return response;
+    }
+    async _executeUserSignedAction(request, signal) {
+        const { action } = request;
+        // Sign a user-signed action
+        const nonce = "nonce" in action ? action.nonce : action.time;
         const signature = await (0, mod_js_1.signUserSignedAction)({
             wallet: this.wallet,
             action,
@@ -1959,46 +1512,33 @@ class ExchangeClient {
         this._validateResponse(response);
         return response;
     }
-    /** Guesses the chain ID based on the wallet type or the isTestnet flag. */
-    async _guessSignatureChainId() {
-        // Trying to get chain ID of the wallet
-        if ((0, mod_js_1.isAbstractViemWalletClient)(this.wallet)) {
-            if ("getChainId" in this.wallet && typeof this.wallet.getChainId === "function") {
-                const chainId = await this.wallet.getChainId();
-                return `0x${chainId.toString(16)}`;
-            }
-        }
-        else if ((0, mod_js_1.isAbstractEthersSigner)(this.wallet) || (0, mod_js_1.isAbstractEthersV5Signer)(this.wallet)) {
-            if ("provider" in this.wallet &&
-                typeof this.wallet.provider === "object" && this.wallet.provider !== null &&
-                "getNetwork" in this.wallet.provider &&
-                typeof this.wallet.provider.getNetwork === "function") {
-                const network = await this.wallet.provider.getNetwork();
-                return `0x${network.chainId.toString(16)}`;
-            }
-        }
-        else if ((0, mod_js_1.isAbstractWindowEthereum)(this.wallet)) {
-            const [chainId] = await this.wallet.request({ method: "eth_chainId", params: [] });
-            return chainId;
-        }
-        // Attempt to guess chain ID based on isTestnet
-        return this.isTestnet ? "0x66eee" : "0xa4b1";
+    async _executeMultiSigAction(request, signal) {
+        const { action, nonce, vaultAddress, expiresAfter } = request;
+        // Sign a multi-signature action
+        const signature = await (0, mod_js_1.signMultiSigAction)({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+            vaultAddress,
+            expiresAfter,
+        });
+        // Send a request
+        const response = await this.transport.request("exchange", { action, signature, nonce, vaultAddress, expiresAfter }, signal);
+        this._validateResponse(response);
+        return response;
     }
-    /** Get the default expiration time for an action. */
     async _getDefaultExpiresAfter() {
         return typeof this.defaultExpiresAfter === "number"
             ? this.defaultExpiresAfter
             : await this.defaultExpiresAfter?.();
     }
-    /** Get the signature chain ID for the wallet. */
     async _getSignatureChainId() {
         return typeof this.signatureChainId === "string" ? this.signatureChainId : await this.signatureChainId();
     }
-    /** Get the Hyperliquid chain based on the isTestnet flag. */
     _getHyperliquidChain() {
         return this.isTestnet ? "Testnet" : "Mainnet";
     }
-    /** Validate a response from the API. */
     _validateResponse(response) {
         if (response.status === "err") {
             throw new ApiRequestError(response);