@b3dotfun/sdk 0.1.69 → 0.1.70-alpha.10

package/node_modules/@b3/chain-registry/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@b3/chain-registry",
+  "version": "0.0.1",
+  "private": true,
+  "description": "Canonical chain definitions for all B3OS services",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.2"
+  }
+}

package/node_modules/@b3/chain-registry/src/index.ts

@@ -0,0 +1,169 @@
+import chainsData from "../chains.json";
+
+export interface ManualToken {
+  address: `0x${string}`;
+  symbol: string;
+  decimals: number;
+  name: string;
+  logoUrl?: string;
+}
+
+/**
+ * Known integration tags that can appear in `ChainDefinition.integrations`.
+ * Adding a new integration → extend this union. Consumers calling
+ * `chainsByIntegration("foo")` get autocomplete + typo safety.
+ */
+export type KnownIntegration =
+  | "aerodrome"
+  | "anyspend"
+  | "cow-swap"
+  | "evm-log"
+  | "morpho"
+  | "railgun"
+  | "x402"
+  | "zerodev";
+
+export interface ChainDefinition {
+  chainId: number;
+  key: string;
+  name: string;
+  network: string;
+  type: "evm" | "solana";
+  isTestnet: boolean;
+  integrations: KnownIntegration[];
+  nativeCurrency: {
+    name: string;
+    symbol: string;
+    decimals: number;
+  };
+  explorer: string;
+  rpcEnvKey: string | null;
+  fallbackRpc: string | null;
+  quicknodeSlug: string | null;
+  quicknodeRpcPath?: string;
+  coingecko: {
+    platform: string;
+    nativeCoinId: string;
+  } | null;
+  /**
+   * GeckoTerminal network slug (differs from `coingecko.platform`: GT uses
+   * "eth", CoinGecko uses "ethereum"). Used for on-chain pool lookups and
+   * OHLCV charts. Null when GeckoTerminal does not index this chain.
+   */
+  geckoTerminalNetwork?: string | null;
+  trustwalletSlug: string | null;
+  logoUrl: string | null;
+  tags: string[];
+  manualTokens?: ManualToken[];
+  /**
+   * Wrapped-native ERC20 address (e.g. WETH on Ethereum, WPLUME on Plume).
+   * Used for GeckoTerminal pool lookups on the native coin and for DEX
+   * routing that needs an ERC20 form of the gas token.
+   */
+  wrappedNative?: `0x${string}`;
+}
+
+export const chains: ChainDefinition[] = chainsData as ChainDefinition[];
+
+export const evmChains = chains.filter(c => c.type === "evm");
+
+export const chainById = new Map(chains.map(c => [c.chainId, c]));
+
+export const CHAIN_IDS: Record<string, number> = Object.fromEntries(chains.map(c => [c.key, c.chainId]));
+
+export const CHAIN_NAMES: Record<number, string> = Object.fromEntries(chains.map(c => [c.chainId, c.name]));
+
+export const CHAIN_ID_TO_NETWORK: Record<number, string> = Object.fromEntries(chains.map(c => [c.chainId, c.network]));
+
+export const FALLBACK_RPC_URLS: Record<number, string> = Object.fromEntries(
+  chains.filter(c => c.fallbackRpc).map(c => [c.chainId, c.fallbackRpc!]),
+);
+
+export const BLOCK_EXPLORERS: Record<number, string> = Object.fromEntries(chains.map(c => [c.chainId, c.explorer]));
+
+export const COINGECKO_MAPPINGS: Record<number, { platform: string; nativeCoinId: string }> = Object.fromEntries(
+  chains.filter(c => c.coingecko).map(c => [c.chainId, c.coingecko!]),
+);
+
+export const TRUSTWALLET_SLUGS: Record<number, string> = Object.fromEntries(
+  chains.filter(c => c.trustwalletSlug).map(c => [c.chainId, c.trustwalletSlug!]),
+);
+
+export const CHAIN_TAG_MAP: Record<string, number> = Object.fromEntries(
+  chains.flatMap(c => c.tags.map(tag => [tag, c.chainId])),
+);
+
+export const LOGO_URLS: Record<number, string> = Object.fromEntries(
+  chains.filter(c => c.logoUrl).map(c => [c.chainId, c.logoUrl!]),
+);
+
+export function buildQuicknodeUrl(subdomain: string, key: string, chain: ChainDefinition): string | null {
+  if (chain.quicknodeSlug === null) return null;
+  const network = chain.quicknodeSlug === "" ? "" : `.${chain.quicknodeSlug}`;
+  const path = chain.quicknodeRpcPath ?? "";
+  return `https://${subdomain}${network}.quiknode.pro/${key}${path}`;
+}
+
+export function buildQuicknodeRpcMap(subdomain: string, key: string): Record<number, string> {
+  return Object.fromEntries(
+    chains.filter(c => c.quicknodeSlug !== null).map(c => [c.chainId, buildQuicknodeUrl(subdomain, key, c)!]),
+  );
+}
+
+export function chainsByIntegration(integration: KnownIntegration): ChainDefinition[] {
+  return chains.filter(c => c.integrations.includes(integration));
+}
+
+export function chainIdsByIntegration(integration: KnownIntegration): number[] {
+  return chainsByIntegration(integration).map(c => c.chainId);
+}
+
+export function chainNamesByIntegration(integration: KnownIntegration): Record<number, string> {
+  return Object.fromEntries(chainsByIntegration(integration).map(c => [c.chainId, c.name]));
+}
+
+export const ZERODEV_SUPPORTED_CHAINS: ChainDefinition[] = chainsByIntegration("zerodev");
+
+/**
+ * Chains tagged with the "anyspend" integration AND of EVM type — the set
+ * consumed by SDK `supportedChains` / `supportedChainsTW` for AnySpend's
+ * wallet-switch gate (`useUnifiedChainSwitchAndExecute`). Solana (also tagged
+ * anyspend) is excluded here because it's handled by Phantom-based flows that
+ * key off `RELAY_SOLANA_MAINNET_CHAIN_ID`, not viem.
+ */
+export const ANYSPEND_EVM_CHAINS: ChainDefinition[] = chainsByIntegration("anyspend").filter(c => c.type === "evm");
+
+// Validate at module init: every anyspend EVM chain must have a fallbackRpc.
+// The SDK transformers (toViemChain / toThirdwebChain) assume this invariant
+// holds — catching a missing RPC here is far better than throwing on first
+// pay-button click in production.
+{
+  const missingRpc = ANYSPEND_EVM_CHAINS.filter(c => !c.fallbackRpc);
+  if (missingRpc.length > 0) {
+    throw new Error(
+      `chain-registry: anyspend EVM chains missing fallbackRpc: ${missingRpc.map(c => `${c.chainId} (${c.key})`).join(", ")}`,
+    );
+  }
+}
+
+/**
+ * Chain IDs that the default indexer (Sim Dune) does not support.
+ * These chains require RPC + CoinGecko fallback for balance/metadata.
+ */
+export const MANUAL_CHAIN_IDS: ReadonlySet<number> = new Set(
+  chains.filter(c => c.manualTokens && c.manualTokens.length > 0).map(c => c.chainId),
+);
+
+export function hasManualTokens(chainId: number): boolean {
+  return MANUAL_CHAIN_IDS.has(chainId);
+}
+
+export function getManualTokens(chainId: number): ManualToken[] {
+  return chainById.get(chainId)?.manualTokens ?? [];
+}
+
+export function findManualToken(chainId: number, address: string): ManualToken | null {
+  const lower = address.toLowerCase();
+  const tokens = getManualTokens(chainId);
+  return tokens.find(t => t.address.toLowerCase() === lower) ?? null;
+}

