@hfunlabs/hyperliquid 0.27.1-hfunlabs.1

package/esm/src/api/info/clearinghouseState.js

@@ -0,0 +1,143 @@
+import * as v from "valibot";
+// ============================================================
+// API Schemas
+// ============================================================
+import { Address, Decimal, UnsignedDecimal, UnsignedInteger } from "../_base.js";
+/**
+ * Request clearinghouse state.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
+ */
+export const ClearinghouseStateRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Type of request. */
+        type: v.pipe(v.literal("clearinghouseState"), v.description("Type of request.")),
+        /** User address. */
+        user: v.pipe(Address, v.description("User address.")),
+        /** DEX name (empty string for main dex). */
+        dex: v.pipe(v.optional(v.string()), v.description("DEX name (empty string for main dex).")),
+    }), v.description("Request clearinghouse state."));
+})();
+/**
+ * Account summary for perpetual trading.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary
+ */
+export const ClearinghouseStateResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Margin summary details. */
+        marginSummary: v.pipe(v.object({
+            /** Total account value. */
+            accountValue: v.pipe(UnsignedDecimal, v.description("Total account value.")),
+            /** Total notional position value. */
+            totalNtlPos: v.pipe(UnsignedDecimal, v.description("Total notional position value.")),
+            /** Total raw USD value. */
+            totalRawUsd: v.pipe(UnsignedDecimal, v.description("Total raw USD value.")),
+            /** Total margin used. */
+            totalMarginUsed: v.pipe(UnsignedDecimal, v.description("Total margin used.")),
+        }), v.description("Margin summary details.")),
+        /** Cross-margin summary details. */
+        crossMarginSummary: v.pipe(v.object({
+            /** Total account value. */
+            accountValue: v.pipe(UnsignedDecimal, v.description("Total account value.")),
+            /** Total notional position value. */
+            totalNtlPos: v.pipe(UnsignedDecimal, v.description("Total notional position value.")),
+            /** Total raw USD value. */
+            totalRawUsd: v.pipe(UnsignedDecimal, v.description("Total raw USD value.")),
+            /** Total margin used. */
+            totalMarginUsed: v.pipe(UnsignedDecimal, v.description("Total margin used.")),
+        }), v.description("Cross-margin summary details.")),
+        /** Maintenance margin used for cross-margin positions. */
+        crossMaintenanceMarginUsed: v.pipe(UnsignedDecimal, v.description("Maintenance margin used for cross-margin positions.")),
+        /** Amount available for withdrawal. */
+        withdrawable: v.pipe(UnsignedDecimal, v.description("Amount available for withdrawal.")),
+        /** Array of asset positions. */
+        assetPositions: v.pipe(v.array(
+        /** Position for a specific asset. */
+        v.pipe(v.object({
+            /** Position type. */
+            type: v.pipe(v.literal("oneWay"), v.description("Position type.")),
+            /** Position details. */
+            position: v.pipe(v.object({
+                /** Asset symbol. */
+                coin: v.pipe(v.string(), v.description("Asset symbol.")),
+                /** Signed position size. */
+                szi: v.pipe(Decimal, v.description("Signed position size.")),
+                /** Leverage details. */
+                leverage: v.pipe(v.variant("type", [
+                    v.object({
+                        /** Leverage type. */
+                        type: v.pipe(v.literal("isolated"), v.description("Leverage type.")),
+                        /** Leverage value used. */
+                        value: v.pipe(UnsignedInteger, v.minValue(1), v.description("Leverage value used.")),
+                        /** Amount of USD used (1 = $1). */
+                        rawUsd: v.pipe(UnsignedDecimal, v.description("Amount of USD used (1 = $1).")),
+                    }),
+                    v.object({
+                        /** Leverage type. */
+                        type: v.pipe(v.literal("cross"), v.description("Leverage type.")),
+                        /** Leverage value used. */
+                        value: v.pipe(UnsignedInteger, v.minValue(1), v.description("Leverage value used.")),
+                    }),
+                ]), v.description("Leverage details.")),
+                /** Average entry price. */
+                entryPx: v.pipe(UnsignedDecimal, v.description("Average entry price.")),
+                /** Position value. */
+                positionValue: v.pipe(UnsignedDecimal, v.description("Position value.")),
+                /** Unrealized profit and loss. */
+                unrealizedPnl: v.pipe(Decimal, v.description("Unrealized profit and loss.")),
+                /** Return on equity. */
+                returnOnEquity: v.pipe(Decimal, v.description("Return on equity.")),
+                /** Liquidation price. */
+                liquidationPx: v.pipe(v.nullable(UnsignedDecimal), v.description("Liquidation price.")),
+                /** Margin used. */
+                marginUsed: v.pipe(UnsignedDecimal, v.description("Margin used.")),
+                /** Maximum allowed leverage. */
+                maxLeverage: v.pipe(UnsignedInteger, v.minValue(1), v.description("Maximum allowed leverage.")),
+                /** Cumulative funding details. */
+                cumFunding: v.pipe(v.object({
+                    /** Total funding paid or received since account opening. */
+                    allTime: v.pipe(Decimal, v.description("Total funding paid or received since account opening.")),
+                    /** Funding accumulated since the position was opened. */
+                    sinceOpen: v.pipe(Decimal, v.description("Funding accumulated since the position was opened.")),
+                    /** Funding accumulated since the last change in position size. */
+                    sinceChange: v.pipe(Decimal, v.description("Funding accumulated since the last change in position size.")),
+                }), v.description("Cumulative funding details.")),
+            }), v.description("Position details.")),
+        }), v.description("Position for a specific asset."))), v.description("Array of asset positions.")),
+        /** Timestamp when data was retrieved (in ms since epoch). */
+        time: v.pipe(UnsignedInteger, v.description("Timestamp when data was retrieved (in ms since epoch).")),
+    }), v.description("Account summary for perpetual trading."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+import { parser } from "../_base.js";
+/**
+ * Request clearinghouse state.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @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
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { clearinghouseState } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await clearinghouseState(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export function clearinghouseState(config, params, signal) {
+    const request = parser(ClearinghouseStateRequest)({
+        type: "clearinghouseState",
+        ...params,
+    });
+    return config.transport.request("info", request, signal);
+}
+//# sourceMappingURL=clearinghouseState.js.map

package/esm/src/api/info/clearinghouseState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearinghouseState.js","sourceRoot":"","sources":["../../../../src/src/api/info/clearinghouseState.ts"],"names":[],"mappings":"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"}

package/esm/src/api/info/delegations.d.ts

@@ -0,0 +1,64 @@
+import * as v from "valibot";
+/**
+ * Request user staking delegations.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-delegations
+ */
+export declare const DelegationsRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Type of request. */
+    readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"delegations", undefined>, v.DescriptionAction<"delegations", "Type of request.">]>;
+    /** User address. */
+    readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "User address.">]>;
+}, undefined>, v.DescriptionAction<{
+    type: "delegations";
+    user: `0x${string}`;
+}, "Request user staking delegations.">]>;
+export type DelegationsRequest = v.InferOutput<typeof DelegationsRequest>;
+/**
+ * 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 declare const DelegationsResponse: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Validator address. */
+    readonly validator: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "Validator address.">]>;
+    /** Amount of tokens delegated to the validator. */
+    readonly amount: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Amount of tokens delegated to the validator.">]>;
+    /** Locked until timestamp (in ms since epoch). */
+    readonly lockedUntilTimestamp: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Locked until timestamp (in ms since epoch).">]>;
+}, undefined>, v.DescriptionAction<{
+    validator: `0x${string}`;
+    amount: string;
+    lockedUntilTimestamp: number;
+}, "User delegation to a validator.">]>, undefined>, v.DescriptionAction<{
+    validator: `0x${string}`;
+    amount: string;
+    lockedUntilTimestamp: number;
+}[], "Array of user's delegations to validators.">]>;
+export type DelegationsResponse = v.InferOutput<typeof DelegationsResponse>;
+import { type DeepImmutable } from "../_base.js";
+import type { InfoRequestConfig } from "./_types.js";
+/** Request parameters for the {@linkcode delegations} function. */
+export type DelegationsParameters = Omit<v.InferInput<typeof DelegationsRequest>, "type">;
+/**
+ * Request user staking delegations.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @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
+ * 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..." },
+ * );
+ * ```
+ */
+export declare function delegations(config: InfoRequestConfig, params: DeepImmutable<DelegationsParameters>, signal?: AbortSignal): Promise<DelegationsResponse>;
+//# sourceMappingURL=delegations.d.ts.map

