@metamask-previews/perps-controller 6.0.1-preview-e5cef32c6 → 6.1.0-preview-6d2aeda

package/dist/utils/errorUtils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errorUtils.d.mts","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAkBnE"}
+{"version":3,"file":"errorUtils.d.mts","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASpD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAe5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAkBnE"}

package/dist/utils/errorUtils.mjs

@@ -1,8 +1,9 @@
 /**
- * Utility functions for error handling across the application.
- * These are general-purpose utilities, not domain-specific.
+ * Utility functions for error handling across Perps controller code.
+ * Includes generic error helpers and Perps error classification helpers.
  */
 import { hasProperty } from "@metamask/utils";
+import { PERPS_ERROR_CODES } from "../perpsErrorCodes.mjs";
 /**
  * Detects expected cancellation/abort errors that should not be reported to Sentry.
  * These occur during normal navigation or view teardown when in-flight fetch requests
@@ -19,6 +20,25 @@ export function isAbortError(error) {
     }
     return false;
 }
+/**
+ * Detects keyring-locked errors, including SDK-wrapped errors that preserve the
+ * original error in `cause`.
+ *
+ * @param error - The error to check.
+ * @returns True if any error in the cause chain is KEYRING_LOCKED.
+ */
+export function isKeyringLockedError(error) {
+    let current = error;
+    const seen = new Set();
+    while (current instanceof Error && !seen.has(current)) {
+        seen.add(current);
+        if (current.message === PERPS_ERROR_CODES.KEYRING_LOCKED) {
+            return true;
+        }
+        current = current.cause;
+    }
+    return false;
+}
 /**
  * Ensures we have a proper Error object for logging.
  * Converts unknown/string errors to proper Error instances.

package/dist/utils/errorUtils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errorUtils.mjs","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,YAAY;YAC3B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAgB;IAC1D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,8DAA8D;IAC9D,oFAAoF;IACpF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,qCAAqC,CAAC;QAC1D,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,KAAK,CACd,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1E,CAAC,CAAC,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC;QACjD,CAAC,CAAC,eAAe,CACpB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Utility functions for error handling across the application.\n * These are general-purpose utilities, not domain-specific.\n */\nimport { hasProperty } from '@metamask/utils';\n\n/**\n * Detects expected cancellation/abort errors that should not be reported to Sentry.\n * These occur during normal navigation or view teardown when in-flight fetch requests\n * are cancelled via AbortController.\n *\n * @param error - The error to check.\n * @returns True if the error is an expected abort/cancellation.\n */\nexport function isAbortError(error: unknown): boolean {\n  if (error instanceof Error) {\n    return (\n      error.name === 'AbortError' ||\n      error.message.includes('signal is aborted') ||\n      error.message.includes('The operation was aborted')\n    );\n  }\n  return false;\n}\n\n/**\n * Ensures we have a proper Error object for logging.\n * Converts unknown/string errors to proper Error instances.\n * Handles undefined/null specially for better Sentry context.\n *\n * @param error - The caught error (could be Error, string, or unknown)\n * @param context - Optional context string to help identify the source of the error\n * @returns A proper Error instance\n */\nexport function ensureError(error: unknown, context?: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  // Handle undefined/null specifically for better error context\n  // e.g. Hyperliquid SDK may reject with undefined when AbortSignal.reason is not set\n  if (error === undefined || error === null) {\n    const baseMessage = 'Unknown error (no details provided)';\n    return new Error(context ? `${baseMessage} [${context}]` : baseMessage);\n  }\n  if (typeof error === 'string') {\n    return new Error(error);\n  }\n  return new Error(\n    typeof error === 'object' && error !== null && hasProperty(error, 'message')\n      ? String((error as { message: unknown }).message)\n      : 'Unknown error',\n  );\n}\n"]}
+{"version":3,"file":"errorUtils.mjs","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,wBAAwB;AAE9C,OAAO,EAAE,iBAAiB,EAAE,+BAA2B;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,YAAY;YAC3B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAEhC,OAAO,OAAO,YAAY,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElB,IAAI,OAAO,CAAC,OAAO,KAAK,iBAAiB,CAAC,cAAc,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAI,OAA+B,CAAC,KAAK,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAgB;IAC1D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,8DAA8D;IAC9D,oFAAoF;IACpF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,qCAAqC,CAAC;QAC1D,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,KAAK,CACd,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1E,CAAC,CAAC,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC;QACjD,CAAC,CAAC,eAAe,CACpB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Utility functions for error handling across Perps controller code.\n * Includes generic error helpers and Perps error classification helpers.\n */\nimport { hasProperty } from '@metamask/utils';\n\nimport { PERPS_ERROR_CODES } from '../perpsErrorCodes';\n\n/**\n * Detects expected cancellation/abort errors that should not be reported to Sentry.\n * These occur during normal navigation or view teardown when in-flight fetch requests\n * are cancelled via AbortController.\n *\n * @param error - The error to check.\n * @returns True if the error is an expected abort/cancellation.\n */\nexport function isAbortError(error: unknown): boolean {\n  if (error instanceof Error) {\n    return (\n      error.name === 'AbortError' ||\n      error.message.includes('signal is aborted') ||\n      error.message.includes('The operation was aborted')\n    );\n  }\n  return false;\n}\n\n/**\n * Detects keyring-locked errors, including SDK-wrapped errors that preserve the\n * original error in `cause`.\n *\n * @param error - The error to check.\n * @returns True if any error in the cause chain is KEYRING_LOCKED.\n */\nexport function isKeyringLockedError(error: unknown): boolean {\n  let current: unknown = error;\n  const seen = new Set<unknown>();\n\n  while (current instanceof Error && !seen.has(current)) {\n    seen.add(current);\n\n    if (current.message === PERPS_ERROR_CODES.KEYRING_LOCKED) {\n      return true;\n    }\n\n    current = (current as { cause?: unknown }).cause;\n  }\n\n  return false;\n}\n\n/**\n * Ensures we have a proper Error object for logging.\n * Converts unknown/string errors to proper Error instances.\n * Handles undefined/null specially for better Sentry context.\n *\n * @param error - The caught error (could be Error, string, or unknown)\n * @param context - Optional context string to help identify the source of the error\n * @returns A proper Error instance\n */\nexport function ensureError(error: unknown, context?: string): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n  // Handle undefined/null specifically for better error context\n  // e.g. Hyperliquid SDK may reject with undefined when AbortSignal.reason is not set\n  if (error === undefined || error === null) {\n    const baseMessage = 'Unknown error (no details provided)';\n    return new Error(context ? `${baseMessage} [${context}]` : baseMessage);\n  }\n  if (typeof error === 'string') {\n    return new Error(error);\n  }\n  return new Error(\n    typeof error === 'object' && error !== null && hasProperty(error, 'message')\n      ? String((error as { message: unknown }).message)\n      : 'Unknown error',\n  );\n}\n"]}

