@nktkas/hyperliquid 0.19.1 → 0.20.0

package/esm/src/signing.d.ts

@@ -1,6 +1,7 @@
 /**
  * This module contains functions for generating Hyperliquid transaction signatures
  * and interfaces to various wallet implementations.
+ *
  * @example
  * ```ts
  * import { signL1Action } from "@nktkas/hyperliquid/signing";
@@ -45,12 +46,16 @@
  *   chainId: parseInt(action.signatureChainId, 16),
  * });
  * ```
+ *
  * @module
  */
+import "../_dnt.polyfills.js";
 import { type ValueMap, type ValueType } from "../deps/jsr.io/@std/msgpack/1.0.3/encode.js";
 import type { Hex } from "./base.js";
 export type { Hex };
 export type { ValueMap, ValueType };
+/** Abstract interface for a wallet that can sign typed data. */
+export type AbstractWallet = AbstractViemWalletClient | AbstractEthersSigner | AbstractEthersV5Signer | AbstractExtendedViemWalletClient | AbstractWindowEthereum;
 /** Abstract interface for a [viem wallet](https://viem.sh/docs/clients/wallet). */
 export interface AbstractViemWalletClient {
     signTypedData(params: {
@@ -98,7 +103,7 @@ export interface AbstractEthersV5Signer {
         }[];
     }, value: Record<string, unknown>): Promise<string>;
 }
