@nktkas/hyperliquid 0.22.2 → 0.23.0

package/esm/src/signing/mod.js

@@ -2,152 +2,162 @@
  * This module contains functions for generating Hyperliquid transaction signatures
  * and interfaces to various wallet implementations.
  *
- * @example
+ * @example Signing an L1 action
  * ```ts
- * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * import { actionSorter, signL1Action } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
  *
- * const action = {
- *   type: "cancel",
- *   cancels: [{ a: 0, o: 12345 }],
- * };
  * const nonce = Date.now();
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
  *
  * const signature = await signL1Action({
- *   wallet,
- *   action,
- *   nonce,
- *   isTestnet: true, // Change to false for mainnet
+ *     wallet: privateKey,
+ *     action: actionSorter[action.type](action),
+ *     nonce,
  * });
  * ```
- * @example
+ *
+ * @example Signing a user-signed action
  * ```ts
- * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
+ *
+ * const privateKey = "0x..."; // or `viem`, `ethers`
  *
  * const action = {
- *   type: "approveAgent",
- *   hyperliquidChain: "Testnet", // "Mainnet" or "Testnet"
- *   signatureChainId: "0x66eee",
- *   nonce: Date.now(),
- *   agentAddress: "0x...",
- *   agentName: "Agent",
- * };
+ *     type: "approveAgent",
+ *     signatureChainId: "0x66eee",
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
+ *     agentName: "Agent",
+ *     nonce: Date.now(),
+ * } as const;
  *
  * const signature = await signUserSignedAction({
- *   wallet,
- *   action,
- *   types: {
- *     "HyperliquidTransaction:ApproveAgent": [
- *       { name: "hyperliquidChain", type: "string" },
- *       { name: "agentAddress", type: "address" },
- *       { name: "agentName", type: "string" },
- *       { name: "nonce", type: "uint64" },
- *     ],
- *   },
- *   chainId: parseInt(action.signatureChainId, 16),
+ *     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 { encode as encodeMsgpack } from "../../deps/jsr.io/@std/msgpack/1.0.3/encode.js";
-import { decodeHex, encodeHex } from "../../deps/jsr.io/@std/encoding/1.0.10/hex.js";
-import { concat as concatBytes } from "../../deps/jsr.io/@std/bytes/1.0.6/concat.js";
-import { isAbstractEthersSigner, isAbstractEthersV5Signer, } from "./_ethers.js";
-import { isValidPrivateKey, signTypedDataWithPrivateKey } from "./_private_key.js";
-import { isAbstractViemWalletClient } from "./_viem.js";
-import { isAbstractWindowEthereum, signTypedDataWithWindowEthereum } from "./_window.js";
+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";
  *
- * Note: Hash generation depends on the order of the action keys.
+ * const action = {
+ *     type: "cancel",
+ *     cancels: [
+ *         { a: 0, o: 12345 },
+ *     ],
+ * } as const;
+ * const nonce = Date.now();
  *
- * @param action - The action to be hashed.
- * @param nonce - Unique request identifier (recommended current timestamp in ms).
- * @param vaultAddress - Optional vault address used in the action.
- * @param expiresAfter - Optional expiration time of the action in milliseconds since the epoch.
- * @returns The hash of the action.
+ * const actionHash = createL1ActionHash({
+ *     action: actionSorter[action.type](action),
+ *     nonce,
+ *     vaultAddress: "0x...", // optional
+ *     expiresAfter: Date.now() + 10_000, // optional
+ * });
+ * ```
  */
