@nktkas/hyperliquid 0.13.1 → 0.14.0

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

@@ -1,10 +1,11 @@
-import type { IRequestTransport } from "../transports/base.js";
-import type { BlockDetailsRequest, TxDetailsRequest } from "../types/explorer/requests.js";
-import type { BlockDetailsResponse, TxDetailsResponse } from "../types/explorer/responses.js";
-import type { ExtraAgent, PerpsClearinghouseState, Referral, SpotClearinghouseState, SubAccount, UserFees, UserFundingUpdate, UserNonFundingLedgerUpdate, UserRateLimit } from "../types/info/accounts.js";
+import type { IRequestTransport } from "../base.js";
+import type { BlockDetailsRequest, TxDetailsRequest, UserDetailsRequest } from "../types/explorer/requests.js";
+import type { BlockDetailsResponse, TxDetailsResponse, UserDetailsResponse } 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, PerpsMeta, PerpsMetaAndAssetCtxs, PredictedFunding, SpotDeployState, SpotMeta, SpotMetaAndAssetCtxs, TokenDetails } from "../types/info/assets.js";
+import type { Delegation, DelegatorReward, DelegatorSummary, DelegatorUpdate, ValidatorSummary } from "../types/info/delegations.js";
 import type { Book, Fill, FrontendOrder, Order, OrderLookup, OrderStatus, TwapHistory, TwapSliceFill } from "../types/info/orders.js";
-import type { CandleSnapshotRequest, ClearinghouseStateRequest, ExtraAgentsRequest, FrontendOpenOrdersRequest, FundingHistoryRequest, HistoricalOrdersRequest, L2BookRequest, MaxBuilderFeeRequest, OpenOrdersRequest, OrderStatusRequest, ReferralRequest, SpotClearinghouseStateRequest, SpotDeployStateRequest, SubAccountsRequest, TokenDetailsRequest, TwapHistoryRequest, UserFeesRequest, UserFillsByTimeRequest, UserFillsRequest, UserFundingRequest, UserNonFundingLedgerUpdatesRequest, UserRateLimitRequest, UserTwapSliceFillsRequest, UserVaultEquitiesRequest, VaultDetailsRequest } from "../types/info/requests.js";
+import type { CandleSnapshotRequest, ClearinghouseStateRequest, DelegationsRequest, DelegatorHistoryRequest, DelegatorRewardsRequest, DelegatorSummaryRequest, ExtraAgentsRequest, FrontendOpenOrdersRequest, FundingHistoryRequest, HistoricalOrdersRequest, IsVipRequest, L2BookRequest, LegalCheckRequest, MaxBuilderFeeRequest, 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, VaultSummary } from "../types/info/vaults.js";
 /** Parameters for the {@linkcode PublicClient} constructor. */
 export interface PublicClientParameters<T extends IRequestTransport = IRequestTransport> {
@@ -15,6 +16,14 @@ export interface PublicClientParameters<T extends IRequestTransport = IRequestTr
 export type CandleSnapshotParameters = CandleSnapshotRequest["req"];
 /** Parameters for the {@linkcode PublicClient.clearinghouseState} method. */
 export type ClearinghouseStateParameters = Omit<ClearinghouseStateRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.delegations} method. */
+export type DelegationsParameters = Omit<DelegationsRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.delegatorHistory} method. */
+export type DelegatorHistoryParameters = Omit<DelegatorHistoryRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.delegatorRewards} method. */
+export type DelegatorRewardsParameters = Omit<DelegatorRewardsRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.delegatorSummary} method. */
+export type DelegatorSummaryParameters = Omit<DelegatorSummaryRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.extraAgents} method. */
 export type ExtraAgentsParameters = Omit<ExtraAgentsRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.frontendOpenOrders} method. */
@@ -23,14 +32,22 @@ export type FrontendOpenOrdersParameters = Omit<FrontendOpenOrdersRequest, "type
 export type FundingHistoryParameters = Omit<FundingHistoryRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.historicalOrders} method. */
 export type HistoricalOrdersParameters = Omit<HistoricalOrdersRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.isVip} method. */
+export type IsVipParameters = Omit<IsVipRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.l2Book} method. */
 export type L2BookParameters = Omit<L2BookRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.legalCheck} method. */
