@nktkas/hyperliquid 0.22.1 → 0.23.0

package/esm/src/signing/mod.d.ts

@@ -0,0 +1,272 @@
+/**
+ * This module contains functions for generating Hyperliquid transaction signatures
+ * and interfaces to various wallet implementations.
+ *
+ * @example Signing an L1 action
+ * ```ts
+ * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ *
+ * const signature = await signL1Action({
+ *     wallet: privateKey,
+ *     action: actionSorter[action.type](action),
+ *     nonce,
+ * });
+ * ```
+ *
+ * @example Signing a user-signed action
+ * ```ts
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const action = {
+ *     type: "approveAgent",
+ *     signatureChainId: "0x66eee",
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
+ *     agentName: "Agent",
+ *     nonce: Date.now(),
+ * } as const;
+ *
+ * const signature = await signUserSignedAction({
+ *     wallet: privateKey,
+ *     action,
+ *     types: userSignedActionEip712Types[action.type],
+ * });
+ * ```
+ *
+ * @example Signing a multi-signature action
+ * ```ts
+ * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "scheduleCancel",
+ *     time: Date.now() + 10000,
+ * } as const;
+ *
+ * // First, create the required number of signatures
+ * const signature = await signL1Action({
+ *     wallet,
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *     nonce,
+ * });
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigSignature = await signMultiSigAction({
+ *     wallet,
+ *     action: {
+ *         signatureChainId: "0x66eee",
+ *         signatures: [signature],
+ *         payload: {
+ *             multiSigUser,
+ *             outerSigner: wallet.address,
+ *             action,
+ *         },
+ *     },
+ *     nonce,
+ * });
+ * ```
+ *
+ * @module
+ */
+import type { Hex } from "../base.js";
+import { type AbstractEthersSigner, type AbstractEthersV5Signer, type AbstractViemWalletClient, type AbstractWallet, type AbstractWindowEthereum, isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, type Signature } from "./_signTypedData/mod.js";
+export { type AbstractEthersSigner, type AbstractEthersV5Signer, type AbstractViemWalletClient, type AbstractWallet, type AbstractWindowEthereum, type Hex, isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, type Signature, };
+export * from "./_sorter.js";
+/**
+ * Create a hash of the L1 action.
+ * @example
+ * ```ts
+ * import { actionSorter, createL1ActionHash } from "@nktkas/hyperliquid/signing";
+ *
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ * const nonce = Date.now();
+ *
+ * const actionHash = createL1ActionHash({
+ *     action: actionSorter[action.type](action),
+ *     nonce,
+ *     vaultAddress: "0x...", // optional
+ *     expiresAfter: Date.now() + 10_000, // optional
+ * });
+ * ```
+ */
+export declare function createL1ActionHash(args: {
+    /** The action to be hashed (hash depends on key order). */
+    action: Record<string, unknown> | unknown[];
+    /** The current timestamp in ms. */
+    nonce: number;
+    /** Optional vault address used in the action. */
+    vaultAddress?: Hex;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): Hex;
+/**
+ * Sign an L1 action.
+ * @example
+ * ```ts
+ * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ *
+ * const signature = await signL1Action({
+ *     wallet: privateKey,
+ *     action: actionSorter[action.type](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();
+ * ```
+ */
+export declare function signL1Action(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed (hash depends on key order). */
+    action: Record<string, unknown> | unknown[];
+    /** The current timestamp in ms. */
+    nonce: number;
+    /** Indicates if the action is for the testnet. (default: false) */
+    isTestnet?: boolean;
+    /** Optional vault address used in the action. */
+    vaultAddress?: Hex;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): Promise<Signature>;
+/**
+ * Sign a user-signed action.
+ * @example
+ * ```ts
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const action = {
+ *     type: "approveAgent",
+ *     signatureChainId: "0x66eee",
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
+ *     agentName: "Agent",
+ *     nonce: Date.now(),
+ * } as const;
+ *
+ * const signature = await signUserSignedAction({
+ *     wallet: privateKey,
+ *     action,
+ *     types: userSignedActionEip712Types[action.type],
+ * });
+ *
+ * // 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();
+ * ```
+ */
+export declare function signUserSignedAction(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed. */
+    action: {
+        signatureChainId: Hex;
+        [key: string]: unknown;
+    };
+    /** The types of the action (hash depends on key order). */
+    types: {
+        [key: string]: {
+            name: string;
+            type: string;
+        }[];
+    };
+}): Promise<Signature>;
+/**
+ * Sign a multi-signature action.
+ * @example
+ * ```ts
+ * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "scheduleCancel",
+ *     time: Date.now() + 10000,
+ * } as const;
+ *
+ * // First, create the required number of signatures
+ * const signature = await signL1Action({
+ *     wallet,
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *     nonce,
+ * });
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigSignature = await signMultiSigAction({
+ *     wallet,
+ *     action: {
+ *         signatureChainId: "0x66eee",
+ *         signatures: [signature],
+ *         payload: {
+ *             multiSigUser,
+ *             outerSigner: wallet.address,
+ *             action,
+ *         },
+ *     },
+ *     nonce,
+ * });
+ * ```
+ */
+export declare function signMultiSigAction(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed (hash depends on key order). */
+    action: {
+        signatureChainId: Hex;
+        [key: string]: unknown;
+    };
+    /** The current timestamp in ms. */
+    nonce: number;
+    /** Indicates if the action is for the testnet. (default: false) */
+    isTestnet?: boolean;
+    /** Optional vault address used in the action. */
+    vaultAddress?: Hex;
+    /** Optional expiration time of the action in ms since the epoch. */
+    expiresAfter?: number;
+}): Promise<Signature>;
+//# sourceMappingURL=mod.d.ts.map

