@b3dotfun/sdk 0.1.70-alpha.2 → 0.1.70-alpha.21

package/src/anyspend/utils/chain.ts

@@ -1,4 +1,5 @@
 import { RELAY_SOLANA_MAINNET_CHAIN_ID } from "@b3dotfun/sdk/anyspend/constants";
+import { SOLANA_CHAIN_ID } from "@b3dotfun/sdk/shared/utils/zerionPositions";
 import {
   ABSTRACT_PUBLIC_RPC,
   ARBITRUM_PUBLIC_RPC,
@@ -8,7 +9,9 @@ import {
   ETHEREUM_PUBLIC_RPC,
   HYPEREVM_PUBLIC_RPC,
   OPTIMISM_PUBLIC_RPC,
+  PLUME_PUBLIC_RPC,
   POLYGON_PUBLIC_RPC,
+  ROBINHOOD_PUBLIC_RPC,
 } from "@b3dotfun/sdk/anyspend/constants/rpc";
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import { b3Viem } from "@b3dotfun/sdk/shared/constants/chains/b3Viem";
@@ -25,7 +28,7 @@ import {
   Transport,
   WalletClient,
 } from "viem";
-import { abstract, arbitrum, avalanche, base, bsc, mainnet, optimism, polygon } from "viem/chains";
+import { abstract, arbitrum, avalanche, base, bsc, mainnet, optimism, polygon, robinhood } from "viem/chains";
 import { ChainType, IBaseChain, IEVMChain, IHyperliquidChain, ISolanaChain } from "../types/chain";
 import {
   getAvaxToken,
@@ -33,10 +36,12 @@ import {
   getEthToken,
   getHyperEVMNativeToken,
   getHyperliquidUSDCToken,
+  getPlumeNativeToken,
   getPolToken,
   getSolanaToken,
   HYPEREVM_CHAIN_ID,
   HYPERLIQUID_CHAIN_ID,
+  PLUME_CHAIN_ID,
 } from "./token";
 
 function getCustomEvmChain(chain: Chain, rpcUrl: string): Chain {
@@ -84,11 +89,19 @@ export function clearChainRpcOverrides(): void {
 export const hyperEVM = defineChain({
   id: HYPEREVM_CHAIN_ID,
   name: "HyperEVM",
-  nativeCurrency: { name: "HyperEVM", symbol: "HYPE", decimals: 18 },
+  nativeCurrency: { name: "Hyperliquid", symbol: "HYPE", decimals: 18 },
   rpcUrls: { default: { http: [HYPEREVM_PUBLIC_RPC] } },
   blockExplorers: { default: { name: "HyperEVM Explorer", url: "https://hyperevmscan.io/" } },
 });
 
+export const plume = defineChain({
+  id: PLUME_CHAIN_ID,
+  name: "Plume",
+  nativeCurrency: { name: "Plume", symbol: "PLUME", decimals: 18 },
+  rpcUrls: { default: { http: [PLUME_PUBLIC_RPC] } },
+  blockExplorers: { default: { name: "Plume Explorer", url: "https://explorer.plume.org" } },
+});
+
 // export const b4testnet = defineChain({
 //   id: 19934,
 //   name: "B4 Testnet",
@@ -247,6 +260,34 @@ export const EVM_MAINNET: Record<number, IEVMChain> = {
     coingeckoName: "hyperevm",
     wethAddress: "0x5555555555555555555555555555555555555555",
   },
+  [plume.id]: {
+    id: plume.id,
+    name: plume.name,
+    logoUrl: "https://cdn.b3.fun/b3os-icons/plume.svg",
+    type: ChainType.EVM,
+    nativeRequired: parseEther("5"), // 5 PLUME ≈ $0.06 — gas reserve; Plume gasPrice ~1000 gwei × 2.2M gas (approve+deposit) needs ~2.2 PLUME, +headroom for spikes
+    canDepositNative: true,
+    defaultToken: getPlumeNativeToken(),
+    nativeToken: getPlumeNativeToken(),
+    viem: plume,
+    pollingInterval: 1000, // 1 second for Plume (L2 fast blocks)
+    coingeckoName: "plume-network",
+    wethAddress: "0xea237441c92cae6fc17caaf9a7acb3f953be4bd1", // WPLUME (wrapped native)
+  },
+  [robinhood.id]: {
+    id: robinhood.id,
+    name: robinhood.name,
+    logoUrl: "https://assets.relay.link/icons/square/4663/light.png",
+    type: ChainType.EVM,
+    nativeRequired: parseEther("0.0001"),
+    canDepositNative: true,
+    defaultToken: getEthToken(robinhood.id),
+    nativeToken: getEthToken(robinhood.id),
+    viem: getCustomEvmChain(robinhood, ROBINHOOD_PUBLIC_RPC),
+    pollingInterval: 1000, // 1 second for Robinhood Chain (Arbitrum Orbit fast blocks)
+    coingeckoName: "robinhood",
+    wethAddress: "0x0bd7d308f8e1639fab988df18a8011f41eacad73", // wrapped native ETH (registry wrappedNative)
+  },
 };
 
 export const EVM_TESTNET: Record<number, IEVMChain> = {
@@ -331,6 +372,17 @@ export const EVM_CHAINS: Record<number, IEVMChain> = { ...EVM_MAINNET, ...EVM_TE
 
 export const SOLANA_CHAINS: Record<number, ISolanaChain> = { [RELAY_SOLANA_MAINNET_CHAIN_ID]: SOLANA_MAINNET };
 
+/**
+ * Translate a Relay-numbered chain id into the id the chain registry uses.
+ *
+ * Relay numbers Solana 792703809; every other chain shares the universal EVM id. Balance rows are
+ * keyed by the registry's id, so handing Relay's number to a balance lookup matches nothing at all
+ * — and a funded Solana wallet then reads as empty rather than as unreadable.
+ */
+export function toRegistryChainId(chainId: number): number {
+  return chainId === RELAY_SOLANA_MAINNET_CHAIN_ID ? SOLANA_CHAIN_ID : chainId;
+}
+
 export const HYPERLIQUID_CHAINS: Record<number, IHyperliquidChain> = {
   [HYPERLIQUID_CHAIN_ID]: HYPERLIQUID_MAINNET,
 };
@@ -655,6 +707,26 @@ export function getHyperliquidChain(chainId: number): IHyperliquidChain {
   return HYPERLIQUID_CHAINS[chainId];
 }
 
+/**
+ * Chains AnySpend no longer accepts orders on, as either source or destination.
+ *
+ * They stay in ALL_CHAINS on purpose. That map answers "what is this chain" — name, logo, token,
+ * decimals — which every order that ever existed still needs in order to render; removing an entry
+ * would make getChainName and friends throw on historical rows. Whether new orders are accepted is
+ * this separate question.
+ *
+ * anyspend-service imports this list rather than keeping its own, so the API and the chain picker
+ * can never disagree about what is on offer.
+ */
+export const DEPRECATED_CHAIN_IDS: readonly number[] = [
+  8333, // B3
+  98866, // Plume
+];
+
+export function isDeprecatedChain(chainId?: number): boolean {
+  return chainId !== undefined && DEPRECATED_CHAIN_IDS.includes(chainId);
+}
+
 /**
  * Get available chain IDs for AnySpend based on context (source or destination).
  * Filters out chains that shouldn't be available for the given context.
@@ -670,7 +742,11 @@ export function getHyperliquidChain(chainId: number): IHyperliquidChain {
  * const destChains = getAvailableChainIds("to") // [1, 8453, 137, ..., 1337]
  */
 export function getAvailableChainIds(context: "from" | "to"): number[] {
-  const allChainIds = Object.values(ALL_CHAINS).map(chain => chain.id);
+  // Deprecated chains are excluded from both directions: the API rejects them, so offering them in
+  // a picker would let a user select something that then fails at order creation.
+  const allChainIds = Object.values(ALL_CHAINS)
+    .map(chain => chain.id)
+    .filter(chainId => !isDeprecatedChain(chainId));
 
   if (context === "from") {
     // Hyperliquid is only supported as destination chain, not source chain

package/src/anyspend/utils/token.ts

@@ -4,6 +4,7 @@ import { avalanche, bsc, polygon } from "viem/chains";
 
 export const HYPERLIQUID_CHAIN_ID = 1337;
 export const HYPEREVM_CHAIN_ID = 999;
+export const PLUME_CHAIN_ID = 98866;
 
 /**
  * Hyperliquid uses a special 34-character USDC address format (0x + 32 hex digits)
@@ -106,3 +107,16 @@ export function getHyperliquidUSDCToken(): components["schemas"]["Token"] {
     },
   };
 }
+
+export function getPlumeNativeToken(): components["schemas"]["Token"] {
+  return {
+    chainId: PLUME_CHAIN_ID,
+    address: ZERO_ADDRESS,
+    symbol: "PLUME",
+    name: "Plume",
+    decimals: 18,
+    metadata: {
+      logoURI: "https://cdn.b3.fun/b3os-icons/plume.svg",
+    },
+  };
+}

package/src/app.shared.ts

@@ -4,15 +4,35 @@ import Cookies from "js-cookie";
 import { B3_AUTH_COOKIE_NAME } from "./shared/constants";
 import { getSessionDurationDays } from "./shared/utils/session-duration";
 
+/** Default API URL derived from environment variables. */
 export const B3_API_URL =
   process.env.EXPO_PUBLIC_B3_API || process.env.NEXT_PUBLIC_B3_API || process.env.PUBLIC_B3_API || "https://api.b3.fun";
 
+/**
+ * Runtime-overridable API URL. Set by `B3Provider` when an `apiUrl` prop
+ * is provided. Falls back to the env-var-derived `B3_API_URL`.
+ */
+let _apiUrlOverride: string | null = null;
+
+/**
+ * Override the B3 API URL at runtime. Called by `B3Provider` when an
+ * `apiUrl` prop is provided. Pass `null` to revert to the default.
+ */
+export function setB3ApiUrl(url: string | null): void {
+  _apiUrlOverride = url;
+}
+
+/** Get the current B3 API URL (prefers runtime override, then env var). */
+export function getB3ApiUrl(): string {
+  return _apiUrlOverride || B3_API_URL;
+}
+
 export const authenticate = async (
   app: ClientApplication,
   accessToken: string,
   identityToken: string,
   params?: Record<string, any>,
-) => {
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token

package/src/global-account/app.native.ts

@@ -77,7 +77,11 @@ const app = createClient(socketio(socket), {
   storageKey: B3_AUTH_COOKIE_NAME,
 });
 
-export const authenticate = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticate = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token

package/src/global-account/better-auth-client.ts

@@ -1,17 +1,43 @@
 import { createAuthClient } from "better-auth/client";
-import { B3_API_URL } from "../app.shared";
+import { twoFactorClient } from "better-auth/client/plugins";
+import { getB3ApiUrl } from "../app.shared";
 
 export type B3BetterAuthClient = ReturnType<typeof createB3BetterAuthClient>;
 
-export function createB3BetterAuthClient(baseURL: string = B3_API_URL) {
+export function createB3BetterAuthClient(baseURL?: string) {
   return createAuthClient({
-    baseURL,
+    baseURL: baseURL ?? getB3ApiUrl(),
     basePath: "/auth",
     fetchOptions: {
       credentials: "include",
     },
+    plugins: [twoFactorClient()],
   });
 }
 
-// Default singleton for standard usage
+// Lazily-initialized singleton. Recreated when the API URL changes via
+// `resetBetterAuthClient()` (called by B3Provider when `apiUrl` changes).
+let _client: B3BetterAuthClient | null = null;
+let _clientUrl: string | null = null;
+
+/** Get the shared BetterAuth client, creating it if needed. */
+export function getBetterAuthClient(): B3BetterAuthClient {
+  const url = getB3ApiUrl();
+  if (!_client || _clientUrl !== url) {
+    _client = createB3BetterAuthClient(url);
+    _clientUrl = url;
+  }
+  return _client;
+}
+
+/** Force-recreate the client on next access (e.g. after API URL change). */
+export function resetBetterAuthClient(): void {
+  _client = null;
+  _clientUrl = null;
+}
+
+/**
+ * @deprecated Use `getBetterAuthClient()` instead. This static singleton
+ * does not reflect runtime API URL changes via `B3Provider apiUrl` prop.
+ */
 export const betterAuthClient = createB3BetterAuthClient();

package/src/global-account/bsmnt.native.ts

@@ -80,7 +80,11 @@ const app = createClient(socketio(socket), {
   storageKey: BSMNT_AUTH_COOKIE_NAME,
 });
 
-export const authenticate = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticate = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token

package/src/global-account/bsmnt.ts

@@ -42,7 +42,11 @@ const app = createClient(socketio(socket), {
   storageKey: BSMNT_AUTH_COOKIE_NAME,
 });
 
-export const authenticate = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticate = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   const fullToken = `${accessToken}+${identityToken}`;
 
   // Do not authenticate if there is no token
@@ -73,7 +77,10 @@ export const resetSocket = () => {
   // reset the socket connection
 };
 
-export const authenticateWithB3JWT = async (fullToken: string, params?: Record<string, any>) => {
+export const authenticateWithB3JWT = async (
+  fullToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   // Do not authenticate if there is no token
   if (!fullToken) {
     console.log("No token found, not authenticating");

package/src/global-account/client-manager.ts

@@ -2,7 +2,7 @@ import { ClientApplication, createClient } from "@b3dotfun/b3-api";
 import rest from "@feathersjs/rest-client";
 import socketio from "@feathersjs/socketio-client";
 import io from "socket.io-client";
-import { authenticate as authenticateB3, B3_API_URL, clientOptions } from "../app.shared";
+import { authenticate as authenticateB3, getB3ApiUrl, clientOptions } from "../app.shared";
 
 export type ClientType = "socket" | "rest";
 
@@ -13,17 +13,53 @@ let currentClient: ClientApplication | null = null;
 // Socket client instance
 let socketClient: ClientApplication | null = null;
 let socketInstance: any = null;
+let socketClientUrl: string | null = null;
 
 // REST client instance
 let restClient: ClientApplication | null = null;
+let restClientUrl: string | null = null;
+
+// The pinned @b3dotfun/b3-api client's generated usersMethods predates `setBio`,
+// so `users.setBio(...)` throws "setBio is not a function". Re-register the users
+// service with the full list (mirrors users.shared.ts). Remove once the
+// @b3dotfun/b3-api pin includes setBio.
+const USERS_METHODS = [
+  "find",
+  "get",
+  "create",
+  "patch",
+  "remove",
+  "setReferralCode",
+  "syncTwProfiles",
+  "setAvatar",
+  "setBio",
+  "registerUsername",
+  "getMe",
+];
+
+// Re-register on every client the manager builds — the active transport
+// (REST/socket) switches at runtime.
+function ensureUsersCustomMethods(client: ClientApplication): void {
+  try {
+    const connection = (client as any).get("connection");
+    if (connection?.service) {
+      (client as any).use("users", connection.service("users"), { methods: USERS_METHODS });
+    }
+  } catch {
+    // Non-fatal: keep whatever methods the generated client already exposes.
+  }
+}
 
 /**
  * Creates a socket client
  */
 function createSocketClient(): ClientApplication {
-  if (!socketClient) {
-    socketInstance = io(B3_API_URL, { transports: ["websocket"] });
+  const url = getB3ApiUrl();
+  if (!socketClient || socketClientUrl !== url) {
+    socketInstance = io(url, { transports: ["websocket"] });
     socketClient = createClient(socketio(socketInstance), clientOptions);
+    ensureUsersCustomMethods(socketClient);
+    socketClientUrl = url;
   }
   return socketClient;
 }
@@ -40,13 +76,25 @@ function resolveFetch(): typeof fetch {
 }
 
 function createRestClient(): ClientApplication {
-  if (!restClient) {
-    const connection = rest(B3_API_URL).fetch(resolveFetch());
+  const url = getB3ApiUrl();
+  if (!restClient || restClientUrl !== url) {
+    const connection = rest(url).fetch(resolveFetch());
     restClient = createClient(connection, clientOptions);
+    ensureUsersCustomMethods(restClient);
+    restClientUrl = url;
   }
   return restClient;
 }
 
+/** Reset all cached clients (called when API URL changes). */
+export function resetClients(): void {
+  socketClient = null;
+  socketClientUrl = null;
+  restClient = null;
+  restClientUrl = null;
+  currentClient = null;
+}
+
 /**
  * Sets the active client type and creates the appropriate client
  *
@@ -99,7 +147,11 @@ export function resetSocket(): void {
 /**
  * Authenticates with the current active client
  */
-export const authenticate = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticate = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<Record<string, any> | null> => {
   return authenticateB3(getClient(), accessToken, identityToken, params);
 };
 
@@ -111,7 +163,7 @@ export const authenticateWithClient = async (
   accessToken: string,
   identityToken: string,
   params?: Record<string, any>,
-) => {
+): Promise<Record<string, any> | null> => {
   const client = getClientByType(clientType);
   return authenticateB3(client, accessToken, identityToken, params);
 };
@@ -119,7 +171,15 @@ export const authenticateWithClient = async (
 /**
  * Authenticates with both clients in parallel (useful for migration scenarios)
  */
-export const authenticateBoth = async (accessToken: string, identityToken: string, params?: Record<string, any>) => {
+export const authenticateBoth = async (
+  accessToken: string,
+  identityToken: string,
+  params?: Record<string, any>,
+): Promise<{
+  socket: Record<string, any> | null;
+  rest: Record<string, any> | null;
+  success: boolean;
+}> => {
   const [socketResult, restResult] = await Promise.allSettled([
     authenticateWithClient("socket", accessToken, identityToken, params),
     authenticateWithClient("rest", accessToken, identityToken, params),
@@ -135,7 +195,12 @@ export const authenticateBoth = async (accessToken: string, identityToken: strin
 /**
  * Switches the client type and authenticates
  */
-export async function switchClientAndAuth(type: ClientType, access: string, id: string, params?: any) {
+export async function switchClientAndAuth(
+  type: ClientType,
+  access: string,
+  id: string,
+  params?: any,
+): Promise<Record<string, any> | null> {
   setClientType(type);
   return authenticateWithClient(type, access, id, params);
 }

package/src/global-account/react/components/AvatarEditor/AvatarEditor.tsx

@@ -13,7 +13,7 @@ import { validateImageUrl } from "@b3dotfun/sdk/global-account/react/utils/profi
 import { cn } from "@b3dotfun/sdk/shared/utils/cn";
 import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
 import { getIpfsUrl } from "@b3dotfun/sdk/shared/utils/ipfs";
-import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
+import { uploadFile as uploadToB3 } from "@b3dotfun/sdk/shared/utils/upload";
 import { Loader2, Upload, X } from "lucide-react";
 import { useCallback, useRef, useState } from "react";
 import type { Area } from "react-easy-crop";
@@ -21,7 +21,6 @@ import Cropper from "react-easy-crop";
 import "react-easy-crop/react-easy-crop.css";
 
 import { useActiveAccount } from "thirdweb/react";
-import { upload } from "thirdweb/storage";
 import { useModalStore } from "../../stores";
 import ModalHeader from "../ModalHeader/ModalHeader";
 
@@ -243,22 +242,18 @@ export function AvatarEditor({ onSetAvatar, className }: AvatarEditorProps) {
         }
       }
 
-      // Upload to IPFS if we have a file
+      // Upload file if we have one
       if (fileToUpload) {
-        debug("Starting upload to IPFS", fileToUpload);
+        debug("Starting upload", fileToUpload);
 
-        // Upload to IPFS using Thirdweb
-        const ipfsUrl = await upload({
-          client,
-          files: [fileToUpload],
-        });
+        const avatarUrl = await uploadToB3(fileToUpload);
 
-        debug("Upload successful", ipfsUrl);
+        debug("Upload successful", avatarUrl);
 
         // Save avatar URL using profiles service
         const user = await app.service("users").setAvatar(
           {
-            avatar: ipfsUrl,
+            avatar: avatarUrl,
           },
           // @ts-expect-error - our typed client is expecting context even though it's set elsewhere
           {},

package/src/global-account/react/components/B3Provider/B3ConfigProvider.tsx

@@ -84,3 +84,15 @@ export function useB3Config(): B3ConfigContextType {
   }
   return context;
 }
+
+/**
+ * Overrides ONLY `partnerId` for a subtree, inheriting every other config value from the parent
+ * B3ConfigProvider. Lets a single route attribute its AnySpend orders/quotes to a different partner
+ * (e.g. `/b3os-deposit` → the b3os partner) without standing up a second B3Provider — the config
+ * context is separate from the wallet/modal machinery, so nothing re-initializes. Must be rendered
+ * inside an existing B3ConfigProvider.
+ */
+export function B3ConfigPartnerOverride({ partnerId, children }: { partnerId: string; children: React.ReactNode }) {
+  const parent = useB3Config();
+  return <B3ConfigContext.Provider value={{ ...parent, partnerId }}>{children}</B3ConfigContext.Provider>;
+}

package/src/global-account/react/components/B3Provider/B3Provider.tsx

@@ -11,7 +11,10 @@ import { QueryClient } from "@tanstack/react-query";
 import { useEffect, useMemo } from "react";
 import { Account, EIP1193, Wallet } from "thirdweb/wallets";
 import { CreateConnectorFn } from "wagmi";
-import { ClientType, setClientType } from "../../../client-manager";
+import { ClientType, resetClients, setClientType } from "../../../client-manager";
+import { setB3ApiUrl } from "../../../../app.shared";
+import { setApiUrl as setNotificationsApiUrl } from "../../../../notifications/services/api";
+import { resetBetterAuthClient } from "../../../better-auth-client";
 import { StyleRoot } from "../StyleRoot";
 import { setToastContext, ToastProvider, useToastContext } from "../Toast/index";
 import AuthenticationProvider from "./AuthenticationProvider";
@@ -19,6 +22,11 @@ import { B3ConfigProvider } from "./B3ConfigProvider";
 import BetterAuthProvider from "./BetterAuthProvider";
 import { LocalSDKProvider } from "./LocalSDKProvider";
 
+const NOTIFICATIONS_URL_BY_ENV = {
+  development: "https://dev-notifications.b3.fun",
+  production: "https://notifications.b3.fun",
+} as const;
+
 /**
  * Main B3Provider component
  */
@@ -29,7 +37,6 @@ export function B3Provider({
   environment,
   automaticallySetFirstEoa,
   defaultEoaProvider,
-  simDuneApiKey,
   // deprecated since v0.0.87
   toaster: _toaster,
   clientType = "rest",
@@ -45,6 +52,8 @@ export function B3Provider({
   disableBSMNTAuthentication = false,
   queryClient,
   authStrategy = "thirdweb",
+  apiUrl,
+  notificationsApiUrl,
 }: {
   theme: "light" | "dark";
   children: React.ReactNode;
@@ -53,7 +62,6 @@ export function B3Provider({
   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";
     style?: React.CSSProperties;
@@ -74,7 +82,35 @@ export function B3Provider({
   queryClient?: QueryClient;
   /** Auth strategy: "thirdweb" (default, ecosystem wallet) or "better-auth" (email/password via Better Auth) */
   authStrategy?: AuthStrategy;
+  /**
+   * Override the B3 API URL. When provided, all SDK requests (auth, Feathers,
+   * BetterAuth) will use this URL instead of the `NEXT_PUBLIC_B3_API` env var.
+   *
+   * Useful for local development: pass `http://localhost:3031` to route
+   * OAuth callbacks and session checks through your local B3 API.
+   * If omitted, defaults to `NEXT_PUBLIC_B3_API` or `https://api.b3.fun`.
+   */
+  apiUrl?: string;
+  /** Override the notifications worker URL. Defaults to `https://notifications.b3.fun`. */
+  notificationsApiUrl?: string;
 }) {
+  // Override the B3 API URL when the `apiUrl` prop is provided.
+  // Must run before client initialization and auth providers mount.
+  useEffect(() => {
+    setB3ApiUrl(apiUrl ?? null);
+    if (apiUrl) {
+      resetBetterAuthClient();
+      resetClients();
+    }
+    return () => {
+      setB3ApiUrl(null);
+    };
+  }, [apiUrl]);
+
+  useEffect(() => {
+    setNotificationsApiUrl(notificationsApiUrl ?? NOTIFICATIONS_URL_BY_ENV[environment ?? "production"]);
+  }, [notificationsApiUrl, environment]);
+
   // Initialize Google Analytics on mount
   useEffect(() => {
     loadGA4Script();
@@ -112,7 +148,7 @@ export function B3Provider({
               authStrategy={authStrategy}
             >
               <ToastContextConnector />
-              <RelayKitProviderWrapper simDuneApiKey={simDuneApiKey}>
+              <RelayKitProviderWrapper>
                 {children}
                 {/* For the modal https://github.com/b3-fun/b3/blob/main/packages/sdk/src/global-account/react/components/ui/dialog.tsx#L46 */}
                 <StyleRoot id="b3-root" />