@b3dotfun/sdk 0.1.69 → 0.1.70-alpha.1

package/dist/esm/global-account/better-auth-client.js

@@ -0,0 +1,13 @@
+import { createAuthClient } from "better-auth/client";
+import { B3_API_URL } from "../app.shared.js";
+export function createB3BetterAuthClient(baseURL = B3_API_URL) {
+    return createAuthClient({
+        baseURL,
+        basePath: "/auth",
+        fetchOptions: {
+            credentials: "include",
+        },
+    });
+}
+// Default singleton for standard usage
+export const betterAuthClient = createB3BetterAuthClient();

package/dist/esm/global-account/bsmnt.d.ts

@@ -1,6 +1,5 @@
 declare const app: import("@b3dotfun/basement-api").ClientApplication;
 export declare const authenticate: (accessToken: string, identityToken: string, params?: Record<string, any>) => Promise<import("@feathersjs/authentication").AuthenticationResult | null>;
 export declare const resetSocket: () => void;
-export declare function extractAvatarIdFromUrl(url: string): string | null;
 export declare const authenticateWithB3JWT: (fullToken: string, params?: Record<string, any>) => Promise<import("@feathersjs/authentication").AuthenticationResult | null>;
 export default app;

package/dist/esm/global-account/bsmnt.js

@@ -60,11 +60,6 @@ export const resetSocket = () => {
     socket.connect();
     // reset the socket connection
 };