package/dist/utils/hyperLiquidAbstraction.cjs

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldDeferUnifiedAccountSetup = void 0;
+const MIGRATABLE_ABSTRACTION_MODES = new Set([
+    'dexAbstraction',
+    'default',
+    'disabled',
+]);
+/**
+ * Determine whether unified-account setup should be deferred until a user
+ * explicitly starts a trading or withdrawal action.
+ *
+ * @param currentMode - The user's current HyperLiquid abstraction mode.
+ * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.
+ * @returns True when migration would require a signing-backed mutation that should be deferred.
+ */
+function shouldDeferUnifiedAccountSetup(currentMode, allowUserSigning) {
+    return (!allowUserSigning &&
+        currentMode !== undefined &&
+        MIGRATABLE_ABSTRACTION_MODES.has(currentMode));
+}
+exports.shouldDeferUnifiedAccountSetup = shouldDeferUnifiedAccountSetup;
+//# sourceMappingURL=hyperLiquidAbstraction.cjs.map

package/dist/utils/hyperLiquidAbstraction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidAbstraction.cjs","sourceRoot":"","sources":["../../src/utils/hyperLiquidAbstraction.ts"],"names":[],"mappings":";;;AAEA,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAA6B;IACvE,gBAAgB;IAChB,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,SAAgB,8BAA8B,CAC5C,WAAmD,EACnD,gBAAyB;IAEzB,OAAO,CACL,CAAC,gBAAgB;QACjB,WAAW,KAAK,SAAS;QACzB,4BAA4B,CAAC,GAAG,CAAC,WAAW,CAAC,CAC9C,CAAC;AACJ,CAAC;AATD,wEASC","sourcesContent":["import type { HyperLiquidAbstractionMode } from '../types/hyperliquid-types';\n\nconst MIGRATABLE_ABSTRACTION_MODES = new Set<HyperLiquidAbstractionMode>([\n  'dexAbstraction',\n  'default',\n  'disabled',\n]);\n\n/**\n * Determine whether unified-account setup should be deferred until a user\n * explicitly starts a trading or withdrawal action.\n *\n * @param currentMode - The user's current HyperLiquid abstraction mode.\n * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.\n * @returns True when migration would require a signing-backed mutation that should be deferred.\n */\nexport function shouldDeferUnifiedAccountSetup(\n  currentMode: HyperLiquidAbstractionMode | undefined,\n  allowUserSigning: boolean,\n): boolean {\n  return (\n    !allowUserSigning &&\n    currentMode !== undefined &&\n    MIGRATABLE_ABSTRACTION_MODES.has(currentMode)\n  );\n}\n"]}

