@getpara/server-sdk 3.1.0 → 3.2.0

package/dist/cjs/workers/mpcWorkerError.js

@@ -0,0 +1,61 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mpcWorkerError_exports = {};
+__export(mpcWorkerError_exports, {
+  classifyMpcError: () => classifyMpcError,
+  unwrapMpcError: () => unwrapMpcError,
+  wrapMpcError: () => wrapMpcError
+});
+module.exports = __toCommonJS(mpcWorkerError_exports);
+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";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  classifyMpcError,
+  unwrapMpcError,
+  wrapMpcError
+});

package/dist/cjs/workers/walletUtils.js

@@ -62,6 +62,7 @@ __export(walletUtils_exports, {
 module.exports = __toCommonJS(walletUtils_exports);
 var import_core_sdk = require("@getpara/core-sdk");
 var uuid = __toESM(require("uuid"));
+var import_mpcWorkerError = require("./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) {
@@ -114,8 +115,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 (0, import_mpcWorkerError.wrapMpcError)(`error creating ED25519 account with userId ${userId} and walletId ${walletId}`, mpcErr, {
+        walletId,
+        protocolId
+      });
     }
   });
 }
@@ -138,8 +142,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 (0, import_mpcWorkerError.wrapMpcError)(`error creating ED25519 account with walletId ${walletId}`, mpcErr, { walletId, protocolId });
     }
   });
 }
@@ -159,11 +163,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 (0, import_mpcWorkerError.wrapMpcError)(`error signing for account of type SOLANA with userId ${userId} and walletId ${walletId}`, mpcErr, {
+            protocolId
+          });
         }
       });
     }();
+    signRes.catch(() => {
+    });
     const { pendingTransactionId } = yield preSignMessageRes;
     if (pendingTransactionId) {
       return { pendingTransactionId };
@@ -207,8 +215,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 (0, import_mpcWorkerError.wrapMpcError)(`error creating account of type ${type} with userId ${userId} and walletId ${walletId}`, mpcErr, {
+        walletId,
+        protocolId
+      });
     }
   });
 }
@@ -248,8 +259,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 (0, import_mpcWorkerError.wrapMpcError)(`error creating account of type ${type} with walletId ${walletId}`, mpcErr, { walletId, protocolId });
     }
   });
 }
@@ -273,11 +284,13 @@ function signMessage(ctx, share, walletId, userId, message) {
               resolve({ signature: result });
             })
           );
-        } catch (e) {
-          throw new Error(`error signing for account with userId ${userId} and walletId ${walletId}`);
+        } catch (mpcErr) {
+          throw (0, import_mpcWorkerError.wrapMpcError)(`error signing for account with userId ${userId} and walletId ${walletId}`, mpcErr, { protocolId });
         }
       });
     }();
+    signMessageRes.catch(() => {
+    });
     const { pendingTransactionId } = yield preSignMessageRes;
     if (pendingTransactionId) {
       return { pendingTransactionId };
@@ -310,11 +323,15 @@ 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 (0, import_mpcWorkerError.wrapMpcError)(`error signing transaction for account with userId ${userId} and walletId ${walletId}`, mpcErr, {
+            protocolId
+          });
         }
       });
     }();
+    signTxRes.catch(() => {
+    });
     const {
       data: { pendingTransactionId }
     } = yield signTransactionRes;
@@ -349,11 +366,17 @@ 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 (0, import_mpcWorkerError.wrapMpcError)(
+            `error signing transaction to send for account with userId ${userId} and walletId ${walletId}`,
+            mpcErr,
+            { protocolId }
+          );
         }
       });
     }();
+    sendTxRes.catch(() => {
+    });
     const {
       data: { pendingTransactionId }
     } = yield sendTransactionRes;
@@ -379,8 +402,8 @@ function refresh(ctx, share, walletId, userId) {
           resolve(result);
         })
       );
-    } catch (e) {
-      throw new Error(`error refreshing keys for account with userId ${userId} and walletId ${walletId}`);
+    } catch (mpcErr) {
+      throw (0, import_mpcWorkerError.wrapMpcError)(`error refreshing keys for account with userId ${userId} and walletId ${walletId}`, mpcErr);
     }
   });
 }
@@ -400,8 +423,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 (0, import_mpcWorkerError.wrapMpcError)(`error getting private key for account with userId ${userId} and walletId ${walletId}`, mpcErr);
     }
   });
 }
@@ -421,8 +444,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 (0, import_mpcWorkerError.wrapMpcError)(
+        `error getting ed25519 private key for account with userId ${userId} and walletId ${walletId}`,
+        mpcErr
+      );
     }
   });
 }

package/dist/cjs/workers/worker.js

