@b3dotfun/sdk 0.1.69 → 0.1.70-alpha.10

package/dist/esm/global-account/react/components/Toast/ToastContext.d.ts

@@ -11,6 +11,9 @@ interface ToastContextType {
     addToast: (type: ToastType, message: string, duration?: number) => string;
     removeToast: (id: string) => void;
     clearAll: () => void;
+    headerMode: boolean;
+    setHeaderMode: (enabled: boolean) => void;
+    latestToast: ToastItem | null;
 }
 export declare function ToastProvider({ children }: {
     children: React.ReactNode;

package/dist/esm/global-account/react/components/Toast/ToastContext.js

@@ -4,6 +4,9 @@ const ToastContext = createContext(undefined);
 let globalToastCounter = 0;
 export function ToastProvider({ children }) {
     const [toasts, setToasts] = useState([]);
+    const [headerMode, setHeaderMode] = useState(false);
+    const headerModeRef = useRef(false);
+    const [latestToast, setLatestToast] = useState(null);
     const timeoutsRef = useRef(new Map());
     const removeToast = useCallback((id) => {
         setToasts(prev => prev.filter(toast => toast.id !== id));
@@ -22,12 +25,23 @@ export function ToastProvider({ children }) {
             duration,
             createdAt: Date.now(),
         };
-        setToasts(prev => [...prev, newToast]);
-        if (duration > 0) {
-            const timeout = setTimeout(() => {
-                removeToast(id);
-            }, duration);
-            timeoutsRef.current.set(id, timeout);
+        if (headerModeRef.current) {
+            setLatestToast(newToast);
+            if (duration > 0) {
+                const timeout = setTimeout(() => {
+                    setLatestToast(null);
+                }, duration);
+                timeoutsRef.current.set(id, timeout);
+            }
+        }
+        else {
+            setToasts(prev => [...prev, newToast]);
+            if (duration > 0) {
+                const timeout = setTimeout(() => {
+                    removeToast(id);
+                }, duration);
+                timeoutsRef.current.set(id, timeout);
+            }
         }
         return id;
     }, [removeToast]);
@@ -36,6 +50,15 @@ export function ToastProvider({ children }) {
         timeoutsRef.current.clear();
         setToasts([]);
     }, []);
+    const setHeaderModeCallback = useCallback((enabled) => {
+        setHeaderMode(enabled);
+        headerModeRef.current = enabled;
+        if (!enabled) {
+            setLatestToast(null);
+            timeoutsRef.current.forEach(timeout => clearTimeout(timeout));
+            timeoutsRef.current.clear();
+        }
+    }, []);
     // Cleanup on unmount
     useEffect(() => {
         const timeouts = timeoutsRef.current;
@@ -44,7 +67,7 @@ export function ToastProvider({ children }) {
             timeouts.clear();
         };
     }, []);
-    return _jsx(ToastContext.Provider, { value: { toasts, addToast, removeToast, clearAll }, children: children });
+    return (_jsx(ToastContext.Provider, { value: { toasts, addToast, removeToast, clearAll, headerMode, setHeaderMode: setHeaderModeCallback, latestToast }, children: children }));
 }
 export function useToastContext() {
     const context = useContext(ToastContext);

package/dist/esm/global-account/react/components/UserAvatar/UserAvatar.d.ts

@@ -0,0 +1,18 @@
+interface UserAvatarProps {
+    /** Direct avatar URL (IPFS or HTTP). Resolved and validated internally. */
+    avatarUrl?: string | null;
+    /** Seed for the generated fallback avatar + alt text. Use email, username, or address. */
+    name?: string;
+    /** Avatar size in pixels (square). */
+    size?: number;
+    /** Additional className for the outer container. */
+    className?: string;
+}
+/**
+ * Renders a user avatar with IPFS support and boring-avatars fallback.
+ *
+ * - If `avatarUrl` is provided and valid, renders via IPFSMediaRenderer.
+ * - On load failure or missing URL, falls back to a deterministic boring-avatars beam.
+ */
+export declare function UserAvatar({ avatarUrl, name, size, className }: UserAvatarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/esm/global-account/react/components/UserAvatar/UserAvatar.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { validateImageUrl } from "../../../../global-account/react/utils/profileDisplay.js";
+import { AVATAR_COLORS } from "../../../../shared/constants/index.js";
+import Avatar from "boring-avatars";
+import { useCallback, useEffect, useState } from "react";
+import { IPFSMediaRenderer } from "../IPFSMediaRenderer/IPFSMediaRenderer.js";
+/**
+ * Renders a user avatar with IPFS support and boring-avatars fallback.
+ *
+ * - If `avatarUrl` is provided and valid, renders via IPFSMediaRenderer.
+ * - On load failure or missing URL, falls back to a deterministic boring-avatars beam.
+ */
+export function UserAvatar({ avatarUrl, name = "user", size = 40, className }) {
+    const resolvedSrc = validateImageUrl(avatarUrl);
+    const [imgError, setImgError] = useState(false);
+    useEffect(() => {
+        setImgError(false);
+    }, [avatarUrl]);
+    const handleImgError = useCallback(() => setImgError(true), []);
+    return (_jsx("div", { className: className, style: { width: size, height: size, minWidth: size, minHeight: size }, children: resolvedSrc && !imgError ? (_jsx("div", { onErrorCapture: handleImgError, className: "h-full w-full overflow-hidden rounded-full", children: _jsx(IPFSMediaRenderer, { src: resolvedSrc, alt: name, className: "h-full w-full object-cover" }) })) : (_jsx(Avatar, { name: name, variant: "beam", size: size, colors: AVATAR_COLORS })) }));
+}

package/dist/esm/global-account/react/components/custom/Button.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "b3" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "b3" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {

package/dist/esm/global-account/react/components/index.d.ts

@@ -1,19 +1,23 @@
 export { B3DynamicModal } from "./B3DynamicModal";
 export { B3Provider } from "./B3Provider/B3Provider";
+export type { AuthStrategy } from "./B3Provider/B3ConfigProvider";
 export { RelayKitProviderWrapper } from "./B3Provider/RelayKitProviderWrapper";
 export { useB3 } from "./B3Provider/useB3";
 export { useB3Account } from "./B3Provider/useB3Account";
 export { useB3Config } from "./B3Provider/useB3Config";
 export { StyleRoot } from "./StyleRoot";
+export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
+export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";
+export { BetterAuthVerifyEmail, type BetterAuthVerifyEmailProps, type BetterAuthVerifyEmailState, } from "./SignInWithB3/BetterAuthVerifyEmail";
 export { AuthButton } from "./SignInWithB3/components/AuthButton";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem";
 export { WalletRow } from "./SignInWithB3/components/WalletRow";
 export { SignInWithB3 } from "./SignInWithB3/SignInWithB3";
 export { SignInWithB3Flow } from "./SignInWithB3/SignInWithB3Flow";
-export { SignInWithB3Privy } from "./SignInWithB3/SignInWithB3Privy";
 export { LoginStepContainer } from "./SignInWithB3/steps/LoginStep";
 export { getConnectOptionsFromStrategy, isWalletType, type AllowedStrategy } from "./SignInWithB3/utils/signInUtils";
 export { ManageAccount } from "./ManageAccount/ManageAccount";
+export { UserAvatar } from "./UserAvatar/UserAvatar";
 export { Deposit } from "./Deposit/Deposit";
 export { Send } from "./Send/Send";
 export { IPFSMediaRenderer } from "./IPFSMediaRenderer/IPFSMediaRenderer";

package/dist/esm/global-account/react/components/index.js

@@ -8,16 +8,20 @@ export { useB3Account } from "./B3Provider/useB3Account.js";
 export { useB3Config } from "./B3Provider/useB3Config.js";
 export { StyleRoot } from "./StyleRoot.js";
 // SignInWithB3 Components
+export { BetterAuthResetPassword } from "./SignInWithB3/BetterAuthResetPassword.js";
+export { BetterAuthSignIn } from "./SignInWithB3/BetterAuthSignIn.js";
+export { BetterAuthVerifyEmail, } from "./SignInWithB3/BetterAuthVerifyEmail.js";
 export { AuthButton } from "./SignInWithB3/components/AuthButton.js";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem.js";
 export { WalletRow } from "./SignInWithB3/components/WalletRow.js";
 export { SignInWithB3 } from "./SignInWithB3/SignInWithB3.js";
 export { SignInWithB3Flow } from "./SignInWithB3/SignInWithB3Flow.js";
-export { SignInWithB3Privy } from "./SignInWithB3/SignInWithB3Privy.js";
 export { LoginStepContainer } from "./SignInWithB3/steps/LoginStep.js";
 export { getConnectOptionsFromStrategy, isWalletType } from "./SignInWithB3/utils/signInUtils.js";
 // ManageAccount Components
 export { ManageAccount } from "./ManageAccount/ManageAccount.js";
+// UserAvatar
+export { UserAvatar } from "./UserAvatar/UserAvatar.js";
 // Deposit Components
 export { Deposit } from "./Deposit/Deposit.js";
 // Send Components

package/dist/esm/global-account/react/components/ui/button.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from "class-variance-authority";
 import * as React from "react";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/dist/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

package/dist/esm/global-account/react/hooks/index.d.ts

@@ -5,6 +5,7 @@ export { useAddTWSessionKey } from "./useAddTWSessionKey";
 export { useAnalytics } from "./useAnalytics";
 export { useAuth } from "./useAuth";
 export { useAuthentication } from "./useAuthentication";
+export { useBetterAuth, EmailVerificationRequiredError } from "./useBetterAuth";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses";
 export { useB3EnsName } from "./useB3EnsName";
 export { useChainSwitchWithAction } from "./useChainSwitchWithAction";
@@ -16,7 +17,6 @@ export { useFirstEOA } from "./useFirstEOA";
 export { useGetAllTWSigners, type TWSignerWithMetadata } from "./useGetAllTWSigners";
 export { useGetGeo } from "./useGetGeo";
 export { useGlobalAccount } from "./useGlobalAccount";
-export { useHandleConnectWithPrivy } from "./useHandleConnectWithPrivy";
 export { useHasMounted } from "./useHasMounted";
 export { useIsMobile } from "./useIsMobile";
 export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect";

package/dist/esm/global-account/react/hooks/index.js

@@ -5,6 +5,7 @@ export { useAddTWSessionKey } from "./useAddTWSessionKey.js";
 export { useAnalytics } from "./useAnalytics.js";
 export { useAuth } from "./useAuth.js";
 export { useAuthentication } from "./useAuthentication.js";
+export { useBetterAuth, EmailVerificationRequiredError } from "./useBetterAuth.js";
 export { useB3BalanceFromAddresses } from "./useB3BalanceFromAddresses.js";
 export { useB3EnsName } from "./useB3EnsName.js";
 export { useChainSwitchWithAction } from "./useChainSwitchWithAction.js";
@@ -16,7 +17,6 @@ export { useFirstEOA } from "./useFirstEOA.js";
 export { useGetAllTWSigners } from "./useGetAllTWSigners.js";
 export { useGetGeo } from "./useGetGeo.js";
 export { useGlobalAccount } from "./useGlobalAccount.js";
-export { useHandleConnectWithPrivy } from "./useHandleConnectWithPrivy.js";
 export { useHasMounted } from "./useHasMounted.js";
 export { useIsMobile } from "./useIsMobile.js";
 export { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";

package/dist/esm/global-account/react/hooks/useAuth.d.ts

@@ -6,8 +6,8 @@ import { preAuthenticate } from "thirdweb/wallets/in-app";
  * This hook provides 1:1 feature parity with useAuthentication.ts
  */
 export declare function useAuth(): {
-    authenticate: (accessToken: string, partnerId: string, strategy?: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
-    reAuthenticate: () => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    authenticate: (accessToken: string, partnerId: string, strategy?: string) => Promise<Record<string, any>>;
+    reAuthenticate: () => Promise<Record<string, any>>;
     logout: (callback?: () => void) => Promise<void>;
     isAuthenticated: boolean;
     isReady: boolean;
@@ -70,6 +70,6 @@ export declare function useAuth(): {
             turnkeyOtpId?: string | undefined;
         };
     } | undefined;
-    refetchUser: () => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    refetchUser: () => Promise<Record<string, any>>;
     setUser: (newUser?: import("@b3dotfun/b3-api").Users) => void;
 };

package/dist/esm/global-account/react/hooks/useAuth.js

@@ -5,13 +5,13 @@ import { ecosystemWalletId } from "../../../shared/constants/index.js";
 import { debugB3React } from "../../../shared/utils/debug.js";
 import { client } from "../../../shared/utils/thirdweb.js";
 import { getConnectors } from "@wagmi/core";
-import { useCallback, useContext, useEffect, useRef } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef } from "react";
 import { useActiveWallet, useAutoConnect, useConnectedWallets, useDisconnect, useSetActiveWallet, } from "thirdweb/react";
 import { ecosystemWallet } from "thirdweb/wallets";
 import { preAuthenticate } from "thirdweb/wallets/in-app";
 import { useAccount, useConnect, useSwitchAccount } from "wagmi";
 import { LocalSDKContext } from "../components/B3Provider/LocalSDKProvider.js";
-import { getCachedWagmiConfig } from "../utils/createWagmiConfig.js";
+import { createWagmiConfig } from "../utils/createWagmiConfig.js";
 import { useSearchParam } from "./useSearchParamsSSR.js";
 import { useUserQuery } from "./useUserQuery.js";
 const debug = debugB3React("useAuth");
@@ -21,7 +21,7 @@ const debug = debugB3React("useAuth");
  * This hook provides 1:1 feature parity with useAuthentication.ts
  */
 export function useAuth() {
-    const { onConnectCallback } = useContext(LocalSDKContext);
+    const { onConnectCallback, disableBSMNTAuthentication } = useContext(LocalSDKContext);
     const { disconnect } = useDisconnect();
     const wallets = useConnectedWallets();
     const activeWallet = useActiveWallet();
@@ -38,7 +38,7 @@ export function useAuth() {
     const useAutoConnectLoadingPrevious = useRef(false);
     const referralCode = useSearchParam("referralCode");
     const { partnerId } = useB3Config();
-    const wagmiConfig = getCachedWagmiConfig({ partnerId });
+    const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId }), [partnerId]);
     const { connect } = useConnect();
     const activeWagmiAccount = useAccount();
     const { switchAccount } = useSwitchAccount();
@@ -63,8 +63,10 @@ export function useAuth() {
             }
             // Authenticate with BSMNT
             try {
-                const b3Jwt = await authenticateWithB3JWT(response.accessToken);
-                debug("BSMNT re-authentication successful", b3Jwt);
+                if (!disableBSMNTAuthentication) {
+                    const b3Jwt = await authenticateWithB3JWT(response.accessToken);
+                    debug("BSMNT re-authentication successful", b3Jwt);
+                }
             }
             catch (bsmntError) {
                 // BSMNT authentication failure shouldn't block the main auth flow
@@ -76,7 +78,7 @@ export function useAuth() {
             debug("Re-authentication failed", err);
             throw err;
         }
-    }, [setUser]);
+    }, [setUser, disableBSMNTAuthentication]);
     const syncWagmi = useCallback(async () => {
         function syncWagmiFunc() {
             const connectors = getConnectors(wagmiConfig);
@@ -120,9 +122,7 @@ export function useAuth() {
             });
         }
         syncWagmiFunc();
-        // wagmi config shouldn't change
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [partnerId, wallets]);
+    }, [wagmiConfig, wallets, connect, switchAccount]);
     useEffect(() => {
         syncWagmi();
     }, [wallets, syncWagmi]);
