@asseteragmbh/wallet-connector 0.1.2 → 0.2.1

package/dist/index.cjs

@@ -4,6 +4,11 @@
 var PROTOCOL_VERSION = 1;
 var CONNECT_PATH = "/connect";
 var ONBOARD_PATH = "/onboard";
+var MANAGE_PATH = "/manage";
+var SIGN_IN_HINTS = ["assetera-marketplace"];
+function isSignInHint(value) {
+  return SIGN_IN_HINTS.includes(value);
+}
 var MESSAGE_PREFIX = "assetera-wallet:";
 var SUPPORTED_METHODS = [
   "eth_requestAccounts",
@@ -48,6 +53,21 @@ function isResponseMessage(value) {
 function isEventMessage(value) {
   return hasType(value, "event") && (value.event === "accountsChanged" || value.event === "chainChanged" || value.event === "disconnect");
 }
+var WALLET_PROTECTIONS = [
+  "unknown",
+  "add-factor",
+  "save-codes",
+  "create-codes",
+  "protected"
+];
+function isCount(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isSecurityMessage(value) {
+  if (!hasType(value, "security")) return false;
+  const data = value.data;
+  return isRecord(data) && typeof data.protection === "string" && WALLET_PROTECTIONS.includes(data.protection) && isCount(data.passkeys) && isCount(data.authenticatorApps);
+}
 function isRequestMessage(value) {
   return hasType(value, "request") && typeof value.id === "string" && typeof value.method === "string";
 }
@@ -56,7 +76,8 @@ function isDisconnectMessage(value) {
 }
 var EVM_ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
 function isOnboardedMessage(value) {
-  return hasType(value, "onboarded") && typeof value.address === "string" && EVM_ADDRESS_RE.test(value.address) && typeof value.chain === "string" && (value.status === "approved" || value.status === "pending");
+  return hasType(value, "onboarded") && typeof value.address === "string" && EVM_ADDRESS_RE.test(value.address) && typeof value.chain === "string" && // `created` is new; an older wallet sent `status` instead and always created or reused a wallet.
+  (typeof value.created === "boolean" || value.status === "approved" || value.status === "pending");
 }
 function isOnboardCancelledMessage(value) {
   return hasType(value, "onboard-cancelled") && (value.reason === "user" || value.reason === "refused" || value.reason === "error");
@@ -64,10 +85,11 @@ function isOnboardCancelledMessage(value) {
 function isCaip2EvmChain(value) {
   return /^eip155:\d{1,32}$/.test(value);
 }
-function connectUrl(walletUrl, partnerOrigin) {
+function connectUrl(walletUrl, partnerOrigin, signIn) {
   const url = new URL(CONNECT_PATH, walletUrl);
   url.searchParams.set("origin", partnerOrigin);
   url.searchParams.set("v", String(PROTOCOL_VERSION));
+  if (signIn !== void 0) url.searchParams.set("signIn", signIn);
   return url.toString();
 }
 function onboardUrl(walletUrl, partnerOrigin, options) {
@@ -76,6 +98,16 @@ function onboardUrl(walletUrl, partnerOrigin, options) {
   url.searchParams.set("v", String(PROTOCOL_VERSION));
   url.searchParams.set("chain", options.chain);
   if (options.locale !== void 0) url.searchParams.set("lang", options.locale);
+  if (options.add) url.searchParams.set("add", "1");
+  if (options.signIn !== void 0) url.searchParams.set("signIn", options.signIn);
+  return url.toString();
+}
+function manageUrl(walletUrl, partnerOrigin, options = {}) {
+  const url = new URL(MANAGE_PATH, walletUrl);
+  url.searchParams.set("origin", partnerOrigin);
+  url.searchParams.set("v", String(PROTOCOL_VERSION));
+  if (options.locale !== void 0) url.searchParams.set("lang", options.locale);
+  if (options.signIn !== void 0) url.searchParams.set("signIn", options.signIn);
   return url.toString();
 }
 
@@ -121,6 +153,7 @@ function createAsseteraWalletProvider(options) {
   let accounts = [];
   let chainIdHex = null;
   let walletDisconnected = false;
+  let lastSecurity;
   const pending = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Map();
   let closeTimer = null;
@@ -195,7 +228,7 @@ function createAsseteraWalletProvider(options) {
     }
     if (typeof window === "undefined") return null;
     const opened = window.open(
-      connectUrl(options.walletUrl, window.location.origin),
+      connectUrl(options.walletUrl, window.location.origin, options.signIn),
       POPUP_NAME,
       popupFeatures
     );
@@ -246,6 +279,14 @@ function createAsseteraWalletProvider(options) {
     walletDisconnected = true;
     emit("disconnect", new ProviderRpcError(message.data.code, message.data.message, message.data.data));
   }
+  function handleSecurityMessage(message) {
+    lastSecurity = {
+      protection: message.data.protection,
+      passkeys: message.data.passkeys,
+      authenticatorApps: message.data.authenticatorApps
+    };
+    emit("assetera_security", lastSecurity);
+  }
   function onWindowMessage(event) {
     if (event.origin !== walletOrigin) return;
     if (popup === null || event.source !== popup) return;
@@ -258,6 +299,10 @@ function createAsseteraWalletProvider(options) {
       handleResponse(data);
       return;
     }
+    if (isSecurityMessage(data)) {
+      handleSecurityMessage(data);
+      return;
+    }
     if (isEventMessage(data)) handleEventMessage(data);
   }
   if (typeof window !== "undefined") window.addEventListener("message", onWindowMessage);
@@ -330,7 +375,23 @@ function createAsseteraWalletProvider(options) {
   function removeListener(event, listener) {
     removeEventListener(event, listener);
   }
-  return { request, on, removeListener, disconnect };
+  function lastSecurityStatus() {
+    return lastSecurity;
+  }
+  return { request, on, removeListener, disconnect, lastSecurityStatus };
+}
+
+// src/popup.ts
+var POPUP_WIDTH = 440;
+var POPUP_HEIGHT = 760;
+function defaultPopupFeatures(win) {
+  const screenX = Number.isFinite(win.screenX) ? win.screenX : 0;
+  const screenY = Number.isFinite(win.screenY) ? win.screenY : 0;
+  const outerWidth = Number.isFinite(win.outerWidth) ? win.outerWidth : POPUP_WIDTH;
+  const outerHeight = Number.isFinite(win.outerHeight) ? win.outerHeight : POPUP_HEIGHT;
+  const left = Math.max(0, Math.round(screenX + (outerWidth - POPUP_WIDTH) / 2));
+  const top = Math.max(0, Math.round(screenY + (outerHeight - POPUP_HEIGHT) / 2));
+  return `popup,width=${POPUP_WIDTH},height=${POPUP_HEIGHT},left=${left},top=${top}`;
 }
 
 // src/onboarding.ts
@@ -343,8 +404,6 @@ var OnboardingError = class extends Error {
   }
 };
 var POPUP_NAME2 = "assetera-wallet-onboarding";
-var POPUP_WIDTH = 440;
-var POPUP_HEIGHT = 760;
 var CLOSE_POLL_MS2 = 500;
 var OVERLAY_Z_INDEX = 2147483e3;
 var DEFAULT_LABELS = {
@@ -354,15 +413,6 @@ var DEFAULT_LABELS = {
   cancel: "Cancel",
   blocked: "Your browser blocked the Assetera Wallet window. Allow pop-ups for this site and try again."
 };
-function defaultPopupFeatures(win) {
-  const screenX = Number.isFinite(win.screenX) ? win.screenX : 0;
-  const screenY = Number.isFinite(win.screenY) ? win.screenY : 0;
-  const outerWidth = Number.isFinite(win.outerWidth) ? win.outerWidth : POPUP_WIDTH;
-  const outerHeight = Number.isFinite(win.outerHeight) ? win.outerHeight : POPUP_HEIGHT;
-  const left = Math.max(0, Math.round(screenX + (outerWidth - POPUP_WIDTH) / 2));
-  const top = Math.max(0, Math.round(screenY + (outerHeight - POPUP_HEIGHT) / 2));
-  return `popup,width=${POPUP_WIDTH},height=${POPUP_HEIGHT},left=${left},top=${top}`;
-}
 function resolveLabels(options) {
   const overrides = typeof options.overlay === "object" && options.overlay !== null ? options.overlay : {};
   const partnerName = options.partnerName;
@@ -484,7 +534,9 @@ function openAsseteraOnboarding(options) {
   const popup = targetWindow.open(
     onboardUrl(options.walletUrl, targetWindow.location.origin, {
       chain: options.chain,
-      ...options.locale === void 0 ? {} : { locale: options.locale }
+      ...options.locale === void 0 ? {} : { locale: options.locale },
+      ...options.addWallet ? { add: true } : {},
+      ...options.signIn === void 0 ? {} : { signIn: options.signIn }
     }),
     POPUP_NAME2,
     options.popupFeatures ?? defaultPopupFeatures(targetWindow)
@@ -494,10 +546,13 @@ function openAsseteraOnboarding(options) {
   }
   const activePopup = popup;
   return new Promise((resolve, reject) => {
-    let settled = false;
+    let onboarded = false;
+    let finished = false;
     let closeTimer = null;
     let overlay = null;
+    const pending = /* @__PURE__ */ new Map();
     function cleanup() {
+      finished = true;
       targetWindow.removeEventListener("message", onMessage);
       if (closeTimer !== null) {
         clearInterval(closeTimer);
@@ -506,44 +561,98 @@ function openAsseteraOnboarding(options) {
       overlay?.remove();
       overlay = null;
     }
-    function settle(action) {
-      if (settled) return;
-      settled = true;
+    function failPending(error) {
+      for (const entry of pending.values()) entry.reject(error);
+      pending.clear();
+    }
+    function close() {
+      if (finished) return;
+      failPending(new OnboardingError("closed", "The Assetera Wallet window was closed."));
       cleanup();
-      action();
+      if (!activePopup.closed) activePopup.close();
+    }
+    function fail(error) {
+      if (onboarded || finished) return;
+      cleanup();
+      reject(error);
     }
     function cancel() {
+      if (onboarded) {
+        close();
+        return;
+      }
       activePopup.close();
-      settle(
-        () => reject(new OnboardingError("cancelled", "The user cancelled the Assetera Wallet onboarding."))
-      );
+      fail(new OnboardingError("cancelled", "The user cancelled the Assetera Wallet onboarding."));
+    }
+    function signMessage(message) {
+      if (finished || activePopup.closed) {
+        return Promise.reject(new OnboardingError("closed", "The Assetera Wallet window was closed."));
+      }
+      const id = globalThis.crypto.randomUUID();
+      const request = {
+        type: `${MESSAGE_PREFIX}request`,
+        v: PROTOCOL_VERSION,
+        id,
+        method: "personal_sign",
+        params: [message, address]
+      };
+      return new Promise((resolveSign, rejectSign) => {
+        pending.set(id, { resolve: resolveSign, reject: rejectSign });
+        activePopup.focus();
+        activePopup.postMessage(request, walletOrigin);
+      });
     }
+    let address;
     function onMessage(event) {
       if (event.origin !== walletOrigin) return;
       if (event.source !== activePopup) return;
       const data = event.data;
-      if (isOnboardedMessage(data)) {
-        settle(() => resolve({ address: data.address, chain: data.chain, status: data.status }));
+      if (!onboarded) {
+        if (isOnboardedMessage(data)) {
+          onboarded = true;
+          address = data.address;
+          resolve({
+            address: data.address,
+            chain: data.chain,
+            created: data.created ?? true,
+            signMessage,
+            close
+          });
+          return;
+        }
+        if (isOnboardCancelledMessage(data)) {
+          fail(new OnboardingError(cancelCode(data.reason), data.message ?? cancelMessage(data.reason)));
+        }
         return;
       }
-      if (isOnboardCancelledMessage(data)) {
-        settle(
-          () => reject(new OnboardingError(cancelCode(data.reason), data.message ?? cancelMessage(data.reason)))
-        );
+      if (isResponseMessage(data)) {
+        const entry = pending.get(data.id);
+        if (!entry) return;
+        pending.delete(data.id);
+        if ("error" in data) {
+          entry.reject(
+            new OnboardingError(
+              data.error.code === RpcErrorCode.UserRejected ? "cancelled" : "failed",
+              data.error.message
+            )
+          );
+        } else if (typeof data.result === "string" && /^0x[0-9a-fA-F]+$/.test(data.result)) {
+          entry.resolve(data.result);
+        } else {
+          entry.reject(new OnboardingError("failed", "The Assetera Wallet returned no signature."));
+        }
       }
     }
     targetWindow.addEventListener("message", onMessage);
     closeTimer = setInterval(() => {
-      if (activePopup.closed) {
-        settle(
-          () => reject(
-            new OnboardingError(
-              "closed",
-              "The Assetera Wallet window was closed before onboarding finished."
-            )
-          )
-        );
+      if (!activePopup.closed) return;
+      if (onboarded) {
+        close();
+        return;
       }
+      fail(
+        new OnboardingError("closed", "The Assetera Wallet window was closed before onboarding finished.")
+      );
     }, CLOSE_POLL_MS2);
     if (overlayEnabled) {
       overlay = showOverlay(targetWindow, labels, {
@@ -554,13 +663,99 @@ function openAsseteraOnboarding(options) {
   });
 }
 
+// src/manage.ts
+var ManagerError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ManagerError";
+    this.code = code;
+  }
+};
+var POPUP_NAME3 = "assetera-wallet-manage";
+var CLOSE_POLL_MS3 = 500;
+function openAsseteraWalletManager(options) {
+  const requestedWindow = options.window ?? (typeof window === "undefined" ? void 0 : window);
+  if (!requestedWindow) {
+    throw new ManagerError("invalid_options", "The Assetera Wallet manager can only run in a browser.");
+  }
+  const targetWindow = requestedWindow;
+  let walletOrigin;
+  try {
+    walletOrigin = new URL(options.walletUrl).origin;
+  } catch {
+    throw new ManagerError("invalid_options", `"${options.walletUrl}" is not a valid wallet URL.`);
+  }
+  const popup = targetWindow.open(
+    manageUrl(options.walletUrl, targetWindow.location.origin, {
+      ...options.locale === void 0 ? {} : { locale: options.locale },
+      ...options.signIn === void 0 ? {} : { signIn: options.signIn }
+    }),
+    POPUP_NAME3,
+    options.popupFeatures ?? defaultPopupFeatures(targetWindow)
+  );
+  if (!popup) {
+    throw new ManagerError(
+      "popup_blocked",
+      "Your browser blocked the Assetera Wallet window. Allow pop-ups for this site and try again."
+    );
+  }
+  const activePopup = popup;
+  let finished = false;
+  let lastSecurity;
+  let closeTimer = null;
+  let resolveClosed;
+  const closed = new Promise((resolve) => {
+    resolveClosed = resolve;
+  });
+  function cleanup() {
+    if (finished) return;
+    finished = true;
+    targetWindow.removeEventListener("message", onMessage);
+    if (closeTimer !== null) {
+      clearInterval(closeTimer);
+      closeTimer = null;
+    }
+    resolveClosed();
+  }
+  function close() {
+    cleanup();
+    if (!activePopup.closed) activePopup.close();
+  }
+  function onMessage(event) {
+    if (event.origin !== walletOrigin) return;
+    if (event.source !== activePopup) return;
+    const data = event.data;
+    if (!isSecurityMessage(data)) return;
+    const status = {
+      protection: data.data.protection,
+      passkeys: data.data.passkeys,
+      authenticatorApps: data.data.authenticatorApps
+    };
+    lastSecurity = status;
+    options.onSecurity?.(status);
+  }
+  targetWindow.addEventListener("message", onMessage);
+  closeTimer = setInterval(() => {
+    if (activePopup.closed) cleanup();
+  }, CLOSE_POLL_MS3);
+  return {
+    close,
+    closed,
+    lastSecurity: () => lastSecurity
+  };
+}
+
 exports.CONNECT_PATH = CONNECT_PATH;
+exports.MANAGE_PATH = MANAGE_PATH;
 exports.MESSAGE_PREFIX = MESSAGE_PREFIX;
+exports.ManagerError = ManagerError;
 exports.ONBOARD_PATH = ONBOARD_PATH;
 exports.OnboardingError = OnboardingError;
 exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
 exports.ProviderRpcError = ProviderRpcError;
 exports.RpcErrorCode = RpcErrorCode;
+exports.SIGN_IN_HINTS = SIGN_IN_HINTS;
 exports.SUPPORTED_METHODS = SUPPORTED_METHODS;
 exports.connectUrl = connectUrl;
 exports.createAsseteraWalletProvider = createAsseteraWalletProvider;
@@ -572,8 +767,12 @@ exports.isOnboardedMessage = isOnboardedMessage;
 exports.isReadyMessage = isReadyMessage;
 exports.isRequestMessage = isRequestMessage;
 exports.isResponseMessage = isResponseMessage;
+exports.isSecurityMessage = isSecurityMessage;
+exports.isSignInHint = isSignInHint;
 exports.isSupportedMethod = isSupportedMethod;
+exports.manageUrl = manageUrl;
 exports.onboardUrl = onboardUrl;
 exports.openAsseteraOnboarding = openAsseteraOnboarding;
+exports.openAsseteraWalletManager = openAsseteraWalletManager;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map