@nktkas/hyperliquid 0.15.2 → 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",
@@ -655,6 +673,55 @@ export class WalletClient {
         this._validateResponse(response);
         return response;
     }
+    /**
+     * Create a vault.
+     * @param args - The parameters for the request.
+     * @param signal - An optional abort signal.
+     * @returns Response for creating a vault.
+     * @throws {ApiRequestError} When the API returns an error response.
+     *
+     * @see null - no documentation
+     * @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 });
+     *
+     * const result = await client.createVault({
+     *   name: "VaultName",
+     *   description: "This is an example of a vault description",
+     *   initialUsd: 100 * 1e6,
+     * });
+     * ```
+     */
+    async createVault(args, signal) {
+        // Destructure the parameters
+        const { nonce = this._nonce, ...actionArgs } = args;
+        // Construct an action
+        const action = {
+            type: "createVault",
+            name: actionArgs.name,
+            description: actionArgs.description,
+            initialUsd: actionArgs.initialUsd,
+            nonce,
+        };
+        // 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;
+    }
     /**
      * Modify an order.
      * @param args - The parameters for the request.
@@ -692,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",
@@ -700,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
                     ? {
@@ -712,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,
                         },
                     },
@@ -773,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",
@@ -781,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
                         ? {
@@ -793,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,
                             },
                         },
@@ -850,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",
@@ -895,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",
@@ -937,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",
@@ -957,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.
@@ -988,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({
@@ -1036,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",
@@ -1085,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",
@@ -1134,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",
@@ -1187,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({
@@ -1236,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",
@@ -1287,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,
@@ -1341,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",
@@ -1390,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",
@@ -1443,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({
@@ -1496,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({
@@ -1544,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",
@@ -1591,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",
@@ -1639,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",
@@ -1691,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({
@@ -1714,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/_hyperliquid_event_target.js

@@ -30,23 +30,21 @@ function isHyperliquidMsg(value) {
 /** Type guard for explorer block messages. */
 function isExplorerBlockMsg(value) {
     return Array.isArray(value) && value.length > 0 &&
-        value.every((block) => typeof block === "object" && block !== null && !Array.isArray(block) &&
-            "height" in block && typeof block.height === "number" &&
-            "blockTime" in block && typeof block.blockTime === "number" &&
-            "hash" in block && typeof block.hash === "string" &&
-            "proposer" in block && typeof block.proposer === "string" &&
-            "numTxs" in block && typeof block.numTxs === "number");
+        (typeof value[0] === "object" && value[0] !== null && !Array.isArray(value[0]) &&
+            "height" in value[0] && typeof value[0].height === "number" &&
+            "blockTime" in value[0] && typeof value[0].blockTime === "number" &&
+            "hash" in value[0] && typeof value[0].hash === "string" &&
+            "proposer" in value[0] && typeof value[0].proposer === "string" &&
+            "numTxs" in value[0] && typeof value[0].numTxs === "number");
 }
 /** Type guard for explorer transactions messages. */
 function isExplorerTxsMsg(value) {
     return Array.isArray(value) && value.length > 0 &&
-        value.every((tx) => {
-            return typeof tx === "object" && tx !== null && !Array.isArray(tx) &&
-                "action" in tx && typeof tx.action === "object" && tx.action !== null &&
-                "block" in tx && typeof tx.block === "number" &&
-                "error" in tx && (typeof tx.error === "string" || tx.error === null) &&
-                "hash" in tx && typeof tx.hash === "string" &&
-                "time" in tx && typeof tx.time === "number" &&
-                "user" in tx && typeof tx.user === "string";
-        });
+        (typeof value[0] === "object" && value[0] !== null && !Array.isArray(value[0]) &&
+            "action" in value[0] && typeof value[0].action === "object" && value[0].action !== null &&
+            "block" in value[0] && typeof value[0].block === "number" &&
+            "error" in value[0] && (typeof value[0].error === "string" || value[0].error === null) &&
+            "hash" in value[0] && typeof value[0].hash === "string" &&
+            "time" in value[0] && typeof value[0].time === "number" &&
+            "user" in value[0] && typeof value[0].user === "string");
 }