@@ -2,8 +2,22 @@ var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
 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 __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -55,6 +69,7 @@ module.exports = __toCommonJS(worker_exports);
 var import_axios = __toESM(require("axios"));
 var import_core_sdk = require("@getpara/core-sdk");
 var walletUtils = __toESM(require("./walletUtils.js"));
+var import_mpcWorkerError = require("./mpcWorkerError.js");
 let rawWasm;
 let wasmLoaded = false;
 function requestWasmWithRetries(ctx, retries = 3) {
@@ -160,13 +175,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) {
@@ -177,6 +196,31 @@ function withRetry(operation, maxRetries = 2, timeoutMs = 1e4) {
     }
   });
 }
+function reportWorkerError(ctx, data, err) {
+  return __async(this, null, function* () {
+    var _a;
+    try {
+      const { cause, context } = (0, import_mpcWorkerError.unwrapMpcError)(err);
+      yield ctx.client.trackError({
+        methodName: `mpcWorker.${data.functionType}`,
+        sdkType: "SERVER",
+        userId: (_a = data.params.userId) != null ? _a : "",
+        sdkVersion: import_core_sdk.paraVersion,
+        error: { name: (0, import_mpcWorkerError.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) {
   return __async(this, null, function* () {
     const {
@@ -200,22 +244,28 @@ function handleMessage(e) {
       disableWebSockets: !!disableWebSockets,
       cosmosPrefix
     };
-    if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
-      yield loadWasm(ctx);
-      if (global.initWasm) {
-        const serverUrl = (0, import_core_sdk.getBaseMPCNetworkUrl)(ctx.env, !ctx.disableWebSockets);
-        yield new Promise(
-          (resolve, reject) => global.initWasm((err, result2) => {
-            if (err) {
-              reject(err);
-            }
-            resolve(result2);
-          }, serverUrl)
-        );
-      }
-      wasmLoaded = true;
+    let result;
+    try {
+      if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
+        yield loadWasm(ctx);
+        if (global.initWasm) {
+          const serverUrl = (0, import_core_sdk.getBaseMPCNetworkUrl)(ctx.env, !ctx.disableWebSockets);
+          yield new Promise(
+            (resolve, reject) => global.initWasm((err, initResult) => {
+              if (err) {
+                reject(err);
+              }
+              resolve(initResult);
+            }, serverUrl)
+          );
+        }
+        wasmLoaded = true;
+      }
+      result = yield executeMessage(ctx, e.data);
+    } catch (err) {
+      yield reportWorkerError(ctx, e.data, err);
+      throw err;
     }
-    const result = yield executeMessage(ctx, e.data);
     result.workId = workId;
     return result;
   });

package/dist/esm/workers/mpcWorkerError.js

@@ -0,0 +1,36 @@
+import "../chunk-FTA5RKYX.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) {
+  const top = err;
+  const cause = top?.cause !== void 0 ? toError(top.cause) : toError(err);
+  const context = top?.mpcContext ?? {};
+  return { cause, context };
+}
+function classifyMpcError(message) {
+  const m = (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/esm/workers/walletUtils.js

@@ -1,6 +1,7 @@
 import "../chunk-FTA5RKYX.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}}`;
 async function keygenRequest(ctx, userId, walletId, protocolId) {
@@ -46,8 +47,11 @@ async function ed25519Keygen(ctx, userId, _sessionCookie, _emailProps, type = "S
       })
     );
     return { signer: newSigner, walletId };
-  } catch {
-    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
+    });
   }
 }
 async function ed25519PreKeygen(ctx, pregenIdentifier, pregenIdentifierType, _sessionCookie, type = "SOLANA") {
@@ -68,8 +72,8 @@ async function ed25519PreKeygen(ctx, pregenIdentifier, pregenIdentifierType, _se
       })
     );
     return { signer: newSigner, walletId };
-  } catch {
-    throw new Error(`error creating ED25519 account with walletId ${walletId}`);
+  } catch (mpcErr) {
+    throw wrapMpcError(`error creating ED25519 account with walletId ${walletId}`, mpcErr, { walletId, protocolId });
   }
 }
 async function ed25519Sign(ctx, share, userId, walletId, base64Bytes) {
@@ -86,10 +90,14 @@ async function ed25519Sign(ctx, share, userId, walletId, base64Bytes) {
         })
       );
       return { signature: base64Sig };
-    } catch {
-      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 } = await preSignMessageRes;
   if (pendingTransactionId) {
     return { pendingTransactionId };
@@ -131,8 +139,11 @@ async function keygen(ctx, userId, type, secretKey) {
       )
     );
     return { signer: newSigner, walletId };
-  } catch {
-    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
+    });
   }
 }
 async function preKeygen(ctx, partnerId, pregenIdentifier, pregenIdentifierType, type, secretKey) {
@@ -170,8 +181,8 @@ async function preKeygen(ctx, partnerId, pregenIdentifier, pregenIdentifierType,
       )
     );
     return { signer: newSigner, walletId };
