@nktkas/hyperliquid 0.22.2 → 0.23.1

package/esm/src/clients/info.d.ts

@@ -2,12 +2,12 @@ import type { IRequestTransport } from "../transports/base.js";
 import type { BlockDetailsRequest, TxDetailsRequest, UserDetailsRequest } from "../types/explorer/requests.js";
 import type { BlockDetails, TxDetails } from "../types/explorer/responses.js";
 import type { ExtraAgent, LegalCheck, MultiSigSigners, PerpsClearinghouseState, PortfolioPeriods, PreTransferCheck, Referral, SpotClearinghouseState, SubAccount, UserFees, UserFundingUpdate, UserNonFundingLedgerUpdate, UserRateLimit, UserRole } from "../types/info/accounts.js";
-import type { AllMids, Candle, FundingHistory, PerpDex, PerpsMeta, PerpsMetaAndAssetCtxs, PredictedFunding, SpotMeta, SpotMetaAndAssetCtxs, TokenDetails } from "../types/info/assets.js";
-import type { Delegation, DelegatorReward, DelegatorSummary, DelegatorUpdate, ValidatorSummary } from "../types/info/delegations.js";
-import type { DeployAuctionStatus, SpotDeployState } from "../types/info/markets.js";
+import type { AllMids, Candle, FundingHistory, MarginTable, PerpDex, PerpsMeta, PerpsMetaAndAssetCtxs, PredictedFunding, SpotMeta, SpotMetaAndAssetCtxs, TokenDetails } from "../types/info/assets.js";
+import type { Delegation, DelegatorReward, DelegatorSummary, DelegatorUpdate, ValidatorSummary } from "../types/info/validators.js";
+import type { DeployAuctionStatus, ExchangeStatus, SpotDeployState } from "../types/info/markets.js";
 import type { Book, Fill, FrontendOrder, Order, OrderLookup, OrderStatus, TwapHistory, TwapSliceFill } from "../types/info/orders.js";
-import type { AllMidsRequest, CandleSnapshotRequest, ClearinghouseStateRequest, DelegationsRequest, DelegatorHistoryRequest, DelegatorRewardsRequest, DelegatorSummaryRequest, ExtraAgentsRequest, FrontendOpenOrdersRequest, FundingHistoryRequest, HistoricalOrdersRequest, IsVipRequest, L2BookRequest, LegalCheckRequest, MaxBuilderFeeRequest, MetaRequest, OpenOrdersRequest, OrderStatusRequest, PerpDeployAuctionStatusRequest, PerpDexsRequest, PortfolioRequest, PreTransferCheckRequest, ReferralRequest, SpotClearinghouseStateRequest, SpotDeployStateRequest, SubAccountsRequest, TokenDetailsRequest, TwapHistoryRequest, UserFeesRequest, UserFillsByTimeRequest, UserFillsRequest, UserFundingRequest, UserNonFundingLedgerUpdatesRequest, UserRateLimitRequest, UserRoleRequest, UserToMultiSigSignersRequest, UserTwapSliceFillsByTimeRequest, UserTwapSliceFillsRequest, UserVaultEquitiesRequest, VaultDetailsRequest } from "../types/info/requests.js";
-import type { VaultDetails, VaultEquity, VaultSummary } from "../types/info/vaults.js";
+import type { AllMidsRequest, CandleSnapshotRequest, ClearinghouseStateRequest, DelegationsRequest, DelegatorHistoryRequest, DelegatorRewardsRequest, DelegatorSummaryRequest, ExtraAgentsRequest, FrontendOpenOrdersRequest, FundingHistoryRequest, HistoricalOrdersRequest, IsVipRequest, L2BookRequest, LeadingVaultsRequest, LegalCheckRequest, MarginTableRequest, MaxBuilderFeeRequest, MetaRequest, OpenOrdersRequest, OrderStatusRequest, PortfolioRequest, PreTransferCheckRequest, ReferralRequest, SpotClearinghouseStateRequest, SpotDeployStateRequest, SubAccountsRequest, TokenDetailsRequest, TwapHistoryRequest, UserFeesRequest, UserFillsByTimeRequest, UserFillsRequest, UserFundingRequest, UserNonFundingLedgerUpdatesRequest, UserRateLimitRequest, UserRoleRequest, UserToMultiSigSignersRequest, UserTwapSliceFillsByTimeRequest, UserTwapSliceFillsRequest, UserVaultEquitiesRequest, VaultDetailsRequest } from "../types/info/requests.js";
+import type { VaultDetails, VaultEquity, VaultLeading, VaultSummary } from "../types/info/vaults.js";
 /** Parameters for the {@linkcode InfoClient} constructor. */
 export interface InfoClientParameters<T extends IRequestTransport = IRequestTransport> {
     /** The transport used to connect to the Hyperliquid API. */
@@ -15,6 +15,8 @@ export interface InfoClientParameters<T extends IRequestTransport = IRequestTran
 }
 /** Parameters for the {@linkcode InfoClient.allMids} method. */
 export type AllMidsParameters = Omit<AllMidsRequest, "type">;