package/esm/src/api/info/delegations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegations.d.ts","sourceRoot":"","sources":["../../../../src/src/api/info/delegations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAQ7B;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAGzB,uBAAuB;;IAKvB,oBAAoB;;;;;yCAQtB,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAMtB,yBAAyB;;IAKzB,mDAAmD;;IAKnD,kDAAkD;;;;;;;;;;oDAWxD,CAAC;AACL,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAM5E,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAM9B"}

package/esm/src/api/info/delegations.js

@@ -0,0 +1,67 @@
+import * as v from "valibot";
+// ============================================================
+// API Schemas
+// ============================================================
+import { Address, UnsignedDecimal, UnsignedInteger } from "../_base.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."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+import { parser } from "../_base.js";
+/**
+ * Request user staking delegations.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @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
+ * 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..." },
+ * );
+ * ```
+ */
+export function delegations(config, params, signal) {
+    const request = parser(DelegationsRequest)({
+        type: "delegations",
+        ...params,
+    });
+    return config.transport.request("info", request, signal);
+}
+//# sourceMappingURL=delegations.js.map

package/esm/src/api/info/delegations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegations.js","sourceRoot":"","sources":["../../../../src/src/api/info/delegations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACtD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,MAAM,CAAC;QACP,uBAAuB;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CACV,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EACxB,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAClC;QACD,oBAAoB;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CACV,OAAO,EACP,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAC/B;KACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CACnD,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACvD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,KAAK;IACL,sCAAsC;IACtC,CAAC,CAAC,IAAI,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,yBAAyB;QACzB,SAAS,EAAE,CAAC,CAAC,IAAI,CACf,OAAO,EACP,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CACpC;QACD,mDAAmD;QACnD,MAAM,EAAE,CAAC,CAAC,IAAI,CACZ,eAAe,EACf,CAAC,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAC9D;QACD,kDAAkD;QAClD,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAC1B,eAAe,EACf,CAAC,CAAC,WAAW,CAAC,6CAA6C,CAAC,CAC7D;KACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,iCAAiC,CAAC,CACjD,CACF,EACD,CAAC,CAAC,WAAW,CAAC,4CAA4C,CAAC,CAC5D,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,OAAO,EAAsB,MAAM,EAAE,MAAM,aAAa,CAAC;AAMzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CACzB,MAAyB,EACzB,MAA4C,EAC5C,MAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACzC,IAAI,EAAE,aAAa;QACnB,GAAG,MAAM;KACV,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/esm/src/api/info/delegatorHistory.d.ts

