jcc_hyper_tool 0.1.1

package/dist/cli/util.js

@@ -0,0 +1,62 @@
+import { ConfigError } from "../core/errors.js";
+import { defaultTradeStateFilePath } from "../core/state/statePaths.js";
+export function getRootProgram(cmd) {
+    let c = cmd;
+    while (c.parent) {
+        c = c.parent;
+    }
+    return c;
+}
+export function readGlobalOptions(cmd) {
+    const root = getRootProgram(cmd);
+    const opts = root.opts();
+    return opts;
+}
+/**
+ * Pure resolver for tests and CLI helpers.
+ * Precedence: subcommand `--state-file` → root `--state-file` → env `JCC_HYPER_STATE_FILE` → default `~/.jcc_hyper_tool/trade-state.json`
+ */
+export function resolveTradeStatePathFromGlobals(globals, localStateFile, homeDir, envStateFile) {
+    if (globals.noState) {
+        return undefined;
+    }
+    const local = localStateFile?.trim();
+    if (local) {
+        return local;
+    }
+    const rootPath = globals.stateFile?.trim();
+    if (rootPath) {
+        return rootPath;
+    }
+    const fromEnv = envStateFile?.trim();
+    if (fromEnv) {
+        return fromEnv;
+    }
+    return defaultTradeStateFilePath(homeDir);
+}
+/**
+ * Resolved path for persisting trade state. Returns `undefined` when `--no-state` is set on the root command.
+ * Precedence: `localStateFile` (subcommand `--state-file`) → root `--state-file` → env `JCC_HYPER_STATE_FILE` → default ~/.jcc_hyper_tool/trade-state.json
+ */
+export function resolveTradeStatePath(cmd, localStateFile) {
+    const globals = readGlobalOptions(cmd);
+    return resolveTradeStatePathFromGlobals(globals, localStateFile, undefined, process.env.JCC_HYPER_STATE_FILE);
+}
+export function requireStateCliEnabled(cmd, hint) {
+    const globals = readGlobalOptions(cmd);
+    if (globals.noState) {
+        throw new ConfigError(`--no-state cannot be used with ${hint}.`);
+    }
+}
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function logVerbose(cmd, message) {
+    const o = readGlobalOptions(cmd);
+    if (o.verbose) {
+        process.stderr.write(`${message}\n`);
+    }
+}
+/** HIP-3 `deployer:ASSET` → infer `/info` meta `dex` (substring before `:`). */
+export { inferHlDexFromPrefixedPerpCoin as inferHlDexFromPrefixedCoin } from "../core/hyperliquid/prefixedPerpCoin.js";
+//# sourceMappingURL=util.js.map

package/dist/cli/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/cli/util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,CAAC,GAAY,GAAG,CAAC;IACrB,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACf,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAoB,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAwD,EACxD,cAAmC,EACnC,OAAgB,EAChB,YAAiC;IAEjC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAY,EACZ,cAAmC;IAEnC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,gCAAgC,CACrC,OAAO,EACP,cAAc,EACd,SAAS,EACT,OAAO,CAAC,GAAG,CAAC,oBAAoB,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAY,EAAE,IAAY;IAC/D,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,WAAW,CAAC,kCAAkC,IAAI,GAAG,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,OAAe;IACtD,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,OAAO,EAAE,8BAA8B,IAAI,0BAA0B,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+declare const NetworkSchema: z.ZodEnum<["mainnet", "testnet"]>;
+export type EffectiveConfig = {
+    network: z.infer<typeof NetworkSchema>;
+    infoOrigin: string;
+    /** Resolved user wallet for HL account queries — never the agent mismatch per docs unless explicitly set via address env. */
+    userAddress?: `0x${string}`;
+    /** True when HYPERLIQUID_PRIVATE_KEY / alias was present and parsed. */
+    hasPrivateKey: boolean;
+};
+export type ResolvedUserContext = Pick<EffectiveConfig, "network" | "infoOrigin"> & {
+    userAddress: `0x${string}`;
+};
+export declare function parseNetwork(raw: unknown): z.infer<typeof NetworkSchema>;
+export declare function normalizeInfoOrigin(network: z.infer<typeof NetworkSchema>, apiUrl?: string): string;
+/**
+ * Loads effective configuration from env + CLI overrides.
+ * Env knobs: JCC_HYPER_NETWORK, JCC_HYPER_API_URL / HYPERLIQUID_API_URL, HYPERLIQUID_PRIVATE_KEY /
+ * JCC_HYPER_WALLET_PRIVATE_KEY, HYPERLIQUID_ADDRESS / JCC_HYPER_WALLET_ADDRESS.
+ * Trade-state default path (when CLI omits --state-file): JCC_HYPER_STATE_FILE, resolved in resolveTradeStatePath.
+ * Does not read ".env" files — use your shell / direnv / dotenv in dev if needed.
+ */
+export declare function loadEffectiveConfig(opts: {
+    env?: NodeJS.ProcessEnv;
+    network?: string;
+    apiUrl?: string;
+}): EffectiveConfig;
+/** Requires a user address (from private key or explicit env) for account-scoped calls. */
+export declare function requireUserContext(cfg: EffectiveConfig): ResolvedUserContext;
+export declare function printEffectiveConfig(cfg: EffectiveConfig): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,QAAA,MAAM,aAAa,mCAAiC,CAAC;AAWrD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,6HAA6H;IAC7H,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG;IAClF,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAMxE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAoBR;AAuBD;;;;;;GAMG;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,eAAe,CA4BlB;AAED,2FAA2F;AAE3F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,mBAAmB,CAW5E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAQjE"}

