@nktkas/hyperliquid 0.27.0 → 0.28.0

package/script/src/signing/mod.js

@@ -0,0 +1,363 @@
+"use strict";
+/**
+ * This module contains functions for generating Hyperliquid transaction signatures.
+ *
+ * @example Signing an L1 action
+ * ```ts
+ * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const signature = await signL1Action({ wallet, action, nonce });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ *
+ * @example Signing a user-signed action
+ * ```ts
+ * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { ApproveAgentRequest, ApproveAgentTypes } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(ApproveAgentRequest.entries.action, { // not required, but for correct generation
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
+ *
+ * const signature = await signUserSignedAction({ wallet, action, types: ApproveAgentTypes });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce: action.nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivateKeySigner = exports.getWalletChainId = exports.getWalletAddress = exports.AbstractWalletError = void 0;
+exports.createL1ActionHash = createL1ActionHash;
+exports.signL1Action = signL1Action;
+exports.signUserSignedAction = signUserSignedAction;
+exports.signMultiSigAction = signMultiSigAction;
+const sha3_js_1 = require("@noble/hashes/sha3.js");
+const utils_js_1 = require("@noble/hashes/utils.js");
+const mod_js_1 = require("../../deps/jsr.io/@std/msgpack/1.0.3/mod.js");
+const _abstractWallet_js_1 = require("./_abstractWallet.js");
+var _abstractWallet_js_2 = require("./_abstractWallet.js");
+Object.defineProperty(exports, "AbstractWalletError", { enumerable: true, get: function () { return _abstractWallet_js_2.AbstractWalletError; } });
+Object.defineProperty(exports, "getWalletAddress", { enumerable: true, get: function () { return _abstractWallet_js_2.getWalletAddress; } });
+Object.defineProperty(exports, "getWalletChainId", { enumerable: true, get: function () { return _abstractWallet_js_2.getWalletChainId; } });
+var _privateKeySigner_js_1 = require("./_privateKeySigner.js");
+Object.defineProperty(exports, "PrivateKeySigner", { enumerable: true, get: function () { return _privateKeySigner_js_1.PrivateKeySigner; } });
+/**
+ * Create a hash of the L1 action.
+ * @example
+ * ```ts
+ * import { createL1ActionHash } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const actionHash = createL1ActionHash({ action, nonce });
+ * ```
+ */
+function createL1ActionHash(args) {
+    const { action, nonce, vaultAddress, expiresAfter } = args;
+    // 1. Action
+    const actionBytes = (0, mod_js_1.encode)(largeIntToBigInt(removeUndefinedKeys(action)));
+    // 2. Nonce
+    const nonceBytes = toUint64Bytes(nonce);
+    // 3. Vault address
+    const vaultMarker = vaultAddress ? new Uint8Array([1]) : new Uint8Array([0]);
+    const vaultBytes = vaultAddress ? (0, utils_js_1.hexToBytes)(vaultAddress.slice(2)) : new Uint8Array();
+    // 4. Expires after
+    const expiresMarker = expiresAfter !== undefined ? new Uint8Array([0]) : new Uint8Array();
+    const expiresBytes = expiresAfter !== undefined ? toUint64Bytes(expiresAfter) : new Uint8Array();
+    // Create a hash
+    const bytes = (0, utils_js_1.concatBytes)(actionBytes, nonceBytes, vaultMarker, vaultBytes, expiresMarker, expiresBytes);
+    const hash = (0, sha3_js_1.keccak_256)(bytes);
+    return `0x${(0, utils_js_1.bytesToHex)(hash)}`;
+}
+function toUint64Bytes(n) {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setBigUint64(0, BigInt(n));
+    return bytes;
+}
+function largeIntToBigInt(obj) {
+    if (typeof obj === "number" && Number.isInteger(obj) && (obj >= 0x100000000 || obj < -0x80000000)) {
+        return BigInt(obj);
+    }
+    if (Array.isArray(obj))
+        return obj.map(largeIntToBigInt);
+    if (typeof obj === "object" && obj !== null) {
+        const result = {};
+        for (const k in obj)
+            result[k] = largeIntToBigInt(obj[k]);
+        return result;
+    }
+    return obj;
+}
+function removeUndefinedKeys(obj) {
+    if (Array.isArray(obj))
+        return obj.map(removeUndefinedKeys);
+    if (typeof obj === "object" && obj !== null) {
+        const result = {};
+        for (const k in obj) {
+            if (obj[k] !== undefined) {
+                result[k] = removeUndefinedKeys(obj[k]);
+            }
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Sign an L1 action.
+ * @example
+ * ```ts
+ * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * import { CancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(CancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "cancel",
+ *   cancels: [
+ *     { a: 0, o: 12345 },
+ *   ],
+ * });
+ * const nonce = Date.now();
+ *
+ * const signature = await signL1Action({ wallet, action, nonce });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+async function signL1Action(args) {
+    const { wallet, action, nonce, isTestnet = false, vaultAddress, expiresAfter } = args;
+    return await (0, _abstractWallet_js_1.signTypedData)({
+        wallet,
+        domain: {
+            name: "Exchange",
+            version: "1",
+            chainId: 1337, // hyperliquid requires chainId to be 1337
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
+        types: {
+            Agent: [
+                { name: "source", type: "string" },
+                { name: "connectionId", type: "bytes32" },
+            ],
+        },
+        primaryType: "Agent",
+        message: {
+            source: isTestnet ? "b" : "a",
+            connectionId: createL1ActionHash({ action, nonce, vaultAddress, expiresAfter }),
+        },
+    });
+}
+/**
+ * Sign a user-signed action.
+ * @example
+ * ```ts
+ * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { ApproveAgentRequest, ApproveAgentTypes } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ *
+ * const action = v.parse(ApproveAgentRequest.entries.action, { // not required, but for correct generation
+ *   type: "approveAgent",
+ *   signatureChainId: "0x66eee",
+ *   hyperliquidChain: "Mainnet",
+ *   agentAddress: "0x...",
+ *   agentName: "Agent",
+ *   nonce: Date.now(),
+ * });
+ *
+ * const signature = await signUserSignedAction({ wallet, action, types: ApproveAgentTypes });
+ *
+ * // Send the signed action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action, signature, nonce: action.nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+async function signUserSignedAction(args) {
+    let { wallet, action, types } = args;
+    const primaryType = Object.keys(types)[0];
+    // Special case: for `approveAgent`
+    // If `agentName` is null or undefined, set it to an empty string
+    if (action.type === "approveAgent" && !action.agentName) {
+        action = { ...action, agentName: "" };
+    }
+    // Special case: for multi-sign payload
+    // If the action contains `payloadMultiSigUser` and `outerSigner`, add them to the types
+    if ("payloadMultiSigUser" in action && "outerSigner" in action) {
+        const primaryTypeArray = types[primaryType];
+        types = {
+            ...types,
+            [primaryType]: [
+                primaryTypeArray[0], // after `hyperliquidChain`
+                { name: "payloadMultiSigUser", type: "address" },
+                { name: "outerSigner", type: "address" },
+                ...primaryTypeArray.slice(1),
+            ],
+        };
+    }
+    // Special case: for some wallets
+    // If the action has extra keys not in the types, filter them out
+    const knownKeys = new Set(types[primaryType].map((f) => f.name));
+    const message = Object.fromEntries(Object.entries(action).filter(([k]) => knownKeys.has(k)));
+    return await (0, _abstractWallet_js_1.signTypedData)({
+        wallet,
+        domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: parseInt(action.signatureChainId),
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
+        types,
+        primaryType,
+        message,
+    });
+}
+/**
+ * Sign a multi-signature action.
+ * @example
+ * ```ts
+ * import { signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { ScheduleCancelRequest } from "@nktkas/hyperliquid/api/exchange";
+ * import * as v from "npm:valibot";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = v.parse(ScheduleCancelRequest.entries.action, { // not required, but for correct generation
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000,
+ * });
+ *
+ * // Create the required number of signatures
+ * const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ *   return await signL1Action({
+ *     wallet: privateKeyToAccount(signerPrivKey as `0x${string}`), // viem or ethers
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
+ *     nonce,
+ *   });
+ * }));
+ *
+ * // // or user-signed action
+ * // const signatures = await Promise.all(["0x...", "0x..."].map(async (signerPrivKey) => {
+ * //   return await signUserSignedAction({
+ * //     wallet: privateKeyToAccount(signerPrivKey as `0x${string}`), // viem or ethers
+ * //     action: {
+ * //       ...action,
+ * //       payloadMultiSigUser: multiSigUser,
+ * //       outerSigner: wallet.address,
+ * //     },
+ * //     types: SomeTypes,
+ * //   });
+ * // }));
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigAction = {
+ *   type: "multiSig",
+ *   signatureChainId: "0x66eee" as const,
+ *   signatures,
+ *   payload: {
+ *     multiSigUser,
+ *     outerSigner: wallet.address,
+ *     action,
+ *   },
+ * };
+ * const multiSigSignature = await signMultiSigAction({ wallet, action: multiSigAction, nonce });
+ *
+ * // Send the multi-sig action to the Hyperliquid API
+ * const response = await fetch("https://api.hyperliquid.xyz/exchange", {
+ *   method: "POST",
+ *   headers: { "Content-Type": "application/json" },
+ *   body: JSON.stringify({ action: multiSigAction, signature: multiSigSignature, nonce }),
+ * });
+ * const body = await response.json();
+ * ```
+ */
+async function signMultiSigAction(args) {
+    let { wallet, action, nonce, isTestnet = false, vaultAddress, expiresAfter } = args;
+    if ("type" in action) {
+        const { type: _, ...actionWithoutType } = action;
+        action = actionWithoutType;
+    }
+    return await (0, _abstractWallet_js_1.signTypedData)({
+        wallet,
+        domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: parseInt(action.signatureChainId),
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
+        types: {
+            "HyperliquidTransaction:SendMultiSig": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "multiSigActionHash", type: "bytes32" },
+                { name: "nonce", type: "uint64" },
+            ],
+        },
+        primaryType: "HyperliquidTransaction:SendMultiSig",
+        message: {
+            hyperliquidChain: isTestnet ? "Testnet" : "Mainnet",
+            multiSigActionHash: createL1ActionHash({ action, nonce, vaultAddress, expiresAfter }),
+            nonce,
+        },
+    });
+}
+//# sourceMappingURL=mod.js.map