@@ -0,0 +1,142 @@
+import * as v from "valibot";
+/**
+ * Request user staking history.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history
+ */
+export declare const DelegatorHistoryRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Type of request. */
+    readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"delegatorHistory", undefined>, v.DescriptionAction<"delegatorHistory", "Type of request.">]>;
+    /** User address. */
+    readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "User address.">]>;
+}, undefined>, v.DescriptionAction<{
+    type: "delegatorHistory";
+    user: `0x${string}`;
+}, "Request user staking history.">]>;
+export type DelegatorHistoryRequest = v.InferOutput<typeof DelegatorHistoryRequest>;
+/**
+ * Array of records of staking events by a delegator.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history
+ */
+export declare const DelegatorHistoryResponse: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Timestamp of the delegation event (in ms since epoch). */
+    readonly time: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Timestamp of the delegation event (in ms since epoch).">]>;
+    /** Transaction hash of the delegation event. */
+    readonly hash: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "Transaction hash of the delegation event.">]>;
+    /** Details of the update. */
+    readonly delta: v.SchemaWithPipe<readonly [v.UnionSchema<[v.ObjectSchema<{
+        /** Delegation operation details. */
+        readonly delegate: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            /** Address of the validator receiving or losing delegation. */
+            readonly validator: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "Address of the validator receiving or losing delegation.">]>;
+            /** Amount of tokens being delegated or undelegated. */
+            readonly amount: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Amount of tokens being delegated or undelegated.">]>;
+            /** Whether this is an undelegation operation. */
+            readonly isUndelegate: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Whether this is an undelegation operation.">]>;
+        }, undefined>, v.DescriptionAction<{
+            validator: `0x${string}`;
+            amount: string;
+            isUndelegate: boolean;
+        }, "Delegation operation details.">]>;
+    }, undefined>, v.ObjectSchema<{
+        /** Deposit details. */
+        readonly cDeposit: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            /** Amount of tokens being deposited. */
+            readonly amount: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Amount of tokens being deposited.">]>;
+        }, undefined>, v.DescriptionAction<{
+            amount: string;
+        }, "Deposit details.">]>;
+    }, undefined>, v.ObjectSchema<{
+        /** Withdrawal details. */
+        readonly withdrawal: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            /** Amount of tokens being withdrawn. */
+            readonly amount: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Amount of tokens being withdrawn.">]>;
+            /** Phase of the withdrawal process. */
+            readonly phase: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"initiated", undefined>, v.LiteralSchema<"finalized", undefined>], undefined>, v.DescriptionAction<"initiated" | "finalized", "Phase of the withdrawal process.">]>;
+        }, undefined>, v.DescriptionAction<{
+            amount: string;
+            phase: "initiated" | "finalized";
+        }, "Withdrawal details.">]>;
+    }, undefined>], undefined>, v.DescriptionAction<{
+        delegate: {
+            validator: `0x${string}`;
+            amount: string;
+            isUndelegate: boolean;
+        };
+    } | {
+        cDeposit: {
+            amount: string;
+        };
+    } | {
+        withdrawal: {
+            amount: string;
+            phase: "initiated" | "finalized";
+        };
+    }, "Details of the update.">]>;
+}, undefined>, v.DescriptionAction<{
+    time: number;
+    hash: `0x${string}`;
+    delta: {
+        delegate: {
+            validator: `0x${string}`;
+            amount: string;
+            isUndelegate: boolean;
+        };
+    } | {
+        cDeposit: {
+            amount: string;
+        };
+    } | {
+        withdrawal: {
+            amount: string;
+            phase: "initiated" | "finalized";
+        };
+    };
+}, "Record of a staking event by a delegator.">]>, undefined>, v.DescriptionAction<{
+    time: number;
+    hash: `0x${string}`;
+    delta: {
+        delegate: {
+            validator: `0x${string}`;
+            amount: string;
+            isUndelegate: boolean;
+        };
+    } | {
+        cDeposit: {
+            amount: string;
+        };
+    } | {
+        withdrawal: {
+            amount: string;
+            phase: "initiated" | "finalized";
+        };
+    };
+}[], "Array of records of staking events by a delegator.">]>;
+export type DelegatorHistoryResponse = v.InferOutput<typeof DelegatorHistoryResponse>;
+import { type DeepImmutable } from "../_base.js";
+import type { InfoRequestConfig } from "./_types.js";
+/** Request parameters for the {@linkcode delegatorHistory} function. */
+export type DelegatorHistoryParameters = Omit<v.InferInput<typeof DelegatorHistoryRequest>, "type">;
+/**
+ * Request user staking history.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of records of staking events by a delegator.
+ *
+ * @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
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { delegatorHistory } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await delegatorHistory(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export declare function delegatorHistory(config: InfoRequestConfig, params: DeepImmutable<DelegatorHistoryParameters>, signal?: AbortSignal): Promise<DelegatorHistoryResponse>;
+//# sourceMappingURL=delegatorHistory.d.ts.map

package/esm/src/api/info/delegatorHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegatorHistory.d.ts","sourceRoot":"","sources":["../../../../src/src/api/info/delegatorHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAQ7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAG9B,uBAAuB;;IAKvB,oBAAoB;;;;;qCAQtB,CAAC;AACL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;IAM3B,6DAA6D;;IAK7D,gDAAgD;;IAKhD,6BAA6B;;QAIvB,oCAAoC;;YAGhC,+DAA+D;;YAK/D,uDAAuD;;YAKvD,iDAAiD;;;;;;;;QAUrD,uBAAuB;;YAGnB,wCAAwC;;;;;;QAU5C,0BAA0B;;YAGtB,wCAAwC;;YAKxC,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DAkBvD,CAAC;AACL,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAMtF,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wEAAwE;AACxE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,0BAA0B,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAMnC"}

package/esm/src/api/info/delegatorHistory.js

@@ -0,0 +1,95 @@
+import * as v from "valibot";
+// ============================================================
+// API Schemas
+// ============================================================
+import { Address, Hex, UnsignedDecimal, UnsignedInteger } from "../_base.js";
+/**
+ * Request user staking history.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history
+ */
+export const DelegatorHistoryRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Type of request. */
+        type: v.pipe(v.literal("delegatorHistory"), v.description("Type of request.")),
+        /** User address. */
+        user: v.pipe(Address, v.description("User address.")),
+    }), v.description("Request user staking history."));
+})();
+/**
+ * Array of records of staking events by a delegator.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-history
+ */
+export const DelegatorHistoryResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.array(
+    /** Record of a staking event by a delegator. */
+    v.pipe(v.object({
+        /** Timestamp of the delegation event (in ms since epoch). */
+        time: v.pipe(UnsignedInteger, v.description("Timestamp of the delegation event (in ms since epoch).")),
+        /** Transaction hash of the delegation event. */
+        hash: v.pipe(v.pipe(Hex, v.length(66)), v.description("Transaction hash of the delegation event.")),
+        /** Details of the update. */
+        delta: v.pipe(v.union([
+            v.object({
+                /** Delegation operation details. */
+                delegate: v.pipe(v.object({
+                    /** Address of the validator receiving or losing delegation. */
+                    validator: v.pipe(Address, v.description("Address of the validator receiving or losing delegation.")),
+                    /** Amount of tokens being delegated or undelegated. */
+                    amount: v.pipe(UnsignedDecimal, v.description("Amount of tokens being delegated or undelegated.")),
+                    /** Whether this is an undelegation operation. */
+                    isUndelegate: v.pipe(v.boolean(), v.description("Whether this is an undelegation operation.")),
+                }), v.description("Delegation operation details.")),
+            }),
+            v.object({
+                /** Deposit details. */
+                cDeposit: v.pipe(v.object({
+                    /** Amount of tokens being deposited. */
+                    amount: v.pipe(UnsignedDecimal, v.description("Amount of tokens being deposited.")),
+                }), v.description("Deposit details.")),
+            }),
+            v.object({
+                /** Withdrawal details. */
+                withdrawal: v.pipe(v.object({
+                    /** Amount of tokens being withdrawn. */
+                    amount: v.pipe(UnsignedDecimal, v.description("Amount of tokens being withdrawn.")),
+                    /** Phase of the withdrawal process. */
+                    phase: v.pipe(v.union([v.literal("initiated"), v.literal("finalized")]), v.description("Phase of the withdrawal process.")),
+                }), v.description("Withdrawal details.")),
+            }),
+        ]), v.description("Details of the update.")),
+    }), v.description("Record of a staking event by a delegator."))), v.description("Array of records of staking events by a delegator."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+import { parser } from "../_base.js";
+/**
+ * Request user staking history.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of records of staking events by a delegator.
+ *
+ * @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
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { delegatorHistory } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await delegatorHistory(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export function delegatorHistory(config, params, signal) {
+    const request = parser(DelegatorHistoryRequest)({
+        type: "delegatorHistory",
+        ...params,
+    });
+    return config.transport.request("info", request, signal);
+}
+//# sourceMappingURL=delegatorHistory.js.map

package/esm/src/api/info/delegatorHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegatorHistory.js","sourceRoot":"","sources":["../../../../src/src/api/info/delegatorHistory.ts"],"names":[],"mappings":"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"}

package/esm/src/api/info/delegatorRewards.d.ts

@@ -0,0 +1,64 @@
+import * as v from "valibot";
+/**
+ * Request user staking rewards.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-rewards
+ */
+export declare const DelegatorRewardsRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Type of request. */
+    readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"delegatorRewards", undefined>, v.DescriptionAction<"delegatorRewards", "Type of request.">]>;
+    /** User address. */
+    readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "User address.">]>;
+}, undefined>, v.DescriptionAction<{
+    type: "delegatorRewards";
+    user: `0x${string}`;
+}, "Request user staking rewards.">]>;
+export type DelegatorRewardsRequest = v.InferOutput<typeof DelegatorRewardsRequest>;
+/**
+ * Array of rewards received from staking activities.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-staking-rewards
+ */
+export declare const DelegatorRewardsResponse: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Timestamp when the reward was received (in ms since epoch). */
+    readonly time: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Timestamp when the reward was received (in ms since epoch).">]>;
+    /** Source of the reward. */
+    readonly source: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"delegation", undefined>, v.LiteralSchema<"commission", undefined>], undefined>, v.DescriptionAction<"delegation" | "commission", "Source of the reward.">]>;
+    /** Total reward amount. */
+    readonly totalAmount: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Total reward amount.">]>;
+}, undefined>, v.DescriptionAction<{
+    time: number;
+    source: "delegation" | "commission";
+    totalAmount: string;
+}, "Reward received from staking activities.">]>, undefined>, v.DescriptionAction<{
+    time: number;
+    source: "delegation" | "commission";
+    totalAmount: string;
+}[], "Array of rewards received from staking activities.">]>;
+export type DelegatorRewardsResponse = v.InferOutput<typeof DelegatorRewardsResponse>;
+import { type DeepImmutable } from "../_base.js";
+import type { InfoRequestConfig } from "./_types.js";
+/** Request parameters for the {@linkcode delegatorRewards} function. */
+export type DelegatorRewardsParameters = Omit<v.InferInput<typeof DelegatorRewardsRequest>, "type">;
+/**
+ * Request user staking rewards.
+ * @param config - General configuration for Info API requests.
+ * @param params - Parameters specific to the API request.
+ * @param signal - An [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) can be used to cancel the request by calling [`abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort) on the corresponding [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController).
+ * @returns Array of rewards received from staking activities.
+ *
+ * @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
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { delegatorRewards } from "@nktkas/hyperliquid/api/info";
+ *
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ * const data = await delegatorRewards(
+ *   { transport },
+ *   { user: "0x..." },
+ * );
+ * ```
+ */
+export declare function delegatorRewards(config: InfoRequestConfig, params: DeepImmutable<DelegatorRewardsParameters>, signal?: AbortSignal): Promise<DelegatorRewardsResponse>;
+//# sourceMappingURL=delegatorRewards.d.ts.map

package/esm/src/api/info/delegatorRewards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegatorRewards.d.ts","sourceRoot":"","sources":["../../../../src/src/api/info/delegatorRewards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAQ7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB;IAG9B,uBAAuB;;IAKvB,oBAAoB;;;;;qCAQtB,CAAC;AACL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;IAM3B,kEAAkE;;IAKlE,4BAA4B;;IAK5B,2BAA2B;;;;;;;;;;4DAWjC,CAAC;AACL,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAMtF,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,wEAAwE;AACxE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,aAAa,CAAC,0BAA0B,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAMnC"}