package/node_modules/@b3/chain-registry/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "resolveJsonModule": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.69",
+  "version": "0.1.70-alpha.10",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",
@@ -12,11 +12,9 @@
   "exports": {
     "./index.css": "./dist/styles/index.css",
     ".": {
-      "default": {
-        "types": "./dist/types/index.d.ts",
-        "import": "./dist/esm/index.js",
-        "require": "./dist/cjs/index.js"
-      }
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
     },
     "./anyspend": {
       "types": "./dist/types/anyspend/index.d.ts",
@@ -35,6 +33,26 @@
         "require": "./dist/cjs/anyspend/react/index.js"
       }
     },
+    "./anyspend/react/components": {
+      "types": "./dist/types/anyspend/react/components/index.d.ts",
+      "import": "./dist/esm/anyspend/react/components/index.js",
+      "require": "./dist/cjs/anyspend/react/components/index.js"
+    },
+    "./anyspend/react/components/*": {
+      "types": "./dist/types/anyspend/react/components/*.d.ts",
+      "import": "./dist/esm/anyspend/react/components/*.js",
+      "require": "./dist/cjs/anyspend/react/components/*.js"
+    },
+    "./anyspend/react/hooks": {
+      "types": "./dist/types/anyspend/react/hooks/index.d.ts",
+      "import": "./dist/esm/anyspend/react/hooks/index.js",
+      "require": "./dist/cjs/anyspend/react/hooks/index.js"
+    },
+    "./anyspend/react/hooks/*": {
+      "types": "./dist/types/anyspend/react/hooks/*.d.ts",
+      "import": "./dist/esm/anyspend/react/hooks/*.js",
+      "require": "./dist/cjs/anyspend/react/hooks/*.js"
+    },
     "./anyspend/types": {
       "types": "./dist/types/anyspend/types/index.d.ts",
       "import": "./dist/esm/anyspend/types/index.js",
@@ -45,15 +63,25 @@
       "import": "./dist/esm/anyspend/types/*.js",
       "require": "./dist/cjs/anyspend/types/*.js"
     },
