jcc_hyper_tool 0.1.1

package/dist/core/hyperliquid/client.js

@@ -0,0 +1,92 @@
+import { HyperliquidApiError } from "../errors.js";
+export class HyperliquidInfoClient {
+    fetchImpl;
+    infoUrl;
+    constructor(opts) {
+        const origin = opts.infoOrigin.replace(/\/+$/, "");
+        this.infoUrl = `${origin}/info`;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async info(body) {
+        let res;
+        try {
+            res = await this.fetchImpl(this.infoUrl, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            throw new HyperliquidApiError(`Network error calling POST ${this.infoUrl}: ${msg}`, 0, "");
+        }
+        const text = await res.text();
+        let parsed;
+        if (text.length > 0) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                throw new HyperliquidApiError(`Non-JSON response (${res.status})`, res.status, text);
+            }
+        }
+        if (!res.ok) {
+            throw new HyperliquidApiError(`HTTP ${res.status} POST ${this.infoUrl}`, res.status, text);
+        }
+        return parsed ?? null;
+    }
+    meta(dex) {
+        return this.info(dex !== undefined ? { type: "meta", dex } : { type: "meta" });
+    }
+    perpDexs() {
+        return this.info({ type: "perpDexs" });
+    }
+    allMids(dex) {
+        return this.info(dex !== undefined ? { type: "allMids", dex } : { type: "allMids" });
+    }
+    clearinghouseState(user, dex) {
+        return this.info(dex !== undefined
+            ? { type: "clearinghouseState", user, dex }
+            : { type: "clearinghouseState", user });
+    }
+    openOrders(user, dex) {
+        return this.info(dex !== undefined ? { type: "openOrders", user, dex } : { type: "openOrders", user });
+    }
+    /** Recent user fills (per HL API caps). Optional `aggregateByTime` merges partials. */
+    userFills(user, opts) {
+        const body = { type: "userFills", user };
+        if (opts?.aggregateByTime !== undefined) {
+            body.aggregateByTime = opts.aggregateByTime;
+        }
+        return this.info(body);
+    }
+    l2Book(coin, opts) {
+        const body = { type: "l2Book", coin };
+        if (opts?.nSigFigs !== undefined) {
+            body.nSigFigs = opts.nSigFigs;
+        }
+        if (opts?.mantissa !== undefined) {
+            body.mantissa = opts.mantissa;
+        }
+        return this.info(body);
+    }
+    /**
+     * 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) {
+        return this.info({
+            type: "candleSnapshot",
+            req: {
+                coin: params.coin,
+                interval: params.interval,
+                startTime: params.startTime,
+                endTime: params.endTime,
+            },
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { JsonValue } from "./types.js";
+import type { FetchLike } from "./client.js";
+export type SignedExchangeEnvelope = Record<string, unknown>;
+export type ExchangePostBody = SignedExchangeEnvelope;
+export declare class HyperliquidExchangeClient {
+    private readonly fetchImpl;
+    readonly exchangeUrl: string;
+    constructor(opts: {
+        apiOrigin: string;
+        fetchImpl?: FetchLike;
+    });
+    exchange(body: ExchangePostBody): Promise<JsonValue>;
+}
+//# sourceMappingURL=exchange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEtD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAA;KAAE;IAMxD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;CAyC3D"}

package/dist/core/hyperliquid/exchange.js

@@ -0,0 +1,42 @@
+import { HyperliquidApiError } from "../errors.js";
+export class HyperliquidExchangeClient {
+    fetchImpl;
+    exchangeUrl;
+    constructor(opts) {
+        const origin = opts.apiOrigin.replace(/\/+$/, "");
+        this.exchangeUrl = `${origin}/exchange`;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async exchange(body) {
+        let res;
+        try {
+            res = await this.fetchImpl(this.exchangeUrl, {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            throw new HyperliquidApiError(`Network error POST ${this.exchangeUrl}: ${msg}`, 0, "");
+        }
+        const text = await res.text();
+        let parsed;
+        if (text.length > 0) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                throw new HyperliquidApiError(`Non-JSON exchange response (${res.status})`, res.status, text);
+            }
+        }
+        if (!res.ok) {
+            throw new HyperliquidApiError(`HTTP ${res.status} POST ${this.exchangeUrl}`, res.status, text);
+        }
+        return parsed ?? null;
+    }
+}
+//# sourceMappingURL=exchange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchange.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMnD,MAAM,OAAO,yBAAyB;IACnB,SAAS,CAAY;IAC7B,WAAW,CAAS;IAE7B,YAAY,IAAkD;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,GAAG,MAAM,WAAW,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAsB;QACnC,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC3C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,IAAI,mBAAmB,CAAC,sBAAsB,IAAI,CAAC,WAAW,KAAK,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAE9B,IAAI,MAA6B,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,mBAAmB,CAC3B,+BAA+B,GAAG,CAAC,MAAM,GAAG,EAC5C,GAAG,CAAC,MAAM,EACV,IAAI,CACL,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,mBAAmB,CAC3B,QAAQ,GAAG,CAAC,MAAM,SAAS,IAAI,CAAC,WAAW,EAAE,EAC7C,GAAG,CAAC,MAAM,EACV,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;CACF"}

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

@@ -0,0 +1,7 @@
+import type { JsonValue } from "./types.js";
+/**
+ * Best-effort extraction of HL order ids from /exchange JSON responses.
+ * Shapes vary; callers should reconcile with openOrders when unsure.
+ */
+export declare function extractOrderOidsFromExchangeResponse(resp: JsonValue): number[];
+//# sourceMappingURL=exchangeParse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exchangeParse.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchangeParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkB5C;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAuB9E"}

package/dist/core/hyperliquid/exchangeParse.js

@@ -0,0 +1,44 @@
+function collectOidsFromStatusEntry(entry, out) {
+    if (typeof entry !== "object" || entry === null) {
+        return;
+    }
+    const rec = entry;
+    for (const k of ["resting", "filled", "triggered"]) {
+        const inner = rec[k];
+        if (typeof inner === "object" && inner !== null) {
+            const oid = inner.oid;
+            if (typeof oid === "number" && Number.isFinite(oid)) {
+                out.push(oid);
+            }
+        }
+    }
+}
+/**
+ * Best-effort extraction of HL order ids from /exchange JSON responses.
+ * Shapes vary; callers should reconcile with openOrders when unsure.
+ */
+export function extractOrderOidsFromExchangeResponse(resp) {
+    const out = [];
+    if (typeof resp !== "object" || resp === null) {
+        return out;
+    }
+    const root = resp;
+    const response = root.response;
+    if (typeof response !== "object" || response === null) {
+        return out;
+    }
+    const type = response.type;
+    const data = response.data;
+    if (type !== "order" || typeof data !== "object" || data === null) {
+        return out;
+    }
+    const statuses = data.statuses;
+    if (!Array.isArray(statuses)) {
+        return out;
+    }
+    for (const s of statuses) {
+        collectOidsFromStatusEntry(s, out);
+    }
+    return out;
+}
+//# sourceMappingURL=exchangeParse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exchangeParse.js","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchangeParse.ts"],"names":[],"mappings":"AAEA,SAAS,0BAA0B,CAAC,KAAc,EAAE,GAAa;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,GAAG,GAAI,KAAiC,CAAC,GAAG,CAAC;YACnD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,IAAe;IAClE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAG,IAA+B,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAI,QAAoC,CAAC,IAAI,CAAC;IACxD,MAAM,IAAI,GAAI,QAAoC,CAAC,IAAI,CAAC;IACxD,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,QAAQ,GAAI,IAAgC,CAAC,QAAQ,CAAC;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,0BAA0B,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Mirrors hyperliquid-python-sdk `float_to_wire` reasonably closely:
+ * `f"{x:.8f}"`, reject drift, trim trailing zeros without scientific notation.
+ */
+export declare function floatToWire(x: number): string;
+//# sourceMappingURL=float.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"float.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/float.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB7C"}

package/dist/core/hyperliquid/float.js

@@ -0,0 +1,24 @@
+/**
+ * Mirrors hyperliquid-python-sdk `float_to_wire` reasonably closely:
+ * `f"{x:.8f}"`, reject drift, trim trailing zeros without scientific notation.
+ */
+export function floatToWire(x) {
+    let rounded = x.toFixed(8);
+    if (Math.abs(parseFloat(rounded) - x) >= 1e-12) {
+        throw new Error(`float_to_wire causes rounding (${x})`);
+    }
+    if (rounded === "-0.00000000") {
+        rounded = "0.00000000";
+    }
+    let s = rounded;
+    if (!s.includes(".")) {
+        return s;
+    }
+    s = s.replace(/(\.\d*?[1-9])0+$/, "$1");
+    s = s.replace(/\.0+$/, "");
+    if (s === "" || s === "-0") {
+        return "0";
+    }
+    return s;
+}
+//# sourceMappingURL=float.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"float.js","sourceRoot":"","sources":["../../../src/core/hyperliquid/float.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,OAAO,GAAG,YAAY,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,OAAO,CAAC;IAEhB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE3B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * `/info` candleSnapshot has no separate `dex` field — only `req.coin`. Combine `--dex` with an unprefixed HIP-3 ticker.
+ */
+export declare function resolvePerpKlineCoinArg(rawCoin: string, dexOpt?: string): string;
+/**
+ * Ensures `coin` exists in `meta.universe` for HIP-3 (`deployer:...`) names before candleSnapshot
+ * (bad tickers otherwise yield HTTP 200 with JSON `null`).
+ */
+export declare function assertPerpKlineCoinInMeta(meta: unknown, resolvedCoin: string): void;
+//# sourceMappingURL=klineCoin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"klineCoin.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/klineCoin.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BhF;AA4CD;;;GAGG;AAEH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAqBnF"}

package/dist/core/hyperliquid/klineCoin.js

@@ -0,0 +1,90 @@
+import { ConfigError } from "../errors.js";
+import { extractPerpUniverseCoinNames, perpCoinToAssetIndex } from "./asset.js";
+import { inferHlDexFromPrefixedPerpCoin } from "./prefixedPerpCoin.js";
+/**
+ * `/info` candleSnapshot has no separate `dex` field — only `req.coin`. Combine `--dex` with an unprefixed HIP-3 ticker.
+ */
+export function resolvePerpKlineCoinArg(rawCoin, dexOpt) {
+    const coin = rawCoin.trim();
+    const dex = dexOpt?.trim();
+    if (!coin) {
+        throw new ConfigError("coin argument must be non-empty.");
+    }
+    if (dex) {
+        if (coin.includes(":")) {
+            const inferred = inferHlDexFromPrefixedPerpCoin(coin);
+            if (!inferred) {
+                throw new ConfigError(`Coin '${coin}' is not a valid deployer-prefixed symbol; omit --dex or fix the name.`);
+            }
+            if (inferred !== dex) {
+                throw new ConfigError(`Coin '${coin}' implies dex '${inferred}' but --dex '${dex}' was passed — remove --dex or pass an unprefixed ticker with --dex.`);
+            }
+            return coin;
+        }
+        return `${dex}:${coin}`;
+    }
+    return coin;
+}
+function scoreSymbolSimilarity(wrongSuffix, candidateSuffix) {
+    const a = wrongSuffix.toUpperCase();
+    const b = candidateSuffix.toUpperCase();
+    if (a === b) {
+        return 100;
+    }
+    if (a.includes(b) || b.includes(a)) {
+        return 50;
+    }
+    let best = 0;
+    const minLen = Math.min(a.length, b.length);
+    for (let len = minLen; len >= 3; len--) {
+        for (let i = 0; i <= a.length - len; i++) {
+            const sub = a.slice(i, i + len);
+            if (b.includes(sub)) {
+                best = Math.max(best, len);
+            }
+        }
+    }
+    return best;
+}
+function suggestPerpNames(allNames, wrongCoin) {
+    const colon = wrongCoin.indexOf(":");
+    const deployer = colon >= 0 ? wrongCoin.slice(0, colon) : "";
+    const suffix = colon >= 0 ? wrongCoin.slice(colon + 1) : wrongCoin;
+    const pool = deployer.length > 0 ? allNames.filter((n) => n.startsWith(`${deployer}:`)) : allNames;
+    const ranked = pool.map((n) => {
+        const nc = n.indexOf(":");
+        const ns = nc >= 0 ? n.slice(nc + 1) : n;
+        return { n, score: scoreSymbolSimilarity(suffix, ns) };
+    });
+    return ranked
+        .filter((x) => x.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 12)
+        .map((x) => x.n);
+}
+/**
+ * Ensures `coin` exists in `meta.universe` for HIP-3 (`deployer:...`) names before candleSnapshot
+ * (bad tickers otherwise yield HTTP 200 with JSON `null`).
+ */
+export function assertPerpKlineCoinInMeta(meta, resolvedCoin) {
+    const dex = inferHlDexFromPrefixedPerpCoin(resolvedCoin);
+    if (!dex) {
+        return;
+    }
+    try {
+        perpCoinToAssetIndex(meta, resolvedCoin);
+    }
+    catch (e) {
+        if (!(e instanceof ConfigError)) {
+            throw e;
+        }
+        const names = extractPerpUniverseCoinNames(meta);
+        const hints = suggestPerpNames(names, resolvedCoin);
+        const hintLine = hints.length > 0 ? ` Similar REST names: ${hints.join(", ")}.` : "";
+        const wtioil = /WTIOIL/i.test(resolvedCoin) && dex === "xyz"
+            ? " On dex xyz, WTI-style crude is usually `xyz:CL` (see `perp meta --dex xyz`), not WTIOIL."
+            : "";
+        throw new ConfigError(`${e.message}${hintLine}${wtioil}`);
+    }
+}
+//# sourceMappingURL=klineCoin.js.map

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

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

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

@@ -0,0 +1,91 @@
+export type TifName = "Gtc" | "Ioc" | "Alo";
+export type LimitOrderWire = {
+    a: number;
+    b: boolean;
+    p: string;
+    s: string;
+    r: boolean;
+    t: {
+        limit: {
+            tif: TifName;
+        };
+    };
+    c?: string;
+};
+export declare function limitWireFromParams(params: {
+    assetIndex: number;
+    isBuy: boolean;
+    limitPx: number;
+    sz: number;
+    reduceOnly: boolean;
+    tif: TifName;
+    cloidHex?: string;
+}): LimitOrderWire;
+export declare function limitsToOrderAction(wires: LimitOrderWire[]): Record<string, unknown>;
+export declare function batchLimitOrdersFromPrimitives(opts: {
+    assetIndex: number;
+    rows: Array<{
+        px: number;
+        isBuy: boolean;
+        sz: number;
+    }>;
+    reduceOnly: boolean;
+    tif: TifName;
+}): LimitOrderWire[];
+export declare function buildPlaceOrderAction(params: {
+    assetIndex: number;
+    isBuy: boolean;
+    limitPx: number;
+    sz: number;
+    reduceOnly: boolean;
+    tif: TifName;
+    cloidHex?: string;
+}): Record<string, unknown>;
+export declare function buildCancelOrdersAction(assetIndex: number, oids: number[]): Record<string, unknown>;
+export type TpslKind = "tp" | "sl";
+export type TriggerOrderWire = {
+    a: number;
+    b: boolean;
+    p: string;
+    s: string;
+    r: boolean;
+    t: {
+        trigger: {
+            isMarket: boolean;
+            triggerPx: string;
+            tpsl: TpslKind;
+        };
+    };
+    c?: string;
+};
+export declare function triggerWireFromParams(params: {
+    assetIndex: number;
+    isBuy: boolean;
+    sz: number;
+    reduceOnly: boolean;
+    triggerPx: number;
+    isMarket: boolean;
+    /** Price field `p` on the wire (limit after trigger, or fallback when market trigger). */
+    wireLimitPx: number;
+    tpsl: TpslKind;
+    cloidHex?: string;
+}): TriggerOrderWire;
+export type OrderGrouping = "na" | "normalTpsl" | "positionTpsl";
+export declare function buildTpslTriggerOrderAction(params: Parameters<typeof triggerWireFromParams>[0], extras?: {
+    grouping?: OrderGrouping;
+}): Record<string, unknown>;
+/** Two trigger wires (TP + SL) in a single batch `order` action. */
+export declare function buildBracketProtectionOrderAction(params: {
+    assetIndex: number;
+    /** Closing side: long exit is sell -> isBuy false */
+    closeIsBuy: boolean;
+    sz: number;
+    reduceOnly: boolean;
+    tpTriggerPx: number;
+    slTriggerPx: number;
+    isMarket: boolean;
+    wireLimitPxTp: number;
+    wireLimitPxSl: number;
+    grouping?: OrderGrouping;
+}): Record<string, unknown>;
+//# sourceMappingURL=orders.d.ts.map

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

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

package/dist/core/hyperliquid/orders.js

@@ -0,0 +1,116 @@
+import { floatToWire } from "./float.js";
+export function limitWireFromParams(params) {
+    const wire = {
+        a: params.assetIndex,
+        b: params.isBuy,
+        p: floatToWire(params.limitPx),
+        s: floatToWire(params.sz),
+        r: params.reduceOnly,
+        t: {
+            limit: {
+                tif: params.tif,
+            },
+        },
+    };
+    if (params.cloidHex !== undefined) {
+        wire.c = params.cloidHex;
+    }
+    return wire;
+}
+export function limitsToOrderAction(wires) {
+    if (wires.length === 0) {
+        throw new Error("limitsToOrderAction: empty wires");
+    }
+    return {
+        type: "order",
+        orders: wires,
+        grouping: "na",
+    };
+}
+export function batchLimitOrdersFromPrimitives(opts) {
+    return opts.rows.map((r) => limitWireFromParams({
+        assetIndex: opts.assetIndex,
+        isBuy: r.isBuy,
+        limitPx: r.px,
+        sz: r.sz,
+        reduceOnly: opts.reduceOnly,
+        tif: opts.tif,
+    }));
+}
+export function buildPlaceOrderAction(params) {
+    return limitsToOrderAction([
+        limitWireFromParams({
+            assetIndex: params.assetIndex,
+            isBuy: params.isBuy,
+            limitPx: params.limitPx,
+            sz: params.sz,
+            reduceOnly: params.reduceOnly,
+            tif: params.tif,
+            cloidHex: params.cloidHex,
+        }),
+    ]);
+}
+export function buildCancelOrdersAction(assetIndex, oids) {
+    return {
+        type: "cancel",
+        cancels: oids.map((o) => ({ a: assetIndex, o })),
+    };
+}
+export function triggerWireFromParams(params) {
+    const wire = {
+        a: params.assetIndex,
+        b: params.isBuy,
+        p: floatToWire(params.wireLimitPx),
+        s: floatToWire(params.sz),
+        r: params.reduceOnly,
+        t: {
+            trigger: {
+                isMarket: params.isMarket,
+                triggerPx: floatToWire(params.triggerPx),
+                tpsl: params.tpsl,
+            },
+        },
+    };
+    if (params.cloidHex !== undefined) {
+        wire.c = params.cloidHex;
+    }
+    return wire;
+}
+export function buildTpslTriggerOrderAction(params, extras) {
+    const grouping = extras?.grouping ?? "na";
+    return {
+        type: "order",
+        orders: [triggerWireFromParams(params)],
+        grouping,
+    };
+}
+/** Two trigger wires (TP + SL) in a single batch `order` action. */
+export function buildBracketProtectionOrderAction(params) {
+    const grouping = params.grouping ?? "na";
+    const tp = triggerWireFromParams({
+        assetIndex: params.assetIndex,
+        isBuy: params.closeIsBuy,
+        sz: params.sz,
+        reduceOnly: params.reduceOnly,
+        triggerPx: params.tpTriggerPx,
+        isMarket: params.isMarket,
+        wireLimitPx: params.wireLimitPxTp,
+        tpsl: "tp",
+    });
+    const sl = triggerWireFromParams({
+        assetIndex: params.assetIndex,
+        isBuy: params.closeIsBuy,
+        sz: params.sz,
+        reduceOnly: params.reduceOnly,
+        triggerPx: params.slTriggerPx,
+        isMarket: params.isMarket,
+        wireLimitPx: params.wireLimitPxSl,
+        tpsl: "sl",
+    });
+    return {
+        type: "order",
+        orders: [tp, sl],
+        grouping,
+    };
+}
+//# sourceMappingURL=orders.js.map

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

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

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

@@ -0,0 +1,3 @@
+/** HIP-3 perp symbols use `deployer:ASSET`. Infer `dex` for `/info` meta from the substring before `:`. */
+export declare function inferHlDexFromPrefixedPerpCoin(coin: string): string | undefined;
+//# sourceMappingURL=prefixedPerpCoin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefixedPerpCoin.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/prefixedPerpCoin.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO/E"}

package/dist/core/hyperliquid/prefixedPerpCoin.js

@@ -0,0 +1,10 @@
+/** HIP-3 perp symbols use `deployer:ASSET`. Infer `dex` for `/info` meta from the substring before `:`. */
+export function inferHlDexFromPrefixedPerpCoin(coin) {
+    const idx = coin.indexOf(":");
+    if (idx <= 0) {
+        return undefined;
+    }
+    const dex = coin.slice(0, idx).trim();
+    return dex.length === 0 ? undefined : dex;
+}
+//# sourceMappingURL=prefixedPerpCoin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefixedPerpCoin.js","sourceRoot":"","sources":["../../../src/core/hyperliquid/prefixedPerpCoin.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AAC5C,CAAC"}

package/dist/core/hyperliquid/signed-exchange.d.ts

@@ -0,0 +1,10 @@
+import type { Wallet } from "ethers";
+export declare function buildSignedExchangePayload(wallet: Wallet, action: Record<string, unknown>, opts: {
+    /** Main Hyperliquid environment uses `"a"`; testnet uses `"b"`. */
+    isMainnet: boolean;
+    vaultAddress?: `0x${string}`;
+    expiresAfter?: bigint;
+    /** Defaults to `Date.now()` ms. */
+    nonce?: bigint;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=signed-exchange.d.ts.map

package/dist/core/hyperliquid/signed-exchange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-exchange.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/signed-exchange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIrC,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE;IACJ,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwBlC"}