@b3dotfun/sdk 0.1.69-test.0 → 0.1.70-alpha.1

package/dist/types/anyspend/react/components/AnySpendStakeUpside.d.ts

@@ -1,6 +1,6 @@
 import { components } from "@b3dotfun/sdk/anyspend/types/api";
 import type { AnySpendContent, AnySpendSlots, AnySpendTheme } from "./types/customization";
-export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, senderAddress, slots, content, theme, }: {
+export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddress, stakeAmount, stakingContractAddress, token, onSuccess, activeTab, senderAddress, slots, content, theme, showFiatOption, }: {
     loadOrder?: string;
     mode?: "modal" | "page";
     beneficiaryAddress: string;
@@ -14,4 +14,6 @@ export declare function AnySpendStakeUpside({ loadOrder, mode, beneficiaryAddres
     slots?: AnySpendSlots;
     content?: AnySpendContent;
     theme?: AnySpendTheme;
+    /** Whether to show the "Pay with fiat" tab. Defaults to true. */
+    showFiatOption?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/anyspend/react/components/checkout/CartItemRow.d.ts

@@ -1,7 +1,8 @@
+import type { ReactNode } from "react";
 import type { CheckoutItem, AnySpendCheckoutClasses } from "./AnySpendCheckout";
 interface CartItemRowProps {
     item: CheckoutItem;
-    formattedPrice: string;
+    formattedPrice: ReactNode;
     classes?: AnySpendCheckoutClasses;
 }
 export declare function CartItemRow({ item, formattedPrice, classes }: CartItemRowProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/anyspend/react/components/checkout/CartSummary.d.ts

@@ -1,8 +1,8 @@
-import type { AnySpendCheckoutClasses } from "./AnySpendCheckout";
-import type { CheckoutSummaryLine } from "./AnySpendCheckout";
+import { type ReactNode } from "react";
+import type { AnySpendCheckoutClasses, CheckoutSummaryLine } from "./AnySpendCheckout";
 interface CartSummaryProps {
     /** Formatted total (final amount after all adjustments) */
-    total: string;
+    total: ReactNode;
     tokenSymbol?: string;
     classes?: AnySpendCheckoutClasses;
     /** Formatted subtotal (sum of items only — shown when adjustments exist) */
@@ -25,6 +25,8 @@ interface CartSummaryProps {
     summaryLines?: CheckoutSummaryLine[];
     /** Formatted USD equivalent (e.g. "$5.56") — shown for non-stablecoin tokens */
     usdEquivalent?: string | null;
+    /** When true, hide adjustment rows and USD equivalent (caller passes a skeleton as `total`). */
+    pricesLoading?: boolean;
 }
-export declare function CartSummary({ total, tokenSymbol, classes, subtotal, tokenDecimals, shipping, tax, discount, summaryLines, usdEquivalent, }: CartSummaryProps): import("react/jsx-runtime").JSX.Element;
+export declare function CartSummary({ total, tokenSymbol, classes, subtotal, tokenDecimals, shipping, tax, discount, summaryLines, usdEquivalent, pricesLoading, }: CartSummaryProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/anyspend/react/components/checkout/CheckoutCartPanel.d.ts

@@ -5,6 +5,8 @@ interface CheckoutCartPanelProps {
     totalAmount: string;
     tokenSymbol?: string;
     tokenDecimals?: number;
+    /** True while token decimals/symbol are still loading — prevents rendering mis-decimalized prices. */
+    pricesLoading?: boolean;
     organizationName?: string;
     organizationLogo?: string;
     classes?: AnySpendCheckoutClasses;
@@ -28,5 +30,5 @@ interface CheckoutCartPanelProps {
     /** Formatted USD equivalent (e.g. "$5.56") — shown for non-stablecoin tokens */
     usdEquivalent?: string | null;
 }
-export declare function CheckoutCartPanel({ items, totalAmount, tokenSymbol, tokenDecimals, organizationName, organizationLogo, classes, footer, shipping, tax, discount, summaryLines, usdEquivalent, }: CheckoutCartPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function CheckoutCartPanel({ items, totalAmount, tokenSymbol, tokenDecimals, pricesLoading, organizationName, organizationLogo, classes, footer, shipping, tax, discount, summaryLines, usdEquivalent, }: CheckoutCartPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/anyspend/react/components/checkout/CheckoutFormPanel.d.ts

@@ -16,6 +16,8 @@ interface CheckoutFormPanelProps {
     /** Token info for display */
     tokenSymbol?: string;
     tokenDecimals?: number;
+    /** True while token decimals/symbol are still loading — prevents rendering mis-decimalized prices. */
+    pricesLoading?: boolean;
     /** CSS class overrides */
     classes?: AnySpendCheckoutClasses;
     /** Current form data (lifted state) */
@@ -35,5 +37,5 @@ interface CheckoutFormPanelProps {
     /** Slot overrides */
     checkoutFormSlot?: (props: CheckoutFormComponentProps) => React.ReactNode;
 }
-export declare function CheckoutFormPanel({ formSchema, formComponent: FormComponent, shippingOptions, collectShippingAddress, enableDiscountCode, validateDiscount, tokenSymbol, tokenDecimals, classes, formData, onFormDataChange, selectedShipping, onShippingChange, appliedDiscount, onDiscountApplied, onDiscountRemoved, shippingAddress, onShippingAddressChange, checkoutFormSlot, }: CheckoutFormPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CheckoutFormPanel({ formSchema, formComponent: FormComponent, shippingOptions, collectShippingAddress, enableDiscountCode, validateDiscount, tokenSymbol, tokenDecimals, pricesLoading, classes, formData, onFormDataChange, selectedShipping, onShippingChange, appliedDiscount, onDiscountApplied, onDiscountRemoved, shippingAddress, onShippingAddressChange, checkoutFormSlot, }: CheckoutFormPanelProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/types/anyspend/react/components/checkout/DiscountCodeInput.d.ts

@@ -6,7 +6,9 @@ interface DiscountCodeInputProps {
     loading?: boolean;
     tokenSymbol?: string;
     tokenDecimals?: number;
+    /** True while token decimals/symbol are still loading — renders applied amount as skeleton. */
+    pricesLoading?: boolean;
     className?: string;
 }
-export declare function DiscountCodeInput({ onApply, appliedDiscount, onRemove, loading, tokenSymbol, tokenDecimals, className, }: DiscountCodeInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function DiscountCodeInput({ onApply, appliedDiscount, onRemove, loading, tokenSymbol, tokenDecimals, pricesLoading, className, }: DiscountCodeInputProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/anyspend/react/components/checkout/PriceSkeleton.d.ts

@@ -0,0 +1,5 @@
+interface PriceSkeletonProps {
+    className?: string;
+}
+export declare function PriceSkeleton({ className }: PriceSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/anyspend/react/components/checkout/ShippingSelector.d.ts

@@ -5,7 +5,9 @@ interface ShippingSelectorProps {
     onSelect: (option: ShippingOption) => void;
     tokenSymbol?: string;
     tokenDecimals?: number;
+    /** True while token decimals/symbol are still loading — renders price as skeleton. */
+    pricesLoading?: boolean;
     className?: string;
 }
-export declare function ShippingSelector({ options, selectedId, onSelect, tokenSymbol, tokenDecimals, className, }: ShippingSelectorProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ShippingSelector({ options, selectedId, onSelect, tokenSymbol, tokenDecimals, pricesLoading, className, }: ShippingSelectorProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -15,8 +15,10 @@ export interface B3ConfigContextType {
     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, authStrategy, }: {
+export declare function B3ConfigProvider({ children, accountOverride, environment, defaultPermissions, automaticallySetFirstEoa, theme, clientType, partnerId, stripePublishableKey, createClientReferenceId, authStrategy, apiUrl, }: {
     children: React.ReactNode;
     accountOverride?: Account;
     environment?: "development" | "production";
@@ -28,5 +30,7 @@ export declare function B3ConfigProvider({ children, accountOverride, environmen
     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/types/global-account/react/components/B3Provider/B3Provider.d.ts

@@ -10,7 +10,7 @@ import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-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, }: {
+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;
@@ -39,4 +39,20 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     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/types/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/types/global-account/react/components/SignInWithB3/BetterAuthSignIn.d.ts

@@ -10,6 +10,11 @@ export interface BetterAuthSignInProps {
     showEmail?: boolean;
     /** URL to redirect to after password reset link is clicked. Token is appended as ?token=... */
     passwordResetRedirectTo?: string;
+    /**
+     * URL Better Auth redirects to after server-side email verification. Render
+     * `BetterAuthVerifyEmail` at this route so the user gets a confirmation page.
+     */
+    verifyEmailRedirectTo?: string;
     /** Called after successful authentication */
     onSuccess?: () => void;
     /** Called on authentication error */
@@ -31,4 +36,4 @@ export interface BetterAuthSignInProps {
  * />
  * ```
  */
-export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, verifyEmailRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.d.ts

@@ -0,0 +1,37 @@
+export type BetterAuthVerifyEmailState = "success" | "expired" | "invalid" | "already-verified" | "error";
+export interface BetterAuthVerifyEmailProps {
+    /**
+     * Error code from the callback URL's `?error=` query param. Pass `null` /
+     * `undefined` when the user landed here cleanly (successful verification).
+     * Better Auth appends this param when server-side verification fails.
+     */
+    errorCode?: string | null;
+    /** Called when the user clicks the "Go to sign in" button. */
+    onGoToSignIn?: () => void;
+    /** Fallback href used when `onGoToSignIn` is not provided. Defaults to "/login". */
+    signInHref?: string;
+    /** Optional override for the success headline. */
+    successTitle?: string;
+    /** Optional override for the success body text. */
+    successMessage?: string;
+    /** Optional class name for the root container. */
+    className?: string;
+}
+/**
+ * Standalone email-verification confirmation page. Render on the route you
+ * set as `callbackURL` when calling `betterAuthClient.sendVerificationEmail`
+ * (or the `verifyCallbackURL` arg on `useBetterAuth().signUpWithEmail`).
+ *
+ * Better Auth verifies the token server-side before redirecting here. This
+ * component only displays the outcome based on the `?error=` query param.
+ *
+ * Usage:
+ * ```tsx
+ * const error = new URLSearchParams(window.location.search).get("error");
+ * <BetterAuthVerifyEmail
+ *   errorCode={error}
+ *   onGoToSignIn={() => router.push("/login")}
+ * />
+ * ```
+ */
+export declare function BetterAuthVerifyEmail({ errorCode, onGoToSignIn, signInHref, successTitle, successMessage, className, }: BetterAuthVerifyEmailProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/global-account/react/components/SignInWithB3/SignInWithB3Flow.d.ts

@@ -3,4 +3,4 @@ import { SignInWithB3ModalProps } from "@b3dotfun/sdk/global-account/react";
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, verifyEmailRedirectTo, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/global-account/react/components/SignInWithB3/components/PasswordInput.d.ts

@@ -0,0 +1,10 @@
+interface PasswordInputProps {
+    value: string;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    disabled?: boolean;
+    placeholder?: string;
+    onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    className?: string;
+}
+export declare function PasswordInput({ value, onChange, disabled, placeholder, onKeyDown, className, }: PasswordInputProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.d.ts

@@ -1,6 +1,8 @@
 interface LoginStepBetterAuthProps {
     onSuccess?: () => void;
     onError?: (error: Error) => Promise<void>;
+    /** URL Better Auth redirects to after server-side email verification. */
+    verifyEmailRedirectTo?: string;
 }
-export declare function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

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

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

@@ -5,9 +5,11 @@ export { RelayKitProviderWrapper } from "./B3Provider/RelayKitProviderWrapper";
 export { useB3 } from "./B3Provider/useB3";
 export { useB3Account } from "./B3Provider/useB3Account";
 export { useB3Config } from "./B3Provider/useB3Config";
+export { useBetterAuthClient } from "./B3Provider/BetterAuthClientProvider";
 export { StyleRoot } from "./StyleRoot";
 export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
 export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";
+export { BetterAuthVerifyEmail, type BetterAuthVerifyEmailProps, type BetterAuthVerifyEmailState, } from "./SignInWithB3/BetterAuthVerifyEmail";
 export { AuthButton } from "./SignInWithB3/components/AuthButton";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem";
 export { WalletRow } from "./SignInWithB3/components/WalletRow";
@@ -17,6 +19,7 @@ export { SignInWithB3Privy } from "./SignInWithB3/SignInWithB3Privy";
 export { LoginStepContainer } from "./SignInWithB3/steps/LoginStep";
 export { getConnectOptionsFromStrategy, isWalletType, type AllowedStrategy } from "./SignInWithB3/utils/signInUtils";
 export { ManageAccount } from "./ManageAccount/ManageAccount";
+export { UserAvatar } from "./UserAvatar/UserAvatar";
 export { Deposit } from "./Deposit/Deposit";
 export { Send } from "./Send/Send";
 export { IPFSMediaRenderer } from "./IPFSMediaRenderer/IPFSMediaRenderer";

package/dist/types/global-account/react/hooks/useBetterAuth.d.ts

@@ -13,7 +13,7 @@ export declare class EmailVerificationRequiredError extends Error {
  */
 export declare function useBetterAuth(): {
     signInWithEmail: (email: string, password: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
-    signUpWithEmail: (email: string, password: string, name: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    signUpWithEmail: (email: string, password: string, name: string, verifyCallbackURL?: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
     signInWithSocial: (provider: BetterAuthSocialProvider) => Promise<void>;
     requestPasswordReset: (email: string, redirectTo?: string) => Promise<{
         data: {

package/dist/types/global-account/react/stores/useModalStore.d.ts

@@ -41,6 +41,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;
 }
 /**
  * Props for the Request Permissions modal
@@ -609,6 +611,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 */

package/dist/types/shared/constants/index.d.ts

@@ -16,3 +16,4 @@ export declare const CLIENT_APP_BUNDLE_ID: string;
 export declare const B3_AUTH_COOKIE_NAME = "b3-auth";
 export declare const ENS_GATEWAY_URL = "https://ens-gateway.b3.fun/";
 export declare const PUBLIC_BASE_RPC_URL = "https://base-rpc.publicnode.com";
+export declare const AVATAR_COLORS: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.69-test.0",
+  "version": "0.1.70-alpha.1",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",

package/src/anyspend/react/components/AnySpend.tsx

@@ -148,6 +148,8 @@ export function AnySpend(props: {
   theme?: AnySpendTheme;
   /** When true, shows a KYC gate before Stripe Web2 (credit card) payments. Default false. */
   kycEnabled?: 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;
 }) {
   const fingerprintConfig = getFingerprintConfig();
 
@@ -184,6 +186,7 @@ function AnySpendInner({
   callbackMetadata,
   senderAddress,
   kycEnabled = false,
+  showFiatOption = true,
 }: {
   sourceChainId?: number;
   destinationTokenAddress?: string;
@@ -211,6 +214,7 @@ function AnySpendInner({
   content?: AnySpendContent;
   theme?: AnySpendTheme;
   kycEnabled?: boolean;
+  showFiatOption?: boolean;
 }) {
   const { slots, content } = useAnySpendCustomization();
   const searchParams = useSearchParamsSSR();
@@ -253,6 +257,7 @@ function AnySpendInner({
   const previousPanel = useRef<PanelView>(PanelView.MAIN);
 
   const [activeTab, setActiveTab] = useState<"crypto" | "fiat">(() => {
+    if (!showFiatOption) return "crypto";
     if (typeof window !== "undefined") {
       const stored = sessionStorage.getItem("anyspend_active_tab") as "crypto" | "fiat" | null;
       if (stored === "crypto" || stored === "fiat") return stored;
@@ -261,8 +266,13 @@ function AnySpendInner({
   });
 
   useEffect(() => {
+    if (!showFiatOption && activeTab === "fiat") setActiveTab("crypto");
+  }, [showFiatOption, activeTab]);
+
+  useEffect(() => {
+    if (!showFiatOption) return;
     sessionStorage.setItem("anyspend_active_tab", activeTab);
-  }, [activeTab]);
+  }, [activeTab, showFiatOption]);
 
   const [orderId, setOrderId] = useState<string | undefined>(loadOrder);
   const [directTransferTxHash, setDirectTransferTxHash] = useState<string | undefined>();
@@ -1312,17 +1322,19 @@ function AnySpendInner({
         )}
 
         {/* Tab section */}
-        <TabSection
-          activeTab={activeTab}
-          setActiveTab={tab => {
-            setActiveTab(tab);
-            // Reset payment methods when switching tabs
-            resetPaymentMethods();
-            setSelectedFiatPaymentMethod(FiatPaymentMethod.NONE);
-          }}
-          setSelectedCryptoPaymentMethod={setSelectedCryptoPaymentMethod}
-          setSelectedFiatPaymentMethod={setSelectedFiatPaymentMethod}
-        />
+        {showFiatOption && (
+          <TabSection
+            activeTab={activeTab}
+            setActiveTab={tab => {
+              setActiveTab(tab);
+              // Reset payment methods when switching tabs
+              resetPaymentMethods();
+              setSelectedFiatPaymentMethod(FiatPaymentMethod.NONE);
+            }}
+            setSelectedCryptoPaymentMethod={setSelectedCryptoPaymentMethod}
+            setSelectedFiatPaymentMethod={setSelectedFiatPaymentMethod}
+          />
+        )}
 
         <div className="relative flex w-full max-w-[calc(100vw-32px)] flex-col gap-2">
           {/* Send section */}

package/src/anyspend/react/components/AnySpendCollectorClubPurchase.tsx

@@ -119,6 +119,10 @@ export interface AnySpendCollectorClubPurchaseProps {
    * Force fiat payment
    */
   forceFiatPayment?: boolean;
+  /**
+   * Whether to show the "Pay with fiat" tab. Defaults to true.
+   */
+  showFiatOption?: boolean;
   /**
    * Optional discount code to apply to the purchase.
    * When provided, validates on-chain and adjusts the price accordingly.
@@ -146,6 +150,7 @@ export function AnySpendCollectorClubPurchase({
   vendingMachineId,
   packType,
   forceFiatPayment,
+  showFiatOption = true,
   discountCode,
   slots,
   content,
@@ -398,6 +403,7 @@ export function AnySpendCollectorClubPurchase({
       showRecipient={showRecipient}
       srcFiatAmount={srcFiatAmount}
       forceFiatPayment={forceFiatPayment}
+      showFiatOption={showFiatOption}
       slots={slots}
       content={content}
       theme={theme}

package/src/anyspend/react/components/AnySpendCustom.tsx

@@ -178,6 +178,8 @@ export function AnySpendCustom(props: {
   dstToken: components["schemas"]["Token"];
   dstAmount: string;
   forceFiatPayment?: 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;
   contractAddress: string;
   encodedData: string;
   metadata: any;
@@ -232,6 +234,7 @@ function AnySpendCustomInner({
   onShowPointsDetail,
   srcFiatAmount: srcFiatAmountProps,
   forceFiatPayment,
+  showFiatOption = true,
   senderAddress,
 }: {
   loadOrder?: string;
@@ -258,6 +261,7 @@ function AnySpendCustomInner({
   onShowPointsDetail?: () => void;
   srcFiatAmount?: string;
   forceFiatPayment?: boolean;
+  showFiatOption?: boolean;
   senderAddress?: string;
   slots?: AnySpendSlots;
   content?: AnySpendContent;
@@ -271,7 +275,13 @@ function AnySpendCustomInner({
   const [activePanel, setActivePanel] = useState<PanelView>(
     loadOrder ? PanelView.ORDER_DETAILS : PanelView.CONFIRM_ORDER,
   );
-  const [activeTab, setActiveTab] = useState<"crypto" | "fiat">(forceFiatPayment ? "fiat" : activeTabProps);
+  const [activeTab, setActiveTab] = useState<"crypto" | "fiat">(
+    !showFiatOption ? "crypto" : forceFiatPayment ? "fiat" : activeTabProps,
+  );
+
+  useEffect(() => {
+    if (!showFiatOption && activeTab === "fiat") setActiveTab("crypto");
+  }, [showFiatOption, activeTab]);
 
   // Payment method state with dual-state system (auto + explicit user selection)
   // Note: AnySpendCustom doesn't use auto-selection, only explicit user selection
@@ -867,7 +877,7 @@ function AnySpendCustomInner({
         onValueChange={value => setActiveTab(value as "crypto" | "fiat")}
         className="bg-b3-react-background max-h-[60dvh] w-full overflow-y-auto p-5"
       >
-        {!forceFiatPayment && (
+        {!forceFiatPayment && showFiatOption && (
           <div className="w-full">
             <div className="bg-as-surface-secondary relative mb-4 grid h-10 grid-cols-2 rounded-xl">
               <div

package/src/anyspend/react/components/AnySpendDeposit.tsx

@@ -95,6 +95,8 @@ export interface AnySpendDepositProps {
   depositContractConfig?: DepositContractConfig;
   /** 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;
   /** Custom list of supported chains. If not provided, uses default chains */
   supportedChains?: ChainConfig[];
   /** Minimum pool size for filtering tokens (default: 1,000,000) */
@@ -248,6 +250,7 @@ export function AnySpendDeposit({
   orderType,
   depositContractConfig,
   showChainSelection,
+  showFiatOption = true,
   supportedChains = DEFAULT_SUPPORTED_CHAINS,
   minPoolSize = DEFAULT_MIN_POOL_SIZE,
   topChainsCount = 3,
@@ -585,39 +588,43 @@ export function AnySpendDeposit({
             </button>
 
             {/* Fund with Fiat */}
-            <button
-              onClick={handleSelectFiat}
-              className={
-                depositClasses?.fiatButton ||
-                "anyspend-deposit-option-button anyspend-deposit-fiat-button border-border-primary hover:border-as-brand hover:bg-as-surface-secondary flex w-full items-center justify-between rounded-xl border p-4 text-left transition-all"
-              }
-            >
-              <div
-                className={depositClasses?.optionContent || "anyspend-deposit-option-content flex items-center gap-3"}
+            {showFiatOption && (
+              <button
+                onClick={handleSelectFiat}
+                className={
+                  depositClasses?.fiatButton ||
+                  "anyspend-deposit-option-button anyspend-deposit-fiat-button border-border-primary hover:border-as-brand hover:bg-as-surface-secondary flex w-full items-center justify-between rounded-xl border p-4 text-left transition-all"
+                }
               >
-                <CreditCardIcon className={depositClasses?.optionIcon || "anyspend-deposit-option-icon h-10 w-10"} />
-                <div className={depositClasses?.optionInfo || "anyspend-deposit-option-info"}>
-                  <span
-                    className={
-                      depositClasses?.optionTitle || "anyspend-deposit-option-title text-as-primary font-medium"
-                    }
-                  >
-                    Fund with Fiat
-                  </span>
-                  <p
-                    className={
-                      depositClasses?.optionDescription ||
-                      "anyspend-deposit-option-description text-as-secondary text-xs"
-                    }
-                  >
-                    Pay with card or bank transfer
-                  </p>
+                <div
+                  className={depositClasses?.optionContent || "anyspend-deposit-option-content flex items-center gap-3"}
+                >
+                  <CreditCardIcon className={depositClasses?.optionIcon || "anyspend-deposit-option-icon h-10 w-10"} />
+                  <div className={depositClasses?.optionInfo || "anyspend-deposit-option-info"}>
+                    <span
+                      className={
+                        depositClasses?.optionTitle || "anyspend-deposit-option-title text-as-primary font-medium"
+                      }
+                    >
+                      Fund with Fiat
+                    </span>
+                    <p
+                      className={
+                        depositClasses?.optionDescription ||
+                        "anyspend-deposit-option-description text-as-secondary text-xs"
+                      }
+                    >
+                      Pay with card or bank transfer
+                    </p>
+                  </div>
                 </div>
-              </div>
-              <ChevronRight
-                className={depositClasses?.optionChevron || "anyspend-deposit-option-chevron text-as-secondary h-5 w-5"}
-              />
-            </button>
+                <ChevronRight
+                  className={
+                    depositClasses?.optionChevron || "anyspend-deposit-option-chevron text-as-secondary h-5 w-5"
+                  }
+                />
+              </button>
+            )}
           </div>
 
           {/* Chain-specific warning */}

package/src/anyspend/react/components/AnySpendNFT.tsx

@@ -42,6 +42,7 @@ export function AnySpendNFT({
   slots,
   content,
   theme,
+  showFiatOption = true,
 }: {
   loadOrder?: string;
   mode?: "modal" | "page";
@@ -54,6 +55,8 @@ export function AnySpendNFT({
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
+  /** Whether to show the "Pay with fiat" tab. Defaults to true. */
+  showFiatOption?: boolean;
 }) {
   const [imageUrlWithFallback, setFallbackImageUrl] = useState<string | null>(nftContract.imageUrl);
   const hasFetchedRef = useRef(false);
@@ -164,6 +167,7 @@ export function AnySpendNFT({
       loadOrder={loadOrder}
       mode={mode}
       activeTab="fiat"
+      showFiatOption={showFiatOption}
       recipientAddress={recipientAddress}
       orderType={"mint_nft"}
       dstChainId={nftContract.chainId}