-export function extractAvatarIdFromUrl(url) {
-    const regex = /https:\/\/models\.readyplayer\.me\/([a-f0-9]{24})\.[a-zA-Z0-9]+/;
-    const match = url.match(regex);
-    return match ? match[1] : null;
-}
 export const authenticateWithB3JWT = async (fullToken, params) => {
     // Do not authenticate if there is no token
     if (!fullToken) {

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

@@ -41,6 +41,8 @@ export function AvatarEditor({ onSetAvatar, className }) {
     const { user, setUser } = useAuthentication(partnerId);
     const setB3ModalContentType = useModalStore(state => state.setB3ModalContentType);
     const contentType = useModalStore(state => state.contentType);
+    const { authStrategy } = useB3Config();
+    const isBetterAuth = authStrategy === "better-auth";
     const account = useActiveAccount();
     const { data: profile, refetch: refreshProfile } = useProfile({
         address: account?.address,
@@ -118,7 +120,7 @@ export function AvatarEditor({ onSetAvatar, className }) {
         setCroppedAreaPixels(null);
     };
     const handleSaveChanges = async () => {
-        if (!account?.address) {
+        if (!isBetterAuth && !account?.address) {
             toast.error("No account connected");
             return;
         }

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

@@ -17,6 +17,7 @@ import { LinkAccount } from "./LinkAccount/LinkAccount.js";
 import { LinkNewAccount } from "./LinkAccount/LinkNewAccount.js";
 import { ManageAccount } from "./ManageAccount/ManageAccount.js";
 import NotificationsContent from "./ManageAccount/NotificationsContent.js";
+import SessionDurationContent from "./ManageAccount/SessionDurationContent.js";
 import { RequestPermissions } from "./RequestPermissions/RequestPermissions.js";
 import { Send } from "./Send/Send.js";
 import { SignInWithB3Flow } from "./SignInWithB3/SignInWithB3Flow.js";
@@ -31,7 +32,7 @@ export function B3DynamicModal() {
     const navigateBack = useModalStore(state => state.navigateBack);
     const { theme } = useB3Config();
     const isMobile = useIsMobile();
-    const { toasts, removeToast } = useToastContext();
+    const { toasts, removeToast, headerMode } = useToastContext();
     // Define arrays for different modal type groups
     const fullWidthTypes = [
         "anySpend",
@@ -140,6 +141,8 @@ export function B3DynamicModal() {
                 return _jsx(Send, { ...contentType });
             case "notifications":
                 return _jsx(NotificationsContent, { ...contentType });
+            case "sessionDuration":
+                return _jsx(SessionDurationContent, { partnerId: contentType.partnerId });
             // Add other modal types here
             default:
                 return null;
@@ -162,7 +165,7 @@ export function B3DynamicModal() {
                     contentType?.type === "send" ||
                     contentType?.type === "avatarEditor" ||
                     contentType?.type === "notifications") &&
-                    "p-0", "mx-auto w-full max-w-md sm:max-w-lg"), hideCloseButton: hideCloseButton, hideGABranding: isAnySpendType, onEscapeKeyDown: !isClosable ? e => e.preventDefault() : undefined, children: [_jsx(ModalTitle, { className: "sr-only hidden", children: contentType?.type || "Modal" }), _jsx(ModalDescription, { className: "sr-only hidden", children: contentType?.type || "Modal Body" }), _jsxs("div", { className: cn("b3-modal-content no-scrollbar dark:bg-b3-background flex max-h-[90dvh] flex-col overflow-auto sm:max-h-[80dvh]"), children: [!hideCloseButton && (_jsxs("button", { onClick: navigateBack, className: "flex items-center gap-2 px-6 py-4 text-gray-600 transition-colors hover:text-gray-900 dark:text-gray-400 dark:hover:text-white", children: [_jsxs("svg", { width: "20", height: "20", viewBox: "0 0 20 20", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("path", { d: "M15.8337 10H4.16699", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("path", { d: "M10.0003 15.8334L4.16699 10L10.0003 4.16669", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" })] }), _jsx("span", { className: "font-inter text-sm font-semibold", children: "Back" })] })), _jsx("div", { className: "flex-1", children: renderContent() }), _jsx(AnimatePresence, { children: toasts.length > 0 && (_jsx(motion.div, { initial: { height: 0 }, animate: { height: "auto" }, exit: { height: 0 }, transition: { duration: 0.3, ease: "easeInOut" }, className: "toast-section relative z-10 overflow-hidden bg-white dark:border-neutral-800 dark:bg-neutral-900", children: _jsx(motion.div, { initial: { opacity: 0, y: -10 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -10 }, transition: { duration: 0.2, delay: 0.1 }, className: "p-4 pt-0", children: _jsx(ToastContainer, { toasts: toasts, onDismiss: removeToast, theme: theme }) }) })) })] })] }), isOpen && !isAnySpendType && (_jsx("style", { children: `
+                    "p-0", "mx-auto w-full max-w-md sm:max-w-lg"), hideCloseButton: hideCloseButton, hideGABranding: isAnySpendType, onEscapeKeyDown: !isClosable ? e => e.preventDefault() : undefined, children: [_jsx(ModalTitle, { className: "sr-only hidden", children: contentType?.type || "Modal" }), _jsx(ModalDescription, { className: "sr-only hidden", children: contentType?.type || "Modal Body" }), _jsxs("div", { className: cn("b3-modal-content no-scrollbar dark:bg-b3-background flex max-h-[90dvh] flex-col overflow-auto sm:max-h-[80dvh]"), children: [!hideCloseButton && (_jsxs("button", { onClick: navigateBack, className: "flex items-center gap-2 px-6 py-4 text-gray-600 transition-colors hover:text-gray-900 dark:text-gray-400 dark:hover:text-white", children: [_jsxs("svg", { width: "20", height: "20", viewBox: "0 0 20 20", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [_jsx("path", { d: "M15.8337 10H4.16699", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("path", { d: "M10.0003 15.8334L4.16699 10L10.0003 4.16669", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" })] }), _jsx("span", { className: "font-inter text-sm font-semibold", children: "Back" })] })), _jsx("div", { className: "flex-1", children: renderContent() }), _jsx(AnimatePresence, { children: !headerMode && toasts.length > 0 && (_jsx(motion.div, { initial: { height: 0 }, animate: { height: "auto" }, exit: { height: 0 }, transition: { duration: 0.3, ease: "easeInOut" }, className: "toast-section relative z-10 overflow-hidden bg-white dark:border-neutral-800 dark:bg-neutral-900", children: _jsx(motion.div, { initial: { opacity: 0, y: -10 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -10 }, transition: { duration: 0.2, delay: 0.1 }, className: "p-4 pt-0", children: _jsx(ToastContainer, { toasts: toasts, onDismiss: removeToast, theme: theme }) }) })) })] })] }), isOpen && !isAnySpendType && (_jsx("style", { children: `
           .modal-inner-content {
             transition: margin-bottom 0.3s ease-in-out;
             margin-bottom: ${toasts.length > 0 ? "0px" : "23px"} !important;

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

@@ -1,5 +1,7 @@
-declare const AuthenticationProvider: ({ partnerId, automaticallySetFirstEoa, }: {
+import { EIP1193 } from "thirdweb/wallets";
+declare const AuthenticationProvider: ({ partnerId, automaticallySetFirstEoa, defaultEoaProvider, }: {
     partnerId: string;
     automaticallySetFirstEoa: boolean;
+    defaultEoaProvider?: EIP1193.EIP1193Provider;
 }) => null;
 export default AuthenticationProvider;

package/dist/esm/global-account/react/components/B3Provider/AuthenticationProvider.js

@@ -1,9 +1,10 @@
 import { useAuthentication } from "../../hooks/index.js";
 import { useAutoSelectWallet } from "../../hooks/useAutoSelectWallet.js";
-const AuthenticationProvider = ({ partnerId, automaticallySetFirstEoa, }) => {
+const AuthenticationProvider = ({ partnerId, automaticallySetFirstEoa, defaultEoaProvider, }) => {
     useAuthentication(partnerId);
     useAutoSelectWallet({
         enabled: automaticallySetFirstEoa,
+        defaultEoaProvider,
     });
     return null;
 };

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

@@ -3,6 +3,7 @@ import { CreateOrderParams } from "../../../../anyspend/react/hooks/useAnyspendC
 import { PermissionsConfig } from "../../../../global-account/types/permissions";
 import { Account } from "thirdweb/wallets";
 import { ClientType } from "../../../client-manager";
+export type AuthStrategy = "thirdweb" | "better-auth";
 export interface B3ConfigContextType {
     accountOverride?: Account;
     automaticallySetFirstEoa: boolean;
@@ -13,8 +14,11 @@ export interface B3ConfigContextType {
     partnerId: string;
     stripePublishableKey?: string;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    authStrategy: AuthStrategy;
+    /** Override the API base URL for all auth operations (Better Auth client, Feathers JWT exchange). */
+    apiUrl?: string;
 }
-export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, }: {
+export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, authStrategy, apiUrl, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment?: "development" | "production";
@@ -25,5 +29,8 @@ export declare function B3ConfigProvider({ children, accountOverride, environmen
     partnerId: string;
     stripePublishableKey?: string;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
+    authStrategy?: AuthStrategy;
+    /** Override the API base URL for all auth operations (Better Auth client, Feathers JWT exchange). */
+    apiUrl?: string;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function useB3Config(): B3ConfigContextType;

package/dist/esm/global-account/react/components/B3Provider/B3ConfigProvider.js

@@ -10,7 +10,7 @@ const DEFAULT_PERMISSIONS = {
     endDate: new Date(Date.now() + 1000 * 60 * 60 * 24 * 365), // 1 year from now
 };
 const B3ConfigContext = createContext(null);
-export function B3ConfigProvider({ children, accountOverride, environment = "development", defaultPermissions = DEFAULT_PERMISSIONS, automaticallySetFirstEoa = false, theme = "light", clientType = "rest", partnerId, stripePublishableKey, createClientReferenceId, }) {
+export function B3ConfigProvider({ children, accountOverride, environment = "development", defaultPermissions = DEFAULT_PERMISSIONS, automaticallySetFirstEoa = false, theme = "light", clientType = "rest", partnerId, stripePublishableKey, createClientReferenceId, authStrategy = "thirdweb", apiUrl, }) {
     return (_jsx(B3ConfigContext.Provider, { value: {
             accountOverride,
             environment,
@@ -21,6 +21,8 @@ export function B3ConfigProvider({ children, accountOverride, environment = "dev
             partnerId,
             stripePublishableKey,
             createClientReferenceId,
+            authStrategy,
+            apiUrl,
         }, children: children }));
 }
 export function useB3Config() {

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

@@ -1,19 +1,23 @@
 import { CreateOnrampOrderParams } from "../../../../anyspend/react/hooks/useAnyspendCreateOnrampOrder";
 import { CreateOrderParams } from "../../../../anyspend/react/hooks/useAnyspendCreateOrder";
 import { PermissionsConfig } from "../../../../global-account/types/permissions";
+import type { AuthStrategy } from "./B3ConfigProvider";
 import "@relayprotocol/relay-kit-ui/styles.css";
-import { Account, Wallet } from "thirdweb/wallets";
+import { QueryClient } from "@tanstack/react-query";
+import { Account, EIP1193, Wallet } from "thirdweb/wallets";
 import { CreateConnectorFn } from "wagmi";
 import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, queryClient, authStrategy, apiUrl, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
     environment?: "development" | "production";
     automaticallySetFirstEoa?: boolean;
+    /** EIP-1193 provider to auto-connect as the default EOA wallet (e.g., Farcaster frame wallet) */
+    defaultEoaProvider?: EIP1193.EIP1193Provider;
     simDuneApiKey?: string;
     toaster?: {
         position?: "top-center" | "top-right" | "bottom-center" | "bottom-right";
@@ -30,4 +34,25 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     overrideDefaultConnectors?: boolean;
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
     defaultPermissions?: PermissionsConfig;
+    disableBSMNTAuthentication?: boolean;
+    /** Provide your own QueryClient for React Query. If omitted, WalletProvider creates one internally. */
+    queryClient?: QueryClient;
+    /** Auth strategy: "thirdweb" (default, ecosystem wallet) or "better-auth" (email/password via Better Auth) */
+    authStrategy?: AuthStrategy;
+    /**
+     * Override the API base URL for Better Auth operations.
+     *
+     * When set, the Better Auth client (signIn, signUp, signOut, getSession) will
+     * target this URL instead of the default `B3_API_URL` / `NEXT_PUBLIC_B3_API`.
+     *
+     * Useful for local development where the frontend runs on localhost:3003 and
+     * the b3-api runs on localhost:3031 — keeps the entire OAuth flow local so
+     * sessions, cookies, and token exchange all hit the same server.
+     *
+     * @example
+     * ```tsx
+     * <B3Provider apiUrl="http://localhost:3031" ... />
+     * ```
+     */
+    apiUrl?: string;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -2,25 +2,23 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { RelayKitProviderWrapper, TooltipProvider } from "../../../../global-account/react/index.js";
 import { createWagmiConfig } from "../../../../global-account/react/utils/createWagmiConfig.js";
 import { loadGA4Script } from "../../../../global-account/utils/analytics.js";
+import { WalletProvider } from "../../../../wallet/react/index.js";
 import "@relayprotocol/relay-kit-ui/styles.css";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { useEffect, useMemo } from "react";
-import { ThirdwebProvider } from "thirdweb/react";
-import { WagmiProvider } from "wagmi";
 import { setClientType } from "../../../client-manager.js";
 import { StyleRoot } from "../StyleRoot.js";
 import { setToastContext, ToastProvider, useToastContext } from "../Toast/index.js";
 import AuthenticationProvider from "./AuthenticationProvider.js";
 import { B3ConfigProvider } from "./B3ConfigProvider.js";
+import { BetterAuthClientProvider } from "./BetterAuthClientProvider.js";
+import BetterAuthProvider from "./BetterAuthProvider.js";
 import { LocalSDKProvider } from "./LocalSDKProvider.js";
-// Create queryClient instance
-const queryClient = new QueryClient();
 /**
  * Main B3Provider component
  */
-export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, simDuneApiKey, 
+export function B3Provider({ theme = "light", children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, 
 // deprecated since v0.0.87
-toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors = false, createClientReferenceId, defaultPermissions, }) {
+toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors = false, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication = false, queryClient, authStrategy = "thirdweb", apiUrl, }) {
     // Initialize Google Analytics on mount
     useEffect(() => {
         loadGA4Script();
@@ -30,7 +28,7 @@ toaster: _toaster, clientType = "rest", rpcUrls, partnerId, stripePublishableKey
         setClientType(clientType);
     }, [clientType]);
     const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId, rpcUrls, connectors, overrideDefaultConnectors }), [partnerId, rpcUrls, connectors, overrideDefaultConnectors]);
-    return (_jsx(ThirdwebProvider, { children: _jsx(WagmiProvider, { config: wagmiConfig, reconnectOnMount: false, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(TooltipProvider, { children: _jsx(ToastProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, onLogoutCallback: onLogout, children: _jsxs(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: !!automaticallySetFirstEoa, theme: theme, clientType: clientType, partnerId: partnerId, stripePublishableKey: stripePublishableKey, createClientReferenceId: createClientReferenceId, defaultPermissions: defaultPermissions, children: [_jsx(ToastContextConnector, {}), _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" })] }), _jsx(AuthenticationProvider, { partnerId: partnerId, automaticallySetFirstEoa: !!automaticallySetFirstEoa })] }) }) }) }) }) }) }));
+    return (_jsx(WalletProvider, { wagmiConfig: wagmiConfig, queryClient: queryClient, children: _jsx(TooltipProvider, { children: _jsx(ToastProvider, { children: _jsx(LocalSDKProvider, { onConnectCallback: onConnect, onLogoutCallback: onLogout, disableBSMNTAuthentication: disableBSMNTAuthentication, children: _jsx(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: !!automaticallySetFirstEoa, theme: theme, clientType: clientType, partnerId: partnerId, stripePublishableKey: stripePublishableKey, createClientReferenceId: createClientReferenceId, defaultPermissions: defaultPermissions, authStrategy: authStrategy, apiUrl: apiUrl, children: _jsxs(BetterAuthClientProvider, { apiUrl: apiUrl, children: [_jsx(ToastContextConnector, {}), _jsxs(RelayKitProviderWrapper, { simDuneApiKey: simDuneApiKey, children: [children, _jsx(StyleRoot, { id: "b3-root" })] }), authStrategy === "better-auth" ? (_jsx(BetterAuthProvider, { partnerId: partnerId })) : (_jsx(AuthenticationProvider, { partnerId: partnerId, automaticallySetFirstEoa: !!automaticallySetFirstEoa, defaultEoaProvider: defaultEoaProvider }))] }) }) }) }) }) }));
 }
 /**
  * Component to connect the toast context to the global toast API

package/dist/esm/global-account/react/components/B3Provider/B3Provider.native.js

@@ -1,13 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { WalletProvider } from "../../../../wallet/react/index.js";
 import { ThirdwebProvider } from "thirdweb/react";
-import { WagmiProvider } from "wagmi";
+import { useMemo } from "react";
 import { createWagmiConfig } from "../../utils/createWagmiConfig.js";
 import AuthenticationProvider from "./AuthenticationProvider.js";
 import { B3ConfigProvider } from "./B3ConfigProvider.js";
 import { LocalSDKProvider } from "./LocalSDKProvider.js";
-// Create queryClient instance
-const queryClient = new QueryClient();
 /**
  * Main B3Provider component
  */
@@ -18,6 +16,6 @@ export function B3Provider({ theme = "light", children, accountOverride, environ
  * Inner provider component for native
  */
 export function InnerProvider({ children, accountOverride, environment, defaultPermissions, theme = "light", clientType = "socket", partnerId, rpcUrls, }) {
-    const wagmiConfig = createWagmiConfig({ partnerId, rpcUrls });
-    return (_jsx(WagmiProvider, { config: wagmiConfig, children: _jsx(QueryClientProvider, { client: queryClient, children: _jsx(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: false, theme: theme, clientType: clientType, partnerId: partnerId, defaultPermissions: defaultPermissions, children: children }) }) }));
+    const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId, rpcUrls }), [partnerId, rpcUrls]);
+    return (_jsx(WalletProvider, { wagmiConfig: wagmiConfig, children: _jsx(B3ConfigProvider, { accountOverride: accountOverride, environment: environment, automaticallySetFirstEoa: false, theme: theme, clientType: clientType, partnerId: partnerId, defaultPermissions: defaultPermissions, children: children }) }));
 }

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

@@ -0,0 +1,17 @@
+import { type B3BetterAuthClient } from "../../../better-auth-client";
+/**
+ * Provides a Better Auth client instance to the subtree.
+ *
+ * When `apiUrl` is supplied, a custom client targeting that URL is created
+ * (e.g. `http://localhost:3031` for local development). Otherwise, the
+ * default singleton (which uses `B3_API_URL` / `NEXT_PUBLIC_B3_API`) is used.
+ */
+export declare function BetterAuthClientProvider({ children, apiUrl, }: {
+    children: React.ReactNode;
+    apiUrl?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the Better Auth client from the nearest `BetterAuthClientProvider`.
+ * Falls back to the default singleton if no provider is present.
+ */
+export declare function useBetterAuthClient(): B3BetterAuthClient;

package/dist/esm/global-account/react/components/B3Provider/BetterAuthClientProvider.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { betterAuthClient, createB3BetterAuthClient, } from "../../../better-auth-client.js";
+const BetterAuthClientContext = createContext(betterAuthClient);
+/**
+ * Provides a Better Auth client instance to the subtree.
+ *
+ * When `apiUrl` is supplied, a custom client targeting that URL is created
+ * (e.g. `http://localhost:3031` for local development). Otherwise, the
+ * default singleton (which uses `B3_API_URL` / `NEXT_PUBLIC_B3_API`) is used.
+ */
+export function BetterAuthClientProvider({ children, apiUrl, }) {
+    const client = useMemo(() => {
+        if (apiUrl) {
+            return createB3BetterAuthClient(apiUrl);
+        }
+        return betterAuthClient;
+    }, [apiUrl]);
+    return _jsx(BetterAuthClientContext.Provider, { value: client, children: children });
+}
+/**
+ * Returns the Better Auth client from the nearest `BetterAuthClientProvider`.
+ * Falls back to the default singleton if no provider is present.
+ */
+export function useBetterAuthClient() {
+    return useContext(BetterAuthClientContext);
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Parallel to AuthenticationProvider for Better Auth strategy.
+ *
+ * Manages the isAuthenticating lifecycle for Better Auth:
+ * 1. On mount, try to restore an existing Feathers JWT (from a previous login)
+ * 2. If no Feathers JWT, check for a Better Auth session (e.g. after OAuth redirect)
+ *    and exchange it for a Feathers JWT
+ * 3. If neither exists, set isAuthenticating: false so the login UI renders
+ *
+ * Also patches app.logout() so any code path that calls it (useAuthentication,
+ * useAuth, SignIn component, etc.) automatically clears the Better Auth session.
+ */
+declare const BetterAuthProvider: ({ partnerId }: {
+    partnerId: string;
+}) => null;
+export default BetterAuthProvider;

package/dist/esm/global-account/react/components/B3Provider/BetterAuthProvider.js

@@ -0,0 +1,116 @@
+import app from "../../../../global-account/app.js";
+import { useAuthStore } from "../../../../global-account/react/index.js";
+import { B3_AUTH_COOKIE_NAME } from "../../../../shared/constants/index.js";
+import { debugB3React } from "../../../../shared/utils/debug.js";
+import Cookies from "js-cookie";
+import { useEffect, useRef } from "react";
+import { useUserQuery } from "../../hooks/useUserQuery.js";
+import { useBetterAuthClient } from "./BetterAuthClientProvider.js";
+const debug = debugB3React("BetterAuthProvider");
+/**
+ * Parallel to AuthenticationProvider for Better Auth strategy.
+ *
+ * Manages the isAuthenticating lifecycle for Better Auth:
+ * 1. On mount, try to restore an existing Feathers JWT (from a previous login)
+ * 2. If no Feathers JWT, check for a Better Auth session (e.g. after OAuth redirect)
+ *    and exchange it for a Feathers JWT
+ * 3. If neither exists, set isAuthenticating: false so the login UI renders
+ *
+ * Also patches app.logout() so any code path that calls it (useAuthentication,
+ * useAuth, SignIn component, etc.) automatically clears the Better Auth session.
+ */
+const BetterAuthProvider = ({ partnerId }) => {
+    const betterAuthClient = useBetterAuthClient();
+    const setIsAuthenticated = useAuthStore(state => state.setIsAuthenticated);
+    const setIsAuthenticating = useAuthStore(state => state.setIsAuthenticating);
+    const setIsConnected = useAuthStore(state => state.setIsConnected);
+    const { setUser } = useUserQuery();
+    const hasAttemptedRestore = useRef(false);
+    const hasPatched = useRef(false);
+    // Patch app.logout() to also clear the Better Auth session.
+    // This ensures any existing logout path (useAuthentication, useAuth, SignIn
+    // dropdown, etc.) clears both the Feathers JWT and the Better Auth session.
+    // Patch app.logout() to also clear the Better Auth session.
+    // Only handles Better Auth signOut — state cleanup (isAuthenticated, isConnected,
+    // setUser, localStorage) is handled by useAuthentication/useAuth's own logout.
+    useEffect(() => {
+        if (hasPatched.current)
+            return;
+        hasPatched.current = true;
+        const originalLogout = app.logout.bind(app);
+        app.logout = async () => {
+            debug("Patched logout: clearing Better Auth session");
+            try {
+                await betterAuthClient.signOut();
+            }
+            catch {
+                debug("Better Auth signOut failed (non-critical)");
+            }
+            return originalLogout();
+        };
+        return () => {
+            app.logout = originalLogout;
+            hasPatched.current = false;
+        };
+    }, [betterAuthClient]);
+    // Session restore on mount
+    useEffect(() => {
+        if (hasAttemptedRestore.current)
+            return;
+        hasAttemptedRestore.current = true;
+        const restoreSession = async () => {
+            debug("Attempting session restore");
+            // 1. Try existing Feathers JWT first (fastest — no network call to Better Auth)
+            try {
+                const response = await app.reAuthenticate();
+                if (response?.user) {
+                    debug("Feathers JWT restored", { userId: response.user.userId });
+                    setUser(response.user);
+                    setIsAuthenticated(true);
+                    setIsConnected(true);
+                    setIsAuthenticating(false);
+                    return;
+                }
+            }
+            catch {
+                debug("No existing Feathers JWT");
+            }
+            // 2. Check for a Better Auth session (e.g. after OAuth redirect sets a cookie)
+            try {
+                const session = await betterAuthClient.getSession();
+                if (session.data?.session?.token) {
+                    debug("Better Auth session found, exchanging for Feathers JWT", {
+                        betterAuthUserId: session.data.user?.id,
+                    });
+                    const response = await app.authenticate({
+                        strategy: "better-auth",
+                        accessToken: session.data.session.token,
+                        partnerId,
+                    });
+                    if (response.accessToken) {
+                        Cookies.set(B3_AUTH_COOKIE_NAME, response.accessToken, {
+                            secure: true,
+                            sameSite: "Lax",
+                        });
+                    }
+                    if (response.user) {
+                        setUser(response.user);
+                        setIsAuthenticated(true);
+                        setIsConnected(true);
+                    }
+                    debug("OAuth session exchanged for Feathers JWT", { userId: response.user?.userId });
+                    setIsAuthenticating(false);
+                    return;
+                }
+            }
+            catch {
+                debug("No Better Auth session to restore");
+            }
+            // 3. Nothing found — show login UI
+            setIsAuthenticating(false);
+        };
+        restoreSession();
+    }, [setIsAuthenticated, setIsAuthenticating, setIsConnected, setUser, partnerId, betterAuthClient]);
+    return null;
+};
+export default BetterAuthProvider;

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

@@ -6,13 +6,15 @@ import { Wallet } from "thirdweb/wallets";
 export interface LocalSDKContextType {
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
     onLogoutCallback?: () => void | Promise<void>;
+    disableBSMNTAuthentication?: boolean;
 }
 export declare const LocalSDKContext: import("react").Context<LocalSDKContextType>;
 /**
  * Local SDK Provider that wraps the app and provides internal SDK state
  */
-export declare function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, }: {
+export declare function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, disableBSMNTAuthentication, }: {
     children: React.ReactNode;
     onConnectCallback?: (wallet: Wallet, b3Jwt: string) => void | Promise<void>;
     onLogoutCallback?: () => void | Promise<void>;
+    disableBSMNTAuthentication?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/esm/global-account/react/components/B3Provider/LocalSDKProvider.js

@@ -3,13 +3,15 @@ import { createContext } from "react";
 export const LocalSDKContext = createContext({
     onConnectCallback: undefined,
     onLogoutCallback: undefined,
+    disableBSMNTAuthentication: false,
 });
 /**
  * Local SDK Provider that wraps the app and provides internal SDK state
  */
-export function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, }) {
+export function LocalSDKProvider({ children, onConnectCallback, onLogoutCallback, disableBSMNTAuthentication, }) {
     return (_jsx(LocalSDKContext.Provider, { value: {
             onConnectCallback,
             onLogoutCallback,
+            disableBSMNTAuthentication,
         }, children: children }));
 }

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

@@ -16,6 +16,8 @@ interface IPFSMediaRendererProps {
     controls?: boolean;
     /** Style object */
     style?: React.CSSProperties;
+    /** Callback when media fails to load */
+    onError?: () => void;
 }
 /**
  * IPFSMediaRenderer - A wrapper around Thirdweb's MediaRenderer that configures
@@ -35,5 +37,5 @@ interface IPFSMediaRendererProps {
  * />
  * ```
  */
-export declare function IPFSMediaRenderer({ src, alt, className, client, width, height, controls, style, }: IPFSMediaRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function IPFSMediaRenderer({ src, alt, className, client, width, height, controls, style, onError, }: IPFSMediaRendererProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -21,7 +21,7 @@ import { MediaRenderer } from "thirdweb/react";
  * />
  * ```
  */
-export function IPFSMediaRenderer({ src, alt = "Media", className, client = defaultClient, width, height, controls, style, }) {
+export function IPFSMediaRenderer({ src, alt = "Media", className, client = defaultClient, width, height, controls, style, onError, }) {
     // If no source, render fallback
     if (!src) {
         return (_jsx("div", { className: className, style: style, "aria-label": alt, children: _jsx("div", { className: "bg-b3-primary-wash flex h-full w-full items-center justify-center rounded-full", children: _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: alt.charAt(0).toUpperCase() }) }) }));
@@ -29,5 +29,7 @@ export function IPFSMediaRenderer({ src, alt = "Media", className, client = defa
     // Convert IPFS URLs to HTTP gateway URLs using our preferred gateway
     // This avoids Thirdweb's default cloudflare-ipfs.com which can be unreliable
     const resolvedSrc = src.startsWith("ipfs://") ? getIpfsUrl(src) : src;
-    return (_jsx(MediaRenderer, { src: resolvedSrc, client: client, alt: alt, className: className, width: width ? width.toString() : undefined, height: height ? height.toString() : undefined, controls: controls, style: style }));
+    // Wrap in a span with onErrorCapture to catch img/video load errors from
+    // MediaRenderer, which doesn't expose an onError prop itself.
+    return (_jsx("span", { onErrorCapture: onError, className: "contents", children: _jsx(MediaRenderer, { src: resolvedSrc, client: client, alt: alt, className: className, width: width ? width.toString() : undefined, height: height ? height.toString() : undefined, controls: controls, style: style }) }));
 }

package/dist/esm/global-account/react/components/LinkAccount/LinkedAccountItem.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Button, toast, useProfile } from "../../../../global-account/react/index.js";
+import { validateImageUrl } from "../../../../global-account/react/utils/profileDisplay.js";
 import { truncateAddress } from "../../../../shared/utils/truncateAddress.js";
 import { Copy, Loader2, UnlinkIcon } from "lucide-react";
 // Helper function to check if a string is a wallet address and format it
@@ -30,7 +31,7 @@ const LinkedAccountItem = ({ profile, profileToUnlink, unlinkingAccountId, isUnl
             toast.error("Failed to copy address");
         }
     };
-    const displayImageUrl = profileData?.avatar || profile.imageUrl;
+    const displayImageUrl = validateImageUrl(profileData?.avatar) || validateImageUrl(profile.imageUrl);
     const displayName = profileData?.name || displayTitle;
     return (_jsxs("div", { className: "linked-account-item hover:bg-b3-line group flex cursor-pointer items-center justify-between rounded-xl p-4 transition-colors", children: [_jsxs("div", { className: "linked-account-info flex items-center gap-3", children: [displayImageUrl ? (_jsx("img", { src: displayImageUrl, alt: profile.title, className: "linked-account-avatar linked-account-avatar-image size-10 rounded-full" })) : (_jsx("div", { className: "linked-account-avatar linked-account-avatar-placeholder bg-b3-primary-wash flex h-10 w-10 items-center justify-center rounded-full", children: _jsx("span", { className: "linked-account-initial text-b3-grey font-neue-montreal-semibold text-sm uppercase", children: profile.initial }) })), _jsxs("div", { className: "linked-account-details", children: [_jsxs("div", { className: "linked-account-title-row flex items-center gap-2", children: [_jsxs("div", { className: "flex items-center gap-1", children: [_jsx("span", { className: `linked-account-title text-b3-grey font-neue-montreal-semibold ${isAddress
                                                     ? "font-mono text-sm" // Use monospace font for addresses

package/dist/esm/global-account/react/components/ManageAccount/BottomNavigation.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { TabsListPrimitive, TabTriggerPrimitive, useModalStore } from "../../../../global-account/react/index.js";
+import { TabsListPrimitive, TabTriggerPrimitive, useB3Config, useModalStore } from "../../../../global-account/react/index.js";
 const HomeIcon = () => {
     return (_jsx("svg", { width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: _jsx("path", { fillRule: "evenodd", clipRule: "evenodd", d: "M12.5227 1.33636C12.1804 1.24368 11.8196 1.24368 11.4773 1.33636C11.08 1.44395 10.7454 1.7066 10.4784 1.91623L10.4038 1.97465L3.54376 7.31012C3.16713 7.6024 2.83532 7.85991 2.58806 8.19421C2.37107 8.48759 2.20942 8.8181 2.11106 9.1695C1.99898 9.56992 1.99943 9.98993 1.99995 10.4667L2.00002 17.8385C2 18.3657 1.99998 18.8204 2.03059 19.195C2.06289 19.5904 2.1342 19.9836 2.327 20.362C2.61462 20.9264 3.07356 21.3854 3.63805 21.673C4.01643 21.8658 4.40964 21.9371 4.80499 21.9694C5.17956 22 5.63431 22 6.16145 22H17.8386C18.3657 22 18.8205 22 19.195 21.9694C19.5904 21.9371 19.9836 21.8658 20.362 21.673C20.9265 21.3854 21.3854 20.9264 21.673 20.362C21.8658 19.9836 21.9371 19.5904 21.9694 19.195C22.0001 18.8204 22 18.3657 22 17.8386L22.0001 10.4667C22.0006 9.98993 22.0011 9.56992 21.889 9.1695C21.7906 8.8181 21.629 8.48759 21.412 8.19421C21.1647 7.8599 20.8329 7.6024 20.4563 7.31011L13.5963 1.97465L13.5216 1.91623C13.2546 1.7066 12.9201 1.44395 12.5227 1.33636ZM8.00003 16C7.44775 16 7.00003 16.4477 7.00003 17C7.00003 17.5523 7.44775 18 8.00003 18H16C16.5523 18 17 17.5523 17 17C17 16.4477 16.5523 16 16 16H8.00003Z", fill: "currentColor" }) }));
 };
@@ -11,11 +11,13 @@ const SettingsIcon = () => {
 };
 const BottomNavigation = () => {
     const setB3ModalContentType = useModalStore(state => state.setB3ModalContentType);
-    return (_jsx("div", { className: "b3-modal-bottom-navigation sticky bottom-0 left-0 w-full rounded-b-xl border-t border-gray-200 bg-[#FAFAFA]", children: _jsxs(TabsListPrimitive, { className: "flex h-[68px] w-full items-center justify-center gap-4 border-none bg-transparent", children: [_jsxs(TabTriggerPrimitive, { value: "home", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", children: [_jsx(HomeIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Home" })] }), _jsxs(TabTriggerPrimitive, { value: "swap", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", onClick: () => {
+    const { authStrategy } = useB3Config();
+    const isBetterAuth = authStrategy === "better-auth";
+    return (_jsx("div", { className: "b3-modal-bottom-navigation sticky bottom-0 left-0 w-full rounded-b-xl border-t border-gray-200 bg-[#FAFAFA]", children: _jsxs(TabsListPrimitive, { className: "flex h-[68px] w-full items-center justify-center gap-4 border-none bg-transparent", children: [_jsxs(TabTriggerPrimitive, { value: "home", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", children: [_jsx(HomeIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Home" })] }), !isBetterAuth && (_jsxs(TabTriggerPrimitive, { value: "swap", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", onClick: () => {
                         setB3ModalContentType({
                             type: "anySpend",
                             showBackButton: true,
                         });
-                    }, children: [_jsx(SwapIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Swap" })] }), _jsxs(TabTriggerPrimitive, { value: "settings", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", children: [_jsx(SettingsIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Settings" })] })] }) }));
+                    }, children: [_jsx(SwapIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Swap" })] })), _jsxs(TabTriggerPrimitive, { value: "settings", className: "data-[state=active]:border-b3-primary-blue group flex flex-initial flex-col items-center gap-1 border-r-0 border-t-0 px-6 pb-2 pt-2.5 text-[#a0a0ab] data-[state=active]:border-t-4 data-[state=active]:text-[#18181B] dark:data-[state=active]:text-white", children: [_jsx(SettingsIcon, {}), _jsx("span", { className: "text-b3-grey font-neue-montreal-semibold text-xs", children: "Settings" })] })] }) }));
 };
 export default BottomNavigation;