@abstraxn/signer-react 3.3.7 → 3.3.8

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.8] - 2026-09-16
+
+### Fixed
+- **Create Proposal never opened MetaMask (loader stuck)** – 3.3.7 force-restarted the WalletConnect relay after every return from the wallet, including after *connect*. That restart raced the next `session_request`, so Create Proposal never deeplinked to MetaMask on iOS/Android. Relay restart now happens only for an in-flight approval. New transactions send first, then explicitly open the connected wallet app so the confirmation popup appears.
+
 ## [3.3.7] - 2026-09-15
 
 ### Fixed

package/dist/src/walletConnectMobile.d.ts

@@ -34,6 +34,12 @@ export declare function getDappReturnUrl(): string;
  * navigating Safari to a new URL (which reloads and drops in-memory state).
  */
 export declare function getSourceBrowserNativeRedirect(): string | undefined;
+/**
+ * Open the already-connected wallet app so the user sees the confirmation UI.
+ * WalletConnect often sends the session_request but does not deeplink on a
+ * later tx if the QR modal is hidden — Create Proposal then sits on a loader.
+ */
+export declare function openConnectedWalletApp(provider: any): void;
 /**
  * Lazy metadata so url/redirect are read at connect/request time, not at
  * provider mount (which is often the homepage in Next.js layouts).

package/dist/src/walletConnectMobile.js

@@ -123,6 +123,79 @@ export function getSourceBrowserNativeRedirect() {
         return "googlechrome://";
     return undefined;
 }
+function isAndroid() {
+    if (typeof navigator === "undefined")
+        return false;
+    return /Android/i.test(navigator.userAgent || "");
+}
+function isMobileDevice() {
+    return isIOS() || isAndroid();
+}
+function isWalletHttpDeepLink(url) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return (host.includes("metamask.app.link") ||
+            host.includes("link.metamask.io") ||
+            host.includes("rainbow.me") ||
+            host.includes("link.trustwallet.com") ||
+            host.includes("walletconnect.com"));
+    }
+    catch {
+        return false;
+    }
+}
+function canOpenAsWalletApp(url) {
+    if (!url)
+        return false;
+    if (/^https?:\/\//i.test(url))
+        return isWalletHttpDeepLink(url);
+    return true;
+}
+/**
+ * Open the already-connected wallet app so the user sees the confirmation UI.
+ * WalletConnect often sends the session_request but does not deeplink on a
+ * later tx if the QR modal is hidden — Create Proposal then sits on a loader.
+ */
+export function openConnectedWalletApp(provider) {
+    if (typeof window === "undefined" || !isMobileDevice())
+        return;
+    restoreWalletConnectModal();
+    try {
+        if (typeof provider?.modal?.open === "function") {
+            void provider.modal.open();
+        }
+    }
+    catch {
+        // Modal may not exist after we force-hid it post-connect.
+    }
+    const peer = provider?.session?.peer?.metadata ??
+        provider?.signer?.session?.peer?.metadata;
+    const native = String(peer?.redirect?.native || "");
+    const universal = String(peer?.redirect?.universal || "");
+    const name = String(peer?.name || "").toLowerCase();
+    let target = "";
+    if (canOpenAsWalletApp(native))
+        target = native;
+    else if (canOpenAsWalletApp(universal))
+        target = universal;
+    else if (name.includes("metamask") || !name) {
+        target = isIOS() ? "metamask://" : "https://metamask.app.link/wc";
+    }
+    else if (name.includes("rainbow")) {
+        target = "rainbow://";
+    }
+    else if (name.includes("trust")) {
+        target = "trust://";
+    }
+    if (!target)
+        return;
+    try {
+        window.location.href = target;
+    }
+    catch {
+        // Ignore
+    }
+}
 function getWalletConnectRedirect() {
     const native = getSourceBrowserNativeRedirect();
     return native ? { native } : undefined;
@@ -292,16 +365,13 @@ export async function resumeWalletConnectRelayer(provider, options) {
     }
     const run = (async () => {
         try {
-            if (!options?.force && isRelayerConnected(relayer)) {
-                const ping = relayer.provider?.connection?.ping;
-                if (typeof ping === "function") {
-                    await Promise.race([
-                        ping.call(relayer.provider.connection),
-                        new Promise((_, reject) => setTimeout(() => reject(new Error("ping timeout")), 1500)),
-                    ]);
+            // New requests must not restart a live session — that races the
+            // session_request and MetaMask never shows a confirmation popup.
+            if (!options?.force) {
+                if (isRelayerConnected(relayer))
                     return;
-                }
-                // No ping API: do not assume a zombie "connected" socket is healthy.
+                await restartWalletConnectTransport(relayer);
+                return;
             }
             await restartWalletConnectTransport(relayer);
             const session = provider?.session ?? provider?.signer?.session;
@@ -396,16 +466,32 @@ export function patchWalletConnectProviderForMobile(provider) {
         if (!isApproval && !wasBackgrounded) {
             return originalRequest(...args);
         }
+        if (!isApproval && wasBackgrounded) {
+            try {
+                await resumeWalletConnectRelayer(provider, { force: true });
+            }
+            finally {
+                provider[NEEDS_RESUME_FLAG] = false;
+            }
+            return originalRequest(...args);
+        }
         if (isApproval) {
             provider[PENDING_FLAG] = (provider[PENDING_FLAG] || 0) + 1;
             restoreWalletConnectModal();
             syncWalletConnectDappRedirect(provider);
         }
         try {
-            await resumeWalletConnectRelayer(provider, { force: wasBackgrounded });
-            if (wasBackgrounded)
-                provider[NEEDS_RESUME_FLAG] = false;
-            return await originalRequest(...args);
+            // Never force-restart right before sending a new tx — that is what
+            // blocked the MetaMask popup on Create Proposal after 3.3.7.
+            await Promise.race([
+                resumeWalletConnectRelayer(provider, { force: false }),
+                new Promise((resolve) => setTimeout(resolve, 1000)),
+            ]);
+            const resultPromise = originalRequest(...args);
+            if (typeof window !== "undefined") {
+                window.setTimeout(() => openConnectedWalletApp(provider), 400);
+            }
+            return await resultPromise;
         }
         finally {
             if (isApproval) {
@@ -422,23 +508,25 @@ export function subscribeWalletConnectForegroundResume(provider) {
     if (typeof window === "undefined" || !provider)
         return () => { };
     let timer = null;
-    let hiddenAt = 0;
     const resume = () => {
         if (timer)
             clearTimeout(timer);
-        const hiddenMs = hiddenAt ? Date.now() - hiddenAt : 0;
         const pending = hasPendingWalletConnectApproval(provider);
-        const force = pending || hiddenMs > 400 || !!provider[NEEDS_RESUME_FLAG];
+        const needsResume = pending || !!provider[NEEDS_RESUME_FLAG];
+        // Do not restart after connect-only backgrounding — that broke the next
+        // session_request so MetaMask never opened for Create Proposal.
+        if (!needsResume) {
+            clearWalletReturnIfSameDocument();
+            return;
+        }
         timer = setTimeout(() => {
             clearWalletReturnIfSameDocument();
-            void resumeWalletConnectRelayer(provider, { force });
-            if (pending)
-                restoreWalletConnectModal();
-        }, pending || force ? 50 : 250);
+            void resumeWalletConnectRelayer(provider, { force: true });
+            restoreWalletConnectModal();
+        }, 50);
     };
     const onVisibility = () => {
         if (document.visibilityState === "hidden") {
-            hiddenAt = Date.now();
             if (hasPendingWalletConnectApproval(provider)) {
                 provider[NEEDS_RESUME_FLAG] = true;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstraxn/signer-react",
-  "version": "3.3.7",
+  "version": "3.3.8",
   "description": "React SDK for Abstraxn Wallet - React components, hooks, and providers for seamless Web3 wallet integration",
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",