@abstraxn/signer-react 3.1.3 → 3.1.4

package/CHANGELOG.md

@@ -5,16 +5,20 @@ 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.1.3] - 2026-03-31
+## [3.1.4] - 2026-04-06
 
 ### Changed
 
-- **Embedded-only wagmi context** – When `externalWallets.enabled` is `false`, the provider still mounts `QueryClientProvider` and `WagmiProvider` using a **connector-free** wagmi config (`createWagmiConfig(..., embedOnly: true)`), so hooks like `useConfig`, `useAccount`, and unified chain switching keep working for email/social embedded flows without registering injected/MetaMask/WalletConnect connectors. If React Query is missing, the error message now describes wagmi hook requirements instead of blaming disabled external wallets.
-- **`createWagmiConfig` embed mode** – New optional `embedOnly` flag builds a minimal wagmi `Config` (empty `connectors`, shared HTTP transports and storage) for embedded-only usage; chain list must still be non-empty.
+- **Passkey completion via login code (`@abstraxn/signer-core`)** – Passkey signup and login now expect a `loginCode` (and optional `mfaRequired`) from the backend, then exchange it through `POST /auth/exchange` before tokens and user state are finalized. Passkey responses no longer persist access/refresh tokens directly from those calls.
+- **Auth route prefixes** – OTP init/verify and passkey signup/login client paths use `/auth/otp/...` and `/auth/passkey/...` instead of `/login/otp/...` and `/login/passkey/...`.
+- **Passkey login stamp** – The WebAuthn/Turnkey stamp is serialized and sent as a JSON string in the passkey login request, matching the updated API contract.
+- **Passkey signup payload** – `targetPublicKey` is optional when a device public key is not available; session completion merges profile fields from the passkey API response where the JWT omits them (e.g. `isPolicy`, `publicKey`, `authProvider`).
+- **MFA after passkey** – `AbstraxnWallet.loginWithPasskey` / `signupWithPasskey` and the React provider defer `connect()` when MFA is still required; `AuthManager` tracks `pendingSessionAuthMethod: 'passkey'` so post-MFA session setup uses the correct path.
 
-### Fixed
+### Added
 
-- **`useExternalWalletInfo().switchChain`** – Returns the unified `switchChain` implementation (embedded + external) instead of only the external-wallet switcher, so chain changes behave consistently when external wallets are off.
+- **`PasskeyFlowResult` and onboarding hooks** – `onPasskeySignup` / `onPasskeyLogin` may return `{ mfaRequired: true }`; `onPasskeyPendingMfa` lets UIs jump to the MFA step (`OnboardingUIReact`, `OnboardingUIWeb`, and `useAuthMethods`). `PasskeyFlowResult` is re-exported from `@abstraxn/signer-core`.
+- **Server logout on full disconnect** – When the Abstraxn session disconnect runs, the SDK best-effort calls `POST /auth/logout` with the current access token (external-wallet-only disconnect continues to skip this).
 
 ## [3.1.2] - 2026-03-27
 

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

@@ -168,67 +168,38 @@ export function AbstraxnProvider({ config, children }) {
         externalSsr,
         config.wagmiConfig,
     ]);
