@nktkas/hyperliquid 0.30.3 → 0.32.0

package/script/api/exchange/_methods/subAccountTransfer.d.ts

@@ -0,0 +1,124 @@
+import * as v from "valibot";
+import { type ErrorResponse, type SuccessResponse } from "./_base/commonSchemas.js";
+/**
+ * Transfer between sub-accounts (perpetual).
+ * @see null
+ */
+export declare const SubAccountTransferRequest: v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.LiteralSchema<"subAccountTransfer", undefined>;
+        /** Sub-account address. */
+        readonly subAccountUser: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+        /** `true` for deposit, `false` for withdrawal. */
+        readonly isDeposit: v.BooleanSchema<undefined>;
+        /** Amount to transfer (float * 1e6). */
+        readonly usd: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+    }, undefined>;
+    /** Nonce (timestamp in ms) used to prevent replay attacks. */
+    readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /** ECDSA signature components. */
+    readonly signature: v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly v: v.PicklistSchema<[27, 28], undefined>;
+    }, undefined>;
+    /** Expiration time of the action. */
+    readonly expiresAfter: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+}, undefined>;
+export type SubAccountTransferRequest = v.InferOutput<typeof SubAccountTransferRequest>;
+/**
+ * Successful response without specific data or error response.
+ * @see null
+ */
+export type SubAccountTransferResponse = SuccessResponse | ErrorResponse;
+import type { ExcludeErrorResponse } from "./_base/errors.js";
+import { type ExchangeConfig, type ExtractRequestOptions } from "./_base/execute.js";
+/** Schema for user-provided action parameters (excludes system fields). */
+declare const SubAccountTransferParameters: Omit<v.ObjectSchema<{
+    /** Type of action. */
+    readonly type: v.LiteralSchema<"subAccountTransfer", undefined>;
+    /** Sub-account address. */
+    readonly subAccountUser: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+    /** `true` for deposit, `false` for withdrawal. */
+    readonly isDeposit: v.BooleanSchema<undefined>;
+    /** Amount to transfer (float * 1e6). */
+    readonly usd: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+}, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: Omit<{
+        /** Type of action. */
+        readonly type: v.LiteralSchema<"subAccountTransfer", undefined>;
+        /** Sub-account address. */
+        readonly subAccountUser: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+        /** `true` for deposit, `false` for withdrawal. */
+        readonly isDeposit: v.BooleanSchema<undefined>;
+        /** Amount to transfer (float * 1e6). */
+        readonly usd: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+    }, "type">;
+    readonly "~standard": v.StandardProps<{
+        subAccountUser: string;
+        isDeposit: boolean;
+        usd: string | number;
+    }, {
+        subAccountUser: `0x${string}`;
+        isDeposit: boolean;
+        usd: number;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+        subAccountUser: `0x${string}`;
+        isDeposit: boolean;
+        usd: number;
+    }, v.StringIssue | v.NumberIssue | v.UnionIssue<v.StringIssue | v.NumberIssue> | v.RegexIssue<string> | v.ToNumberIssue<string | number> | v.SafeIntegerIssue<number> | v.MinValueIssue<number, 0> | v.LengthIssue<`0x${string}`, 42> | v.ObjectIssue | v.BooleanIssue | v.MinValueIssue<number, 1>>;
+    readonly "~types"?: {
+        readonly input: {
+            subAccountUser: string;
+            isDeposit: boolean;
+            usd: string | number;
+        };
+        readonly output: {
+            subAccountUser: `0x${string}`;
+            isDeposit: boolean;
+            usd: number;
+        };
+        readonly issue: v.StringIssue | v.NumberIssue | v.UnionIssue<v.StringIssue | v.NumberIssue> | v.RegexIssue<string> | v.ToNumberIssue<string | number> | v.SafeIntegerIssue<number> | v.MinValueIssue<number, 0> | v.LengthIssue<`0x${string}`, 42> | v.ObjectIssue | v.BooleanIssue | v.MinValueIssue<number, 1>;
+    } | undefined;
+};
+/** Action parameters for the {@linkcode subAccountTransfer} function. */
+export type SubAccountTransferParameters = v.InferInput<typeof SubAccountTransferParameters>;
+/** Request options for the {@linkcode subAccountTransfer} function. */
+export type SubAccountTransferOptions = ExtractRequestOptions<v.InferInput<typeof SubAccountTransferRequest>>;
+/** Successful variant of {@linkcode SubAccountTransferResponse} without errors. */
+export type SubAccountTransferSuccessResponse = ExcludeErrorResponse<SubAccountTransferResponse>;
+/**
+ * Transfer between sub-accounts (perpetual).
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param params Parameters specific to the API request.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { subAccountTransfer } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await subAccountTransfer(
+ *   { transport, wallet },
+ *   { subAccountUser: "0x...", isDeposit: true, usd: 1 * 1e6 },
+ * );
+ * ```
+ *
+ * @see null
+ */
+export declare function subAccountTransfer(config: ExchangeConfig, params: SubAccountTransferParameters, opts?: SubAccountTransferOptions): Promise<SubAccountTransferSuccessResponse>;
+export {};
+//# sourceMappingURL=subAccountTransfer.d.ts.map

