@nktkas/hyperliquid 0.25.0-beta.1 → 0.25.0-beta.3

package/README.md

@@ -57,9 +57,15 @@ deno add jsr:@nktkas/hyperliquid
 // Issues:
 // - signing: does not support private keys directly, use `viem` or `ethers`
 
-import "event-target-polyfill";
+import "event-target-polyfill"; // for `WebSocketTransport`
+// or
+// import { Event, EventTarget } from "event-target-shim";
+// if (!globalThis.EventTarget || !globalThis.Event) {
+//     globalThis.EventTarget = EventTarget;
+//     globalThis.Event = Event;
+// }
 
-if (!globalThis.CustomEvent) {
+if (!globalThis.CustomEvent) { // for `WebSocketTransport`
     globalThis.CustomEvent = function (type, params) {
         params = params || {};
         const event = new Event(type, params);
@@ -68,15 +74,7 @@ if (!globalThis.CustomEvent) {
     };
 }
 
-if (!AbortSignal.timeout) {
-    AbortSignal.timeout = function (delay) {
-        const controller = new AbortController();
-        setTimeout(() => controller.abort(), delay);
-        return controller.signal;
-    };
-}
-
-if (!Promise.withResolvers) {
+if (!Promise.withResolvers) { // for `WebSocketTransport`
     Promise.withResolvers = function () {
         let resolve, reject;
         const promise = new Promise((res, rej) => {
@@ -86,6 +84,30 @@ if (!Promise.withResolvers) {
         return { promise, resolve, reject };
     };
 }
+
+if (!AbortSignal.any) {
+    AbortSignal.any = function (signals) {
+        const controller = new AbortController();
+        for (const signal of signals) {
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                return controller.signal;
+            }
+            signal.addEventListener("abort", () => {
+                controller.abort(signal.reason);
+            }, { once: true, signal: controller.signal });
+        }
+        return controller.signal;
+    };
+}
+
+if (!AbortSignal.timeout) {
+    AbortSignal.timeout = function (delay) {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), delay);
+        return controller.signal;
+    };
+}
 ```
 
 </details>
@@ -174,6 +196,14 @@ const multiSignClient = new hl.MultiSignClient({
 await multiSignClient.approveAgent({ agentAddress: "0x..." });
 ```
 
+### CLI
+
+The SDK includes a command-line interface for quick interactions with Hyperliquid API without writing code.
+
+```bash
+npx @nktkas/hyperliquid --help
+```
+
 ## Usage
 
 ### 1) Initialize Transport
@@ -187,7 +217,7 @@ import * as hl from "@nktkas/hyperliquid";
 const httpTransport = new hl.HttpTransport({...}); // Accepts optional parameters (e.g. isTestnet, timeout, etc.)
 
 // 2. WebSocket Transport: has better network latency than HTTP transport
-const wsTransport = new hl.WebSocketTransport({...}); // Accepts optional parameters (e.g. url, timeout, reconnect, etc.)
+const wsTransport = new hl.WebSocketTransport({...}); // Accepts optional parameters (e.g. url, isTestnet, timeout, reconnect, etc.)
 ```
 
 ### 2) Initialize Client
@@ -406,9 +436,11 @@ class InfoClient {
     meta(params?: MetaParameters): Promise<PerpsMeta>;
     metaAndAssetCtxs(params?: MetaAndAssetCtxsParameters): Promise<PerpsMetaAndAssetCtxs>;
     perpDeployAuctionStatus(): Promise<DeployAuctionStatus>;
+    perpDexLimits(params: PerpDexLimitsParameters): Promise<PerpDexLimits | null>;
     perpDexs(): Promise<(PerpDex | null)[]>;
     perpsAtOpenInterestCap(params?: PerpsAtOpenInterestCapParameters): Promise<string[]>;
     predictedFundings(): Promise<PredictedFunding[]>;
+    recentTrades(params: RecentTradesParameters): Promise<Trade[]>;
     spotDeployState(params: SpotDeployStateParameters): Promise<SpotDeployState>;
     spotMeta(): Promise<SpotMeta>;
     spotMetaAndAssetCtxs(): Promise<SpotMetaAndAssetCtxs>;
@@ -446,6 +478,7 @@ class InfoClient {
     userTwapSliceFillsByTime(params: UserTwapSliceFillsByTimeParameters): Promise<TwapSliceFill[]>;
 
     // Validator
+    gossipRootIps(): Promise<GossipRootIps>;
     delegations(params: DelegationsParameters): Promise<Delegation[]>;
     delegatorHistory(params: DelegatorHistoryParameters): Promise<DelegatorUpdate[]>;
     delegatorRewards(params: DelegatorRewardsParameters): Promise<DelegatorReward[]>;
@@ -476,7 +509,6 @@ class ExchangeClient {
     constructor(args: {
         transport: HttpTransport | WebSocketTransport;
         wallet: AbstractWallet; // `viem`, `ethers` (v5 or v6), or private key directly
-        isTestnet?: boolean; // Whether to use testnet (default: false)
         defaultVaultAddress?: Hex; // Vault address used by default if not provided in method call
         signatureChainId?: Hex | (() => MaybePromise<Hex>); // Chain ID used for signing (default: get chain id from wallet otherwise `0x1`)
         nonceManager?: () => MaybePromise<number>; // Function to get the next nonce (default: monotonically incrementing `Date.now()`)
@@ -507,6 +539,7 @@ class ExchangeClient {
     setReferrer(params: SetReferrerParameters): Promise<SuccessResponse>;
     subAccountModify(params: SubAccountModifyParameters): Promise<SuccessResponse>;
     spotUser(params: SpotUserParameters): Promise<SuccessResponse>;
+    webData2(params: WebData2Parameters): Promise<WebData2>;
 
     // Transfer
     sendAsset(params: SendAssetParameters): Promise<SuccessResponse>;
@@ -660,6 +693,7 @@ class HttpTransport {
 class WebSocketTransport {
     constructor(options?: {
         url?: string | URL; // WebSocket URL (default: "wss://api.hyperliquid.xyz/ws")
+        isTestnet?: boolean; // Indicates this transport uses testnet endpoint (default: false)
         timeout?: number; // Request timeout in ms (default: 10_000)
         keepAlive?: {
             interval?: number; // Ping interval in ms (default: 30_000)
@@ -679,6 +713,13 @@ class WebSocketTransport {
 }
 ```
 
+### Errors
+
+- [`HyperliquidError`](src/errors.ts#L2) - Base error class for all SDK errors.
+- [`TransportError`](src/transports/base.ts#L49) - Thrown when a transport layer error occurs.
+- [`ApiRequestError`](src/clients//exchange.ts#L294) - Thrown when an API request fails.
+- [`SchemaError`](src/schemas/mod.ts#L79) - Thrown when a schema validation error occurs.
+
 ## Additional Import Points
 
 ### `/schemas`
@@ -705,7 +746,7 @@ const action = {
 } satisfies OrderRequest["action"]; // can be used as type
 
 //                             or as valibot schema
-//                             ⌄⌄⌄⌄⌄⌄⌄⌄⌄⌄⌄
+//                             ⌄⌄⌄⌄⌄⌄⌄⌄⌄⌄⌄⌄
 const validatedAction = parser(OrderRequest.entries.action)(action);
 //                      ^^^^^^
 //                      validates, formats, sorts object keys for correct signature generation
@@ -764,7 +805,7 @@ import { CancelRequest, parser } from "@nktkas/hyperliquid/schemas";
 
 const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const action = parser(CancelRequest.entries.action)({ // for correct signature generation
+const action = parser(CancelRequest.entries.action)({ // for correct signature generation (optional)
     type: "cancel",
     cancels: [
         { a: 0, o: 12345 },
@@ -791,7 +832,7 @@ import { ApproveAgentRequest, parser } from "@nktkas/hyperliquid/schemas";
 
 const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const action = parser(ApproveAgentRequest.entries.action)({ // for correct signature generation
+const action = parser(ApproveAgentRequest.entries.action)({ // for correct signature generation (optional)
     type: "approveAgent",
     signatureChainId: "0x66eee",
     hyperliquidChain: "Mainnet",
@@ -841,6 +882,13 @@ with `tif: "Ioc"` and price that guarantee immediate execution:
 **Vault and Sub-Account**: Pass vault or sub-account address via `vaultAddress` options to methods or set
 `defaultVaultAddress` in constructor.
 
+### How to use Testnet?
+
+[**HttpTransport**](#http-transport): Set the `isTestnet` flag to `true`.
+
+[**WebSocketTransport**](#websocket-transport): Set the `isTestnet` flag to `true` and provide the testnet `url` when
+initializing the transport.
+
 ## Contributing
 
 We appreciate your help! To contribute, please read the [contributing instructions](CONTRIBUTING.md).

package/esm/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/esm/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}

package/esm/bin/cli.js

@@ -0,0 +1,452 @@
+#!/usr/bin/env node
+import * as hl from "../src/mod.js";
+import { Hex } from "../src/schemas/mod.js";
+import * as v from "valibot";
+import parseArgs from "minimist";
+import process from "node:process";
+// deno-lint-ignore no-explicit-any
+function getClassMethods(classConstructor) {
+    return Object.getOwnPropertyNames(classConstructor.prototype)
+        .filter((name) => {
+        if (name === "constructor")
+            return false;
+        const descriptor = Object.getOwnPropertyDescriptor(classConstructor.prototype, name);
+        return descriptor?.value && typeof descriptor.value === "function";
+    });
+}
+// deno-lint-ignore no-explicit-any
+function isClassMethod(classConstructor, method) {
+    const classMethods = getClassMethods(classConstructor);
+    // deno-lint-ignore no-explicit-any
+    return classMethods.includes(method);
+}
+function transformParams(method, params) {
+    switch (method) {
+        case "modify": {
+            v.assert(v.string(), params?.order);
+            return {
+                ...params,
+                order: JSON.parse(params.order),
+            };
+        }
+        case "convertToMultiSigUser": {
+            v.assert(v.string(), params?.authorizedUsers);
+            return {
+                ...params,
+                authorizedUsers: JSON.parse(params.authorizedUsers),
+            };
+        }
+        case "cSignerAction": {
+            return {
+                ...params,
+                jailSelf: "jailSelf" in params ? null : undefined,
+                unjailSelf: "unjailSelf" in params ? null : undefined,
+            };
+        }
+        case "order": {
+            v.assert(v.string(), params?.orders);
+            return {
+                ...params,
+                orders: JSON.parse(params.orders),
+                grouping: params.grouping ?? "na",
+            };
+        }
+        case "approveAgent": {
+            return {
+                ...params,
+                agentName: params.agentName ?? null,
+            };
+        }
+        case "sendAsset": {
+            return {
+                ...params,
+                fromSubAccount: params.fromSubAccount ?? "",
+            };
+        }
+        case "vaultModify": {
+            return {
+                ...params,
+                allowDeposits: params.allowDeposits ?? null,
+                alwaysCloseOnWithdraw: params.alwaysCloseOnWithdraw ?? null,
+            };
+        }
+        case "setDisplayName": {
+            return {
+                ...params,
+                displayName: params.displayName ?? "",
+            };
+        }
+        case "batchModify": {
+            v.assert(v.string(), params?.modifies);
+            return {
+                ...params,
+                modifies: JSON.parse(params.modifies),
+            };
+        }
+        case "cancel": {
+            v.assert(v.string(), params?.cancels);
+            return {
+                ...params,
+                cancels: JSON.parse(params.cancels),
+            };
+        }
+        case "cancelByCloid": {
+            v.assert(v.string(), params?.cancels);
+            return {
+                ...params,
+                cancels: JSON.parse(params.cancels),
+            };
+        }
+        case "createVault": {
+            return {
+                ...params,
+                nonce: Date.now(),
+            };
+        }
+        case "spotUser": {
+            return {
+                toggleSpotDusting: {
+                    ...params,
+                },
+            };
+        }
+        case "twapOrder": {
+            return {
+                twap: {
+                    ...params,
+                },
+            };
+        }
+        default: {
+            return {
+                ...params,
+            };
+        }
+    }
+}
+class EchoTransport {
+    isTestnet;
+    constructor(isTestnet) {
+        this.isTestnet = isTestnet;
+    }
+    request(endpoint, payload) {
+        if (endpoint === "explorer") {
+            if (typeof payload === "object" && payload !== null && "type" in payload) {
+                if (payload.type === "blockDetails") {
+                    return new Promise((resolve) => resolve({ blockDetails: payload }));
+                }
+                else if (payload.type === "txDetails") {
+                    return new Promise((resolve) => resolve({ tx: payload }));
+                }
+                else if (payload.type === "userDetails") {
+                    return new Promise((resolve) => resolve({ txs: payload }));
+                }
+            }
+        }
+        return new Promise((resolve) => resolve(payload));
+    }
+}
+class ExchangeClientWithoutValidation extends hl.ExchangeClient {
+    _validateResponse = () => true;
+}
+async function executeEndpointMethod(endpoint, method, cliArgs) {
+    const isTestnet = Boolean(cliArgs?.testnet);
+    const timeout = Number(cliArgs.timeout) || undefined;
+    const isOffline = Boolean(cliArgs?.offline);
+    const transport = isOffline ? new EchoTransport(isTestnet) : new hl.HttpTransport({ isTestnet, timeout });
+    let client;
+    if (endpoint === "info") {
+        if (!isClassMethod(hl.InfoClient, method)) {
+            throw new Error(`CLI does not support the "${method}" method in the "info" endpoint`);
+        }
+        client = new hl.InfoClient({ transport });
+    }
+    else if (endpoint === "exchange") {
+        if (!isClassMethod(hl.ExchangeClient, method)) {
+            throw new Error(`CLI does not support the "${method}" method in the "exchange" endpoint`);
+        }
+        const privateKey = v.parse(v.pipe(Hex, v.minLength(66)), cliArgs["private-key"], { message: 'Invalid format "private-key": Expected 32-byte hexadecimal string' });
+        delete cliArgs["private-key"]; // just in case
+        const vaultAddress = v.parse(v.optional(v.pipe(Hex, v.minLength(42))), cliArgs.vault, { message: 'Invalid format "vault": Expected 20-byte hexadecimal string OR nothing' });
+        client = isOffline
+            ? new ExchangeClientWithoutValidation({
+                transport,
+                wallet: privateKey,
+                defaultVaultAddress: vaultAddress,
+            })
+            : new hl.ExchangeClient({
+                transport,
+                wallet: privateKey,
+                defaultVaultAddress: vaultAddress,
+            });
+    }
+    else {
+        throw new Error(`Invalid endpoint "${endpoint}". Use "info" or "exchange"`);
+    }
+    // @ts-ignore - dynamic method access
+    return await client[method](transformParams(method, cliArgs));
+}
+// ──────────────────── Main ────────────────────
+function printHelp() {
+    console.log(`Hyperliquid CLI
+
+Usage:
+  npx @nktkas/hyperliquid <endpoint> <method> [options]
+
+Endpoints:
+  info      - Query blockchain and market information
+  exchange  - Execute trading operations (requires --private-key)
+
+Common Options:
+  --testnet               Use testnet instead of mainnet
+  --timeout <number>      Request timeout in milliseconds (default: 10000)
+  --help, -h              Show this help message
+  --offline               Generate transactions offline without broadcasting
+
+Exchange Options:
+  --private-key <key>     Private key for exchange operations (required)
+  --vault <address>       Vault address for operations
+
+=============================================================================
+INFO ENDPOINT METHODS
+=============================================================================
+
+Market Data:
+  allMids                 [--dex <string>]
+  l2Book                  --coin <string> [--nSigFigs <2|3|4|5>] [--mantissa <2|5>]
+  candleSnapshot          --coin <string> --interval <1m|3m|5m|15m|30m|1h|2h|4h|8h|12h|1d|3d|1w|1M> 
+                          --startTime <number> [--endTime <number>]
+  fundingHistory          --coin <string> --startTime <number> [--endTime <number>]
+  predictedFundings       (no params)
+  recentTrades            --coin <string>
+
+Exchange Information:
+  meta                    [--dex <string>]
+  metaAndAssetCtxs        [--dex <string>]
+  spotMeta                (no params)
+  spotMetaAndAssetCtxs    (no params)
+  exchangeStatus          (no params)
+  perpDexs                (no params)
+  perpDexLimits           --dex <string>
+  spotPairDeployAuctionStatus  (no params)
+  perpDeployAuctionStatus      (no params)
+  perpsAtOpenInterestCap       [--dex <string>]
+  maxMarketOrderNtls           (no params)
+  liquidatable                 (no params)
+  marginTable                  --id <number>
+
+User Account Data:
+  clearinghouseState      --user <address> [--dex <string>]
+  spotClearinghouseState  --user <address> [--dex <string>]
+  portfolio               --user <address>
+  openOrders              --user <address> [--dex <string>]
+  frontendOpenOrders      --user <address> [--dex <string>]
+  historicalOrders        --user <address>
+  orderStatus             --user <address> --oid <number|hex>
+  userDetails             --user <address>
+  userFees                --user <address>
+  userRateLimit           --user <address>
+  userRole                --user <address>
+  activeAssetData         --user <address> --coin <string>
+  isVip                   --user <address>
+  legalCheck              --user <address>
+  referral                --user <address>
+  spotDeployState         --user <address>
+  preTransferCheck        --user <address> --source <address>
+  maxBuilderFee           --user <address> --builder <address>
+  webData2                --user <address>
+
+User Trading History:
+  userFills               --user <address> [--aggregateByTime <bool>]
+  userFillsByTime         --user <address> --startTime <number> [--endTime <number>] [--aggregateByTime <bool>]
+  userFunding             --user <address> --startTime <number> [--endTime <number>]
+  userNonFundingLedgerUpdates  --user <address> --startTime <number> [--endTime <number>]
+  twapHistory             --user <address>
+  userTwapSliceFills      --user <address>
+  userTwapSliceFillsByTime     --user <address> --startTime <number> [--endTime <number>] [--aggregateByTime <bool>]
+
+Sub-Account & Multi-Sig:
+  subAccounts             --user <address>
+  extraAgents             --user <address>
+  userToMultiSigSigners   --user <address>
+
+Vault Information:
+  vaultSummaries          (no params)
+  vaultDetails            --vaultAddress <address> [--user <address>]
+  leadingVaults           --user <address>
+  userVaultEquities       --user <address>
+
+Delegation & Validators:
+  delegations             --user <address>
+  delegatorHistory        --user <address>
+  delegatorRewards        --user <address>
+  delegatorSummary        --user <address>
+  validatorL1Votes        (no params)
+  validatorSummaries      (no params)
+  gossipRootIps           (no params)
+
+Transaction & Block Details:
+  txDetails               --hash <hex>
+  blockDetails            --height <number>
+  tokenDetails            --tokenId <hex>
+
+=============================================================================
+EXCHANGE ENDPOINT METHODS
+=============================================================================
+
+Trading Operations:
+  order                   --orders <json> [--grouping <na|normalTpsl|positionTpsl>] 
+                          [--builder <json>]
+  modify                  --oid <number|hex> --order <json>
+  batchModify             --modifies <json>
+  cancel                  --cancels <json>
+  cancelByCloid           --cancels <json>
+  scheduleCancel          [--time <number>]
+
+TWAP Operations:
+  twapOrder               --a <number> --b <bool> --s <string> --r <bool> --m <number> --t <bool>
+  twapCancel              --a <number> --t <number>
+
+Position Management:
+  updateLeverage          --asset <number> --isCross <bool> --leverage <number>
+  updateIsolatedMargin    --asset <number> --isBuy <bool> --ntli <number>
+
+Fund Transfers:
+  withdraw3               --destination <address> --amount <string>
+  usdSend                 --destination <address> --amount <string>
+  spotSend                --destination <address> --token <name:address> --amount <string>
+  sendAsset               --destination <address> --token <name:address> --amount <string>
+                          --sourceDex <string> --destinationDex <string> [--fromSubAccount <address>]
+  usdClassTransfer        --amount <string> --toPerp <bool>
+
+Sub-Account Management:
+  createSubAccount        --name <string>
+  subAccountModify        --subAccountUser <address> --name <string>
+  subAccountTransfer      --subAccountUser <address> --isDeposit <bool> --usd <number>
+  subAccountSpotTransfer  --subAccountUser <address> --isDeposit <bool> 
+                          --token <name:address> --amount <string>
+
+Vault Operations:
+  createVault             --name <string> --description <string> --initialUsd <number>
+  vaultModify             --vaultAddress <address> [--allowDeposits <bool>] 
+                          [--alwaysCloseOnWithdraw <bool>]
+  vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
+  vaultDistribute         --vaultAddress <address> --usd <number>
+
+Agent & Referrer:
+  approveAgent            --agentAddress <address> [--agentName <string>]
+  approveBuilderFee       --maxFeeRate <number> --builder <address>
+  registerReferrer        --code <string>
+  setReferrer             --code <string>
+  setDisplayName          [--displayName <string>]
+
+Staking & Delegation:
+  tokenDelegate           --validator <address> --wei <number> --isUndelegate <bool>
+  cDeposit                --wei <number>
+  cWithdraw               --wei <number>
+  claimRewards            (no params)
+
+Spot & EVM Operations:
+  spotUser                --optOut <bool>
+  evmUserModify           --usingBigBlocks <bool>
+  reserveRequestWeight    --weight <number>
+
+Multi-Sig & Advanced:
+  convertToMultiSigUser   --authorizedUsers <json> --threshold <number>
+  cSignerAction           --jailSelf | --unjailSelf
+  noop                    (no params)
+
+=============================================================================
+
+Examples:
+  # Get all mid prices
+  npx @nktkas/hyperliquid info allMids
+
+  # Get ETH order book with 3 significant figures
+  npx @nktkas/hyperliquid info l2Book --coin ETH --nSigFigs 3
+
+  # Get user's portfolio
+  npx @nktkas/hyperliquid info portfolio --user 0x...
+
+  # Get candle data for BTC
+  npx @nktkas/hyperliquid info candleSnapshot --coin BTC --interval 1h --startTime 1700000000000
+
+  # Place a limit order
+  npx @nktkas/hyperliquid exchange order --private-key 0x... --orders '[{\\"a\\":0,\\"b\\":true,\\"p\\":\\"30000\\",\\"s\\":\\"0.1\\",\\"r\\":false,\\"t\\":{\\"limit\\":{\\"tif\\":\\"Gtc\\"}}}]'
+
+  # Modify an existing order
+  npx @nktkas/hyperliquid exchange modify --private-key 0x... --oid 12345 --order '{\\"a\\":0,\\"b\\":true,\\"p\\":\\"31000\\",\\"s\\":\\"0.1\\",\\"r\\":false,\\"t\\":{\\"limit\\":{\\"tif\\":\\"Gtc\\"}}}'
+
+  # Cancel orders
+  npx @nktkas/hyperliquid exchange cancel --private-key 0x... --cancels '[{\\"a\\":0,\\"o\\":12345}]'
+
+  # Update leverage
+  npx @nktkas/hyperliquid exchange updateLeverage --private-key 0x... --asset 0 --isCross true --leverage 5
+
+  # Withdraw funds
+  npx @nktkas/hyperliquid exchange withdraw3 --private-key 0x... --destination 0x... --amount "100.5"
+
+  # Send USD to another user
+  npx @nktkas/hyperliquid exchange usdSend --private-key 0x... --destination 0x... --amount "50.0"
+
+  # Create a vault
+  npx @nktkas/hyperliquid exchange createVault --private-key 0x... --name "My Vault" --description "Test vault" --initialUsd 1000`);
+}
+function findInArgv(types) {
+    // Convert to array if one type is passed in
+    const typeArray = Array.isArray(types) ? types : [types];
+    // Validation functions for each type
+    const validators = {
+        // to avoid converting them to numbers
+        hex: (value) => /^0[xX][0-9a-fA-F]+$/.test(value),
+        // to avoid converting them to strings
+        bool: (value) => /^(true|false)$/i.test(value),
+        // to avoid losing precision in fractional numbers
+        number: (value) => /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(value),
+        // to avoid converting them to booleans
+        empty: (value) => value === "",
+    };
+    const foundKeys = [];
+    for (let i = 0; i < process.argv.length; i++) {
+        const arg = process.argv[i];
+        // Processing format --key=value
+        if (arg.startsWith("--") && arg.includes("=")) {
+            const eqIndex = arg.indexOf("=");
+            const key = arg.slice(2, eqIndex);
+            const value = arg.slice(eqIndex + 1);
+            // Check value for all requested types
+            for (const type of typeArray) {
+                if (validators[type] && validators[type](value)) {
+                    foundKeys.push(key);
+                    break; // Don't add duplicates
+                }
+            }
+        } // Processing format --key value
+        else if (arg.startsWith("--") && i + 1 < process.argv.length) {
+            const nextArg = process.argv[i + 1];
+            const key = arg.slice(2);
+            // Check value for all requested types
+            for (const type of typeArray) {
+                if (validators[type] && validators[type](nextArg)) {
+                    foundKeys.push(key);
+                    break; // Don't add duplicates
+                }
+            }
+        }
+    }
+    return foundKeys;
+}
+const cliArgs = parseArgs(process.argv.slice(2), {
+    boolean: ["testnet", "offline", ...findInArgv("bool")],
+    string: ["_", ...findInArgv(["hex", "number", "empty"])],
+});
+const [endpoint, method] = cliArgs._;
+if (cliArgs.help || cliArgs.h || !endpoint || !method) {
+    printHelp();
+}
+else {
+    executeEndpointMethod(endpoint, method, cliArgs)
+        .then((result) => console.log(JSON.stringify(result)))
+        .catch((error) => console.error("Error:", error instanceof Error ? error.message : String(error)));
+}
+//# sourceMappingURL=cli.js.map

package/esm/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,SAAS,MAAM,UAAU,CAAC;AACjC,OAAO,OAAO,MAAM,cAAc,CAAC;AAMnC,mCAAmC;AACnC,SAAS,eAAe,CAAI,gBAA2C;IACnE,OAAO,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,SAAS,CAAC;SACxD,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE;QAC7B,IAAI,IAAI,KAAK,aAAa;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrF,OAAO,UAAU,EAAE,KAAK,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC;IACvE,CAAC,CAAqB,CAAC;AAC/B,CAAC;AACD,mCAAmC;AACnC,SAAS,aAAa,CAAI,gBAA2C,EAAE,MAAc;IACjF,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IACvD,mCAAmC;IACnC,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAa,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,MAA+B;IACpE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACpC,OAAO;gBACH,GAAG,MAAM;gBACT,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;aAClC,CAAC;QACN,CAAC;QACD,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;YAC9C,OAAO;gBACH,GAAG,MAAM;gBACT,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC;aACtD,CAAC;QACN,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACnB,OAAO;gBACH,GAAG,MAAM;gBACT,QAAQ,EAAE,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBACjD,UAAU,EAAE,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC;QACN,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YACrC,OAAO;gBACH,GAAG,MAAM;gBACT,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;aACpC,CAAC;QACN,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YAClB,OAAO;gBACH,GAAG,MAAM;gBACT,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;aACtC,CAAC;QACN,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACf,OAAO;gBACH,GAAG,MAAM;gBACT,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE;aAC9C,CAAC;QACN,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACjB,OAAO;gBACH,GAAG,MAAM;gBACT,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;gBAC3C,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,IAAI;aAC9D,CAAC;QACN,CAAC;QACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACpB,OAAO;gBACH,GAAG,MAAM;gBACT,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;aACxC,CAAC;QACN,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACjB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACvC,OAAO;gBACH,GAAG,MAAM;gBACT,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;aACxC,CAAC;QACN,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO;gBACH,GAAG,MAAM;gBACT,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACtC,CAAC;QACN,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACnB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO;gBACH,GAAG,MAAM;gBACT,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;aACtC,CAAC;QACN,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACjB,OAAO;gBACH,GAAG,MAAM;gBACT,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;aACpB,CAAC;QACN,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YACd,OAAO;gBACH,iBAAiB,EAAE;oBACf,GAAG,MAAM;iBACZ;aACJ,CAAC;QACN,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACf,OAAO;gBACH,IAAI,EAAE;oBACF,GAAG,MAAM;iBACZ;aACJ,CAAC;QACN,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACN,OAAO;gBACH,GAAG,MAAM;aACZ,CAAC;QACN,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,aAAa;IACI;IAAnB,YAAmB,SAAkB;QAAlB,cAAS,GAAT,SAAS,CAAS;IAAG,CAAC;IACzC,OAAO,CAAI,QAA0C,EAAE,OAAgB;QACnE,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;gBACvE,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,OAAO,EAAO,CAAC,CAAC,CAAC;gBAC7E,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAO,CAAC,CAAC,CAAC;gBACnE,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAO,CAAC,CAAC,CAAC;gBACpE,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAY,CAAC,CAAC,CAAC;IAC3D,CAAC;CACJ;AACD,MAAM,+BAAgC,SAAQ,EAAE,CAAC,cAAc;IAClD,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC;CAC3C;AAED,KAAK,UAAU,qBAAqB,CAChC,QAAgB,EAChB,MAAc,EACd,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;IACrD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1G,IAAI,MAAyC,CAAC;IAE9C,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,iCAAiC,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,GAAG,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,qCAAqC,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CACtB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAC5B,OAAO,CAAC,aAAa,CAAC,EACtB,EAAE,OAAO,EAAE,mEAAmE,EAAE,CACnF,CAAC;QACF,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe;QAC9C,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EACxC,OAAO,CAAC,KAAK,EACb,EAAE,OAAO,EAAE,wEAAwE,EAAE,CACxF,CAAC;QAEF,MAAM,GAAG,SAAS;YACd,CAAC,CAAC,IAAI,+BAA+B,CAAC;gBAClC,SAAS;gBACT,MAAM,EAAE,UAAU;gBAClB,mBAAmB,EAAE,YAAY;aACpC,CAAC;YACF,CAAC,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC;gBACpB,SAAS;gBACT,MAAM,EAAE,UAAU;gBAClB,mBAAmB,EAAE,YAAY;aACpC,CAAC,CAAC;IACX,CAAC;SAAM,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,6BAA6B,CAAC,CAAC;IAChF,CAAC;IAED,qCAAqC;IACrC,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,iDAAiD;AAEjD,SAAS,SAAS;IACd,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kIA0MkH,CAAC,CAAC;AACpI,CAAC;AAGD,SAAS,UAAU,CAAC,KAA0C;IAC1D,4CAA4C;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzD,qCAAqC;IACrC,MAAM,UAAU,GAAG;QACf,sCAAsC;QACtC,GAAG,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QACzD,sCAAsC;QACtC,IAAI,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QACtD,kDAAkD;QAClD,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC;QACvE,uCAAuC;QACvC,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE;KACzC,CAAC;IAEF,MAAM,SAAS,GAAG,EAAE,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE5B,gCAAgC;QAChC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAErC,sCAAsC;YACtC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9C,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpB,MAAM,CAAC,uBAAuB;gBAClC,CAAC;YACL,CAAC;QACL,CAAC,CAAC,gCAAgC;aAC7B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAEzB,sCAAsC;YACtC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpB,MAAM,CAAC,uBAAuB;gBAClC,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAC7C,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D,CAAC,CAAC;AACH,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAa,CAAC;AAEjD,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;IACpD,SAAS,EAAE,CAAC;AAChB,CAAC;KAAM,CAAC;IACJ,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;SAC3C,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;SACrD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC"}

package/{script/src/errors.d.ts → esm/src/_errors.d.ts}

@@ -2,4 +2,4 @@
 export declare class HyperliquidError extends Error {
     constructor(message?: string, options?: ErrorOptions);
 }
-//# sourceMappingURL=errors.d.ts.map
+//# sourceMappingURL=_errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_errors.d.ts","sourceRoot":"","sources":["../../src/src/_errors.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIvD"}

package/esm/src/{errors.js → _errors.js}

@@ -5,3 +5,4 @@ export class HyperliquidError extends Error {
         this.name = "HyperliquidError";
     }
 }
+//# sourceMappingURL=_errors.js.map