@b3dotfun/sdk 0.1.70-alpha.12 → 0.1.70-alpha.14

package/dist/esm/anyspend/react/components/AnySpendDeposit.d.ts

@@ -41,6 +41,13 @@ export interface AnySpendDepositProps {
     destinationTokenAddress: string;
     /** The destination chain ID */
     destinationTokenChainId: number;
+    /**
+     * When false, the destination token is user-selectable even though a default destination token is
+     * provided (the provided destination is used only as the initial/default value). Used by the
+     * wallet-funding deposit flow so the user can change the receive token away from the default
+     * (Base USDC). Defaults to true (locked destination, current behavior). Does not affect the
+     * QR/pure-transfer path. */
+    lockDestinationToken?: boolean;
     /** Callback when deposit succeeds */
     onSuccess?: (amount: string) => void;
     /** Callback for opening a custom modal (e.g., for special token handling) */
@@ -102,6 +109,13 @@ export interface AnySpendDepositProps {
     classes?: AnySpendAllClasses;
     /** When true, allows direct transfer without swap if source and destination token/chain are the same */
     allowDirectTransfer?: boolean;
+    /**
+     * When true, the QR-deposit path is a PURE TRANSFER: the destination token/chain
+     * mirror whatever source token the user selects, so the exact token they send lands
+     * in their wallet on the same chain (no swap/bridge). Forwarded to QRDeposit.
+     * Defaults to false.
+     */
+    pureTransferOnly?: boolean;
     /** Fixed destination token amount (in wei/smallest unit). When provided, user cannot change the amount. */
     destinationTokenAmount?: string;
     /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
@@ -150,4 +164,4 @@ export interface AnySpendDepositProps {
  *   onSuccess={(amount) => console.log(`Deposited ${amount}`)}
  * />
  */
-export declare function AnySpendDeposit({ loadOrder, mode, recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, showFiatOption, supportedChains, minPoolSize, topChainsCount, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit, classes, allowDirectTransfer, destinationTokenAmount, callbackMetadata, senderAddress, slots, content, theme, }: AnySpendDepositProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AnySpendDeposit({ loadOrder, mode, recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, lockDestinationToken, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, showFiatOption, supportedChains, minPoolSize, topChainsCount, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit, classes, allowDirectTransfer, pureTransferOnly, destinationTokenAmount, callbackMetadata, senderAddress, slots, content, theme, }: AnySpendDepositProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/esm/anyspend/react/components/AnySpendDeposit.js

@@ -1,9 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { USDC_BASE } from "../../../anyspend/index.js";
 import { Skeleton, useAccountWallet, useSimBalance, useTokenData } from "../../../global-account/react/index.js";
 import { cn } from "../../../shared/utils/cn.js";
 import { NetworkArbitrumOne, NetworkBase, NetworkBinanceSmartChain, NetworkEthereum, NetworkOptimism, NetworkPolygonPos, } from "@web3icons/react";
 import { ChevronRight } from "lucide-react";
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { AnySpend } from "./AnySpend.js";
 import { AnySpendCustomExactIn } from "./AnySpendCustomExactIn.js";
 import { ChainWarningText } from "./common/WarningText.js";
@@ -21,6 +22,19 @@ const DEFAULT_SUPPORTED_CHAINS = [
 ];
 // Minimum pool size to filter out low liquidity tokens
 const DEFAULT_MIN_POOL_SIZE = 1000000;
+/**
+ * Self-described fallback metadata for the default funding token(s), keyed by
+ * `${chainId}:${lowercased address}`. Used when `useTokenData` misses (returns
+ * null) so the destination token's decimals/symbol are correct WITHOUT depending
+ * on the network — critical in pure-transfer mode where there's no server-side
+ * correction and the wrong decimals would make `useWatchTransfer` show a wrong amount.
+ */
+const KNOWN_FUNDING_TOKENS = {
+    [`${USDC_BASE.chainId}:${USDC_BASE.address.toLowerCase()}`]: USDC_BASE,
+};
+function getKnownFundingToken(chainId, address) {
+    return KNOWN_FUNDING_TOKENS[`${chainId}:${address.toLowerCase()}`];
+}
 function formatUsd(value) {
     return new Intl.NumberFormat("en-US", {
         style: "currency",
@@ -94,7 +108,7 @@ function ChainIcon({ chainId, className }) {
  *   onSuccess={(amount) => console.log(`Deposited ${amount}`)}
  * />
  */
-export function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, showFiatOption = true, supportedChains = DEFAULT_SUPPORTED_CHAINS, minPoolSize = DEFAULT_MIN_POOL_SIZE, topChainsCount = 3, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit = false, classes, allowDirectTransfer = false, destinationTokenAmount, callbackMetadata, senderAddress, slots, content, theme, }) {
+export function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, paymentType: initialPaymentType, sourceTokenAddress, sourceTokenChainId: initialSourceChainId, destinationTokenAddress, destinationTokenChainId, lockDestinationToken = true, onSuccess, onOpenCustomModal, mainFooter, onTokenSelect, customUsdInputValues, preferEoa, minDestinationAmount, header, orderType, depositContractConfig, showChainSelection, showFiatOption = true, supportedChains = DEFAULT_SUPPORTED_CHAINS, minPoolSize = DEFAULT_MIN_POOL_SIZE, topChainsCount = 3, onClose, returnToHomeUrl, customRecipientLabel, returnHomeLabel, isCustomDeposit = false, classes, allowDirectTransfer = false, pureTransferOnly = false, destinationTokenAmount, callbackMetadata, senderAddress, slots, content, theme, }) {
     // Extract deposit-specific classes for convenience
     const depositClasses = classes?.deposit;
     const { connectedEOAWallet } = useAccountWallet();
@@ -111,16 +125,22 @@ export function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, p
         }
     }, [showFiatOption, paymentType]);
     // Fetch destination token data
-    const { data: destinationTokenData } = useTokenData(destinationTokenChainId, destinationTokenAddress);
-    // Construct full destination token object
-    const destinationToken = useMemo(() => ({
-        address: destinationTokenAddress,
-        chainId: destinationTokenChainId,
-        symbol: destinationTokenData?.symbol ?? "",
-        name: destinationTokenData?.name ?? "",
-        decimals: destinationTokenData?.decimals ?? 18,
-        metadata: { logoURI: destinationTokenData?.logoURI },
-    }), [destinationTokenAddress, destinationTokenChainId, destinationTokenData]);
+    const { data: destinationTokenData, isLoading: isDestinationTokenLoading } = useTokenData(destinationTokenChainId, destinationTokenAddress);
+    // Construct full destination token object. When `useTokenData` misses (it returns
+    // null on an API miss, not an error), fall back to a known-token entry so the
+    // decimals/symbol invariant holds regardless of the fetch — e.g. Base USDC is 6
+    // decimals, never the generic 18 fallback.
+    const destinationToken = useMemo(() => {
+        const known = getKnownFundingToken(destinationTokenChainId, destinationTokenAddress);
+        return {
+            address: destinationTokenAddress,
+            chainId: destinationTokenChainId,
+            symbol: destinationTokenData?.symbol ?? known?.symbol ?? "",
+            name: destinationTokenData?.name ?? known?.name ?? "",
+            decimals: destinationTokenData?.decimals ?? known?.decimals ?? 18,
+            metadata: { logoURI: destinationTokenData?.logoURI ?? known?.metadata?.logoURI },
+        };
+    }, [destinationTokenAddress, destinationTokenChainId, destinationTokenData]);
     // Fetch balances for EOA wallet (use senderAddress as fallback for pre-filled balance display)
     const effectiveBalanceAddress = senderAddress || eoaAddress;
     const { data: balanceData, isLoading: isBalanceLoading } = useSimBalance(shouldShowChainSelection ? effectiveBalanceAddress : undefined, supportedChains.map(c => c.id));
@@ -162,6 +182,9 @@ export function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, p
     const totalBalance = useMemo(() => {
         return Object.values(chainBalances).reduce((sum, chain) => sum + chain.totalUsdValue, 0);
     }, [chainBalances]);
+    const handleQRDepositSuccess = useCallback((txHash) => {
+        onSuccess?.(txHash ?? "");
+    }, [onSuccess]);
     if (!recipientAddress)
         return null;
     const tokenSymbol = destinationToken.symbol || "TOKEN";
@@ -208,10 +231,24 @@ export function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, p
     }
     // QR Deposit view
     if (step === "qr-deposit") {
-        return (_jsx(QRDeposit, { mode: mode, recipientAddress: recipientAddress, destinationToken: destinationToken, destinationChainId: destinationTokenChainId, depositContractConfig: depositContractConfig, onBack: handleBack, onClose: onClose ?? handleBack, classes: classes?.qrDeposit }));
+        // In pure-transfer mode QRDeposit captures `destinationToken` as its initial
+        // SOURCE token via useState, so it must be fully resolved (correct symbol +
+        // decimals) before QRDeposit mounts. Known funding tokens (e.g. Base USDC) are
+        // already fully resolved via the self-described fallback, so only show a spinner
+        // for unknown tokens whose metadata still has to load over the network.
+        const hasKnownDestination = !!getKnownFundingToken(destinationTokenChainId, destinationTokenAddress);
+        // NOTE: all current Fund Wallet callers derive `destinationTokenAddress` from
+        // `getDefaultDepositDestination`, which always returns Base USDC — exactly a
+        // `KNOWN_FUNDING_TOKENS` key — so `hasKnownDestination` is always true and this
+        // branch never fires for them. The guard is defensive for FUTURE callers that pass
+        // an unknown token together with `pureTransferOnly=true`.
+        if (pureTransferOnly && !hasKnownDestination && !destinationTokenData && isDestinationTokenLoading) {
+            return (_jsx("div", { className: cn("anyspend-deposit anyspend-deposit-qr-loading font-inter bg-as-surface-primary mx-auto w-full max-w-[460px] p-6", mode === "page" && "border-as-border-secondary overflow-hidden rounded-2xl border shadow-xl"), children: _jsxs("div", { className: "anyspend-deposit-qr-loading-content flex flex-col items-center justify-center gap-4 py-12", children: [_jsx(Skeleton, { className: "h-8 w-8 rounded-full" }), _jsx(Skeleton, { className: "h-4 w-40" })] }) }));
+        }
+        return (_jsx(QRDeposit, { mode: mode, recipientAddress: recipientAddress, destinationToken: destinationToken, destinationChainId: destinationTokenChainId, pureTransferOnly: pureTransferOnly, depositContractConfig: depositContractConfig, onBack: handleBack, onClose: onClose ?? handleBack, onSuccess: handleQRDepositSuccess, classes: classes?.qrDeposit }));
     }
     // Deposit view
     return (_jsxs("div", { className: depositClasses?.form || "anyspend-deposit anyspend-deposit-form relative", children: [shouldShowChainSelection && (_jsxs("button", { onClick: handleBack, className: depositClasses?.backButton ||
                     "anyspend-deposit-back-button text-as-secondary hover:text-as-primary absolute left-4 top-4 z-10 flex items-center gap-1", children: [_jsx("svg", { className: depositClasses?.backIcon || "anyspend-deposit-back-icon h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 19l-7-7 7-7" }) }), _jsx("span", { className: depositClasses?.backText || "anyspend-deposit-back-text text-sm", children: "Back" })] })), onClose && (_jsx("button", { onClick: onClose, className: depositClasses?.closeButton ||
-                    "anyspend-deposit-close-button text-as-secondary hover:text-as-primary absolute right-4 top-4 z-10", children: _jsx("svg", { className: "h-6 w-6", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })), _jsx("div", { className: depositClasses?.formContent || cn("anyspend-deposit-form-content", shouldShowChainSelection && "pt-8"), children: isCustomDeposit ? (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, paymentType: paymentType, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: selectedChainId, destinationToken: destinationToken, destinationChainId: destinationTokenChainId, orderType: effectiveOrderType, minDestinationAmount: minDestinationAmount, header: header ?? defaultHeader, onSuccess: onSuccess, onOpenCustomModal: onOpenCustomModal, mainFooter: mainFooter, onTokenSelect: onTokenSelect, customUsdInputValues: customUsdInputValues, preferEoa: preferEoa, customExactInConfig: depositContractConfig, returnToHomeUrl: returnToHomeUrl, customRecipientLabel: customRecipientLabel, returnHomeLabel: returnHomeLabel, classes: classes?.customExactIn, allowDirectTransfer: allowDirectTransfer, destinationTokenAmount: destinationTokenAmount, callbackMetadata: callbackMetadata, senderAddress: senderAddress, showFiatOption: showFiatOption, slots: slots, content: content, theme: theme }, selectedChainId)) : (_jsx(AnySpend, { loadOrder: loadOrder, mode: mode, defaultActiveTab: paymentType, recipientAddress: recipientAddress, sourceChainId: selectedChainId, destinationTokenAddress: destinationTokenAddress, destinationTokenChainId: destinationTokenChainId, onSuccess: txHash => onSuccess?.(txHash ?? ""), onTokenSelect: onTokenSelect, customUsdInputValues: customUsdInputValues, hideHeader: true, hideBottomNavigation: true, disableUrlParamManagement: true, returnToHomeUrl: returnToHomeUrl, customRecipientLabel: customRecipientLabel, returnHomeLabel: returnHomeLabel, classes: classes?.anySpend, allowDirectTransfer: allowDirectTransfer, destinationTokenAmount: destinationTokenAmount, callbackMetadata: callbackMetadata, senderAddress: senderAddress, showFiatOption: showFiatOption, slots: slots, content: content, theme: theme }, selectedChainId)) }), _jsx(ChainWarningText, { chainId: destinationTokenChainId, classes: classes?.chainWarningText || { root: "px-4 pb-4" } })] }));
+                    "anyspend-deposit-close-button text-as-secondary hover:text-as-primary absolute right-4 top-4 z-10", children: _jsx("svg", { className: "h-6 w-6", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })), _jsx("div", { className: depositClasses?.formContent || cn("anyspend-deposit-form-content", shouldShowChainSelection && "pt-8"), children: isCustomDeposit ? (_jsx(AnySpendCustomExactIn, { loadOrder: loadOrder, mode: mode, recipientAddress: recipientAddress, paymentType: paymentType, sourceTokenAddress: sourceTokenAddress, sourceTokenChainId: selectedChainId, destinationToken: destinationToken, destinationChainId: destinationTokenChainId, orderType: effectiveOrderType, minDestinationAmount: minDestinationAmount, header: header ?? defaultHeader, onSuccess: onSuccess, onOpenCustomModal: onOpenCustomModal, mainFooter: mainFooter, onTokenSelect: onTokenSelect, customUsdInputValues: customUsdInputValues, preferEoa: preferEoa, customExactInConfig: depositContractConfig, returnToHomeUrl: returnToHomeUrl, customRecipientLabel: customRecipientLabel, returnHomeLabel: returnHomeLabel, classes: classes?.customExactIn, allowDirectTransfer: allowDirectTransfer, destinationTokenAmount: destinationTokenAmount, callbackMetadata: callbackMetadata, senderAddress: senderAddress, showFiatOption: showFiatOption, slots: slots, content: content, theme: theme }, selectedChainId)) : (_jsx(AnySpend, { loadOrder: loadOrder, mode: mode, defaultActiveTab: paymentType, recipientAddress: recipientAddress, sourceChainId: selectedChainId, destinationTokenAddress: destinationTokenAddress, destinationTokenChainId: destinationTokenChainId, lockDestinationToken: lockDestinationToken, onSuccess: txHash => onSuccess?.(txHash ?? ""), onTokenSelect: onTokenSelect, customUsdInputValues: customUsdInputValues, hideHeader: true, hideBottomNavigation: true, disableUrlParamManagement: true, returnToHomeUrl: returnToHomeUrl, customRecipientLabel: customRecipientLabel, returnHomeLabel: returnHomeLabel, classes: classes?.anySpend, allowDirectTransfer: allowDirectTransfer, destinationTokenAmount: destinationTokenAmount, callbackMetadata: callbackMetadata, senderAddress: senderAddress, showFiatOption: showFiatOption, slots: slots, content: content, theme: theme }, selectedChainId)) }), _jsx(ChainWarningText, { chainId: destinationTokenChainId, classes: classes?.chainWarningText || { root: "px-4 pb-4" } })] }));
 }

