@dynamic-labs-wallet/forward-mpc-client 0.8.2 → 0.10.0

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client-v2/errors.ts","../src/client-v2/error-classification.ts"],"names":["ErrorCode","ATTESTATION_FAILED","REQUEST_TIMEOUT","ForwardMPCErrorType","SESSION","ForwardMPCError","Error","code","type","context","message","name","Object","setPrototypeOf","prototype","toJSON","stack","SessionError","SessionAttestationError","cause","undefined","SessionRequestTimeoutError","classifyForwardMpcError","error","errorType","errorCode","errorMessage","attestationErrors","sessionEstablished","shouldFallback","String","isForwardMpcError","isAttestationError"],"mappings":"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","file":"utils.js","sourcesContent":["import { type WebSocketError } from '@dynamic-labs-wallet/forward-mpc-shared';\n\n// ─── Error codes ──────────────────────────────────────────────────────────────\n\nexport const ErrorCode = {\n  // Transport\n  CONNECTION_FAILED: 'CONNECTION_FAILED',\n  CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',\n  NOT_CONNECTED: 'NOT_CONNECTED',\n  // Session\n  HANDSHAKE_FAILED: 'HANDSHAKE_FAILED',\n  HANDSHAKE_INVALID_RESPONSE: 'HANDSHAKE_INVALID_RESPONSE',\n  ATTESTATION_FAILED: 'ATTESTATION_FAILED',\n  ATTESTATION_PCR_MISMATCH: 'ATTESTATION_PCR_MISMATCH',\n  ATTESTATION_CHALLENGE_MISMATCH: 'ATTESTATION_CHALLENGE_MISMATCH',\n  ATTESTATION_NONCE_MISMATCH: 'ATTESTATION_NONCE_MISMATCH',\n  ATTESTATION_NONCE_MISSING: 'ATTESTATION_NONCE_MISSING',\n  ATTESTATION_DOCUMENT_MISSING: 'ATTESTATION_DOCUMENT_MISSING',\n  REQUEST_TIMEOUT: 'REQUEST_TIMEOUT',\n  SESSION_DISPOSED: 'SESSION_DISPOSED',\n  SERVER_ERROR: 'SERVER_ERROR',\n  MESSAGE_PARSE_FAILED: 'MESSAGE_PARSE_FAILED',\n  // Client\n  SESSION_ESTABLISH_FAILED: 'SESSION_ESTABLISH_FAILED',\n  UNSUPPORTED_ALGORITHM: 'UNSUPPORTED_ALGORITHM',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\n/**\n * Focused subset of ErrorCode for attestation verification failures.\n * Use with `error.code` to distinguish failure modes on SessionAttestationError.\n */\nexport const AttestationErrorCode = {\n  /** Generic / unrecognised attestation failure */\n  FAILED: ErrorCode.ATTESTATION_FAILED,\n  /** PCR8 hash mismatch — enclave measurement changed */\n  PCR_MISMATCH: ErrorCode.ATTESTATION_PCR_MISMATCH,\n  /** Challenge / ciphertext binding mismatch */\n  CHALLENGE_MISMATCH: ErrorCode.ATTESTATION_CHALLENGE_MISMATCH,\n  /** Nonce value mismatch — possible tampering */\n  NONCE_MISMATCH: ErrorCode.ATTESTATION_NONCE_MISMATCH,\n  /** Nonce field missing from attestation document */\n  NONCE_MISSING: ErrorCode.ATTESTATION_NONCE_MISSING,\n  /** Server did not return an attestation document */\n  DOCUMENT_MISSING: ErrorCode.ATTESTATION_DOCUMENT_MISSING,\n} as const;\n\nexport type AttestationErrorCode =\n  (typeof AttestationErrorCode)[keyof typeof AttestationErrorCode];\n\n// ─── Error types ──────────────────────────────────────────────────────────────\n\nexport const ForwardMPCErrorType = {\n  TRANSPORT: 'transport',\n  SESSION: 'session',\n  CLIENT: 'client',\n} as const;\n\nexport type ForwardMPCErrorType =\n  (typeof ForwardMPCErrorType)[keyof typeof ForwardMPCErrorType];\n\n// ─── Root base class ──────────────────────────────────────────────────────────\n\n/**\n * Abstract root for all Forward MPC errors.\n * `instanceof ForwardMPCError` is true for every error thrown by this library.\n */\nexport abstract class ForwardMPCError extends Error {\n  public readonly code: ErrorCode;\n  public readonly type: ForwardMPCErrorType;\n  public readonly context?: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    code: ErrorCode,\n    type: ForwardMPCErrorType,\n    context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = this.constructor.name;\n    this.code = code;\n    this.type = type;\n    this.context = context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      type: this.type,\n      stack: this.stack,\n      context: this.context,\n    };\n  }\n}\n\n// ─── Layer base classes ───────────────────────────────────────────────────────\n\n/** Abstract base for errors originating from the WebSocket / transport layer. */\nexport abstract class TransportError extends ForwardMPCError {\n  constructor(\n    message: string,\n    code: ErrorCode,\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, ForwardMPCErrorType.TRANSPORT, context);\n  }\n}\n\n/** Abstract base for errors originating from the session / crypto / protocol layer. */\nexport abstract class SessionError extends ForwardMPCError {\n  constructor(\n    message: string,\n    code: ErrorCode,\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, ForwardMPCErrorType.SESSION, context);\n  }\n}\n\n/** Abstract base for errors originating from the client / application layer. */\nexport abstract class ClientError extends ForwardMPCError {\n  constructor(\n    message: string,\n    code: ErrorCode,\n    context?: Record<string, unknown>\n  ) {\n    super(message, code, ForwardMPCErrorType.CLIENT, context);\n  }\n}\n\n// ─── Transport errors ─────────────────────────────────────────────────────────\n\nexport class TransportConnectionError extends TransportError {\n  constructor(context?: Record<string, unknown>) {\n    super('WebSocket connection failed', ErrorCode.CONNECTION_FAILED, context);\n  }\n}\n\nexport class TransportConnectionTimeoutError extends TransportError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'WebSocket connection timed out',\n      ErrorCode.CONNECTION_TIMEOUT,\n      context\n    );\n  }\n}\n\nexport class TransportNotConnectedError extends TransportError {\n  constructor(context?: Record<string, unknown>) {\n    super('WebSocket is not connected', ErrorCode.NOT_CONNECTED, context);\n  }\n}\n\n// ─── Session errors ───────────────────────────────────────────────────────────\n\nexport class SessionHandshakeError extends SessionError {\n  constructor(reason: string, context?: Record<string, unknown>) {\n    super(\n      `ML-KEM-768 handshake failed: ${reason}`,\n      ErrorCode.HANDSHAKE_FAILED,\n      { reason, ...context }\n    );\n  }\n}\n\nexport class SessionHandshakeInvalidResponseError extends SessionError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'Handshake response was invalid or incomplete',\n      ErrorCode.HANDSHAKE_INVALID_RESPONSE,\n      context\n    );\n  }\n}\n\n/**\n * Attestation verification failure.\n * Use `error.code` to distinguish failure reasons (e.g. ATTESTATION_PCR_MISMATCH)\n * and `error.cause` to inspect the original verifier error.\n */\nexport class SessionAttestationError extends SessionError {\n  public readonly cause?: unknown;\n\n  constructor(\n    message: string = 'Attestation verification failed',\n    code: ErrorCode = ErrorCode.ATTESTATION_FAILED,\n    context?: Record<string, unknown>,\n    cause?: unknown\n  ) {\n    super(message, code, context);\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n\nexport class SessionRequestTimeoutError extends SessionError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'Request timed out waiting for server response',\n      ErrorCode.REQUEST_TIMEOUT,\n      context\n    );\n  }\n}\n\nexport class SessionDisposedError extends SessionError {\n  constructor(context?: Record<string, unknown>) {\n    super('Session has been disposed', ErrorCode.SESSION_DISPOSED, context);\n  }\n}\n\nexport class SessionServerError extends SessionError {\n  constructor(reason: string, context?: Record<string, unknown>) {\n    super(\n      `Server returned an error response: ${reason}`,\n      ErrorCode.SERVER_ERROR,\n      { reason, ...context }\n    );\n  }\n}\n\nexport class SessionMessageParseError extends SessionError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'Failed to parse server message',\n      ErrorCode.MESSAGE_PARSE_FAILED,\n      context\n    );\n  }\n}\n\n/**\n * The remote server returned an explicit error response.\n * Carries the full WebSocketError payload so callers can inspect\n * `serverError.type` and `serverError.details`.\n */\nexport class SessionRemoteError extends SessionError {\n  constructor(\n    public readonly serverError: WebSocketError,\n    context?: Record<string, unknown>\n  ) {\n    super(serverError.message, ErrorCode.SERVER_ERROR, context);\n  }\n}\n\n// ─── Client errors ────────────────────────────────────────────────────────────\n\nexport class ClientUnsupportedAlgorithmError extends ClientError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'Signing algorithm is not supported',\n      ErrorCode.UNSUPPORTED_ALGORITHM,\n      context\n    );\n  }\n}\n\nexport class ClientSessionEstablishFailedError extends ClientError {\n  constructor(context?: Record<string, unknown>) {\n    super(\n      'Failed to establish session',\n      ErrorCode.SESSION_ESTABLISH_FAILED,\n      context\n    );\n  }\n}\n","import {\n  ForwardMPCError,\n  SessionAttestationError,\n  SessionRequestTimeoutError,\n} from './errors';\n\n/**\n * Error classification result from Forward MPC operations.\n */\nexport type ForwardMpcErrorType =\n  | 'ATTESTATION_FAILURE'\n  | 'FORWARD_MPC_TIMEOUT'\n  | 'FORWARD_MPC_ERROR';\n\n/**\n * Result of classifying a Forward MPC error.\n */\nexport interface ForwardMpcErrorClassification {\n  /** The type of error encountered */\n  errorType: ForwardMpcErrorType;\n  /** Error code from ForwardMPCError, if available */\n  errorCode: string | undefined;\n  /** Error message */\n  errorMessage: string;\n  /** Attestation verification errors, if this is an attestation failure */\n  attestationErrors?: unknown[];\n  /** Whether the session was established before the error occurred */\n  sessionEstablished: boolean;\n  /** Whether this error should trigger a fallback to relay-based MPC */\n  shouldFallback: boolean;\n}\n\n/**\n * Classifies a Forward MPC error and returns structured data for logging.\n * Use this to standardize error handling across keygen, signing, and connect operations.\n *\n * @param error - The error to classify\n * @returns Classification result with error details and recommended action\n *\n * @example\n * ```typescript\n * try {\n *   await forwardMpcClient.sign(...);\n * } catch (error) {\n *   const classification = classifyForwardMpcError(error);\n *   logger.warn(`Forward MPC ${operation} failed`, {\n *     ...classification,\n *     chainName,\n *     environmentId,\n *   });\n *   if (classification.shouldFallback) {\n *     // Fall through to relay-based MPC\n *   } else {\n *     throw error;\n *   }\n * }\n * ```\n */\nexport function classifyForwardMpcError(\n  error: unknown\n): ForwardMpcErrorClassification {\n  if (error instanceof SessionAttestationError) {\n    return {\n      errorType: 'ATTESTATION_FAILURE',\n      errorCode: error.code,\n      errorMessage: error.message,\n      attestationErrors: error.context?.['errors'] as unknown[] | undefined,\n      sessionEstablished: false,\n      shouldFallback: true,\n    };\n  }\n\n  if (error instanceof SessionRequestTimeoutError) {\n    return {\n      errorType: 'FORWARD_MPC_TIMEOUT',\n      errorCode: error.code,\n      errorMessage: error.message,\n      sessionEstablished: true,\n      shouldFallback: false,\n    };\n  }\n\n  if (error instanceof ForwardMPCError) {\n    return {\n      errorType: 'FORWARD_MPC_ERROR',\n      errorCode: error.code,\n      errorMessage: error.message,\n      sessionEstablished: true,\n      shouldFallback: false,\n    };\n  }\n\n  // Unknown error type\n  return {\n    errorType: 'FORWARD_MPC_ERROR',\n    errorCode: undefined,\n    errorMessage: error instanceof Error ? error.message : String(error),\n    sessionEstablished: false,\n    shouldFallback: false,\n  };\n}\n\n/**\n * Type guard to check if an error is a Forward MPC error that should be handled.\n */\nexport function isForwardMpcError(error: unknown): error is ForwardMPCError {\n  return error instanceof ForwardMPCError;\n}\n\n/**\n * Type guard to check if an error is an attestation failure.\n */\nexport function isAttestationError(\n  error: unknown\n): error is SessionAttestationError {\n  return error instanceof SessionAttestationError;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs-wallet/forward-mpc-client",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "description": "WebSocket client for Forward MPC operations",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,26 +28,29 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js",
+      "require": "./dist/utils.cjs"
     }
   },
