@nktkas/hyperliquid/esm/src/api/info/_methods/delegations.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 staking delegations.
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations
 */
export const DelegationsRequest = /* @__PURE__ */ (() => {
    return v.pipe(v.object({
        /** Type of request. */
        type: v.pipe(v.literal("delegations"), v.description("Type of request.")),
        /** User address. */
        user: v.pipe(Address, v.description("User address.")),
    }), v.description("Request user staking delegations."));
})();
/**
 * Array of user's delegations to validators.
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations
 */
export const DelegationsResponse = /* @__PURE__ */ (() => {
    return v.pipe(v.array(
    /** User delegation to a validator. */
    v.pipe(v.object({
        /** Validator address. */
        validator: v.pipe(Address, v.description("Validator address.")),
        /** Amount of tokens delegated to the validator. */
        amount: v.pipe(UnsignedDecimal, v.description("Amount of tokens delegated to the validator.")),
        /** Locked until timestamp (in ms since epoch). */
        lockedUntilTimestamp: v.pipe(UnsignedInteger, v.description("Locked until timestamp (in ms since epoch).")),
    }), v.description("User delegation to a validator."))), v.description("Array of user's delegations to validators."));
})();
/**
 * Request user staking delegations.
 *
 * @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 Array of user's delegations to validators.
 *
 * @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 { delegations } from "@nktkas/hyperliquid/api/info";
 *
 * const transport = new HttpTransport(); // or `WebSocketTransport`
 *
 * const data = await delegations(
 *   { transport },
 *   { user: "0x..." },
 * );
 * ```
 *
 * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations
 */
export function delegations(config, params, signal) {
    const request = v.parse(DelegationsRequest, {
        type: "delegations",
        ...params,
    });
    return config.transport.request("info", request, signal);
}
//# sourceMappingURL=delegations.js.map