@nktkas/hyperliquid 0.25.9 → 0.27.0

package/dist/bin/cli.js

@@ -0,0 +1,299 @@
+#!/usr/bin/env node
+import process from "node:process";
+import * as v from "valibot";
+import * as hl from "../src/mod.js";
+import { parseArgs, transformArgs } from "./_utils.js";
+function transformParams(method, params) {
+    switch (method) {
+        case "spotUser": {
+            return { toggleSpotDusting: { ...params } };
+        }
+        case "twapOrder": {
+            return { twap: { ...params } };
+        }
+        default: {
+            return params;
+        }
+    }
+}
+class EchoTransport {
+    isTestnet;
+    constructor(isTestnet) {
+        this.isTestnet = isTestnet;
+    }
+    request(_, payload) {
+        return new Promise((resolve) => resolve({ status: "ok", response: payload }));
+    }
+}
+async function executeEndpointMethod(endpoint, method, args) {
+    const isTestnet = "testnet" in args;
+    const timeout = Number(args.timeout) || undefined;
+    const isOffline = "offline" in args;
+    const transport = isOffline ? new EchoTransport(isTestnet) : new hl.HttpTransport({ isTestnet, timeout });
+    let client;
+    if (endpoint === "info") {
+        client = new hl.InfoClient({ transport });
+        if (!(method in client)) {
+            throw new Error(`CLI does not support the "${method}" method in the "${endpoint}" endpoint`);
+        }
+    }
+    else if (endpoint === "exchange") {
+        const pk = v.parse(v.pipe(v.string(), v.hexadecimal()), args["private-key"], { message: 'Invalid format "private-key": Expected 32-byte hexadecimal string' });
+        delete args["private-key"]; // just in case
+        const defaultVaultAddress = v.parse(v.optional(v.pipe(v.string(), v.hexadecimal())), args.vault, { message: 'Invalid format "vault": Expected 20-byte hexadecimal string OR nothing' });
+        client = new hl.ExchangeClient({ transport, wallet: pk, defaultVaultAddress });
+        if (!(method in client)) {
+            throw new Error(`CLI does not support the "${method}" method in the "${endpoint}" endpoint`);
+        }
+    }
+    else {
+        throw new Error(`Invalid endpoint "${endpoint}". Use "info" or "exchange"`);
+    }
+    if (isOffline) {
+        // @ts-ignore - dynamic method access
+        const response = await client[method](transformParams(method, args));
+        return response.response;
+    }
+    else {
+        // @ts-ignore - dynamic method access
+        return await client[method](transformParams(method, args));
+    }
+}
+// ──────────────────── 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:
+  alignedQuoteTokenInfo   --token <number>
+  allMids                 [--dex <string>]
+  allPerpMetas            (no params)
+  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>]
+  l2Book                  --coin <string> [--nSigFigs <2|3|4|5>] [--mantissa <2|5>]
+  liquidatable            (no params)
+  marginTable             --id <number>
+  maxMarketOrderNtls      (no params)
+  meta                    [--dex <string>]
+  metaAndAssetCtxs        [--dex <string>]
+  perpDexLimits           --dex <string>
+  perpDexs                (no params)
+  perpsAtOpenInterestCap  [--dex <string>]
+  predictedFundings       (no params)
+  recentTrades            --coin <string>
+  spotMeta                (no params)
+  spotMetaAndAssetCtxs    (no params)
+
+User Account:
+  activeAssetData         --user <address> --coin <string>
+  clearinghouseState      --user <address> [--dex <string>]
+  extraAgents             --user <address>
+  isVip                   --user <address>
+  legalCheck              --user <address>
+  maxBuilderFee           --user <address> --builder <address>
+  portfolio               --user <address>
+  preTransferCheck        --user <address> --source <address>
+  referral                --user <address>
+  spotClearinghouseState  --user <address> [--dex <string>]
+  subAccounts             --user <address>
+  subAccounts2            --user <address>
+  userDexAbstraction      --user <address>
+  userFees                --user <address>
+  userFunding             --user <address> --startTime <number> [--endTime <number>]
+  userNonFundingLedgerUpdates  --user <address> --startTime <number> [--endTime <number>]
+  userRateLimit           --user <address>
+  userRole                --user <address>
+  userToMultiSigSigners   --user <address>
+  webData2                --user <address>
+
+Orders & TWAP & Position:
+  frontendOpenOrders      --user <address> [--dex <string>]
+  historicalOrders        --user <address>
+  openOrders              --user <address> [--dex <string>]
+  orderStatus             --user <address> --oid <number|hex>
+  twapHistory             --user <address>
+  userFills               --user <address> [--aggregateByTime <bool>]
+  userFillsByTime         --user <address> --startTime <number>
+                          [--endTime <number>] [--aggregateByTime <bool>]
+  userTwapSliceFills           --user <address>
+  userTwapSliceFillsByTime     --user <address> --startTime <number>
+                               [--endTime <number>] [--aggregateByTime <bool>]
+
+Delegation & Validators:
+  delegations             --user <address>
+  delegatorHistory        --user <address>
+  delegatorRewards        --user <address>
+  delegatorSummary        --user <address>
+  gossipRootIps           (no params)
+  validatorL1Votes        (no params)
+  validatorSummaries      (no params)
+
+Vault:
+  leadingVaults           --user <address>
+  userVaultEquities       --user <address>
+  vaultDetails            --vaultAddress <address> [--user <address>]
+  vaultSummaries          (no params)
+
+Deploy Market:
+  perpDeployAuctionStatus      (no params)
+  spotDeployState              --user <address>
+  spotPairDeployAuctionStatus  (no params)
+
+Other:
+  exchangeStatus          (no params)
+
+Transaction & Block Details:
+  blockDetails            --height <number>
+  tokenDetails            --tokenId <hex>
+  txDetails               --hash <hex>
+  userDetails             --user <address>
+
+=============================================================================
+EXCHANGE ENDPOINT METHODS
+=============================================================================
+
+Order & TWAP & Position:
+  batchModify             --modifies <json>
+  cancel                  --cancels <json>
+  cancelByCloid           --cancels <json>
+  modify                  --oid <number|hex> --order <json>
+  order                   --orders <json> [--grouping <na|normalTpsl|positionTpsl>] [--builder <json>]
+  scheduleCancel          [--time <number>]
+  twapCancel              --a <number> --t <number>
+  twapOrder               --a <number> --b <bool> --s <number> --r <bool> --m <number> --t <bool>
+  updateIsolatedMargin    --asset <number> --isBuy <bool> --ntli <number>
+  updateLeverage          --asset <number> --isCross <bool> --leverage <number>
+
+Account:
+  agentEnableDexAbstraction  (no params)
+  approveAgent            --agentAddress <address> [--agentName <string>]
+  approveBuilderFee       --maxFeeRate <number> --builder <address>
+  evmUserModify           --usingBigBlocks <bool>
+  noop                    (no params)
+  reserveRequestWeight    --weight <number>
+  setDisplayName          --displayName <string>
+  spotUser                --optOut <bool>
+  userDexAbstraction      --user <address> --enabled <bool>
+
+Fund Transfers:
+  sendAsset               --destination <address> --token <name:address> --amount <number>
+                          --sourceDex <string> --destinationDex <string> [--fromSubAccount <address>]
+  spotSend                --destination <address> --token <name:address> --amount <number>
+  usdClassTransfer        --amount <number> --toPerp <bool>
+  usdSend                 --destination <address> --amount <number>
+  withdraw3               --destination <address> --amount <number>
+
+Sub-Account:
+  createSubAccount        --name <string>
+  subAccountModify        --subAccountUser <address> --name <string>
+  subAccountSpotTransfer  --subAccountUser <address> --isDeposit <bool>
+                          --token <name:address> --amount <number>
+  subAccountTransfer      --subAccountUser <address> --isDeposit <bool> --usd <number>
+
+Referrer:
+  claimRewards            (no params)
+  registerReferrer        --code <string>
+  setReferrer             --code <string>
+
+Staking & Delegation:
+  cDeposit                --wei <number>
+  cWithdraw               --wei <number>
+  linkStakingUser         --user <address> --isFinalize <bool>
+  tokenDelegate           --validator <address> --wei <number> --isUndelegate <bool>
+
+Vault:
+  createVault             --name <string> --description <string> --initialUsd <number>
+  vaultDistribute         --vaultAddress <address> --usd <number>
+  vaultModify             --vaultAddress <address> [--allowDeposits <bool>]
+                          [--alwaysCloseOnWithdraw <bool>]
+  vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
+
+Deploy Market:
+  perpDeploy              --registerAsset <json> | --setOracle <json> | --setFundingMultipliers <json> |
+                          --haltTrading <json> | --setMarginTableIds <json> | --setFeeRecipient <json> |
+                          --setOpenInterestCaps <json> | --setSubDeployers <json> | --setFeeScale <json>
+  spotDeploy              --genesis <json> | --registerHyperliquidity <json> | --registerSpot <json> |
+                          --registerToken2 <json> | --setDeployerTradingFeeShare <json> | --userGenesis <json> |
+                          --enableQuoteToken <json>
+
+Validator Actions:
+  cSignerAction           --jailSelf null | --unjailSelf null
+  cValidatorAction        --changeProfile <json> | --register <json> | --unregister null
+  validatorL1Stream       --riskFreeRate <number>
+
+Other:
+  convertToMultiSigUser   --authorizedUsers <json> --threshold <number>
+
+=============================================================================
+
+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
+
+  # Create a vault
+  npx @nktkas/hyperliquid exchange createVault --private-key 0x... --name "My Vault" --description "Test vault" --initialUsd 1000`);
+}
+const rawArgs = parseArgs(process.argv.slice(2), {
+    flags: ["testnet", "help", "h", "offline"],
+});
+const args = transformArgs(rawArgs, {
+    number: "string",
+});
+const [endpoint, method] = args._;
+if (args.help || args.h || !endpoint || !method) {
+    printHelp();
+}
+else {
+    executeEndpointMethod(endpoint, method, args)
+        .then((result) => console.log(JSON.stringify(result)))
+        .catch((error) => console.error("Error:", error instanceof Error ? error.message : String(error)));
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/src/_base.d.ts.map

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

package/dist/src/_base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_base.js","sourceRoot":"","sources":["../../src/_base.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAgB,EAAE,OAAsB;QAClD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/src/api/_base.d.ts

@@ -0,0 +1,53 @@
+import * as v from "valibot";
+import { HyperliquidError } from "../_base.ts";
+export type MaybePromise<T> = T | Promise<T>;
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type DeepImmutable<T> = {
+    readonly [K in keyof T]: DeepImmutable<T[K]>;
+};
+export type OmitFirst<T extends readonly any[]> = T extends readonly [any, ...infer R] ? R : [];
+export type OverloadedParameters<T> = T extends {
+    (...args: infer A1): unknown;
+    (...args: infer A2): unknown;
+    (...args: infer A3): unknown;
+    (...args: infer A4): unknown;
+} ? A1 | A2 | A3 | A4 : T extends {
+    (...args: infer A1): unknown;
+    (...args: infer A2): unknown;
+    (...args: infer A3): unknown;
+} ? A1 | A2 | A3 : T extends {
+    (...args: infer A1): unknown;
+    (...args: infer A2): unknown;
+} ? A1 | A2 : T extends (...args: infer A) => unknown ? A : never;
+export declare const UnsignedDecimal: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>;
+export type UnsignedDecimal = v.InferOutput<typeof UnsignedDecimal>;
+export declare const Decimal: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, string>, v.StringSchema<undefined>, v.TrimAction, v.RegexAction<string, undefined>, v.TransformAction<string, string>]>;
+export type Decimal = v.InferOutput<typeof Decimal>;
+export declare const Integer: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>]>;
+export type Integer = v.InferOutput<typeof Integer>;
+export declare const UnsignedInteger: v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+export type UnsignedInteger = v.InferOutput<typeof UnsignedInteger>;
+export declare const Hex: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>;
+export type Hex = v.InferOutput<typeof Hex>;
+export declare const Address: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>;
+export type Address = v.InferOutput<typeof Address>;
+export declare const TokenId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `${string}:0x${string}`>]>;
+export type TokenId = v.InferOutput<typeof TokenId>;
+export declare const Percent: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `${string}%`>]>;
+export type Percent = v.InferOutput<typeof Percent>;
+export declare const ISO8601WithoutTimezone: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>;
+export type ISO8601WithoutTimezone = v.InferOutput<typeof ISO8601WithoutTimezone>;
+/** Thrown when validating invalid data.  */
+export declare class SchemaError extends HyperliquidError {
+    constructor(message: string);
+}
+/**
+ * Creates a valibot parser with summarized error messages.
+ * Used for validating, formatting, and sorting object keys for correct signature generation.
+ * @param schema - The valibot schema to validate against.
+ * @returns A parser function that validates input against the schema.
+ */
+export declare function parser<TSchema extends v.GenericSchema>(schema: TSchema): v.Parser<TSchema, undefined>;
+//# sourceMappingURL=_base.d.ts.map

package/dist/src/api/_base.d.ts.map

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

package/dist/src/api/_base.js

@@ -0,0 +1,67 @@
+// deno-lint-ignore-file no-explicit-any ban-types
+import * as v from "valibot";
+import { HyperliquidError } from "../_base.js";
+// ============================================================
+// API Schemas
+// ============================================================
+export const UnsignedDecimal = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([v.string(), v.number()]), v.transform(String), v.string(), v.trim(), v.regex(/^[0-9]+(\.[0-9]+)?$/), v.transform((value) => formatDecimal(value)));
+})();
+export const Decimal = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([v.string(), v.number()]), v.transform(String), v.string(), v.trim(), v.regex(/^-?[0-9]+(\.[0-9]+)?$/), v.transform((value) => formatDecimal(value)));
+})();
+export const Integer = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([v.string(), v.number()]), v.transform(Number), v.number(), v.integer(), v.safeInteger());
+})();
+export const UnsignedInteger = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([v.string(), v.number()]), v.transform(Number), v.number(), v.integer(), v.safeInteger(), v.minValue(0));
+})();
+export const Hex = /* @__PURE__ */ (() => {
+    return v.pipe(v.string(), v.regex(/^0[xX][0-9a-fA-F]+$/), v.transform((value) => value.toLowerCase()));
+})();
+export const Address = /* @__PURE__ */ (() => {
+    return v.pipe(Hex, v.length(42));
+})();
+export const TokenId = /* @__PURE__ */ (() => {
+    return v.pipe(v.string(), v.regex(/^[^:]+:0x[0-9a-fA-F]+$/), v.transform((value) => value));
+})();
+export const Percent = /* @__PURE__ */ (() => {
+    return v.pipe(v.string(), v.regex(/^[0-9]+(\.[0-9]+)?%$/), v.transform((value) => value));
+})();
+export const ISO8601WithoutTimezone = /* @__PURE__ */ (() => {
+    return v.pipe(v.string(), v.regex(/^\d{4}-(?:0[1-9]|1[0-2])-(?:[12]\d|0[1-9]|3[01])[T ](?:0\d|1\d|2[0-3])(?::[0-5]\d){2}(?:\.\d{1,9})?$/));
+})();
+/** Removes leading/trailing zeros from decimal string without precision loss. */
+function formatDecimal(numStr) {
+    return numStr
+        .trim()
+        .replace(/^(-?)0+(?=\d)/, "$1") // Remove leading zeros, keep sign
+        .replace(/(\.\d*?)0+$/, "$1") // Remove trailing zeros after decimal
+        .replace(/\.$/, ""); // Remove lone decimal point
+}
+/** Thrown when validating invalid data.  */
+export class SchemaError extends HyperliquidError {
+    constructor(message) {
+        super(message);
+        this.name = "SchemaError";
+    }
+}
+/**
+ * Creates a valibot parser with summarized error messages.
+ * Used for validating, formatting, and sorting object keys for correct signature generation.
+ * @param schema - The valibot schema to validate against.
+ * @returns A parser function that validates input against the schema.
+ */
+export function parser(schema) {
+    const safeParser = v.safeParser(schema);
+    const parser = (input) => {
+        const result = safeParser(input);
+        if (result.issues)
+            throw new SchemaError("\n" + v.summarize(result.issues));
+        return result.output;
+    };
+    parser.schema = schema;
+    parser.config = undefined;
+    return parser;
+}
+//# sourceMappingURL=_base.js.map

package/dist/src/api/_base.js.map

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