@getpara/web-sdk 3.1.0 → 3.2.0

package/dist/workers/mpcWorkerError.d.ts

@@ -0,0 +1,14 @@
+export interface MpcErrorContext {
+    protocolId?: string;
+    walletId?: string;
+    userId?: string;
+    chainId?: string;
+    functionType?: string;
+    [key: string]: unknown;
+}
+export declare function wrapMpcError(summary: string, cause: unknown, context?: MpcErrorContext): Error;
+export declare function unwrapMpcError(err: unknown): {
+    cause: Error;
+    context: MpcErrorContext;
+};
+export declare function classifyMpcError(message: string | undefined): string;

package/dist/workers/mpcWorkerError.js

@@ -0,0 +1,38 @@
+"use client";
+import "../chunk-YJOFEY2L.js";
+function toError(value) {
+  return value instanceof Error ? value : new Error(String(value));
+}
+function wrapMpcError(summary, cause, context) {
+  const err = new Error(summary);
+  err.cause = toError(cause);
+  if (context) {
+    err.mpcContext = context;
+  }
+  return err;
+}
+function unwrapMpcError(err) {
+  var _a;
+  const top = err;
+  const cause = (top == null ? void 0 : top.cause) !== void 0 ? toError(top.cause) : toError(err);
+  const context = (_a = top == null ? void 0 : top.mpcContext) != null ? _a : {};
+  return { cause, context };
+}
+function classifyMpcError(message) {
+  const m = (message != null ? message : "").toLowerCase();
+  if (m.includes("panic")) return "MpcPanicError";
+  if (/\bwasm\b|webassembly/.test(m)) return "MpcWasmError";
+  if (/connection|websocket|\bdial\b|getconnection|econnrefused|network|broken pipe/.test(m)) {
+    return "MpcConnectionError";
+  }
+  if (/timed out|timeout|deadline/.test(m)) return "MpcTimeoutError";
+  if (/deserialize|unmarshal|invalid share|config from (sender|receiver)|reconstruct|magic bytes/.test(m)) {
+    return "MpcShareError";
+  }
+  return "MpcProtocolError";
+}
+export {
+  classifyMpcError,
+  unwrapMpcError,
+  wrapMpcError
+};

package/dist/workers/walletUtils.js

@@ -4,6 +4,7 @@ import {
 } from "../chunk-YJOFEY2L.js";
 import { getBaseMPCNetworkUrl } from "@getpara/core-sdk";
 import * as uuid from "uuid";
+import { wrapMpcError } from "./mpcWorkerError.js";
 const configCGGMPBase = (serverUrl, walletId, id) => `{"ServerUrl":"${serverUrl}", "WalletId": "${walletId}", "Id":"${id}", "Ids":["USER","CAPSULE"], "Threshold":1}`;
 const configDKLSBase = (walletId, id, disableWebSockets) => `{"walletId": "${walletId}", "id":"${id}", "otherId":"CAPSULE", "isReceiver": false, "disableWebSockets": ${disableWebSockets}}`;
 function keygenRequest(ctx, userId, walletId, protocolId) {
@@ -56,8 +57,11 @@ function ed25519Keygen(ctx, userId, _sessionCookie, _emailProps, type = "SOLANA"
         })
       );
       return { signer: newSigner, walletId };
-    } catch (e) {
-      throw new Error(`error creating ED25519 account with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error creating ED25519 account with userId ${userId} and walletId ${walletId}`, mpcErr, {
+        walletId,
+        protocolId
+      });
     }
   });
 }
@@ -80,8 +84,8 @@ function ed25519PreKeygen(ctx, pregenIdentifier, pregenIdentifierType, _sessionC
         })
       );
       return { signer: newSigner, walletId };
-    } catch (e) {
-      throw new Error(`error creating ED25519 account with walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error creating ED25519 account with walletId ${walletId}`, mpcErr, { walletId, protocolId });
     }
   });
 }
@@ -101,11 +105,15 @@ function ed25519Sign(ctx, share, userId, walletId, base64Bytes) {
             })
           );
           return { signature: base64Sig };
-        } catch (e) {
-          throw new Error(`error signing for account of type SOLANA with userId ${userId} and walletId ${walletId}`);
+        } catch (mpcErr) {
+          throw wrapMpcError(`error signing for account of type SOLANA with userId ${userId} and walletId ${walletId}`, mpcErr, {
+            protocolId
+          });
         }
       });
     }();