@@ -139,9 +139,11 @@ export function useAuth() {
             setIsAuthenticated(true);
             setIsAuthenticating(false);
             debug("Re-authenticated successfully", { userAuth });
-            // Authenticate on BSMNT with B3 JWT
-            const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-            debug("@@b3Jwt", b3Jwt);
+            if (!disableBSMNTAuthentication) {
+                // Authenticate on BSMNT with B3 JWT
+                const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+                debug("@@b3Jwt", b3Jwt);
+            }
             return userAuth;
         }
         catch (error) {
@@ -151,7 +153,14 @@ export function useAuth() {
             setIsAuthenticating(false);
             throw new Error("Authentication required. Please authenticate.");
         }
-    }, [reAuthenticate, setIsAuthenticated, setIsAuthenticating, setUser, setHasStartedConnecting]);
+    }, [
+        reAuthenticate,
+        setIsAuthenticated,
+        setIsAuthenticating,
+        setUser,
+        setHasStartedConnecting,
+        disableBSMNTAuthentication,
+    ]);
     /**
      * Authenticate with B3
      *
@@ -181,8 +190,10 @@ export function useAuth() {
             }
             // Step 3: Authenticate with BSMNT for basement integration
             try {
-                const b3Jwt = await authenticateWithB3JWT(response.accessToken);
-                debug("BSMNT authentication successful", b3Jwt);
+                if (!disableBSMNTAuthentication) {
+                    const b3Jwt = await authenticateWithB3JWT(response.accessToken);
+                    debug("BSMNT authentication successful", b3Jwt);
+                }
             }
             catch (bsmntError) {
                 // BSMNT authentication failure shouldn't block the main auth flow
@@ -194,7 +205,7 @@ export function useAuth() {
             debug("Authentication failed", err);
             throw err;
         }
-    }, [referralCode, setUser]);
+    }, [referralCode, setUser, disableBSMNTAuthentication]);
     /**
      * Handle wallet connection
      */