-    // Connector-free wagmi config so `useConfig` / `useAccount` / etc. never throw when
-    // `externalWallets.enabled` is false (embedded email/social only). React Query is required
-    // for WagmiProvider the same as for the full external-wallet tree.
-    const { embedWagmiConfig, embedConfigError } = useMemo(() => {
-        if (externalWalletsEnabled) {
-            return { embedWagmiConfig: null, embedConfigError: null };
-        }
-        try {
-            const cfg = createWagmiConfig(wagmiChains, undefined, undefined, wagmiThemeRef.current, externalSsr, true);
-            return { embedWagmiConfig: cfg, embedConfigError: null };
-        }
-        catch (error) {
-            console.error("Failed to create embed-only wagmi config:", error);
-            return {
-                embedWagmiConfig: null,
-                embedConfigError: error instanceof Error
-                    ? error
-                    : new Error("Failed to create embed-only wagmi config"),
-            };
-        }
-    }, [externalWalletsEnabled, chainsKey, externalSsr]);
-    // Embedded-only mode: still mount WagmiProvider (no connectors) when React Query is available.
-    if (!externalWalletsEnabled) {
+    // If external wallets are enabled, wrap with QueryClientProvider and WagmiProvider
+    if (externalWalletsEnabled) {
+        // Check if React Query is available BEFORE doing anything else
+        // This prevents errors from happening in the first place
         const queryCheck = canUseReactQuery();
         if (!queryCheck.canUse) {
-            console.error("❌ Wagmi hooks require @tanstack/react-query. Install it or wrap your app with QueryClientProvider.\n" +
+            console.error("❌ External wallets are disabled because React Query is not available.\n" +
                 `Reason: ${queryCheck.reason || "Unknown"}\n` +
-                "Rendering without WagmiProvider; calls to useConfig may throw.");
+                "Please install @tanstack/react-query@^5.90.16 and ensure there is only one React instance.\n" +
+                "Falling back to Abstraxn wallet only.");
             return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
         }
-        if (embedConfigError || !embedWagmiConfig) {
-            if (embedConfigError) {
-                console.error("Failed to create embed-only wagmi config:", embedConfigError);
-            }
+        if (configError) {
+            console.error("Failed to create wagmi config:", configError);
+            // Fallback to provider without wagmi if config creation fails
             return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
         }
+        if (!wagmiConfig) {
+            // Show loading state while config is being created
+            // Don't render AbstraxnProviderInner until wagmiConfig is ready
+            return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Loading wallet connectors..." }) }));
+        }
+        // ✅ For SSR mode, wait for hydration before rendering WagmiProvider
+        // This ensures injected wallets (Phantom, etc.) are detected properly
         if (externalSsr && !isHydrated) {
-            return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Hydrating..." }) }));
+            return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Hydrating wallet connectors..." }) }));
         }
-        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx(WagmiProvider, { config: embedWagmiConfig, children: _jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }) }) }));
-    }
-    // External wallets enabled: full connectors + Solana adapter tree
-    // Check if React Query is available BEFORE doing anything else
-    const queryCheck = canUseReactQuery();
-    if (!queryCheck.canUse) {
-        console.error("❌ External wallets are disabled because React Query is not available.\n" +
-            `Reason: ${queryCheck.reason || "Unknown"}\n` +
-            "Please install @tanstack/react-query@^5.90.16 and ensure there is only one React instance.\n" +
-            "Falling back to Abstraxn wallet only.");
-        return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
-    }
-    if (configError) {
-        console.error("Failed to create wagmi config:", configError);
-        return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
-    }
-    if (!wagmiConfig) {
-        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Loading wallet connectors..." }) }));
-    }
-    if (externalSsr && !isHydrated) {
-        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Hydrating wallet connectors..." }) }));
+        // Do NOT pass key to WagmiProvider. Remounting loses connection state and causes
+        // "Connector not connected" in Next.js (e.g. when config loads after hydration).
+        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx(ConnectionProvider, { endpoint: config.chains?.solanaEndpoint || "https://api.mainnet-beta.solana.com", children: _jsx(WalletProvider, { wallets: solanaWallets, autoConnect: true, children: _jsx(WagmiProvider, { config: wagmiConfig, initialState: config.initialState, children: _jsx(AbstraxnProviderWithWagmi, { config: config, children: children }) }) }) }) }));
     }
-    return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx(ConnectionProvider, { endpoint: config.chains?.solanaEndpoint || "https://api.mainnet-beta.solana.com", children: _jsx(WalletProvider, { wallets: solanaWallets, autoConnect: true, children: _jsx(WagmiProvider, { config: wagmiConfig, initialState: config.initialState, children: _jsx(AbstraxnProviderWithWagmi, { config: config, children: children }) }) }) }) }));
+    // If external wallets are disabled, use the provider without wagmi
+    return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
 }
 //# sourceMappingURL=AbstraxnProvider.js.map

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

@@ -766,10 +766,13 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                 }
                 const authManager = walletInstance.getAuthManager();
                 const user = await authManager.loginWithPasskey();
-                // Set user immediately so onLoginSuccess can access it
                 setUser(user);
-                // Connect wallet after successful authentication
+                const lastAuthState = authManager.getLastAuthState();
+                if (lastAuthState?.mfaRequired === true) {
+                    return { mfaRequired: true };
+                }
                 await walletInstance.connect();