+/** Parameters for the {@linkcode InfoClient.blockDetails} method. */
+export type BlockDetailsParameters = Omit<BlockDetailsRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.candleSnapshot} method. */
 export type CandleSnapshotParameters = CandleSnapshotRequest["req"];
 /** Parameters for the {@linkcode InfoClient.clearinghouseState} method. */
@@ -39,8 +41,12 @@ export type HistoricalOrdersParameters = Omit<HistoricalOrdersRequest, "type">;
 export type IsVipParameters = Omit<IsVipRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.l2Book} method. */
 export type L2BookParameters = Omit<L2BookRequest, "type">;
+/** Parameters for the {@linkcode InfoClient.leadingVaults} method. */
+export type LeadingVaultsParameters = Omit<LeadingVaultsRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.legalCheck} method. */
 export type LegalCheckParameters = Omit<LegalCheckRequest, "type">;
+/** Parameters for the {@linkcode InfoClient.marginTable} method. */
+export type MarginTableParameters = Omit<MarginTableRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.maxBuilderFee} method. */
 export type MaxBuilderFeeParameters = Omit<MaxBuilderFeeRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.meta} method. */
@@ -49,10 +55,6 @@ export type MetaParameters = Omit<MetaRequest, "type">;
 export type OpenOrdersParameters = Omit<OpenOrdersRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.orderStatus} method. */
 export type OrderStatusParameters = Omit<OrderStatusRequest, "type">;
-/** Parameters for the {@linkcode InfoClient.perpDeployAuctionStatus} method. */
-export type PerpDeployAuctionStatusParameters = Omit<PerpDeployAuctionStatusRequest, "type">;
-/** Parameters for the {@linkcode InfoClient.perpDexs} method. */
-export type PerpDexsParameters = Omit<PerpDexsRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.portfolio} method. */
 export type PortfolioParameters = Omit<PortfolioRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.preTransferCheck} method. */
@@ -69,6 +71,10 @@ export type SubAccountsParameters = Omit<SubAccountsRequest, "type">;
 export type TokenDetailsParameters = Omit<TokenDetailsRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.twapHistory} method. */
 export type TwapHistoryParameters = Omit<TwapHistoryRequest, "type">;
+/** Parameters for the {@linkcode InfoClient.txDetails} method. */
+export type TxDetailsParameters = Omit<TxDetailsRequest, "type">;
+/** Parameters for the {@linkcode InfoClient.userDetails} method. */
+export type UserDetailsParameters = Omit<UserDetailsRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.userFees} method. */
 export type UserFeesParameters = Omit<UserFeesRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.userFills} method. */
@@ -93,12 +99,6 @@ export type UserTwapSliceFillsByTimeParameters = Omit<UserTwapSliceFillsByTimeRe
 export type UserVaultEquitiesParameters = Omit<UserVaultEquitiesRequest, "type">;
 /** Parameters for the {@linkcode InfoClient.vaultDetails} method. */
 export type VaultDetailsParameters = Omit<VaultDetailsRequest, "type">;
-/** Parameters for the {@linkcode InfoClient.blockDetails} method. */
-export type BlockDetailsParameters = Omit<BlockDetailsRequest, "type">;
-/** Parameters for the {@linkcode InfoClient.txDetails} method. */
-export type TxDetailsParameters = Omit<TxDetailsRequest, "type">;
-/** Parameters for the {@linkcode InfoClient.userDetails} method. */
-export type UserDetailsParameters = Omit<UserDetailsRequest, "type">;
 /**
  * Info client for interacting with the Hyperliquid API.
  * @typeParam T The type of transport used to connect to the Hyperliquid API.
@@ -120,8 +120,11 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     constructor(args: InfoClientParameters<T>);
     /**
      * Request mid coin prices.
+     * @param args - An optional parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Mid coin prices.
+     * @returns Mapping of coin symbols to mid prices.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins
      * @example
@@ -140,9 +143,11 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * Block details by block height.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Block details response.
+     * @returns Block details.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -160,6 +165,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of candlestick data points.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot
      * @example
      * ```ts
@@ -182,6 +189,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Account summary for perpetual trading.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
      * @example
      * ```ts
@@ -200,6 +209,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's delegations to validators.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations
      * @example
      * ```ts
@@ -218,6 +229,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's staking updates.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history
      * @example
      * ```ts
@@ -236,6 +249,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's staking rewards.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-rewards
      * @example
      * ```ts
@@ -254,6 +269,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Summary of a user's staking delegations.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
      * @example
      * ```ts
@@ -266,13 +283,34 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * ```
      */
     delegatorSummary(args: DelegatorSummaryParameters, signal?: AbortSignal): Promise<DelegatorSummary>;