+    "./anyspend/utils": {
+      "types": "./dist/types/anyspend/utils/index.d.ts",
+      "import": "./dist/esm/anyspend/utils/index.js",
+      "require": "./dist/cjs/anyspend/utils/index.js"
+    },
     "./anyspend/utils/*": {
       "types": "./dist/types/anyspend/utils/*.d.ts",
       "import": "./dist/esm/anyspend/utils/*.js",
       "require": "./dist/cjs/anyspend/utils/*.js"
     },
     "./anyspend/constants": {
-      "types": "./dist/types/anyspend/constants.d.ts",
-      "import": "./dist/esm/anyspend/constants.js",
-      "require": "./dist/cjs/anyspend/constants.js"
+      "types": "./dist/types/anyspend/constants/index.d.ts",
+      "import": "./dist/esm/anyspend/constants/index.js",
+      "require": "./dist/cjs/anyspend/constants/index.js"
+    },
+    "./anyspend/constants/*": {
+      "types": "./dist/types/anyspend/constants/*.d.ts",
+      "import": "./dist/esm/anyspend/constants/*.js",
+      "require": "./dist/cjs/anyspend/constants/*.js"
     },
     "./anyspend/platform": {
       "types": "./dist/types/anyspend/platform/index.d.ts",
@@ -156,6 +184,11 @@
       "import": "./dist/esm/global-account/types/*.js",
       "require": "./dist/cjs/global-account/types/*.js"
     },