package/script/src/signing/mod.js.map

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

package/script/src/transport/_polyfills.d.ts

@@ -0,0 +1,16 @@
+export declare const Promise_: {
+    /** @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers */
+    withResolvers: <T>() => PromiseWithResolvers<T>;
+};
+export declare const AbortSignal_: {
+    /** @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/any_static */
+    any: (signals: AbortSignal[]) => AbortSignal;
+    /** @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static */
+    timeout: (ms: number) => AbortSignal;
+};
+/** @see https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent */
+export declare const CustomEvent_: {
+    new <T>(type: string, eventInitDict?: CustomEventInit<T>): CustomEvent<T>;
+    prototype: CustomEvent;
+};
+//# sourceMappingURL=_polyfills.d.ts.map

package/script/src/transport/_polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_polyfills.d.ts","sourceRoot":"","sources":["../../../src/src/transport/_polyfills.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ;IAEjB,kHAAkH;oBAC1E,CAAC;CAOzC,CAAC;AAEL,eAAO,MAAM,YAAY;IAErB,mFAAmF;mBAClD,WAAW,EAAE;IAgB9C,uFAAuF;kBACnD,MAAM;CAM1C,CAAC;AAEL,wEAAwE;AACxE,eAAO,MAAM,YAAY;;;CAQrB,CAAC"}

