@abstraxn/signer-react 3.1.2 → 3.1.3

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.1.3] - 2026-03-31
+
+### 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.
+
+### Fixed
+
+- **`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.
+
 ## [3.1.2] - 2026-03-27
 
 ### Changed

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

@@ -168,38 +168,67 @@ export function AbstraxnProvider({ config, children }) {
         externalSsr,
         config.wagmiConfig,
     ]);
-    // 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
+    // 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) {
         const queryCheck = canUseReactQuery();
         if (!queryCheck.canUse) {
-            console.error("❌ External wallets are disabled because React Query is not available.\n" +
+            console.error("❌ Wagmi hooks require @tanstack/react-query. Install it or wrap your app with QueryClientProvider.\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.");
+                "Rendering without WagmiProvider; calls to useConfig may throw.");
             return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));
         }
-        if (configError) {
-            console.error("Failed to create wagmi config:", configError);
-            // Fallback to provider without wagmi if config creation fails
+        if (embedConfigError || !embedWagmiConfig) {
+            if (embedConfigError) {
+                console.error("Failed to create embed-only wagmi config:", embedConfigError);
+            }
             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 wallet connectors..." }) }));
+            return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx("div", { style: { display: "none" }, children: "Hydrating..." }) }));
         }
-        // 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(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..." }) }));
     }
-    // If external wallets are disabled, use the provider without wagmi
-    return (_jsx(AbstraxnProviderWithoutWagmi, { 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 }) }) }) }) }));
 }
 //# sourceMappingURL=AbstraxnProvider.js.map

package/dist/src/hooks.d.ts

@@ -270,6 +270,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             request?: (parameters: import("viem").CcipRequestParameters) => Promise<import("viem/_types/utils/ccip").CcipRequestReturnType>;
         } | undefined;
         chain: Chain | undefined;
+        dataSuffix?: import("viem").DataSuffix | undefined;
         experimental_blockTag?: import("viem").BlockTag | undefined;
         key: string;
         name: string;
@@ -321,7 +322,6 @@ 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,6 +333,7 @@ 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;
@@ -346,7 +347,6 @@ 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,6 +358,7 @@ 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;
@@ -371,7 +372,6 @@ 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,6 +383,7 @@ 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;
@@ -396,7 +397,6 @@ 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,6 +408,7 @@ 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[];
@@ -421,7 +422,6 @@ 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,6 +433,7 @@ 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;
@@ -452,6 +453,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
         getChainId: () => Promise<import("viem").GetChainIdReturnType>;
         getCode: (args: import("viem").GetBytecodeParameters) => Promise<import("viem").GetBytecodeReturnType>;
         getContractEvents: <const abi extends Abi | readonly unknown[], eventName extends import("viem").ContractEventName<abi> | undefined = undefined, strict extends boolean | undefined = undefined, fromBlock extends import("viem").BlockNumber | import("viem").BlockTag | undefined = undefined, toBlock extends import("viem").BlockNumber | import("viem").BlockTag | undefined = undefined>(args: import("viem").GetContractEventsParameters<abi, eventName, strict, fromBlock, toBlock>) => Promise<import("viem").GetContractEventsReturnType<abi, eventName, strict, fromBlock, toBlock>>;
+        getDelegation: (args: import("viem").GetDelegationParameters) => Promise<import("viem").GetDelegationReturnType>;
         getEip712Domain: (args: import("viem").GetEip712DomainParameters) => Promise<import("viem").GetEip712DomainReturnType>;
         getEnsAddress: (args: import("viem").GetEnsAddressParameters) => Promise<import("viem").GetEnsAddressReturnType>;
         getEnsAvatar: (args: import("viem").GetEnsAvatarParameters) => Promise<import("viem").GetEnsAvatarReturnType>;
@@ -471,7 +473,6 @@ 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;
@@ -483,6 +484,7 @@ 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;
@@ -496,7 +498,6 @@ 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;
@@ -508,6 +509,7 @@ 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;
@@ -521,7 +523,6 @@ 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;
@@ -533,6 +534,7 @@ 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;
@@ -546,7 +548,6 @@ 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;
@@ -558,6 +559,7 @@ 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[];
@@ -571,7 +573,6 @@ 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;
@@ -583,6 +584,7 @@ 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;
@@ -3877,6 +3879,7 @@ export declare function usePublicClient(chain: Chain, rpcUrl: string): {
             cacheTime?: undefined;
             ccipRead?: undefined;
             chain?: undefined;
+            dataSuffix?: undefined;
             experimental_blockTag?: undefined;
             key?: undefined;
             name?: undefined;
@@ -3885,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>, "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>>;
+        } & 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>>;
     };
 };
 /**
@@ -3926,6 +3929,7 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             request?: (parameters: import("viem").CcipRequestParameters) => Promise<import("viem/_types/utils/ccip").CcipRequestReturnType>;
         } | undefined;
         chain: Chain | undefined;
+        dataSuffix?: import("viem").DataSuffix | undefined;
         experimental_blockTag?: import("viem").BlockTag | undefined;
         key: string;
         name: string;
@@ -8337,6 +8341,7 @@ export declare function useWalletClient(chain: any, rpcUrl?: string): {
             cacheTime?: undefined;
             ccipRead?: undefined;
             chain?: undefined;
+            dataSuffix?: undefined;
             experimental_blockTag?: undefined;
             key?: undefined;
             name?: undefined;
@@ -8345,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>, "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>>;
+        } & 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>>;
     };
 };
 /**
@@ -8863,6 +8868,7 @@ export declare function useExternalWalletClient(): {
             request?: (parameters: import("viem").CcipRequestParameters) => Promise<import("viem/_types/utils/ccip").CcipRequestReturnType>;
         } | undefined;
         chain: Chain;
+        dataSuffix?: import("viem").DataSuffix | undefined;
         experimental_blockTag?: import("viem").BlockTag | undefined;
         key: string;
         name: string;
@@ -13274,6 +13280,7 @@ export declare function useExternalWalletClient(): {
             cacheTime?: undefined;
             ccipRead?: undefined;
             chain?: undefined;
+            dataSuffix?: undefined;
             experimental_blockTag?: undefined;
             key?: undefined;
             name?: undefined;
@@ -13282,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>, "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>>;
+        } & 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>>;
     } | null;
     isConnected: boolean;
     isPending: boolean;

package/dist/src/hooks.js

@@ -504,7 +504,7 @@ export function useExternalWalletChain() {
  * ```
  */
 export function useExternalWalletInfo() {
-    const { externalWalletChainId, externalWalletNetwork, switchExternalWalletChain, isExternalWalletConnected, externalWalletAddress, externalWalletBalance, } = useExternalWallet();
+    const { externalWalletChainId, externalWalletNetwork, 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")
-        // Chain switching
-        switchChain: switchExternalWalletChain,
+        // Unified chain switch (embedded + external); not only switchExternalWalletChain.
+        switchChain,
         // Connection status
         isConnected: isExternalWalletConnected,
         address: externalWalletAddress,

package/dist/src/wagmiConfig.d.ts

@@ -9,7 +9,13 @@ 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): Config;
+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;
 /**
  * External wallet connector types
  */

package/dist/src/wagmiConfig.js

@@ -35,7 +35,13 @@ 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) {
+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) {
     // 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
@@ -48,6 +54,28 @@ export function createWagmiConfig(chains, walletConnectProjectId, enabledConnect
             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
@@ -95,23 +123,11 @@ export function createWagmiConfig(chains, walletConnectProjectId, enabledConnect
             }));
         }
     }
-    // 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: 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,
+        transports,
+        storage,
         ssr: !!ssr,
     });
 }

package/package.json

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