package/dist/utils/hyperLiquidAbstraction.d.cts

@@ -0,0 +1,11 @@
+import type { HyperLiquidAbstractionMode } from "../types/hyperliquid-types.cjs";
+/**
+ * Determine whether unified-account setup should be deferred until a user
+ * explicitly starts a trading or withdrawal action.
+ *
+ * @param currentMode - The user's current HyperLiquid abstraction mode.
+ * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.
+ * @returns True when migration would require a signing-backed mutation that should be deferred.
+ */
+export declare function shouldDeferUnifiedAccountSetup(currentMode: HyperLiquidAbstractionMode | undefined, allowUserSigning: boolean): boolean;
+//# sourceMappingURL=hyperLiquidAbstraction.d.cts.map

package/dist/utils/hyperLiquidAbstraction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidAbstraction.d.cts","sourceRoot":"","sources":["../../src/utils/hyperLiquidAbstraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,uCAAmC;AAQ7E;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,0BAA0B,GAAG,SAAS,EACnD,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAMT"}

package/dist/utils/hyperLiquidAbstraction.d.mts

@@ -0,0 +1,11 @@
+import type { HyperLiquidAbstractionMode } from "../types/hyperliquid-types.mjs";
+/**
+ * Determine whether unified-account setup should be deferred until a user
+ * explicitly starts a trading or withdrawal action.
+ *
+ * @param currentMode - The user's current HyperLiquid abstraction mode.
+ * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.
+ * @returns True when migration would require a signing-backed mutation that should be deferred.
+ */
+export declare function shouldDeferUnifiedAccountSetup(currentMode: HyperLiquidAbstractionMode | undefined, allowUserSigning: boolean): boolean;
+//# sourceMappingURL=hyperLiquidAbstraction.d.mts.map

package/dist/utils/hyperLiquidAbstraction.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidAbstraction.d.mts","sourceRoot":"","sources":["../../src/utils/hyperLiquidAbstraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,uCAAmC;AAQ7E;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,0BAA0B,GAAG,SAAS,EACnD,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAMT"}

package/dist/utils/hyperLiquidAbstraction.mjs

@@ -0,0 +1,19 @@
+const MIGRATABLE_ABSTRACTION_MODES = new Set([
+    'dexAbstraction',
+    'default',
+    'disabled',
+]);
+/**
+ * Determine whether unified-account setup should be deferred until a user
+ * explicitly starts a trading or withdrawal action.
+ *
+ * @param currentMode - The user's current HyperLiquid abstraction mode.
+ * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.
+ * @returns True when migration would require a signing-backed mutation that should be deferred.
+ */
+export function shouldDeferUnifiedAccountSetup(currentMode, allowUserSigning) {
+    return (!allowUserSigning &&
+        currentMode !== undefined &&
+        MIGRATABLE_ABSTRACTION_MODES.has(currentMode));
+}
+//# sourceMappingURL=hyperLiquidAbstraction.mjs.map

package/dist/utils/hyperLiquidAbstraction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperLiquidAbstraction.mjs","sourceRoot":"","sources":["../../src/utils/hyperLiquidAbstraction.ts"],"names":[],"mappings":"AAEA,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAA6B;IACvE,gBAAgB;IAChB,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAC5C,WAAmD,EACnD,gBAAyB;IAEzB,OAAO,CACL,CAAC,gBAAgB;QACjB,WAAW,KAAK,SAAS;QACzB,4BAA4B,CAAC,GAAG,CAAC,WAAW,CAAC,CAC9C,CAAC;AACJ,CAAC","sourcesContent":["import type { HyperLiquidAbstractionMode } from '../types/hyperliquid-types';\n\nconst MIGRATABLE_ABSTRACTION_MODES = new Set<HyperLiquidAbstractionMode>([\n  'dexAbstraction',\n  'default',\n  'disabled',\n]);\n\n/**\n * Determine whether unified-account setup should be deferred until a user\n * explicitly starts a trading or withdrawal action.\n *\n * @param currentMode - The user's current HyperLiquid abstraction mode.\n * @param allowUserSigning - Whether the caller is allowed to trigger wallet signing.\n * @returns True when migration would require a signing-backed mutation that should be deferred.\n */\nexport function shouldDeferUnifiedAccountSetup(\n  currentMode: HyperLiquidAbstractionMode | undefined,\n  allowUserSigning: boolean,\n): boolean {\n  return (\n    !allowUserSigning &&\n    currentMode !== undefined &&\n    MIGRATABLE_ABSTRACTION_MODES.has(currentMode)\n  );\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/perps-controller",
-  "version": "6.0.1-preview-e5cef32c6",
+  "version": "6.1.0-preview-6d2aeda",
   "description": "Controller for perpetual trading functionality in MetaMask",
   "keywords": [
     "Ethereum",