package/script/src/transport/_polyfills.js

@@ -0,0 +1,48 @@
+"use strict";
+// deno-lint-ignore-file no-explicit-any
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomEvent_ = exports.AbortSignal_ = exports.Promise_ = void 0;
+exports.Promise_ = (() => {
+    return {
+        /** @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers */
+        withResolvers: Promise.withResolvers ? () => Promise.withResolvers() : () => {
+            let resolve;
+            let reject;
+            const promise = new Promise((res, rej) => (resolve = res, reject = rej));
+            return { promise, resolve, reject };
+        },
+    };
+})();
+exports.AbortSignal_ = (() => {
+    return {
+        /** @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/any_static */
+        any: AbortSignal.any ? (signals) => AbortSignal.any(signals) : (signals) => {
+            const controller = new AbortController();
+            for (const signal of signals) {
+                if (signal.aborted) {
+                    controller.abort(signal.reason);
+                    break;
+                }
+                signal.addEventListener("abort", () => controller.abort(signal.reason), { once: true, signal: controller.signal });
+            }
+            return controller.signal;
+        },
+        /** @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static */
+        timeout: AbortSignal.timeout ? (ms) => AbortSignal.timeout(ms) : (ms) => {
+            const controller = new AbortController();
+            setTimeout(() => controller.abort(new DOMException("Signal timed out.", "TimeoutError")), ms);
+            return controller.signal;
+        },
+    };
+})();
+/** @see https://developer.mozilla.org/en-US/docs/Web/API/CustomEvent */
+exports.CustomEvent_ = (() => {
+    return globalThis.CustomEvent || class extends Event {
+        detail;
+        constructor(type, eventInitDict) {
+            super(type, eventInitDict);
+            this.detail = eventInitDict?.detail ?? null;
+        }
+    };
+})();
+//# sourceMappingURL=_polyfills.js.map