package/dist/esm/anyspend/react/components/QRDeposit.d.ts

@@ -14,6 +14,14 @@ export interface QRDepositProps {
     destinationToken: components["schemas"]["Token"];
     /** The destination chain ID */
     destinationChainId: number;
+    /**
+     * When true, the deposit is a PURE TRANSFER: the destination token/chain mirror
+     * the user's currently selected source token/chain, so the exact token the user
+     * sends lands in their wallet on the same chain — no swap/bridge order is created.
+     * The `destinationToken`/`destinationChainId` props are then used only as the
+     * initial source selection (they must be fully resolved before mount). Defaults to false.
+     */
+    pureTransferOnly?: boolean;
     /** Creator address (optional) */
     creatorAddress?: string;
     /** Contract config for custom execution after deposit */
@@ -24,8 +32,11 @@ export interface QRDepositProps {
     onClose?: () => void;
     /** Callback when order is created successfully */
     onOrderCreated?: (orderId: string) => void;
-    /** Callback when deposit is completed */
-    onSuccess?: (txHash?: string) => void;
+    /**
+     * Callback when deposit is completed. The argument carries the deposited amount string
+     * (e.g. "200.00") on the pure-transfer path, or the order tx hash otherwise.
+     */
+    onSuccess?: (amountOrTxHash?: string) => void;
     /** Custom classes for styling */
     classes?: QRDepositClasses;
 }
@@ -43,4 +54,4 @@ export interface QRDepositProps {
  *   onSuccess={(txHash) => console.log("Deposit complete:", txHash)}
  * />
  */
-export declare function QRDeposit({ mode, recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }: QRDepositProps): import("react/jsx-runtime").JSX.Element;
+export declare function QRDeposit({ mode, recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, pureTransferOnly, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }: QRDepositProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/anyspend/react/components/QRDeposit.js

@@ -5,7 +5,7 @@ import { cn } from "../../../shared/utils/cn.js";
 import { TokenSelector } from "@relayprotocol/relay-kit-ui";
 import { Check, ChevronsUpDown, Copy, Loader2 } from "lucide-react";
 import { QRCodeSVG } from "qrcode.react";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { useAnyspendOrderAndTransactions } from "../hooks/useAnyspendOrderAndTransactions.js";
 import { useCreateDepositFirstOrder } from "../hooks/useCreateDepositFirstOrder.js";
 import { useOnOrderSuccess } from "../hooks/useOnOrderSuccess.js";
@@ -39,28 +39,35 @@ const DEFAULT_ETH_ON_BASE = {
  *   onSuccess={(txHash) => console.log("Deposit complete:", txHash)}
  * />
  */
-export function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }) {
+export function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, pureTransferOnly = false, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }) {
     const [copied, setCopied] = useState(false);
     const [orderId, setOrderId] = useState();
     const [globalAddress, setGlobalAddress] = useState();
     const orderCreatedRef = useRef(false);
     const [transferResult, setTransferResult] = useState(null);
-    // Source token/chain as state (can be changed by user)
-    const [sourceChainId, setSourceChainId] = useState(sourceChainIdProp ?? 8453);
-    const [sourceToken, setSourceToken] = useState(sourceTokenProp ?? DEFAULT_ETH_ON_BASE);
+    // Source token/chain as state (can be changed by user).
+    // In pure-transfer mode the initial source is the passed destination (caller sets
+    // it to the desired default funding token), so the deposit mirrors the user's selection.
+    const [sourceChainId, setSourceChainId] = useState(sourceChainIdProp ?? (pureTransferOnly ? destinationChainId : 8453));
+    const [sourceToken, setSourceToken] = useState(sourceTokenProp ?? (pureTransferOnly ? destinationToken : DEFAULT_ETH_ON_BASE));
+    // In pure-transfer mode the effective destination mirrors the selected source,
+    // forcing isPureTransfer = true (no swap/bridge order is created).
+    const effectiveDestinationToken = pureTransferOnly ? sourceToken : destinationToken;
+    const effectiveDestinationChainId = pureTransferOnly ? sourceChainId : destinationChainId;
     // Check if this is a pure transfer (same chain and token)
-    const isPureTransfer = isSameChainAndToken(sourceChainId, sourceToken.address, destinationChainId, destinationToken.address);
+    const isPureTransfer = isSameChainAndToken(sourceChainId, sourceToken.address, effectiveDestinationChainId, effectiveDestinationToken.address);
+    const handleTransferDetected = useCallback((result) => {
+        setTransferResult(result);
+        onSuccess?.(result.formattedAmount);
+    }, [onSuccess]);
     // Watch for pure transfers (same chain and token)
-    const { isWatching: isWatchingTransfer } = useWatchTransfer({
+    const { isWatching: isWatchingTransfer, reset: resetWatchTransfer } = useWatchTransfer({
         address: recipientAddress,
         chainId: sourceChainId,
         tokenAddress: sourceToken.address,
         tokenDecimals: sourceToken.decimals,
         enabled: isPureTransfer && !transferResult,
-        onTransferDetected: result => {
-            setTransferResult(result);
-            onSuccess?.();
-        },
+        onTransferDetected: handleTransferDetected,
     });
     // Handle token selection from TokenSelector
     const handleTokenSelect = (newToken) => {
@@ -77,6 +84,8 @@ export function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourc
         setGlobalAddress(undefined);
         orderCreatedRef.current = false;
         setTransferResult(null);
+        // Reset the balance watcher baseline so the new token isn't compared against the old token's balance
+        resetWatchTransfer();
         // Update token and chain
         setSourceChainId(newToken.chainId);
         setSourceToken(token);
@@ -107,18 +116,18 @@ export function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourc
         createOrder({
             recipientAddress,
             srcChain: sourceChainId,
-            dstChain: destinationChainId,
+            dstChain: effectiveDestinationChainId,
             srcToken: sourceToken,
-            dstToken: destinationToken,
+            dstToken: effectiveDestinationToken,
             creatorAddress,
             contractConfig: depositContractConfig,
         });
     }, [
         recipientAddress,
         sourceChainId,
-        destinationChainId,
+        effectiveDestinationChainId,
         sourceToken,
-        destinationToken,
+        effectiveDestinationToken,
         creatorAddress,
         depositContractConfig,
         createOrder,
@@ -163,7 +172,7 @@ export function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourc
     return (_jsx("div", { className: classes?.container ||
             cn("anyspend-container anyspend-qr-deposit font-inter bg-as-surface-primary mx-auto w-full max-w-[460px] p-6", mode === "page" && "border-as-border-secondary overflow-hidden rounded-2xl border shadow-xl"), children: _jsxs("div", { className: classes?.content || "anyspend-qr-deposit-content flex flex-col gap-4", children: [_jsxs("div", { className: classes?.header || "anyspend-qr-header flex items-center justify-between", children: [_jsx("button", { onClick: handleBack, className: classes?.backButton || "anyspend-qr-back-button text-as-secondary hover:text-as-primary", children: _jsx("svg", { className: "h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 19l-7-7 7-7" }) }) }), _jsx("h2", { className: classes?.title || "anyspend-qr-title text-as-primary text-base font-semibold", children: "Deposit" }), onClose ? (_jsx("button", { onClick: handleClose, className: classes?.closeButton || "anyspend-qr-close-button text-as-secondary hover:text-as-primary", children: _jsx("svg", { className: "h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })) : (_jsx("div", { className: "w-5" }))] }), _jsxs("div", { className: classes?.tokenSelectorContainer || "anyspend-qr-token-selector flex flex-col gap-1.5", children: [_jsx("label", { className: classes?.tokenSelectorLabel || "anyspend-qr-token-label text-as-secondary text-sm", children: "Send" }), _jsx(TokenSelector, { chainIdsFilter: getAvailableChainIds("from"), context: "from", fromChainWalletVMSupported: true, isValidAddress: true, lockedChainIds: getAvailableChainIds("from"), multiWalletSupportEnabled: true, onAnalyticEvent: undefined, setToken: handleTokenSelect, supportedWalletVMs: ["evm"], token: undefined, trigger: _jsxs(Button, { variant: "outline", role: "combobox", className: classes?.tokenSelectorTrigger ||
                                     "anyspend-qr-token-trigger border-as-stroke bg-as-surface-secondary flex h-auto w-full items-center justify-between gap-2 rounded-xl border px-3 py-2.5", children: [_jsxs("div", { className: "flex items-center gap-2", children: [sourceToken.metadata?.logoURI ? (_jsx(ChainTokenIcon, { chainUrl: ALL_CHAINS[sourceChainId]?.logoUrl, tokenUrl: sourceToken.metadata.logoURI, className: "h-8 min-h-8 w-8 min-w-8" })) : (_jsx("div", { className: "h-8 w-8 rounded-full bg-gray-700" })), _jsxs("div", { className: "flex flex-col items-start gap-0", children: [_jsx("div", { className: "text-as-primary font-semibold", children: sourceToken.symbol }), _jsx("div", { className: "text-as-primary/70 text-xs", children: ALL_CHAINS[sourceChainId]?.name ?? "Unknown" })] })] }), _jsx(ChevronsUpDown, { className: "h-4 w-4 shrink-0 opacity-70" })] }) })] }), _jsxs("div", { className: classes?.qrContent || "anyspend-qr-content border-as-stroke flex items-start gap-4 rounded-xl border p-4", children: [_jsxs("div", { className: classes?.qrCodeContainer || "anyspend-qr-code-container flex flex-col items-center gap-2", children: [_jsx("div", { className: classes?.qrCode || "anyspend-qr-code rounded-lg bg-white p-2", children: _jsx(QRCodeSVG, { value: qrValue, size: 120, level: "M", marginSize: 0 }) }), _jsxs("span", { className: classes?.qrScanHint || "anyspend-qr-scan-hint text-as-secondary text-xs", children: ["SCAN WITH ", _jsx("span", { className: "inline-block", children: "\uD83E\uDD8A" })] })] }), _jsxs("div", { className: classes?.addressContainer || "anyspend-qr-address-container flex flex-1 flex-col gap-1", children: [_jsx("span", { className: classes?.addressLabel || "anyspend-qr-address-label text-as-secondary text-sm", children: "Deposit address:" }), _jsxs("div", { className: classes?.addressRow || "anyspend-qr-address-row flex items-start gap-1", children: [_jsx("span", { className: classes?.address || "anyspend-qr-address text-as-primary break-all font-mono text-sm leading-relaxed", children: displayAddress }), _jsx("button", { onClick: handleCopyAddress, className: classes?.addressCopyIcon ||
-                                                "anyspend-qr-copy-icon text-as-secondary hover:text-as-primary mt-0.5 shrink-0", children: copied ? _jsx(Check, { className: "h-4 w-4" }) : _jsx(Copy, { className: "h-4 w-4" }) })] })] })] }), _jsx(ChainWarningText, { chainId: destinationChainId }), _jsxs(WarningText, { children: ["Only send ", sourceToken.symbol, " on ", ALL_CHAINS[sourceChainId]?.name ?? "the specified chain", ". Other tokens will not be converted."] }), isPureTransfer && isWatchingTransfer && (_jsxs("div", { className: classes?.watchingIndicator ||
+                                                "anyspend-qr-copy-icon text-as-secondary hover:text-as-primary mt-0.5 shrink-0", children: copied ? _jsx(Check, { className: "h-4 w-4" }) : _jsx(Copy, { className: "h-4 w-4" }) })] })] })] }), _jsx(ChainWarningText, { chainId: effectiveDestinationChainId }), _jsxs(WarningText, { children: ["Only send ", sourceToken.symbol, " on ", ALL_CHAINS[sourceChainId]?.name ?? "the specified chain", ". Other tokens will not be converted."] }), isPureTransfer && isWatchingTransfer && (_jsxs("div", { className: classes?.watchingIndicator ||
                         "anyspend-qr-watching flex items-center justify-center gap-2 rounded-lg bg-blue-500/10 p-3", children: [_jsx(Loader2, { className: "h-4 w-4 animate-spin text-blue-500" }), _jsx("span", { className: "text-sm text-blue-500", children: "Watching for incoming transfer..." })] })), _jsx("button", { onClick: handleCopyAddress, className: classes?.copyButton ||
                         "anyspend-qr-copy-button flex w-full items-center justify-center gap-2 rounded-xl bg-blue-500 py-3.5 font-medium text-white transition-all hover:bg-blue-600", children: "Copy deposit address" })] }) }));
 }

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

