@nktkas/hyperliquid 0.15.3 → 0.15.4

package/script/src/clients/wallet.js

@@ -59,6 +59,17 @@
      * @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.
      */
     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.
@@ -144,13 +155,20 @@
                 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.
@@ -181,7 +199,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -234,7 +252,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -296,7 +314,7 @@
          */
         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",
@@ -306,8 +324,8 @@
                         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
                                 ? {
@@ -318,7 +336,7 @@
                                 : {
                                     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,
                                     },
                                 },
@@ -372,7 +390,7 @@
          */
         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",
@@ -423,7 +441,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -467,7 +485,7 @@
          */
         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
@@ -511,7 +529,7 @@
          */
         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",
@@ -562,7 +580,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -606,7 +624,7 @@
          */
         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",
@@ -648,7 +666,7 @@
          */
         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",
@@ -694,7 +712,7 @@
          */
         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",
@@ -754,7 +772,7 @@
          */
         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",
@@ -762,8 +780,8 @@
                 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
                         ? {
@@ -774,7 +792,7 @@
                         : {
                             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,
                             },
                         },
@@ -835,7 +853,7 @@
          */
         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",
@@ -843,8 +861,8 @@
                     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
                             ? {
@@ -855,7 +873,7 @@
                             : {
                                 trigger: {
                                     isMarket: order.t.trigger.isMarket,
-                                    triggerPx: order.t.trigger.triggerPx,
+                                    triggerPx: this._formatDecimal(order.t.trigger.triggerPx),
                                     tpsl: order.t.trigger.tpsl,
                                 },
                             },
@@ -912,7 +930,7 @@
          */
         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",
@@ -957,7 +975,7 @@
          */
         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",
@@ -999,7 +1017,7 @@
          */
         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",
@@ -1019,6 +1037,110 @@
             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 (0, signing_js_1.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.
@@ -1050,7 +1172,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -1098,7 +1220,7 @@
          */
         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",
@@ -1147,7 +1269,7 @@
          */
         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",
@@ -1196,7 +1318,7 @@
          */
         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",
@@ -1249,7 +1371,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -1298,7 +1420,7 @@
          */
         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",
@@ -1349,14 +1471,14 @@
          */
         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,
@@ -1403,7 +1525,7 @@
          */
         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",
@@ -1452,7 +1574,7 @@
          */
         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",
@@ -1505,7 +1627,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -1558,7 +1680,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -1606,7 +1728,7 @@
          */
         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",
@@ -1653,7 +1775,7 @@
          */
         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",
@@ -1701,7 +1823,7 @@
          */
         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",
@@ -1753,7 +1875,7 @@
                 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 (0, signing_js_1.signUserSignedAction)({
@@ -1776,6 +1898,15 @@
             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/script/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/script/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/script/src/transports/http/http_transport.js

@@ -97,12 +97,18 @@
          */
         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/script/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/script/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/script/src/transports/websocket/websocket_transport.js

@@ -111,7 +111,7 @@
         }
         /**
          * 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.
@@ -119,10 +119,6 @@
          * @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 _websocket_request_dispatcher_js_1.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