@nktkas/hyperliquid 0.30.3 → 0.31.0

package/script/src/api/exchange/client.d.ts

@@ -1,5 +1,6 @@
 import type { ExchangeConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
 import { type AgentEnableDexAbstractionOptions, type AgentEnableDexAbstractionSuccessResponse } from "./_methods/agentEnableDexAbstraction.js";
+import { type AgentSetAbstractionOptions, type AgentSetAbstractionParameters, type AgentSetAbstractionSuccessResponse } from "./_methods/agentSetAbstraction.js";
 import { type ApproveAgentOptions, type ApproveAgentParameters, type ApproveAgentSuccessResponse } from "./_methods/approveAgent.js";
 import { type ApproveBuilderFeeOptions, type ApproveBuilderFeeParameters, type ApproveBuilderFeeSuccessResponse } from "./_methods/approveBuilderFee.js";
 import { type BatchModifyOptions, type BatchModifyParameters, type BatchModifySuccessResponse } from "./_methods/batchModify.js";
@@ -40,6 +41,7 @@ import { type UpdateLeverageOptions, type UpdateLeverageParameters, type UpdateL
 import { type UsdClassTransferOptions, type UsdClassTransferParameters, type UsdClassTransferSuccessResponse } from "./_methods/usdClassTransfer.js";
 import { type UsdSendOptions, type UsdSendParameters, type UsdSendSuccessResponse } from "./_methods/usdSend.js";
 import { type UserDexAbstractionOptions, type UserDexAbstractionParameters, type UserDexAbstractionSuccessResponse } from "./_methods/userDexAbstraction.js";
+import { type UserSetAbstractionOptions, type UserSetAbstractionParameters, type UserSetAbstractionSuccessResponse } from "./_methods/userSetAbstraction.js";
 import { type UserPortfolioMarginOptions, type UserPortfolioMarginParameters, type UserPortfolioMarginSuccessResponse } from "./_methods/userPortfolioMargin.js";
 import { type ValidatorL1StreamOptions, type ValidatorL1StreamParameters, type ValidatorL1StreamSuccessResponse } from "./_methods/validatorL1Stream.js";
 import { type VaultDistributeOptions, type VaultDistributeParameters, type VaultDistributeSuccessResponse } from "./_methods/vaultDistribute.js";
@@ -98,105 +100,1332 @@ export declare class ExchangeClient<C extends ExchangeConfig = ExchangeSingleWal
      * ```
      */
     constructor(config: C);
-    /** @see {@link agentEnableDexAbstraction} */
+    /**
+     * Enable HIP-3 DEX abstraction.
+     *
+     * @deprecated Use {@link agentSetAbstraction} instead.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.agentEnableDexAbstraction();
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction-agent
+     */
     agentEnableDexAbstraction(opts?: AgentEnableDexAbstractionOptions): Promise<AgentEnableDexAbstractionSuccessResponse>;
-    /** @see {@link approveAgent} */
+    /**
+     * Set User abstraction mode (method for agent wallet).
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.agentSetAbstraction({ abstraction: "u" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#set-user-abstraction-agent
+     */
+    agentSetAbstraction(params: AgentSetAbstractionParameters, opts?: AgentSetAbstractionOptions): Promise<AgentSetAbstractionSuccessResponse>;
+    /**
+     * Approve an agent to sign on behalf of the master account.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.approveAgent({ agentAddress: "0x...", agentName: "myAgent" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
+     */
     approveAgent(params: ApproveAgentParameters, opts?: ApproveAgentOptions): Promise<ApproveAgentSuccessResponse>;
-    /** @see {@link approveBuilderFee} */
+    /**
+     * Approve a maximum fee rate for a builder.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.approveBuilderFee({ maxFeeRate: "0.01%", builder: "0x..." });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+     */
     approveBuilderFee(params: ApproveBuilderFeeParameters, opts?: ApproveBuilderFeeOptions): Promise<ApproveBuilderFeeSuccessResponse>;
-    /** @see {@link batchModify} */
+    /**
+     * Modify multiple orders.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.batchModify({ modifies: [ { oid: 123, order: { a: 0, b: true, p: "31000", s: "0.2", r: false, t: { limit: { tif: "Gtc" } } } }, ] });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+     */
     batchModify(params: BatchModifyParameters, opts?: BatchModifyOptions): Promise<BatchModifySuccessResponse>;
-    /** @see {@link borrowLend} */
+    /**
+     * Borrow or lend assets.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.borrowLend({ operation: "supply", token: 0, amount: "20" });
+     * ```
+     */
     borrowLend(params: BorrowLendParameters, opts?: BorrowLendOptions): Promise<BorrowLendSuccessResponse>;
-    /** @see {@link cancel} */
+    /**
+     * Cancel order(s).
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.cancel({ cancels: [ { a: 0, o: 123 }, ] });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
+     */
     cancel(params: CancelParameters, opts?: CancelOptions): Promise<CancelSuccessResponse>;
-    /** @see {@link cancelByCloid} */
+    /**
+     * Cancel order(s) by cloid.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link CancelResponse} without error statuses.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.cancelByCloid({ cancels: [ { asset: 0, cloid: "0x..." }, ] });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
+     */
     cancelByCloid(params: CancelByCloidParameters, opts?: CancelByCloidOptions): Promise<CancelByCloidSuccessResponse>;
-    /** @see {@link cDeposit} */
+    /**
+     * Transfer native token from the user spot account into staking for delegating to validators.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.cDeposit({ wei: 1 * 1e8 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking
+     */
     cDeposit(params: CDepositParameters, opts?: CDepositOptions): Promise<CDepositSuccessResponse>;
-    /** @see {@link claimRewards} */
+    /**
+     * Claim rewards from referral program.
+     *
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.claimRewards();
+     * ```
+     */
     claimRewards(opts?: ClaimRewardsOptions): Promise<ClaimRewardsSuccessResponse>;
-    /** @see {@link convertToMultiSigUser} */
+    /**
+     * Convert a single-signature account to a multi-signature account or vice versa.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.convertToMultiSigUser({ signers: { authorizedUsers: ["0x...", "0x...", "0x..."], threshold: 2 } });
+     * ```
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.convertToMultiSigUser({ signers: null });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig
+     */
     convertToMultiSigUser(params: ConvertToMultiSigUserParameters, opts?: ConvertToMultiSigUserOptions): Promise<ConvertToMultiSigUserSuccessResponse>;
-    /** @see {@link createSubAccount} */
+    /**
+     * Create a sub-account.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Response for creating a sub-account.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.createSubAccount({ name: "..." });
+     * ```
+     */
     createSubAccount(params: CreateSubAccountParameters, opts?: CreateSubAccountOptions): Promise<CreateSubAccountSuccessResponse>;
-    /** @see {@link createVault} */
+    /**
+     * Create a vault.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Response for creating a vault.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.createVault({ name: "...", description: "...", initialUsd: 100 * 1e6, nonce: Date.now() });
+     * ```
+     */
     createVault(params: CreateVaultParameters, opts?: CreateVaultOptions): Promise<CreateVaultSuccessResponse>;
-    /** @see {@link cSignerAction} */
+    /**
+     * Jail or unjail self as a validator signer.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.cSignerAction({ jailSelf: null });
+     * ```
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.cSignerAction({ unjailSelf: null });
+     * ```
+     */
     cSignerAction(params: CSignerActionParameters, opts?: CSignerActionOptions): Promise<CSignerActionSuccessResponse>;
-    /** @see {@link cValidatorAction} */
+    /**
+     * Action related to validator management.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.cValidatorAction({ changeProfile: { node_ip: { Ip: "1.2.3.4" }, name: "...", description: "...", unjailed: true, disable_delegations: false, commission_bps: null, signer: null } });
+     * ```
+     */
     cValidatorAction(params: CValidatorActionParameters, opts?: CValidatorActionOptions): Promise<CValidatorActionSuccessResponse>;
-    /** @see {@link cWithdraw} */
+    /**
+     * Transfer native token from staking into the user's spot account.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.cWithdraw({ wei: 1 * 1e8 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#withdraw-from-staking
+     */
     cWithdraw(params: CWithdrawParameters, opts?: CWithdrawOptions): Promise<CWithdrawSuccessResponse>;
-    /** @see {@link evmUserModify} */
+    /**
+     * Configure block type for EVM transactions.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.evmUserModify({ usingBigBlocks: true });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
+     */
     evmUserModify(params: EvmUserModifyParameters, opts?: EvmUserModifyOptions): Promise<EvmUserModifySuccessResponse>;
-    /** @see {@link linkStakingUser} */
+    /**
+     * Link staking and trading accounts for fee discount attribution.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.linkStakingUser({ user: "0x...", isFinalize: false });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#staking-linking
+     */
     linkStakingUser(params: LinkStakingUserParameters, opts?: LinkStakingUserOptions): Promise<LinkStakingUserSuccessResponse>;
-    /** @see {@link modify} */
+    /**
+     * Modify an order.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.modify({ oid: 123, order: { a: 0, b: true, p: "31000", s: "0.2", r: false, t: { limit: { tif: "Gtc" } }, c: "0x..." } });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order
+     */
     modify(params: ModifyParameters, opts?: ModifyOptions): Promise<ModifySuccessResponse>;
-    /** @see {@link order} */
+    /**
+     * Place an order(s).
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link OrderResponse} without error statuses.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.order({ orders: [ { a: 0, b: true, p: "30000", s: "0.1", r: false, t: { limit: { tif: "Gtc" } }, c: "0x..." }, ], grouping: "na" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order
+     */
     order(params: OrderParameters, opts?: OrderOptions): Promise<OrderSuccessResponse>;
-    /** @see {@link noop} */
+    /**
+     * This action does not do anything (no operation), but causes the nonce to be marked as used.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.noop();
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#invalidate-pending-nonce-noop
+     */
     noop(opts?: NoopOptions): Promise<NoopSuccessResponse>;
-    /** @see {@link perpDeploy} */
+    /**
+     * Deploying HIP-3 assets.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.perpDeploy({ registerAsset: { maxGas: 1000000, assetRequest: { coin: "USDC", szDecimals: 8, oraclePx: "1", marginTableId: 1, onlyIsolated: false }, dex: "test", schema: null } });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/hip-3-deployer-actions
+     */
     perpDeploy(params: PerpDeployParameters, opts?: PerpDeployOptions): Promise<PerpDeploySuccessResponse>;
-    /** @see {@link registerReferrer} */
+    /**
+     * Create a referral code.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.registerReferrer({ code: "..." });
+     * ```
+     */
     registerReferrer(params: RegisterReferrerParameters, opts?: RegisterReferrerOptions): Promise<RegisterReferrerSuccessResponse>;
-    /** @see {@link reserveRequestWeight} */
+    /**
+     * Reserve additional rate-limited actions for a fee.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.reserveRequestWeight({ weight: 10 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#reserve-additional-actions
+     */
     reserveRequestWeight(params: ReserveRequestWeightParameters, opts?: ReserveRequestWeightOptions): Promise<ReserveRequestWeightSuccessResponse>;
-    /** @see {@link scheduleCancel} */
+    /**
+     * Schedule a cancel-all operation at a future time.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.scheduleCancel({ time: Date.now() + 10_000 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#schedule-cancel-dead-mans-switch
+     */
     scheduleCancel(params?: ScheduleCancelParameters, opts?: ScheduleCancelOptions): Promise<ScheduleCancelSuccessResponse>;
     scheduleCancel(opts?: ScheduleCancelOptions): Promise<ScheduleCancelSuccessResponse>;
-    /** @see {@link sendAsset} */
+    /**
+     * Transfer tokens between different perp DEXs, spot balance, users, and/or sub-accounts.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.sendAsset({ destination: "0x0000000000000000000000000000000000000001", sourceDex: "", destinationDex: "test", token: "USDC:0xeb62eee3685fc4c43992febcd9e75443", amount: "1" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset
+     */
     sendAsset(params: SendAssetParameters, opts?: SendAssetOptions): Promise<SendAssetSuccessResponse>;
-    /** @see {@link setDisplayName} */
+    /**
+     * Set the display name in the leaderboard.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.setDisplayName({ displayName: "..." });
+     * ```
+     */
     setDisplayName(params: SetDisplayNameParameters, opts?: SetDisplayNameOptions): Promise<SetDisplayNameSuccessResponse>;
-    /** @see {@link setReferrer} */
+    /**
+     * Set a referral code.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.setReferrer({ code: "..." });
+     * ```
+     */
     setReferrer(params: SetReferrerParameters, opts?: SetReferrerOptions): Promise<SetReferrerSuccessResponse>;
-    /** @see {@link spotDeploy} */
+    /**
+     * Deploying HIP-1 and HIP-2 assets.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.spotDeploy({ registerToken2: { spec: { name: "USDC", szDecimals: 8, weiDecimals: 8 }, maxGas: 1000000, fullName: "USD Coin" } });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/deploying-hip-1-and-hip-2-assets
+     */
     spotDeploy(params: SpotDeployParameters, opts?: SpotDeployOptions): Promise<SpotDeploySuccessResponse>;
-    /** @see {@link spotSend} */
+    /**
+     * Send spot assets to another address.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.spotSend({ destination: "0x...", token: "USDC:0xeb62eee3685fc4c43992febcd9e75443", amount: "1" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#core-spot-transfer
+     */
     spotSend(params: SpotSendParameters, opts?: SpotSendOptions): Promise<SpotSendSuccessResponse>;
-    /** @see {@link spotUser} */
+    /**
+     * Opt Out of Spot Dusting.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.spotUser({ toggleSpotDusting: { optOut: false } });
+     * ```
+     */
     spotUser(params: SpotUserParameters, opts?: SpotUserOptions): Promise<SpotUserSuccessResponse>;
-    /** @see {@link subAccountModify} */
+    /**
+     * Modify a sub-account.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.subAccountModify({ subAccountUser: "0x...", name: "..." });
+     * ```
+     */
     subAccountModify(params: SubAccountModifyParameters, opts?: SubAccountModifyOptions): Promise<SubAccountModifySuccessResponse>;
-    /** @see {@link subAccountSpotTransfer} */
+    /**
+     * Transfer between sub-accounts (spot).
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.subAccountSpotTransfer({ subAccountUser: "0x...", isDeposit: true, token: "USDC:0xeb62eee3685fc4c43992febcd9e75443", amount: "1" });
+     * ```
+     */
     subAccountSpotTransfer(params: SubAccountSpotTransferParameters, opts?: SubAccountSpotTransferOptions): Promise<SubAccountSpotTransferSuccessResponse>;
-    /** @see {@link subAccountTransfer} */
+    /**
+     * Transfer between sub-accounts (perpetual).
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.subAccountTransfer({ subAccountUser: "0x...", isDeposit: true, usd: 1 * 1e6 });
+     * ```
+     */
     subAccountTransfer(params: SubAccountTransferParameters, opts?: SubAccountTransferOptions): Promise<SubAccountTransferSuccessResponse>;
-    /** @see {@link tokenDelegate} */
+    /**
+     * Delegate or undelegate native tokens to or from a validator.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.tokenDelegate({ validator: "0x...", isUndelegate: true, wei: 1 * 1e8 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+     */
     tokenDelegate(params: TokenDelegateParameters, opts?: TokenDelegateOptions): Promise<TokenDelegateSuccessResponse>;
-    /** @see {@link twapCancel} */
+    /**
+     * Cancel a TWAP order.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link TwapCancelResponse} without error status.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.twapCancel({ a: 0, t: 1 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-order
+     */
     twapCancel(params: TwapCancelParameters, opts?: TwapCancelOptions): Promise<TwapCancelSuccessResponse>;
-    /** @see {@link twapOrder} */
+    /**
+     * Place a TWAP order.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful variant of {@link TwapOrderResponse} without error status.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * const data = await client.twapOrder({ twap: { a: 0, b: true, s: "1", r: false, m: 10, t: true } });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-a-twap-order
+     */
     twapOrder(params: TwapOrderParameters, opts?: TwapOrderOptions): Promise<TwapOrderSuccessResponse>;
-    /** @see {@link updateIsolatedMargin} */
+    /**
+     * Add or remove margin from isolated position.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.updateIsolatedMargin({ asset: 0, isBuy: true, ntli: 1 * 1e6 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin
+     */
     updateIsolatedMargin(params: UpdateIsolatedMarginParameters, opts?: UpdateIsolatedMarginOptions): Promise<UpdateIsolatedMarginSuccessResponse>;
-    /** @see {@link updateLeverage} */
+    /**
+     * Update cross or isolated leverage on a coin.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.updateLeverage({ asset: 0, isCross: true, leverage: 5 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-leverage
+     */
     updateLeverage(params: UpdateLeverageParameters, opts?: UpdateLeverageOptions): Promise<UpdateLeverageSuccessResponse>;
-    /** @see {@link usdClassTransfer} */
+    /**
+     * Transfer funds between Spot account and Perp account.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.usdClassTransfer({ amount: "1", toPerp: true });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#transfer-from-spot-account-to-perp-account-and-vice-versa
+     */
     usdClassTransfer(params: UsdClassTransferParameters, opts?: UsdClassTransferOptions): Promise<UsdClassTransferSuccessResponse>;
-    /** @see {@link usdSend} */
+    /**
+     * Send usd to another address.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.usdSend({ destination: "0x...", amount: "1" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#core-usdc-transfer
+     */
     usdSend(params: UsdSendParameters, opts?: UsdSendOptions): Promise<UsdSendSuccessResponse>;
-    /** @see {@link userDexAbstraction} */
+    /**
+     * Enable/disable HIP-3 DEX abstraction.
+     *
+     * @deprecated Use {@link userSetAbstraction} instead.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.userDexAbstraction({ user: "0x...", enabled: true });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#enable-hip-3-dex-abstraction
+     */
     userDexAbstraction(params: UserDexAbstractionParameters, opts?: UserDexAbstractionOptions): Promise<UserDexAbstractionSuccessResponse>;
-    /** @see {@link userPortfolioMargin} */
+    /**
+     * Set User abstraction mode.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.userSetAbstraction({ user: "0x...", abstraction: "dexAbstraction" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#set-user-abstraction
+     */
+    userSetAbstraction(params: UserSetAbstractionParameters, opts?: UserSetAbstractionOptions): Promise<UserSetAbstractionSuccessResponse>;
+    /**
+     * Enable/disable user portfolio margin.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.userPortfolioMargin({ user: "0x...", enabled: true });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/portfolio-margin
+     */
     userPortfolioMargin(params: UserPortfolioMarginParameters, opts?: UserPortfolioMarginOptions): Promise<UserPortfolioMarginSuccessResponse>;
-    /** @see {@link validatorL1Stream} */
+    /**
+     * Validator vote on risk-free rate for aligned quote asset.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.validatorL1Stream({ riskFreeRate: "0.05" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#validator-vote-on-risk-free-rate-for-aligned-quote-asset
+     */
     validatorL1Stream(params: ValidatorL1StreamParameters, opts?: ValidatorL1StreamOptions): Promise<ValidatorL1StreamSuccessResponse>;
-    /** @see {@link vaultDistribute} */
+    /**
+     * Distribute funds from a vault between followers.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.vaultDistribute({ vaultAddress: "0x...", usd: 10 * 1e6 });
+     * ```
+     */
     vaultDistribute(params: VaultDistributeParameters, opts?: VaultDistributeOptions): Promise<VaultDistributeSuccessResponse>;
-    /** @see {@link vaultModify} */
+    /**
+     * Modify a vault's configuration.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.vaultModify({ vaultAddress: "0x...", allowDeposits: true, alwaysCloseOnWithdraw: false });
+     * ```
+     */
     vaultModify(params: VaultModifyParameters, opts?: VaultModifyOptions): Promise<VaultModifySuccessResponse>;
-    /** @see {@link vaultTransfer} */
+    /**
+     * Deposit or withdraw from a vault.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.vaultTransfer({ vaultAddress: "0x...", isDeposit: true, usd: 10 * 1e6 });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault
+     */
     vaultTransfer(params: VaultTransferParameters, opts?: VaultTransferOptions): Promise<VaultTransferSuccessResponse>;
-    /** @see {@link withdraw3} */
+    /**
+     * Initiate a withdrawal request.
+     *
+     * @param params - Parameters specific to the API request.
+     * @param opts - Request execution options.
+     *
+     * @returns Successful response without specific data.
+     *
+     * @throws {ValiError} When the request parameters fail validation (before sending).
+     * @throws {TransportError} When the transport layer throws an error.
+     * @throws {ApiRequestError} When the API returns an unsuccessful response.
+     *
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "npm:viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+     * const transport = new hl.HttpTransport(); // or `WebSocketTransport`
+     * const client = new hl.ExchangeClient({ transport, wallet });
+     *
+     * await client.withdraw3({ destination: "0x...", amount: "1" });
+     * ```
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request
+     */
     withdraw3(params: Withdraw3Parameters, opts?: Withdraw3Options): Promise<Withdraw3SuccessResponse>;
 }
 export type { ExchangeMultiSigConfig, ExchangeSingleWalletConfig } from "./_methods/_base/execute.js";
 export { ApiRequestError } from "./_methods/_base/errors.js";
 export type { AgentEnableDexAbstractionOptions, AgentEnableDexAbstractionSuccessResponse, } from "./_methods/agentEnableDexAbstraction.js";
+export type { AgentSetAbstractionOptions, AgentSetAbstractionParameters, AgentSetAbstractionSuccessResponse, } from "./_methods/agentSetAbstraction.js";
 export type { ApproveAgentOptions, ApproveAgentParameters, ApproveAgentSuccessResponse, } from "./_methods/approveAgent.js";
 export type { ApproveBuilderFeeOptions, ApproveBuilderFeeParameters, ApproveBuilderFeeSuccessResponse, } from "./_methods/approveBuilderFee.js";
 export type { BatchModifyOptions, BatchModifyParameters, BatchModifySuccessResponse } from "./_methods/batchModify.js";
@@ -236,7 +1465,8 @@ export type { UpdateIsolatedMarginOptions, UpdateIsolatedMarginParameters, Updat
 export type { UpdateLeverageOptions, UpdateLeverageParameters, UpdateLeverageSuccessResponse, } from "./_methods/updateLeverage.js";
 export type { UsdClassTransferOptions, UsdClassTransferParameters, UsdClassTransferSuccessResponse, } from "./_methods/usdClassTransfer.js";
 export type { UsdSendOptions, UsdSendParameters, UsdSendSuccessResponse } from "./_methods/usdSend.js";
-export type { UserDexAbstractionOptions, UserDexAbstractionParameters, UserDexAbstractionSuccessResponse, } from "./_methods/userDexAbstraction.js";
+export type { UserDexAbstractionOptions, UserDexAbstractionOptions as UserDexAbstractionExchangeOptions, UserDexAbstractionParameters, UserDexAbstractionParameters as UserDexAbstractionExchangeParameters, UserDexAbstractionSuccessResponse, UserDexAbstractionSuccessResponse as UserDexAbstractionExchangeSuccessResponse, } from "./_methods/userDexAbstraction.js";
+export type { UserSetAbstractionOptions, UserSetAbstractionParameters, UserSetAbstractionSuccessResponse, } from "./_methods/userSetAbstraction.js";
 export type { UserPortfolioMarginOptions, UserPortfolioMarginParameters, UserPortfolioMarginSuccessResponse, } from "./_methods/userPortfolioMargin.js";
 export type { ValidatorL1StreamOptions, ValidatorL1StreamParameters, ValidatorL1StreamSuccessResponse, } from "./_methods/validatorL1Stream.js";
 export type { VaultDistributeOptions, VaultDistributeParameters, VaultDistributeSuccessResponse, } from "./_methods/vaultDistribute.js";