@abstraxn/signer-react 3.3.4 → 3.3.6

package/CHANGELOG.md

@@ -5,11 +5,28 @@ 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.6] - 2026-09-14
+
+### Fixed
+- **WalletConnect mobile approve/reject never returned to the dapp** – After a WalletConnect action deeplinked to MetaMask (or another wallet) on iOS/Android, the browser dropped the relay WebSocket. Approve and reject results never reached the in-flight `signMessage` / `sendTransaction` / `writeContract` promise. The SDK now resumes the WalletConnect relay when the tab becomes visible again and before user-approval requests, and no longer treats a transport drop as a session disconnect.
+- **WalletConnect iOS return opened Safari on the homepage** – Return metadata used `location.origin`, so MetaMask opened Safari at `/` and reloaded the app (lost in-memory UI state). Metadata now uses the current page URL. On iOS Chrome/Firefox/Edge/Brave/Opera, `redirect.native` is the source browser app scheme with no path so the existing tab can be foregrounded. On Safari, `redirect.universal` is omitted so the wallet can return to the same tab instead of navigating to `/`. If a wallet still lands on the homepage, the SDK restores the page the user transacted from.
+
+### Notes
+- Disconnect and reconnect WalletConnect once after upgrading so the wallet stores the new return metadata. Existing sessions keep the old homepage/Safari redirect until re-paired.
+
 ## [3.3.4] - 2026-08-31
 
+### Fixed
+- **Passkey export/sign 401** — via `@abstraxn/signer-core@2.1.4`, passkey login
+  registers the IndexedDB session key on Turnkey after login (fixes
+  `PUBLIC_KEY_NOT_FOUND` on export, sign, and proxy).
+
 ### Changed
-- Bumped `@abstraxn/signer-core` to `2.1.4` so passkey login registers the
-  IndexedDB session key (fixes export/sign `PUBLIC_KEY_NOT_FOUND`).
+- Bumped `@abstraxn/signer-core` to `2.1.4`.
+
+### Notes
+- Deploy **wallet-service** with `POST /auth/passkey/register-session` before upgrading.
+- Users on passkey must **log out and log in again** after upgrade.
 
 ## [3.3.3] - 2026-07-09
 

package/dist/src/components/AbstraxnProvider/AbstraxnProvider.js

@@ -10,6 +10,7 @@ import { EVM_CHAINS, toCoreChain } from "../../chains";
 import { AbstraxnProviderWithWagmi } from "./AbstraxnProviderWithWagmi";
 import { AbstraxnProviderWithoutWagmi } from "./AbstraxnProviderWithoutWagmi";
 import { useQueryClientSafe, QueryClientWrapper, canUseReactQuery } from "./utils";
