@nktkas/hyperliquid 0.13.1 → 0.14.0

package/esm/src/clients/wallet.js

@@ -1,17 +1,18 @@
-import { sorters } from "../utils/key_sort.js";
-import { signL1Action, signUserSignedAction, } from "../utils/signing.js";
-// ———————————————Errors———————————————
+import { HyperliquidError } from "../base.js";
+import { signL1Action, signUserSignedAction, } from "../signing.js";
+// ——————————————— Errors ———————————————
 /** Error thrown when the API returns an error response. */
-export class ApiRequestError extends Error {
+export class ApiRequestError extends HyperliquidError {
     constructor(response) {
         let message = "Cannot process API request";
         if (response.status === "err") {
+            // For ErrorResponse
             message += `: ${response.response}`;
         }
         else {
             if ("statuses" in response.response.data) {
-                const errors = response.response.data.statuses
-                    .reduce((acc, status, index) => {
+                // For OrderResponse, CancelResponse
+                const errors = response.response.data.statuses.reduce((acc, status, index) => {
                     if (typeof status === "object" && "error" in status) {
                         acc.push(`Order ${index} failed: ${status.error}`);
                     }
@@ -22,6 +23,7 @@ export class ApiRequestError extends Error {
                 }
             }
             else {
+                // For TwapOrderResponse, TwapCancelResponse
                 if (typeof response.response.data.status === "object" && "error" in response.response.data.status) {
                     message += `: ${response.response.data.status.error}`;
                 }
@@ -37,11 +39,11 @@ export class ApiRequestError extends Error {
         this.name = "ApiRequestError";
     }
 }
-// ———————————————Client———————————————
+// ——————————————— Client ———————————————
 /**
  * Wallet client for interacting with the Hyperliquid API.
- * @typeParam T - The transport used to connect to the Hyperliquid API.
- * @typeParam W - The WalletClient/Account ([viem](https://viem.sh/docs/clients/wallet)) or Signer ([ethers.js](https://docs.ethers.io/v6/api/providers/#Signer)) used for signing transactions.
+ * @typeParam T The transport used to connect to the Hyperliquid API.
+ * @typeParam W The WalletClient/Account ([viem](https://viem.sh/docs/clients/wallet)) or Signer ([ethers.js](https://docs.ethers.io/v6/api/providers/#Signer)) used for signing transactions.
  */
 export class WalletClient {
     /**
@@ -59,7 +61,7 @@ export class WalletClient {
      * const client = new hl.WalletClient({ wallet, transport });
      * ```
      *
-     * @example Private key via [ethers.js](https://docs.ethers.org/v6/api/wallet/#Wallet)
+     * @example Private key via [ethers.js](https://docs.ethers.org/v6/api/wallet/#Wallet) or [ethers.js v5](https://docs.ethers.org/v5/api/signer/#Wallet)
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      * import { ethers } from "ethers";
@@ -74,14 +76,21 @@ export class WalletClient {
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
      * import { createWalletClient, custom } from "viem";
-     * import { arbitrum } from "viem/chains";
      *
      * const [account] = await window.ethereum.request({ method: "eth_requestAccounts" });
-     * const wallet = createWalletClient({ account, chain: arbitrum, transport: custom(window.ethereum) });
+     * const wallet = createWalletClient({ account, transport: custom(window.ethereum) });
      *
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      * ```
+     *
+     * @example External wallet (e.g. MetaMask) via `window.ethereum` directly
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet: window.ethereum, transport });
+     * ```
      */
     constructor(args) {
         /** The transport used to connect to the Hyperliquid API. */
@@ -91,7 +100,10 @@ export class WalletClient {
             writable: true,
             value: void 0
         });
-        /** The WalletClient/Account ([viem](https://viem.sh/docs/clients/wallet)) or Signer ([ethers.js](https://docs.ethers.org/v6/api/providers/#Signer)) used for signing transactions. */
+        /**
+         * The [viem](https://viem.sh/docs/clients/wallet) or [ethers.js](https://docs.ethers.org/v6/api/providers/#Signer)
+         * used for signing transactions.
+         */
         Object.defineProperty(this, "wallet", {
             enumerable: true,
             configurable: true,
@@ -112,20 +124,31 @@ export class WalletClient {
             writable: true,
             value: void 0
         });
+        /**
+         * The network that will be used to sign transactions.
+         * Must match the network of the {@link wallet}.
+         */
+        Object.defineProperty(this, "signatureChainId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.transport = args.transport;
         this.wallet = args.wallet;
         this.isTestnet = args.isTestnet ?? false;
         this.defaultVaultAddress = args.defaultVaultAddress;
+        this.signatureChainId = args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1");
     }
     // ———————————————Actions———————————————
     /**
      * Approve an agent to sign on behalf of the master or sub-accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -139,29 +162,35 @@ export class WalletClient {
      *   agentAddress: "0x...",
      *   agentName: "agentName",
      * });
+     * ```
      */
     async approveAgent(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "approveAgent",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             nonce: args.nonce ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:ApproveAgent": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "agentAddress", type: "address" },
-                { name: "agentName", type: "string" },
-                { name: "nonce", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.nonce,
-        };
+            types: {
+                "HyperliquidTransaction:ApproveAgent": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "agentAddress", type: "address" },
+                    { name: "agentName", type: "string" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -169,10 +198,10 @@ export class WalletClient {
      * Approve a max fee rate for a builder address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -186,29 +215,35 @@ export class WalletClient {
      *   maxFeeRate: "0.01%",
      *   builder: "0x...",
      * });
+     * ```
      */
     async approveBuilderFee(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "approveBuilderFee",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             nonce: args.nonce ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:ApproveBuilderFee": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "maxFeeRate", type: "string" },
-                { name: "builder", type: "address" },
-                { name: "nonce", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.nonce,
-        };
+            types: {
+                "HyperliquidTransaction:ApproveBuilderFee": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "maxFeeRate", type: "string" },
+                    { name: "builder", type: "address" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -216,10 +251,10 @@ export class WalletClient {
      * Modify multiple orders.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {OrderResponseSuccess} Successful variant of {@link OrderResponse} without error statuses.
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -250,16 +285,53 @@ export class WalletClient {
      * ```
      */
     async batchModify(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.batchModify({ type: "batchModify", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "batchModify",
+            modifies: actionArgs.modifies.map((modify) => {
+                const sortedModify = {
+                    oid: modify.oid,
+                    order: {
+                        a: modify.order.a,
+                        b: modify.order.b,
+                        p: modify.order.p,
+                        s: modify.order.s,
+                        r: modify.order.r,
+                        t: "limit" in modify.order.t
+                            ? {
+                                limit: {
+                                    tif: modify.order.t.limit.tif,
+                                },
+                            }
+                            : {
+                                trigger: {
+                                    isMarket: modify.order.t.trigger.isMarket,
+                                    triggerPx: modify.order.t.trigger.triggerPx,
+                                    tpsl: modify.order.t.trigger.tpsl,
+                                },
+                            },
+                        c: modify.order.c,
+                    },
+                };
+                if (sortedModify.order.c === undefined)
+                    delete sortedModify.order.c;
+                return sortedModify;
+            }),
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -267,10 +339,10 @@ export class WalletClient {
      * Cancel order(s).
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CancelResponseSuccess} Successful variant of {@link CancelResponse} without error statuses.
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -289,27 +361,127 @@ export class WalletClient {
      * ```
      */
     async cancel(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.cancel({ type: "cancel", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "cancel",
+            cancels: actionArgs.cancels.map((cancel) => ({
+                a: cancel.a,
+                o: cancel.o,
+            })),
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Deposit into staking balance.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.cDeposit({ wei: 1 * 1e8 });
+     * ```
+     */
+    async cDeposit(args, signal) {
+        // Construct an action
+        const action = {
+            ...args,
+            type: "cDeposit",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: this.signatureChainId,
+            nonce: args.nonce ?? Date.now(),
         };
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
+            action,
+            types: {
+                "HyperliquidTransaction:CDeposit": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "wei", type: "uint64" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
     /**
-     * Cancel order(s) by Client Order ID.
+     * Claim rewards from referral program.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CancelResponseSuccess} Successful variant of {@link CancelResponse} without error statuses.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid | Hyperliquid GitBook}
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.claimRewards();
+     * ```
+     */
+    async claimRewards(args = {}, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now() } = args;
+        // Construct an action
+        const sortedAction = { type: "claimRewards" };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action: sortedAction,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action: sortedAction, signature, nonce };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Cancel order(s) by cloid.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -328,16 +500,119 @@ export class WalletClient {
      * ```
      */
     async cancelByCloid(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.cancelByCloid({ type: "cancelByCloid", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "cancelByCloid",
+            cancels: actionArgs.cancels.map((cancel) => ({
+                asset: cancel.asset,
+                cloid: cancel.cloid,
+            })),
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Withdraw from staking balance.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#withdraw-from-staking
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.cWithdraw({ wei: 1 * 1e8 });
+     * ```
+     */
+    async cWithdraw(args, signal) {
+        // Construct an action
+        const action = {
+            ...args,
+            type: "cWithdraw",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: this.signatureChainId,
+            nonce: args.nonce ?? Date.now(),
         };
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
+            action,
+            types: {
+                "HyperliquidTransaction:CWithdraw": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "wei", type: "uint64" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Configure block type for EVM transactions.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Response for creating a sub-account.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/evm/dual-block-architecture
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.evmUserModify({ usingBigBlocks: true });
+     * ```
+     */
+    async evmUserModify(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "evmUserModify",
+            usingBigBlocks: actionArgs.usingBigBlocks,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -345,9 +620,10 @@ export class WalletClient {
      * Create a sub-account.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {CreateSubAccountResponse} Response for creating a sub-account.
+     * @returns Response for creating a sub-account.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -357,21 +633,28 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.createSubAccount({
-     *   name: "subAccountName",
-     * });
+     * const result = await client.createSubAccount({ name: "subAccountName" });
      * ```
      */
     async createSubAccount(args, signal) {
+        // Destructure the parameters
         const { nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.createSubAccount({ type: "createSubAccount", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce);
-        const request = {
-            action: sortedAction,
-            signature,
-            nonce,
+        // Construct an action
+        const action = {
+            type: "createSubAccount",
+            name: actionArgs.name,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -379,10 +662,10 @@ export class WalletClient {
      * Modify an order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -411,16 +694,48 @@ export class WalletClient {
      * ```
      */
     async modify(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.modify({ type: "modify", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "modify",
+            oid: actionArgs.oid,
+            order: {
+                a: actionArgs.order.a,
+                b: actionArgs.order.b,
+                p: actionArgs.order.p,
+                s: actionArgs.order.s,
+                r: actionArgs.order.r,
+                t: "limit" in actionArgs.order.t
+                    ? {
+                        limit: {
+                            tif: actionArgs.order.t.limit.tif,
+                        },
+                    }
+                    : {
+                        trigger: {
+                            isMarket: actionArgs.order.t.trigger.isMarket,
+                            triggerPx: actionArgs.order.t.trigger.triggerPx,
+                            tpsl: actionArgs.order.t.trigger.tpsl,
+                        },
+                    },
+                c: actionArgs.order.c,
+            },
+        };
+        if (action.order.c === undefined)
+            delete action.order.c;
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -428,10 +743,10 @@ export class WalletClient {
      * Place an order(s).
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {OrderResponseSuccess} Successful variant of {@link OrderResponse} without error statuses.
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -460,19 +775,59 @@ export class WalletClient {
      * ```
      */
     async order(args, signal) {
-        const clonedArgs = structuredClone(args); // Clone to prevent mutation of original object
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = clonedArgs;
-        if (actionArgs.builder)
-            actionArgs.builder.b = actionArgs.builder.b.toLowerCase();
-        const sortedAction = sorters.order({ type: "order", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Destructure the parameters
+        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "order",
+            orders: actionArgs.orders.map((order) => {
+                const sortedOrder = {
+                    a: order.a,
+                    b: order.b,
+                    p: order.p,
+                    s: order.s,
+                    r: order.r,
+                    t: "limit" in order.t
+                        ? {
+                            limit: {
+                                tif: order.t.limit.tif,
+                            },
+                        }
+                        : {
+                            trigger: {
+                                isMarket: order.t.trigger.isMarket,
+                                triggerPx: order.t.trigger.triggerPx,
+                                tpsl: order.t.trigger.tpsl,
+                            },
+                        },
+                    c: order.c,
+                };
+                if (order.c === undefined)
+                    delete sortedOrder.c;
+                return sortedOrder;
+            }),
+            grouping: actionArgs.grouping,
+            builder: actionArgs.builder
+                ? {
+                    b: actionArgs.builder.b.toLowerCase(),
+                    f: actionArgs.builder.f,
+                }
+                : actionArgs.builder,
+        };
+        if (action.builder === undefined)
+            delete action.builder;
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -480,10 +835,10 @@ export class WalletClient {
      * Schedule a time to cancel all open orders.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -493,22 +848,73 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.scheduleCancel({
-     *   time: Date.now() + 3600000, // Schedule cancellation 1 hour from now
-     * });
+     * const result = await client.scheduleCancel({ time: Date.now() + 3600000 });
      * ```
      */
     async scheduleCancel(args = {}, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.scheduleCancel({ type: "scheduleCancel", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "scheduleCancel",
+            time: actionArgs.time,
+        };
+        if (action.time === undefined)
+            delete action.time;
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        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 error response.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.setDisplayName({ displayName: "My Name" });
+     * ```
+     */
+    async setDisplayName(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "setDisplayName",
+            displayName: actionArgs.displayName,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -516,9 +922,10 @@ export class WalletClient {
      * Set a referral code.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -528,21 +935,28 @@ export class WalletClient {
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.WalletClient({ wallet, transport });
      *
-     * const result = await client.setReferrer({
-     *   code: "TEST",
-     * });
+     * const result = await client.setReferrer({ code: "TEST" });
      * ```
      */
     async setReferrer(args, signal) {
+        // Destructure the parameters
         const { nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.setReferrer({ type: "setReferrer", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce);
-        const request = {
-            action: sortedAction,
-            signature,
-            nonce,
+        // Construct an action
+        const action = {
+            type: "setReferrer",
+            code: actionArgs.code,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -550,10 +964,10 @@ export class WalletClient {
      * Transfer a spot asset on L1 to another address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-spot-transfer | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-spot-transfer
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -571,38 +985,140 @@ export class WalletClient {
      * ```
      */
     async spotSend(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "spotSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             time: args.time ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:SpotSend": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "destination", type: "string" },
-                { name: "token", type: "string" },
-                { name: "amount", type: "string" },
-                { name: "time", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.time,
+            types: {
+                "HyperliquidTransaction:SpotSend": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "destination", type: "string" },
+                    { name: "token", type: "string" },
+                    { name: "amount", type: "string" },
+                    { name: "time", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.time };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Opt Out of Spot Dusting.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.spotUser({
+     *   toggleSpotDusting: { optOut: false },
+     * });
+     * ```
+     */
+    async spotUser(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "spotUser",
+            toggleSpotDusting: {
+                optOut: actionArgs.toggleSpotDusting.optOut,
+            },
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Transfer between sub-accounts (spot).
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.subAccountSpotTransfer({
+     *   subAccountUser: "0x...",
+     *   isDeposit: true,
+     *   token: "USDC:0xeb62eee3685fc4c43992febcd9e75443",
+     *   amount: "1",
+     * });
+     * ```
+     */
+    async subAccountSpotTransfer(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "subAccountSpotTransfer",
+            subAccountUser: actionArgs.subAccountUser,
+            isDeposit: actionArgs.isDeposit,
+            token: actionArgs.token,
+            amount: actionArgs.amount,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
     /**
-     * Transfer between sub-accounts.
+     * Transfer between sub-accounts (perpetual).
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -615,20 +1131,86 @@ export class WalletClient {
      * const result = await client.subAccountTransfer({
      *   subAccountUser: "0x...",
      *   isDeposit: true,
-     *   usd: 1000000, // 1 USD in raw units (float amount * 1e6)
+     *   usd: 1 * 1e6,
      * });
      * ```
      */
     async subAccountTransfer(args, signal) {
+        // Destructure the parameters
         const { nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.subAccountTransfer({ type: "subAccountTransfer", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "subAccountTransfer",
+            subAccountUser: actionArgs.subAccountUser,
+            isDeposit: actionArgs.isDeposit,
+            usd: actionArgs.usd,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Delegate or undelegate stake from a validator.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.tokenDelegate({
+     *   validator: "0x...",
+     *   isUndelegate: true,
+     *   wei: 1 * 1e8,
+     * });
+     * ```
+     */
+    async tokenDelegate(args, signal) {
+        // Construct an action
+        const action = {
+            ...args,
+            type: "tokenDelegate",
+            hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: this.signatureChainId,
+            nonce: args.nonce ?? Date.now(),
         };
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
+            action,
+            types: {
+                "HyperliquidTransaction:TokenDelegate": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "validator", type: "address" },
+                    { name: "wei", type: "uint64" },
+                    { name: "isUndelegate", type: "bool" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -636,10 +1218,10 @@ export class WalletClient {
      * Cancel a TWAP order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {TwapCancelResponseSuccess} Successful variant of {@link TwapCancelResponse} without error status.
+     * @returns Successful variant of {@link TwapCancelResponse} without error status.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -656,16 +1238,26 @@ export class WalletClient {
      * ```
      */
     async twapCancel(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.twapCancel({ type: "twapCancel", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "twapCancel",
+            a: actionArgs.a,
+            t: actionArgs.t,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -673,10 +1265,10 @@ export class WalletClient {
      * Place a TWAP order.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {TwapOrderResponseSuccess} Successful variant of {@link TwapOrderResponse} without error status.
+     * @returns Successful variant of {@link TwapOrderResponse} without error status.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -697,16 +1289,32 @@ export class WalletClient {
      * ```
      */
     async twapOrder(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.twapOrder({ type: "twapOrder", twap: actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "twapOrder",
+            twap: {
+                a: actionArgs.a,
+                b: actionArgs.b,
+                s: actionArgs.s,
+                r: actionArgs.r,
+                m: actionArgs.m,
+                t: actionArgs.t,
+            },
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -714,10 +1322,10 @@ export class WalletClient {
      * Update isolated margin for a position.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -730,21 +1338,32 @@ export class WalletClient {
      * const result = await client.updateIsolatedMargin({
      *   asset: 0,
      *   isBuy: true, // Add to long position
-     *   ntli: 1000, // Add 1000 USD margin (integer only)
+     *   ntli: 1, // Add 1 USD margin (integer only)
      * });
      * ```
      */
     async updateIsolatedMargin(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.updateIsolatedMargin({ type: "updateIsolatedMargin", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "updateIsolatedMargin",
+            asset: actionArgs.asset,
+            isBuy: actionArgs.isBuy,
+            ntli: actionArgs.ntli,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -752,10 +1371,10 @@ export class WalletClient {
      * Update leverage for cross or isolated margin.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -773,16 +1392,27 @@ export class WalletClient {
      * ```
      */
     async updateLeverage(args, signal) {
+        // Destructure the parameters
         const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.updateLeverage({ type: "updateLeverage", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce, vaultAddress);
-        const request = {
-            action: sortedAction,
-            signature,
+        // Construct an action
+        const action = {
+            type: "updateLeverage",
+            asset: actionArgs.asset,
+            isCross: actionArgs.isCross,
+            leverage: actionArgs.leverage,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
             nonce,
+            isTestnet: this.isTestnet,
             vaultAddress,
-        };
+        });
+        // Send a request
+        const request = { action, signature, nonce, vaultAddress };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -790,10 +1420,10 @@ export class WalletClient {
      * Transfer funds between Spot and Perp accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -804,33 +1434,38 @@ export class WalletClient {
      * const client = new hl.WalletClient({ wallet, transport });
      *
      * const result = await client.usdClassTransfer({
-     *   amount: "1000",
+     *   amount: "1",
      *   toPerp: true, // Transfer from Spot to Perp
      * });
      * ```
      */
     async usdClassTransfer(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "usdClassTransfer",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             nonce: args.nonce ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:UsdClassTransfer": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "amount", type: "string" },
-                { name: "toPerp", type: "bool" },
-                { name: "nonce", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.nonce,
-        };
+            types: {
+                "HyperliquidTransaction:UsdClassTransfer": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "amount", type: "string" },
+                    { name: "toPerp", type: "bool" },
+                    { name: "nonce", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -838,10 +1473,10 @@ export class WalletClient {
      * Transfer USDC on L1 to another address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -853,43 +1488,142 @@ export class WalletClient {
      *
      * const result = await client.usdSend({
      *   destination: "0x...",
-     *   amount: "1000",
+     *   amount: "1",
      * });
      * ```
      */
     async usdSend(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "usdSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             time: args.time ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:UsdSend": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "destination", type: "string" },
-                { name: "amount", type: "string" },
-                { name: "time", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
+            action,
+            types: {
+                "HyperliquidTransaction:UsdSend": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "destination", type: "string" },
+                    { name: "amount", type: "string" },
+                    { name: "time", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.time };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Distribute funds from a vault between followers.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.vaultDistribute({
+     *   vaultAddress: "0x...",
+     *   usd: 10 * 1e6,
+     * });
+     * ```
+     */
+    async vaultDistribute(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "vaultDistribute",
+            vaultAddress: actionArgs.vaultAddress,
+            usd: actionArgs.usd,
+        };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.time,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
+        const response = await this.transport.request("action", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
+    /**
+     * Modify a vault's configuration.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * const result = await client.vaultModify({
+     *   vaultAddress: "0x...",
+     *   allowDeposits: true,
+     *   alwaysCloseOnWithdraw: false,
+     * });
+     * ```
+     */
+    async vaultModify(args, signal) {
+        // Destructure the parameters
+        const { nonce = Date.now(), ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "vaultModify",
+            vaultAddress: actionArgs.vaultAddress,
+            allowDeposits: actionArgs.allowDeposits,
+            alwaysCloseOnWithdraw: actionArgs.alwaysCloseOnWithdraw,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
     /**
-     * Transfer funds to/from a vault.
+     * Add or remove funds from a vault.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -902,20 +1636,31 @@ export class WalletClient {
      * const result = await client.vaultTransfer({
      *   vaultAddress: "0x...",
      *   isDeposit: true,
-     *   usd: 1000000, // 1 USD in raw units (float amount * 1e6)
+     *   usd: 10 * 1e6,
      * });
      * ```
      */
     async vaultTransfer(args, signal) {
+        // Destructure the parameters
         const { nonce = Date.now(), ...actionArgs } = args;
-        const sortedAction = sorters.vaultTransfer({ type: "vaultTransfer", ...actionArgs });
-        const signature = await signL1Action(this.wallet, this.isTestnet, sortedAction, nonce);
-        const request = {
-            action: sortedAction,
-            signature,
-            nonce,
+        // Construct an action
+        const action = {
+            type: "vaultTransfer",
+            vaultAddress: actionArgs.vaultAddress,
+            isDeposit: actionArgs.isDeposit,
+            usd: actionArgs.usd,
         };
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }
@@ -923,10 +1668,10 @@ export class WalletClient {
      * Initiate a withdrawal request.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns {SuccessResponse} Successful response without specific data.
+     * @returns Successful response without specific data.
      * @throws {ApiRequestError} When the API returns an error response.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -938,32 +1683,37 @@ export class WalletClient {
      *
      * const result = await client.withdraw3({
      *   destination: "0x...",
-     *   amount: "1000",
+     *   amount: "1",
      * });
      * ```
      */
     async withdraw3(args, signal) {
+        // Construct an action
         const action = {
             ...args,
             type: "withdraw3",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
-            signatureChainId: args.signatureChainId ?? this.isTestnet ? "0x66eee" : "0xa4b1",
+            signatureChainId: this.signatureChainId,
             time: args.time ?? Date.now(),
         };
-        const signature = await signUserSignedAction(this.wallet, action, {
-            "HyperliquidTransaction:Withdraw": [
-                { name: "hyperliquidChain", type: "string" },
-                { name: "destination", type: "string" },
-                { name: "amount", type: "string" },
-                { name: "time", type: "uint64" },
-            ],
-        }, parseInt(action.signatureChainId, 16));
-        const request = {
+        // Sign the action
+        const signature = await signUserSignedAction({
+            wallet: this.wallet,
             action,
-            signature,
-            nonce: action.time,
-        };
+            types: {
+                "HyperliquidTransaction:Withdraw": [
+                    { name: "hyperliquidChain", type: "string" },
+                    { name: "destination", type: "string" },
+                    { name: "amount", type: "string" },
+                    { name: "time", type: "uint64" },
+                ],
+            },
+            chainId: parseInt(action.signatureChainId, 16),
+        });
+        // Send a request
+        const request = { action, signature, nonce: action.time };
         const response = await this.transport.request("action", request, signal);
+        // Validate a response
         this._validateResponse(response);
         return response;
     }