@nktkas/hyperliquid 0.25.0-beta.3 → 0.25.0

package/esm/src/api/exchange/approveAgent.d.ts

@@ -0,0 +1,104 @@
+import { type DeepImmutable } from "../_common.js";
+import { type ExchangeRequestConfig, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_common.js";
+import * as v from "valibot";
+/**
+ * Approve an agent to sign on behalf of the master account.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
+ */
+export declare const ApproveAgentRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"approveAgent", undefined>, v.DescriptionAction<"approveAgent", "Type of action.">]>;
+        /** Chain ID used for signing. */
+        readonly signatureChainId: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Chain ID used for signing.">]>;
+        /** HyperLiquid network. */
+        readonly hyperliquidChain: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"Mainnet", undefined>, v.LiteralSchema<"Testnet", undefined>], undefined>, v.DescriptionAction<"Testnet" | "Mainnet", "HyperLiquid network.">]>;
+        /** Agent address. */
+        readonly agentAddress: 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}`, "Agent address.">]>;
+        /** Agent name or null for unnamed agent (default: null). */
+        readonly agentName: v.SchemaWithPipe<readonly [v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>, v.DescriptionAction<string | null, "Agent name or null for unnamed agent.">]>;
+        /** Unique request identifier (current timestamp in ms). */
+        readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "approveAgent";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        agentAddress: `0x${string}`;
+        agentName: string | null;
+        nonce: number;
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>]>, v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>]>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "approveAgent";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        agentAddress: `0x${string}`;
+        agentName: string | null;
+        nonce: number;
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+}, "Approve an agent to sign on behalf of the master account.">]>;
+export type ApproveAgentRequest = v.InferOutput<typeof ApproveAgentRequest>;
+import { SuccessResponse } from "./_common.js";
+export { SuccessResponse };
+/** Action parameters for the {@linkcode approveAgent} function. */
+export type ApproveAgentParameters = ExtractRequestAction<v.InferInput<typeof ApproveAgentRequest>>;
+/** Request options for the {@linkcode approveAgent} function. */
+export type ApproveAgentOptions = ExtractRequestOptions<v.InferInput<typeof ApproveAgentRequest>>;
+/** EIP-712 types for the {@linkcode approveAgent} function. */
+export declare const ApproveAgentTypes: {
+    "HyperliquidTransaction:ApproveAgent": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Approve an agent to sign on behalf of the master account.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { approveAgent } 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 approveAgent(
+ *   { transport, wallet },
+ *   { agentAddress: "0x...", agentName: "..." },
+ * );
+ * ```
+ */
+export declare function approveAgent(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<ApproveAgentParameters>, opts?: ApproveAgentOptions): Promise<SuccessResponse>;
+//# sourceMappingURL=approveAgent.d.ts.map

package/esm/src/api/exchange/approveAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approveAgent.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/approveAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,aAAa,EAAgC,MAAM,eAAe,CAAC;AAC1F,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAG1B,KAAK,sBAAsB,EAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAI7B;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAG1B,yBAAyB;;QAGrB,sBAAsB;;QAKtB,iCAAiC;;QAKjC,2BAA2B;;QAK3B,qBAAqB;;QAKrB,4DAA4D;;QAK5D,2DAA2D;;;;;;;;;;IAQ/D,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEAQjC,CAAC;AACL,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,CAAC;AAI3B,mEAAmE;AACnE,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AACpG,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAElG,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB;;;;;CAO7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,sBAAsB,CAAC,EAC7C,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/esm/src/api/exchange/approveAgent.js

