jcc_hyper_tool 0.1.3 → 0.1.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormat.d.ts","sourceRoot":"","sources":["../../src/core/errorFormat.ts"],"names":[],"mappings":"AAGA,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED,yEAAyE;AACzE,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiC3D"}

package/dist/core/errorFormat.js

@@ -0,0 +1,59 @@
+import { ConfigError, HyperliquidApiError } from "./errors.js";
+import { formatErrorChain } from "./hyperliquid/httpRequest.js";
+/** Max response body bytes embedded in CLI stderr (beyond this, note truncation). */
+export const HTTP_ERROR_BODY_MAX_BYTES = 65_536;
+export function formatHttpResponseBody(bodyText) {
+    const trimmed = bodyText.trimEnd();
+    if (trimmed.length === 0) {
+        return "";
+    }
+    if (trimmed.length <= HTTP_ERROR_BODY_MAX_BYTES) {
+        return trimmed;
+    }
+    return `${trimmed.slice(0, HTTP_ERROR_BODY_MAX_BYTES)}\n… (truncated; ${trimmed.length} bytes total)`;
+}
+/** Pretty-print JSON bodies when possible; otherwise return raw text. */
+export function formatHttpResponseBodyForDisplay(bodyText) {
+    const raw = formatHttpResponseBody(bodyText);
+    if (!raw) {
+        return "";
+    }
+    try {
+        return JSON.stringify(JSON.parse(raw), null, 2);
+    }
+    catch {
+        return raw;
+    }
+}
+export function formatErrorForStderr(error) {
+    if (error instanceof HyperliquidApiError) {
+        const lines = [error.message];
+        const body = formatHttpResponseBodyForDisplay(error.bodyText);
+        if (body && !error.message.includes(body.slice(0, 200))) {
+            lines.push("", "── Response body ──", body);
+        }
+        const meta = [];
+        if (error.requestHint) {
+            meta.push(`request=${error.requestHint}`);
+        }
+        if (error.status !== undefined) {
+            meta.push(`httpStatus=${error.status}`);
+        }
+        if (meta.length > 0) {
+            lines.push("", meta.join(", "));
+        }
+        return lines.join("\n");
+    }
+    if (error instanceof ConfigError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        const lines = [`${error.name}: ${error.message}`];
+        if (error.cause !== undefined) {
+            lines.push(`Caused by: ${formatErrorChain(error.cause)}`);
+        }
+        return lines.join("\n");
+    }
+    return String(error);
+}
+//# sourceMappingURL=errorFormat.js.map

package/dist/core/errorFormat.js.map

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

package/dist/core/errors.d.ts

