@nktkas/hyperliquid/esm/src/api/info/_methods/delegatorSummary.js

Hyperliquid API SDK for all major JS runtimes, written in TypeScript.

import * as v from "valibot";
// ============================================================
// API Schemas
// ============================================================
import { Address, UnsignedDecimal, UnsignedInteger } from "../../_schemas.js";
/**
 * Request user's staking summary.
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
 */
export const DelegatorSummaryRequest = /* @__PURE__ */ (() => {
    return v.pipe(v.object({
        /** Type of request. */
        type: v.pipe(v.literal("delegatorSummary"), v.description("Type of request.")),
        /** User address. */
        user: v.pipe(Address, v.description("User address.")),
    }), v.description("Request user's staking summary."));
})();
/**
 * User's staking summary.
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
 */
export const DelegatorSummaryResponse = /* @__PURE__ */ (() => {
    return v.pipe(v.object({
        /** Total amount of delegated tokens. */
        delegated: v.pipe(UnsignedDecimal, v.description("Total amount of delegated tokens.")),
        /** Total amount of undelegated tokens. */
        undelegated: v.pipe(UnsignedDecimal, v.description("Total amount of undelegated tokens.")),
        /** Total amount of tokens pending withdrawal. */
        totalPendingWithdrawal: v.pipe(UnsignedDecimal, v.description("Total amount of tokens pending withdrawal.")),
        /** Number of pending withdrawals. */
        nPendingWithdrawals: v.pipe(UnsignedInteger, v.description("Number of pending withdrawals.")),
    }), v.description("User's staking summary."));
})();
/**
 * Request user's staking summary.
 *
 * @param config - General configuration for Info API requests.
 * @param params - Parameters specific to the API request.
 * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request.
 *
 * @returns User's staking summary.
 *
 * @throws {ValiError} When the request parameters fail validation (before sending).
 * @throws {TransportError} When the transport layer throws an error.
 *
 * @example
 * ```ts
 * import { HttpTransport } from "@nktkas/hyperliquid";
 * import { delegatorSummary } from "@nktkas/hyperliquid/api/info";
 *
 * const transport = new HttpTransport(); // or `WebSocketTransport`
 *
 * const data = await delegatorSummary(
 *   { transport },
 *   { user: "0x..." },
 * );
 * ```
 *
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-summary
 */
export function delegatorSummary(config, params, signal) {
    const request = v.parse(DelegatorSummaryRequest, {
        type: "delegatorSummary",
        ...params,
    });
    return config.transport.request("info", request, signal);
}
//# sourceMappingURL=delegatorSummary.js.map