@@ -0,0 +1,79 @@
+import { Address, Hex, parser, UnsignedInteger } from "../_common.js";
+import { executeUserSignedAction, getNonce, getSignatureChainId, Signature, } from "./_common.js";
+import * as v from "valibot";
+// -------------------- Schemas --------------------
+/**
+ * Approve an agent to sign on behalf of the master account.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
+ */
+export const ApproveAgentRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("approveAgent"), v.description("Type of action.")),
+            /** Chain ID used for signing. */
+            signatureChainId: v.pipe(Hex, v.description("Chain ID used for signing.")),
+            /** HyperLiquid network. */
+            hyperliquidChain: v.pipe(v.union([v.literal("Mainnet"), v.literal("Testnet")]), v.description("HyperLiquid network.")),
+            /** Agent address. */
+            agentAddress: v.pipe(Address, v.description("Agent address.")),
+            /** Agent name or null for unnamed agent (default: null). */
+            agentName: v.pipe(v.optional(v.nullable(v.string()), null), v.description("Agent name or null for unnamed agent.")),
+            /** Unique request identifier (current timestamp in ms). */
+            nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        }), v.description("Action to perform.")),
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(Signature, v.description("Cryptographic signature.")),
+    }), v.description("Approve an agent to sign on behalf of the master account."));
+})();
+import { SuccessResponse } from "./_common.js";
+export { SuccessResponse };
+/** EIP-712 types for the {@linkcode approveAgent} function. */
+export const ApproveAgentTypes = {
+    "HyperliquidTransaction:ApproveAgent": [
+        { name: "hyperliquidChain", type: "string" },
+        { name: "agentAddress", type: "address" },
+        { name: "agentName", type: "string" },
+        { name: "nonce", type: "uint64" },
+    ],
+};
+/**
+ * Approve an agent to sign on behalf of the master account.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-an-api-wallet
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { approveAgent } 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 approveAgent(
+ *   { transport, wallet },
+ *   { agentAddress: "0x...", agentName: "..." },
+ * );
+ * ```
+ */
+export async function approveAgent(config, params, opts) {
+    const action = parser(ApproveAgentRequest.entries.action)({
+        type: "approveAgent",
+        hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
+        signatureChainId: await getSignatureChainId(config),
+        nonce: await getNonce(config),
+        ...params,
+    });
+    return await executeUserSignedAction(config, { action, types: ApproveAgentTypes }, opts?.signal);
+}
+//# sourceMappingURL=approveAgent.js.map

package/esm/src/api/exchange/approveAgent.js.map

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

package/esm/src/api/exchange/approveBuilderFee.d.ts

@@ -0,0 +1,104 @@
+import { type DeepImmutable } from "../_common.js";
+import { type ExchangeRequestConfig, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_common.js";
+import * as v from "valibot";
+/**
+ * Approve a maximum fee rate for a builder.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ */
+export declare const ApproveBuilderFeeRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"approveBuilderFee", undefined>, v.DescriptionAction<"approveBuilderFee", "Type of action.">]>;
+        /** Chain ID used for signing. */
+        readonly signatureChainId: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Chain ID used for signing.">]>;
+        /** HyperLiquid network. */
+        readonly hyperliquidChain: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"Mainnet", undefined>, v.LiteralSchema<"Testnet", undefined>], undefined>, v.DescriptionAction<"Testnet" | "Mainnet", "HyperLiquid network.">]>;
+        /** Max fee rate (e.g., "0.01%"). */
+        readonly maxFeeRate: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `${string}%`>]>, v.DescriptionAction<`${string}%`, "Max fee rate (e.g., \"0.01%\").">]>;
+        /** Builder address. */
+        readonly builder: 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}`, "Builder address.">]>;
+        /** Unique request identifier (current timestamp in ms). */
+        readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "approveBuilderFee";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        maxFeeRate: `${string}%`;
+        builder: `0x${string}`;
+        nonce: number;
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>]>, v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>]>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "approveBuilderFee";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        maxFeeRate: `${string}%`;
+        builder: `0x${string}`;
+        nonce: number;
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+}, "Approve a maximum fee rate for a builder.">]>;
+export type ApproveBuilderFeeRequest = v.InferOutput<typeof ApproveBuilderFeeRequest>;
+import { SuccessResponse } from "./_common.js";
+export { SuccessResponse };
+/** Action parameters for the {@linkcode approveBuilderFee} function. */
+export type ApproveBuilderFeeParameters = ExtractRequestAction<v.InferInput<typeof ApproveBuilderFeeRequest>>;
+/** Request options for the {@linkcode approveBuilderFee} function. */
+export type ApproveBuilderFeeOptions = ExtractRequestOptions<v.InferInput<typeof ApproveBuilderFeeRequest>>;
+/** EIP-712 types for the {@linkcode approveBuilderFee} function. */
+export declare const ApproveBuilderFeeTypes: {
+    "HyperliquidTransaction:ApproveBuilderFee": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Approve a maximum fee rate for a builder.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { approveBuilderFee } 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 approveBuilderFee(
+ *   { transport, wallet },
+ *   { maxFeeRate: "0.01%", builder: "0x..." },
+ * );
+ * ```
+ */
+export declare function approveBuilderFee(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<ApproveBuilderFeeParameters>, opts?: ApproveBuilderFeeOptions): Promise<SuccessResponse>;
+//# sourceMappingURL=approveBuilderFee.d.ts.map