package/dist/core/config.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { ConfigError } from "./errors.js";
+import { addressFromPrivateKey } from "./wallet.js";
+const NetworkSchema = z.enum(["mainnet", "testnet"]);
+const DEFAULT_BASE = {
+    mainnet: "https://api.hyperliquid.xyz",
+    testnet: "https://api.hyperliquid-testnet.xyz",
+};
+function isEthereumAddress(raw) {
+    return /^0x[a-fA-F0-9]{40}$/.test(raw);
+}
+export function parseNetwork(raw) {
+    const v = NetworkSchema.safeParse(raw);
+    if (!v.success) {
+        throw new ConfigError(`Invalid network. Expected mainnet | testnet, got: ${String(raw)}`);
+    }
+    return v.data;
+}
+export function normalizeInfoOrigin(network, apiUrl) {
+    const base = DEFAULT_BASE[network];
+    if (!apiUrl) {
+        return base;
+    }
+    try {
+        const parsed = new URL(apiUrl);
+        /**
+         * If user passes ".../info" by mistake, trim to origin.
+         * If they pass ".../anything", we'll still normalize to `${origin}`.
+         */
+        const origin = parsed.protocol === "https:" || parsed.protocol === "http:" ? parsed.origin : base;
+        return origin;
+    }
+    catch {
+        throw new ConfigError(`Invalid --api-url / api URL: "${apiUrl}"`);
+    }
+}
+function readOptionalPrivateKey(env) {
+    const raw = env.JCC_HYPER_WALLET_PRIVATE_KEY ?? env.HYPERLIQUID_PRIVATE_KEY;
+    if (!raw) {
+        return undefined;
+    }
+    return raw;
+}
+function readOptionalAddress(env) {
+    const raw = env.JCC_HYPER_WALLET_ADDRESS ?? env.HYPERLIQUID_ADDRESS;
+    if (!raw) {
+        return undefined;
+    }
+    if (!isEthereumAddress(raw.trim())) {
+        throw new ConfigError(`Invalid JCC_HYPER_WALLET_ADDRESS / HYPERLIQUID_ADDRESS: expected 0x + 40 hex chars`);
+    }
+    return raw.trim();
+}
+/**
+ * Loads effective configuration from env + CLI overrides.
+ * Env knobs: JCC_HYPER_NETWORK, JCC_HYPER_API_URL / HYPERLIQUID_API_URL, HYPERLIQUID_PRIVATE_KEY /
+ * JCC_HYPER_WALLET_PRIVATE_KEY, HYPERLIQUID_ADDRESS / JCC_HYPER_WALLET_ADDRESS.
+ * Trade-state default path (when CLI omits --state-file): JCC_HYPER_STATE_FILE, resolved in resolveTradeStatePath.
+ * Does not read ".env" files — use your shell / direnv / dotenv in dev if needed.
+ */
+export function loadEffectiveConfig(opts) {
+    const env = opts.env ?? process.env;
+    const network = parseNetwork(opts.network ?? env.JCC_HYPER_NETWORK ?? "mainnet");
+    const infoOrigin = normalizeInfoOrigin(network, opts.apiUrl ?? env.JCC_HYPER_API_URL ?? env.HYPERLIQUID_API_URL);
+    const pk = readOptionalPrivateKey(env);
+    const explicitAddress = readOptionalAddress(env);
+    if (explicitAddress && pk) {
+        const derived = addressFromPrivateKey(pk);
+        if (derived.toLowerCase() !== explicitAddress.toLowerCase()) {
+            throw new ConfigError(`Private key address ${derived} does not match JCC_HYPER_WALLET_ADDRESS / HYPERLIQUID_ADDRESS ${explicitAddress}`);
+        }
+    }
+    const userAddress = explicitAddress ?? (pk ? addressFromPrivateKey(pk) : undefined);
+    return {
+        network,
+        infoOrigin,
+        userAddress,
+        hasPrivateKey: Boolean(pk),
+    };
+}
+/** Requires a user address (from private key or explicit env) for account-scoped calls. */
+export function requireUserContext(cfg) {
+    if (!cfg.userAddress) {
+        throw new ConfigError("Missing wallet context. Set HYPERLIQUID_PRIVATE_KEY or JCC_HYPER_WALLET_PRIVATE_KEY (or HYPERLIQUID_ADDRESS / JCC_HYPER_WALLET_ADDRESS for read-only account queries).");
+    }
+    return {
+        network: cfg.network,
+        infoOrigin: cfg.infoOrigin,
+        userAddress: cfg.userAddress,
+    };
+}
+export function printEffectiveConfig(cfg) {
+    const lines = [
+        `network: ${cfg.network}`,
+        `infoOrigin: ${cfg.infoOrigin}`,
+        `hasPrivateKey: ${cfg.hasPrivateKey ? "yes" : "no"}`,
+        `userAddress: ${cfg.userAddress ?? "(not set)"}`,
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class HyperliquidApiError extends Error {
+    readonly status: number;
+    readonly bodyText: string;
+    constructor(message: string, status: number, bodyText: string);
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAM9D;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/errors.js

@@ -0,0 +1,17 @@
+export class HyperliquidApiError extends Error {
+    status;
+    bodyText;
+    constructor(message, status, bodyText) {
+        super(message);
+        this.name = "HyperliquidApiError";
+        this.status = status;
+        this.bodyText = bodyText;
+    }
+}
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,MAAM,CAAS;IACf,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,MAAc,EAAE,QAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/core/hyperliquid/asset.d.ts

@@ -0,0 +1,24 @@
+export declare function encodeBuilderDeployedPerpAssetId(perpDexIndex: number, indexInMeta: number): number;
+/** Resolve perp `"coin"` symbols (BTC, ETH, HIP-3 `xyz:...`) to HL `universe` indices from `meta` info payload. */
+export declare function perpCoinToAssetIndex(meta: unknown, coin: string): number;
+/** Sorted unique `universe[].name` strings from a `meta` info payload (HIP-3 rows look like `xyz:CL`). */
+export declare function extractPerpUniverseCoinNames(meta: unknown): string[];
+/**
+ * Map `/info` `perpDexs` list (index 0 is `null` = native HL perp dex) to the `perp_dex_index`
+ * used in builder asset encoding.
+ */
+export declare function perpDexIndexFromList(perpDexs: unknown, dexName: string): number;
+/**
+ * Integer `asset` for `/exchange` perp order actions.
+ * - Default / native perp dex (no `dex`): same as index in `meta.universe` (e.g. BTC often 0).
+ * - Builder-deployed dex: `100000 + perp_dex_index * 10000 + index_in_meta`.
+ */
+export declare function perpCoinToExchangeAssetId(opts: {
+    coin: string;
+    meta: unknown;
+    /** When set, selects a builder dex; native dex is `meta()` without `dex` and no encoding offset. */
+    dex: string | undefined;
+    /** From `POST { type: "perpDexs" }` — required when `dex` is set. */
+    perpDexs?: unknown;
+}): number;
+//# sourceMappingURL=asset.d.ts.map

package/dist/core/hyperliquid/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/asset.ts"],"names":[],"mappings":"AAMA,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,mHAAmH;AAEnH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxE;AAED,0GAA0G;AAE1G,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAmBpE;AAED;;;GAGG;AAEH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB/E;AAED;;;;GAIG;AAEH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,oGAAoG;IACpG,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAaT"}

package/dist/core/hyperliquid/asset.js

@@ -0,0 +1,88 @@
+import { ConfigError } from "../errors.js";
+/** HL builder-deployed perp asset IDs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids */
+const BUILDER_PERP_BASE = 100_000;
+const BUILDER_PERP_STRIDE = 10_000;
+export function encodeBuilderDeployedPerpAssetId(perpDexIndex, indexInMeta) {
+    return BUILDER_PERP_BASE + perpDexIndex * BUILDER_PERP_STRIDE + indexInMeta;
+}
+/** Resolve perp `"coin"` symbols (BTC, ETH, HIP-3 `xyz:...`) to HL `universe` indices from `meta` info payload. */
+export function perpCoinToAssetIndex(meta, coin) {
+    if (typeof meta !== "object" || meta === null) {
+        throw new ConfigError(`Unexpected meta response while resolving coin '${coin}'.`);
+    }
+    const u = meta.universe;
+    if (!Array.isArray(u)) {
+        throw new ConfigError(`Unexpected meta.universe shape while resolving '${coin}'.`);
+    }
+    for (let i = 0; i < u.length; i++) {
+        const row = u[i];
+        if (typeof row !== "object" || row === null) {
+            continue;
+        }
+        const name = row.name;
+        if (name === coin) {
+            return i;
+        }
+    }
+    throw new ConfigError(`Unknown perp universe coin '${coin}'. Try 'perp meta' to inspect names.`);
+}
+/** Sorted unique `universe[].name` strings from a `meta` info payload (HIP-3 rows look like `xyz:CL`). */
+export function extractPerpUniverseCoinNames(meta) {
+    if (typeof meta !== "object" || meta === null) {
+        return [];
+    }
+    const u = meta.universe;
+    if (!Array.isArray(u)) {
+        return [];
+    }
+    const names = [];
+    for (const row of u) {
+        if (typeof row !== "object" || row === null) {
+            continue;
+        }
+        const name = row.name;
+        if (typeof name === "string" && name.length > 0) {
+            names.push(name);
+        }
+    }
+    return [...new Set(names)].sort();
+}
+/**
+ * Map `/info` `perpDexs` list (index 0 is `null` = native HL perp dex) to the `perp_dex_index`
+ * used in builder asset encoding.
+ */
+export function perpDexIndexFromList(perpDexs, dexName) {
+    if (!Array.isArray(perpDexs)) {
+        throw new ConfigError("Unexpected perpDexs response shape.");
+    }
+    const want = dexName.trim();
+    for (let i = 0; i < perpDexs.length; i++) {
+        const row = perpDexs[i];
+        if (row === null || typeof row !== "object") {
+            continue;
+        }
+        const name = row.name;
+        if (name === want) {
+            return i;
+        }
+    }
+    throw new ConfigError(`Unknown perp dex '${want}'. Try perpDexs / perp meta.`);
+}
+/**
+ * Integer `asset` for `/exchange` perp order actions.
+ * - Default / native perp dex (no `dex`): same as index in `meta.universe` (e.g. BTC often 0).
+ * - Builder-deployed dex: `100000 + perp_dex_index * 10000 + index_in_meta`.
+ */
+export function perpCoinToExchangeAssetId(opts) {
+    const indexInMeta = perpCoinToAssetIndex(opts.meta, opts.coin);
+    const d = opts.dex?.trim();
+    if (!d) {
+        return indexInMeta;
+    }
+    if (opts.perpDexs === undefined || opts.perpDexs === null) {
+        throw new ConfigError("perpDexs is required when resolving a builder-deployed perp asset id (dex is set).");
+    }
+    const perpDexIdx = perpDexIndexFromList(opts.perpDexs, d);
+    return encodeBuilderDeployedPerpAssetId(perpDexIdx, indexInMeta);
+}
+//# sourceMappingURL=asset.js.map

package/dist/core/hyperliquid/asset.js.map

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

package/dist/core/hyperliquid/candles.d.ts

@@ -0,0 +1,24 @@
+/** Official `candleSnapshot` `req.interval` values (matches HL WS candle subscription set). */
+export declare const HL_CANDLE_INTERVALS: readonly ["1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M"];
+export type HlCandleInterval = (typeof HL_CANDLE_INTERVALS)[number];
+export declare function parseCandleInterval(raw: string): HlCandleInterval;
+export declare function parsePositiveIntMs(raw: string, label: string): number;
+export declare function assertKlineTimeOrder(startMs: number, endMs: number): void;
+export type ValidatedKlineReq = {
+    interval: HlCandleInterval;
+    startTime: number;
+    endTime: number;
+};
+/**
+ * Default history length when `--start-time` / `--end-time` are omitted.
+ * Tuned so bar counts stay reasonable for HL API (emphasis: 5m ≈ 1 交易日日内、1h ≈ 一月、1d ≈ 一年).
+ */
+export declare function defaultLookbackMs(interval: HlCandleInterval): number;
+/**
+ * Resolve interval + time range: either explicit `--start-time` & `--end-time`, or defaults (end = now).
+ */
+export declare function resolveKlineRequest(intervalRaw: string, timeOpts: {
+    startTime?: string;
+    endTime?: string;
+}, nowMs: number): ValidatedKlineReq;
+//# sourceMappingURL=candles.d.ts.map

package/dist/core/hyperliquid/candles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candles.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/candles.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,kGAetB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAQjE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAmCpE;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,KAAK,EAAE,MAAM,GACZ,iBAAiB,CA2BnB"}

package/dist/core/hyperliquid/candles.js

@@ -0,0 +1,113 @@
+import { ConfigError } from "../errors.js";
+/** Official `candleSnapshot` `req.interval` values (matches HL WS candle subscription set). */
+export const HL_CANDLE_INTERVALS = [
+    "1m",
+    "3m",
+    "5m",
+    "15m",
+    "30m",
+    "1h",
+    "2h",
+    "4h",
+    "8h",
+    "12h",
+    "1d",
+    "3d",
+    "1w",
+    "1M",
+];
+const INTERVAL_SET = new Set(HL_CANDLE_INTERVALS);
+export function parseCandleInterval(raw) {
+    const s = raw.trim();
+    if (!INTERVAL_SET.has(s)) {
+        throw new ConfigError(`Invalid --interval '${raw}'. Allowed: ${HL_CANDLE_INTERVALS.join(", ")}`);
+    }
+    return s;
+}
+export function parsePositiveIntMs(raw, label) {
+    const trimmed = raw.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        throw new ConfigError(`${label} must be a positive integer (milliseconds as digits only).`);
+    }
+    const n = Number(trimmed);
+    if (!Number.isSafeInteger(n) || n <= 0) {
+        throw new ConfigError(`${label} must be a positive integer milliseconds.`);
+    }
+    return n;
+}
+export function assertKlineTimeOrder(startMs, endMs) {
+    if (startMs > endMs) {
+        throw new ConfigError(`--start-time must be <= --end-time (got ${startMs} > ${endMs}).`);
+    }
+}
+const MINUTE_MS = 60_000;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+/**
+ * Default history length when `--start-time` / `--end-time` are omitted.
+ * Tuned so bar counts stay reasonable for HL API (emphasis: 5m ≈ 1 交易日日内、1h ≈ 一月、1d ≈ 一年).
+ */
+export function defaultLookbackMs(interval) {
+    switch (interval) {
+        case "1m":
+            return 1 * DAY_MS;
+        case "3m":
+            return 2 * DAY_MS;
+        case "5m":
+            return 1 * DAY_MS;
+        case "15m":
+            return 7 * DAY_MS;
+        case "30m":
+            return 14 * DAY_MS;
+        case "1h":
+            return 30 * DAY_MS;
+        case "2h":
+            return 45 * DAY_MS;
+        case "4h":
+            return 90 * DAY_MS;
+        case "8h":
+            return 180 * DAY_MS;
+        case "12h":
+            return 270 * DAY_MS;
+        case "1d":
+            return 365 * DAY_MS;
+        case "3d":
+            return 3 * 365 * DAY_MS;
+        case "1w":
+            return 2 * 365 * DAY_MS;
+        case "1M":
+            return 5 * 365 * DAY_MS;
+        default: {
+            const _exhaustive = interval;
+            return _exhaustive;
+        }
+    }
+}
+function isProvided(raw) {
+    return raw !== undefined && raw.trim() !== "";
+}
+/**
+ * Resolve interval + time range: either explicit `--start-time` & `--end-time`, or defaults (end = now).
+ */
+export function resolveKlineRequest(intervalRaw, timeOpts, nowMs) {
+    const interval = parseCandleInterval(intervalRaw);
+    const hasStart = isProvided(timeOpts.startTime);
+    const hasEnd = isProvided(timeOpts.endTime);
+    if (hasStart !== hasEnd) {
+        throw new ConfigError("请同时传入 --start-time 与 --end-time，或两者都不传以使用按周期自动计算的默认时间范围。");
+    }
+    if (hasStart && hasEnd) {
+        const startTime = parsePositiveIntMs(timeOpts.startTime, "--start-time");
+        const endTime = parsePositiveIntMs(timeOpts.endTime, "--end-time");
+        assertKlineTimeOrder(startTime, endTime);
+        return { interval, startTime, endTime };
+    }
+    const endTime = nowMs;
+    const startTime = endTime - defaultLookbackMs(interval);
+    if (!Number.isSafeInteger(startTime) || startTime <= 0) {
+        throw new ConfigError("默认起始时间无效（当前时间过小）；请显式传入 --start-time / --end-time。");
+    }
+    assertKlineTimeOrder(startTime, endTime);
+    return { interval, startTime, endTime };
+}
+//# sourceMappingURL=candles.js.map

package/dist/core/hyperliquid/candles.js.map

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

package/dist/core/hyperliquid/client.d.ts

@@ -0,0 +1,36 @@
+import type { JsonValue } from "./types.js";
+export type FetchLike = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+export type InfoRequestBody = Record<string, unknown>;
+export declare class HyperliquidInfoClient {
+    private readonly fetchImpl;
+    readonly infoUrl: string;
+    constructor(opts: {
+        infoOrigin: string;
+        fetchImpl?: FetchLike;
+    });
+    info(body: InfoRequestBody): Promise<JsonValue>;
+    meta(dex?: string): Promise<JsonValue>;
+    perpDexs(): Promise<JsonValue>;
+    allMids(dex?: string): Promise<JsonValue>;
+    clearinghouseState(user: `0x${string}`, dex?: string): Promise<JsonValue>;
+    openOrders(user: `0x${string}`, dex?: string): Promise<JsonValue>;
+    /** Recent user fills (per HL API caps). Optional `aggregateByTime` merges partials. */
+    userFills(user: `0x${string}`, opts?: {
+        aggregateByTime?: boolean;
+    }): Promise<JsonValue>;
+    l2Book(coin: string, opts?: {
+        nSigFigs?: number;
+        mantissa?: number;
+    }): Promise<JsonValue>;
+    /**
+     * OHLCV candle snapshot. Response shape is API-defined (typically array of objects with
+     * `t,T,s,i,o,h,l,c,v,n`); numeric precision is preserved when those fields are strings.
+     */
+    candleSnapshot(params: {
+        coin: string;
+        interval: string;
+        startTime: number;
+        endTime: number;
+    }): Promise<JsonValue>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/hyperliquid/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,EACxC,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE;IAMzD,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAkCrD,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAItC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAI9B,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIzC,kBAAkB,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQzE,UAAU,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAMjE,uFAAuF;IACvF,SAAS,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAQxF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAWzF;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,SAAS,CAAC;CAWvB"}