+export type LegalCheckParameters = Omit<LegalCheckRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.maxBuilderFee} method. */
 export type MaxBuilderFeeParameters = Omit<MaxBuilderFeeRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.openOrders} method. */
 export type OpenOrdersParameters = Omit<OpenOrdersRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.orderStatus} method. */
 export type OrderStatusParameters = Omit<OrderStatusRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.portfolio} method. */
+export type PortfolioParameters = Omit<PortfolioRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.preTransferCheck} method. */
+export type PreTransferCheckParameters = Omit<PreTransferCheckRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.referral} method. */
 export type ReferralParameters = Omit<ReferralRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.spotClearinghouseState} method. */
@@ -55,8 +72,14 @@ export type UserFundingParameters = Omit<UserFundingRequest, "type">;
 export type UserNonFundingLedgerUpdatesParameters = Omit<UserNonFundingLedgerUpdatesRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.userRateLimit} method. */
 export type UserRateLimitParameters = Omit<UserRateLimitRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.userRole} method. */
+export type UserRoleParameters = Omit<UserRoleRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.userToMultiSigSigners} method. */
+export type UserToMultiSigSignersParameters = Omit<UserToMultiSigSignersRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.userTwapSliceFills} method. */
 export type UserTwapSliceFillsParameters = Omit<UserTwapSliceFillsRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.userTwapSliceFillsByTime} method. */
+export type UserTwapSliceFillsByTimeParameters = Omit<UserTwapSliceFillsByTimeRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.userVaultEquities} method. */
 export type UserVaultEquitiesParameters = Omit<UserVaultEquitiesRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.vaultDetails} method. */
@@ -65,9 +88,11 @@ export type VaultDetailsParameters = Omit<VaultDetailsRequest, "type">;
 export type BlockDetailsParameters = Omit<BlockDetailsRequest, "type">;
 /** Parameters for the {@linkcode PublicClient.txDetails} method. */
 export type TxDetailsParameters = Omit<TxDetailsRequest, "type">;