package/esm/src/api/exchange/approveBuilderFee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approveBuilderFee.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/approveBuilderFee.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,aAAa,EAAyC,MAAM,eAAe,CAAC;AACnG,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAG1B,KAAK,sBAAsB,EAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAI7B;;;GAGG;AACH,eAAO,MAAM,wBAAwB;IAG/B,yBAAyB;;QAGrB,sBAAsB;;QAKtB,iCAAiC;;QAKjC,2BAA2B;;QAK3B,oCAAoC;;QAKpC,uBAAuB;;QAKvB,2DAA2D;;;;;;;;;;IAQ/D,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAQjC,CAAC;AACL,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,CAAC;AAI3B,wEAAwE;AACxE,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AAC9G,sEAAsE;AACtE,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC;AAE5G,oEAAoE;AACpE,eAAO,MAAM,sBAAsB;;;;;CAOlC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,2BAA2B,CAAC,EAClD,IAAI,CAAC,EAAE,wBAAwB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/esm/src/api/exchange/approveBuilderFee.js

@@ -0,0 +1,79 @@
+import { Address, Hex, parser, Percent, UnsignedInteger } from "../_common.js";
+import { executeUserSignedAction, getNonce, getSignatureChainId, Signature, } from "./_common.js";
+import * as v from "valibot";
+// -------------------- Schemas --------------------
+/**
+ * Approve a maximum fee rate for a builder.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ */
+export const ApproveBuilderFeeRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("approveBuilderFee"), v.description("Type of action.")),
+            /** Chain ID used for signing. */
+            signatureChainId: v.pipe(Hex, v.description("Chain ID used for signing.")),
+            /** HyperLiquid network. */
+            hyperliquidChain: v.pipe(v.union([v.literal("Mainnet"), v.literal("Testnet")]), v.description("HyperLiquid network.")),
+            /** Max fee rate (e.g., "0.01%"). */
+            maxFeeRate: v.pipe(Percent, v.description('Max fee rate (e.g., "0.01%").')),
+            /** Builder address. */
+            builder: v.pipe(Address, v.description("Builder address.")),
+            /** Unique request identifier (current timestamp in ms). */
+            nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        }), v.description("Action to perform.")),
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(Signature, v.description("Cryptographic signature.")),
+    }), v.description("Approve a maximum fee rate for a builder."));
+})();
+import { SuccessResponse } from "./_common.js";
+export { SuccessResponse };
+/** EIP-712 types for the {@linkcode approveBuilderFee} function. */
+export const ApproveBuilderFeeTypes = {
+    "HyperliquidTransaction:ApproveBuilderFee": [
+        { name: "hyperliquidChain", type: "string" },
+        { name: "maxFeeRate", type: "string" },
+        { name: "builder", type: "address" },
+        { name: "nonce", type: "uint64" },
+    ],
+};
+/**
+ * Approve a maximum fee rate for a builder.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { approveBuilderFee } 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 approveBuilderFee(
+ *   { transport, wallet },
+ *   { maxFeeRate: "0.01%", builder: "0x..." },
+ * );
+ * ```
+ */
+export async function approveBuilderFee(config, params, opts) {
+    const action = parser(ApproveBuilderFeeRequest.entries.action)({
+        type: "approveBuilderFee",
+        hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
+        signatureChainId: await getSignatureChainId(config),
+        nonce: await getNonce(config),
+        ...params,
+    });
+    return await executeUserSignedAction(config, { action, types: ApproveBuilderFeeTypes }, opts?.signal);
+}
+//# sourceMappingURL=approveBuilderFee.js.map