package/script/api/exchange/_methods/subAccountTransfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subAccountTransfer.d.ts","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/subAccountTransfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAO7B,OAAO,EAAE,KAAK,aAAa,EAAmB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAErG;;;GAGG;AACH,eAAO,MAAM,yBAAyB;IAElC,yBAAyB;;QAEvB,sBAAsB;;QAEtB,2BAA2B;;QAE3B,kDAAkD;;QAElD,wCAAwC;;;IAG1C,8DAA8D;;IAE9D,kCAAkC;;;;;;IAElC,qCAAqC;;aAGrC,CAAC;AACL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAExF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,eAAe,GAAG,aAAa,CAAC;AAOzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAmB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtG,2EAA2E;AAC3E,QAAA,MAAM,4BAA4B;IAlC5B,sBAAsB;;IAEtB,2BAA2B;;IAE3B,kDAAkD;;IAElD,wCAAwC;;;;QANxC,sBAAsB;;QAEtB,2BAA2B;;QAE3B,kDAAkD;;QAElD,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC1C,CAAC;AAEL,yEAAyE;AACzE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE7F,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC,CAAC;AAE9G,mFAAmF;AACnF,MAAM,MAAM,iCAAiC,GAAG,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,4BAA4B,EACpC,IAAI,CAAC,EAAE,yBAAyB,GAC/B,OAAO,CAAC,iCAAiC,CAAC,CAG5C"}