+                return undefined;
             },
             onPasskeySignup: async () => {
                 if (!walletInstance)
@@ -784,11 +787,13 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
                 }
                 const authManager = walletInstance.getAuthManager();
                 const user = await authManager.signupWithPasskey();
-                // Clear any previous errors on successful verification
-                // setError(null);
                 setUser(user);
-                // Connect wallet after successful authentication
+                const lastAuthState = authManager.getLastAuthState();
+                if (lastAuthState?.mfaRequired === true) {
+                    return { mfaRequired: true };
+                }
                 await walletInstance.connect();
+                return undefined;
             },
             onLoginSuccess: async (_data) => {
                 // Clear any previous errors on successful login
@@ -1605,7 +1610,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
             setLoading(false);
         }
     }, [showOnboarding]);
-    // Disconnect wallet
+    // Full disconnect: when Abstraxn is connected, `wallet.disconnect()` runs and signer-core notifies POST /auth/logout; external-wallet-only flows use `disconnectExternalWallet` instead (no core disconnect).
     const disconnect = useCallback(async () => {
         setLoading(true);
         setDisconnecting(true);
@@ -2972,7 +2977,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
         wagmiDisconnect,
         wagmiAccount?.isConnected,
     ]);
-    // Disconnect external wallet
+    // External wallet only — does not call AbstraxnWallet.disconnect (no server /auth/logout).
     const disconnectExternalWallet = useCallback(async () => {
         if (!externalWalletsEnabled || !wagmiDisconnect) {
             return;

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

@@ -351,10 +351,13 @@ export function useWalletInitialization({ config, walletRef, onboardingRef, otpI
                 }
                 const authManager = walletInstance.getAuthManager();
                 const user = await authManager.loginWithPasskey();
-                // Set user immediately so onLoginSuccess can access it
                 setUser(user);
-                // Connect wallet after successful authentication
+                const lastAuthState = authManager.getLastAuthState();
+                if (lastAuthState?.mfaRequired === true) {
+                    return { mfaRequired: true };
+                }
                 await walletInstance.connect();
+                return undefined;
             },
             onPasskeySignup: async () => {
                 if (!walletInstance)
@@ -369,11 +372,13 @@ export function useWalletInitialization({ config, walletRef, onboardingRef, otpI
                 }
                 const authManager = walletInstance.getAuthManager();
                 const user = await authManager.signupWithPasskey();
-                // Clear any previous errors on successful verification
-                // setError(null);
                 setUser(user);
-                // Connect wallet after successful authentication
+                const lastAuthState = authManager.getLastAuthState();
+                if (lastAuthState?.mfaRequired === true) {
+                    return { mfaRequired: true };
+                }
                 await walletInstance.connect();
+                return undefined;
             },
             onLoginSuccess: async (_data) => {
                 // Clear any previous errors on successful login

package/dist/src/components/OnboardingUI/OnboardingUIReact.js

@@ -27,7 +27,10 @@ export const OnboardingUIReact = ({ config = {}, modal = false, onClose, externa
     const authMethods = config.authMethods || ["otp", "google"];
     const showModalCloseButton = config.showCloseButton === true;
     const onboarding = useOnboarding(config);
-    const authMethodsHook = useAuthMethods(config);
+    const authMethodsHook = useAuthMethods({
+        ...config,
+        onPasskeyPendingMfa: config.onPasskeyPendingMfa ?? (() => onboarding.setStep("mfa")),
+    });
     const { user, isConnected, whoami, loading: providerLoading, error: providerError, emailForOtp, } = useAbstraxnWallet();
     const [showExternalWallets, setShowExternalWallets] = useState(false);
     const [oauthLoading, setOauthLoading] = useState(false);

package/dist/src/components/OnboardingUI/OnboardingUIWeb.js

@@ -4286,8 +4286,11 @@ export class OnboardingUIWeb {
             this.setLoading(true, "passkey");
             this.hidePasskeyError();
             if (this.config.onPasskeyLogin) {
-                await this.config.onPasskeyLogin();
-                // Call onLoginSuccess to close modal and update state
+                const result = await this.config.onPasskeyLogin();
+                if (result && typeof result === "object" && result.mfaRequired === true) {
+                    this.showMfaVerificationScreenForOAuth();
+                    return;
+                }
                 if (this.config.onLoginSuccess) {
                     this.config.onLoginSuccess({ user: null });
                 }
@@ -4318,8 +4321,11 @@ export class OnboardingUIWeb {
             this.setLoading(true, "passkey");
             this.hidePasskeyError();
             if (this.config.onPasskeySignup) {
-                await this.config.onPasskeySignup();
-                // Call onLoginSuccess to close modal and update state
+                const result = await this.config.onPasskeySignup();
+                if (result && typeof result === "object" && result.mfaRequired === true) {
+                    this.showMfaVerificationScreenForOAuth();
+                    return;
+                }
                 if (this.config.onLoginSuccess) {
                     this.config.onLoginSuccess({ user: null });
                 }

package/dist/src/components/OnboardingUI/hooks/useAuthMethods.js

@@ -192,6 +192,11 @@ export const useAuthMethods = (config) => {
             else {
                 await wallet.loginWithPasskey();
             }
+            const mfaPending = wallet.getAuthManager().getLastAuthState()?.mfaRequired === true;
+            if (mfaPending) {
+                config?.onPasskeyPendingMfa?.();
+                return;
+            }
             config?.onLoginSuccess?.({});
         }
         catch (err) {
@@ -225,6 +230,11 @@ export const useAuthMethods = (config) => {
             else {
                 await wallet.signupWithPasskey();
             }
+            const mfaPending = wallet.getAuthManager().getLastAuthState()?.mfaRequired === true;
+            if (mfaPending) {
+                config?.onPasskeyPendingMfa?.();
+                return;
+            }
             config?.onLoginSuccess?.({});
         }
         catch (err) {

package/dist/src/hooks.d.ts

@@ -322,6 +322,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             withdrawalsRoot?: `0x${string}` | undefined;
             transactions: includeTransactions extends true ? ({
                 type: "legacy";
+                value: bigint;
                 yParity?: undefined | undefined;
                 from: Address;
                 gas: bigint;
@@ -333,7 +334,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
-                value: bigint;
                 accessList?: undefined | undefined;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -347,6 +347,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 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;
             } | {
                 type: "eip2930";
+                value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
@@ -358,7 +359,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
-                value: bigint;
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -372,6 +372,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 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;
             } | {
                 type: "eip1559";
+                value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
@@ -383,7 +384,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
-                value: bigint;
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes?: undefined | undefined;
@@ -397,6 +397,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 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;
             } | {
                 type: "eip4844";
+                value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
@@ -408,7 +409,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
-                value: bigint;
                 accessList: import("viem").AccessList;
                 authorizationList?: undefined | undefined;
                 blobVersionedHashes: readonly import("viem").Hex[];
@@ -422,6 +422,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 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;
             } | {
                 type: "eip7702";
+                value: bigint;
                 yParity: number;
                 from: Address;
                 gas: bigint;
@@ -433,7 +434,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
                 to: Address | null;
                 typeHex: import("viem").Hex | null;
                 v: bigint;
-                value: bigint;
                 accessList: import("viem").AccessList;
                 authorizationList: import("viem").SignedAuthorizationList;
                 blobVersionedHashes?: undefined | undefined;
@@ -473,6 +473,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
         getStorageAt: (args: import("viem").GetStorageAtParameters) => Promise<import("viem").GetStorageAtReturnType>;
         getTransaction: <blockTag extends import("viem").BlockTag = "latest">(args: import("viem").GetTransactionParameters<blockTag>) => Promise<{
             type: "legacy";
+            value: bigint;
             yParity?: undefined | undefined;
             from: Address;
             gas: bigint;
@@ -484,7 +485,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
-            value: bigint;
             accessList?: undefined | undefined;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -498,6 +498,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             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;
         } | {
             type: "eip2930";
+            value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
@@ -509,7 +510,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
-            value: bigint;
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -523,6 +523,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             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;
         } | {
             type: "eip1559";
+            value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
@@ -534,7 +535,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
-            value: bigint;
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes?: undefined | undefined;
@@ -548,6 +548,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             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;
         } | {
             type: "eip4844";
+            value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
@@ -559,7 +560,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
-            value: bigint;
             accessList: import("viem").AccessList;
             authorizationList?: undefined | undefined;
             blobVersionedHashes: readonly import("viem").Hex[];
@@ -573,6 +573,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             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;
         } | {
             type: "eip7702";
+            value: bigint;
             yParity: number;
             from: Address;
             gas: bigint;
@@ -584,7 +585,6 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             to: Address | null;
             typeHex: import("viem").Hex | null;
             v: bigint;
-            value: bigint;
             accessList: import("viem").AccessList;
             authorizationList: import("viem").SignedAuthorizationList;
             blobVersionedHashes?: undefined | undefined;
@@ -3888,7 +3888,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             transport?: undefined;
             type?: undefined;
             uid?: undefined;
-        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, Chain | undefined, undefined>, "prepareTransactionRequest" | "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain | undefined, undefined>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("viem").Transport, Chain | undefined, undefined, import("viem").PublicRpcSchema, import("viem").PublicActions<import("viem").Transport, Chain | undefined>>) => client) => import("viem").Client<import("viem").Transport, Chain | undefined, undefined, import("viem").PublicRpcSchema, { [K in keyof client]: client[K]; } & import("viem").PublicActions<import("viem").Transport, Chain | undefined>>;
+        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, Chain | undefined, undefined>, "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain | undefined, undefined>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("viem").Transport, Chain | undefined, undefined, import("viem").PublicRpcSchema, import("viem").PublicActions<import("viem").Transport, Chain | undefined>>) => client) => import("viem").Client<import("viem").Transport, Chain | undefined, undefined, import("viem").PublicRpcSchema, { [K in keyof client]: client[K]; } & import("viem").PublicActions<import("viem").Transport, Chain | undefined>>;
     };
 };
 /**
@@ -8350,7 +8350,7 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             transport?: undefined;
             type?: undefined;
             uid?: undefined;
-        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, Chain | undefined, import("viem").Account | undefined>, "prepareTransactionRequest" | "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, import("viem").WalletRpcSchema, import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>>) => client) => import("viem").Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, import("viem").WalletRpcSchema, { [K in keyof client]: client[K]; } & import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>>;
+        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, Chain | undefined, import("viem").Account | undefined>, "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, import("viem").WalletRpcSchema, import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>>) => client) => import("viem").Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, import("viem").WalletRpcSchema, { [K in keyof client]: client[K]; } & import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>>;
     };
 };
 /**
@@ -13289,7 +13289,7 @@ export declare function useExternalWalletClient(): {
             transport?: undefined;
             type?: undefined;
             uid?: undefined;
-        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account>, "prepareTransactionRequest" | "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain, import("viem").Account>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account, import("viem").WalletRpcSchema, import("viem").WalletActions<Chain, import("viem").Account>>) => client) => import("viem").Client<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account, import("viem").WalletRpcSchema, { [K in keyof client]: client[K]; } & import("viem").WalletActions<Chain, import("viem").Account>>;
+        } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account>, "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain, import("viem").Account>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account, import("viem").WalletRpcSchema, import("viem").WalletActions<Chain, import("viem").Account>>) => client) => import("viem").Client<import("wagmi").Transport<string, Record<string, any>, import("viem").EIP1193RequestFn>, Chain, import("viem").Account, import("viem").WalletRpcSchema, { [K in keyof client]: client[K]; } & import("viem").WalletActions<Chain, import("viem").Account>>;
     } | null;
     isConnected: boolean;
     isPending: boolean;

package/dist/src/hooks.js

@@ -504,7 +504,7 @@ export function useExternalWalletChain() {
  * ```
  */
 export function useExternalWalletInfo() {
-    const { externalWalletChainId, externalWalletNetwork, isExternalWalletConnected, externalWalletAddress, externalWalletBalance, } = useExternalWallet();
+    const { externalWalletChainId, externalWalletNetwork, switchExternalWalletChain, isExternalWalletConnected, externalWalletAddress, externalWalletBalance, } = useExternalWallet();
     const { sendTransaction, signMessage, signTransaction, switchChain, } = useAbstraxnWallet();
     const [formattedBalance, setFormattedBalance] = useState('0');
     useEffect(() => {
@@ -571,8 +571,8 @@ export function useExternalWalletInfo() {
         // Balance information
         balance: externalWalletBalance, // BigInt in wei
         formattedBalance, // String formatted as ETH (e.g., "0.123456")
-        // Unified chain switch (embedded + external); not only switchExternalWalletChain.
-        switchChain,
+        // Chain switching
+        switchChain: switchExternalWalletChain,
         // Connection status
         isConnected: isExternalWalletConnected,
         address: externalWalletAddress,

package/dist/src/wagmiConfig.d.ts

@@ -9,13 +9,7 @@ import { type Chain as CoreChain } from "@abstraxn/signer-core";
  * Note: Uses 'injected' connector which automatically detects MetaMask and other wallets
  * without requiring @metamask/sdk
  */
-export declare function createWagmiConfig(chains?: CoreChain[] | Chain[], walletConnectProjectId?: string, enabledConnectors?: ("injected" | "metaMask" | "walletConnect")[], theme?: "light" | "dark", ssr?: boolean, 
-/**
- * When true, builds a wagmi config with **no** wallet connectors. Used when
- * `externalWallets.enabled` is false so hooks like `useConfig` / `useAccount`
- * still work for embedded flows without exposing MetaMask / WalletConnect.
- */
-embedOnly?: boolean): Config;
+export declare function createWagmiConfig(chains?: CoreChain[] | Chain[], walletConnectProjectId?: string, enabledConnectors?: ("injected" | "metaMask" | "walletConnect")[], theme?: "light" | "dark", ssr?: boolean): Config;
 /**
  * External wallet connector types
  */

package/dist/src/wagmiConfig.js

@@ -35,13 +35,7 @@ function convertToViemChain(chain) {
  * Note: Uses 'injected' connector which automatically detects MetaMask and other wallets
  * without requiring @metamask/sdk
  */
-export function createWagmiConfig(chains, walletConnectProjectId, enabledConnectors, theme, ssr, 
-/**
- * When true, builds a wagmi config with **no** wallet connectors. Used when
- * `externalWallets.enabled` is false so hooks like `useConfig` / `useAccount`
- * still work for embedded flows without exposing MetaMask / WalletConnect.
- */
-embedOnly) {
+export function createWagmiConfig(chains, walletConnectProjectId, enabledConnectors, theme, ssr) {
     // Normalize chains to ensure they are all valid viem Chain objects
     // This handles mixed arrays of viem Chains and CoreChains (e.g. custom chains)
     const viemChains = chains && chains.length > 0
@@ -54,28 +48,6 @@ embedOnly) {
             return convertToViemChain(chain);
         })
         : SUPPORTED_CHAINS.map(convertToViemChain);
-    // Ensure we have at least one chain (shared by embed + full config)
-    if (viemChains.length === 0) {
-        throw new Error("At least one chain is required");
-    }
-    const transports = viemChains.reduce((acc, chain) => {
-        acc[chain.id] = http();
-        return acc;
-    }, {});
-    const storage = ssr
-        ? createStorage({ storage: cookieStorage })
-        : typeof window !== "undefined"
-            ? createStorage({ storage: window.localStorage })
-            : undefined;
-    if (embedOnly) {
-        return createConfig({
-            chains: viemChains,
-            connectors: [],
-            transports,
-            storage,
-            ssr: !!ssr,
-        });
-    }
     const connectors = [];
     // Add connectors based on enabled list
     // Note: 'injected' connector will automatically detect MetaMask and other injected wallets
@@ -123,11 +95,23 @@ embedOnly) {
             }));
         }
     }
+    // Ensure we have at least one chain
+    if (viemChains.length === 0) {
+        throw new Error("At least one chain is required");
+    }
     return createConfig({
         chains: viemChains,
         connectors,
-        transports,
-        storage,
+        transports: viemChains.reduce((acc, chain) => {
+            acc[chain.id] = http();
+            return acc;
+        }, {}),
+        // Configure storage based on SSR setting
+        storage: ssr
+            ? createStorage({ storage: cookieStorage })
+            : typeof window !== "undefined"
+                ? createStorage({ storage: window.localStorage })
+                : undefined,
         ssr: !!ssr,
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstraxn/signer-react",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "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",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@abstraxn/signer-core": "^2.1.1",
+    "@abstraxn/signer-core": "2.1.2",
     "@solana/wallet-adapter-base": "^0.9.27",
     "@solana/wallet-adapter-react": "^0.15.39",
     "@solana/wallet-adapter-react-ui": "^0.9.39",