-export function createL1ActionHash(action, nonce, vaultAddress, expiresAfter) {
+export function createL1ActionHash(args) {
+    const { action, nonce, vaultAddress, expiresAfter } = args;
     // 1. Action
-    const actionBytes = encodeMsgpack(normalizeIntegersForMsgPack(action));
+    const actionBytes = encodeMsgpack(action);
     // 2. Nonce
-    const nonceBytes = new Uint8Array(8);
-    new DataView(nonceBytes.buffer).setBigUint64(0, BigInt(nonce));
+    const nonceBytes = toUint64Bytes(nonce);
     // 3. Vault address
-    const vaultMarker = vaultAddress ? Uint8Array.of(1) : Uint8Array.of(0);
-    const vaultBytes = vaultAddress ? decodeHex(vaultAddress.slice(2)) : new Uint8Array();
+    const vaultMarker = vaultAddress ? new Uint8Array([1]) : new Uint8Array([0]);
+    const vaultBytes = vaultAddress ? etc.hexToBytes(vaultAddress.slice(2)) : new Uint8Array();
     // 4. Expires after
-    let expiresMarker;
-    let expiresBytes;
-    if (expiresAfter !== undefined) {
-        expiresMarker = Uint8Array.of(0);
-        expiresBytes = new Uint8Array(8);
-        new DataView(expiresBytes.buffer).setBigUint64(0, BigInt(expiresAfter));
-    }
-    else {
-        expiresMarker = new Uint8Array();
-        expiresBytes = new Uint8Array();
-    }
-    // Create a keccak256 hash
-    const bytes = concatBytes([
-        actionBytes,
-        nonceBytes,
-        vaultMarker,
-        vaultBytes,
-        expiresMarker,
-        expiresBytes,
-    ]);
+    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${encodeHex(hash)}`;
+    return `0x${etc.bytesToHex(hash)}`;
 }
-/** Layer to make {@link https://jsr.io/@std/msgpack | @std/msgpack} compatible with {@link https://github.com/msgpack/msgpack-javascript | @msgpack/msgpack}. */
-function normalizeIntegersForMsgPack(obj) {
-    const THIRTY_ONE_BITS = 2147483648;
-    const THIRTY_TWO_BITS = 4294967296;
-    if (typeof obj === "number" && Number.isInteger(obj) &&
-        obj <= Number.MAX_SAFE_INTEGER && obj >= Number.MIN_SAFE_INTEGER &&
-        (obj >= THIRTY_TWO_BITS || obj < -THIRTY_ONE_BITS)) {
-        return BigInt(obj);
-    }
-    if (Array.isArray(obj)) {
-        return obj.map(normalizeIntegersForMsgPack);
-    }
-    if (obj && typeof obj === "object" && obj !== null) {
-        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, normalizeIntegersForMsgPack(value)]));
-    }
-    return obj;
+function toUint64Bytes(n) {
+    const bytes = new Uint8Array(8);
+    new DataView(bytes.buffer).setBigUint64(0, BigInt(n));
+    return bytes;
 }
 /**
  * Sign an L1 action.
- *
- * Note: Signature generation depends on the order of the action keys.
- * @param args - Arguments for signing the action.
- * @returns The signature components r, s, and v.
  * @example
  * ```ts
- * import { signL1Action } from "@nktkas/hyperliquid/signing";
+ * 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 }, // Asset index and order ID
+ *         { a: 0, o: 12345 },
  *     ],
- * };
- * const nonce = Date.now();
+ * } as const;
  *
  * const signature = await signL1Action({
  *     wallet: privateKey,
- *     action,
+ *     action: actionSorter[action.type](action),
  *     nonce,
- *     isTestnet: true, // Change to false for mainnet
  * });
  *