package/script/api/exchange/_methods/subAccountTransfer.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAccountTransferRequest = void 0;
+exports.subAccountTransfer = subAccountTransfer;
+const v = __importStar(require("valibot"));
+// ============================================================
+// API Schemas
+// ============================================================
+const _schemas_js_1 = require("../../_schemas.js");
+const commonSchemas_js_1 = require("./_base/commonSchemas.js");
+/**
+ * Transfer between sub-accounts (perpetual).
+ * @see null
+ */
+exports.SubAccountTransferRequest = (() => {
+    return v.object({
+        /** Action to perform. */
+        action: v.object({
+            /** Type of action. */
+            type: v.literal("subAccountTransfer"),
+            /** Sub-account address. */
+            subAccountUser: _schemas_js_1.Address,
+            /** `true` for deposit, `false` for withdrawal. */
+            isDeposit: v.boolean(),
+            /** Amount to transfer (float * 1e6). */
+            usd: v.pipe(_schemas_js_1.UnsignedInteger, v.minValue(1)),
+        }),
+        /** Nonce (timestamp in ms) used to prevent replay attacks. */
+        nonce: _schemas_js_1.UnsignedInteger,
+        /** ECDSA signature components. */
+        signature: commonSchemas_js_1.SignatureSchema,
+        /** Expiration time of the action. */
+        expiresAfter: v.optional(_schemas_js_1.UnsignedInteger),
+    });
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+const _base_js_1 = require("../../../_base.js");
+const execute_js_1 = require("./_base/execute.js");
+/** Schema for user-provided action parameters (excludes system fields). */
+const SubAccountTransferParameters = /* @__PURE__ */ (() => {
+    return v.omit(v.object(exports.SubAccountTransferRequest.entries.action.entries), ["type"]);
+})();
+/**
+ * Transfer between sub-accounts (perpetual).
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param params Parameters specific to the API request.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { subAccountTransfer } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await subAccountTransfer(
+ *   { transport, wallet },
+ *   { subAccountUser: "0x...", isDeposit: true, usd: 1 * 1e6 },
+ * );
+ * ```
+ *
+ * @see null
+ */
+function subAccountTransfer(config, params, opts) {
+    const action = (0, _base_js_1.parse)(SubAccountTransferParameters, params);
+    return (0, execute_js_1.executeL1Action)(config, { type: "subAccountTransfer", ...action }, opts);
+}
+//# sourceMappingURL=subAccountTransfer.js.map

package/script/api/exchange/_methods/subAccountTransfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subAccountTransfer.js","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/subAccountTransfer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgGA,gDAOC;AAvGD,2CAA6B;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,mDAA6D;AAC7D,+DAAqG;AAErG;;;GAGG;AACU,QAAA,yBAAyB,GAAmB,CAAC,GAAG,EAAE;IAC7D,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,sBAAsB;YACtB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACrC,2BAA2B;YAC3B,cAAc,EAAE,qBAAO;YACvB,kDAAkD;YAClD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;YACtB,wCAAwC;YACxC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,6BAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;SAC5C,CAAC;QACF,8DAA8D;QAC9D,KAAK,EAAE,6BAAe;QACtB,kCAAkC;QAClC,SAAS,EAAE,kCAAe;QAC1B,qCAAqC;QACrC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,6BAAe,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC,EAAE,CAAC;AASL,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,gDAA0C;AAE1C,mDAAsG;AAEtG,2EAA2E;AAC3E,MAAM,4BAA4B,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACzD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,MAAM,CAAC,iCAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAC1D,CAAC,MAAM,CAAC,CACT,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAWL;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,kBAAkB,CAChC,MAAsB,EACtB,MAAoC,EACpC,IAAgC;IAEhC,MAAM,MAAM,GAAG,IAAA,gBAAK,EAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAA,4BAAe,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;AAClF,CAAC"}

package/script/api/exchange/_methods/tokenDelegate.d.ts

@@ -0,0 +1,147 @@
+import * as v from "valibot";
+import { type ErrorResponse, type SuccessResponse } from "./_base/commonSchemas.js";
+/**
+ * Delegate or undelegate native tokens to or from a validator.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+ */
+export declare const TokenDelegateRequest: v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.LiteralSchema<"tokenDelegate", undefined>;
+        /** Chain ID in hex format for EIP-712 signing. */
+        readonly signatureChainId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>;
+        /** HyperLiquid network type. */
+        readonly hyperliquidChain: v.PicklistSchema<["Mainnet", "Testnet"], undefined>;
+        /** Validator address. */
+        readonly validator: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+        /** Amount for delegate/undelegate (float * 1e8). */
+        readonly wei: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+        /** `true` for undelegate, `false` for delegate. */
+        readonly isUndelegate: v.BooleanSchema<undefined>;
+        /** Nonce (timestamp in ms) used to prevent replay attacks. */
+        readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+    /** Nonce (timestamp in ms) used to prevent replay attacks. */
+    readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /** ECDSA signature components. */
+    readonly signature: v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>;
+        readonly v: v.PicklistSchema<[27, 28], undefined>;
+    }, undefined>;
+}, undefined>;
+export type TokenDelegateRequest = v.InferOutput<typeof TokenDelegateRequest>;
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+ */
+export type TokenDelegateResponse = SuccessResponse | ErrorResponse;
+import type { ExcludeErrorResponse } from "./_base/errors.js";
+import { type ExchangeConfig, type ExtractRequestOptions } from "./_base/execute.js";
+/** Schema for user-provided action parameters (excludes system fields). */
+declare const TokenDelegateParameters: Omit<v.ObjectSchema<{
+    /** Type of action. */
+    readonly type: v.LiteralSchema<"tokenDelegate", undefined>;
+    /** Chain ID in hex format for EIP-712 signing. */
+    readonly signatureChainId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>;
+    /** HyperLiquid network type. */
+    readonly hyperliquidChain: v.PicklistSchema<["Mainnet", "Testnet"], undefined>;
+    /** Validator address. */
+    readonly validator: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+    /** Amount for delegate/undelegate (float * 1e8). */
+    readonly wei: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+    /** `true` for undelegate, `false` for delegate. */
+    readonly isUndelegate: v.BooleanSchema<undefined>;
+    /** Nonce (timestamp in ms) used to prevent replay attacks. */
+    readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+}, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: Omit<{
+        /** Type of action. */
+        readonly type: v.LiteralSchema<"tokenDelegate", undefined>;
+        /** Chain ID in hex format for EIP-712 signing. */
+        readonly signatureChainId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>;
+        /** HyperLiquid network type. */
+        readonly hyperliquidChain: v.PicklistSchema<["Mainnet", "Testnet"], undefined>;
+        /** Validator address. */
+        readonly validator: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+        /** Amount for delegate/undelegate (float * 1e8). */
+        readonly wei: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>;
+        /** `true` for undelegate, `false` for delegate. */
+        readonly isUndelegate: v.BooleanSchema<undefined>;
+        /** Nonce (timestamp in ms) used to prevent replay attacks. */
+        readonly nonce: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.ToNumberAction<string | number, undefined>, v.NumberSchema<undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, "type" | "nonce" | "signatureChainId" | "hyperliquidChain">;
+    readonly "~standard": v.StandardProps<{
+        wei: string | number;
+        validator: string;
+        isUndelegate: boolean;
+    }, {
+        wei: number;
+        validator: `0x${string}`;
+        isUndelegate: boolean;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+        wei: number;
+        validator: `0x${string}`;
+        isUndelegate: boolean;
+    }, v.StringIssue | v.NumberIssue | v.UnionIssue<v.StringIssue | v.NumberIssue> | v.RegexIssue<string> | v.ToNumberIssue<string | number> | v.SafeIntegerIssue<number> | v.MinValueIssue<number, 0> | v.LengthIssue<`0x${string}`, 42> | v.ObjectIssue | v.BooleanIssue | v.MinValueIssue<number, 1>>;
+    readonly "~types"?: {
+        readonly input: {
+            wei: string | number;
+            validator: string;
+            isUndelegate: boolean;
+        };
+        readonly output: {
+            wei: number;
+            validator: `0x${string}`;
+            isUndelegate: boolean;
+        };
+        readonly issue: v.StringIssue | v.NumberIssue | v.UnionIssue<v.StringIssue | v.NumberIssue> | v.RegexIssue<string> | v.ToNumberIssue<string | number> | v.SafeIntegerIssue<number> | v.MinValueIssue<number, 0> | v.LengthIssue<`0x${string}`, 42> | v.ObjectIssue | v.BooleanIssue | v.MinValueIssue<number, 1>;
+    } | undefined;
+};
+/** Action parameters for the {@linkcode tokenDelegate} function. */
+export type TokenDelegateParameters = v.InferInput<typeof TokenDelegateParameters>;
+/** Request options for the {@linkcode tokenDelegate} function. */
+export type TokenDelegateOptions = ExtractRequestOptions<v.InferInput<typeof TokenDelegateRequest>>;
+/** Successful variant of {@linkcode TokenDelegateResponse} without errors. */
+export type TokenDelegateSuccessResponse = ExcludeErrorResponse<TokenDelegateResponse>;
+/** EIP-712 types for the {@linkcode tokenDelegate} function. */
+export declare const TokenDelegateTypes: {
+    "HyperliquidTransaction:TokenDelegate": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Delegate or undelegate native tokens to or from a validator.
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param params Parameters specific to the API request.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { tokenDelegate } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await tokenDelegate(
+ *   { transport, wallet },
+ *   { validator: "0x...", isUndelegate: true, wei: 1 * 1e8 },
+ * );
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+ */
+export declare function tokenDelegate(config: ExchangeConfig, params: TokenDelegateParameters, opts?: TokenDelegateOptions): Promise<TokenDelegateSuccessResponse>;
+export {};
+//# sourceMappingURL=tokenDelegate.d.ts.map

package/script/api/exchange/_methods/tokenDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenDelegate.d.ts","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/tokenDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAO7B,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAE7B,yBAAyB;;QAEvB,sBAAsB;;QAEtB,kDAAkD;;QAElD,gCAAgC;;QAEhC,yBAAyB;;QAEzB,oDAAoD;;QAEpD,mDAAmD;;QAEnD,8DAA8D;;;IAGhE,8DAA8D;;IAE9D,kCAAkC;;;;;;aAGlC,CAAC;AACL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,aAAa,CAAC;AAOpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAA2B,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE9G,2EAA2E;AAC3E,QAAA,MAAM,uBAAuB;IAtCvB,sBAAsB;;IAEtB,kDAAkD;;IAElD,gCAAgC;;IAEhC,yBAAyB;;IAEzB,oDAAoD;;IAEpD,mDAAmD;;IAEnD,8DAA8D;;;;QAZ9D,sBAAsB;;QAEtB,kDAAkD;;QAElD,gCAAgC;;QAEhC,yBAAyB;;QAEzB,oDAAoD;;QAEpD,mDAAmD;;QAEnD,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BhE,CAAC;AAEL,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEnF,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAEpG,8EAA8E;AAC9E,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AAEvF,gEAAgE;AAChE,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,uBAAuB,EAC/B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,4BAA4B,CAAC,CAQvC"}

package/script/api/exchange/_methods/tokenDelegate.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenDelegateTypes = exports.TokenDelegateRequest = void 0;
+exports.tokenDelegate = tokenDelegate;
+const v = __importStar(require("valibot"));
+// ============================================================
+// API Schemas
+// ============================================================
+const _schemas_js_1 = require("../../_schemas.js");
+const commonSchemas_js_1 = require("./_base/commonSchemas.js");
+/**
+ * Delegate or undelegate native tokens to or from a validator.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+ */
+exports.TokenDelegateRequest = (() => {
+    return v.object({
+        /** Action to perform. */
+        action: v.object({
+            /** Type of action. */
+            type: v.literal("tokenDelegate"),
+            /** Chain ID in hex format for EIP-712 signing. */
+            signatureChainId: _schemas_js_1.Hex,
+            /** HyperLiquid network type. */
+            hyperliquidChain: commonSchemas_js_1.HyperliquidChainSchema,
+            /** Validator address. */
+            validator: _schemas_js_1.Address,
+            /** Amount for delegate/undelegate (float * 1e8). */
+            wei: v.pipe(_schemas_js_1.UnsignedInteger, v.minValue(1)),
+            /** `true` for undelegate, `false` for delegate. */
+            isUndelegate: v.boolean(),
+            /** Nonce (timestamp in ms) used to prevent replay attacks. */
+            nonce: _schemas_js_1.UnsignedInteger,
+        }),
+        /** Nonce (timestamp in ms) used to prevent replay attacks. */
+        nonce: _schemas_js_1.UnsignedInteger,
+        /** ECDSA signature components. */
+        signature: commonSchemas_js_1.SignatureSchema,
+    });
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+const _base_js_1 = require("../../../_base.js");
+const execute_js_1 = require("./_base/execute.js");
+/** Schema for user-provided action parameters (excludes system fields). */
+const TokenDelegateParameters = /* @__PURE__ */ (() => {
+    return v.omit(v.object(exports.TokenDelegateRequest.entries.action.entries), ["type", "signatureChainId", "hyperliquidChain", "nonce"]);
+})();
+/** EIP-712 types for the {@linkcode tokenDelegate} function. */
+exports.TokenDelegateTypes = {
+    "HyperliquidTransaction:TokenDelegate": [
+        { name: "hyperliquidChain", type: "string" },
+        { name: "validator", type: "address" },
+        { name: "wei", type: "uint64" },
+        { name: "isUndelegate", type: "bool" },
+        { name: "nonce", type: "uint64" },
+    ],
+};
+/**
+ * Delegate or undelegate native tokens to or from a validator.
+ *
+ * @param config General configuration for Exchange API requests.
+ * @param params Parameters specific to the API request.
+ * @param opts Request execution options.
+ * @return Successful response without specific data.
+ *
+ * @throws {ValidationError} When the request parameters fail validation (before sending).
+ * @throws {TransportError} When the transport layer throws an error.
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { tokenDelegate } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await tokenDelegate(
+ *   { transport, wallet },
+ *   { validator: "0x...", isUndelegate: true, wei: 1 * 1e8 },
+ * );
+ * ```
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#delegate-or-undelegate-stake-from-validator
+ */
+function tokenDelegate(config, params, opts) {
+    const action = (0, _base_js_1.parse)(TokenDelegateParameters, params);
+    return (0, execute_js_1.executeUserSignedAction)(config, { type: "tokenDelegate", ...action }, exports.TokenDelegateTypes, opts);
+}
+//# sourceMappingURL=tokenDelegate.js.map

package/script/api/exchange/_methods/tokenDelegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenDelegate.js","sourceRoot":"","sources":["../../../../src/api/exchange/_methods/tokenDelegate.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoHA,sCAYC;AAhID,2CAA6B;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,mDAAkE;AAClE,+DAKkC;AAElC;;;GAGG;AACU,QAAA,oBAAoB,GAAmB,CAAC,GAAG,EAAE;IACxD,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,sBAAsB;YACtB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;YAChC,kDAAkD;YAClD,gBAAgB,EAAE,iBAAG;YACrB,gCAAgC;YAChC,gBAAgB,EAAE,yCAAsB;YACxC,yBAAyB;YACzB,SAAS,EAAE,qBAAO;YAClB,oDAAoD;YACpD,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,6BAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3C,mDAAmD;YACnD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;YACzB,8DAA8D;YAC9D,KAAK,EAAE,6BAAe;SACvB,CAAC;QACF,8DAA8D;QAC9D,KAAK,EAAE,6BAAe;QACtB,kCAAkC;QAClC,SAAS,EAAE,kCAAe;KAC3B,CAAC,CAAC;AACL,CAAC,CAAC,EAAE,CAAC;AASL,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,gDAA0C;AAE1C,mDAA8G;AAE9G,2EAA2E;AAC3E,MAAM,uBAAuB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACpD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,MAAM,CAAC,4BAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EACrD,CAAC,MAAM,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAC1D,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAWL,gEAAgE;AACnD,QAAA,kBAAkB,GAAG;IAChC,sCAAsC,EAAE;QACtC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5C,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;QACtC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE;QACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,aAAa,CAC3B,MAAsB,EACtB,MAA+B,EAC/B,IAA2B;IAE3B,MAAM,MAAM,GAAG,IAAA,gBAAK,EAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,IAAA,oCAAuB,EAC5B,MAAM,EACN,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,EACpC,0BAAkB,EAClB,IAAI,CACL,CAAC;AACJ,CAAC"}