-  "peerDependencies": {
-    "@dynamic-labs-wallet/core": ">=0.0.328"
-  },
   "dependencies": {
     "@evervault/wasm-attestation-bindings": "^0.3.1",
     "@noble/hashes": "^2.0.0",
-    "@noble/post-quantum": "^0.5.1",
     "eventemitter3": "^5.0.1",
     "fp-ts": "^2.16.11",
     "isows": "^1.0.7",
     "ws": "^8.18.3",
-    "@dynamic-labs-wallet/forward-mpc-shared": "0.6.0"
+    "@dynamic-labs-wallet/forward-mpc-shared": "0.7.0"
+  },
+  "peerDependencies": {
+    "@dynamic-labs-wallet/primitives": ">=0.0.336 || 0.0.1"
   },
   "devDependencies": {
-    "@dynamic-labs-wallet/core": ">=0.0.328",
     "@types/node": "^24.5.1",
     "@types/ws": "^8.18.1",
-    "rimraf": "^6.0.1",
+    "rimraf": "^6.1.0",
     "tsup": "^8.3.5",
     "typescript": "^5.9.2",
     "vitest": "^4.0.10"
@@ -59,7 +62,8 @@
     "client"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node ./scripts/verify-utils-rn-safe.mjs",
+    "verify:utils-rn-safe": "node ./scripts/verify-utils-rn-safe.mjs",
     "dev": "tsup --watch",
     "clean": "rimraf dist .tsbuildinfo",
     "test": "vitest run",