+    /**
+     * Request exchange status information.
+     * @param signal - An optional abort signal.
+     * @returns Exchange system status information.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.exchangeStatus();
+     * ```
+     */
+    exchangeStatus(signal?: AbortSignal): Promise<ExchangeStatus>;
     /**
      * Request user's extra agents.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns User's extra agents.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -290,6 +328,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of open orders with additional frontend information.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders-with-additional-frontend-info
      * @example
      * ```ts
@@ -308,6 +348,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of historical funding rate data for an asset.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates
      * @example
      * ```ts
@@ -329,6 +371,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's historical orders.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-historical-orders
      * @example
      * ```ts
@@ -347,7 +391,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Boolean indicating user's VIP status.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -365,6 +411,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns L2 order book snapshot.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot
      * @example
      * ```ts
@@ -377,13 +425,35 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * ```
      */
     l2Book(args: L2BookParameters, signal?: AbortSignal): Promise<Book>;
+    /**
+     * Request leading vaults for a user.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.leadingVaults({ user: "0x..." });
+     * ```
+     */
+    leadingVaults(args: LeadingVaultsParameters, signal?: AbortSignal): Promise<VaultLeading[]>;
     /**
      * Request legal verification status of a user.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Legal verification status for a user.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -395,12 +465,53 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * ```
      */
     legalCheck(args: LegalCheckParameters, signal?: AbortSignal): Promise<LegalCheck>;
+    /**
+     * Request liquidatable (unknown).
+     * @param signal - An optional abort signal.
+     * @returns
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.liquidatable();
+     * ```
+     */
+    liquidatable(signal?: AbortSignal): Promise<unknown[]>;
+    /**
+     * Request margin table data.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Margin requirements table with multiple tiers.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.marginTable({ id: 1 });
+     * ```
+     */
+    marginTable(args: MarginTableParameters, signal?: AbortSignal): Promise<MarginTable>;
     /**
      * Request builder fee approval.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Maximum builder fee approval.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#check-builder-fee-approval
      * @example
      * ```ts
@@ -413,12 +524,34 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * ```
      */
     maxBuilderFee(args: MaxBuilderFeeParameters, signal?: AbortSignal): Promise<number>;