- * const response = await fetch("https://api.hyperliquid-testnet.xyz/exchange", {
+ * // 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 }),
@@ -157,63 +167,54 @@ function normalizeIntegersForMsgPack(obj) {
  */
 export async function signL1Action(args) {
     const { wallet, action, nonce, isTestnet = false, vaultAddress, expiresAfter, } = args;
-    const domain = {
-        name: "Exchange",
-        version: "1",
-        chainId: 1337, // hyperliquid requires a fixed chain
-        verifyingContract: "0x0000000000000000000000000000000000000000",
-    };
-    const types = {
-        Agent: [
-            { name: "source", type: "string" },
-            { name: "connectionId", type: "bytes32" },
-        ],
-    };
-    const actionHash = createL1ActionHash(action, nonce, vaultAddress, expiresAfter);
+    const actionHash = createL1ActionHash({ action, nonce, vaultAddress, expiresAfter });
     const message = {
         source: isTestnet ? "b" : "a",
         connectionId: actionHash,
     };
-    const signature = await abstractSignTypedData({ wallet, domain, types, message });
-    return splitSignature(signature);
+    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.
- *
- * Note: Signature generation depends on the order of types.
- *
- * @param args - Arguments for signing the action.
- * @returns The signature components r, s, and v.
  * @example
  * ```ts
- * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
+ * import { signUserSignedAction, userSignedActionEip712Types } from "@nktkas/hyperliquid/signing";
  *
  * const privateKey = "0x..."; // or `viem`, `ethers`
  *
  * const action = {
  *     type: "approveAgent",
- *     hyperliquidChain: "Testnet", // "Mainnet" or "Testnet"
  *     signatureChainId: "0x66eee",
- *     nonce: Date.now(),
- *     agentAddress: "0x...", // Change to your agent address
+ *     hyperliquidChain: "Mainnet",
+ *     agentAddress: "0x...",
  *     agentName: "Agent",
- * };
+ *     nonce: Date.now(),
+ * } as const;
  *
  * const signature = await signUserSignedAction({
  *     wallet: privateKey,
  *     action,
- *     types: {
- *         "HyperliquidTransaction:ApproveAgent": [
- *             { name: "hyperliquidChain", type: "string" },
- *             { name: "agentAddress", type: "address" },
- *             { name: "agentName", type: "string" },
- *             { name: "nonce", type: "uint64" },
- *         ],
- *     },
- *     chainId: parseInt(action.signatureChainId, 16),
+ *     types: userSignedActionEip712Types[action.type],
  * });
  *
- * const response = await fetch("https://api.hyperliquid-testnet.xyz/exchange", {
+ * // 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 }),
@@ -222,76 +223,76 @@ export async function signL1Action(args) {
  * ```
  */
 export async function signUserSignedAction(args) {
-    const { wallet, action, types, chainId } = args;
-    const domain = {
-        name: "HyperliquidSignTransaction",
-        version: "1",
-        chainId,
-        verifyingContract: "0x0000000000000000000000000000000000000000",
-    };
-    const signature = await abstractSignTypedData({ wallet, domain, types, message: action });
-    return splitSignature(signature);
+    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.
- *
- * Note: Signature generation depends on the order of the action keys.
- *
- * @param args - Arguments for signing the action.
- * @returns The signature components r, s, and v.
  * @example
  * ```ts
- * import { signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
+ * import { actionSorter, signL1Action, signMultiSigAction } from "@nktkas/hyperliquid/signing";
  * import { privateKeyToAccount } from "viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x...");
- * const multiSigUser = "0x..."; // Multi-sig user address
+ * const wallet = privateKeyToAccount("0x..."); // or `ethers`, private key with address
+ * const multiSigUser = "0x...";
  *
  * const nonce = Date.now();
- * const action = { // Example action
- *   type: "scheduleCancel",
- *   time: Date.now() + 10000
- * };
+ * const action = {
+ *     type: "scheduleCancel",
+ *     time: Date.now() + 10000,
+ * } as const;
  *
- * // First, create signature from one of the authorized signers
+ * // First, create the required number of signatures
  * const signature = await signL1Action({
- *   wallet,
- *   action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
- *   nonce,
- *   isTestnet: true,
+ *     wallet,
+ *     action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), actionSorter[action.type](action)],
+ *     nonce,
  * });
  *
- * // Then use it in the multi-sig action
+ * // Then use signatures in the multi-sig action
  * const multiSigSignature = await signMultiSigAction({
- *   wallet,
- *   action: {
- *     type: "multiSig",
- *     signatureChainId: "0x66eee",
- *     signatures: [signature],
- *     payload: {
- *       multiSigUser,
- *       outerSigner: wallet.address,
- *       action,
- *     }
- *   },
- *   nonce,
- *   hyperliquidChain: "Testnet",
- *   signatureChainId: "0x66eee",
+ *     wallet,
+ *     action: {
+ *         signatureChainId: "0x66eee",
+ *         signatures: [signature],
+ *         payload: {
+ *             multiSigUser,
+ *             outerSigner: wallet.address,
+ *             action,
+ *         },
+ *     },
+ *     nonce,
  * });
  * ```
  */
 export async function signMultiSigAction(args) {
-    const { wallet, action, nonce, hyperliquidChain, signatureChainId, vaultAddress, expiresAfter, } = args;
-    const multiSigActionHash = createL1ActionHash(action, nonce, vaultAddress, expiresAfter);
+    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,
-        hyperliquidChain,
-        signatureChainId,
         nonce,
     };
-    return await signUserSignedAction({
+    return await signTypedData({
         wallet,
-        action: message,
+        domain: {
+            name: "HyperliquidSignTransaction",
+            version: "1",
+            chainId: parseInt(message.signatureChainId),
+            verifyingContract: "0x0000000000000000000000000000000000000000",
+        },
         types: {
             "HyperliquidTransaction:SendMultiSig": [
                 { name: "hyperliquidChain", type: "string" },
@@ -299,54 +300,7 @@ export async function signMultiSigAction(args) {
                 { name: "nonce", type: "uint64" },
             ],
         },
-        chainId: parseInt(signatureChainId, 16),
+        primaryType: "HyperliquidTransaction:SendMultiSig",
+        message,
     });
 }
-/** Signs typed data with the provided wallet using EIP-712. */
-async function abstractSignTypedData(args) {
-    const { wallet, domain, types, message } = args;
-    if (isValidPrivateKey(wallet)) {
-        return await signTypedDataWithPrivateKey({
-            privateKey: wallet,
-            domain,
-            types,
-            primaryType: Object.keys(types)[0],
-            message,
-        });
-    }
-    else if (isAbstractViemWalletClient(wallet)) {
-        return await wallet.signTypedData({
-            domain,
-            types: {
-                EIP712Domain: [
-                    { name: "name", type: "string" },
-                    { name: "version", type: "string" },
-                    { name: "chainId", type: "uint256" },
-                    { name: "verifyingContract", type: "address" },
-                ],
-                ...types,
-            },
-            primaryType: Object.keys(types)[0],
-            message,
-        });
-    }
-    else if (isAbstractEthersSigner(wallet)) {
-        return await wallet.signTypedData(domain, types, message);
-    }
-    else if (isAbstractEthersV5Signer(wallet)) {
-        return await wallet._signTypedData(domain, types, message);
-    }
-    else if (isAbstractWindowEthereum(wallet)) {
-        return await signTypedDataWithWindowEthereum(wallet, domain, types, message);
-    }
-    else {
-        throw new Error("Unsupported wallet for signing typed data");
-    }
-}
-/** Splits a signature hexadecimal string into its components. */
-function splitSignature(signature) {
-    const r = `0x${signature.slice(2, 66)}`;
-    const s = `0x${signature.slice(66, 130)}`;
-    const v = parseInt(signature.slice(130, 132), 16);
-    return { r, s, v };
-}

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"}