+    signRes.catch(() => {
+    });
     const { pendingTransactionId } = yield preSignMessageRes;
     if (pendingTransactionId) {
       signRes.catch(() => {
@@ -151,8 +159,11 @@ function keygen(ctx, userId, type, secretKey) {
         )
       );
       return { signer: newSigner, walletId };
-    } catch (e) {
-      throw new Error(`error creating account of type ${type} with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error creating account of type ${type} with userId ${userId} and walletId ${walletId}`, mpcErr, {
+        walletId,
+        protocolId
+      });
     }
   });
 }
@@ -185,8 +196,8 @@ function preKeygen(ctx, _partnerId, pregenIdentifier, pregenIdentifierType, type
         )
       );
       return { signer: newSigner, walletId };
-    } catch (e) {
-      throw new Error(`error creating account of type ${type} with walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error creating account of type ${type} with walletId ${walletId}`, mpcErr, { walletId, protocolId });
     }
   });
 }
@@ -215,15 +226,15 @@ function signMessage(ctx, share, walletId, userId, message, cosmosSignDoc) {
               resolve({ signature: result });
             })
           );
-        } catch (e) {
-          throw new Error(`error signing for account with userId ${userId} and walletId ${walletId}`);
+        } catch (mpcErr) {
+          throw wrapMpcError(`error signing for account with userId ${userId} and walletId ${walletId}`, mpcErr, { protocolId });
         }
       });
     }();
+    signMessageRes.catch(() => {
+    });
     const { pendingTransactionId } = yield preSignMessageRes;
     if (pendingTransactionId) {
-      signMessageRes.catch(() => {
-      });
       return { pendingTransactionId };
     }
     return yield signMessageRes;
@@ -259,17 +270,19 @@ function signTransaction(ctx, share, walletId, userId, tx, chainId) {
               resolve({ signature: result });
             })
           );
-        } catch (e) {
-          throw new Error(`error signing transaction for account with userId ${userId} and walletId ${walletId}`);
+        } catch (mpcErr) {
+          throw wrapMpcError(`error signing transaction for account with userId ${userId} and walletId ${walletId}`, mpcErr, {
+            protocolId
+          });
         }
       });
     }();
+    signTxRes.catch(() => {
+    });
     const {
       data: { pendingTransactionId }
     } = yield signTransactionRes;
     if (pendingTransactionId) {
-      signTxRes.catch(() => {
-      });
       return { pendingTransactionId };
     }
     return yield signTxRes;
@@ -305,17 +318,21 @@ function sendTransaction(ctx, share, walletId, userId, tx, chainId) {
               resolve({ signature: result });
             })
           );
-        } catch (e) {
-          throw new Error(`error signing transaction to send for account with userId ${userId} and walletId ${walletId}`);
+        } catch (mpcErr) {
+          throw wrapMpcError(
+            `error signing transaction to send for account with userId ${userId} and walletId ${walletId}`,
+            mpcErr,
+            { protocolId }
+          );
         }
       });
     }();
+    sendTxRes.catch(() => {
+    });
     const {
       data: { pendingTransactionId }
     } = yield sendTransactionRes;
     if (pendingTransactionId) {
-      sendTxRes.catch(() => {
-      });
       return { pendingTransactionId };
     }
     return yield sendTxRes;
@@ -342,8 +359,8 @@ function refresh(ctx, share, walletId, userId, oldPartnerId, newPartnerId, keySh
           resolve({ protocolId, signer: result });
         })
       );
-    } catch (e) {
-      throw new Error(`error refreshing keys for account with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error refreshing keys for account with userId ${userId} and walletId ${walletId}`, mpcErr);
     }
   });
 }
@@ -362,8 +379,8 @@ function getPrivateKey(ctx, share, walletId, userId) {
           resolve(result);
         })
       );
-    } catch (e) {
-      throw new Error(`error getting private key for account with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(`error getting private key for account with userId ${userId} and walletId ${walletId}`, mpcErr);
     }
   });
 }
@@ -382,8 +399,11 @@ function getED25519PrivateKey(ctx, share, walletId, userId) {
           resolve(result);
         })
       );
-    } catch (e) {
-      throw new Error(`error getting ed25519 private key for account with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw wrapMpcError(
+        `error getting ed25519 private key for account with userId ${userId} and walletId ${walletId}`,
+        mpcErr
+      );
     }
   });
 }

package/dist/workers/worker.js

@@ -1,4 +1,20 @@
 "use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -27,6 +43,7 @@ import {
   mpcComputationClient,
   paraVersion
 } from "@getpara/core-sdk";
