@nktkas/hyperliquid 0.23.1 → 0.24.1

package/script/src/types/exchange/requests.d.ts

@@ -1,14 +1,29 @@
-import type { Hex } from "../../base.js";
+import type { Hex } from "../mod.js";
 import type { TIF } from "../info/orders.js";
+/** ECDSA signature components for Ethereum typed data. */
+export interface Signature {
+    /** First 32-byte component of ECDSA signature. */
+    r: Hex;
+    /** Second 32-byte component of ECDSA signature. */
+    s: Hex;
+    /** Recovery identifier. */
+    v: 27 | 28;
+}
 /** Order parameters. */
 export type OrderParams = {
     /** Asset ID. */
     a: number;
     /** Position side (`true` for long, `false` for short). */
     b: boolean;
-    /** Price. */
+    /**
+     * Price.
+     * @pattern ^[0-9]+(\.[0-9]+)?$
+     */
     p: string;
-    /** Size (in base currency units). */
+    /**
+     * Size (in base currency units).
+     * @pattern ^[0-9]+(\.[0-9]+)?$
+     */
     s: string;
     /** Is reduce-only? */
     r: boolean;
@@ -24,42 +39,25 @@ export type OrderParams = {
         trigger: {
             /** Is market order? */
             isMarket: boolean;
-            /** Trigger price. */
+            /**
+             * Trigger price.
+             * @pattern ^[0-9]+(\.[0-9]+)?$
+             */
             triggerPx: string;
             /** Indicates whether it is take profit or stop loss. */
             tpsl: "tp" | "sl";
         };
     };
     /** Client Order ID. */
-    c?: Hex | null;
+    c?: Hex;
 };
-/** Base structure for exchange requests. */
-export interface BaseExchangeRequest {
-    /** Action to perform. */
-    action: {
-        /** Type of action. */
-        type: string;
-        /** Additional parameters. */
-        [key: string]: any;
-    };
-    /** Unique request identifier (current timestamp in ms). */
-    nonce: number;
-    /** Cryptographic signature. */
-    signature: {
-        r: Hex;
-        s: Hex;
-        v: number;
-    };
-    /** Vault address (for vault trading). */
-    vaultAddress?: Hex;
-    /** Expiration time of the action. */
-    expiresAfter?: number;
-}
 /**
  * Approve an agent to sign on behalf of the master account.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
  */