package/esm/src/signing/mod.d.ts.map

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

package/esm/src/signing/mod.js

@@ -0,0 +1,306 @@
+/**
+ * This module contains functions for generating Hyperliquid transaction signatures
+ * and interfaces to various wallet implementations.
+ *
+ * @example Signing an L1 action
+ * ```ts
+ * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ *
+ * const signature = await signL1Action({
+ *     wallet: privateKey,
+ *     action: actionSorter[action.type](action),
+ *     nonce,
+ * });
+ * ```
+ *
+ * @example Signing a user-signed action
+ * ```ts
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const action = {
+ *     type: "approveAgent",
+ *     signatureChainId: "0x66eee",
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
+ *     agentName: "Agent",
+ *     nonce: Date.now(),
+ * } as const;
+ *
+ * const signature = await signUserSignedAction({
+ *     wallet: privateKey,
+ *     action,
+ *     types: userSignedActionEip712Types[action.type],
+ * });
+ * ```
+ *
+ * @example Signing a multi-signature action
+ * ```ts
+ * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "scheduleCancel",
+ *     time: Date.now() + 10000,
+ * } as const;
+ *
+ * // First, create the required number of signatures
+ * const signature = await signL1Action({
+ *     wallet,
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *     nonce,
+ * });
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigSignature = await signMultiSigAction({
+ *     wallet,
+ *     action: {
+ *         signatureChainId: "0x66eee",
+ *         signatures: [signature],
+ *         payload: {
+ *             multiSigUser,
+ *             outerSigner: wallet.address,
+ *             action,
+ *         },
+ *     },
+ *     nonce,
+ * });
+ * ```
+ *
+ * @module
+ */
+import { keccak_256 } from "@noble/hashes/sha3";
+import { etc } from "@noble/secp256k1";
+import { encode as encodeMsgpack } from "@msgpack/msgpack";
+import { isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, signTypedData, } from "./_signTypedData/mod.js";
+export { isAbstractEthersSigner, isAbstractEthersV5Signer, isAbstractViemWalletClient, isAbstractWindowEthereum, isValidPrivateKey, };
+export * from "./_sorter.js";
+/**
+ * Create a hash of the L1 action.
+ * @example
+ * ```ts
+ * import { actionSorter, createL1ActionHash } from "@nktkas/hyperliquid/signing";
+ *
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ * const nonce = Date.now();
+ *
+ * const actionHash = createL1ActionHash({
+ *     action: actionSorter[action.type](action),
+ *     nonce,
+ *     vaultAddress: "0x...", // optional
+ *     expiresAfter: Date.now() + 10_000, // optional
+ * });
+ * ```
+ */
+export function createL1ActionHash(args) {
+    const { action, nonce, vaultAddress, expiresAfter } = args;
+    // 1. Action
+    const actionBytes = encodeMsgpack(action);
+    // 2. Nonce
+    const nonceBytes = toUint64Bytes(nonce);
+    // 3. Vault address
+    const vaultMarker = vaultAddress ? new Uint8Array([1]) : new Uint8Array([0]);
+    const vaultBytes = vaultAddress ? etc.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 = etc.concatBytes(actionBytes, nonceBytes, vaultMarker, vaultBytes, expiresMarker, expiresBytes);
+    const hash = keccak_256(bytes);
+    return `0x${etc.bytesToHex(hash)}`;
+}
+function toUint64Bytes(n) {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setBigUint64(0, BigInt(n));
+    return bytes;
+}
+/**
+ * Sign an L1 action.
+ * @example
+ * ```ts
+ * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ *
+ * const signature = await signL1Action({
+ *     wallet: privateKey,
+ *     action: actionSorter[action.type](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();
+ * ```
+ */
+export async function signL1Action(args) {
+    const { wallet, action, nonce, isTestnet = false, vaultAddress, expiresAfter, } = args;
+    const actionHash = createL1ActionHash({ action, nonce, vaultAddress, expiresAfter });
+    const message = {
+        source: isTestnet ? "b" : "a",
+        connectionId: actionHash,
+    };
+    return await 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,
+    });
+}
+/**
+ * Sign a user-signed action.
+ * @example
+ * ```ts
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
+ *
+ * const action = {
+ *     type: "approveAgent",
+ *     signatureChainId: "0x66eee",
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
+ *     agentName: "Agent",
+ *     nonce: Date.now(),
+ * } as const;
+ *
+ * const signature = await signUserSignedAction({
+ *     wallet: privateKey,
+ *     action,
+ *     types: userSignedActionEip712Types[action.type],
+ * });
+ *
+ * // 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();
+ * ```
+ */
+export async function signUserSignedAction(args) {
+    const { wallet, action, types } = args;
+    return await signTypedData({
+        wallet,
+        domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: parseInt(action.signatureChainId),
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
+        types,
+        primaryType: Object.keys(types)[0],
+        message: action,
+    });
+}
+/**
+ * Sign a multi-signature action.
+ * @example
+ * ```ts
+ * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const multiSigUser = "0x...";
+ *
+ * const nonce = Date.now();
+ * const action = {
+ *     type: "scheduleCancel",
+ *     time: Date.now() + 10000,
+ * } as const;
+ *
+ * // First, create the required number of signatures
+ * const signature = await signL1Action({
+ *     wallet,
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *     nonce,
+ * });
+ *
+ * // Then use signatures in the multi-sig action
+ * const multiSigSignature = await signMultiSigAction({
+ *     wallet,
+ *     action: {
+ *         signatureChainId: "0x66eee",
+ *         signatures: [signature],
+ *         payload: {
+ *             multiSigUser,
+ *             outerSigner: wallet.address,
+ *             action,
+ *         },
+ *     },
+ *     nonce,
+ * });
+ * ```
+ */
+export async function signMultiSigAction(args) {
+    const { wallet, action, nonce, isTestnet = false, vaultAddress, expiresAfter, } = args;
+    const multiSigActionHash = createL1ActionHash({ action, nonce, vaultAddress, expiresAfter });
+    const message = {
+        signatureChainId: action.signatureChainId,
+        hyperliquidChain: isTestnet ? "Testnet" : "Mainnet",
+        multiSigActionHash,
+        nonce,
+    };
+    return await signTypedData({
+        wallet,
+        domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: parseInt(message.signatureChainId),
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
+        types: {
+            "HyperliquidTransaction:SendMultiSig": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "multiSigActionHash", type: "bytes32" },
+                { name: "nonce", type: "uint64" },
+            ],
+        },
+        primaryType: "HyperliquidTransaction:SendMultiSig",
+        message,
+    });
+}