package/script/src/transport/_polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_polyfills.js","sourceRoot":"","sources":["../../../src/src/transport/_polyfills.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAE3B,QAAA,QAAQ,GAAmB,CAAC,GAAG,EAAE;IAC5C,OAAO;QACL,kHAAkH;QAClH,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAM,EAAE,CAAC,OAAO,CAAC,aAAa,EAAK,CAAC,CAAC,CAAC,GAAM,EAAE;YACnF,IAAI,OAA6C,CAAC;YAClD,IAAI,MAA+B,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;YAC5E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAEQ,QAAA,YAAY,GAAmB,CAAC,GAAG,EAAE;IAChD,OAAO;QACL,mFAAmF;QACnF,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAsB,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAsB,EAAE,EAAE;YACvG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAChC,MAAM;gBACR,CAAC;gBACD,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EACrC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC1C,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,uFAAuF;QACvF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAU,EAAE,EAAE;YACtF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9F,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAEL,wEAAwE;AAC3D,QAAA,YAAY,GAAmB,CAAC,GAAG,EAAE;IAChD,OAAO,UAAU,CAAC,WAAW,IAAI,KAAS,SAAQ,KAAK;QAC5C,MAAM,CAAW;QAC1B,YAAY,IAAY,EAAE,aAAkC;YAC1D,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,GAAG,aAAa,EAAE,MAAM,IAAI,IAAI,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC"}

package/script/src/transport/http/mod.d.ts

