@b3dotfun/sdk 0.1.69 → 0.1.70-alpha.10

package/src/global-account/react/stores/useModalStore.ts

@@ -44,6 +44,8 @@ export interface SignInWithB3ModalProps extends BaseModalProps {
   source?: "signInWithB3Button" | "requestPermissions";
   /** Whether to show the signers enabled modal */
   signersEnabled?: boolean;
+  /** URL Better Auth redirects to after server-side email verification. */
+  verifyEmailRedirectTo?: string;
 }
 
 /**
@@ -139,6 +141,8 @@ export interface AnySpendModalProps extends BaseModalProps {
   disableUrlParamManagement?: boolean;
   /** Staging environment support */
   isStaging?: boolean;
+  /** Whether to show the "Pay with Fiat" tab. Defaults to true. When false, the fiat tab is hidden and activeTab is forced to "crypto". */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -156,6 +160,8 @@ export interface AnySpendNftProps extends BaseModalProps {
   onSuccess?: (txHash?: string) => void;
   /** Client-provided reference ID for tracking orders */
   clientReferenceId?: string;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -234,6 +240,8 @@ export interface AnySpendStakeB3Props extends BaseModalProps {
   stakeAmount?: string;
   /** Callback function called when the stake is successful */
   onSuccess?: () => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -249,6 +257,8 @@ export interface AnySpendStakeB3ExactInProps extends BaseModalProps {
   stakeAmount?: string;
   /** Callback function called when the stake is successful */
   onSuccess?: () => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -270,6 +280,8 @@ export interface AnySpendStakeUpsideProps extends BaseModalProps {
   activeTab?: "crypto" | "fiat";
   /** Callback function called when the stake is successful */
   onSuccess?: () => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -287,6 +299,8 @@ export interface AnySpendStakeUpsideExactInProps extends BaseModalProps {
   token: components["schemas"]["Token"];
   /** Callback function called when the stake is successful */
   onSuccess?: () => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -310,6 +324,8 @@ export interface AnySpendDepositUpsideProps extends BaseModalProps {
   destinationTokenAmount?: string;
   /** Callback function called when the deposit is successful */
   onSuccess?: () => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -329,6 +345,8 @@ export interface AnySpendBuySpinProps extends BaseModalProps {
   onSuccess?: (txHash?: string) => void;
   /** Prefill quantity of spins to purchase */
   prefillQuantity?: string;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -344,6 +362,8 @@ export interface AnySpendSignatureMintProps extends BaseModalProps {
   imageUrl?: string;
   /** Callback function called when minting is successful */
   onSuccess?: (txHash?: string) => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -369,6 +389,8 @@ export interface AnySpendBondKitProps extends BaseModalProps {
   b3Amount?: string;
   /** Callback function called when purchase is successful */
   onSuccess?: (txHash?: string) => void;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export interface LinkAccountModalProps extends BaseModalProps {
@@ -418,6 +440,8 @@ export interface AnySpendDepositHypeProps extends BaseModalProps {
   customRecipientLabel?: string;
   /** Custom label for the return home button (overrides "Return to Home" / "Close") */
   returnHomeLabel?: string;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export interface AvatarEditorModalProps extends BaseModalProps {
@@ -451,6 +475,16 @@ export interface SendModalProps extends BaseModalProps {
   onSuccess?: (txHash?: string) => void;
 }
 
+/**
+ * Props for the Session Duration modal
+ * Allows users to configure how long they stay signed in
+ */
+export interface SessionDurationModalProps extends BaseModalProps {
+  type: "sessionDuration";
+  partnerId: string;
+  chain: Chain;
+}
+
 /**
  * Props for the Notifications modal
  * Allows users to manage notification settings and channels
@@ -499,6 +533,8 @@ export interface AnySpendCollectorClubPurchaseProps extends BaseModalProps {
   isStaging?: boolean;
   /** Optional discount code to apply to the purchase */
   discountCode?: string;
+  /** Whether to show the "Pay with fiat" tab. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 /**
@@ -557,6 +593,8 @@ export interface AnySpendCheckoutTriggerModalProps extends BaseModalProps {
   returnUrl?: string;
   /** Label for the return button */
   returnLabel?: string;
+  /** Whether to show fiat payment options (card + coinbase). Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export interface AnySpendWorkflowTriggerModalProps extends BaseModalProps {
@@ -586,6 +624,8 @@ export interface AnySpendWorkflowTriggerModalProps extends BaseModalProps {
   actionLabel?: string;
   /** Custom class names */
   classes?: AnySpendAllClasses;
+  /** Whether to show fiat payment option. Defaults to true. */
+  showFiatOption?: boolean;
 }
 
 export interface AnySpendDepositModalProps extends BaseModalProps {
@@ -625,6 +665,8 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
   actionLabel?: string;
   /** Whether to show chain selection step. Defaults to true if sourceTokenChainId is not provided */
   showChainSelection?: boolean;
+  /** Whether to show the "Fund with Fiat" option in the deposit options list. Defaults to true */
+  showFiatOption?: boolean;
   /** Minimum pool size for filtering tokens (default: 1,000,000) */
   minPoolSize?: number;
   /** Custom title for chain selection step */
@@ -677,6 +719,7 @@ export type ModalContentType =
   | DepositModalProps
   | SendModalProps
   | NotificationsModalProps
+  | SessionDurationModalProps
   | AnySpendCollectorClubPurchaseProps
   | AnySpendDepositModalProps
   | AnySpendWorkflowTriggerModalProps

package/src/global-account/react/utils/createWagmiConfig.tsx

@@ -1,9 +1,8 @@
+import { createWalletConfig } from "@b3dotfun/sdk/wallet/utils/createWalletConfig";
 import { ecosystemWalletId } from "@b3dotfun/sdk/shared/constants";
-import { supportedChains } from "@b3dotfun/sdk/shared/constants/chains/supported";
 import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
 import { inAppWalletConnector } from "@thirdweb-dev/wagmi-adapter";
-import { http } from "viem";
-import { createConfig, type CreateConnectorFn } from "wagmi";
+import type { CreateConnectorFn } from "wagmi";
 
 export interface CreateWagmiConfigOptions {
   partnerId: string;
@@ -13,7 +12,8 @@ export interface CreateWagmiConfigOptions {
 }
 
 /**
- * Creates a wagmi config with optional custom RPC URLs and connectors
+ * Creates a wagmi config with the B3 ecosystem wallet connector.
+ * Delegates to createWalletConfig and adds the ecosystem connector on top.
  * @param options.partnerId - Partner ID for the ecosystem wallet
  * @param options.rpcUrls - Optional mapping of chain IDs to RPC URLs
  * @param options.connectors - Additional connectors to include
@@ -32,27 +32,8 @@ export function createWagmiConfig(options: CreateWagmiConfigOptions) {
 
   const finalConnectors = overrideDefaultConnectors ? connectors : [...defaultConnectors, ...connectors];
 
-  return createConfig({
-    chains: [supportedChains[0], ...supportedChains.slice(1)],
-    transports: Object.fromEntries(supportedChains.map(chain => [chain.id, http(rpcUrls?.[chain.id])])),
+  return createWalletConfig({
     connectors: finalConnectors,
+    rpcUrls,
   });
 }
-
-/** Module-level cache — wagmi configs must not be recreated on every render. */
-const wagmiConfigCache = new Map<string, ReturnType<typeof createWagmiConfig>>();
-
-/**
- * Returns a cached wagmi config for the given partnerId.
- * Use this instead of calling createWagmiConfig() directly inside React components or hooks
- * to avoid registering duplicate EventEmitter listeners on every render.
- */
-export function getCachedWagmiConfig(options: CreateWagmiConfigOptions) {
-  const key = options.partnerId;
-  let config = wagmiConfigCache.get(key);
-  if (!config) {
-    config = createWagmiConfig(options);
-    wagmiConfigCache.set(key, config);
-  }
-  return config;
-}

package/src/global-account/react/utils/index.ts

@@ -1,4 +1,3 @@
 export * from "./notificationsAPI";
 export * from "./profileDisplay";
 export * from "./toast";
-export * from "./updateAvatar";

package/src/global-account/react/utils/profileDisplay.ts

@@ -3,6 +3,21 @@ import { type Profile } from "thirdweb/wallets";
 
 const debug = debugB3React("profileDisplay");
 
+const ALLOWED_IPFS_GATEWAYS = [
+  "ipfs.io",
+  "gateway.pinata.cloud",
+  "cloudflare-ipfs.com",
+  "dweb.link",
+  "nftstorage.link",
+  "w3s.link",
+];
+
+const BLOCKED_HOSTNAMES = ["models.readyplayer.me", "readyplayer.me"];
+
+function isHostnameInList(hostname: string, list: string[]): boolean {
+  return list.some(entry => hostname === entry || hostname.endsWith(`.${entry}`));
+}
+
 /**
  * Validates that an image URL uses an allowed schema
  * @param url - The URL to validate
@@ -31,30 +46,17 @@ export function validateImageUrl(url: string | null | undefined): string | null
       return null;
     }
 
-    // Whitelist of allowed IPFS gateway hostnames
-    const allowedIpfsGateways = [
-      "ipfs.io",
-      "gateway.pinata.cloud",
-      "cloudflare-ipfs.com",
-      "dweb.link",
-      "nftstorage.link",
-      "w3s.link",
-    ];
-
-    // Check if hostname matches allowed IPFS gateways
     const hostname = parsedUrl.hostname.toLowerCase();
-    const isAllowedIpfsGateway = allowedIpfsGateways.some(gateway => {
-      // Exact match or subdomain of the gateway
-      return hostname === gateway || hostname.endsWith(`.${gateway}`);
-    });
 
-    if (isAllowedIpfsGateway) {
+    if (isHostnameInList(hostname, ALLOWED_IPFS_GATEWAYS)) {
       return url;
     }
 
-    // For standard HTTP(S) URLs from trusted sources
-    // Add additional hostname validation here if needed
-    // For now, allow all HTTP(S) URLs (can be restricted further if needed)
+    if (isHostnameInList(hostname, BLOCKED_HOSTNAMES)) {
+      debug("Rejected deprecated avatar service:", hostname, url);
+      return null;
+    }
+
     return url;
   } catch (error) {
     // Invalid URL format

package/src/global-account/types/b3-api.types.ts

@@ -10,11 +10,14 @@ type ObjectId = string;
 
 // Partner IDs interface
 interface PartnerIds {
+  /** @deprecated Privy is no longer used for authentication. This field exists for legacy data compatibility only. */
   privyId?: string;
   thirdwebId?: string;
 }
 
-// Privy linked account interface
+/**
+ * @deprecated Privy is no longer used for authentication. This type exists for legacy data compatibility only.
+ */
 interface PrivyLinkedAccount {
   type: string; // "wallet" | "smart_wallet" | "google_oauth"
   address?: string;
@@ -76,6 +79,7 @@ interface User {
 
   // Partner integrations
   partnerIds: PartnerIds;
+  /** @deprecated Privy is no longer used for authentication. This field exists for legacy data compatibility only. */
   privyLinkedAccounts?: PrivyLinkedAccount[];
   twProfiles?: TWProfile[];
 }

package/src/notifications/services/api.ts

@@ -8,6 +8,7 @@ import type {
   UserData,
 } from "../types";
 
+// Hardcoded default; consumers override via `B3Provider.notificationsApiUrl`.
 const DEFAULT_API_URL = "https://notifications.b3.fun";
 
 let apiUrl: string = DEFAULT_API_URL;

package/src/shared/constants/chains/b3Chain.ts

@@ -1,6 +1,5 @@
 import { defineChain as defineThirdwebChain, Chain as ThirdwebChain } from "thirdweb";
 import { Chain, defineChain } from "viem";
-import { ChainNetworks } from "@b3dotfun/sdk/global-account/types/chain-networks";
 
 export const nullAddress = "0x0000000000000000000000000000000000000000";
 
@@ -84,28 +83,6 @@ export const b3Mainnet = defineChain({
   },
 });
 
-export const getViemChainConfig = (config: ChainNetworks) =>
-  defineChain({
-    id: config.id,
-    name: config.name,
-    rpc: config.rpcUrls.default.http,
-    rpcUrls: {
-      default: {
-        http: [config.rpcUrls.default.http],
-        ws: [config.rpcUrls.default.ws],
-      },
-    },
-    icon: config.icon,
-    blockExplorers: {
-      default: {
-        name: config.blockExplorers.explorerTitle,
-        url: config.blockExplorers.default,
-      },
-    },
-    nativeCurrency: config.nativeCurrency,
-    testnet: config.testnet ? true : undefined,
-  });
-
 export const thirdwebB3Testnet: ThirdwebChain = defineThirdwebChain({
   id: 1993,
   name: "B3 Sepolia",
@@ -133,7 +110,7 @@ export const thirdwebB3Testnet: ThirdwebChain = defineThirdwebChain({
 export const thirdwebB3Mainnet: ThirdwebChain = defineThirdwebChain({
   id: 8333,
   name: "B3",
-  rpc: "https://mainnet-rpc.b3.fun/http",
+  rpc: "https://mainnet-rpc.b3.fun",
   icon: {
     url: "https://cdn.b3.fun/b3_logo.svg",
     width: 32,
@@ -153,22 +130,6 @@ export const thirdwebB3Mainnet: ThirdwebChain = defineThirdwebChain({
   },
 });
 
-export const getThirdwebChainConfig = (config: ChainNetworks): ThirdwebChain =>
-  defineThirdwebChain({
-    id: config.id,
-    name: config.name,
-    rpc: config.rpcUrls.default.http,
-    icon: config.icon,
-    blockExplorers: [
-      {
-        name: config.blockExplorers.explorerTitle,
-        url: config.blockExplorers.default,
-      },
-    ],
-    nativeCurrency: config.nativeCurrency,
-    testnet: config.testnet ? true : undefined,
-  });
-
 export const b3Chain = process.env.NEXT_PUBLIC_B3_CHAINID === "8333" ? b3Mainnet : b3Testnet;
 export const thirdwebB3Chain: ThirdwebChain =
   process.env.NEXT_PUBLIC_B3_CHAINID === "8333" ? thirdwebB3Mainnet : thirdwebB3Testnet;

package/src/shared/constants/chains/b3Viem.ts

@@ -0,0 +1,18 @@
+import { B3_PUBLIC_RPC } from "@b3dotfun/sdk/anyspend/constants/rpc";
+import type { Chain } from "viem";
+import { b3 as viemB3 } from "viem/chains";
+
+/**
+ * Viem's built-in `b3` chain points at mainnet-rpc.b3.fun; we spread it and override
+ * RPC URLs so all SDK call sites stay aligned with {@link B3_PUBLIC_RPC}.
+ */
+export const b3Viem: Chain = {
+  ...viemB3,
+  rpcUrls: {
+    ...viemB3.rpcUrls,
+    default: {
+      ...viemB3.rpcUrls.default,
+      http: [B3_PUBLIC_RPC],
+    },
+  },
+};

package/src/shared/constants/chains/supported.ts

@@ -1,75 +1,36 @@
-import type { ChainNetworks } from "@b3dotfun/sdk/global-account/types/chain-networks";
+import { ANYSPEND_EVM_CHAINS } from "@b3/chain-registry";
 import { toThirdwebChain, toViemChain } from "@b3dotfun/sdk/shared/utils/chain-transformers";
 import invariant from "invariant";
-
 import type { Chain as ThirdwebChain } from "thirdweb";
-// Import the JSON directly
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore
-import chainNetworksJSON from "../../generated/chain-networks.json" with { type: "json" };
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 import coingeckoChainsJSON from "../../generated/coingecko-chains.json" with { type: "json" };
 
-const chainNetworks = chainNetworksJSON as ChainNetworks[];
-
-// Convert custom chains to Viem format
-const viemChains = chainNetworks.map(toViemChain);
-
-// TODO: link to doc explaining why we don't support all chains and how to add more
-// These are the chains that are supported for things such as bridging and fetching balances
-export const supportedChains = [...viemChains];
-
-// ThirdWeb format chains
-export const supportedChainsTW: ThirdwebChain[] = [
-  ...chainNetworks
-    .map(chain => {
-      const networkData = chainNetworks.find(n => n.id === chain.id);
-      return networkData ? toThirdwebChain(networkData) : undefined;
-    })
-    .filter((chain): chain is NonNullable<typeof chain> => chain !== undefined),
-];
+export const supportedChains = ANYSPEND_EVM_CHAINS.map(toViemChain);
+export const supportedChainsTW: ThirdwebChain[] = ANYSPEND_EVM_CHAINS.map(toThirdwebChain);
+export const supportedChainNetworks = ANYSPEND_EVM_CHAINS;
 
-// Original format from chain-networks.json
-export const supportedChainNetworks = chainNetworks;
-
-// CoinGecko chain mapping
 export const coingeckoChains = coingeckoChainsJSON as Record<
   number,
-  {
-    coingecko_id: string;
-    name: string;
-    native_coin_id: string;
-  }
+  { coingecko_id: string; name: string; native_coin_id: string }
 >;
-// Helper function to get CoinGecko chain info
+
 export function getCoingeckoChainInfo(chainId: number) {
   return coingeckoChains[chainId];
 }
 
-const _b3MainnetThirdWeb: ThirdwebChain | undefined = supportedChainsTW.find(chain => chain.id === 8333);
+const _b3MainnetThirdWeb = supportedChainsTW.find(c => c.id === 8333);
 invariant(_b3MainnetThirdWeb, "B3 mainnet chain not found in supported chains TW");
 export const b3MainnetThirdWeb = _b3MainnetThirdWeb;
 
-const _b3TestnetThirdWeb: ThirdwebChain | undefined = supportedChainsTW.find(chain => chain.id === 1993);
-invariant(_b3TestnetThirdWeb, "B3 testnet chain not found in supported chains TW");
-export const b3TestnetThirdWeb = _b3TestnetThirdWeb;
-
-const _b3Mainnet = supportedChains.find(chain => chain.id === 8333);
+const _b3Mainnet = supportedChains.find(c => c.id === 8333);
 invariant(_b3Mainnet, "B3 mainnet chain not found in supported chains");
 export const b3Mainnet = _b3Mainnet;
 
-const _b3Testnet = supportedChains.find(chain => chain.id === 1993);
-invariant(_b3Testnet, "B3 testnet chain not found in supported chains");
-export const b3Testnet = _b3Testnet;
-
-const _baseMainnet = supportedChains.find(chain => chain.id === 8453);
+const _baseMainnet = supportedChains.find(c => c.id === 8453);
 invariant(_baseMainnet, "Base mainnet chain not found in supported chains");
 export const baseMainnet = _baseMainnet;
 
-/**
- * Get a Thirdweb chain by chain ID from supportedChainsTW
- */
 export function getThirdwebChain(chainId: number): ThirdwebChain {
   const chain = supportedChainsTW.find(c => c.id === chainId);
   if (!chain) {

package/src/shared/constants/index.ts

@@ -32,3 +32,5 @@ export const B3_AUTH_COOKIE_NAME = "b3-auth";
 export const ENS_GATEWAY_URL = "https://ens-gateway.b3.fun/";
 
 export const PUBLIC_BASE_RPC_URL = "https://base-rpc.publicnode.com";
+
+export const AVATAR_COLORS = ["#3368ef", "#272727", "#6366f1", "#06b6d4", "#eeb0d9", "#ba3fbf", "#ff777b", "#dfbb53"];

package/src/shared/utils/chain-transformers.ts

@@ -1,51 +1,53 @@
-import type { ChainNetworks } from "@b3dotfun/sdk/global-account/types/chain-networks";
+import type { ChainDefinition } from "@b3/chain-registry";
 import type { Chain as ThirdwebChain } from "thirdweb";
 import { defineChain as defineThirdwebChain } from "thirdweb";
-import { Chain } from "viem";
+import type { Chain } from "viem";
 
-export function toViemChain(network: ChainNetworks): Chain {
+// fallbackRpc is validated non-null at chain-registry module init for every
+// anyspend EVM chain (see ANYSPEND_EVM_CHAINS in @b3/chain-registry). Callers
+// outside the anyspend EVM set must ensure their own data shape.
+
+// Derive icon format from URL extension. Thirdweb chain config carries an
+// explicit `format` field; the old chain-networks.json had per-chain values
+// (svg/png/etc.) but @b3/chain-registry only stores `logoUrl`. URL extension
+// is reliable across our current chain set — 9/11 anyspend chains use .png
+// (trustwallet/relay/coinmarketcap), 2 use .svg (Base, Plume from cdn.b3.fun).
+function inferIconFormat(url: string): string {
+  const match = url.toLowerCase().match(/\.([a-z0-9]+)(?:\?|#|$)/);
+  const ext = match?.[1];
+  if (ext === "png" || ext === "jpg" || ext === "jpeg" || ext === "gif" || ext === "webp") return ext;
+  return "svg";
+}
+
+export function toViemChain(chain: ChainDefinition): Chain {
+  if (!chain.fallbackRpc) {
+    throw new Error(`toViemChain: chain ${chain.chainId} (${chain.key}) has no fallbackRpc`);
+  }
   return {
-    id: network.id,
-    name: network.name,
-    nativeCurrency: network.nativeCurrency,
-    rpcUrls: {
-      default: {
-        http: [network.rpcUrls.default.http],
-        webSocket: network.rpcUrls.default.ws ? [network.rpcUrls.default.ws] : undefined,
-      },
-    },
+    id: chain.chainId,
+    name: chain.name,
+    nativeCurrency: chain.nativeCurrency,
+    rpcUrls: { default: { http: [chain.fallbackRpc] } },
     blockExplorers: {
-      default: {
-        name: network.blockExplorers.explorerTitle,
-        url: network.blockExplorers.default,
-      },
+      default: { name: `${chain.name} Explorer`, url: chain.explorer },
     },
-    contracts: network.contracts,
-    testnet: network.testnet,
-    sourceId: network.sourceId,
-    formatters: network.formatters,
-    fees: network.fees,
+    testnet: chain.isTestnet,
   };
 }
 
-export function toThirdwebChain(network: ChainNetworks): ThirdwebChain {
+export function toThirdwebChain(chain: ChainDefinition): ThirdwebChain {
+  if (!chain.fallbackRpc) {
+    throw new Error(`toThirdwebChain: chain ${chain.chainId} (${chain.key}) has no fallbackRpc`);
+  }
   return defineThirdwebChain({
-    id: network.id,
-    name: network.name,
-    nativeCurrency: network.nativeCurrency,
-    rpc: network.rpcUrls.default.http,
-    icon: {
-      url: network.icon.url,
-      width: network.icon.width,
-      height: network.icon.height,
-      format: network.icon.format,
-    },
-    blockExplorers: [
-      {
-        name: network.blockExplorers.explorerTitle,
-        url: network.blockExplorers.default,
-      },
-    ],
-    testnet: network.testnet ? true : undefined,
+    id: chain.chainId,
+    name: chain.name,
+    nativeCurrency: chain.nativeCurrency,
+    rpc: chain.fallbackRpc,
+    icon: chain.logoUrl
+      ? { url: chain.logoUrl, width: 32, height: 32, format: inferIconFormat(chain.logoUrl) }
+      : undefined,
+    blockExplorers: [{ name: `${chain.name} Explorer`, url: chain.explorer }],
+    testnet: chain.isTestnet ? true : undefined,
   });
 }

package/src/shared/utils/chains.ts

@@ -1,5 +1,6 @@
+import { b3Viem } from "@b3dotfun/sdk/shared/constants/chains/b3Viem";
 import { supportedChains } from "@b3dotfun/sdk/shared/constants/chains/supported";
-import { b3, Chain } from "viem/chains";
+import type { Chain } from "viem";
 
 const baseChainBaseUrl = "https://basescan.org";
 
@@ -13,7 +14,7 @@ export function chainIdToName(id: number) {
 }
 
 export function getExplorerUrl(chain: Chain, txHash: string): string {
-  if (chain.id === b3.id) {
+  if (chain.id === b3Viem.id) {
     return "https://explorer.b3.fun/b3/tx/" + txHash;
   }
   let baseUrl = chain.blockExplorers?.default.url;

package/src/shared/utils/session-duration.ts

@@ -0,0 +1,64 @@
+const STORAGE_KEY_PREFIX = "b3-session-duration";
+const DEFAULT_DAYS = 7;
+
+// 0 = session cookie (expires when browser closes)
+export const SESSION_DURATION_OPTIONS = [0, 1, 7, 14, 30] as const;
+export type SessionDurationDays = (typeof SESSION_DURATION_OPTIONS)[number];
+
+function storageKey(partnerId?: string) {
+  return partnerId ? `${STORAGE_KEY_PREFIX}_${partnerId}` : STORAGE_KEY_PREFIX;
+}
+
+/**
+ * Read session duration for a specific partner.
+ *
+ * preferences shape: { [partnerId]: { sessionDuration: number }, sessionDuration?: number }
+ *
+ * Priority: user.preferences[partnerId].sessionDuration
+ *           → user.preferences.sessionDuration (global fallback)
+ *           → localStorage (per-partner) → localStorage (global) → default 7d
+ */
+export function getSessionDurationDays(userPreferences?: Record<string, any>, partnerId?: string): SessionDurationDays {
+  if (userPreferences) {
+    if (partnerId) {
+      const v = userPreferences[partnerId]?.sessionDuration;
+      if (SESSION_DURATION_OPTIONS.includes(v as SessionDurationDays)) return v as SessionDurationDays;
+    }
+    const v = userPreferences["sessionDuration"];
+    if (SESSION_DURATION_OPTIONS.includes(v as SessionDurationDays)) return v as SessionDurationDays;
+  }
+  try {
+    if (partnerId) {
+      const stored = localStorage.getItem(storageKey(partnerId));
+      if (stored !== null) {
+        const parsed = Number(stored);
+        if (SESSION_DURATION_OPTIONS.includes(parsed as SessionDurationDays)) return parsed as SessionDurationDays;
+      }
+    }
+    const stored = localStorage.getItem(STORAGE_KEY_PREFIX);
+    if (stored !== null) {
+      const parsed = Number(stored);
+      if (SESSION_DURATION_OPTIONS.includes(parsed as SessionDurationDays)) return parsed as SessionDurationDays;
+    }
+  } catch {
+    // localStorage unavailable (e.g. SSR)
+  }
+  return DEFAULT_DAYS;
+}
+
+export const SESSION_DURATION_LABELS: Record<SessionDurationDays, string> = {
+  0: "Session only",
+  1: "1 day",
+  7: "7 days",
+  14: "14 days",
+  30: "30 days",
+};
+
+/** Cache the preference locally so it's available immediately on next login */
+export function setSessionDurationDays(days: SessionDurationDays, partnerId?: string): void {
+  try {
+    localStorage.setItem(storageKey(partnerId), String(days));
+  } catch {
+    // ignore
+  }
+}