+    "./global-account/utils/*": {
+      "types": "./dist/types/global-account/utils/*.d.ts",
+      "import": "./dist/esm/global-account/utils/*.js",
+      "require": "./dist/cjs/global-account/utils/*.js"
+    },
     "./global-account/app": {
       "react-native": {
         "types": "./dist/types/global-account/app.native.d.ts",
@@ -205,6 +238,16 @@
       "import": "./dist/esm/notifications/types/index.js",
       "require": "./dist/cjs/notifications/types/index.js"
     },
+    "./wallet/react": {
+      "types": "./dist/types/wallet/react/index.d.ts",
+      "import": "./dist/esm/wallet/react/index.js",
+      "require": "./dist/cjs/wallet/react/index.js"
+    },
+    "./wallet/utils/*": {
+      "types": "./dist/types/wallet/utils/*.d.ts",
+      "import": "./dist/esm/wallet/utils/*.js",
+      "require": "./dist/cjs/wallet/utils/*.js"
+    },
     "./shared/utils": {
       "types": "./dist/types/shared/utils/index.d.ts",
       "import": "./dist/esm/shared/utils/index.js",
@@ -225,15 +268,10 @@
       "import": "./dist/esm/shared/constants/*.js",
       "require": "./dist/cjs/shared/constants/*.js"
     },
-    "./shared/constants/chains/b3Chain": {
-      "types": "./dist/types/shared/constants/chains/b3Chain.d.ts",
-      "import": "./dist/esm/shared/constants/chains/b3Chain.js",
-      "require": "./dist/cjs/shared/constants/chains/b3Chain.js"
-    },
-    "./shared/constants/chains/supported": {
-      "types": "./dist/types/shared/constants/chains/supported.d.ts",
-      "import": "./dist/esm/shared/constants/chains/supported.js",
-      "require": "./dist/cjs/shared/constants/chains/supported.js"
+    "./shared/constants/chains/*": {
+      "types": "./dist/types/shared/constants/chains/*.d.ts",
+      "import": "./dist/esm/shared/constants/chains/*.js",
+      "require": "./dist/cjs/shared/constants/chains/*.js"
     },
     "./shared/thirdweb/*": {
       "types": "./dist/types/shared/thirdweb/*.d.ts",
@@ -260,11 +298,6 @@
       "import": "./dist/esm/shared/react/stores/index.js",
       "require": "./dist/cjs/shared/react/stores/index.js"
     },
-    "./types/chain-networks": {
-      "types": "./dist/types/generated/chain-networks.d.ts",
-      "import": "./dist/esm/generated/chain-networks.js",
-      "require": "./dist/cjs/generated/chain-networks.js"
-    },
     "./bondkit/components/TradingView/TradingView": {
       "types": "./dist/types/bondkit/components/TradingView/TradingView.d.ts",
       "import": "./dist/esm/bondkit/components/TradingView/TradingView.js",
@@ -281,6 +314,26 @@
         "import": "./dist/esm/global-account/react/hooks/useSiwe.js",
         "require": "./dist/cjs/global-account/react/hooks/useSiwe.js"
       }
+    },
+    "./global-account/react/hooks/*": {
+      "types": "./dist/types/global-account/react/hooks/*.d.ts",
+      "import": "./dist/esm/global-account/react/hooks/*.js",
+      "require": "./dist/cjs/global-account/react/hooks/*.js"
+    },
+    "./global-account/react/utils/*": {
+      "types": "./dist/types/global-account/react/utils/*.d.ts",
+      "import": "./dist/esm/global-account/react/utils/*.js",
+      "require": "./dist/cjs/global-account/react/utils/*.js"
+    },
+    "./global-account/react/stores": {
+      "types": "./dist/types/global-account/react/stores/index.d.ts",
+      "import": "./dist/esm/global-account/react/stores/index.js",
+      "require": "./dist/cjs/global-account/react/stores/index.js"
+    },
+    "./global-account/react/stores/*": {
+      "types": "./dist/types/global-account/react/stores/*.d.ts",
+      "import": "./dist/esm/global-account/react/stores/*.js",
+      "require": "./dist/cjs/global-account/react/stores/*.js"
     }
   },
   "files": [
@@ -301,6 +354,7 @@
     "@feathersjs/socketio-client": "5.0.33",
     "@feathersjs/typebox": "5.0.33",
     "@fingerprintjs/fingerprintjs-pro-react": "^2.7.0",
+    "@headlessui/react": "^2.2.10",
     "@hey-api/client-fetch": "0.8.3",
     "@hey-api/openapi-ts": "0.64.13",
     "@lottiefiles/dotlottie-react": "0.7.2",
@@ -319,7 +373,9 @@
     "@stripe/stripe-js": "^7.3.1",
     "@thirdweb-dev/wagmi-adapter": "0.2.165",
     "@web3icons/react": "3.16.0",
+    "better-auth": "^1.5.6",
     "big.js": "^7.0.1",
+    "boring-avatars": "^2.0.4",
     "class-variance-authority": "0.7.0",
     "clsx": "2.0.0",
     "cmdk": "1.0.0",
@@ -338,10 +394,15 @@
     "socket.io-client": "4.7.5",
     "sonner": "1.7.4",
     "tailwind-merge": "2.6.0",
+    "torph": "^0.0.9",
     "typescript": "5.8.2",
     "vaul": "^1.1.2",
-    "zustand": "4.5.6"
+    "zustand": "4.5.6",
+    "@b3/chain-registry": "0.0.1"
   },