package/dist/esm/global-account/react/hooks/useAuthentication.d.ts

@@ -65,6 +65,6 @@ export declare function useAuthentication(partnerId: string, { skipAutoConnect }
             turnkeyOtpId?: string | undefined;
         };
     } | undefined;
-    refetchUser: (wallet?: Wallet) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    refetchUser: (wallet?: Wallet) => Promise<Record<string, any>>;
     setUser: (newUser?: import("@b3dotfun/b3-api").Users) => void;
 };

package/dist/esm/global-account/react/hooks/useAuthentication.js

@@ -5,7 +5,7 @@ import { ecosystemWalletId } from "../../../shared/constants/index.js";
 import { debugB3React } from "../../../shared/utils/debug.js";
 import { client } from "../../../shared/utils/thirdweb.js";
 import { getConnectors } from "@wagmi/core";
-import { useCallback, useContext, useEffect, useRef } from "react";
+import { useCallback, useContext, useEffect, useMemo, useRef } from "react";
 import { useActiveWallet, useAutoConnect, useConnectedWallets, useDisconnect, useSetActiveWallet, } from "thirdweb/react";
 import { ecosystemWallet } from "thirdweb/wallets";
 import { preAuthenticate } from "thirdweb/wallets/in-app";
@@ -16,7 +16,7 @@ import { useTWAuth } from "./useTWAuth.js";
 import { useUserQuery } from "./useUserQuery.js";
 const debug = debugB3React("useAuthentication");
 export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