@@ -0,0 +1,87 @@
+import { TransportError } from "../../_errors.js";
+/** Error thrown when an HTTP request fails. */
+export declare class HttpRequestError extends TransportError {
+    /** The HTTP response that caused the error. */
+    response?: Response;
+    /** The response body text. */
+    body?: string;
+    /**
+     * Creates a new HTTP request error.
+     * @param args - The error arguments.
+     * @param args.response - The HTTP response that caused the error.
+     * @param args.body - The response body text.
+     * @param options - The error options.
+     */
+    constructor(args?: {
+        response?: Response;
+        body?: string;
+    }, options?: ErrorOptions);
+}
+/** Configuration options for the HTTP transport layer. */
+export interface HttpTransportOptions {
+    /**
+     * Indicates this transport uses testnet endpoint.
+     * @default false
+     */
+    isTestnet?: boolean;
+    /**
+     * Request timeout in ms. Set to `null` to disable.
+     * @default 10_000
+     */
+    timeout?: number | null;
+    /**
+     * Custom API URL for requests.
+     * @default `https://api.hyperliquid.xyz` for mainnet, `https://api.hyperliquid-testnet.xyz` for testnet.
+     */
+    apiUrl?: string | URL;
+    /**
+     * Custom RPC URL for explorer requests.
+     * @default `https://rpc.hyperliquid.xyz` for mainnet, `https://rpc.hyperliquid-testnet.xyz` for testnet.
+     */
+    rpcUrl?: string | URL;
+    /** A custom [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit) that is merged with a fetch request. */
+    fetchOptions?: Omit<RequestInit, "body" | "method">;
+}
+/** Mainnet API URL. */
+export declare const MAINNET_API_URL = "https://api.hyperliquid.xyz";
+/** Testnet API URL. */
+export declare const TESTNET_API_URL = "https://api.hyperliquid-testnet.xyz";
+/** Mainnet RPC URL. */
+export declare const MAINNET_RPC_URL = "https://rpc.hyperliquid.xyz";
+/** Testnet RPC URL. */
+export declare const TESTNET_RPC_URL = "https://rpc.hyperliquid-testnet.xyz";
+/**
+ * HTTP transport for Hyperliquid API.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint
+ */
+export declare class HttpTransport implements HttpTransportOptions {
+    isTestnet: boolean;
+    timeout: number | null;
+    apiUrl: string | URL;
+    rpcUrl: string | URL;
+    fetchOptions: Omit<RequestInit, "body" | "method">;
+    /**
+     * Creates a new HTTP transport instance.
+     * @param options - Configuration options for the HTTP transport layer.
+     */
+    constructor(options?: HttpTransportOptions);
+    /**
+     * Sends a request to the Hyperliquid API via [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+     *
+     * @param endpoint - The API endpoint to send the request to.
+     * @param payload - The payload to send with the request.
+     * @param signal - [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to cancel the request.
+     *
+     * @returns A promise that resolves with parsed JSON response body.
+     *
+     * @throws {HttpRequestError} Thrown when the HTTP request fails.
+     */
+    request<T>(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
+    /** Merges multiple `HeadersInit` into one [`Headers`](https://developer.mozilla.org/en-US/docs/Web/API/Headers/Headers). */
+    protected _mergeHeadersInit(...inits: HeadersInit[]): Headers;
+    /** Merges multiple [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit) into one [`RequestInit`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit). */
+    protected _mergeRequestInit(...inits: RequestInit[]): RequestInit;
+}
+//# sourceMappingURL=mod.d.ts.map

package/script/src/transport/http/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/transport/http/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,+CAA+C;AAC/C,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;gBACS,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,YAAY;CAgBlF;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEtB,kIAAkI;IAClI,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CACrD;AAED,uBAAuB;AACvB,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,uBAAuB;AACvB,eAAO,MAAM,eAAe,wCAAwC,CAAC;AACrE,uBAAuB;AACvB,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,uBAAuB;AACvB,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,oBAAoB;IACxD,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC;IACrB,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEnD;;;OAGG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAQ1C;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA6ChH,4HAA4H;IAC5H,SAAS,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO;IAW7D,4LAA4L;IAC5L,SAAS,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW;CAelE"}