-  } catch {
-    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 });
   }
 }
 async function signMessage(ctx, share, walletId, userId, message) {
@@ -192,10 +203,12 @@ async function signMessage(ctx, share, walletId, userId, message) {
           resolve({ signature: result });
         })
       );
-    } catch {
-      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 } = await preSignMessageRes;
   if (pendingTransactionId) {
     return { pendingTransactionId };
@@ -225,10 +238,14 @@ async function signTransaction(ctx, share, walletId, userId, tx, chainId) {
           resolve({ signature: result });
         })
       );
-    } catch {
-      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 }
   } = await signTransactionRes;
@@ -260,10 +277,16 @@ async function sendTransaction(ctx, share, walletId, userId, tx, chainId) {
           resolve({ signature: result });
         })
       );
-    } catch {
-      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 }
   } = await sendTransactionRes;
@@ -287,8 +310,8 @@ async function refresh(ctx, share, walletId, userId) {
         resolve(result);
       })
     );
-  } catch {
-    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);
   }
 }
 async function getPrivateKey(ctx, share, walletId, userId) {
@@ -306,8 +329,8 @@ async function getPrivateKey(ctx, share, walletId, userId) {
         resolve(result);
       })
     );
-  } catch {
-    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);
   }
 }
 async function getED25519PrivateKey(ctx, share, walletId, userId) {
@@ -325,8 +348,11 @@ async function getED25519PrivateKey(ctx, share, walletId, userId) {
         resolve(result);
       })
     );
-  } catch {
-    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
+    );
   }
 }
 export {

package/dist/esm/workers/worker.js

@@ -1,3 +1,19 @@
+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 {
   paraVersion
 } from "@getpara/core-sdk";
 import * as walletUtils from "./walletUtils.js";
+import { classifyMpcError, unwrapMpcError } from "./mpcWorkerError.js";
 let rawWasm;
 let wasmLoaded = false;
 function requestWasmWithRetries(ctx, retries = 3) {
@@ -132,13 +149,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) {
@@ -149,6 +170,31 @@ function withRetry(operation, maxRetries = 2, timeoutMs = 1e4) {
     }
   });
 }
+function reportWorkerError(ctx, data, err) {
+  return __async(this, null, function* () {
+    var _a;
+    try {
+      const { cause, context } = unwrapMpcError(err);
+      yield ctx.client.trackError({
+        methodName: `mpcWorker.${data.functionType}`,
+        sdkType: "SERVER",
+        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) {
   return __async(this, null, function* () {
     const {
@@ -172,22 +218,28 @@ function handleMessage(e) {
       disableWebSockets: !!disableWebSockets,
       cosmosPrefix
     };
-    if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
-      yield loadWasm(ctx);
-      if (global.initWasm) {
-        const serverUrl = getBaseMPCNetworkUrl(ctx.env, !ctx.disableWebSockets);
-        yield new Promise(
-          (resolve, reject) => global.initWasm((err, result2) => {
-            if (err) {
-              reject(err);
-            }
-            resolve(result2);
-          }, serverUrl)
-        );
-      }
-      wasmLoaded = true;
+    let result;
+    try {
+      if (!wasmLoaded && (!ctx.offloadMPCComputationURL || ctx.useDKLS)) {
+        yield loadWasm(ctx);
+        if (global.initWasm) {
+          const serverUrl = getBaseMPCNetworkUrl(ctx.env, !ctx.disableWebSockets);
+          yield new Promise(
+            (resolve, reject) => global.initWasm((err, initResult) => {
+              if (err) {
+                reject(err);
+              }
+              resolve(initResult);
+            }, serverUrl)
+          );
+        }
+        wasmLoaded = true;
+      }
+      result = yield executeMessage(ctx, e.data);
+    } catch (err) {
+      yield reportWorkerError(ctx, e.data, err);
+      throw err;
     }
-    const result = yield executeMessage(ctx, e.data);
     result.workId = workId;
     return result;
   });

package/dist/types/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/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@getpara/server-sdk",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "dependencies": {
-    "@getpara/core-sdk": "3.1.0",
-    "@getpara/user-management-client": "3.1.0",
-    "@getpara/viem-v2-integration": "3.1.0",
+    "@getpara/core-sdk": "3.2.0",
+    "@getpara/user-management-client": "3.2.0",
+    "@getpara/viem-v2-integration": "3.2.0",
     "uuid": "^11.1.0",
     "ws": "^8.14.2"
   },
@@ -16,7 +16,7 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "e73f17cd7960fdfe62ff68a972b3461e47b21eb0",
+  "gitHead": "096152f48e9d9a64fdb192588315c64d33d15a1b",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "scripts": {