-    const { onConnectCallback, onLogoutCallback } = useContext(LocalSDKContext);
+    const { onConnectCallback, onLogoutCallback, disableBSMNTAuthentication } = useContext(LocalSDKContext);
     const { disconnect } = useDisconnect();
     const wallets = useConnectedWallets();
     // Keep refs so logout() always disconnects current wallets, not stale closure values.
@@ -48,7 +48,7 @@ export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
     const { authenticate } = useTWAuth();
     const { user, setUser } = useUserQuery();
     const useAutoConnectLoadingPrevious = useRef(false);
-    const wagmiConfig = createWagmiConfig({ partnerId });
+    const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId }), [partnerId]);
     const { connect } = useConnect();
     const activeWagmiAccount = useAccount();
     const { switchAccount } = useSwitchAccount();
@@ -99,9 +99,7 @@ export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
             });
         }
         syncWagmiFunc();
-        // wagmi config shouldn't change
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [partnerId, wallets]);
+    }, [wagmiConfig, wallets, connect, switchAccount]);
     useEffect(() => {
         syncWagmi();
     }, [wallets, syncWagmi]);
@@ -121,9 +119,11 @@ export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
             setIsAuthenticated(true);
             setIsAuthenticating(false);
             debug("Re-authenticated successfully", { userAuth });
