@nktkas/hyperliquid 0.25.8 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nktkas/hyperliquid",
-  "version": "0.25.8",
+  "version": "0.26.0",
   "description": "Unofficial Hyperliquid API SDK for all major JS runtimes, written in TypeScript.",
   "keywords": [
     "api",
@@ -8,7 +8,6 @@
     "sdk",
     "javascript",
     "typescript",
-    "crypto",
     "cryptocurrency",
     "trading",
     "blockchain",
@@ -17,63 +16,67 @@
     "dex",
     "hyperliquid"
   ],
-  "author": {
-    "name": "nktkas",
-    "email": "github.turk9@passmail.net",
-    "url": "https://github.com/nktkas"
-  },
   "homepage": "https://github.com/nktkas/hyperliquid",
+  "bugs": {
+    "url": "https://github.com/nktkas/hyperliquid/issues"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nktkas/hyperliquid.git"
   },
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/nktkas/hyperliquid/issues"
+  "author": {
+    "name": "nktkas",
+    "email": "github.turk9@passmail.net",
+    "url": "https://github.com/nktkas"
   },
-  "main": "./script/src/mod.js",
-  "module": "./esm/src/mod.js",
+  "sideEffects": false,
+  "type": "module",
   "exports": {
-    ".": {
-      "import": "./esm/src/mod.js",
-      "require": "./script/src/mod.js"
-    },
-    "./signing": {
-      "import": "./esm/src/signing/mod.js",
-      "require": "./script/src/signing/mod.js"
-    },
-    "./utils": {
-      "import": "./esm/src/utils/mod.js",
-      "require": "./script/src/utils/mod.js"
-    },
-    "./api/exchange": {
-      "import": "./esm/src/api/exchange/~mod.js",
-      "require": "./script/src/api/exchange/~mod.js"
-    },
-    "./api/info": {
-      "import": "./esm/src/api/info/~mod.js",
-      "require": "./script/src/api/info/~mod.js"
-    },
-    "./api/subscription": {
-      "import": "./esm/src/api/subscription/~mod.js",
-      "require": "./script/src/api/subscription/~mod.js"
-    }
+    ".": "./dist/src/mod.js",
+    "./signing": "./dist/src/signing/mod.js",
+    "./utils": "./dist/src/utils/mod.js",
+    "./api/exchange": "./dist/src/api/exchange/~mod.js",
+    "./api/info": "./dist/src/api/info/~mod.js",
+    "./api/subscription": "./dist/src/api/subscription/~mod.js"
   },
-  "scripts": {},
   "bin": {
-    "@nktkas/hyperliquid": "./esm/bin/cli.js"
+    "@nktkas/hyperliquid": "./dist/bin/cli.js"
   },
-  "engines": {
-    "node": ">=20.19.0"
+  "files": [
+    "dist",
+    "bin",
+    "src",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "npx tsc",
+    "fmt": "npx deno fmt && npx sort-package-json",
+    "lint": "npx deno lint",
+    "test": "npx deno test -A",
+    "typecheck": "npx deno check"
   },
-  "sideEffects": false,
   "dependencies": {
     "@henrygd/semaphore": "0.1.0",
-    "@msgpack/msgpack": "^3.1.2",
+    "@msgpack/msgpack": "3.1.2",
+    "@nktkas/rews": "^1.2.0",
     "@noble/hashes": "^2.0.1",
     "@noble/secp256k1": "^3.0.0",
-    "typescript-event-target": "1.1.1",
     "valibot": "1.1.0"
   },
-  "_generatedBy": "dnt@dev"
-}
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/ws": "^8.18.1",
+    "dotenv": "^17.2.3",
+    "ethers5": "npm:ethers@^5.8.0",
+    "ethers6": "npm:ethers@^6.15.0",
+    "typescript": "^5.9.3",
+    "viem": "^2.39.0",
+    "ws": "^8.18.3"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}

package/src/api/_base.ts

@@ -0,0 +1,159 @@
+// deno-lint-ignore-file no-explicit-any ban-types
+import * as v from "valibot";
+import { HyperliquidError } from "../_base.ts";
+
+// -------------------- Types --------------------
+
+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;
+
+// -------------------- 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 type UnsignedDecimal = v.InferOutput<typeof UnsignedDecimal>;
+
+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 type Decimal = v.InferOutput<typeof Decimal>;
+
+export const Integer = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([v.string(), v.number()]),
+    v.transform(Number),
+    v.number(),
+    v.integer(),
+    v.safeInteger(),
+  );
+})();
+export type Integer = v.InferOutput<typeof Integer>;
+
+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 type UnsignedInteger = v.InferOutput<typeof UnsignedInteger>;
+
+export const Hex = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.string(),
+    v.regex(/^0[xX][0-9a-fA-F]+$/),
+    v.transform((value) => value.toLowerCase() as `0x${string}`),
+  );
+})();
+export type Hex = v.InferOutput<typeof Hex>;
+
+export const Address = /* @__PURE__ */ (() => {
+  return v.pipe(Hex, v.length(42));
+})();
+export type Address = v.InferOutput<typeof Address>;
+
+export const TokenId = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.string(),
+    v.regex(/^[^:]+:0x[0-9a-fA-F]+$/),
+    v.transform((value) => value as `${string}:${Hex}`),
+  );
+})();
+export type TokenId = v.InferOutput<typeof TokenId>;
+
+export const Percent = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.string(),
+    v.regex(/^[0-9]+(\.[0-9]+)?%$/),
+    v.transform((value) => value as `${string}%`),
+  );
+})();
+export type Percent = v.InferOutput<typeof Percent>;
+
+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})?$/),
+  );
+})();
+export type ISO8601WithoutTimezone = v.InferOutput<typeof ISO8601WithoutTimezone>;
+
+/** Removes leading/trailing zeros from decimal string without precision loss. */
+function formatDecimal(numStr: string): string {
+  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: string) {
+    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<TSchema extends v.GenericSchema>(schema: TSchema): v.Parser<TSchema, undefined> {
+  const safeParser = v.safeParser(schema);
+  const parser = (input: unknown) => {
+    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;
+}