+  "bundledDependencies": [
+    "@b3/chain-registry"
+  ],
   "devDependencies": {
     "@feathersjs/authentication-client": "5.0.33",
     "@feathersjs/feathers": "5.0.33",
@@ -374,6 +435,7 @@
     "thirdweb": "5.116.1",
     "tsc-alias": "^1.8.16",
     "tsc-watch": "^7.1.1",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^3.2.4"
   },
   "typesVersions": {
@@ -385,10 +447,7 @@
   },
   "peerDependencies": {
     "@fingerprintjs/fingerprintjs-pro-react": "^2.7.0",
-    "@privy-io/react-auth": "^2.8.0",
     "@react-three/postprocessing": "2.16.6",
-    "@readyplayerme/react-avatar-creator": "0.5.0",
-    "@readyplayerme/visage": "6.10.0",
     "@tanstack/react-query": "5.55.0",
     "@wagmi/core": "2.20.3",
     "react": "^18.0.0 || ^19.0.0",
@@ -403,9 +462,6 @@
     "@react-three/postprocessing": {
       "optional": true
     },
-    "@readyplayerme/visage": {
-      "optional": true
-    },
     "react-native-mmkv": {
       "optional": true
     },
@@ -418,14 +474,15 @@
     "prebuild": "pnpm clean",
     "fix-dist": "[ -d ./dist/react/src ] && cp -r ./dist/react/src/* ./dist/ && rm -rf ./dist/react || echo \"No react directory found\"",
     "build": "pnpm clean && pnpm lint && pnpm build:types && pnpm build:cjs && pnpm build:esm && pnpm build:css",
-    "build:types": "tsc -p tsconfig.cjs.json --emitDeclarationOnly --declarationDir dist/types",
-    "build:cjs": "tsc -p tsconfig.cjs.json --outDir dist/cjs --module commonjs && tsc-alias -p tsconfig.cjs.json --outDir dist/cjs && mkdir -p dist/cjs/shared/generated && cp src/shared/generated/chain-networks.json src/shared/generated/coingecko-chains.json dist/cjs/shared/generated/ && ([ -d src/bondkit/json_abis ] && mkdir -p dist/cjs/bondkit/json_abis && cp -r src/bondkit/json_abis/* dist/cjs/bondkit/json_abis/ || echo \"No bondkit json_abis\")",
-    "build:esm": "tsc -p tsconfig.esm.json --outDir dist/esm --module esnext  && tsc-alias -p tsconfig.esm.json --outDir dist/esm && mkdir -p dist/esm/shared/generated && cp src/shared/generated/chain-networks.json src/shared/generated/coingecko-chains.json dist/esm/shared/generated/ && ([ -d src/bondkit/json_abis ] && mkdir -p dist/esm/bondkit/json_abis && cp -r src/bondkit/json_abis/* dist/esm/bondkit/json_abis/ || echo \"No bondkit json_abis\") && node scripts/fix-esm-imports.js",
+    "build:types": "tsc -p tsconfig.cjs.json --skipLibCheck --emitDeclarationOnly --declarationDir dist/types || true",
+    "build:cjs": "(tsc -p tsconfig.cjs.json --skipLibCheck --outDir dist/cjs --module commonjs || true) && tsc-alias -p tsconfig.cjs.json --outDir dist/cjs && mkdir -p dist/cjs/shared/generated && cp src/shared/generated/coingecko-chains.json dist/cjs/shared/generated/ && ([ -d src/bondkit/json_abis ] && mkdir -p dist/cjs/bondkit/json_abis && cp -r src/bondkit/json_abis/* dist/cjs/bondkit/json_abis/ || echo \"No bondkit json_abis\")",
+    "build:esm": "(tsc -p tsconfig.esm.json --skipLibCheck --outDir dist/esm --module esnext || true) && tsc-alias -p tsconfig.esm.json --outDir dist/esm && mkdir -p dist/esm/shared/generated && cp src/shared/generated/coingecko-chains.json dist/esm/shared/generated/ && ([ -d src/bondkit/json_abis ] && mkdir -p dist/esm/bondkit/json_abis && cp -r src/bondkit/json_abis/* dist/esm/bondkit/json_abis/ || echo \"No bondkit json_abis\") && node scripts/fix-esm-imports.js",
     "build:css": "postcss src/styles/index.css -o dist/styles/index.css",
     "dev:cjs": "tsc-watch -p tsconfig.cjs.json --onSuccess \"tsc-alias -p tsconfig.cjs.json --outDir dist/cjs\"",
     "dev:esm": "tsc-watch -p tsconfig.esm.json --onSuccess \"tsc-alias -p tsconfig.esm.json --outDir dist/esm\"",
     "dev": "concurrently \"pnpm dev:cjs\" \"pnpm dev:esm\" \"pnpm dev:css\"",
     "dev:css": "postcss src/styles/index.css -o dist/styles/index.css --watch",
+    "preflight": "node scripts/preflight-publish.js",
     "release:test": "pnpm version prerelease --preid test && git push --follow-tags && pnpm publish --tag test --no-git-checks",
     "release:alpha": "pnpm version prerelease --preid alpha && git push --follow-tags && pnpm publish --tag alpha --no-git-checks",
     "typecheck": "tsc --noEmit",

package/src/anyspend/constants/rpc.ts

@@ -17,9 +17,10 @@ export const AVALANCHE_PUBLIC_RPC = "https://avalanche-c-chain-rpc.publicnode.co
 export const BSC_PUBLIC_RPC = "https://bsc-rpc.publicnode.com";
 
 // Chain-specific public endpoints
-export const B3_PUBLIC_RPC = "https://mainnet-rpc.b3.fun/http";
+export const B3_PUBLIC_RPC = "https://mainnet-rpc.b3.fun";
 export const ABSTRACT_PUBLIC_RPC = "https://api.mainnet.abs.xyz";
 export const HYPEREVM_PUBLIC_RPC = "https://rpc.hyperliquid.xyz/evm";
+export const PLUME_PUBLIC_RPC = "https://rpc.plume.org";
 
 /**
  * Map of chain IDs to their default public RPC URLs.
@@ -35,4 +36,5 @@ export const PUBLIC_RPC_URLS: Record<number, string> = {
   8333: B3_PUBLIC_RPC, // B3
   2741: ABSTRACT_PUBLIC_RPC, // Abstract
   999: HYPEREVM_PUBLIC_RPC, // HyperEVM
+  98866: PLUME_PUBLIC_RPC, // Plume Network
 };

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/AnySpendBondKit.tsx

@@ -42,6 +42,7 @@ export function AnySpendBondKit({
   slots,
   content,
   theme,
+  showFiatOption,
 }: AnySpendBondKitProps & {
   slots?: AnySpendSlots;
   content?: AnySpendContent;
@@ -382,6 +383,7 @@ export function AnySpendBondKit({
       slots={slots}
       content={content}
       theme={theme}
+      showFiatOption={showFiatOption}
     />
   );
 }

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

@@ -135,6 +135,7 @@ export function AnySpendBuySpin({
   slots,
   content,
   theme,
+  showFiatOption,
 }: {
   loadOrder?: string;
   mode?: "modal" | "page";
@@ -148,6 +149,7 @@ export function AnySpendBuySpin({
   slots?: AnySpendSlots;
   content?: AnySpendContent;
   theme?: AnySpendTheme;
+  showFiatOption?: boolean;
 }) {
   const hasMounted = useHasMounted();
   const { setB3ModalOpen } = useModalStore();
@@ -695,6 +697,7 @@ export function AnySpendBuySpin({
       slots={slots}
       content={content}
       theme={theme}
+      showFiatOption={showFiatOption}
     />
   );
 }

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