+import { restoreAfterWalletRedirect } from "../../walletConnectMobile";
 import { ConnectionProvider, WalletProvider } from "@solana/wallet-adapter-react";
 import { PhantomWalletAdapter, SolflareWalletAdapter } from "@solana/wallet-adapter-wallets";
 export function AbstraxnProvider({ config, children }) {
@@ -26,6 +27,9 @@ export function AbstraxnProvider({ config, children }) {
     const [isHydrated, setIsHydrated] = useState(() => {
         return typeof window !== 'undefined';
     });
+    useEffect(() => {
+        restoreAfterWalletRedirect();
+    }, []);
     useEffect(() => {
         if (externalSsr && typeof window !== 'undefined' && !isHydrated) {
             // Wait for wallet injection scripts to run (Phantom, etc.)

package/dist/src/components/AbstraxnProvider/AbstraxnProviderInner.js

@@ -12,6 +12,7 @@ import { ExternalWalletButtons, resetExternalWalletViewState, } from "../../Exte
 import { EVM_CHAINS, SOLANA_CHAINS, getChainById, toCoreChain, } from "../../chains";
 import { AbstraxnContext } from "./context";
 import { isLinkAuthCallback } from "./utils";
+import { hasActiveWalletConnectSession, hasPendingWalletConnectApproval, isWalletConnectConnector, patchWalletConnectProviderForMobile, rememberCurrentPageForWalletReturn, resumeWalletConnectRelayer, subscribeWalletConnectForegroundResume, syncWalletConnectDappRedirect, } from "../../walletConnectMobile";
 /** Syncs wagmi disconnect to external wallet state; only rendered when wagmi is available (under WagmiProvider). */
 function WagmiConnectionEffectSync({ onDisconnect, }) {
     useConnectionEffect({ onDisconnect });
@@ -45,6 +46,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
     const [emailForOtp, setEmailForOtpState] = useState("");
     const explicitConnectionRef = useRef(false);
     const autoDisconnectHandledRef = useRef(false);
+    const wcProviderRef = useRef(null);
     useEffect(() => {
         isExternalWalletConnectedRef.current = isExternalWalletConnected;
     }, [isExternalWalletConnected]);
@@ -2555,6 +2557,14 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
         if (chainTypePref === "solana" && solana?.wallet?.connected) {
             return;
         }
+        // Mobile WalletConnect: leaving the browser for MetaMask drops the relay
+        // socket, which can make wagmi look disconnected even though the session
+        // is still valid. Keep UI state and resume the relay instead of resetting.
+        if (!wagmiAccount.isConnected &&
+            hasActiveWalletConnectSession(wcProviderRef.current)) {
+            void resumeWalletConnectRelayer(wcProviderRef.current);
+            return;
+        }
         // Prevent auto-connect (but allow restoration from persistence)
         // Only auto-disconnect if:
         // 1. wagmiAccount is connected
@@ -2664,6 +2674,8 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                     // Close WalletConnect QR modal when connection detected via wagmi (e.g. Next.js hydration)
                     if (typeof document !== "undefined") {
                         const closeWcModalDom = () => {
+                            if (hasPendingWalletConnectApproval(wcProviderRef.current))
+                                return;
                             ["w3m-modal", "w3m-modal-backdrop", "[data-w3m-modal]", ".w3m-modal", ".w3m-modal-backdrop", "[class*='w3m-modal']", "[class*='walletconnect-qrcode']"].forEach((sel) => {
                                 try {
                                     const el = document.querySelector(sel);
@@ -2866,6 +2878,21 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                 });
             }
             try {
+                if (isWalletConnectConnector) {
+                    rememberCurrentPageForWalletReturn();
+                    try {
+                        if (typeof connector.getProvider === "function") {
+                            const provider = await connector.getProvider();
+                            if (provider) {
+                                syncWalletConnectDappRedirect(provider);
+                                patchWalletConnectProviderForMobile(provider);
+                            }
+                        }
+                    }
+                    catch {
+                        // Provider may not exist until after connect.
+                    }
+                }
                 // Use connectAsync to properly await the connection
                 const result = await wagmiConnect.connectAsync({ connector });
                 // Use the result directly to set state immediately
@@ -2931,9 +2958,15 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                         connectorName.includes("walletconnect");
                     if (isWalletConnectConnector) {
                         const closeWalletConnectModal = async () => {
+                            if (hasPendingWalletConnectApproval(wcProviderRef.current))
+                                return;
                             try {
                                 if (typeof connector.getProvider === "function") {
                                     const provider = await connector.getProvider();
+                                    if (provider) {
+                                        wcProviderRef.current = provider;
+                                        patchWalletConnectProviderForMobile(provider);
+                                    }
                                     if (provider?.modal?.close) {
                                         provider.modal.close();
                                     }
@@ -3113,6 +3146,11 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
     const handleWagmiDisconnect = useCallback(() => {
         if (!externalWalletsEnabledRef.current)
             return;
+        // Transport drop (mobile deeplink) is not a session disconnect.
+        if (hasActiveWalletConnectSession(wcProviderRef.current)) {
+            void resumeWalletConnectRelayer(wcProviderRef.current);
+            return;
+        }
         setIsExternalWalletConnected(false);
         setExternalWalletAddress(null);
         setExternalWalletChainId(null);
@@ -3152,6 +3190,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
         }
         const connector = wagmiAccount.connector;
         let mounted = true;
+        let unsubscribeForeground;
         const setup = async () => {
             try {
                 const getProvider = connector.getProvider ?? connector.getEthereumProvider;
@@ -3160,15 +3199,39 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                 const p = await getProvider();
                 if (!mounted || !p)
                     return;
+                const isWc = isWalletConnectConnector(connector);
+                if (isWc) {
+                    wcProviderRef.current = p;
+                    syncWalletConnectDappRedirect(p);
+                    patchWalletConnectProviderForMobile(p);
+                    unsubscribeForeground = subscribeWalletConnectForegroundResume(p);
+                    if (!mounted) {
+                        unsubscribeForeground();
+                        unsubscribeForeground = undefined;
+                        wcProviderRef.current = null;
+                        return;
+                    }
+                }
+                else {
+                    wcProviderRef.current = null;
+                }
                 const onDisconnectFromProvider = () => {
                     if (!isExternalWalletConnectedRef.current)
                         return;
+                    if (hasActiveWalletConnectSession(p)) {
+                        void resumeWalletConnectRelayer(p);
+                        return;
+                    }
                     handleWagmiDisconnect();
                 };
                 const onAccountsChanged = (accounts) => {
                     const list = Array.isArray(accounts) ? accounts : [];
-                    if (list.length === 0)
+                    if (list.length === 0) {
+                        // Empty accounts during mobile resume is often a transport blip.
+                        if (hasActiveWalletConnectSession(p))
+                            return;
                         onDisconnectFromProvider();
+                    }
                 };
                 p.on?.("accountsChanged", onAccountsChanged);
                 p.on?.("disconnect", onDisconnectFromProvider);
@@ -3188,6 +3251,8 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
         });
         return () => {
             mounted = false;
+            unsubscribeForeground?.();
+            wcProviderRef.current = null;
             const cleanup = providerListenerCleanupRef.current;
             providerListenerCleanupRef.current = null;
             if (typeof cleanup === "function")

package/dist/src/hooks.d.ts

@@ -358,16 +358,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             withdrawals?: import("viem").Withdrawal[] | undefined | undefined;
             withdrawalsRoot?: `0x${string}` | undefined;
             transactions: includeTransactions extends true ? ({
+                input: import("viem").Hex;
+                s: import("viem").Hex;
                 type: "legacy";
                 value: bigint;
                 yParity?: undefined | undefined;
                 from: Address;
                 gas: bigint;
                 hash: import("viem").Hash;
-                input: import("viem").Hex;
                 nonce: number;
                 r: import("viem").Hex;
-                s: import("viem").Hex;
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
@@ -383,16 +383,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_1 ? T_1 extends (blockTag extends "pending" ? true : false) ? T_1 extends true ? null : bigint : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_2 ? T_2 extends (blockTag extends "pending" ? true : false) ? T_2 extends true ? null : number : never : never;
             } | {
+                input: import("viem").Hex;
+                s: import("viem").Hex;
                 type: "eip2930";
                 value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
                 hash: import("viem").Hash;
-                input: import("viem").Hex;
                 nonce: number;
                 r: import("viem").Hex;
-                s: import("viem").Hex;
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
@@ -408,16 +408,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_4 ? T_4 extends (blockTag extends "pending" ? true : false) ? T_4 extends true ? null : bigint : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_5 ? T_5 extends (blockTag extends "pending" ? true : false) ? T_5 extends true ? null : number : never : never;
             } | {
+                input: import("viem").Hex;
+                s: import("viem").Hex;
                 type: "eip1559";
                 value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
                 hash: import("viem").Hash;
-                input: import("viem").Hex;
                 nonce: number;
                 r: import("viem").Hex;
-                s: import("viem").Hex;
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
@@ -433,16 +433,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_7 ? T_7 extends (blockTag extends "pending" ? true : false) ? T_7 extends true ? null : bigint : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_8 ? T_8 extends (blockTag extends "pending" ? true : false) ? T_8 extends true ? null : number : never : never;
             } | {
+                input: import("viem").Hex;
+                s: import("viem").Hex;
                 type: "eip4844";
                 value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
                 hash: import("viem").Hash;
-                input: import("viem").Hex;
                 nonce: number;
                 r: import("viem").Hex;
-                s: import("viem").Hex;
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
@@ -458,16 +458,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 blockNumber: (blockTag extends "pending" ? true : false) extends infer T_10 ? T_10 extends (blockTag extends "pending" ? true : false) ? T_10 extends true ? null : bigint : never : never;
                 transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_11 ? T_11 extends (blockTag extends "pending" ? true : false) ? T_11 extends true ? null : number : never : never;
             } | {
+                input: import("viem").Hex;
+                s: import("viem").Hex;
                 type: "eip7702";
                 value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
                 hash: import("viem").Hash;
-                input: import("viem").Hex;
                 nonce: number;
                 r: import("viem").Hex;
-                s: import("viem").Hex;
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
@@ -508,16 +508,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
         } | undefined) => Promise<import("viem").EstimateMaxPriorityFeePerGasReturnType>;
         getStorageAt: (args: import("viem").GetStorageAtParameters) => Promise<import("viem").GetStorageAtReturnType>;
         getTransaction: <blockTag extends import("viem").BlockTag = "latest">(args: import("viem").GetTransactionParameters<blockTag>) => Promise<{
+            input: import("viem").Hex;
+            s: import("viem").Hex;
             type: "legacy";
             value: bigint;
             yParity?: undefined | undefined;
             from: Address;
             gas: bigint;
             hash: import("viem").Hash;
-            input: import("viem").Hex;
             nonce: number;
             r: import("viem").Hex;
-            s: import("viem").Hex;
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
@@ -533,16 +533,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_1 ? T_1 extends (blockTag extends "pending" ? true : false) ? T_1 extends true ? null : bigint : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_2 ? T_2 extends (blockTag extends "pending" ? true : false) ? T_2 extends true ? null : number : never : never;
         } | {
+            input: import("viem").Hex;
+            s: import("viem").Hex;
             type: "eip2930";
             value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
             hash: import("viem").Hash;
-            input: import("viem").Hex;
             nonce: number;
             r: import("viem").Hex;
-            s: import("viem").Hex;
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
@@ -558,16 +558,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_4 ? T_4 extends (blockTag extends "pending" ? true : false) ? T_4 extends true ? null : bigint : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_5 ? T_5 extends (blockTag extends "pending" ? true : false) ? T_5 extends true ? null : number : never : never;
         } | {
+            input: import("viem").Hex;
+            s: import("viem").Hex;
             type: "eip1559";
             value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
             hash: import("viem").Hash;
-            input: import("viem").Hex;
             nonce: number;
             r: import("viem").Hex;
-            s: import("viem").Hex;
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
@@ -583,16 +583,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_7 ? T_7 extends (blockTag extends "pending" ? true : false) ? T_7 extends true ? null : bigint : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_8 ? T_8 extends (blockTag extends "pending" ? true : false) ? T_8 extends true ? null : number : never : never;
         } | {
+            input: import("viem").Hex;
+            s: import("viem").Hex;
             type: "eip4844";
             value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
             hash: import("viem").Hash;
-            input: import("viem").Hex;
             nonce: number;
             r: import("viem").Hex;
-            s: import("viem").Hex;
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
@@ -608,16 +608,16 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             blockNumber: (blockTag extends "pending" ? true : false) extends infer T_10 ? T_10 extends (blockTag extends "pending" ? true : false) ? T_10 extends true ? null : bigint : never : never;
             transactionIndex: (blockTag extends "pending" ? true : false) extends infer T_11 ? T_11 extends (blockTag extends "pending" ? true : false) ? T_11 extends true ? null : number : never : never;
         } | {
+            input: import("viem").Hex;
+            s: import("viem").Hex;
             type: "eip7702";
             value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
             hash: import("viem").Hash;
-            input: import("viem").Hex;
             nonce: number;
             r: import("viem").Hex;
-            s: import("viem").Hex;
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
@@ -8162,9 +8162,9 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             [x: `address[${string}]`]: undefined;
             [x: `bool[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
+            [x: `bytes3[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
-            [x: `bytes3[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
@@ -8264,9 +8264,9 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             address?: undefined;
             bool?: undefined;
             bytes?: undefined;
+            bytes3?: undefined;
             bytes1?: undefined;
             bytes2?: undefined;
-            bytes3?: undefined;
             bytes4?: undefined;
             bytes5?: undefined;
             bytes6?: undefined;
@@ -13137,9 +13137,9 @@ export declare function useExternalWalletClient(): {
             [x: `address[${string}]`]: undefined;
             [x: `bool[${string}]`]: undefined;
             [x: `bytes[${string}]`]: undefined;
+            [x: `bytes3[${string}]`]: undefined;
             [x: `bytes1[${string}]`]: undefined;
             [x: `bytes2[${string}]`]: undefined;
-            [x: `bytes3[${string}]`]: undefined;
             [x: `bytes4[${string}]`]: undefined;
             [x: `bytes5[${string}]`]: undefined;
             [x: `bytes6[${string}]`]: undefined;
@@ -13239,9 +13239,9 @@ export declare function useExternalWalletClient(): {
             address?: undefined;
             bool?: undefined;
             bytes?: undefined;
+            bytes3?: undefined;
             bytes1?: undefined;
             bytes2?: undefined;
-            bytes3?: undefined;
             bytes4?: undefined;
             bytes5?: undefined;
             bytes6?: undefined;

package/dist/src/wagmiConfig.js

@@ -4,6 +4,7 @@
 import { createConfig, createStorage, http, cookieStorage, } from "@wagmi/core";
 import { injected, walletConnect } from "wagmi/connectors";
 import { SUPPORTED_CHAINS, } from "@abstraxn/signer-core";
+import { createWalletConnectDappMetadata } from "./walletConnectMobile";
 /**
  * Convert internal Chain type to viem Chain type
  * Uses viem's built-in chain definitions when available for better compatibility
@@ -79,14 +80,7 @@ export function createWagmiConfig(chains, walletConnectProjectId, enabledConnect
         else {
             connectors.push(walletConnect({
                 projectId: walletConnectProjectId,
-                metadata: {
-                    name: "Abstraxn",
-                    description: "Abstraxn Wallet",
-                    url: typeof window !== "undefined"
-                        ? window.location.origin
-                        : "https://abstraxn.com",
-                    icons: ["https://avatars.githubusercontent.com/u/37784886"],
-                },
+                metadata: createWalletConnectDappMetadata(),
                 showQrModal: true,
                 qrModalOptions: {
                     themeMode: theme === "dark" ? "dark" : "light",

package/dist/src/walletConnectMobile.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Mobile WalletConnect helpers.
+ *
+ * On iOS/Android the browser suspends JS and drops the WalletConnect relay
+ * WebSocket when the user is sent to MetaMask (or another wallet) via deeplink.
+ * The wallet still approves/rejects, but the in-flight JSON-RPC promise never
+ * settles unless the relay is resumed when the dapp becomes visible again.
+ *
+ * After approve/reject, MetaMask opens metadata.redirect / metadata.url. Using
+ * only `location.origin` sends iOS users to Safari on the homepage (full reload,
+ * lost React state). We:
+ * - keep metadata.url as the current page (not origin)
+ * - on iOS Chrome/Firefox/etc. set redirect.native to the browser app scheme
+ *   with no path, so the existing tab is foregrounded
+ * - on Safari omit redirect so MetaMask can `goBack()` to the same tab
+ */
+/** Selectors used to close/restore Reown AppKit + WalletConnect modal DOM. */
+export declare const WALLETCONNECT_MODAL_SELECTORS: string[];
+export declare function isWalletConnectConnector(connector: {
+    id?: string;
+    name?: string;
+} | null | undefined): boolean;
+export declare function isUserApprovalRpcMethod(method: unknown): boolean;
+export declare function hasPendingWalletConnectApproval(provider?: any): boolean;
+export declare function hasActiveWalletConnectSession(provider: any): boolean;
+/**
+ * Current dapp page, including path/query/hash. Never origin-only — that is
+ * what made MetaMask open the homepage after approve/reject.
+ */
+export declare function getDappReturnUrl(): string;
+/**
+ * iOS-only app scheme for the browser the user is actually in. No path:
+ * opening `googlechrome://` foregrounds Chrome's existing tab instead of
+ * navigating Safari to a new URL (which reloads and drops in-memory state).
+ */
+export declare function getSourceBrowserNativeRedirect(): string | undefined;
+/**
+ * Lazy metadata so url/redirect are read at connect/request time, not at
+ * provider mount (which is often the homepage in Next.js layouts).
+ */
+export declare function createWalletConnectDappMetadata(): {
+    name: string;
+    description: string;
+    icons: string[];
+    url: string;
+    redirect?: {
+        native?: string;
+        universal?: string;
+    };
+};
+export declare function rememberCurrentPageForWalletReturn(): void;
+export declare function clearWalletReturnIfSameDocument(): void;
+/**
+ * If the wallet opened a fresh Safari tab on the homepage, send the user back
+ * to the page they transacted from. This still reloads that page (React state
+ * cannot be recovered), but it is better than leaving them on `/`.
+ */
+export declare function restoreAfterWalletRedirect(): void;
+/**
+ * Push the current page + source-browser scheme onto the live WC provider so
+ * MetaMask does not keep a stale homepage redirect from first init.
+ */
+export declare function syncWalletConnectDappRedirect(provider: any): void;
+/**
+ * Re-open the WalletConnect relay after the mobile browser comes back
+ * from the wallet app so pending approve/reject responses can be delivered.
+ */
+export declare function resumeWalletConnectRelayer(provider: any): Promise<void>;
+/**
+ * Undo the inline `display: none !important` we apply after connect so the
+ * WalletConnect modal can show "Continue in wallet" and process the response.
+ */
+export declare function restoreWalletConnectModal(): 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.
+ */
+export declare function subscribeWalletConnectForegroundResume(provider: any): () => void;

package/dist/src/walletConnectMobile.js

@@ -0,0 +1,399 @@
+/**
+ * Mobile WalletConnect helpers.
+ *
+ * On iOS/Android the browser suspends JS and drops the WalletConnect relay
+ * WebSocket when the user is sent to MetaMask (or another wallet) via deeplink.
+ * The wallet still approves/rejects, but the in-flight JSON-RPC promise never
+ * settles unless the relay is resumed when the dapp becomes visible again.
+ *
+ * After approve/reject, MetaMask opens metadata.redirect / metadata.url. Using
+ * only `location.origin` sends iOS users to Safari on the homepage (full reload,
+ * lost React state). We:
+ * - keep metadata.url as the current page (not origin)
+ * - on iOS Chrome/Firefox/etc. set redirect.native to the browser app scheme
+ *   with no path, so the existing tab is foregrounded
+ * - on Safari omit redirect so MetaMask can `goBack()` to the same tab
+ */
+const PATCHED_FLAG = "__abstraxnWcMobilePatched";
+const PENDING_FLAG = "__abstraxnWcPendingApprovals";
+const RETURN_HREF_KEY = "abstraxn_wc_return_href";
+const RETURN_AT_KEY = "abstraxn_wc_return_at";
+const RETURN_TTL_MS = 3 * 60 * 1000;
+const USER_APPROVAL_METHODS = new Set([
+    "personal_sign",
+    "eth_sign",
+    "eth_signTypedData",
+    "eth_signTypedData_v3",
+    "eth_signTypedData_v4",
+    "eth_signTransaction",
+    "eth_sendTransaction",
+    "eth_sendRawTransaction",
+    "wallet_sendCalls",
+    "wallet_sendCallsSync",
+    "wallet_grantPermissions",
+    "wallet_requestPermissions",
+    "wallet_watchAsset",
+    "wallet_addEthereumChain",
+    "wallet_switchEthereumChain",
+]);
+/** Selectors used to close/restore Reown AppKit + WalletConnect modal DOM. */
+export const WALLETCONNECT_MODAL_SELECTORS = [
+    "w3m-modal",
+    "w3m-modal-backdrop",
+    "wcm-modal",
+    "[data-w3m-modal]",
+    ".w3m-modal",
+    ".w3m-modal-backdrop",
+    "#w3m-modal",
+    "[class*='w3m-modal']",
+    "[id*='w3m-modal']",
+    "[class*='walletconnect-qrcode']",
+    "[id*='walletconnect']",
+];
+export function isWalletConnectConnector(connector) {
+    if (!connector)
+        return false;
+    const id = String(connector.id || "").toLowerCase();
+    const name = String(connector.name || "").toLowerCase();
+    return (id.includes("walletconnect") ||
+        id.includes("wallet_connect") ||
+        name.includes("walletconnect") ||
+        name.includes("wallet connect"));
+}
+export function isUserApprovalRpcMethod(method) {
+    return typeof method === "string" && USER_APPROVAL_METHODS.has(method);
+}
+export function hasPendingWalletConnectApproval(provider) {
+    if (provider && typeof provider[PENDING_FLAG] === "number") {
+        return provider[PENDING_FLAG] > 0;
+    }
+    return false;
+}
+export function hasActiveWalletConnectSession(provider) {
+    const session = provider?.session ?? provider?.signer?.session;
+    if (!session?.topic)
+        return false;
+    if (typeof session.expiry === "number" &&
+        session.expiry > 0 &&
+        session.expiry * 1000 < Date.now()) {
+        return false;
+    }
+    return true;
+}
+function isIOS() {
+    if (typeof navigator === "undefined")
+        return false;
+    const ua = navigator.userAgent || "";
+    const platform = navigator.platform || "";
+    return (/iPad|iPhone|iPod/i.test(ua) ||
+        (platform === "MacIntel" && (navigator.maxTouchPoints || 0) > 1));
+}
+/**
+ * Current dapp page, including path/query/hash. Never origin-only — that is
+ * what made MetaMask open the homepage after approve/reject.
+ */
+export function getDappReturnUrl() {
+    if (typeof window === "undefined")
+        return "https://abstraxn.com";
+    const url = new URL(window.location.href);
+    url.searchParams.delete("wc_ev");
+    url.searchParams.delete("wc_res");
+    return `${url.origin}${url.pathname}${url.search}${url.hash}`;
+}
+/**
+ * iOS-only app scheme for the browser the user is actually in. No path:
+ * opening `googlechrome://` foregrounds Chrome's existing tab instead of
+ * navigating Safari to a new URL (which reloads and drops in-memory state).
+ */
+export function getSourceBrowserNativeRedirect() {
+    if (typeof navigator === "undefined" || !isIOS())
+        return undefined;
+    const ua = navigator.userAgent || "";
+    if (/FxiOS/i.test(ua))
+        return "firefox://";
+    if (/EdgiOS/i.test(ua))
+        return "microsoft-edge://";
+    if (/OPiOS/i.test(ua) || /OPT\//i.test(ua))
+        return "touch://";
+    if (/Brave/i.test(ua))
+        return "brave://";
+    if (/CriOS/i.test(ua))
+        return "googlechrome://";
+    return undefined;
+}
+function getWalletConnectRedirect() {
+    const native = getSourceBrowserNativeRedirect();
+    return native ? { native } : undefined;
+}
+/**
+ * Lazy metadata so url/redirect are read at connect/request time, not at
+ * provider mount (which is often the homepage in Next.js layouts).
+ */
+export function createWalletConnectDappMetadata() {
+    return {
+        name: "Abstraxn",
+        description: "Abstraxn Wallet",
+        icons: ["https://avatars.githubusercontent.com/u/37784886"],
+        get url() {
+            return getDappReturnUrl();
+        },
+        get redirect() {
+            return getWalletConnectRedirect();
+        },
+    };
+}
+export function rememberCurrentPageForWalletReturn() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        window.localStorage.setItem(RETURN_HREF_KEY, getDappReturnUrl());
+        window.localStorage.setItem(RETURN_AT_KEY, String(Date.now()));
+    }
+    catch {
+        // Ignore quota / private-mode errors.
+    }
+}
+export function clearWalletReturnIfSameDocument() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        const saved = window.localStorage.getItem(RETURN_HREF_KEY);
+        if (!saved)
+            return;
+        const savedUrl = new URL(saved, window.location.origin);
+        if (savedUrl.origin !== window.location.origin)
+            return;
+        if (savedUrl.pathname === window.location.pathname &&
+            savedUrl.search === window.location.search &&
+            savedUrl.hash === window.location.hash) {
+            window.localStorage.removeItem(RETURN_HREF_KEY);
+            window.localStorage.removeItem(RETURN_AT_KEY);
+        }
+    }
+    catch {
+        // Ignore
+    }
+}
+/**
+ * If the wallet opened a fresh Safari tab on the homepage, send the user back
+ * to the page they transacted from. This still reloads that page (React state
+ * cannot be recovered), but it is better than leaving them on `/`.
+ */
+export function restoreAfterWalletRedirect() {
+    if (typeof window === "undefined")
+        return;
+    try {
+        const at = Number(window.localStorage.getItem(RETURN_AT_KEY) || 0);
+        const saved = window.localStorage.getItem(RETURN_HREF_KEY);
+        if (!saved || !at || Date.now() - at > RETURN_TTL_MS) {
+            window.localStorage.removeItem(RETURN_HREF_KEY);
+            window.localStorage.removeItem(RETURN_AT_KEY);
+            return;
+        }
+        const savedUrl = new URL(saved, window.location.origin);
+        if (savedUrl.origin !== window.location.origin) {
+            window.localStorage.removeItem(RETURN_HREF_KEY);
+            window.localStorage.removeItem(RETURN_AT_KEY);
+            return;
+        }
+        const savedPath = `${savedUrl.pathname}${savedUrl.search}${savedUrl.hash}`;
+        const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;
+        if (savedPath === currentPath) {
+            window.localStorage.removeItem(RETURN_HREF_KEY);
+            window.localStorage.removeItem(RETURN_AT_KEY);
+            return;
+        }
+        window.localStorage.removeItem(RETURN_HREF_KEY);
+        window.localStorage.removeItem(RETURN_AT_KEY);
+        window.location.replace(savedUrl.href);
+    }
+    catch {
+        // Ignore
+    }
+}
+function applyDappMetadata(meta, url, redirect) {
+    if (!meta || typeof meta !== "object")
+        return;
+    meta.url = url;
+    if (redirect) {
+        meta.redirect = { native: redirect.native };
+    }
+    else if (meta.redirect) {
+        delete meta.redirect;
+    }
+}
+/**
+ * Push the current page + source-browser scheme onto the live WC provider so
+ * MetaMask does not keep a stale homepage redirect from first init.
+ */
+export function syncWalletConnectDappRedirect(provider) {
+    if (!provider || typeof window === "undefined")
+        return;
+    const url = getDappReturnUrl();
+    const redirect = getWalletConnectRedirect();
+    rememberCurrentPageForWalletReturn();
+    applyDappMetadata(provider.metadata, url, redirect);
+    applyDappMetadata(provider.signer?.metadata, url, redirect);
+    applyDappMetadata(provider.session?.self?.metadata, url, redirect);
+    applyDappMetadata(provider.signer?.session?.self?.metadata, url, redirect);
+}
+function getWalletConnectRelayer(provider) {
+    return (provider?.signer?.client?.core?.relayer ||
+        provider?.client?.core?.relayer ||
+        provider?.rpc?.provider?.signer?.client?.core?.relayer ||
+        provider?.universalProvider?.client?.core?.relayer ||
+        null);
+}
+function isRelayerConnected(relayer) {
+    return (relayer?.connected === true ||
+        relayer?.provider?.connected === true ||
+        relayer?.provider?.connection?.connected === true);
+}
+/**
+ * Re-open the WalletConnect relay after the mobile browser comes back
+ * from the wallet app so pending approve/reject responses can be delivered.
+ */
+export async function resumeWalletConnectRelayer(provider) {
+    if (!provider)
+        return;
+    const relayer = getWalletConnectRelayer(provider);
+    if (!relayer)
+        return;
+    try {
+        if (isRelayerConnected(relayer)) {
+            try {
+                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)),
+                    ]);
+                }
+                return;
+            }
+            catch {
+                // Ping failed — transport looks stale, restart below.
+            }
+        }
+        if (typeof relayer.restartTransport === "function") {
+            await relayer.restartTransport();
+        }
+        else if (typeof relayer.transportOpen === "function") {
+            try {
+                await relayer.transportClose?.();
+            }
+            catch {
+                // Ignore close errors and still try to open.
+            }
+            await relayer.transportOpen();
+        }
+        const session = provider?.session ?? provider?.signer?.session;
+        const topic = session?.topic;
+        const client = provider?.signer?.client || provider?.client;
+        if (topic && typeof client?.ping === "function") {
+            try {
+                await client.ping({ topic });
+            }
+            catch {
+                // Session ping is best-effort; the request may still complete.
+            }
+        }
+    }
+    catch {
+        // Best-effort: a failed resume should not break the original request.
+    }
+}
+/**
+ * Undo the inline `display: none !important` we apply after connect so the
+ * WalletConnect modal can show "Continue in wallet" and process the response.
+ */
+export function restoreWalletConnectModal() {
+    if (typeof document === "undefined")
+        return;
+    WALLETCONNECT_MODAL_SELECTORS.forEach((sel) => {
+        try {
+            document.querySelectorAll(sel).forEach((el) => {
+                const htmlEl = el;
+                if (htmlEl?.style) {
+                    htmlEl.style.removeProperty("display");
+                }
+            });
+        }
+        catch {
+            // Ignore invalid selectors in older browsers.
+        }
+    });
+}
+function getRequestMethod(args) {
+    const payload = args[0];
+    if (typeof payload === "string")
+        return payload;
+    if (payload && typeof payload === "object" && "method" in payload) {
+        return payload.method;
+    }
+    return undefined;
+}
+/**
+ * Patch the EIP-1193 provider so signing/tx requests resume the relay first.
+ * Covers wagmi hooks, viem walletClient, and direct provider.request calls.
+ */
+export function patchWalletConnectProviderForMobile(provider) {
+    if (!provider || typeof provider.request !== "function")
+        return;
+    if (provider[PATCHED_FLAG])
+        return;
+    const originalRequest = provider.request.bind(provider);
+    provider[PATCHED_FLAG] = true;
+    provider[PENDING_FLAG] = 0;
+    provider.request = async (...args) => {
+        const method = getRequestMethod(args);
+        if (!isUserApprovalRpcMethod(method)) {
+            return originalRequest(...args);
+        }
+        provider[PENDING_FLAG] = (provider[PENDING_FLAG] || 0) + 1;
+        restoreWalletConnectModal();
+        syncWalletConnectDappRedirect(provider);
+        try {
+            await resumeWalletConnectRelayer(provider);
+            return await originalRequest(...args);
+        }
+        finally {
+            provider[PENDING_FLAG] = Math.max(0, (provider[PENDING_FLAG] || 1) - 1);
+        }
+    };
+}
+/**
+ * When the dapp tab is shown again (user left MetaMask), restart the relay so
+ * the pending WalletConnect response can be received.
+ */
+export function subscribeWalletConnectForegroundResume(provider) {
+    if (typeof window === "undefined" || !provider)
+        return () => { };
+    let timer = null;
+    const resume = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            clearWalletReturnIfSameDocument();
+            void resumeWalletConnectRelayer(provider);
+            if (hasPendingWalletConnectApproval(provider)) {
+                restoreWalletConnectModal();
+            }
+        }, 250);
+    };
+    const onVisibility = () => {
+        if (document.visibilityState === "visible")
+            resume();
+    };
+    document.addEventListener("visibilitychange", onVisibility);
+    window.addEventListener("pageshow", resume);
+    window.addEventListener("focus", resume);
+    return () => {
+        if (timer)
+            clearTimeout(timer);
+        document.removeEventListener("visibilitychange", onVisibility);
+        window.removeEventListener("pageshow", resume);
+        window.removeEventListener("focus", resume);
+    };
+}
+//# sourceMappingURL=walletConnectMobile.js.map

package/package.json

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