-            // Authenticate on BSMNT with B3 JWT
-            const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-            debug("@@b3Jwt", b3Jwt);
+            if (!disableBSMNTAuthentication) {
+                // Authenticate on BSMNT with B3 JWT
+                const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+                debug("@@b3Jwt", b3Jwt);
+            }
             return userAuth;
         }
         catch (error) {
@@ -134,12 +134,23 @@ export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
             setIsAuthenticated(true);
             setIsAuthenticating(false);
             debug("Fresh authentication successful", { userAuth });
-            // Authenticate on BSMNT with B3 JWT
-            const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
-            debug("@@b3Jwt", b3Jwt);
+            if (!disableBSMNTAuthentication) {
+                // Authenticate on BSMNT with B3 JWT
+                const b3Jwt = await authenticateWithB3JWT(userAuth.accessToken);
+                debug("@@b3Jwt", b3Jwt);
+            }
             return userAuth;
         }
-    }, [activeWallet, partnerId, authenticate, setIsAuthenticated, setIsAuthenticating, setUser, setHasStartedConnecting]);
+    }, [
+        activeWallet,
+        partnerId,
+        authenticate,
+        setIsAuthenticated,
+        setIsAuthenticating,
+        setUser,
+        setHasStartedConnecting,
+        disableBSMNTAuthentication,
+    ]);
     const logout = useCallback(async (callback) => {
         // Disconnect ecosystem/smart wallets from the connected wallets list.
         // EOA wallets (MetaMask, Coinbase Wallet) are left in the list so they can
@@ -175,7 +186,7 @@ export function useAuthentication(partnerId, { skipAutoConnect = false } = {}) {
             localStorage.removeItem("lastAuthProvider");
             localStorage.removeItem("b3-user");
         }
-        app.logout();
+        await app.logout();
         debug("@@logout:loggedOut");
         setIsAuthenticated(false);
         setIsConnected(false);

package/dist/esm/global-account/react/hooks/useAutoSelectWallet.d.ts

@@ -1,7 +1,10 @@
+import { EIP1193 } from "thirdweb/wallets";
 /**
- * Hook to automatically select the first EOA wallet when user is authenticated
- * Only auto-selects if the last auth was via wallet or no previous auth provider
+ * Hook to automatically connect a default EOA provider (if given) and
+ * select the first EOA wallet when user is authenticated.
+ * Only auto-selects if the last auth was via wallet or no previous auth provider.
  */
-export declare function useAutoSelectWallet({ enabled }: {
+export declare function useAutoSelectWallet({ enabled, defaultEoaProvider, }: {
     enabled: boolean;
+    defaultEoaProvider?: EIP1193.EIP1193Provider;
 }): void;

package/dist/esm/global-account/react/hooks/useAutoSelectWallet.js

@@ -1,16 +1,44 @@
+import { client } from "../../../shared/utils/thirdweb.js";
 import { debugB3React } from "../../../shared/utils/debug.js";
-import { useCallback, useEffect } from "react";
-import { getLastAuthProvider, useConnectedWallets, useSetActiveWallet } from "thirdweb/react";
+import { useCallback, useEffect, useRef } from "react";
+import { getLastAuthProvider, useAddConnectedWallet, useConnectedWallets, useSetActiveWallet } from "thirdweb/react";
+import { EIP1193 } from "thirdweb/wallets";
 import { useAuthStore } from "../stores/index.js";
 const debug = debugB3React("useAutoSelectWallet");
 /**
- * Hook to automatically select the first EOA wallet when user is authenticated
- * Only auto-selects if the last auth was via wallet or no previous auth provider
+ * Hook to automatically connect a default EOA provider (if given) and
+ * select the first EOA wallet when user is authenticated.
+ * Only auto-selects if the last auth was via wallet or no previous auth provider.
  */
-export function useAutoSelectWallet({ enabled }) {
+export function useAutoSelectWallet({ enabled, defaultEoaProvider, }) {
     const isAuthenticated = useAuthStore(state => state.isAuthenticated);
     const wallets = useConnectedWallets();
     const setActiveWallet = useSetActiveWallet();
+    const addConnectedWallet = useAddConnectedWallet();
+    const hasConnectedProvider = useRef(false);
+    // Auto-connect the default EOA provider (e.g. Farcaster frame wallet) on mount.
+    // Uses useAddConnectedWallet instead of useConnect so the wallet is added to
+    // connectedWallets WITHOUT becoming the active wallet. This prevents
+    // useAuthentication's logout/onTimeout from disconnecting it (logout only
+    // disconnects ecosystem wallets and the active wallet).
+    useEffect(() => {
+        if (!defaultEoaProvider || hasConnectedProvider.current)
+            return;
+        hasConnectedProvider.current = true;
+        const connectDefaultProvider = async () => {
+            try {
+                const wallet = EIP1193.fromProvider({ provider: defaultEoaProvider });
+                await wallet.connect({ client });
+                addConnectedWallet(wallet);
+                debug("Auto-connected default EOA provider", wallet.id);
+            }
+            catch (error) {
+                debug("Failed to auto-connect default EOA provider", error);
+                hasConnectedProvider.current = false;
+            }
+        };
+        connectDefaultProvider();
+    }, [defaultEoaProvider, addConnectedWallet]);
     const setWallet = useCallback((wallet) => {
         debug("@@setWallet", wallet.id, wallet.getAccount()?.address);
         setActiveWallet(wallet);