@nktkas/hyperliquid 0.26.0 → 0.27.1

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

@@ -0,0 +1,136 @@
+"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.ApproveBuilderFeeTypes = exports.ApproveBuilderFeeResponse = exports.ApproveBuilderFeeRequest = void 0;
+exports.approveBuilderFee = approveBuilderFee;
+const v = __importStar(require("valibot"));
+// ============================================================
+// API Schemas
+// ============================================================
+const _base_js_1 = require("../_base.js");
+const mod_js_1 = require("./_base/mod.js");
+/**
+ * Approve a maximum fee rate for a builder.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ */
+exports.ApproveBuilderFeeRequest = (() => {
+    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(_base_js_1.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(_base_js_1.Percent, v.description('Max fee rate (e.g., "0.01%").')),
+            /** Builder address. */
+            builder: v.pipe(_base_js_1.Address, v.description("Builder address.")),
+            /** Unique request identifier (current timestamp in ms). */
+            nonce: v.pipe(_base_js_1.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(_base_js_1.UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(mod_js_1.Signature, v.description("Cryptographic signature.")),
+    }), v.description("Approve a maximum fee rate for a builder."));
+})();
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#approve-a-builder-fee
+ */
+exports.ApproveBuilderFeeResponse = (() => {
+    return v.pipe(v.union([mod_js_1.SuccessResponse, mod_js_1.ErrorResponse]), v.description("Successful response without specific data or error response."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+const _base_js_2 = require("../_base.js");
+const mod_js_2 = require("./_base/mod.js");
+/** EIP-712 types for the {@linkcode approveBuilderFee} function. */
+exports.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..." },
+ * );
+ * ```
+ */
+async function approveBuilderFee(config, params, opts) {
+    const request = (0, _base_js_2.parser)(exports.ApproveBuilderFeeRequest)({
+        action: {
+            type: "approveBuilderFee",
+            hyperliquidChain: config.transport.isTestnet ? "Testnet" : "Mainnet",
+            signatureChainId: await (0, mod_js_2.getSignatureChainId)(config),
+            nonce: 0, // Placeholder; actual nonce generated in `executeUserSignedAction` to prevent race conditions
+            ...params,
+        },
+        nonce: 0, // Placeholder; actual nonce generated in `executeUserSignedAction` to prevent race conditions
+        signature: {
+            r: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            s: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            v: 27,
+        },
+    });
+    return await (0, mod_js_2.executeUserSignedAction)(config, request, exports.ApproveBuilderFeeTypes, opts?.signal);
+}
+//# sourceMappingURL=approveBuilderFee.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approveBuilderFee.js","sourceRoot":"","sources":["../../../../src/src/api/exchange/approveBuilderFee.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4IA,8CAqBC;AAjKD,2CAA6B;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,0CAAqE;AACrE,2CAA2E;AAE3E;;;GAGG;AACU,QAAA,wBAAwB,GAAmB,CAAC,GAAG,EAAE;IAC5D,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,MAAM,CAAC;QACP,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,sBAAsB;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CACV,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAC9B,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CACjC;YACD,iCAAiC;YACjC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CACtB,cAAG,EACH,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAC5C;YACD,2BAA2B;YAC3B,gBAAgB,EAAE,CAAC,CAAC,IAAI,CACtB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EACrD,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CACtC;YACD,oCAAoC;YACpC,UAAU,EAAE,CAAC,CAAC,IAAI,CAChB,kBAAO,EACP,CAAC,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAC/C;YACD,uBAAuB;YACvB,OAAO,EAAE,CAAC,CAAC,IAAI,CACb,kBAAO,EACP,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAClC;YACD,2DAA2D;YAC3D,KAAK,EAAE,CAAC,CAAC,IAAI,CACX,0BAAe,EACf,CAAC,CAAC,WAAW,CAAC,sDAAsD,CAAC,CACtE;SACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CACpC;QACD,2DAA2D;QAC3D,KAAK,EAAE,CAAC,CAAC,IAAI,CACX,0BAAe,EACf,CAAC,CAAC,WAAW,CAAC,sDAAsD,CAAC,CACtE;QACD,+BAA+B;QAC/B,SAAS,EAAE,CAAC,CAAC,IAAI,CACf,kBAAS,EACT,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAC1C;KACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAC3D,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL;;;GAGG;AACU,QAAA,yBAAyB,GAAmB,CAAC,GAAG,EAAE;IAC7D,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,KAAK,CAAC,CAAC,wBAAe,EAAE,sBAAa,CAAC,CAAC,EACzC,CAAC,CAAC,WAAW,CAAC,8DAA8D,CAAC,CAC9E,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,0CAAyD;AACzD,2CAQwB;AAWxB,oEAAoE;AACvD,QAAA,sBAAsB,GAAG;IACpC,0CAA0C,EAAE;QAC1C,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5C,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAsD,EACtD,MAAkD,EAClD,IAA+B;IAE/B,MAAM,OAAO,GAAG,IAAA,iBAAM,EAAC,gCAAwB,CAAC,CAAC;QAC/C,MAAM,EAAE;YACN,IAAI,EAAE,mBAAmB;YACzB,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACpE,gBAAgB,EAAE,MAAM,IAAA,4BAAmB,EAAC,MAAM,CAAC;YACnD,KAAK,EAAE,CAAC,EAAE,8FAA8F;YACxG,GAAG,MAAM;SACV;QACD,KAAK,EAAE,CAAC,EAAE,8FAA8F;QACxG,SAAS,EAAE;YACT,CAAC,EAAE,oEAAoE;YACvE,CAAC,EAAE,oEAAoE;YACvE,CAAC,EAAE,EAAE;SACN;KACF,CAAC,CAAC;IACH,OAAO,MAAM,IAAA,gCAAuB,EAAC,MAAM,EAAE,OAAO,EAAE,8BAAsB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9F,CAAC"}

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

@@ -0,0 +1,329 @@
+import * as v from "valibot";
+import { OrderResponse } from "./order.js";
+/**
+ * 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.NumberSchema<undefined>, v.IntegerAction<number, undefined>, 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<{
+                readonly a: 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, "Asset ID.">]>;
+                readonly b: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Position side (`true` for long, `false` for short).">]>;
+                readonly p: 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, "Price.">]>;
+                readonly s: 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, "Size (in base currency units).">]>;
+                readonly r: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Is reduce-only?">]>;
+                readonly t: v.SchemaWithPipe<readonly [v.UnionSchema<[v.ObjectSchema<{
+                    readonly limit: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                        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<{
+                    readonly trigger: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                        readonly isMarket: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "Is market order?">]>;
+                        readonly triggerPx: 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, "Trigger price.">]>;
+                        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.">]>;
+                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;
+            }, "Place 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.NumberSchema<undefined>, v.IntegerAction<number, undefined>, 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.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.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [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.NumberSchema<undefined>, v.IntegerAction<number, undefined>, 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>;
+/**
+ * Response for order placement and batch modifications.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+ */
+export declare const BatchModifyResponse: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"ok", undefined>, v.DescriptionAction<"ok", "Successful status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"order", undefined>, v.DescriptionAction<"order", "Type of response.">]>;
+        readonly data: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+            readonly statuses: v.SchemaWithPipe<readonly [v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+                readonly resting: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                    readonly oid: 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, "Order ID.">]>;
+                    readonly cloid: 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<{
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                }, "Resting order status.">]>;
+            }, undefined>, v.ObjectSchema<{
+                readonly filled: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+                    readonly totalSz: 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 size filled.">]>;
+                    readonly avgPx: 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, "Average price of fill.">]>;
+                    readonly oid: 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, "Order ID.">]>;
+                    readonly cloid: 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<{
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                }, "Filled order status.">]>;
+            }, undefined>, v.ObjectSchema<{
+                readonly error: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Error message.">]>;
+            }, undefined>], undefined>, undefined>, v.DescriptionAction<({
+                resting: {
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                error: string;
+            })[], "Array of statuses or error messages.">]>;
+        }, undefined>, v.DescriptionAction<{
+            statuses: ({
+                resting: {
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                error: string;
+            })[];
+        }, "Specific data.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "order";
+        data: {
+            statuses: ({
+                resting: {
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                error: string;
+            })[];
+        };
+    }, "Response details.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "ok";
+    response: {
+        type: "order";
+        data: {
+            statuses: ({
+                resting: {
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                    cloid?: `0x${string}` | undefined;
+                };
+            } | {
+                error: string;
+            })[];
+        };
+    };
+}, "Response for order placement and batch modifications.">]>;
+export type BatchModifyResponse = OrderResponse;
+import { type DeepImmutable } from "../_base.js";
+import { type ExchangeRequestConfig, type ExcludeErrorResponse, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_base/mod.js";
+/** 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>>;
+/** Successful variant of {@linkcode BatchModifyResponse} without errors. */
+export type BatchModifySuccessResponse = ExcludeErrorResponse<BatchModifyResponse>;
+/**
+ * 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<BatchModifySuccessResponse>;
+//# sourceMappingURL=batchModify.d.ts.map

package/script/src/api/exchange/batchModify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchModify.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/batchModify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAS7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAGzB,yBAAyB;;QAGrB,sBAAsB;;QAKtB,2BAA2B;;YAGvB,mCAAmC;;YAQnC,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQpC,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;IAK/B,yCAAyC;;IAKzC,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAQvC,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAAgB,CAAC;AACjD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAMhD,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAExB,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAElG,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAEhG,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC5C,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}

package/script/src/api/exchange/batchModify.js

@@ -0,0 +1,146 @@
+"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.BatchModifyResponse = exports.BatchModifyRequest = void 0;
+exports.batchModify = batchModify;
+const v = __importStar(require("valibot"));
+// ============================================================
+// API Schemas
+// ============================================================
+const _base_js_1 = require("../_base.js");
+const mod_js_1 = require("./_base/mod.js");
+const _common_schemas_js_1 = require("../_common_schemas.js");
+const order_js_1 = require("./order.js");
+/**
+ * Modify multiple orders.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+ */
+exports.BatchModifyRequest = (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("batchModify"), v.description("Type of action.")),
+            /** Order modifications. */
+            modifies: v.pipe(v.array(v.object({
+                /** Order ID or Client Order ID. */
+                oid: v.pipe(v.union([
+                    _base_js_1.UnsignedInteger,
+                    v.pipe(_base_js_1.Hex, v.length(34)),
+                ]), v.description("Order ID or Client Order ID.")),
+                /** New order parameters. */
+                order: _common_schemas_js_1.PlaceOrderParamsSchema,
+            })), v.description("Order modifications.")),
+        }), v.description("Action to perform.")),
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: v.pipe(_base_js_1.UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(mod_js_1.Signature, v.description("Cryptographic signature.")),
+        /** Vault address (for vault trading). */
+        vaultAddress: v.pipe(v.optional(_base_js_1.Address), v.description("Vault address (for vault trading).")),
+        /** Expiration time of the action. */
+        expiresAfter: v.pipe(v.optional(_base_js_1.UnsignedInteger), v.description("Expiration time of the action.")),
+    }), v.description("Modify multiple orders."));
+})();
+/**
+ * Response for order placement and batch modifications.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders
+ */
+exports.BatchModifyResponse = order_js_1.OrderResponse;
+// ============================================================
+// Execution Logic
+// ============================================================
+const _base_js_2 = require("../_base.js");
+const mod_js_2 = require("./_base/mod.js");
+/**
+ * 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" } },
+ *         },
+ *       },
+ *     ],
+ *   },
+ * );
+ * ```
+ */
+async function batchModify(config, params, opts) {
+    const request = (0, _base_js_2.parser)(exports.BatchModifyRequest)({
+        action: {
+            type: "batchModify",
+            ...params,
+        },
+        nonce: 0, // Placeholder; actual nonce generated in `executeL1Action`
+        signature: {
+            r: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            s: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            v: 27,
+        },
+        vaultAddress: opts?.vaultAddress ?? config.defaultVaultAddress,
+        expiresAfter: typeof config.defaultExpiresAfter === "number"
+            ? config.defaultExpiresAfter
+            : await config.defaultExpiresAfter?.(),
+    });
+    return await (0, mod_js_2.executeL1Action)(config, request, opts?.signal);
+}
+//# sourceMappingURL=batchModify.js.map

package/script/src/api/exchange/batchModify.js.map

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