+/** Parameters for the {@linkcode PublicClient.userDetails} method. */
+export type UserDetailsParameters = Omit<UserDetailsRequest, "type">;
 /**
  * Public client for interacting with the Hyperliquid API.
- * @typeParam T - The type of transport used to connect to the Hyperliquid API.
+ * @typeParam T The type of transport used to connect to the Hyperliquid API.
  */
 export declare class PublicClient<T extends IRequestTransport = IRequestTransport> {
     /** The transport used to connect to the Hyperliquid API. */
@@ -90,7 +115,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Mid coin prices.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-mids-for-all-coins
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -108,7 +133,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of candlestick data points.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -116,7 +141,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const candles = await client.candleSnapshot({
+     * const candleSnapshot = await client.candleSnapshot({
      *   coin: "ETH",
      *   interval: "1h",
      *   startTime: Date.now() - 1000 * 60 * 60 * 24
@@ -130,7 +155,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Account summary for perpetual trading.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -138,16 +163,89 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const state = await client.clearinghouseState({ user: "0x..." });
+     * const clearinghouseState = await client.clearinghouseState({ user: "0x..." });
      * ```
      */
     clearinghouseState(args: ClearinghouseStateParameters, signal?: AbortSignal): Promise<PerpsClearinghouseState>;
+    /**
+     * Request user staking delegations.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Array of user's delegations to validators.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-staking-delegations
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const delegations = await client.delegations({ user: "0x..." });
+     * ```
+     */
+    delegations(args: DelegationsParameters, signal?: AbortSignal): Promise<Delegation[]>;
+    /**
+     * Request user staking history.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Array of user's staking updates.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-staking-history
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const delegatorHistory = await client.delegatorHistory({ user: "0x..." });
+     * ```
+     */
+    delegatorHistory(args: DelegatorHistoryParameters, signal?: AbortSignal): Promise<DelegatorUpdate[]>;
+    /**
+     * Request user staking rewards.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Array of user's staking rewards.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-staking-rewards
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const delegatorRewards = await client.delegatorRewards({ user: "0x..." });
+     * ```
+     */
+    delegatorRewards(args: DelegatorRewardsParameters, signal?: AbortSignal): Promise<DelegatorReward[]>;
+    /**
+     * Request user staking summary.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Summary of a user's staking delegations.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-staking-summary
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const delegatorSummary = await client.delegatorSummary({ user: "0x..." });
+     * ```
+     */
+    delegatorSummary(args: DelegatorSummaryParameters, signal?: AbortSignal): Promise<DelegatorSummary>;
     /**
      * 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
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -165,7 +263,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of open orders with additional frontend information.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders-with-additional-frontend-info | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders-with-additional-frontend-info
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -173,7 +271,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const orders = await client.frontendOpenOrders({ user: "0x..." });
+     * const frontendOpenOrders = await client.frontendOpenOrders({ user: "0x..." });
      * ```
      */
     frontendOpenOrders(args: FrontendOpenOrdersParameters, signal?: AbortSignal): Promise<FrontendOrder[]>;
@@ -183,7 +281,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of historical funding rate data for an asset.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -191,20 +289,38 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const funding = await client.fundingHistory({
+     * const fundingHistory = await client.fundingHistory({
      *   coin: "ETH",
      *   startTime: Date.now() - 1000 * 60 * 60 * 24
      * });
      * ```
      */
     fundingHistory(args: FundingHistoryParameters, signal?: AbortSignal): Promise<FundingHistory[]>;
+    /**
+     * Request to check if a user is a VIP.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Boolean indicating user's VIP status.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const isVip = await client.isVip({ user: "0x..." });
+     * ```
+     */
+    isVip(args: IsVipParameters, signal?: AbortSignal): Promise<boolean>;
     /**
      * Request user's historical orders.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Array of user's historical orders.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-historical-orders | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-historical-orders
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -212,7 +328,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const orders = await client.historicalOrders({ user: "0x..." });
+     * const historicalOrders = await client.historicalOrders({ user: "0x..." });
      * ```
      */
     historicalOrders(args: HistoricalOrdersParameters, signal?: AbortSignal): Promise<OrderStatus<FrontendOrder>[]>;
@@ -222,7 +338,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns L2 order book snapshot.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -230,17 +346,35 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const book = await client.l2Book({ coin: "ETH", nSigFigs: 2 });
+     * const l2Book = await client.l2Book({ coin: "ETH", nSigFigs: 2 });
      * ```
      */
     l2Book(args: L2BookParameters, signal?: AbortSignal): Promise<Book>;
+    /**
+     * 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
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const legalCheck = await client.legalCheck({ user: "0x..." });
+     * ```
+     */
+    legalCheck(args: LegalCheckParameters, signal?: AbortSignal): Promise<LegalCheck>;
     /**
      * Request builder fee approval.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Maximum builder fee approval.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#check-builder-fee-approval | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#check-builder-fee-approval
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -257,7 +391,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Metadata for perpetual assets.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -274,7 +408,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Metadata and context information for each perpetual asset.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc | Hyperliquid GitBook}
+     * @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
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -292,7 +426,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of open order.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -300,7 +434,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const orders = await client.openOrders({ user: "0x..." });
+     * const openOrders = await client.openOrders({ user: "0x..." });
      * ```
      */
     openOrders(args: OpenOrdersParameters, signal?: AbortSignal): Promise<Order[]>;
@@ -310,7 +444,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Result of an order status lookup.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -318,16 +452,70 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const status = await client.orderStatus({ user: "0x...", oid: 12345 });
+     * const orderStatus = await client.orderStatus({ user: "0x...", oid: 12345 });
      * ```
      */
     orderStatus(args: OrderStatusParameters, signal?: AbortSignal): Promise<OrderLookup>;
+    /**
+     * Request portfolio.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Portfolio of a user.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const portfolio = await client.portfolio({ user: "0x..." });
+     * ```
+     */
+    portfolio(args: PortfolioParameters, signal?: AbortSignal): Promise<PortfolioPeriods>;
+    /**
+     * Request user's existence check before transfer.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Pre-transfer user existence check result.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const preTransferCheck = await client.preTransferCheck({ user: "0x...", source: "0x..." });
+     * ```
+     */
+    preTransferCheck(args: PreTransferCheckParameters, signal?: AbortSignal): Promise<PreTransferCheck>;
+    /**
+     * 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.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#query-perps-at-open-interest-caps
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const perpsAtOpenInterestCap = await client.perpsAtOpenInterestCap();
+     * ```
+     */
+    perpsAtOpenInterestCap(signal?: AbortSignal): Promise<string[]>;
     /**
      * Request predicted funding rates.
      * @param signal - An optional abort signal.
      * @returns Array of predicted funding rates.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-predicted-funding-rates-for-different-venues | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-predicted-funding-rates-for-different-venues
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -345,6 +533,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Referral information for a user.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -362,7 +551,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Balances for spot tokens.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -370,7 +559,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const state = await client.spotClearinghouseState({ user: "0x..." });
+     * const spotClearinghouseState = await client.spotClearinghouseState({ user: "0x..." });
      * ```
      */
     spotClearinghouseState(args: SpotClearinghouseStateParameters, signal?: AbortSignal): Promise<SpotClearinghouseState>;
@@ -380,7 +569,16 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns The deploy state of a user.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-deploy-auction | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-the-spot-deploy-auction
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const spotDeployState = await client.spotDeployState({ user: "0x..." });
+     * ```
      */
     spotDeployState(args: SpotDeployStateParameters, signal?: AbortSignal): Promise<SpotDeployState>;
     /**
@@ -388,7 +586,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Metadata for spot assets.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-metadata
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -396,7 +594,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const meta = await client.spotMeta();
+     * const spotMeta = await client.spotMeta();
      * ```
      */
     spotMeta(signal?: AbortSignal): Promise<SpotMeta>;
@@ -405,7 +603,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Metadata and context information for each spot asset.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -413,7 +611,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const [meta, assetCtxs] = await client.spotMetaAndAssetCtxs();
+     * const [spotMeta, spotAssetCtxs] = await client.spotMetaAndAssetCtxs();
      * ```
      */
     spotMetaAndAssetCtxs(signal?: AbortSignal): Promise<SpotMetaAndAssetCtxs>;
@@ -421,9 +619,9 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * Request user sub-accounts.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Array of user sub-account.
+     * @returns Array of user sub-account or null if the user does not have any sub-accounts.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-subaccounts | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-subaccounts
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -441,7 +639,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns The details of a token.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-a-token | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-information-about-a-token
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -449,7 +647,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const details = await client.tokenDetails({ tokenId: "0x..." });
+     * const tokenDetails = await client.tokenDetails({ tokenId: "0x..." });
      * ```
      */
     tokenDetails(args: TokenDetailsParameters, signal?: AbortSignal): Promise<TokenDetails>;
@@ -459,6 +657,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns The twap history of a user.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -476,6 +675,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns User fees.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -483,7 +683,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const userFees = await client.userFees({ user: "0x..." });
+     * const fees = await client.userFees({ user: "0x..." });
      * ```
      */
     userFees(args: UserFeesParameters, signal?: AbortSignal): Promise<UserFees>;
@@ -493,7 +693,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of user's trade fill.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -511,7 +711,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of user's trade fill.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -532,7 +732,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of user's funding ledger update.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates | Hyperliquid GitBook}
+     * @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
      * import * as hl from "@nktkas/hyperliquid";
@@ -553,7 +753,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of user's non-funding ledger update.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-a-users-funding-history-or-non-funding-ledger-updates | Hyperliquid GitBook}
+     * @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
      * import * as hl from "@nktkas/hyperliquid";
@@ -561,7 +761,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const funding = await client.userNonFundingLedgerUpdates({
+     * const nonFundingLedgerUpdates = await client.userNonFundingLedgerUpdates({
      *   user: "0x...",
      *   startTime: Date.now() - 1000 * 60 * 60 * 24
      * });
@@ -574,7 +774,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns User's rate limits.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-rate-limits | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-user-rate-limits
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -586,13 +786,49 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * ```
      */
     userRateLimit(args: UserRateLimitParameters, signal?: AbortSignal): Promise<UserRateLimit>;
+    /**
+     * Request user role.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns User's role.
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-role
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const userRole = await client.userRole({ user: "0x..." });
+     * ```
+     */
+    userRole(args: UserRoleParameters, signal?: AbortSignal): Promise<UserRole>;
+    /**
+     * Request multi-sig signers for a user.
+     * @param args - The parameters for the request.
+     * @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
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const multiSigSigners = await client.userToMultiSigSigners({ user: "0x..." });
+     * ```
+     */
+    userToMultiSigSigners(args: UserToMultiSigSignersParameters, signal?: AbortSignal): Promise<MultiSigSigners | null>;
     /**
      * Request user twap slice fills.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Array of user's twap slice fill.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-twap-slice-fills | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-twap-slice-fills
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -600,17 +836,38 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const fills = await client.userTwapSliceFills({ user: "0x..." });
+     * const twapSliceFills = await client.userTwapSliceFills({ user: "0x..." });
      * ```
      */
     userTwapSliceFills(args: UserTwapSliceFillsParameters, signal?: AbortSignal): Promise<TwapSliceFill[]>;
+    /**
+     * Request user twap slice fills by time.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Array of user's twap slice fill.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const twapSliceFillsByTime = await client.userTwapSliceFillsByTime({
+     *   user: "0x...",
+     *   startTime: Date.now() - 1000 * 60 * 60 * 24
+     * });
+     * ```
+     */
+    userTwapSliceFillsByTime(args: UserTwapSliceFillsByTimeParameters, signal?: AbortSignal): Promise<TwapSliceFill[]>;
     /**
      * Request user vault deposits.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
      * @returns Array of user's vault deposits.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-vault-deposits | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-vault-deposits
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -618,17 +875,34 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const deposits = await client.userVaultDeposits({ user: "0x..." });
+     * const userVaultEquities = await client.userVaultDeposits({ user: "0x..." });
      * ```
      */
     userVaultEquities(args: UserVaultEquitiesParameters, signal?: AbortSignal): Promise<VaultEquity[]>;
+    /**
+     * Request validator summaries.
+     * @param args - The parameters for the request.
+     * @returns Array of validator summaries.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const validatorSummaries = await client.validatorSummaries();
+     * ```
+     */
+    validatorSummaries(signal?: AbortSignal): Promise<ValidatorSummary[]>;
     /**
      * Request details of a vault.
      * @param args - The parameters for the request.
      * @param signal - An optional abort signal.
-     * @returns Details of a vault.
+     * @returns Details of a vault or null if the vault does not exist.
      *
-     * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-details-for-a-vault | Hyperliquid GitBook}
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-details-for-a-vault
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -636,7 +910,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const vault = await client.vaultDetails({ vaultAddress: "0x..." });
+     * const vaultDetails = await client.vaultDetails({ vaultAddress: "0x..." });
      * ```
      */
     vaultDetails(args: VaultDetailsParameters, signal?: AbortSignal): Promise<VaultDetails | null>;
@@ -646,6 +920,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns Array of vault summaries.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -653,7 +928,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * const transport = new hl.HttpTransport(); // or WebSocketTransport
      * const client = new hl.PublicClient({ transport });
      *
-     * const vaults = await client.vaultSummaries();
+     * const vaultSummaries = await client.vaultSummaries();
      * ```
      */
     vaultSummaries(signal?: AbortSignal): Promise<VaultSummary[]>;
@@ -663,6 +938,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns A promise that resolves with the details of the block.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -680,6 +956,7 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * @param signal - An optional abort signal.
      * @returns A promise that resolves with the details of the transaction.
      *
+     * @see null - no documentation
      * @example
      * ```ts
      * import * as hl from "@nktkas/hyperliquid";
@@ -691,5 +968,23 @@ export declare class PublicClient<T extends IRequestTransport = IRequestTranspor
      * ```
      */
     txDetails(args: TxDetailsParameters, signal?: AbortSignal): Promise<TxDetailsResponse>;
+    /**
+     * Request user details.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns User details.
+     *
+     * @see null - no documentation
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     *
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.PublicClient({ transport });
+     *
+     * const { txs } = await client.userDetails({ user: "0x..." });
+     * ```
+     */
+    userDetails(args: UserDetailsParameters, signal?: AbortSignal): Promise<UserDetailsResponse>;
 }
 //# sourceMappingURL=public.d.ts.map