@abstraxn/signer-react 3.3.9 → 3.3.10

package/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.10] - 2026-09-18
+
+### Fixed
+- **Mobile WalletConnect reject / confirm / on-chain failure** (aligned with WC + EIP-1193):
+  - **Reject:** On return from MetaMask, force-resume the relay (time-bounded). Map EIP-1193 `4001` / WC `5000` to `User rejected the request`. If WC stays silent and pending nonce never moved, surface the same reject error so loaders clear.
+  - **Confirm:** WC success is a **tx hash** only. Gated chain poll recovers the hash when the relay drops after approve (success-only; does not invent rejects).
+  - **On-chain failure:** `useWaitForTxnReceipt` defaults to `throwOnRevert: true` so a mined `status: reverted` throws `Transaction reverted` (receipt check is dapp/RPC, not WalletConnect).
+
+### Added
+- `isUserRejectionError`, `toUserRejectionError`, `forceResumeWalletConnectOnReturn`.
+
 ## [3.3.9] - 2026-09-17
 
 ### Fixed

package/dist/src/hooks.d.ts

@@ -8165,11 +8165,12 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             [x: `bytes3[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
+            [x: `bytes16[${string}]`]: undefined;
+            [x: `bytes8[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes7[${string}]`]: undefined;
-            [x: `bytes8[${string}]`]: undefined;
             [x: `bytes9[${string}]`]: undefined;
             [x: `bytes10[${string}]`]: undefined;
             [x: `bytes11[${string}]`]: undefined;
@@ -8177,7 +8178,6 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             [x: `bytes13[${string}]`]: undefined;
             [x: `bytes14[${string}]`]: undefined;
             [x: `bytes15[${string}]`]: undefined;
-            [x: `bytes16[${string}]`]: undefined;
             [x: `bytes17[${string}]`]: undefined;
             [x: `bytes18[${string}]`]: undefined;
             [x: `bytes19[${string}]`]: undefined;
@@ -8195,8 +8195,8 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             [x: `bytes31[${string}]`]: undefined;
             [x: `bytes32[${string}]`]: undefined;
             [x: `int[${string}]`]: undefined;
-            [x: `int8[${string}]`]: undefined;
             [x: `int16[${string}]`]: undefined;
+            [x: `int8[${string}]`]: undefined;
             [x: `int24[${string}]`]: undefined;
             [x: `int32[${string}]`]: undefined;
             [x: `int40[${string}]`]: undefined;
@@ -8228,8 +8228,8 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             [x: `int248[${string}]`]: undefined;
             [x: `int256[${string}]`]: undefined;
             [x: `uint[${string}]`]: undefined;
-            [x: `uint8[${string}]`]: undefined;
             [x: `uint16[${string}]`]: undefined;
+            [x: `uint8[${string}]`]: undefined;
             [x: `uint24[${string}]`]: undefined;
             [x: `uint32[${string}]`]: undefined;
             [x: `uint40[${string}]`]: undefined;
@@ -8267,11 +8267,12 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             bytes3?: undefined;
             bytes1?: undefined;
             bytes2?: undefined;
+            bytes16?: undefined;
+            bytes8?: undefined;
             bytes4?: undefined;
             bytes5?: undefined;
             bytes6?: undefined;
             bytes7?: undefined;
-            bytes8?: undefined;
             bytes9?: undefined;
             bytes10?: undefined;
             bytes11?: undefined;
@@ -8279,7 +8280,6 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             bytes13?: undefined;
             bytes14?: undefined;
             bytes15?: undefined;
-            bytes16?: undefined;
             bytes17?: undefined;
             bytes18?: undefined;
             bytes19?: undefined;
@@ -8296,8 +8296,8 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             bytes30?: undefined;
             bytes31?: undefined;
             bytes32?: undefined;
-            int8?: undefined;
             int16?: undefined;
+            int8?: undefined;
             int24?: undefined;
             int32?: undefined;
             int40?: undefined;
@@ -8328,8 +8328,8 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             int240?: undefined;
             int248?: undefined;
             int256?: undefined;
-            uint8?: undefined;
             uint16?: undefined;
+            uint8?: undefined;
             uint24?: undefined;
             uint32?: undefined;
             uint40?: undefined;
@@ -8811,10 +8811,16 @@ export declare function useSignAndSendTxn(provider: PublicClient): {
  * ```
  */
 export declare function useWaitForTxnReceipt(provider: PublicClient): {
-    waitForTxnReceipt: ({ hash, confirmations, timeout, }: {
+    waitForTxnReceipt: ({ hash, confirmations, timeout, throwOnRevert, }: {
         hash: `0x${string}`;
         confirmations?: number;
         timeout?: number;
+        /**
+         * When true (default), a mined receipt with status reverted throws
+         * `Transaction reverted` — on-chain failure is not a WalletConnect concern;
+         * the dapp must check the receipt after receiving the hash.
+         */
+        throwOnRevert?: boolean;
     }) => Promise<TransactionReceipt>;
 };
 /**
@@ -13140,11 +13146,12 @@ export declare function useExternalWalletClient(): {
             [x: `bytes3[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
+            [x: `bytes16[${string}]`]: undefined;
+            [x: `bytes8[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
             [x: `bytes7[${string}]`]: undefined;
-            [x: `bytes8[${string}]`]: undefined;
             [x: `bytes9[${string}]`]: undefined;
             [x: `bytes10[${string}]`]: undefined;
             [x: `bytes11[${string}]`]: undefined;
@@ -13152,7 +13159,6 @@ export declare function useExternalWalletClient(): {
             [x: `bytes13[${string}]`]: undefined;
             [x: `bytes14[${string}]`]: undefined;
             [x: `bytes15[${string}]`]: undefined;
-            [x: `bytes16[${string}]`]: undefined;
             [x: `bytes17[${string}]`]: undefined;
             [x: `bytes18[${string}]`]: undefined;
             [x: `bytes19[${string}]`]: undefined;
@@ -13170,8 +13176,8 @@ export declare function useExternalWalletClient(): {
             [x: `bytes31[${string}]`]: undefined;
             [x: `bytes32[${string}]`]: undefined;
             [x: `int[${string}]`]: undefined;
-            [x: `int8[${string}]`]: undefined;
             [x: `int16[${string}]`]: undefined;
+            [x: `int8[${string}]`]: undefined;
             [x: `int24[${string}]`]: undefined;
             [x: `int32[${string}]`]: undefined;
             [x: `int40[${string}]`]: undefined;
@@ -13203,8 +13209,8 @@ export declare function useExternalWalletClient(): {
             [x: `int248[${string}]`]: undefined;
             [x: `int256[${string}]`]: undefined;
             [x: `uint[${string}]`]: undefined;
-            [x: `uint8[${string}]`]: undefined;
             [x: `uint16[${string}]`]: undefined;
+            [x: `uint8[${string}]`]: undefined;
             [x: `uint24[${string}]`]: undefined;
             [x: `uint32[${string}]`]: undefined;
             [x: `uint40[${string}]`]: undefined;
@@ -13242,11 +13248,12 @@ export declare function useExternalWalletClient(): {
             bytes3?: undefined;
             bytes1?: undefined;
             bytes2?: undefined;
+            bytes16?: undefined;
+            bytes8?: undefined;
             bytes4?: undefined;
             bytes5?: undefined;
             bytes6?: undefined;
             bytes7?: undefined;
-            bytes8?: undefined;
             bytes9?: undefined;
             bytes10?: undefined;
             bytes11?: undefined;
@@ -13254,7 +13261,6 @@ export declare function useExternalWalletClient(): {
             bytes13?: undefined;
             bytes14?: undefined;
             bytes15?: undefined;
-            bytes16?: undefined;
             bytes17?: undefined;
             bytes18?: undefined;
             bytes19?: undefined;
@@ -13271,8 +13277,8 @@ export declare function useExternalWalletClient(): {
             bytes30?: undefined;
             bytes31?: undefined;
             bytes32?: undefined;
-            int8?: undefined;
             int16?: undefined;
+            int8?: undefined;
             int24?: undefined;
             int32?: undefined;
             int40?: undefined;
@@ -13303,8 +13309,8 @@ export declare function useExternalWalletClient(): {
             int240?: undefined;
             int248?: undefined;
             int256?: undefined;
-            uint8?: undefined;
             uint16?: undefined;
+            uint8?: undefined;
             uint24?: undefined;
             uint32?: undefined;
             uint40?: undefined;

package/dist/src/hooks.js

@@ -12,7 +12,7 @@ import { useWalletClient as useWagmiWalletClient, useAccount, useConfig, useChai
 import { getWalletClient, switchChain, getPublicClient } from '@wagmi/core';
 import { getConnectorMeta } from './connectors';
 import { getChainById } from './chains';
-import { waitUntilDocumentVisible, pollForOutgoingTx, clearWalletConnectPendingState, isWalletConnectConnector, isMobileDevice, } from './walletConnectMobile';
+import { waitUntilDocumentVisible, pollForOutgoingTx, clearWalletConnectPendingState, isWalletConnectConnector, isMobileDevice, isUserRejectionError, toUserRejectionError, } from './walletConnectMobile';
 /**
  * Hook to check if wallet is connected
  */
@@ -2057,7 +2057,7 @@ export function useSignAndSendTxn(provider) {
  * ```
  */
 export function useWaitForTxnReceipt(provider) {
-    const waitForTxnReceipt = useCallback(async ({ hash, confirmations, timeout, }) => {
+    const waitForTxnReceipt = useCallback(async ({ hash, confirmations, timeout, throwOnRevert = true, }) => {
         if (!provider) {
             throw new Error('Provider (publicClient) is required');
         }
@@ -2080,9 +2080,18 @@ export function useWaitForTxnReceipt(provider) {
                         timeout: Math.min(20_000, remaining),
                         pollingInterval: 1_500,
                     });
+                    if (throwOnRevert &&
+                        (receipt.status === 'reverted' ||
+                            receipt.status === 0 ||
+                            receipt.status === '0x0')) {
+                        throw new Error('Transaction reverted');
+                    }
                     return receipt;
                 }
                 catch (error) {
+                    if (error instanceof Error && error.message === 'Transaction reverted') {
+                        throw error;
+                    }
                     lastError = error;
                     await waitUntilDocumentVisible();
                     await new Promise((resolve) => setTimeout(resolve, 1_000));
@@ -2096,6 +2105,9 @@ export function useWaitForTxnReceipt(provider) {
                 : new Error('Failed to wait for transaction receipt');
         }
         catch (error) {
+            if (error instanceof Error && error.message === 'Transaction reverted') {
+                throw error;
+            }
             if (error instanceof Error && error.message.startsWith('Failed to wait for transaction receipt')) {
                 throw error;
             }
@@ -2523,7 +2535,12 @@ export function useWriteContract() {
                 // Matching without selector is still useful (from + to).
             }
             const cancelPoll = { cancelled: false };
-            const sendPromise = sendWrite();
+            const sendPromise = sendWrite().then((hash) => hash, (err) => {
+                if (isUserRejectionError(err))
+                    throw toUserRejectionError(err);
+                throw err;
+            });
+            // Success-only chain recovery when WC hash never arrives.
             const pollPromise = pollForOutgoingTx({
                 publicClient,
                 from: fromAddress,
@@ -2532,12 +2549,11 @@ export function useWriteContract() {
                 value,
                 startBlock,
                 signal: cancelPoll,
-                initialDelayMs: 10_000,
-                timeoutMs: 90_000,
+                initialDelayMs: 1_000,
+                timeoutMs: 60_000,
             });
             try {
                 const hash = await Promise.race([sendPromise, pollPromise]);
-                // Poll may win while WC is still hanging — ignore a late reject.
                 void sendPromise.then(() => undefined, () => undefined);
                 return hash;
             }

package/dist/src/index.d.ts

@@ -16,4 +16,4 @@ export type { OnboardingUIComponentProps, OnboardingUIComponentRef } from './Onb
 export { ALL_CHAINS, EVM_CHAINS, SOLANA_CHAINS, getChainById, getChainsByType, getDefaultChains, toCoreChain, type ChainData, } from './chains';
 export { CONNECTORS, getConnectorMeta, isOAuthConnector, isWalletConnector, isAuthConnector, type ConnectorType, type ConnectorMeta, } from './connectors';
 export { createWagmiConfig } from './wagmiConfig';
-export { pollForOutgoingTx, clearWalletConnectPendingState, waitUntilDocumentVisible, isWalletConnectConnector, isMobileDevice, } from './walletConnectMobile';
+export { pollForOutgoingTx, clearWalletConnectPendingState, waitUntilDocumentVisible, isWalletConnectConnector, isMobileDevice, forceResumeWalletConnectOnReturn, isUserRejectionError, toUserRejectionError, } from './walletConnectMobile';

package/dist/src/index.js

@@ -11,5 +11,5 @@ export { OnboardingUIComponent as OnboardingUI } from './OnboardingUI';
 export { ALL_CHAINS, EVM_CHAINS, SOLANA_CHAINS, getChainById, getChainsByType, getDefaultChains, toCoreChain, } from './chains';
 export { CONNECTORS, getConnectorMeta, isOAuthConnector, isWalletConnector, isAuthConnector, } from './connectors';
 export { createWagmiConfig } from './wagmiConfig';
-export { pollForOutgoingTx, clearWalletConnectPendingState, waitUntilDocumentVisible, isWalletConnectConnector, isMobileDevice, } from './walletConnectMobile';
+export { pollForOutgoingTx, clearWalletConnectPendingState, waitUntilDocumentVisible, isWalletConnectConnector, isMobileDevice, forceResumeWalletConnectOnReturn, isUserRejectionError, toUserRejectionError, } from './walletConnectMobile';
 //# sourceMappingURL=index.js.map

package/dist/src/walletConnectMobile.d.ts

@@ -107,9 +107,12 @@ export declare function waitUntilDocumentVisible(): Promise<void>;
  * (poll won while eth_sendTransaction is still hanging).
  */
 export declare function clearWalletConnectPendingState(provider: any): void;
+/** EIP-1193 4001 / WC 5000 (and common message shapes). */
+export declare function isUserRejectionError(error: unknown): boolean;
+export declare function toUserRejectionError(error?: unknown): Error;
 /**
- * When WalletConnect never returns eth_sendTransaction after MetaMask approve,
- * scan recent blocks for a matching outgoing tx (from/to + optional calldata prefix).
+ * Success-only recovery: find an on-chain hash when WC never returns one.
+ * Does not infer reject (that is handled by relay resume + reject fallback).
  */
 export declare function pollForOutgoingTx(params: {
     publicClient: {
@@ -123,7 +126,6 @@ export declare function pollForOutgoingTx(params: {
     };
     from: string;
     to: string;
-    /** Match tx.input prefix (e.g. 0x + 4-byte selector). */
     dataPrefix?: string;
     value?: bigint;
     startBlock: bigint;
@@ -133,13 +135,15 @@ export declare function pollForOutgoingTx(params: {
     timeoutMs?: number;
     initialDelayMs?: number;
 }): Promise<`0x${string}`>;
+/** Time-bounded force-resume (must not hang on transportOpen). */
+export declare function forceResumeWalletConnectOnReturn(provider: any, timeoutMs?: number): Promise<void>;
 /**
  * Patch the EIP-1193 provider so signing/tx requests resume the relay first.
  * Covers wagmi hooks, viem walletClient, and direct provider.request calls.
  */
 export declare function patchWalletConnectProviderForMobile(provider: any): void;
 /**
- * When the dapp tab is shown again (user left MetaMask), restart the relay so
- * the pending WalletConnect response can be received.
+ * When the dapp tab is shown again, restart the relay so pending
+ * approve/reject responses can be delivered (WalletConnect mobile linking).
  */
 export declare function subscribeWalletConnectForegroundResume(provider: any): () => void;

package/dist/src/walletConnectMobile.js

@@ -569,19 +569,57 @@ export function clearWalletConnectPendingState(provider) {
         // ignore
     }
 }
+/** EIP-1193 4001 / WC 5000 (and common message shapes). */
+export function isUserRejectionError(error) {
+    const walk = (err, depth = 0) => {
+        if (err == null || depth > 8)
+            return false;
+        if (typeof err === "string") {
+            return /user rejected|rejected by user|user denied|denied transaction|request rejected|cancelled by user/i.test(err);
+        }
+        if (typeof err !== "object")
+            return false;
+        const e = err;
+        if (e.code === 4001 || e.code === 5000 || e.code === "4001" || e.code === "ACTION_REJECTED") {
+            return true;
+        }
+        if (typeof e.name === "string" && /UserRejected/i.test(e.name))
+            return true;
+        const msg = `${e.message ?? ""} ${e.shortMessage ?? ""}`;
+        if (/user rejected|rejected by user|user denied|denied transaction|request rejected|user cancelled|user canceled/i.test(msg)) {
+            return true;
+        }
+        return walk(e.cause, depth + 1);
+    };
+    return walk(error);
+}
+export function toUserRejectionError(error) {
+    if (error instanceof Error && isUserRejectionError(error)) {
+        const err = new Error("User rejected the request");
+        err.code = 4001;
+        err.cause = error;
+        return err;
+    }
+    const err = new Error("User rejected the request");
+    err.code = 4001;
+    if (error !== undefined)
+        err.cause = error;
+    return err;
+}
 /**
- * When WalletConnect never returns eth_sendTransaction after MetaMask approve,
- * scan recent blocks for a matching outgoing tx (from/to + optional calldata prefix).
+ * Success-only recovery: find an on-chain hash when WC never returns one.
+ * Does not infer reject (that is handled by relay resume + reject fallback).
  */
 export async function pollForOutgoingTx(params) {
-    const { publicClient, from, to, dataPrefix, value, startBlock, signal, timeoutMs = 90_000, initialDelayMs = 10_000, } = params;
+    const { publicClient, from, to, dataPrefix, value, startBlock, signal, timeoutMs = 60_000, initialDelayMs = 1_000, } = params;
+    await waitUntilDocumentVisible();
+    if (signal.cancelled)
+        throw new Error("cancelled");
     if (initialDelayMs > 0) {
         await new Promise((r) => setTimeout(r, initialDelayMs));
     }
-    if (signal.cancelled) {
+    if (signal.cancelled)
         throw new Error("cancelled");
-    }
-    await waitUntilDocumentVisible();
     const fromLc = from.toLowerCase();
     const toLc = to.toLowerCase();
     const prefixLc = dataPrefix ? dataPrefix.toLowerCase() : undefined;
@@ -589,11 +627,7 @@ export async function pollForOutgoingTx(params) {
     while (!signal.cancelled && Date.now() - started < timeoutMs) {
         try {
             const latest = await publicClient.getBlockNumber();
-            const fromBlock = startBlock > 0n
-                ? startBlock
-                : latest > 12n
-                    ? latest - 12n
-                    : 0n;
+            const fromBlock = startBlock > 0n ? startBlock : latest > 12n ? latest - 12n : 0n;
             for (let b = fromBlock; b <= latest; b++) {
                 if (signal.cancelled)
                     break;
@@ -609,7 +643,8 @@ export async function pollForOutgoingTx(params) {
                         continue;
                     if (String(tx.to || "").toLowerCase() !== toLc)
                         continue;
-                    if (value !== undefined && BigInt(tx.value ?? 0) !== value) {
+                    if (value !== undefined &&
+                        BigInt(tx.value ?? 0) !== value) {
                         continue;
                     }
                     if (prefixLc) {
@@ -625,11 +660,83 @@ export async function pollForOutgoingTx(params) {
             }
         }
         catch {
-            // RPC blip — keep polling
+            // RPC blip
         }
         await new Promise((r) => setTimeout(r, 2_000));
     }
-    throw new Error("No WalletConnect response and no matching on-chain transaction found. If MetaMask showed confirmed, refresh and check the explorer.");
+    // Stay pending until cancelled — reject UX is owned by the approval race.
+    if (signal.cancelled)
+        throw new Error("cancelled");
+    await new Promise(() => { });
+    throw new Error("cancelled");
+}
+/** Time-bounded force-resume (must not hang on transportOpen). */
+export async function forceResumeWalletConnectOnReturn(provider, timeoutMs = 1_500) {
+    if (!provider)
+        return;
+    try {
+        provider[NEEDS_RESUME_FLAG] = true;
+        await Promise.race([
+            resumeWalletConnectRelayer(provider, { force: true }),
+            new Promise((resolve) => setTimeout(resolve, timeoutMs)),
+        ]);
+    }
+    catch {
+        // best-effort
+    }
+}
+async function readPendingNonce(provider) {
+    try {
+        const accounts = provider?.accounts ||
+            provider?.session?.namespaces?.eip155?.accounts?.map((a) => a.includes(":") ? a.split(":").pop() : a) ||
+            [];
+        const address = accounts[0];
+        if (!address || typeof provider.request !== "function")
+            return null;
+        // Use unbound original if patched — readPendingNonce is called from
+        // inside the patch with the live provider; eth_getTransactionCount is
+        // not an approval method so the patch forwards it.
+        const hex = await provider.request({
+            method: "eth_getTransactionCount",
+            params: [address, "pending"],
+        });
+        return typeof hex === "string" ? parseInt(hex, 16) : Number(hex);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prefer WC delivering real approve/reject after return (docs: respondSessionRequest).
+ * If still pending with no nonce bump → EIP-1193-style user rejection.
+ * If nonce moved → do not fake reject (let success hash arrive via WC or poll).
+ */
+async function raceApprovalWithResumeAndRejectFallback(resultPromise, provider, startNonce) {
+    const normalizedResult = resultPromise.then((v) => v, (err) => {
+        if (isUserRejectionError(err))
+            throw toUserRejectionError(err);
+        throw err;
+    });
+    const rejectFallback = (async () => {
+        await waitUntilDocumentVisible();
+        await forceResumeWalletConnectOnReturn(provider, 1_500);
+        await new Promise((r) => setTimeout(r, 400));
+        await forceResumeWalletConnectOnReturn(provider, 1_500);
+        // Window for MetaMask's real JSON-RPC reject/hash after resume.
+        await new Promise((r) => setTimeout(r, 5_000));
+        if (!hasPendingWalletConnectApproval(provider)) {
+            return await new Promise(() => { });
+        }
+        const currentNonce = await readPendingNonce(provider);
+        if (startNonce != null &&
+            currentNonce != null &&
+            currentNonce > startNonce) {
+            // Tx submitted — confirmation path owns this.
+            return await new Promise(() => { });
+        }
+        throw toUserRejectionError();
+    })();
+    return await Promise.race([normalizedResult, rejectFallback]);
 }
 function getRequestMethod(args) {
     const payload = args[0];
@@ -661,7 +768,10 @@ export function patchWalletConnectProviderForMobile(provider) {
         }
         if (!isApproval && wasBackgrounded) {
             try {
-                await resumeWalletConnectRelayer(provider, { force: true });
+                await Promise.race([
+                    resumeWalletConnectRelayer(provider, { force: true }),
+                    new Promise((resolve) => setTimeout(resolve, 1_500)),
+                ]);
             }
             finally {
                 provider[NEEDS_RESUME_FLAG] = false;
@@ -669,10 +779,10 @@ export function patchWalletConnectProviderForMobile(provider) {
             return originalRequest(...args);
         }
         let cancelDeeplinks;
+        let startNonce = null;
         if (isApproval) {
             provider[PENDING_FLAG] = (provider[PENDING_FLAG] || 0) + 1;
-            // Already connected: never re-open "All Wallets". Only restore modal
-            // during connect (no session yet).
+            startNonce = await readPendingNonce(provider);
             if (hasActiveWalletConnectSession(provider)) {
                 hideWalletConnectModal(provider);
             }
@@ -680,29 +790,24 @@ export function patchWalletConnectProviderForMobile(provider) {
                 restoreWalletConnectModal();
             }
             syncWalletConnectDappRedirect(provider);
-            // Mark before deeplink so a fast backgrounding still triggers force-resume.
             provider[NEEDS_RESUME_FLAG] = true;
         }
         try {
-            // 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 (isApproval) {
-                // Do NOT auto-deeplink when a session already exists.
-                // WC ethereum-provider already opens the peer wallet; our extra
-                // metamask:// calls queue iOS "Open in MetaMask?" dialogs that stay
-                // on screen after the tx is confirmed (JS cannot dismiss them).
-                // Connect flow (no session) may still use a single scheduled open.
                 if (!hasActiveWalletConnectSession(provider)) {
                     cancelDeeplinks = scheduleOpenConnectedWalletApp(provider);
                 }
                 else {
                     hideWalletConnectModal(provider);
                 }
+                if (isMobileDevice()) {
+                    return await raceApprovalWithResumeAndRejectFallback(resultPromise, provider, startNonce);
+                }
             }
             return await resultPromise;
         }
@@ -711,7 +816,6 @@ export function patchWalletConnectProviderForMobile(provider) {
             if (isApproval) {
                 provider[PENDING_FLAG] = Math.max(0, (provider[PENDING_FLAG] || 1) - 1);
                 provider.__abstraxnWcDeeplinkOpened = false;
-                // Close picker that may have been left open after approve/reject.
                 hideWalletConnectModal(provider);
                 if (!hasPendingWalletConnectApproval(provider)) {
                     provider[NEEDS_RESUME_FLAG] = false;
@@ -721,8 +825,8 @@ export function patchWalletConnectProviderForMobile(provider) {
     };
 }
 /**
- * When the dapp tab is shown again (user left MetaMask), restart the relay so
- * the pending WalletConnect response can be received.
+ * When the dapp tab is shown again, restart the relay so pending
+ * approve/reject responses can be delivered (WalletConnect mobile linking).
  */
 export function subscribeWalletConnectForegroundResume(provider) {
     if (typeof window === "undefined" || !provider)
@@ -732,35 +836,32 @@ export function subscribeWalletConnectForegroundResume(provider) {
         timers.splice(0).forEach((t) => clearTimeout(t));
         const pending = hasPendingWalletConnectApproval(provider);
         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;
         }
-        // iOS often reports "visible" before networking is ready; retry force-resume.
-        const delays = [50, 300, 1000, 2000, 4000];
-        delays.forEach((ms) => {
-            timers.push(setTimeout(() => {
-                if (!hasPendingWalletConnectApproval(provider) &&
-                    !provider[NEEDS_RESUME_FLAG]) {
-                    return;
-                }
-                clearWalletReturnIfSameDocument();
-                void resumeWalletConnectRelayer(provider, { force: true }).then(() => {
-                    if (!hasPendingWalletConnectApproval(provider)) {
-                        provider[NEEDS_RESUME_FLAG] = false;
-                        hideWalletConnectModal(provider);
-                    }
-                });
-                // Do not restoreWalletConnectModal here — that reopens "All Wallets".
-                if (!hasActiveWalletConnectSession(provider)) {
-                    restoreWalletConnectModal();
-                }
-                else {
+        const run = () => {
+            if (!hasPendingWalletConnectApproval(provider) &&
+                !provider[NEEDS_RESUME_FLAG]) {
+                return;
+            }
+            clearWalletReturnIfSameDocument();
+            void forceResumeWalletConnectOnReturn(provider, 1_500).then(() => {
+                if (!hasPendingWalletConnectApproval(provider)) {
+                    provider[NEEDS_RESUME_FLAG] = false;
                     hideWalletConnectModal(provider);
                 }
-            }, ms));
+            });
+            if (!hasActiveWalletConnectSession(provider)) {
+                restoreWalletConnectModal();
+            }
+            else {
+                hideWalletConnectModal(provider);
+            }
+        };
+        run();
+        [800, 2_000].forEach((ms) => {
+            timers.push(setTimeout(run, ms));
         });
     };
     const onVisibility = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstraxn/signer-react",
-  "version": "3.3.9",
+  "version": "3.3.10",
   "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",