@nktkas/hyperliquid 0.15.3 → 0.15.4

package/esm/src/clients/wallet.js

@@ -46,6 +46,17 @@ export class ApiRequestError extends HyperliquidError {
  * @typeParam W The WalletClient/Account ([viem](https://viem.sh/docs/clients/wallet)) or Signer ([ethers.js](https://docs.ethers.io/v6/api/providers/#Signer)) used for signing transactions.
  */
 export class WalletClient {
+    /** Gets the next nonce for signing transactions. */
+    get _nonce() {
+        let nonce = Date.now();
+        if (nonce <= this._lastNonce) {
+            nonce = ++this._lastNonce;
+        }
+        else {
+            this._lastNonce = nonce;
+        }
+        return nonce;
+    }
     /**
      * Initialises a new instance.
      * @param args - The parameters for the client.
@@ -131,13 +142,20 @@ export class WalletClient {
             writable: true,
             value: void 0
         });
+        /** The last nonce used for signing transactions. */
+        Object.defineProperty(this, "_lastNonce", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
         this.transport = args.transport;
         this.wallet = args.wallet;
         this.isTestnet = args.isTestnet ?? false;
         this.defaultVaultAddress = args.defaultVaultAddress;
         this.signatureChainId = args.signatureChainId ?? (this.isTestnet ? "0x66eee" : "0xa4b1");
     }
-    // ———————————————Actions———————————————
+    // ——————————————— Exchange API ———————————————
     /**
      * Approve an agent to sign on behalf of the master or sub-accounts.
      * @param args - The parameters for the request.
@@ -168,7 +186,7 @@ export class WalletClient {
             type: "approveAgent",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -221,7 +239,7 @@ export class WalletClient {
             type: "approveBuilderFee",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -283,7 +301,7 @@ export class WalletClient {
      */
     async batchModify(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "batchModify",
@@ -293,8 +311,8 @@ export class WalletClient {
                     order: {
                         a: modify.order.a,
                         b: modify.order.b,
-                        p: modify.order.p,
-                        s: modify.order.s,
+                        p: this._formatDecimal(modify.order.p),
+                        s: this._formatDecimal(modify.order.s),
                         r: modify.order.r,
                         t: "limit" in modify.order.t
                             ? {
@@ -305,7 +323,7 @@ export class WalletClient {
                             : {
                                 trigger: {
                                     isMarket: modify.order.t.trigger.isMarket,
-                                    triggerPx: modify.order.t.trigger.triggerPx,
+                                    triggerPx: this._formatDecimal(modify.order.t.trigger.triggerPx),
                                     tpsl: modify.order.t.trigger.tpsl,
                                 },
                             },
@@ -359,7 +377,7 @@ export class WalletClient {
      */
     async cancel(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "cancel",
@@ -410,7 +428,7 @@ export class WalletClient {
             type: "cDeposit",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -454,7 +472,7 @@ export class WalletClient {
      */
     async claimRewards(args = {}, signal) {
         // Destructure the parameters
-        const { nonce = Date.now() } = args;
+        const { nonce = this._nonce, } = args;
         // Construct an action
         const sortedAction = { type: "claimRewards" };
         // Sign the action
@@ -498,7 +516,7 @@ export class WalletClient {
      */
     async cancelByCloid(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "cancelByCloid",
@@ -549,7 +567,7 @@ export class WalletClient {
             type: "cWithdraw",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -593,7 +611,7 @@ export class WalletClient {
      */
     async evmUserModify(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "evmUserModify",
@@ -635,7 +653,7 @@ export class WalletClient {
      */
     async createSubAccount(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "createSubAccount",
@@ -681,7 +699,7 @@ export class WalletClient {
      */
     async createVault(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "createVault",
@@ -741,7 +759,7 @@ export class WalletClient {
      */
     async modify(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "modify",
@@ -749,8 +767,8 @@ export class WalletClient {
             order: {
                 a: actionArgs.order.a,
                 b: actionArgs.order.b,
-                p: actionArgs.order.p,
-                s: actionArgs.order.s,
+                p: this._formatDecimal(actionArgs.order.p),
+                s: this._formatDecimal(actionArgs.order.s),
                 r: actionArgs.order.r,
                 t: "limit" in actionArgs.order.t
                     ? {
@@ -761,7 +779,7 @@ export class WalletClient {
                     : {
                         trigger: {
                             isMarket: actionArgs.order.t.trigger.isMarket,
-                            triggerPx: actionArgs.order.t.trigger.triggerPx,
+                            triggerPx: this._formatDecimal(actionArgs.order.t.trigger.triggerPx),
                             tpsl: actionArgs.order.t.trigger.tpsl,
                         },
                     },
@@ -822,7 +840,7 @@ export class WalletClient {
      */
     async order(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "order",
@@ -830,8 +848,8 @@ export class WalletClient {
                 const sortedOrder = {
                     a: order.a,
                     b: order.b,
-                    p: order.p,
-                    s: order.s,
+                    p: this._formatDecimal(order.p),
+                    s: this._formatDecimal(order.s),
                     r: order.r,
                     t: "limit" in order.t
                         ? {
@@ -842,7 +860,7 @@ export class WalletClient {
                         : {
                             trigger: {
                                 isMarket: order.t.trigger.isMarket,
-                                triggerPx: order.t.trigger.triggerPx,
+                                triggerPx: this._formatDecimal(order.t.trigger.triggerPx),
                                 tpsl: order.t.trigger.tpsl,
                             },
                         },
@@ -899,7 +917,7 @@ export class WalletClient {
      */
     async scheduleCancel(args = {}, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "scheduleCancel",
@@ -944,7 +962,7 @@ export class WalletClient {
      */
     async setDisplayName(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "setDisplayName",
@@ -986,7 +1004,7 @@ export class WalletClient {
      */
     async setReferrer(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "setReferrer",
@@ -1006,6 +1024,110 @@ export class WalletClient {
         this._validateResponse(response);
         return response;
     }
+    /**
+     * Deploying HIP-1 and HIP-2 assets.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Successful response without specific data.
+     * @throws {ApiRequestError} When the API returns an error response.
+     * @untested
+     *
+     * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/deploying-hip-1-and-hip-2-assets
+     * @example
+     * ```ts
+     * import * as hl from "@nktkas/hyperliquid";
+     * import { privateKeyToAccount } from "viem/accounts";
+     *
+     * const wallet = privateKeyToAccount("0x...");
+     * const transport = new hl.HttpTransport(); // or WebSocketTransport
+     * const client = new hl.WalletClient({ wallet, transport });
+     *
+     * // Unknown what the successful response will be
+     * const result = await client.spotDeploy({
+     *   registerToken2: {
+     *     spec: {
+     *       name: "TestToken",
+     *       szDecimals: 8,
+     *       weiDecimals: 8,
+     *     },
+     *     maxGas: 1000000,
+     *     fullName: "TestToken (TT)"
+     *   }
+     * });
+     * ```
+     */
+    async spotDeploy(args, signal) {
+        // Destructure the parameters
+        const { nonce = this._nonce, ...actionArgs } = args;
+        // Construct an action
+        let action;
+        if ("registerToken2" in actionArgs) {
+            action = {
+                type: "spotDeploy",
+                registerToken2: {
+                    spec: {
+                        name: actionArgs.registerToken2.spec.name,
+                        szDecimals: actionArgs.registerToken2.spec.szDecimals,
+                        weiDecimals: actionArgs.registerToken2.spec.weiDecimals,
+                    },
+                    maxGas: actionArgs.registerToken2.maxGas,
+                    fullName: actionArgs.registerToken2.fullName,
+                },
+            };
+        }
+        else if ("userGenesis" in actionArgs) {
+            action = {
+                type: "spotDeploy",
+                userGenesis: {
+                    token: actionArgs.userGenesis.token,
+                    userAndWei: actionArgs.userGenesis.userAndWei,
+                    existingTokenAndWei: actionArgs.userGenesis.existingTokenAndWei,
+                },
+            };
+        }
+        else if ("genesis" in actionArgs) {
+            action = {
+                type: "spotDeploy",
+                genesis: {
+                    token: actionArgs.genesis.token,
+                    maxSupply: actionArgs.genesis.maxSupply,
+                },
+            };
+        }
+        else if ("registerSpot" in actionArgs) {
+            action = {
+                type: "spotDeploy",
+                registerSpot: {
+                    tokens: actionArgs.registerSpot.tokens,
+                },
+            };
+        }
+        else {
+            action = {
+                type: "spotDeploy",
+                registerHyperliquidity: {
+                    spot: actionArgs.registerHyperliquidity.spot,
+                    startPx: actionArgs.registerHyperliquidity.startPx,
+                    orderSz: actionArgs.registerHyperliquidity.orderSz,
+                    nOrders: actionArgs.registerHyperliquidity.nOrders,
+                    nSeededLevels: actionArgs.registerHyperliquidity.nSeededLevels,
+                },
+            };
+        }
+        // Sign the action
+        const signature = await signL1Action({
+            wallet: this.wallet,
+            action,
+            nonce,
+            isTestnet: this.isTestnet,
+        });
+        // Send a request
+        const request = { action, signature, nonce };
+        const response = await this.transport.request("exchange", request, signal);
+        // Validate a response
+        this._validateResponse(response);
+        return response;
+    }
     /**
      * Transfer a spot asset on L1 to another address.
      * @param args - The parameters for the request.
@@ -1037,7 +1159,7 @@ export class WalletClient {
             type: "spotSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            time: args.time ?? Date.now(),
+            time: args.time ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -1085,7 +1207,7 @@ export class WalletClient {
      */
     async spotUser(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "spotUser",
@@ -1134,7 +1256,7 @@ export class WalletClient {
      */
     async subAccountSpotTransfer(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "subAccountSpotTransfer",
@@ -1183,7 +1305,7 @@ export class WalletClient {
      */
     async subAccountTransfer(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "subAccountTransfer",
@@ -1236,7 +1358,7 @@ export class WalletClient {
             type: "tokenDelegate",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -1285,7 +1407,7 @@ export class WalletClient {
      */
     async twapCancel(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "twapCancel",
@@ -1336,14 +1458,14 @@ export class WalletClient {
      */
     async twapOrder(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "twapOrder",
             twap: {
                 a: actionArgs.a,
                 b: actionArgs.b,
-                s: actionArgs.s,
+                s: this._formatDecimal(actionArgs.s),
                 r: actionArgs.r,
                 m: actionArgs.m,
                 t: actionArgs.t,
@@ -1390,7 +1512,7 @@ export class WalletClient {
      */
     async updateIsolatedMargin(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "updateIsolatedMargin",
@@ -1439,7 +1561,7 @@ export class WalletClient {
      */
     async updateLeverage(args, signal) {
         // Destructure the parameters
-        const { vaultAddress = this.defaultVaultAddress, nonce = Date.now(), ...actionArgs } = args;
+        const { vaultAddress = this.defaultVaultAddress, nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "updateLeverage",
@@ -1492,7 +1614,7 @@ export class WalletClient {
             type: "usdClassTransfer",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            nonce: args.nonce ?? Date.now(),
+            nonce: args.nonce ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -1545,7 +1667,7 @@ export class WalletClient {
             type: "usdSend",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            time: args.time ?? Date.now(),
+            time: args.time ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -1593,7 +1715,7 @@ export class WalletClient {
      */
     async vaultDistribute(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "vaultDistribute",
@@ -1640,7 +1762,7 @@ export class WalletClient {
      */
     async vaultModify(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "vaultModify",
@@ -1688,7 +1810,7 @@ export class WalletClient {
      */
     async vaultTransfer(args, signal) {
         // Destructure the parameters
-        const { nonce = Date.now(), ...actionArgs } = args;
+        const { nonce = this._nonce, ...actionArgs } = args;
         // Construct an action
         const action = {
             type: "vaultTransfer",
@@ -1740,7 +1862,7 @@ export class WalletClient {
             type: "withdraw3",
             hyperliquidChain: this.isTestnet ? "Testnet" : "Mainnet",
             signatureChainId: this.signatureChainId,
-            time: args.time ?? Date.now(),
+            time: args.time ?? this._nonce,
         };
         // Sign the action
         const signature = await signUserSignedAction({
@@ -1763,6 +1885,15 @@ export class WalletClient {
         this._validateResponse(response);
         return response;
     }
+    // ——————————————— Private methods ———————————————
+    /** Formats a decimal number as a string, removing trailing zeros. */
+    _formatDecimal(numStr) {
+        if (!numStr.includes("."))
+            return numStr;
+        const [intPart, fracPart] = numStr.split(".");
+        const newFrac = fracPart.replace(/0+$/, "");
+        return newFrac ? `${intPart}.${newFrac}` : intPart;
+    }
     /** Validate a response from the API. */
     _validateResponse(response) {
         if (response.status === "err") {

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

@@ -19,11 +19,27 @@ export declare class HttpRequestError extends TransportError {
 export interface HttpTransportOptions {
     /**
      * Base URL for API endpoints.
-     * - Mainnet: `https://api.hyperliquid.xyz`
-     * - Testnet: `https://api.hyperliquid-testnet.xyz`
-     * @defaultValue `https://api.hyperliquid.xyz`
+     *
+     * When given as a string or URL, the URL is modified based on the request type:
+     * - For `"info"` and `"exchange"`, the hostname is replaced with `api.<baseDomain>`.
+     * - For `"explorer"`, the hostname is replaced with `rpc.<baseDomain>`.
+     *
+     * Alternatively, you can supply an object to specify separate URLs:
+     * ```ts
+     * {
+     *   api: "https://api.hyperliquid.xyz",
+     *   rpc: "https://rpc.hyperliquid.xyz"
+     * }
+     * ```
+     *
+     * - Mainnet: `https://hyperliquid.xyz`
+     * - Testnet: `https://hyperliquid-testnet.xyz`
+     * @defaultValue `https://hyperliquid.xyz`
      */
-    url?: string | URL;
+    url?: string | URL | {
+        api?: string | URL;
+        rpc?: string | URL;
+    };
     /**
      * Request timeout in ms.
      * Set to `null` to disable.
@@ -47,7 +63,10 @@ export interface HttpTransportOptions {
 }
 /** HTTP implementation of the REST transport interface. */
 export declare class HttpTransport implements IRequestTransport, HttpTransportOptions {
-    url: string | URL;
+    url: string | URL | {
+        api?: string | URL;
+        rpc?: string | URL;
+    };
     timeout: number | null;
     fetchOptions: Omit<RequestInit, "body" | "method">;
     onRequest?: (request: Request) => MaybePromise<Request | void | null | undefined>;

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,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;;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;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,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,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,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;IAQ1C;;;;;;;;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;CAqDtB"}
+{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/http/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvE,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;;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;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,EACE,MAAM,GACN,GAAG,GACH;QACE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;IAEN;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,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,GAAG,EACG,MAAM,GACN,GAAG,GACH;QACE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;IACN,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,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;IAQ1C;;;;;;;;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;CAyDtB"}

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

@@ -84,12 +84,18 @@ export class HttpTransport {
      */
     async request(endpoint, payload, signal) {
         // Construct a Request
-        const url = new URL(endpoint, this.url);
-        // FIXME: Temporary hack: replace `api.hyperliquid-testnet.xyz/explorer` with `rpc.hyperliquid-testnet.xyz/explorer`
-        // until the new rpc url becomes the standard for mainnet.
-        // TODO: Maybe after that should split the url property into api and rpc variants.
-        if (url.hostname === "api.hyperliquid-testnet.xyz" && url.pathname === "/explorer") {
-            url.hostname = "rpc.hyperliquid-testnet.xyz";
+        let url;
+        if (typeof this.url === "string" || this.url instanceof URL) {
+            // If a string is provided, get the base domain and apply the modification to it
+            const parsedUrl = new URL(this.url);
+            const parts = parsedUrl.hostname.split(".");
+            const baseDomain = parts.slice(-2).join(".");
+            const baseUrl = `${parsedUrl.protocol}//${endpoint === "explorer" ? "rpc" : "api"}.${baseDomain}`;
+            url = new URL(endpoint, baseUrl);
+        }
+        else {
+            // If an object is specified, use the specific url and add a path to it
+            url = new URL(endpoint, endpoint === "explorer" ? this.url.rpc : this.url.api);
         }
         const init = mergeRequestInit({
             body: JSON.stringify(payload),

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

@@ -76,7 +76,7 @@ export declare class WebSocketTransport implements IRequestTransport, ISubscript
     constructor(options?: WebSocketTransportOptions);
     /**
      * Sends a request to the Hyperliquid API via WebSocket.
-     * @param endpoint - The API endpoint to send the request to.
+     * @param endpoint - The API endpoint to send the request to (`explorer` requests are not supported).
      * @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.

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

@@ -1 +1 @@
-{"version":3,"file":"websocket_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/websocket/websocket_transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,4BAA4B,EACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACvG,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,OAAO,EAAE,KAAK,qBAAqB,EAAE,0BAA0B,EAAE,KAAK,4BAA4B,EAAE,CAAC;AAErG,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACtC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE;QACR;;;;WAIG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE,4BAA4B,CAAC;CAC5C;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,YAAW,iBAAiB,EAAE,sBAAsB;IAChF,qDAAqD;IACrD,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhD,iDAAiD;IACjD,SAAS,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAEnD,6CAA6C;IAC7C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,cAAc,EAAE,GAAG,CACzB,MAAM,EACN;QACI,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,CACJ,CAAa;IAEd;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE;QAChB;;;WAGG;QACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC;;;OAGG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IAuC/C;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBzG;;;;;;;OAOG;IACG,SAAS,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,CAAC;IAwExB;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1C;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB7C"}
+{"version":3,"file":"websocket_transport.d.ts","sourceRoot":"","sources":["../../../../src/src/transports/websocket/websocket_transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,4BAA4B,EACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACvG,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,EAAE,qBAAqB,EAAE,CAAC;AACjC,OAAO,EAAE,KAAK,qBAAqB,EAAE,0BAA0B,EAAE,KAAK,4BAA4B,EAAE,CAAC;AAErG,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACtC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE;QACR;;;;WAIG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE,4BAA4B,CAAC;CAC5C;AAED,kFAAkF;AAClF,qBAAa,kBAAmB,YAAW,iBAAiB,EAAE,sBAAsB;IAChF,qDAAqD;IACrD,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhD,iDAAiD;IACjD,SAAS,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAEnD,6CAA6C;IAC7C,SAAS,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAE5C;;;;;OAKG;IACH,SAAS,CAAC,cAAc,EAAE,GAAG,CACzB,MAAM,EACN;QACI,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,CACJ,CAAa;IAEd;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE;QAChB;;;WAGG;QACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC;;;OAGG;gBACS,OAAO,CAAC,EAAE,yBAAyB;IAuC/C;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBzG;;;;;;;OAOG;IACG,SAAS,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EACrC,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,YAAY,CAAC;IAwExB;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1C;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB7C"}

package/esm/src/transports/websocket/websocket_transport.js

@@ -99,7 +99,7 @@ export class WebSocketTransport {
     }
     /**
      * Sends a request to the Hyperliquid API via WebSocket.
-     * @param endpoint - The API endpoint to send the request to.
+     * @param endpoint - The API endpoint to send the request to (`explorer` requests are not supported).
      * @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.
@@ -107,10 +107,6 @@ export class WebSocketTransport {
      * @note Explorer requests are not supported in the Hyperliquid WebSocket API.
      */
     request(type, payload, signal) {
-        // Reject explorer requests because they are not supported by the Hyperliquid WebSocket API
-        if (type === "explorer") {
-            return Promise.reject(new WebSocketRequestError("Explorer requests are not supported in the Hyperliquid WebSocket API."));
-        }
         // Send the request and wait for a response
         const timeoutSignal = this.timeout ? AbortSignal.timeout(this.timeout) : undefined;
         const combinedSignal = signal && timeoutSignal