package/esm/src/api/exchange/approveBuilderFee.js.map

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

package/esm/src/api/exchange/batchModify.d.ts

@@ -0,0 +1,241 @@
+import { type DeepImmutable } from "../_common.js";
+import { type ExchangeRequestConfig, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_common.js";
+import * as v from "valibot";
+/**
+ * Modify multiple orders.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+ */
+export declare const BatchModifyRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"batchModify", undefined>, v.DescriptionAction<"batchModify", "Type of action.">]>;
+        /** Order modifications. */
+        readonly modifies: v.SchemaWithPipe<readonly [v.ArraySchema<v.ObjectSchema<{
+            /** Order ID or Client Order ID. */
+            readonly oid: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 34, undefined>]>], undefined>, v.DescriptionAction<number | `0x${string}`, "Order ID or Client Order ID.">]>;
+            /** New order parameters. */
+            readonly order: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                /** Asset ID. */
+                readonly a: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Asset ID.">]>;
+                /** Position side (`true` for long, `false` for short). */
+                readonly b: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Position side (`true` for long, `false` for short).">]>;
+                /** Price. */
+                readonly p: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Price.">]>;
+                /** Size (in base currency units). */
+                readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Size (in base currency units).">]>;
+                /** Is reduce-only? */
+                readonly r: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Is reduce-only?">]>;
+                /** Order type. */
+                readonly t: v.SchemaWithPipe<readonly [v.UnionSchema<[v.ObjectSchema<{
+                    /** Limit order parameters. */
+                    readonly limit: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                        /**
+                         * Time-in-force.
+                         * - `"Gtc"`: Remains active until filled or canceled.
+                         * - `"Ioc"`: Fills immediately or cancels any unfilled portion.
+                         * - `"Alo"`: Adds liquidity only.
+                         * - `"FrontendMarket"`: Similar to Ioc, used in Hyperliquid UI.
+                         * - `"LiquidationMarket"`: Similar to Ioc, used in Hyperliquid UI.
+                         */
+                        readonly tif: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"Gtc", undefined>, v.LiteralSchema<"Ioc", undefined>, v.LiteralSchema<"Alo", undefined>, v.LiteralSchema<"FrontendMarket", undefined>, v.LiteralSchema<"LiquidationMarket", undefined>], undefined>, v.DescriptionAction<"Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket", string>]>;
+                    }, undefined>, v.DescriptionAction<{
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    }, "Limit order parameters.">]>;
+                }, undefined>, v.ObjectSchema<{
+                    /** Trigger order parameters. */
+                    readonly trigger: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                        /** Is market order? */
+                        readonly isMarket: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Is market order?">]>;
+                        /** Trigger price. */
+                        readonly triggerPx: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>, v.DescriptionAction<string, "Trigger price.">]>;
+                        /** Indicates whether it is take profit or stop loss. */
+                        readonly tpsl: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"tp", undefined>, v.LiteralSchema<"sl", undefined>], undefined>, v.DescriptionAction<"tp" | "sl", "Indicates whether it is take profit or stop loss.">]>;
+                    }, undefined>, v.DescriptionAction<{
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    }, "Trigger order parameters.">]>;
+                }, undefined>], undefined>, v.DescriptionAction<{
+                    limit: {
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    };
+                } | {
+                    trigger: {
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    };
+                }, "Order type.">]>;
+                /** Client Order ID. */
+                readonly c: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 34, undefined>]>, undefined>, v.DescriptionAction<`0x${string}` | undefined, "Client Order ID.">]>;
+            }, undefined>, v.DescriptionAction<{
+                a: number;
+                b: boolean;
+                p: string;
+                s: string;
+                r: boolean;
+                t: {
+                    limit: {
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    };
+                } | {
+                    trigger: {
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    };
+                };
+                c?: `0x${string}` | undefined;
+            }, "New order parameters.">]>;
+        }, undefined>, undefined>, v.DescriptionAction<{
+            oid: number | `0x${string}`;
+            order: {
+                a: number;
+                b: boolean;
+                p: string;
+                s: string;
+                r: boolean;
+                t: {
+                    limit: {
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    };
+                } | {
+                    trigger: {
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    };
+                };
+                c?: `0x${string}` | undefined;
+            };
+        }[], "Order modifications.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "batchModify";
+        modifies: {
+            oid: number | `0x${string}`;
+            order: {
+                a: number;
+                b: boolean;
+                p: string;
+                s: string;
+                r: boolean;
+                t: {
+                    limit: {
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    };
+                } | {
+                    trigger: {
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    };
+                };
+                c?: `0x${string}` | undefined;
+            };
+        }[];
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>]>, v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>]>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+    /** Vault address (for vault trading). */
+    readonly vaultAddress: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, undefined>, v.DescriptionAction<`0x${string}` | undefined, "Vault address (for vault trading).">]>;
+    /** Expiration time of the action. */
+    readonly expiresAfter: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, v.DescriptionAction<number | undefined, "Expiration time of the action.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "batchModify";
+        modifies: {
+            oid: number | `0x${string}`;
+            order: {
+                a: number;
+                b: boolean;
+                p: string;
+                s: string;
+                r: boolean;
+                t: {
+                    limit: {
+                        tif: "Gtc" | "Ioc" | "Alo" | "FrontendMarket" | "LiquidationMarket";
+                    };
+                } | {
+                    trigger: {
+                        isMarket: boolean;
+                        triggerPx: string;
+                        tpsl: "tp" | "sl";
+                    };
+                };
+                c?: `0x${string}` | undefined;
+            };
+        }[];
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+    vaultAddress?: `0x${string}` | undefined;
+    expiresAfter?: number | undefined;
+}, "Modify multiple orders.">]>;
+export type BatchModifyRequest = v.InferOutput<typeof BatchModifyRequest>;
+import { OrderSuccessResponse } from "./order.js";
+export { OrderSuccessResponse };
+/** Action parameters for the {@linkcode batchModify} function. */
+export type BatchModifyParameters = ExtractRequestAction<v.InferInput<typeof BatchModifyRequest>>;
+/** Request options for the {@linkcode batchModify} function. */
+export type BatchModifyOptions = ExtractRequestOptions<v.InferInput<typeof BatchModifyRequest>>;
+/**
+ * Modify multiple orders.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful variant of {@link OrderResponse} without error statuses.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { batchModify } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * const data = await batchModify(
+ *   { transport, wallet },
+ *   {
+ *     modifies: [
+ *       {
+ *         oid: 123,
+ *         order: {
+ *           a: 0,
+ *           b: true,
+ *           p: "31000",
+ *           s: "0.2",
+ *           r: false,
+ *           t: { limit: { tif: "Gtc" } },
+ *         },
+ *       },
+ *     ],
+ *   },
+ * );
+ * ```
+ */
+export declare function batchModify(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<BatchModifyParameters>, opts?: BatchModifyOptions): Promise<OrderSuccessResponse>;
+//# sourceMappingURL=batchModify.d.ts.map