@@ -30,3 +30,14 @@ export declare function B3ConfigProvider({ children, accountOverride, environmen
     authStrategy?: AuthStrategy;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function useB3Config(): B3ConfigContextType;
+/**
+ * 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 declare function B3ConfigPartnerOverride({ partnerId, children }: {
+    partnerId: string;
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -31,3 +31,14 @@ export function useB3Config() {
     }
     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 }) {
+    const parent = useB3Config();
+    return _jsx(B3ConfigContext.Provider, { value: { ...parent, partnerId }, children: children });
+}

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

@@ -5,6 +5,7 @@ export { RelayKitProviderWrapper } from "./B3Provider/RelayKitProviderWrapper";
 export { useB3 } from "./B3Provider/useB3";
 export { useB3Account } from "./B3Provider/useB3Account";
 export { useB3Config } from "./B3Provider/useB3Config";
+export { B3ConfigPartnerOverride } from "./B3Provider/B3ConfigProvider";
 export { StyleRoot } from "./StyleRoot";
 export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
 export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";

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

@@ -6,6 +6,7 @@ export { RelayKitProviderWrapper } from "./B3Provider/RelayKitProviderWrapper.js
 export { useB3 } from "./B3Provider/useB3.js";
 export { useB3Account } from "./B3Provider/useB3Account.js";
 export { useB3Config } from "./B3Provider/useB3Config.js";
+export { B3ConfigPartnerOverride } from "./B3Provider/B3ConfigProvider.js";
 export { StyleRoot } from "./StyleRoot.js";
 // SignInWithB3 Components
 export { BetterAuthResetPassword } from "./SignInWithB3/BetterAuthResetPassword.js";

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

@@ -617,8 +617,16 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     destinationTokenAddress: string;
     /** The destination chain ID */
     destinationTokenChainId: number;
+    /**
+     * When false, the destination token is user-selectable even though a default destination token is
+     * provided (the provided destination is used only as the initial/default value). Used by the
+     * wallet-funding deposit flow so the user can change the receive token away from the default
+     * (Base USDC). Defaults to true (locked destination). Does not affect the QR/pure-transfer path. */
+    lockDestinationToken?: boolean;
     /** Callback when deposit succeeds */
     onSuccess?: (amount: string) => void;
+    /** Callback when the modal's close control is pressed. */
+    onClose?: () => void;
     /** Callback for opening a custom modal (e.g., for special token handling) */
     onOpenCustomModal?: () => void;
     /** Custom footer content */
@@ -661,6 +669,12 @@ export interface AnySpendDepositModalProps extends BaseModalProps {
     classes?: AnySpendAllClasses;
     /** Whether to allow direct transfer without swap */
     allowDirectTransfer?: boolean;
+    /**
+     * When true, the QR-deposit path is a PURE TRANSFER: the destination token/chain
+     * mirror the user's selected source token, so the exact token they send lands in
+     * their wallet on the same chain (no swap/bridge).
+     */
+    pureTransferOnly?: boolean;
     /** Opaque metadata passed to the order for callbacks (e.g., workflow form data) */
     callbackMetadata?: Record<string, unknown>;
 }