@@ -1,7 +1,8 @@
 export declare class HyperliquidApiError extends Error {
     readonly status: number;
     readonly bodyText: string;
-    constructor(message: string, status: number, bodyText: string);
+    readonly requestHint?: string;
+    constructor(message: string, status: number, bodyText: string, requestHint?: string);
 }
 export declare class ConfigError extends Error {
     constructor(message: string);

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

@@ -1 +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"}
+{"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;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOpF;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/errors.js

@@ -1,11 +1,13 @@
 export class HyperliquidApiError extends Error {
     status;
     bodyText;
-    constructor(message, status, bodyText) {
+    requestHint;
+    constructor(message, status, bodyText, requestHint) {
         super(message);
         this.name = "HyperliquidApiError";
         this.status = status;
         this.bodyText = bodyText;
+        this.requestHint = requestHint;
     }
 }
 export class ConfigError extends Error {

package/dist/core/errors.js.map

@@ -1 +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"}
+{"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;IACjB,WAAW,CAAU;IAE9B,YAAY,OAAe,EAAE,MAAc,EAAE,QAAgB,EAAE,WAAoB;QACjF,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;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,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/client.d.ts

@@ -1,12 +1,15 @@
 import type { JsonValue } from "./types.js";
+import { type HyperliquidHttpRetryOptions } from "./httpRequest.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;
+    private readonly retry;
     readonly infoUrl: string;
     constructor(opts: {
         infoOrigin: string;
         fetchImpl?: FetchLike;
+        retry?: HyperliquidHttpRetryOptions;
     });
     info(body: InfoRequestBody): Promise<JsonValue>;
     meta(dex?: string): Promise<JsonValue>;

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

@@ -1 +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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,kBAAkB,CAAC;AAE1B,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,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,2BAA2B,CAAA;KAAE;IAO9F,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAmDrD,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"}

package/dist/core/hyperliquid/client.js

@@ -1,40 +1,50 @@
 import { HyperliquidApiError } from "../errors.js";
+import { formatHyperliquidHttpError, postJsonWithRetry, requestHintFromJsonBody, } from "./httpRequest.js";
 export class HyperliquidInfoClient {
     fetchImpl;
+    retry;
     infoUrl;
     constructor(opts) {
         const origin = opts.infoOrigin.replace(/\/+$/, "");
         this.infoUrl = `${origin}/info`;
         this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.retry = opts.retry ?? {};
     }
     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();
+        const requestHint = requestHintFromJsonBody(body);
+        const res = await postJsonWithRetry({
+            url: this.infoUrl,
+            body,
+            fetchImpl: this.fetchImpl,
+            retry: this.retry,
+        });
         let parsed;
-        if (text.length > 0) {
+        if (res.text.length > 0) {
             try {
-                parsed = JSON.parse(text);
+                parsed = JSON.parse(res.text);
             }
             catch {
-                throw new HyperliquidApiError(`Non-JSON response (${res.status})`, res.status, text);
+                throw new HyperliquidApiError(formatHyperliquidHttpError({
+                    method: "POST",
+                    url: this.infoUrl,
+                    status: res.status,
+                    statusText: res.statusText,
+                    bodyText: res.text,
+                    requestHint,
+                    retriesAttempted: res.attemptsMade - 1,
+                }), res.status, res.text, requestHint);
             }
         }
-        if (!res.ok) {
-            throw new HyperliquidApiError(`HTTP ${res.status} POST ${this.infoUrl}`, res.status, text);
+        if (res.status < 200 || res.status >= 300) {
+            throw new HyperliquidApiError(formatHyperliquidHttpError({
+                method: "POST",
+                url: this.infoUrl,
+                status: res.status,
+                statusText: res.statusText,
+                bodyText: res.text,
+                requestHint,
+                retriesAttempted: res.attemptsMade - 1,
+            }), res.status, res.text, requestHint);
         }
         return parsed ?? null;
     }

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

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

@@ -1,13 +1,16 @@
 import type { JsonValue } from "./types.js";
 import type { FetchLike } from "./client.js";
+import { type HyperliquidHttpRetryOptions } from "./httpRequest.js";
 export type SignedExchangeEnvelope = Record<string, unknown>;
 export type ExchangePostBody = SignedExchangeEnvelope;
 export declare class HyperliquidExchangeClient {
     private readonly fetchImpl;
+    private readonly retry;
     readonly exchangeUrl: string;
     constructor(opts: {
         apiOrigin: string;
         fetchImpl?: FetchLike;
+        retry?: HyperliquidHttpRetryOptions;
     });
     exchange(body: ExchangePostBody): Promise<JsonValue>;
 }

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

@@ -1 +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"}
+{"version":3,"file":"exchange.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchange.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,kBAAkB,CAAC;AAE1B,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,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,KAAK,CAAC,EAAE,2BAA2B,CAAC;KACrC;IAOK,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;CAkD3D"}

package/dist/core/hyperliquid/exchange.js

@@ -1,41 +1,51 @@
+import { assertExchangeResponseOk, } from "./exchangeParse.js";
 import { HyperliquidApiError } from "../errors.js";
+import { formatHyperliquidHttpError, postJsonWithRetry, } from "./httpRequest.js";
 export class HyperliquidExchangeClient {
     fetchImpl;
+    retry;
     exchangeUrl;
     constructor(opts) {
         const origin = opts.apiOrigin.replace(/\/+$/, "");
         this.exchangeUrl = `${origin}/exchange`;
         this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.retry = opts.retry ?? {};
     }
     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();
+        const res = await postJsonWithRetry({
+            url: this.exchangeUrl,
+            body,
+            fetchImpl: this.fetchImpl,
+            retry: this.retry,
+        });
         let parsed;
-        if (text.length > 0) {
+        if (res.text.length > 0) {
             try {
-                parsed = JSON.parse(text);
+                parsed = JSON.parse(res.text);
             }
             catch {
-                throw new HyperliquidApiError(`Non-JSON exchange response (${res.status})`, res.status, text);
+                throw new HyperliquidApiError(formatHyperliquidHttpError({
+                    method: "POST",
+                    url: this.exchangeUrl,
+                    status: res.status,
+                    statusText: res.statusText,
+                    bodyText: res.text,
+                    requestHint: "exchange",
+                }), res.status, res.text, "exchange");
             }
         }
-        if (!res.ok) {
-            throw new HyperliquidApiError(`HTTP ${res.status} POST ${this.exchangeUrl}`, res.status, text);
+        if (res.status < 200 || res.status >= 300) {
+            throw new HyperliquidApiError(formatHyperliquidHttpError({
+                method: "POST",
+                url: this.exchangeUrl,
+                status: res.status,
+                statusText: res.statusText,
+                bodyText: res.text,
+                requestHint: "exchange",
+                retriesAttempted: res.attemptsMade - 1,
+            }), res.status, res.text, "exchange");
         }
+        assertExchangeResponseOk(parsed ?? null);
         return parsed ?? null;
     }
 }

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

@@ -1 +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"}
+{"version":3,"file":"exchange.js","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchange.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,OAAO,yBAAyB;IACnB,SAAS,CAAY;IACrB,KAAK,CAA8B;IAC3C,WAAW,CAAS;IAE7B,YAAY,IAIX;QACC,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;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAsB;QACnC,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC;YAClC,GAAG,EAAE,IAAI,CAAC,WAAW;YACrB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,IAAI,MAA6B,CAAC;QAClC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAc,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,mBAAmB,CAC3B,0BAA0B,CAAC;oBACzB,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,IAAI,CAAC,WAAW;oBACrB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,GAAG,CAAC,IAAI;oBAClB,WAAW,EAAE,UAAU;iBACxB,CAAC,EACF,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,IAAI,EACR,UAAU,CACX,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAC1C,MAAM,IAAI,mBAAmB,CAC3B,0BAA0B,CAAC;gBACzB,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,IAAI,CAAC,WAAW;gBACrB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,IAAI;gBAClB,WAAW,EAAE,UAAU;gBACvB,gBAAgB,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC;aACvC,CAAC,EACF,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,IAAI,EACR,UAAU,CACX,CAAC;QACJ,CAAC;QAED,wBAAwB,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;QAEzC,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;CACF"}

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

@@ -1,4 +1,7 @@
 import type { JsonValue } from "./types.js";
+/** Collect HL /exchange application-level errors (HTTP may still be 200). */
+export declare function collectExchangeApplicationErrors(resp: JsonValue): string[];
+export declare function assertExchangeResponseOk(resp: JsonValue, context?: string): void;
 /**
  * Best-effort extraction of HL order ids from /exchange JSON responses.
  * Shapes vary; callers should reconcile with openOrders when unsure.

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

@@ -1 +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"}
+{"version":3,"file":"exchangeParse.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/exchangeParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA+B5C,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAgC1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBhF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAuB9E"}

package/dist/core/hyperliquid/exchangeParse.js

@@ -1,3 +1,5 @@
+import { HyperliquidApiError } from "../errors.js";
+import { formatHttpResponseBodyForDisplay } from "../errorFormat.js";
 function collectOidsFromStatusEntry(entry, out) {
     if (typeof entry !== "object" || entry === null) {
         return;
@@ -13,6 +15,66 @@ function collectOidsFromStatusEntry(entry, out) {
         }
     }
 }
+function stringifyExchangeErr(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Collect HL /exchange application-level errors (HTTP may still be 200). */
+export function collectExchangeApplicationErrors(resp) {
+    const errors = [];
+    if (typeof resp !== "object" || resp === null) {
+        return errors;
+    }
+    const root = resp;
+    if (root.status === "err") {
+        errors.push(stringifyExchangeErr(root.response ?? root));
+    }
+    const response = root.response;
+    if (typeof response !== "object" || response === null) {
+        return errors;
+    }
+    const data = response.data;
+    if (typeof data !== "object" || data === null) {
+        return errors;
+    }
+    const statuses = data.statuses;
+    if (!Array.isArray(statuses)) {
+        return errors;
+    }
+    for (let i = 0; i < statuses.length; i++) {
+        const entry = statuses[i];
+        if (typeof entry !== "object" || entry === null) {
+            continue;
+        }
+        const err = entry.error;
+        if (typeof err === "string" && err.trim()) {
+            errors.push(`statuses[${i}]: ${err.trim()}`);
+        }
+    }
+    return errors;
+}
+export function assertExchangeResponseOk(resp, context) {
+    const errors = collectExchangeApplicationErrors(resp);
+    if (errors.length === 0) {
+        return;
+    }
+    const full = formatHttpResponseBodyForDisplay(JSON.stringify(resp));
+    const prefix = context ? `${context}: ` : "";
+    throw new HyperliquidApiError([
+        `${prefix}Hyperliquid /exchange application error:`,
+        ...errors.map((e) => `- ${e}`),
+        "",
+        "Full response:",
+        full,
+    ].join("\n"), 200, JSON.stringify(resp), "exchange");
+}
 /**
  * Best-effort extraction of HL order ids from /exchange JSON responses.
  * Shapes vary; callers should reconcile with openOrders when unsure.

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

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

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

@@ -0,0 +1,36 @@
+import type { FetchLike } from "./client.js";
+/** Hyperliquid REST IP weight budget (see HL rate-limits docs). */
+export declare const HL_REST_WEIGHT_LIMIT_PER_MINUTE = 1200;
+export type HyperliquidHttpRetryOptions = {
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+};
+export type PostJsonResult = {
+    status: number;
+    statusText: string;
+    text: string;
+    headers: Headers;
+    /** 1-based attempt count for this request. */
+    attemptsMade: number;
+};
+export declare function defaultHyperliquidHttpRetryOptions(): Required<HyperliquidHttpRetryOptions>;
+export declare function requestHintFromJsonBody(body: unknown): string | undefined;
+/** Unwrap Error.cause chains (Node fetch often surfaces only "fetch failed" at the top). */
+export declare function formatErrorChain(error: unknown): string;
+export declare function hyperliquidRateLimitHint(): string;
+export declare function formatHyperliquidHttpError(params: {
+    method: string;
+    url: string;
+    status: number;
+    statusText?: string;
+    bodyText: string;
+    requestHint?: string;
+    retriesAttempted?: number;
+}): string;
+export declare function postJsonWithRetry(params: {
+    url: string;
+    body: unknown;
+    fetchImpl: FetchLike;
+    retry?: HyperliquidHttpRetryOptions;
+}): Promise<PostJsonResult>;
+//# sourceMappingURL=httpRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"httpRequest.d.ts","sourceRoot":"","sources":["../../../src/core/hyperliquid/httpRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAWF,wBAAgB,kCAAkC,IAAI,QAAQ,CAAC,2BAA2B,CAAC,CAK1F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmBvD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAQjD;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAqCT;AAoCD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,2BAA2B,CAAC;CACrC,GAAG,OAAO,CAAC,cAAc,CAAC,CAmE1B"}