+    /**
+     * Request maximum market order notionals.
+     * @param signal - An optional abort signal.
+     * @returns
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.maxMarketOrderNtls();
+     * ```
+     */
+    maxMarketOrderNtls(signal?: AbortSignal): Promise<[number, string][]>;
     /**
      * Request trading metadata.
+     * @param args - An optional parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Metadata for perpetual assets.
      *
-     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata-universe-and-margin-tables
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -434,7 +567,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     /**
      * Request metadata and asset contexts.
      * @param signal - An optional abort signal.
-     * @returns Metadata and context information for each perpetual asset.
+     * @returns Metadata and context for perpetual assets.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc
      * @example
@@ -454,6 +589,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of open order.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders
      * @example
      * ```ts
@@ -472,6 +609,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Result of an order status lookup.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid
      * @example
      * ```ts
@@ -489,6 +628,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Status of the perpetual deploy auction.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-information-about-the-perp-deploy-auction
      * @example
      * ```ts
@@ -504,7 +645,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     /**
      * Request all perpetual dexs.
      * @param signal - An optional abort signal.
-     * @returns Array of perpetual dexes.
+     * @returns Array of perpetual dexes (null is main dex).
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-all-perpetual-dexs
      * @example
@@ -520,10 +663,11 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     perpDexs(signal?: AbortSignal): Promise<(PerpDex | null)[]>;
     /**
      * Request perpetuals at open interest cap.
-     * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Array of perpetuals at open interest caps.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#query-perps-at-open-interest-caps
      * @example
      * ```ts
@@ -537,10 +681,12 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      */
     perpsAtOpenInterestCap(signal?: AbortSignal): Promise<string[]>;
     /**
-     * Request portfolio.
+     * Request user portfolio.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Portfolio of a user.
+     * @returns Portfolio metrics grouped by time periods.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-portfolio
      * @example
@@ -559,6 +705,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of predicted funding rates.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-predicted-funding-rates-for-different-venues
      * @example
      * ```ts
@@ -577,7 +725,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Pre-transfer user existence check result.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -595,6 +745,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Referral information for a user.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-referral-information
      * @example
      * ```ts
@@ -611,7 +763,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * Request spot clearinghouse state.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Balances for spot tokens.
+     * @returns Account summary for spot trading.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances
      * @example
@@ -629,7 +783,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * Request spot deploy state.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns The deploy state of a user.
+     * @returns Deploy state for spot tokens.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-deploy-auction
      * @example
@@ -648,6 +804,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Metadata for spot assets.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata
      * @example
      * ```ts
@@ -663,7 +821,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     /**
      * Request spot metadata and asset contexts.
      * @param signal - An optional abort signal.
-     * @returns Metadata and context information for each spot asset.
+     * @returns Metadata and context for spot assets.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts
      * @example
@@ -683,6 +843,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user sub-account or null if the user does not have any sub-accounts.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-subaccounts
      * @example
      * ```ts
@@ -699,7 +861,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * Request token details.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns The details of a token.
+     * @returns Details of a token.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-a-token
      * @example
@@ -717,9 +881,11 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * Request twap history of a user.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns The twap history of a user.
+     * @returns Array of user's TWAP history.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -732,12 +898,14 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      */
     twapHistory(args: TwapHistoryParameters, signal?: AbortSignal): Promise<TwapHistory[]>;
     /**
-     * Transaction details by transaction hash.
+     * Request transaction details by transaction hash.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Transaction details response.
+     * @returns Transaction details.
+     *
+     * @throws {TransportError} When the transport layer throws an error.
      *
-     * @see null - no documentation
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -750,12 +918,14 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      */
     txDetails(args: TxDetailsParameters, signal?: AbortSignal): Promise<TxDetails>;
     /**
-     * User details by user's address.
+     * Request user details by user's address.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns User details response.
+     * @returns User details.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -773,7 +943,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns User fees.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-fees
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -791,6 +963,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's trade fill.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
      * @example
      * ```ts
@@ -809,6 +983,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's trade fill.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time
      * @example
      * ```ts
@@ -830,6 +1006,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's funding ledger update.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates
      * @example
      * ```ts
@@ -851,6 +1029,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's non-funding ledger update.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates
      * @example
      * ```ts
@@ -872,6 +1052,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns User's rate limits.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-rate-limits
      * @example
      * ```ts
@@ -890,6 +1072,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns User's role.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-role
      * @example
      * ```ts
@@ -908,7 +1092,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Multi-sig signers for a user or null if the user does not have any multi-sig signers.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -926,6 +1112,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's twap slice fill.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-twap-slice-fills
      * @example
      * ```ts
@@ -944,7 +1132,9 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's twap slice fill.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -965,6 +1155,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Array of user's vault deposits.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-vault-deposits
      * @example
      * ```ts
@@ -973,16 +1165,37 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const infoClient = new hl.InfoClient({ transport });
      *
-     * const data = await infoClient.userVaultDeposits({ user: "0x..." });
+     * const data = await infoClient.userVaultEquities({ user: "0x..." });
      * ```
      */
     userVaultEquities(args: UserVaultEquitiesParameters, signal?: AbortSignal): Promise<VaultEquity[]>;
+    /**
+     * Request validator L1 votes.
+     * @param signal - An optional abort signal.
+     * @returns
+     *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const infoClient = new hl.InfoClient({ transport });
+     *
+     * const data = await infoClient.validatorL1Votes();
+     * ```
+     */
+    validatorL1Votes(signal?: AbortSignal): Promise<unknown[]>;
     /**
      * Request validator summaries.
-     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
      * @returns Array of validator summaries.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -1000,6 +1213,8 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
      * @param signal - An optional abort signal.
      * @returns Details of a vault or null if the vault does not exist.
      *
+     * @throws {TransportError} When the transport layer throws an error.
+     *
      * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-details-for-a-vault
      * @example
      * ```ts
@@ -1014,11 +1229,12 @@ export declare class InfoClient<T extends IRequestTransport = IRequestTransport>
     vaultDetails(args: VaultDetailsParameters, signal?: AbortSignal): Promise<VaultDetails | null>;
     /**
      * Request a list of vaults less than 2 hours old.
-     * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Array of vault summaries.
      *
-     * @see null - no documentation
+     * @throws {TransportError} When the transport layer throws an error.
+     *
+     * @see null
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";