-export interface ApproveAgentRequest extends BaseExchangeRequest {
+export interface ApproveAgentRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "approveAgent";
@@ -69,19 +67,23 @@ export interface ApproveAgentRequest extends BaseExchangeRequest {
         hyperliquidChain: "Mainnet" | "Testnet";
         /** Agent address. */
         agentAddress: Hex;
-        /** Agent name or undefined for unnamed agent. */
-        agentName?: string | null;
+        /** Agent name or null for unnamed agent. */
+        agentName: string | null;
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Approve a maximum fee rate for a builder.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
  */
-export interface ApproveBuilderFeeRequest extends BaseExchangeRequest {
+export interface ApproveBuilderFeeRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "approveBuilderFee";
@@ -96,33 +98,45 @@ export interface ApproveBuilderFeeRequest extends BaseExchangeRequest {
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Modify multiple orders.
  * @returns {OrderResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
  */
-export interface BatchModifyRequest extends BaseExchangeRequest {
+export interface BatchModifyRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "batchModify";
         /** Order modifications. */
         modifies: {
-            /** Order ID or CLient Order ID. */
+            /** Order ID or Client Order ID. */
             oid: number | Hex;
             /** New order parameters. */
             order: OrderParams;
         }[];
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Cancel order(s).
  * @returns {CancelResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
  */
-export interface CancelRequest extends BaseExchangeRequest {
+export interface CancelRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "cancel";
@@ -134,14 +148,22 @@ export interface CancelRequest extends BaseExchangeRequest {
             o: number;
         }[];
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Cancel order(s) by cloid.
  * @returns {CancelResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
  */
-export interface CancelByCloidRequest extends BaseExchangeRequest {
+export interface CancelByCloidRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "cancelByCloid";
@@ -153,14 +175,22 @@ export interface CancelByCloidRequest extends BaseExchangeRequest {
             cloid: Hex;
         }[];
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
- * Transfer native token from the user's spot account into staking for delegating to validators.
+ * Transfer native token from the user spot account into staking for delegating to validators.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking
  */
-export interface CDepositRequest extends BaseExchangeRequest {
+export interface CDepositRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "cDeposit";
@@ -173,26 +203,36 @@ export interface CDepositRequest extends BaseExchangeRequest {
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Claim rewards from referral program.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface ClaimRewardsRequest extends BaseExchangeRequest {
+export interface ClaimRewardsRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "claimRewards";
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Convert a single-signature account to a multi-signature account.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig
  */
-export interface ConvertToMultiSigUserRequest extends BaseExchangeRequest {
+export interface ConvertToMultiSigUserRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "convertToMultiSigUser";
@@ -203,17 +243,43 @@ export interface ConvertToMultiSigUserRequest extends BaseExchangeRequest {
         /**
          * Signers configuration.
          *
-         * Must be {@linkcode ConvertToMultiSigUserRequest_Signers} converted to a string via `JSON.stringify(...)`.
+         * Must be {@linkcode ConvertToMultiSigUserRequestSigners} converted to a string via `JSON.stringify(...)`.
          */
         signers: string;
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+}
+/**
+ * Convert a single-signature account to a multi-signature account (without JSON.stringify).
+ * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig
+ */
+export interface ConvertToMultiSigUserRequestWithoutStringify {
+    /** Action to perform. */
+    action: {
+        /** Type of action. */
+        type: "convertToMultiSigUser";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Signers configuration. */
+        signers: ConvertToMultiSigUserRequestSigners;
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: number;
+    };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /** Signers configuration for {@linkcode ConvertToMultiSigUserRequest}. */
-export type ConvertToMultiSigUserRequest_Signers = {
+export type ConvertToMultiSigUserRequestSigners = {
     /** List of authorized user addresses. */
     authorizedUsers: Hex[];
     /** Minimum number of signatures required. */
@@ -224,22 +290,30 @@ export type ConvertToMultiSigUserRequest_Signers = {
 /**
  * Create a sub-account.
  * @returns {CreateSubAccountResponse}
+ * @see null
  */
-export interface CreateSubAccountRequest extends BaseExchangeRequest {
+export interface CreateSubAccountRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "createSubAccount";
         /** Sub-account name. */
         name: string;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Create a vault.
  * @returns {CreateVaultResponse}
+ * @see null
  */
-export interface CreateVaultRequest extends BaseExchangeRequest {
+export interface CreateVaultRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "createVault";
@@ -252,75 +326,74 @@ export interface CreateVaultRequest extends BaseExchangeRequest {
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
- * Jail a signer to prevent them from signing transactions.
+ * Perform an action on a signer:
+ * - Jail to prevent them from signing transactions.
+ * - Unjail to allow them to sign transactions again.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface CSignerActionRequest_JailSelf extends BaseExchangeRequest {
+export interface CSignerActionRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "CSignerAction";
         /** Jail the signer. */
         jailSelf: null;
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: number;
-}
-/**
- * Unjail a signer to allow them to sign transactions again.
- * @returns {SuccessResponse}
- */
-export interface CSignerActionRequest_UnjailSelf extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "CSignerAction";
         /** Unjail the signer. */
         unjailSelf: null;
     };
-    vaultAddress?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
- * Change a validator's profile information.
+ * Perform an action on a validator:
+ * - Change profile information.
+ * - Register a new validator.
+ * - Unregister an existing validator.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface CValidatorActionRequest_ChangeProfile extends BaseExchangeRequest {
+export interface CValidatorActionRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "CValidatorAction";
         /** Profile changes to apply. */
         changeProfile: {
             /** Validator node IP address. */
-            node_ip?: {
+            node_ip: {
                 /** IP address. */
                 Ip: string;
             } | null;
             /** Validator name. */
-            name?: string | null;
+            name: string | null;
             /** Validator description. */
-            description?: string | null;
+            description: string | null;
             /** Validator jail status. */
             unjailed: boolean;
             /** Enable or disable delegations. */
-            disable_delegations?: boolean | null;
+            disable_delegations: boolean | null;
             /** Commission rate in basis points (1 = 0.0001%). */
-            commission_bps?: number | null;
+            commission_bps: number | null;
             /** Signer address. */
-            signer?: Hex | null;
+            signer: Hex | null;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: number;
-}
-/**
- * Register a new validator.
- * @returns {SuccessResponse}
- */
-export interface CValidatorActionRequest_Register extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "CValidatorAction";
         /** Registration parameters. */
@@ -348,29 +421,26 @@ export interface CValidatorActionRequest_Register extends BaseExchangeRequest {
             /** Initial stake amount in wei. */
             initial_wei: number;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: number;
-}
-/**
- * Unregister an existing validator.
- * @returns {SuccessResponse}
- */
-export interface CValidatorActionRequest_Unregister extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "CValidatorAction";
         /** Unregister the validator. */
         unregister: null;
     };
-    vaultAddress?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
- * Transfer native token from staking into the user's spot account.
+ * Transfer native token from staking into the user spot account.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#withdraw-from-staking
  */
-export interface CWithdrawRequest extends BaseExchangeRequest {
+export interface CWithdrawRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "cWithdraw";
@@ -383,73 +453,113 @@ export interface CWithdrawRequest extends BaseExchangeRequest {
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Configure block type for EVM transactions.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
  */
-export interface EvmUserModifyRequest extends BaseExchangeRequest {
+export interface EvmUserModifyRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "evmUserModify";
         /** `true` for large blocks, `false` for small blocks. */
         usingBigBlocks: boolean;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Modify an order.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order
  */
-export interface ModifyRequest extends BaseExchangeRequest {
+export interface ModifyRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "modify";
-        /** Order ID or CLient Order ID. */
+        /** Order ID or Client Order ID. */
         oid: number | Hex;
         /** New order parameters. */
         order: OrderParams;
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * A multi-signature request.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig
  */
-export interface MultiSigRequest extends BaseExchangeRequest {
+export interface MultiSigRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "multiSig";
         /** Chain ID used for signing. */
         signatureChainId: Hex;
         /** List of signatures from authorized signers. */
-        signatures: {
-            r: Hex;
-            s: Hex;
-            v: number;
-        }[];
+        signatures: Signature[];
         /** Multi-signature payload information. */
         payload: {
             /** Address of the multi-signature user account. */
             multiSigUser: Hex;
-            /** Address of the authorized user initiating the request. */
+            /** Address of the authorized user initiating the request (any authorized user). */
             outerSigner: Hex;
             /** The underlying action to be executed through multi-sig. */
-            action: BaseExchangeRequest["action"];
+            action: ApproveAgentRequest["action"] | ApproveBuilderFeeRequest["action"] | BatchModifyRequest["action"] | CancelRequest["action"] | CancelByCloidRequest["action"] | CDepositRequest["action"] | ClaimRewardsRequest["action"] | (ConvertToMultiSigUserRequest["action"] | ConvertToMultiSigUserRequestWithoutStringify["action"]) | CreateSubAccountRequest["action"] | CreateVaultRequest["action"] | CSignerActionRequest["action"] | CValidatorActionRequest["action"] | CWithdrawRequest["action"] | EvmUserModifyRequest["action"] | ModifyRequest["action"] | NoopRequest["action"] | MultiSigRequest["action"] | OrderRequest["action"] | PerpDeployRequest["action"] | RegisterReferrerRequest["action"] | ReserveRequestWeightRequest["action"] | ScheduleCancelRequest["action"] | SendAssetRequest["action"] | SetDisplayNameRequest["action"] | SetReferrerRequest["action"] | SpotDeployRequest["action"] | SpotSendRequest["action"] | SpotUserRequest["action"] | SubAccountModifyRequest["action"] | SubAccountSpotTransferRequest["action"] | SubAccountTransferRequest["action"] | TokenDelegateRequest["action"] | TwapCancelRequest["action"] | TwapOrderRequest["action"] | UpdateIsolatedMarginRequest["action"] | UpdateLeverageRequest["action"] | UsdClassTransferRequest["action"] | UsdSendRequest["action"] | VaultDistributeRequest["action"] | VaultModifyRequest["action"] | VaultTransferRequest["action"] | Withdraw3Request["action"];
         };
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
+}
+/**
+ * This action does not do anything (no operation), but causes the nonce to be marked as used.
+ * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#invalidate-pending-nonce-noop
+ */
+export interface NoopRequest {
+    /** Action to perform. */
+    action: {
+        /** Type of action. */
+        type: "noop";
+    };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Place an order(s).
  * @returns {OrderResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
  */
-export interface OrderRequest extends BaseExchangeRequest {
+export interface OrderRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "order";
@@ -470,154 +580,126 @@ export interface OrderRequest extends BaseExchangeRequest {
             f: number;
         };
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
- * Deploying HIP-3 assets (Register Asset).
+ * Deploying HIP-3 assets:
+ * - Register Asset
+ * - Set Oracle
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/deploying-hip-3-assets
  */
-export interface PerpDeployRequest_RegisterAsset extends BaseExchangeRequest {
+export interface PerpDeployRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "perpDeploy";
         /** Parameters for registering a new perpetual asset. */
         registerAsset: {
             /** Max gas in native token wei. If not provided, then uses current deploy auction price. */
-            maxGas?: number | null;
+            maxGas: number | null;
             /** Contains new asset listing parameters. */
             assetRequest: {
                 /** Coin symbol for the new asset. */
                 coin: string;
                 /** Number of decimal places for size. */
                 szDecimals: number;
-                /** Initial oracle price for the asset. */
+                /**
+                 * Initial oracle price for the asset.
+                 * @pattern ^[0-9]+(\.[0-9]+)?$
+                 */
                 oraclePx: string;
                 /** Margin table identifier for risk management. */
                 marginTableId: number;
                 /** Whether the asset can only be traded with isolated margin. */
                 onlyIsolated: boolean;
             };
-            /** Name of the perp dex (<= 6 characters). */
+            /** Name of the dex. */
             dex: string;
-            /** Contains new perp dex parameters. */
-            schema?: {
-                /** Full name of the perp dex. */
+            /** Contains new dex parameters. */
+            schema: {
+                /** Full name of the dex. */
                 fullName: string;
                 /** Collateral token index. */
                 collateralToken: number;
                 /** User to update oracles. If not provided, then deployer is assumed to be oracle updater. */
-                oracleUpdater?: Hex | null;
+                oracleUpdater: Hex | null;
             } | null;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-3 assets (Set Oracle).
- * @returns {SuccessResponse}
- */
-export interface PerpDeployRequest_SetOracle extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "perpDeploy";
         /** Parameters for setting oracle and mark prices for assets. */
         setOracle: {
-            /** Name of the perp dex (<= 6 characters). */
+            /** Name of the dex. */
             dex: string;
             /** A list (sorted by key) of asset and oracle prices. */
             oraclePxs: [string, string][];
-            /** A list (sorted by key) of asset and mark prices. */
-            markPxs: [string, string][];
+            /** An outer list of inner lists (inner list sorted by key) of asset and mark prices. */
+            markPxs: [string, string][][];
         };
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Transfer funds between Spot account and Perp dex account.
- * @returns {SuccessResponse}
- */
-export interface PerpDexClassTransferRequest extends BaseExchangeRequest {
-    action: {
-        /** Type of action. */
-        type: "PerpDexClassTransfer";
-        /** Chain ID used for signing. */
-        signatureChainId: Hex;
-        /** HyperLiquid network. */
-        hyperliquidChain: "Mainnet" | "Testnet";
-        /** Name of perp dex. */
-        dex: string;
-        /** Collateral token of the perp dex as a string. */
-        token: string;
-        /** Amount of collateral token to transfer (1 = 1$). */
-        amount: string;
-        /** `true` for transferring from perp dex to spot account, `false` for transferring from spot account to perp dex. */
-        toPerp: boolean;
-        /** Unique request identifier (current timestamp in ms). */
-        nonce: number;
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Transfer collateral tokens between different perp dexes for the same user.
- * @returns {SuccessResponse}
- */
-export interface PerpDexTransferRequest extends BaseExchangeRequest {
-    action: {
-        /** Type of action. */
-        type: "PerpDexTransfer";
-        /** Chain ID used for signing. */
-        signatureChainId: Hex;
-        /** HyperLiquid network. */
-        hyperliquidChain: "Mainnet" | "Testnet";
-        /** Source perp dex name (empty string for main dex). */
-        sourceDex: string;
-        /** Destination perp dex name (empty string for main dex). */
-        destinationDex: string;
-        /** Amount to transfer (1 = 1$). */
-        amount: string;
-        /** Unique request identifier (current timestamp in ms). */
-        nonce: number;
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Create a referral code.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface RegisterReferrerRequest extends BaseExchangeRequest {
+export interface RegisterReferrerRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "registerReferrer";
         /** Referral code to create. */
         code: string;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Reserve additional rate-limited actions for a fee.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#reserve-additional-actions
  */
-export interface ReserveRequestWeightRequest extends BaseExchangeRequest {
+export interface ReserveRequestWeightRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "reserveRequestWeight";
         /** Amount of request weight to reserve. */
         weight: number;
     };
-    vaultAddress?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Schedule a cancel-all operation at a future time.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch
  */
-export interface ScheduleCancelRequest extends BaseExchangeRequest {
+export interface ScheduleCancelRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "scheduleCancel";
@@ -629,14 +711,59 @@ export interface ScheduleCancelRequest extends BaseExchangeRequest {
          */
         time?: number;
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
+/**
+ * Transfer tokens between different perp DEXs, spot balance, users, and/or sub-accounts.
+ * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset-testnet-only
+ */
+export interface SendAssetRequest {
+    /** Action to perform. */
+    action: {
+        /** Type of action. */
+        type: "sendAsset";
+        /** Chain ID used for signing. */
+        signatureChainId: Hex;
+        /** HyperLiquid network. */
+        hyperliquidChain: "Mainnet" | "Testnet";
+        /** Destination address. */
+        destination: Hex;
+        /** Source DEX ("" for default USDC perp DEX, "spot" for spot). */
+        sourceDex: string | "";
+        /** Destination DEX ("" for default USDC perp DEX, "spot" for spot). */
+        destinationDex: string | "";
+        /** Token identifier. */
+        token: `${string}:${Hex}`;
+        /**
+         * Amount to send (not in wei).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
+        amount: string;
+        /** Source sub-account address ("" for main account). */
+        fromSubAccount: Hex | "";
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: number;
+    };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+}
 /**
  * Set the display name in the leaderboard.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface SetDisplayNameRequest extends BaseExchangeRequest {
+export interface SetDisplayNameRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "setDisplayName";
@@ -647,28 +774,46 @@ export interface SetDisplayNameRequest extends BaseExchangeRequest {
          */
         displayName: string;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Set a referral code.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface SetReferrerRequest extends BaseExchangeRequest {
+export interface SetReferrerRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "setReferrer";
         /** Referral code. */
         code: string;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
- * Deploying HIP-1 and HIP-2 assets (Genesis).
+ * Deploying HIP-1 and HIP-2 assets:
+ * - Genesis
+ * - Register Hyperliquidity
+ * - Register Spot
+ * - Register Token2
+ * - Set Deployer Trading Fee Share
+ * - User Genesis
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/deploying-hip-1-and-hip-2-assets
  */
-export interface SpotDeployRequest_Genesis extends BaseExchangeRequest {
+export interface SpotDeployRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "spotDeploy";
@@ -676,46 +821,37 @@ export interface SpotDeployRequest_Genesis extends BaseExchangeRequest {
         genesis: {
             /** Token identifier. */
             token: number;
-            /** Maximum token supply. */
+            /**
+             * Maximum token supply.
+             * @pattern ^[0-9]+(\.[0-9]+)?$
+             */
             maxSupply: string;
             /** Set hyperliquidity balance to 0. */
             noHyperliquidity?: true;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-1 and HIP-2 assets (Register Hyperliquidity).
- * @returns {SuccessResponse}
- */
-export interface SpotDeployRequest_RegisterHyperliquidity extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "spotDeploy";
         /** Register hyperliquidity parameters. */
         registerHyperliquidity: {
             /** Spot index (distinct from base token index). */
             spot: number;
-            /** Starting price for liquidity seeding. */
+            /**
+             * Starting price for liquidity seeding.
+             * @pattern ^[0-9]+(\.[0-9]+)?$
+             */
             startPx: string;
-            /** Order size as a float (not in wei). */
+            /**
+             * Order size as a float (not in wei).
+             * @pattern ^[0-9]+(\.[0-9]+)?$
+             */
             orderSz: string;
             /** Total number of orders to place. */
             nOrders: number;
             /** Number of levels to seed with USDC. */
             nSeededLevels?: number;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-1 and HIP-2 assets (Register Spot).
- * @returns {SuccessResponse}
- */
-export interface SpotDeployRequest_RegisterSpot extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "spotDeploy";
         /** Register spot parameters. */
@@ -723,16 +859,7 @@ export interface SpotDeployRequest_RegisterSpot extends BaseExchangeRequest {
             /** Tuple containing base and quote token indices. */
             tokens: [number, number];
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-1 and HIP-2 assets (Register Token).
- * @returns {SuccessResponse}
- */
-export interface SpotDeployRequest_RegisterToken2 extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "spotDeploy";
         /** Register token parameters. */
@@ -751,35 +878,17 @@ export interface SpotDeployRequest_RegisterToken2 extends BaseExchangeRequest {
             /** Optional full token name. */
             fullName?: string;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-1 and HIP-2 assets (Set Deployer Trading Fee Share).
- * @returns {SuccessResponse}
- */
-export interface SpotDeployRequest_SetDeployerTradingFeeShare extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "spotDeploy";
         /** Set deployer trading fee share parameters. */
         setDeployerTradingFeeShare: {
             /** Token identifier. */
             token: number;
-            /**  The deployer trading fee share. Range: ["0%", "100%"]. */
+            /** The deployer trading fee share. Range is 0% to 100%. */
             share: `${string}%`;
         };
-    };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
-}
-/**
- * Deploying HIP-1 and HIP-2 assets (User Genesis).
- * @returns {SuccessResponse}
- */
-export interface SpotDeployRequest_UserGenesis extends BaseExchangeRequest {
-    action: {
+    } | {
         /** Type of action. */
         type: "spotDeploy";
         /** User genesis parameters. */
@@ -787,21 +896,27 @@ export interface SpotDeployRequest_UserGenesis extends BaseExchangeRequest {
             /** Token identifier. */
             token: number;
             /** Array of tuples: [user address, genesis amount in wei]. */
-            userAndWei: [string, string][];
+            userAndWei: [Hex, string][];
             /** Array of tuples: [existing token identifier, genesis amount in wei]. */
             existingTokenAndWei: [number, string][];
             /** Array of tuples: [user address, blacklist status] (`true` for blacklist, `false` to remove existing blacklisted user). */
-            blacklistUsers?: [string, boolean][];
+            blacklistUsers?: [Hex, boolean][];
         };
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Send spot assets to another address.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#core-spot-transfer
  */
-export interface SpotSendRequest extends BaseExchangeRequest {
+export interface SpotSendRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "spotSend";
@@ -813,19 +928,26 @@ export interface SpotSendRequest extends BaseExchangeRequest {
         destination: Hex;
         /** Token identifier. */
         token: `${string}:${Hex}`;
-        /** Amount to send (not in wei). */
+        /**
+         * Amount to send (not in wei).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
         amount: string;
         /** Unique request identifier (current timestamp in ms). */
         time: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Opt Out of Spot Dusting.
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface SpotUserRequest extends BaseExchangeRequest {
+export interface SpotUserRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "spotUser";
@@ -835,14 +957,42 @@ export interface SpotUserRequest extends BaseExchangeRequest {
             optOut: boolean;
         };
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
+}
+/**
+ * Modify a sub-account.
+ * @returns {SuccessResponse}
+ * @see null
+ */
+export interface SubAccountModifyRequest {
+    /** Action to perform. */
+    action: {
+        /** Type of action. */
+        type: "subAccountModify";
+        /** Sub-account address to modify. */
+        subAccountUser: Hex;
+        /** New sub-account name. */
+        name: string;
+    };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Transfer between sub-accounts (spot).
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface SubAccountSpotTransferRequest extends BaseExchangeRequest {
+export interface SubAccountSpotTransferRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "subAccountSpotTransfer";
@@ -852,17 +1002,26 @@ export interface SubAccountSpotTransferRequest extends BaseExchangeRequest {
         isDeposit: boolean;
         /** Token identifier. */
         token: `${string}:${Hex}`;
-        /** Amount to send (not in wei). */
+        /**
+         * Amount to send (not in wei).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
         amount: string;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Transfer between sub-accounts (perpetual).
  * @returns {SuccessResponse}
+ * @see null
  */
-export interface SubAccountTransferRequest extends BaseExchangeRequest {
+export interface SubAccountTransferRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "subAccountTransfer";
@@ -873,14 +1032,20 @@ export interface SubAccountTransferRequest extends BaseExchangeRequest {
         /** Amount to transfer (float * 1e6). */
         usd: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Delegate or undelegate native tokens to or from a validator.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
  */
-export interface TokenDelegateRequest extends BaseExchangeRequest {
+export interface TokenDelegateRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "tokenDelegate";
@@ -897,14 +1062,18 @@ export interface TokenDelegateRequest extends BaseExchangeRequest {
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Cancel a TWAP order.
  * @returns {TwapCancelResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order
  */
-export interface TwapCancelRequest extends BaseExchangeRequest {
+export interface TwapCancelRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "twapCancel";
@@ -913,14 +1082,22 @@ export interface TwapCancelRequest extends BaseExchangeRequest {
         /** Twap ID. */
         t: number;
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Place a TWAP order.
  * @returns {TwapOrderResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order
  */
-export interface TwapOrderRequest extends BaseExchangeRequest {
+export interface TwapOrderRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "twapOrder";
@@ -930,7 +1107,10 @@ export interface TwapOrderRequest extends BaseExchangeRequest {
             a: number;
             /** Position side (`true` for long, `false` for short). */
             b: boolean;
-            /** Size (in base currency units). */
+            /**
+             * Size (in base currency units).
+             * @pattern ^[0-9]+(\.[0-9]+)?$
+             */
             s: string;
             /** Is reduce-only? */
             r: boolean;
@@ -940,14 +1120,22 @@ export interface TwapOrderRequest extends BaseExchangeRequest {
             t: boolean;
         };
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Add or remove margin from isolated position.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin
  */
-export interface UpdateIsolatedMarginRequest extends BaseExchangeRequest {
+export interface UpdateIsolatedMarginRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "updateIsolatedMargin";
@@ -958,14 +1146,22 @@ export interface UpdateIsolatedMarginRequest extends BaseExchangeRequest {
         /** Amount to adjust (float * 1e6). */
         ntli: number;
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Update cross or isolated leverage on a coin.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage
  */
-export interface UpdateLeverageRequest extends BaseExchangeRequest {
+export interface UpdateLeverageRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "updateLeverage";
@@ -976,14 +1172,22 @@ export interface UpdateLeverageRequest extends BaseExchangeRequest {
         /** New leverage value. */
         leverage: number;
     };
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
     vaultAddress?: Hex;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Transfer funds between Spot account and Perp account.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa
  */
-export interface UsdClassTransferRequest extends BaseExchangeRequest {
+export interface UsdClassTransferRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "usdClassTransfer";
@@ -991,21 +1195,28 @@ export interface UsdClassTransferRequest extends BaseExchangeRequest {
         signatureChainId: Hex;
         /** HyperLiquid network. */
         hyperliquidChain: "Mainnet" | "Testnet";
-        /** Amount to transfer (1 = 1$). */
+        /**
+         * Amount to transfer (1 = 1$).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
         amount: string;
         /** `true` for Spot to Perp, `false` for Perp to Spot. */
         toPerp: boolean;
         /** Unique request identifier (current timestamp in ms). */
         nonce: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Send usd to another address.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#core-usdc-transfer
  */
-export interface UsdSendRequest extends BaseExchangeRequest {
+export interface UsdSendRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "usdSend";
@@ -1015,19 +1226,26 @@ export interface UsdSendRequest extends BaseExchangeRequest {
         hyperliquidChain: "Mainnet" | "Testnet";
         /** Destination address. */
         destination: Hex;
-        /** Amount to send (1 = 1$). */
+        /**
+         * Amount to send (1 = 1$).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
         amount: string;
         /** Unique request identifier (current timestamp in ms). */
         time: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 /**
  * Distribute funds from a vault between followers.
  * @returns {SuccessResponse}
+ *  @see null
  */
-export interface VaultDistributeRequest extends BaseExchangeRequest {
+export interface VaultDistributeRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "vaultDistribute";
@@ -1040,14 +1258,20 @@ export interface VaultDistributeRequest extends BaseExchangeRequest {
          */
         usd: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Vault address (for vault trading). */
+    expiresAfter?: number;
 }
 /**
- * Modify a vault's configuration.
+ * Modify a vault configuration.
  * @returns {SuccessResponse}
+ *  @see null
  */
-export interface VaultModifyRequest extends BaseExchangeRequest {
+export interface VaultModifyRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "vaultModify";
@@ -1058,14 +1282,20 @@ export interface VaultModifyRequest extends BaseExchangeRequest {
         /** Always close positions on withdrawal. */
         alwaysCloseOnWithdraw: boolean | null;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
+    expiresAfter?: number;
 }
 /**
  * Deposit or withdraw from a vault.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault
  */
-export interface VaultTransferRequest extends BaseExchangeRequest {
+export interface VaultTransferRequest {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "vaultTransfer";
@@ -1076,14 +1306,20 @@ export interface VaultTransferRequest extends BaseExchangeRequest {
         /** Amount for deposit/withdrawal (float * 1e6). */
         usd: number;
     };
-    vaultAddress?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
+    /** Expiration time of the action. */
     expiresAfter?: number;
 }
 /**
  * Initiate a withdrawal request.
  * @returns {SuccessResponse}
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request
  */
-export interface Withdraw3Request extends BaseExchangeRequest {
+export interface Withdraw3Request {
+    /** Action to perform. */
     action: {
         /** Type of action. */
         type: "withdraw3";
@@ -1093,12 +1329,17 @@ export interface Withdraw3Request extends BaseExchangeRequest {
         hyperliquidChain: "Mainnet" | "Testnet";
         /** Destination address. */
         destination: Hex;
-        /** Amount to withdraw (1 = 1$). */
+        /**
+         * Amount to withdraw (1 = 1$).
+         * @pattern ^[0-9]+(\.[0-9]+)?$
+         */
         amount: string;
         /** Unique request identifier (current timestamp in ms). */
         time: number;
     };
-    vaultAddress?: undefined;
-    expiresAfter?: undefined;
+    /** Unique request identifier (current timestamp in ms). */
+    nonce: number;
+    /** Cryptographic signature. */
+    signature: Signature;
 }
 //# sourceMappingURL=requests.d.ts.map