+import { classifyMpcError, unwrapMpcError } from "./mpcWorkerError.js";
 let wasmLoaded = false;
 function tryFetchWasm(url) {
   return __async(this, null, function* () {
@@ -144,13 +161,17 @@ function withRetry(operation, maxRetries = 2, timeoutMs = 1e4) {
     while (true) {
       try {
         const operationPromise = operation();
+        let timeoutId;
         const timeoutPromise = new Promise((_, reject) => {
-          const timeoutId = setTimeout(() => {
+          timeoutId = setTimeout(() => {
             reject(new Error(`Operation timed out after ${timeoutMs}ms`));
           }, timeoutMs);
-          operationPromise.finally(() => clearTimeout(timeoutId));
         });
-        return yield Promise.race([operationPromise, timeoutPromise]);
+        try {
+          return yield Promise.race([operationPromise, timeoutPromise]);
+        } finally {
+          clearTimeout(timeoutId);
+        }
       } catch (error) {
         retries++;
         if (retries > maxRetries) {
@@ -161,6 +182,31 @@ function withRetry(operation, maxRetries = 2, timeoutMs = 1e4) {
     }
   });
 }
+function reportWorkerError(ctx, sdkType, data, err) {
+  return __async(this, null, function* () {
+    var _a;
+    try {
+      const { cause, context } = unwrapMpcError(err);
+      yield ctx.client.trackError({
+        methodName: `mpcWorker.${data.functionType}`,
+        sdkType,
+        userId: (_a = data.params.userId) != null ? _a : "",
+        sdkVersion: paraVersion,
+        error: { name: classifyMpcError(cause.message), message: cause.message },
+        context: __spreadValues({
+          functionType: data.functionType,
+          // worker-level identifiers (present for most signing ops); the wrapped
+          // context (spread last) supplies walletId/protocolId for keygen flows
+          // where params don't carry them.
+          userId: data.params.userId,
+          walletId: data.params.walletId,
+          chainId: data.params.chainId
+        }, context)
+      });
+    } catch (e) {
+    }
+  });
+}
 function handleMessage(e, postMessage, useFetchAdapter) {
   return __async(this, null, function* () {
     const {
@@ -201,25 +247,31 @@ function handleMessage(e, postMessage, useFetchAdapter) {
       disableWebSockets: !!disableWebSockets,
       wasmOverride
     };
-    if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
-      yield loadWasm(ctx, wasmOverride);
-      const serverUrl = getBaseMPCNetworkUrl(ctx.env, !ctx.disableWebSockets);
-      if (globalThis.initWasm) {
-        yield new Promise(
-          (resolve, reject) => {
-            var _a;
-            return (_a = globalThis.initWasm) == null ? void 0 : _a.call(globalThis, (err, result2) => {
-              if (err) {
-                reject(err);
-              }
-              resolve(result2);
-            }, serverUrl);
-          }
-        );
+    let result;
+    try {
+      if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
+        yield loadWasm(ctx, wasmOverride);
+        const serverUrl = getBaseMPCNetworkUrl(ctx.env, !ctx.disableWebSockets);
+        if (globalThis.initWasm) {
+          yield new Promise(
+            (resolve, reject) => {
+              var _a;
+              return (_a = globalThis.initWasm) == null ? void 0 : _a.call(globalThis, (err, initResult) => {
+                if (err) {
+                  reject(err);
+                }
+                resolve(initResult);
+              }, serverUrl);
+            }
+          );
+        }
+        wasmLoaded = true;
       }
-      wasmLoaded = true;
+      result = yield executeMessage(ctx, e.data);
+    } catch (err) {
+      yield reportWorkerError(ctx, "WEB", e.data, err);
+      throw err;
     }
-    const result = yield executeMessage(ctx, e.data);
     if (workId) {
       result.workId = workId;
     }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@getpara/web-sdk",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "dependencies": {
-    "@getpara/core-sdk": "3.1.0",
-    "@getpara/user-management-client": "3.1.0",
+    "@getpara/core-sdk": "3.2.0",
+    "@getpara/user-management-client": "3.2.0",
     "@opentelemetry/api": "^1.9.1",
     "base64url": "^3.0.1",
     "buffer": "6.0.3",
@@ -30,7 +30,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "e73f17cd7960fdfe62ff68a972b3461e47b21eb0",
+  "gitHead": "096152f48e9d9a64fdb192588315c64d33d15a1b",
   "main": "dist/index.js",
   "scripts": {
     "build": "rm -rf dist && yarn typegen && node ./scripts/build.mjs && yarn post-build",