-/** Abstract interface for an extended [viem wallet](https://viem.sh/docs/clients/wallet) (e.g. privy [useSignTypedData](https://docs.privy.io/reference/sdk/react-auth/functions/useSignTypedData#returns)). */
+/** Abstract interface for an extended [viem wallet](https://viem.sh/docs/clients/wallet) (e.g. privy [useSignTypedData](https://docs.privy.io/wallets/using-wallets/ethereum/sign-typed-data)). */
 export interface AbstractExtendedViemWalletClient {
     signTypedData(params: {
         domain: {
@@ -146,7 +151,7 @@ export declare function createL1ActionHash(action: ValueType, nonce: number, vau
  * import { signL1Action } from "@nktkas/hyperliquid/signing";
  * import { privateKeyToAccount } from "viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // Change to your private key
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
  *
  * const action = {
  *     type: "cancel",
@@ -173,7 +178,7 @@ export declare function createL1ActionHash(action: ValueType, nonce: number, vau
  */
 export declare function signL1Action(args: {
     /** Wallet to sign the action. */
-    wallet: AbstractViemWalletClient | AbstractEthersSigner | AbstractEthersV5Signer | AbstractExtendedViemWalletClient | AbstractWindowEthereum;
+    wallet: AbstractWallet;
     /** The action to be signed. */
     action: ValueType;
     /** Unique request identifier (recommended current timestamp in ms). */
@@ -193,6 +198,7 @@ export declare function signL1Action(args: {
  * 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
@@ -200,7 +206,7 @@ export declare function signL1Action(args: {
  * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
  * import { privateKeyToAccount } from "viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // Change to your private key
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
  *
  * const action = {
  *     type: "approveAgent",
@@ -235,7 +241,7 @@ export declare function signL1Action(args: {
  */
 export declare function signUserSignedAction(args: {
     /** Wallet to sign the action. */
-    wallet: AbstractViemWalletClient | AbstractEthersSigner | AbstractEthersV5Signer | AbstractExtendedViemWalletClient | AbstractWindowEthereum;
+    wallet: AbstractWallet;
     /** The action to be signed. */
     action: Record<string, unknown>;
     /** The types of the action. */
@@ -252,6 +258,75 @@ export declare function signUserSignedAction(args: {
     s: Hex;
     v: number;
 }>;
+/**
+ * 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 { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
+ * const multiSigUser = "0x..."; // Multi-sig user address
+ *
+ * const nonce = Date.now();
+ * const action = { // Example action
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000
+ * };
+ *
+ * // First, create signature from one of the authorized signers
+ * const signature = await signL1Action({
+ *   wallet,
+ *   action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
+ *   nonce,
+ *   isTestnet: true,
+ * });
+ *
+ * // Then use it 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",
+ * });
+ * ```
+ * @unstable May not behave as expected and the interface may change in the future.
+ */
+export declare function signMultiSigAction(args: {
+    /** Wallet to sign the action. */
+    wallet: AbstractWallet;
+    /** The action to be signed. */
+    action: ValueMap;
+    /** Unique request identifier (recommended current timestamp in ms). */
+    nonce: number;
+    /** Optional vault address used in the action. */
+    vaultAddress?: Hex;
+    /** Optional expiration time of the action in milliseconds since the epoch. */
+    expiresAfter?: number;
+    /** HyperLiquid network ("Mainnet" or "Testnet"). */
+    hyperliquidChain: "Mainnet" | "Testnet";
+    /** Chain ID used for signing. */
+    signatureChainId: Hex;
+}): Promise<{
+    r: Hex;
+    s: Hex;
+    v: number;
+}>;
 /** Checks if the given value is an abstract viem wallet. */
 export declare function isAbstractViemWalletClient(client: unknown): client is AbstractViemWalletClient;
 /** Checks if the given value is an abstract ethers signer. */

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

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

package/esm/src/signing.js

@@ -1,6 +1,7 @@
 /**
  * This module contains functions for generating Hyperliquid transaction signatures
  * and interfaces to various wallet implementations.
+ *
  * @example
  * ```ts
  * import { signL1Action } from "@nktkas/hyperliquid/signing";
@@ -45,9 +46,11 @@
  *   chainId: parseInt(action.signatureChainId, 16),
  * });
  * ```
+ *
  * @module
  */
-import { keccak_256 } from "../deps/jsr.io/@noble/hashes/1.8.0/src/sha3.js";
+import "../_dnt.polyfills.js";
+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 } from "../deps/jsr.io/@std/bytes/1.0.6/concat.js";
@@ -68,14 +71,28 @@ export function createL1ActionHash(action, nonce, vaultAddress, expiresAfter) {
     const nonceBytes = new Uint8Array(8);
     new DataView(nonceBytes.buffer).setBigUint64(0, BigInt(nonce));
     // 3. Vault address
-    const vaultMarker = Uint8Array.of(vaultAddress ? 0x01 : 0x00);
-    const vaultBytes = vaultAddress ? decodeHex(vaultAddress.slice(2)) : new Uint8Array();
+    let vaultMarker;
+    let vaultBytes;
+    if (vaultAddress) {
+        vaultMarker = Uint8Array.of(1);
+        vaultBytes = decodeHex(vaultAddress.slice(2));
+    }
+    else {
+        vaultMarker = new Uint8Array(1);
+        vaultBytes = new Uint8Array();
+    }
     // 4. Expires after
-    const expiresMarker = new Uint8Array(expiresAfter !== undefined ? 1 : 0);
-    const expiresBytes = new Uint8Array(expiresAfter !== undefined ? 8 : 0);
+    let expiresMarker;
+    let expiresBytes;
     if (expiresAfter !== undefined) {
+        expiresMarker = new Uint8Array(1);
+        expiresBytes = new Uint8Array(8);
         new DataView(expiresBytes.buffer).setBigUint64(0, BigInt(expiresAfter));
     }
+    else {
+        expiresMarker = new Uint8Array();
+        expiresBytes = new Uint8Array();
+    }
     // Create a keccak256 hash
     const chunks = [
         actionBytes,
@@ -117,7 +134,7 @@ function normalizeIntegersForMsgPack(obj) {
  * import { signL1Action } from "@nktkas/hyperliquid/signing";
  * import { privateKeyToAccount } from "viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // Change to your private key
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
  *
  * const action = {
  *     type: "cancel",
@@ -168,6 +185,7 @@ export async function signL1Action(args) {
  * 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
@@ -175,7 +193,7 @@ export async function signL1Action(args) {
  * import { signUserSignedAction } from "@nktkas/hyperliquid/signing";
  * import { privateKeyToAccount } from "viem/accounts";
  *
- * const wallet = privateKeyToAccount("0x..."); // Change to your private key
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
  *
  * const action = {
  *     type: "approveAgent",
@@ -219,6 +237,77 @@ export async function signUserSignedAction(args) {
     const signature = await abstractSignTypedData({ wallet, domain, types, message: action });
     return splitSignature(signature);
 }
+/**
+ * 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 { privateKeyToAccount } from "viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // Your private key
+ * const multiSigUser = "0x..."; // Multi-sig user address
+ *
+ * const nonce = Date.now();
+ * const action = { // Example action
+ *   type: "scheduleCancel",
+ *   time: Date.now() + 10000
+ * };
+ *
+ * // First, create signature from one of the authorized signers
+ * const signature = await signL1Action({
+ *   wallet,
+ *   action: [multiSigUser.toLowerCase(), wallet.address.toLowerCase(), action],
+ *   nonce,
+ *   isTestnet: true,
+ * });
+ *
+ * // Then use it 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",
+ * });
+ * ```
+ * @unstable May not behave as expected and the interface may change in the future.
+ */
+export async function signMultiSigAction(args) {
+    const { wallet, action, nonce, hyperliquidChain, signatureChainId, vaultAddress, expiresAfter, } = args;
+    const multiSigActionHash = createL1ActionHash(action, nonce, vaultAddress, expiresAfter);
+    const message = {
+        multiSigActionHash,
+        hyperliquidChain,
+        signatureChainId,
+        nonce,
+    };
+    return await signUserSignedAction({
+        wallet,
+        action: message,
+        types: {
+            "HyperliquidTransaction:SendMultiSig": [
+                { name: "hyperliquidChain", type: "string" },
+                { name: "multiSigActionHash", type: "bytes32" },
+                { name: "nonce", type: "uint64" },
+            ],
+        },
+        chainId: parseInt(signatureChainId, 16),
+    });
+}
 /** Signs typed data with the provided wallet using EIP-712. */
 async function abstractSignTypedData(args) {
     const { wallet, domain, types, message } = args;

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

@@ -0,0 +1,49 @@
+import { HyperliquidError } from "../base.js";
+/**
+ * Interface representing a REST transport.
+ *
+ * Handles communication with Hyperliquid API endpoints.
+ *
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint | Info endpoint}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint | Exchange endpoint}
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests | Websocket post requests}
+ */
+export interface IRequestTransport extends Partial<AsyncDisposable> {
+    /**
+     * Sends a request to the Hyperliquid API.
+     * @param endpoint - The API endpoint to send the request to.
+     * @param payload - The payload to send with the request.
+     * @param signal - An ptional abort signal.
+     * @returns A promise that resolves with parsed JSON response body.
+     */
+    request<T>(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
+}
+/**
+ * Interface representing an event subscription transport.
+ * Handles WebSocket subscriptions for real-time updates.
+ * @see {@link https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions | Websocket subscriptions}
+ */
+export interface ISubscriptionTransport extends Partial<AsyncDisposable> {
+    /**
+     * Subscribes to a Hyperliquid event channel.
+     * @param channel - The event channel to listen to.
+     * @param payload - The payload to send with the subscription request.
+     * @param listener - The function to call when the event is dispatched.
+     * @param signal - An optional abort signal for canceling the subscription request.
+     * @returns A promise that resolves with a {@link Subscription} object to manage the subscription lifecycle.
+     */
+    subscribe<T>(channel: string, payload: unknown, listener: (data: CustomEvent<T>) => void, signal?: AbortSignal): Promise<Subscription>;
+}
+/** Controls event subscription lifecycle. */
+export interface Subscription {
+    /**
+     * Unsubscribes from the event and sends an unsubscribe request to the server.
+     * @param signal - An optional abort signal for canceling the unsubscribe request.
+     */
+    unsubscribe(signal?: AbortSignal): Promise<void>;
+}
+/** Base class for all transport-related errors. */
+export declare class TransportError extends HyperliquidError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +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;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,EACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,EACxC,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,mDAAmD;AACnD,qBAAa,cAAe,SAAQ,gBAAgB;gBACpC,OAAO,CAAC,EAAE,MAAM;CAI/B"}

package/esm/src/transports/base.js

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

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

@@ -1,4 +1,5 @@
-import { type IRequestTransport, type MaybePromise, TransportError } from "../../base.js";
+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
@@ -22,12 +23,14 @@ export interface HttpTransportOptions {
      */
     isTestnet?: boolean;
     /**
-     * Request timeout in ms.
-     * Set to `null` to disable.
+     * Request timeout in ms. Set to `null` to disable.
      * @defaultValue `10_000`
      */
     timeout?: number | null;
-    /** Custom server to use for API requests. */
+    /**
+     * Custom server to use for API requests.
+     * @defaultValue `https://api.hyperliquid.xyz` for mainnet and `https://api.hyperliquid-testnet.xyz` for testnet.
+     */
     server?: {
         mainnet?: {
             api?: string | URL;
@@ -84,6 +87,6 @@ export declare class HttpTransport implements IRequestTransport, HttpTransportOp
      * @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}.
      */
-    request(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<unknown>;
+    request<T>(endpoint: "info" | "exchange" | "explorer", payload: unknown, signal?: AbortSignal): Promise<T>;
 }
 //# sourceMappingURL=http_transport.d.ts.map

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,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1F;;;;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;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,6CAA6C;IAC7C,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,CACT,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAC1C,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,OAAO,CAAC;CAwDtB"}
+{"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"}

package/esm/src/transports/http/http_transport.js

@@ -1,10 +1,12 @@
-import { TransportError } from "../../base.js";
+import { TransportError } from "../base.js";
 /**
  * Error thrown when an HTTP response is deemed invalid:
  * - Non-200 status code
  * - Unexpected content type
  */
 export class HttpRequestError extends TransportError {
+    response;
+    responseBody;
     /**
      * Creates a new HTTP request error.
      * @param response - The failed HTTP response.
@@ -15,64 +17,24 @@ export class HttpRequestError extends TransportError {
         if (responseBody)
             message += `, body "${responseBody}"`;
         super(message);
-        Object.defineProperty(this, "response", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: response
-        });
-        Object.defineProperty(this, "responseBody", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: responseBody
-        });
+        this.response = response;
+        this.responseBody = responseBody;
         this.name = "HttpRequestError";
     }
 }
 /** HTTP implementation of the REST transport interface. */
 export class HttpTransport {
+    isTestnet;
+    timeout;
+    server;
+    fetchOptions;
+    onRequest;
+    onResponse;
     /**
      * Creates a new HTTP transport instance.
      * @param options - Configuration options for the HTTP transport layer.
      */
     constructor(options) {
-        Object.defineProperty(this, "isTestnet", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "timeout", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "server", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "fetchOptions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onRequest", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onResponse", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.isTestnet = options?.isTestnet ?? false;
         this.timeout = options?.timeout === undefined ? 10_000 : options.timeout;
         this.server = {
@@ -105,7 +67,6 @@ export class HttpTransport {
             body: JSON.stringify(payload),
             headers: {
                 "Accept-Encoding": "gzip, deflate, br, zstd",
-                "Connection": "keep-alive",
                 "Content-Type": "application/json",
             },
             keepalive: true,
@@ -143,29 +104,21 @@ export class HttpTransport {
         return body;
     }
 }
-/**
- * Merges multiple `HeadersInit` objects into one.
- * @param inits - A list of `HeadersInit` objects to merge.
- * @returns A new `Headers` object that contains all headers from the input objects.
- */
+/** Merges multiple {@linkcode HeadersInit} into one {@linkcode Headers}. */
 function mergeHeadersInit(...inits) {
     if (inits.length === 0 || inits.length === 1) {
         return new Headers(inits[0]);
     }
     const merged = new Headers();
     for (const headers of inits) {
-        const entries = Symbol.iterator in headers ? headers : Object.entries(headers);
-        for (const [key, value] of entries) {
+        const iterator = Symbol.iterator in headers ? headers : Object.entries(headers);
+        for (const [key, value] of iterator) {
             merged.set(key, value);
         }
     }
     return merged;
 }
-/**
- * Merges multiple `RequestInit` objects into one.
- * @param inits - A list of `RequestInit` objects to merge.
- * @returns A new `RequestInit` object that contains all properties from the input objects.
- */
+/** Merges multiple {@linkcode RequestInit} into one {@linkcode RequestInit}. */
 function mergeRequestInit(...inits) {
     const merged = inits.reduce((acc, init) => ({ ...acc, ...init }), {});
     const headersList = inits.map((init) => init.headers)

package/esm/src/transports/websocket/_hyperliquid_event_target.d.ts

@@ -1,51 +1,48 @@
 import { TypedEventTarget } from "../../../deps/jsr.io/@derzade/typescript-event-target/1.1.1/mod.js";
 import type { BlockDetails, TxDetails } from "../../types/explorer/responses.js";
 import type { BaseExchangeResponse } from "../../types/exchange/responses.js";
+/** Response to subscribe to or unsubscribe from an event. */
+interface SubscriptionResponse {
+    /** Type of subscription operation. */
+    method: "subscribe" | "unsubscribe";
+    /** Original subscription request. */
+    subscription: unknown;
+}
+/** Response to post request. */
+interface PostResponse {
+    /** Unique request identifier. */
+    id: number;
+    /** Server response. */
+    response: 
+    /** Response containing requested information. */
+    {
+        /** Indicates that this is an informational response. */
+        type: "info";
+        /** Contains the information data. */
+        payload: {
+            /** Type of information being returned. */
+            type: string;
+            /** Information specific data. */
+            data: unknown;
+        };
+    }
+    /** Response containing action result. */
+     | {
+        /** Indicates that this is an action response. */
+        type: "action";
+        /** Action result. */
+        payload: BaseExchangeResponse;
+    };
+}
 /** Base system events and dynamic channel events for Hyperliquid WebSocket API. */
 interface HyperliquidEventMap {
-    /** Subscription created/removed event. */
-    subscriptionResponse: CustomEvent<{
-        /** Type of subscription operation. */
-        method: "subscribe" | "unsubscribe";
-        /** Original subscription request. */
-        subscription: unknown;
-    }>;
-    /** Response to post request event. */
-    post: CustomEvent<{
-        /** Unique request identifier. */
-        id: number;
-        /** Server response. */
-        response: 
-        /** Response containing requested information. */
-        {
-            /** Indicates that this is an informational response. */
-            type: "info";
-            /** Contains the information data. */
-            payload: {
-                /** Type of information being returned. */
-                type: string;
-                /** Information specific data. */
-                data: unknown;
-            };
-        }
-        /** Response containing action result. */
-         | {
-            /** Indicates that this is an action response. */
-            type: "action";
-            /** Action result. */
-            payload: BaseExchangeResponse;
-        };
-    }>;
-    /** Error response for message event. */
+    subscriptionResponse: CustomEvent<SubscriptionResponse>;
+    post: CustomEvent<PostResponse>;
     error: CustomEvent<string>;
-    /** Pong response event. */
     pong: CustomEvent<undefined>;
-    /** Block explorer update event. */
     _explorerBlock: CustomEvent<Omit<BlockDetails, "txs">[]>;
-    /** Transaction explorer update event. */
     _explorerTxs: CustomEvent<TxDetails[]>;
-    /** Subscribed channel event. */
-    [key: string]: CustomEvent<unknown>;
+    [key: string]: CustomEvent<any>;
 }
 /** Listens for WebSocket messages and sends them as Hyperliquid typed events. */
 export declare class HyperliquidEventTarget extends TypedEventTarget<HyperliquidEventMap> {

package/esm/src/transports/websocket/_hyperliquid_event_target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_hyperliquid_event_target.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/websocket/_hyperliquid_event_target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAU9E,mFAAmF;AACnF,UAAU,mBAAmB;IACzB,0CAA0C;IAC1C,oBAAoB,EAAE,WAAW,CAAC;QAC9B,sCAAsC;QACtC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;QACpC,qCAAqC;QACrC,YAAY,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;IAEH,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;QACd,iCAAiC;QACjC,EAAE,EAAE,MAAM,CAAC;QACX,uBAAuB;QACvB,QAAQ;QACJ,iDAAiD;QAC/C;YACE,wDAAwD;YACxD,IAAI,EAAE,MAAM,CAAC;YACb,qCAAqC;YACrC,OAAO,EAAE;gBACL,0CAA0C;gBAC1C,IAAI,EAAE,MAAM,CAAC;gBACb,iCAAiC;gBACjC,IAAI,EAAE,OAAO,CAAC;aACjB,CAAC;SACL;QACD,yCAAyC;WACvC;YACE,iDAAiD;YACjD,IAAI,EAAE,QAAQ,CAAC;YACf,qBAAqB;YACrB,OAAO,EAAE,oBAAoB,CAAC;SACjC,CAAC;KACT,CAAC,CAAC;IAEH,wCAAwC;IACxC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3B,2BAA2B;IAC3B,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAE7B,mCAAmC;IACnC,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAEzD,yCAAyC;IACzC,YAAY,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvC,gCAAgC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,iFAAiF;AACjF,qBAAa,sBAAuB,SAAQ,gBAAgB,CAAC,mBAAmB,CAAC;gBACjE,MAAM,EAAE,SAAS;CAiBhC"}
+{"version":3,"file":"_hyperliquid_event_target.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/websocket/_hyperliquid_event_target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAU9E,6DAA6D;AAC7D,UAAU,oBAAoB;IAC1B,sCAAsC;IACtC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACzB;AAED,gCAAgC;AAChC,UAAU,YAAY;IAClB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,QAAQ;IACJ,iDAAiD;IAC/C;QACE,wDAAwD;QACxD,IAAI,EAAE,MAAM,CAAC;QACb,qCAAqC;QACrC,OAAO,EAAE;YACL,0CAA0C;YAC1C,IAAI,EAAE,MAAM,CAAC;YACb,iCAAiC;YACjC,IAAI,EAAE,OAAO,CAAC;SACjB,CAAC;KACL;IACD,yCAAyC;OACvC;QACE,iDAAiD;QACjD,IAAI,EAAE,QAAQ,CAAC;QACf,qBAAqB;QACrB,OAAO,EAAE,oBAAoB,CAAC;KACjC,CAAC;CACT;AAED,mFAAmF;AACnF,UAAU,mBAAmB;IACzB,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7B,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,YAAY,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvC,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;CACnC;AAED,iFAAiF;AACjF,qBAAa,sBAAuB,SAAQ,gBAAgB,CAAC,mBAAmB,CAAC;gBACjE,MAAM,EAAE,SAAS;CAiBhC"}