package/esm/src/transports/base.d.ts

@@ -42,6 +42,6 @@ export interface Subscription {
 }
 /** Base class for all transport-related errors. */
 export declare class TransportError extends HyperliquidError {
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 //# sourceMappingURL=base.d.ts.map

package/esm/src/transports/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/src/transports/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC/D;;;;;;OAMG;IACH,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,CAAC;CAC9G;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,OAAO,CAAC,eAAe,CAAC;IACpE;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpH;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IACzB,kFAAkF;IAClF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACnC;AAED,mDAAmD;AACnD,qBAAa,cAAe,SAAQ,gBAAgB;gBACpC,OAAO,CAAC,EAAE,MAAM;CAI/B"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/src/transports/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC/D;;;;;;OAMG;IACH,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,CAAC;CAC9G;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,OAAO,CAAC,eAAe,CAAC;IACpE;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpH;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IACzB,kFAAkF;IAClF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACnC;AAED,mDAAmD;AACnD,qBAAa,cAAe,SAAQ,gBAAgB;gBACpC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIvD"}

package/esm/src/transports/base.js

@@ -1,8 +1,8 @@
 import { HyperliquidError } from "../base.js";
 /** Base class for all transport-related errors. */
 export class TransportError extends HyperliquidError {
-    constructor(message) {
-        super(message);
+    constructor(message, options) {
+        super(message, options);
         this.name = "TransportError";
     }
 }

package/esm/src/transports/http/http_transport.d.ts

@@ -1,19 +1,13 @@
 import type { MaybePromise } from "../../base.js";
 import { type IRequestTransport, TransportError } from "../base.js";
-/**
- * Error thrown when an HTTP response is deemed invalid:
- * - Non-200 status code
- * - Unexpected content type
- */
+/** Error thrown when an HTTP request fails. */
 export declare class HttpRequestError extends TransportError {
-    response: Response;
-    responseBody?: string | undefined;
-    /**
-     * Creates a new HTTP request error.
-     * @param response - The failed HTTP response.
-     * @param responseBody - The raw response body content, if available.
-     */
-    constructor(response: Response, responseBody?: string | undefined);
+    response?: Response;
+    body?: string;
+    constructor(args?: {
+        response?: Response;
+        body?: string;
+    }, options?: ErrorOptions);
 }
 /** Configuration options for the HTTP transport layer. */
 export interface HttpTransportOptions {
@@ -84,8 +78,8 @@ export declare class HttpTransport implements IRequestTransport, HttpTransportOp
      * @param payload - The payload to send with the request.
      * @param signal - An optional abort signal.
      * @returns A promise that resolves with parsed JSON response body.
-     * @throws {HttpRequestError} - Thrown when an HTTP response is deemed invalid.
-     * @throws May throw {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/fetch#exceptions | fetch errors}.
+     *
+     * @throws {HttpRequestError} Thrown when the HTTP request fails.
      */
     request<T>(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
 }

package/esm/src/transports/http/http_transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/http/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAM7B,QAAQ,EAAE,QAAQ;IAAS,YAAY,CAAC,EAAE,MAAM;IALnE;;;;OAIG;gBACgB,QAAQ,EAAE,QAAQ,EAAS,YAAY,CAAC,EAAE,MAAM,YAAA;CAOtE;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QACrD,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACxD,CAAC;IAEF,2IAA2I;IAC3I,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAElF;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzF;AAED,2DAA2D;AAC3D,qBAAa,aAAc,YAAW,iBAAiB,EAAE,oBAAoB;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE;QACJ,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAClD,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACrD,CAAC;IACF,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtF;;;OAGG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAkB1C;;;;;;;;OAQG;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;CAuDnH"}
+{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/http/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,+CAA+C;AAC/C,qBAAa,gBAAiB,SAAQ,cAAc;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEF,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,YAAY;CAgBpF;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QACrD,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACxD,CAAC;IAEF,2IAA2I;IAC3I,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IAEpD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAElF;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzF;AAED,2DAA2D;AAC3D,qBAAa,aAAc,YAAW,iBAAiB,EAAE,oBAAoB;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE;QACJ,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAClD,OAAO,EAAE;YAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;KACrD,CAAC;IACF,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAEtF;;;OAGG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAkB1C;;;;;;;;OAQG;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;CA4DnH"}