@b3dotfun/sdk 0.1.70-alpha.11 → 0.1.70-alpha.13

package/dist/cjs/anyspend/react/components/AnySpend.d.ts

@@ -28,6 +28,13 @@ export declare function AnySpend(props: {
     sourceChainId?: number;
     destinationTokenAddress?: string;
     destinationTokenChainId?: number;
+    /**
+     * When false, the destination token is user-selectable even if 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 buy-mode display, current behavior).
+     */
+    lockDestinationToken?: boolean;
     recipientAddress?: string;
     loadOrder?: string;
     hideTransactionHistoryButton?: boolean;

package/dist/cjs/anyspend/react/components/AnySpend.js

@@ -67,7 +67,7 @@ function AnySpend(props) {
     const fingerprintConfig = (0, AnySpendFingerprintWrapper_1.getFingerprintConfig)();
     return ((0, jsx_runtime_1.jsx)(AnySpendFingerprintWrapper_1.AnySpendFingerprintWrapper, { fingerprint: fingerprintConfig, children: (0, jsx_runtime_1.jsx)(AnySpendCustomizationContext_1.AnySpendCustomizationProvider, { slots: props.slots, content: props.content, theme: props.theme, children: (0, jsx_runtime_1.jsx)(AnySpendInner, { ...props }) }) }));
 }
-function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationTokenChainId, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, hideHeader, hideBottomNavigation = false, disableUrlParamManagement = false, returnToHomeUrl, customRecipientLabel, returnHomeLabel, classes, allowDirectTransfer = false, destinationTokenAmount, callbackMetadata, senderAddress, kycEnabled = false, showFiatOption = true, }) {
+function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationTokenChainId, lockDestinationToken = true, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, hideHeader, hideBottomNavigation = false, disableUrlParamManagement = false, returnToHomeUrl, customRecipientLabel, returnHomeLabel, classes, allowDirectTransfer = false, destinationTokenAmount, callbackMetadata, senderAddress, kycEnabled = false, showFiatOption = true, }) {
     const { slots, content } = (0, AnySpendCustomizationContext_1.useAnySpendCustomization)();
     const searchParams = (0, react_2.useSearchParamsSSR)();
     const router = (0, react_2.useRouter)();
@@ -81,8 +81,10 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     // in the same frame that onStatusResolved sets it (setState is async).
     // When kycEnabled is false (default), pre-approve so the KYC gate is skipped.
     const kycApprovedRef = (0, react_4.useRef)(!kycEnabled);
-    // Determine if we're in "buy mode" based on whether destination token props are provided
-    const isBuyMode = !!(destinationTokenAddress && destinationTokenChainId);
+    // Determine if we're in "buy mode" based on whether destination token props are provided.
+    // When lockDestinationToken is false, the provided destination is only a default and the user
+    // can change the receive token, so we stay out of buy mode (selectable swap mode).
+    const isBuyMode = !!(destinationTokenAddress && destinationTokenChainId) && lockDestinationToken;
     // Add refs to track URL state
     const initialUrlProcessed = (0, react_4.useRef)(false);
     const lastUrlUpdate = (0, react_4.useRef)(null);
@@ -142,9 +144,14 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     (0, react_4.useEffect)(() => {
         sessionStorage.setItem("anyspend_fiat_method", selectedFiatPaymentMethod);
     }, [selectedFiatPaymentMethod]);
+    // Whether a default destination token was provided. When lockDestinationToken is false this is
+    // used only as the INITIAL/default value (the user can still change the receive token), so the
+    // wallet-funding deposit flow defaults to Base USDC but stays selectable.
+    const hasProvidedDestination = !!(destinationTokenAddress && destinationTokenChainId);
     // Get initial chain IDs from URL or defaults
     const initialSrcChainId = sourceChainId || parseInt(searchParams.get("fromChainId") || "0") || chains_1.mainnet.id;
-    const initialDstChainId = parseInt(searchParams.get("toChainId") || "0") || (isBuyMode ? destinationTokenChainId : chains_1.base.id);
+    const initialDstChainId = parseInt(searchParams.get("toChainId") || "0") ||
+        (isBuyMode ? destinationTokenChainId : hasProvidedDestination ? destinationTokenChainId : chains_1.base.id);
     // State for source chain/token selection
     const [selectedSrcChainId, setSelectedSrcChainId] = (0, react_4.useState)(initialSrcChainId);
     const defaultSrcToken = (0, anyspend_1.getDefaultToken)(selectedSrcChainId);
@@ -181,19 +188,25 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     });
     // Helper to check if address is Hyperliquid USDC (supports both 34-char and 42-char formats)
     const isHyperliquidUSDCAddress = (address) => (0, anyspend_1.eqci)(address, anyspend_1.HYPERLIQUID_USDC_ADDRESS) || (0, anyspend_1.eqci)(address, anyspend_1.ZERO_ADDRESS);
-    const defaultDstToken = isBuyMode
-        ? // Special case: Hyperliquid uses zero address for USDC
-            destinationTokenChainId === anyspend_1.HYPERLIQUID_CHAIN_ID && isHyperliquidUSDCAddress(destinationTokenAddress)
-                ? (0, anyspend_1.getHyperliquidUSDCToken)()
-                : {
-                    symbol: "",
-                    chainId: destinationTokenChainId,
-                    address: destinationTokenAddress,
-                    name: "",
-                    decimals: 18,
-                    metadata: {},
-                }
-        : (0, anyspend_1.getDefaultToken)(selectedDstChainId);
+    // Build a token object from the provided destination props (handles the Hyperliquid USDC special case).
+    // The inline truthiness check lets TypeScript narrow both props to non-null, so it is `undefined`
+    // unless both props are provided — i.e. only meaningful when hasProvidedDestination/isBuyMode is true.
+    const providedDstToken = destinationTokenChainId && destinationTokenAddress
+        ? destinationTokenChainId === anyspend_1.HYPERLIQUID_CHAIN_ID && isHyperliquidUSDCAddress(destinationTokenAddress)
+            ? (0, anyspend_1.getHyperliquidUSDCToken)()
+            : {
+                symbol: "",
+                chainId: destinationTokenChainId,
+                address: destinationTokenAddress,
+                name: "",
+                decimals: 18,
+                metadata: {},
+            }
+        : undefined;
+    // In buy mode the provided destination is locked. Otherwise, if a default destination was provided
+    // (selectable deposit flow) seed it as the default; falling back to the chain's default token only
+    // when no destination prop is given (standard swap mode).
+    const defaultDstToken = (isBuyMode || hasProvidedDestination) && providedDstToken ? providedDstToken : (0, anyspend_1.getDefaultToken)(selectedDstChainId);
     const dstTokenFromUrl = (0, react_2.useTokenFromUrl)({
         defaultToken: defaultDstToken,
         prefix: "to",

package/dist/cjs/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/cjs/anyspend/react/components/AnySpendDeposit.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnySpendDeposit = AnySpendDeposit;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const anyspend_1 = require("../../../anyspend");
 const react_1 = require("../../../global-account/react");
 const cn_1 = require("../../../shared/utils/cn");
 const react_2 = require("@web3icons/react");
@@ -24,6 +25,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 = {
+    [`${anyspend_1.USDC_BASE.chainId}:${anyspend_1.USDC_BASE.address.toLowerCase()}`]: anyspend_1.USDC_BASE,
+};
+function getKnownFundingToken(chainId, address) {
+    return KNOWN_FUNDING_TOKENS[`${chainId}:${address.toLowerCase()}`];
+}
 function formatUsd(value) {
     return new Intl.NumberFormat("en-US", {
         style: "currency",
@@ -97,7 +111,7 @@ function ChainIcon({ chainId, className }) {
  *   onSuccess={(amount) => console.log(`Deposited ${amount}`)}
  * />
  */
-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, }) {
+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 } = (0, react_1.useAccountWallet)();
@@ -114,16 +128,22 @@ function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, paymentT
         }
     }, [showFiatOption, paymentType]);
     // Fetch destination token data
-    const { data: destinationTokenData } = (0, react_1.useTokenData)(destinationTokenChainId, destinationTokenAddress);
-    // Construct full destination token object
-    const destinationToken = (0, react_3.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 } = (0, react_1.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 = (0, react_3.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 } = (0, react_1.useSimBalance)(shouldShowChainSelection ? effectiveBalanceAddress : undefined, supportedChains.map(c => c.id));
@@ -165,6 +185,9 @@ function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, paymentT
     const totalBalance = (0, react_3.useMemo)(() => {
         return Object.values(chainBalances).reduce((sum, chain) => sum + chain.totalUsdValue, 0);
     }, [chainBalances]);
+    const handleQRDepositSuccess = (0, react_3.useCallback)((txHash) => {
+        onSuccess?.(txHash ?? "");
+    }, [onSuccess]);
     if (!recipientAddress)
         return null;
     const tokenSymbol = destinationToken.symbol || "TOKEN";
@@ -211,10 +234,24 @@ function AnySpendDeposit({ loadOrder, mode = "modal", recipientAddress, paymentT
     }
     // QR Deposit view
     if (step === "qr-deposit") {
-        return ((0, jsx_runtime_1.jsx)(QRDeposit_1.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 ((0, jsx_runtime_1.jsx)("div", { className: (0, cn_1.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: (0, jsx_runtime_1.jsxs)("div", { className: "anyspend-deposit-qr-loading-content flex flex-col items-center justify-center gap-4 py-12", children: [(0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-8 w-8 rounded-full" }), (0, jsx_runtime_1.jsx)(react_1.Skeleton, { className: "h-4 w-40" })] }) }));
+        }
+        return ((0, jsx_runtime_1.jsx)(QRDeposit_1.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 ((0, jsx_runtime_1.jsxs)("div", { className: depositClasses?.form || "anyspend-deposit anyspend-deposit-form relative", children: [shouldShowChainSelection && ((0, jsx_runtime_1.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: [(0, jsx_runtime_1.jsx)("svg", { className: depositClasses?.backIcon || "anyspend-deposit-back-icon h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 19l-7-7 7-7" }) }), (0, jsx_runtime_1.jsx)("span", { className: depositClasses?.backText || "anyspend-deposit-back-text text-sm", children: "Back" })] })), onClose && ((0, jsx_runtime_1.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: (0, jsx_runtime_1.jsx)("svg", { className: "h-6 w-6", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })), (0, jsx_runtime_1.jsx)("div", { className: depositClasses?.formContent || (0, cn_1.cn)("anyspend-deposit-form-content", shouldShowChainSelection && "pt-8"), children: isCustomDeposit ? ((0, jsx_runtime_1.jsx)(AnySpendCustomExactIn_1.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)) : ((0, jsx_runtime_1.jsx)(AnySpend_1.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)) }), (0, jsx_runtime_1.jsx)(WarningText_1.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: (0, jsx_runtime_1.jsx)("svg", { className: "h-6 w-6", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })), (0, jsx_runtime_1.jsx)("div", { className: depositClasses?.formContent || (0, cn_1.cn)("anyspend-deposit-form-content", shouldShowChainSelection && "pt-8"), children: isCustomDeposit ? ((0, jsx_runtime_1.jsx)(AnySpendCustomExactIn_1.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)) : ((0, jsx_runtime_1.jsx)(AnySpend_1.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)) }), (0, jsx_runtime_1.jsx)(WarningText_1.ChainWarningText, { chainId: destinationTokenChainId, classes: classes?.chainWarningText || { root: "px-4 pb-4" } })] }));
 }

package/dist/cjs/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/cjs/anyspend/react/components/QRDeposit.js

@@ -42,28 +42,35 @@ const DEFAULT_ETH_ON_BASE = {
  *   onSuccess={(txHash) => console.log("Deposit complete:", txHash)}
  * />
  */
-function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }) {
+function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenProp, sourceChainId: sourceChainIdProp, destinationToken, destinationChainId, pureTransferOnly = false, creatorAddress, depositContractConfig, onBack, onClose, onOrderCreated, onSuccess, classes, }) {
     const [copied, setCopied] = (0, react_2.useState)(false);
     const [orderId, setOrderId] = (0, react_2.useState)();
     const [globalAddress, setGlobalAddress] = (0, react_2.useState)();
     const orderCreatedRef = (0, react_2.useRef)(false);
     const [transferResult, setTransferResult] = (0, react_2.useState)(null);
-    // Source token/chain as state (can be changed by user)
-    const [sourceChainId, setSourceChainId] = (0, react_2.useState)(sourceChainIdProp ?? 8453);
-    const [sourceToken, setSourceToken] = (0, react_2.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] = (0, react_2.useState)(sourceChainIdProp ?? (pureTransferOnly ? destinationChainId : 8453));
+    const [sourceToken, setSourceToken] = (0, react_2.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 = (0, anyspend_1.isSameChainAndToken)(sourceChainId, sourceToken.address, destinationChainId, destinationToken.address);
+    const isPureTransfer = (0, anyspend_1.isSameChainAndToken)(sourceChainId, sourceToken.address, effectiveDestinationChainId, effectiveDestinationToken.address);
+    const handleTransferDetected = (0, react_2.useCallback)((result) => {
+        setTransferResult(result);
+        onSuccess?.(result.formattedAmount);
+    }, [onSuccess]);
     // Watch for pure transfers (same chain and token)
-    const { isWatching: isWatchingTransfer } = (0, useWatchTransfer_1.useWatchTransfer)({
+    const { isWatching: isWatchingTransfer, reset: resetWatchTransfer } = (0, useWatchTransfer_1.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) => {
@@ -80,6 +87,8 @@ function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenP
         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);
@@ -110,18 +119,18 @@ function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenP
         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,
@@ -166,7 +175,7 @@ function QRDeposit({ mode = "modal", recipientAddress, sourceToken: sourceTokenP
     return ((0, jsx_runtime_1.jsx)("div", { className: classes?.container ||
             (0, cn_1.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: (0, jsx_runtime_1.jsxs)("div", { className: classes?.content || "anyspend-qr-deposit-content flex flex-col gap-4", children: [(0, jsx_runtime_1.jsxs)("div", { className: classes?.header || "anyspend-qr-header flex items-center justify-between", children: [(0, jsx_runtime_1.jsx)("button", { onClick: handleBack, className: classes?.backButton || "anyspend-qr-back-button text-as-secondary hover:text-as-primary", children: (0, jsx_runtime_1.jsx)("svg", { className: "h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M15 19l-7-7 7-7" }) }) }), (0, jsx_runtime_1.jsx)("h2", { className: classes?.title || "anyspend-qr-title text-as-primary text-base font-semibold", children: "Deposit" }), onClose ? ((0, jsx_runtime_1.jsx)("button", { onClick: handleClose, className: classes?.closeButton || "anyspend-qr-close-button text-as-secondary hover:text-as-primary", children: (0, jsx_runtime_1.jsx)("svg", { className: "h-5 w-5", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) }) })) : ((0, jsx_runtime_1.jsx)("div", { className: "w-5" }))] }), (0, jsx_runtime_1.jsxs)("div", { className: classes?.tokenSelectorContainer || "anyspend-qr-token-selector flex flex-col gap-1.5", children: [(0, jsx_runtime_1.jsx)("label", { className: classes?.tokenSelectorLabel || "anyspend-qr-token-label text-as-secondary text-sm", children: "Send" }), (0, jsx_runtime_1.jsx)(relay_kit_ui_1.TokenSelector, { chainIdsFilter: (0, anyspend_1.getAvailableChainIds)("from"), context: "from", fromChainWalletVMSupported: true, isValidAddress: true, lockedChainIds: (0, anyspend_1.getAvailableChainIds)("from"), multiWalletSupportEnabled: true, onAnalyticEvent: undefined, setToken: handleTokenSelect, supportedWalletVMs: ["evm"], token: undefined, trigger: (0, jsx_runtime_1.jsxs)(react_1.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: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2", children: [sourceToken.metadata?.logoURI ? ((0, jsx_runtime_1.jsx)(ChainTokenIcon_1.ChainTokenIcon, { chainUrl: anyspend_1.ALL_CHAINS[sourceChainId]?.logoUrl, tokenUrl: sourceToken.metadata.logoURI, className: "h-8 min-h-8 w-8 min-w-8" })) : ((0, jsx_runtime_1.jsx)("div", { className: "h-8 w-8 rounded-full bg-gray-700" })), (0, jsx_runtime_1.jsxs)("div", { className: "flex flex-col items-start gap-0", children: [(0, jsx_runtime_1.jsx)("div", { className: "text-as-primary font-semibold", children: sourceToken.symbol }), (0, jsx_runtime_1.jsx)("div", { className: "text-as-primary/70 text-xs", children: anyspend_1.ALL_CHAINS[sourceChainId]?.name ?? "Unknown" })] })] }), (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronsUpDown, { className: "h-4 w-4 shrink-0 opacity-70" })] }) })] }), (0, jsx_runtime_1.jsxs)("div", { className: classes?.qrContent || "anyspend-qr-content border-as-stroke flex items-start gap-4 rounded-xl border p-4", children: [(0, jsx_runtime_1.jsxs)("div", { className: classes?.qrCodeContainer || "anyspend-qr-code-container flex flex-col items-center gap-2", children: [(0, jsx_runtime_1.jsx)("div", { className: classes?.qrCode || "anyspend-qr-code rounded-lg bg-white p-2", children: (0, jsx_runtime_1.jsx)(qrcode_react_1.QRCodeSVG, { value: qrValue, size: 120, level: "M", marginSize: 0 }) }), (0, jsx_runtime_1.jsxs)("span", { className: classes?.qrScanHint || "anyspend-qr-scan-hint text-as-secondary text-xs", children: ["SCAN WITH ", (0, jsx_runtime_1.jsx)("span", { className: "inline-block", children: "\uD83E\uDD8A" })] })] }), (0, jsx_runtime_1.jsxs)("div", { className: classes?.addressContainer || "anyspend-qr-address-container flex flex-1 flex-col gap-1", children: [(0, jsx_runtime_1.jsx)("span", { className: classes?.addressLabel || "anyspend-qr-address-label text-as-secondary text-sm", children: "Deposit address:" }), (0, jsx_runtime_1.jsxs)("div", { className: classes?.addressRow || "anyspend-qr-address-row flex items-start gap-1", children: [(0, jsx_runtime_1.jsx)("span", { className: classes?.address || "anyspend-qr-address text-as-primary break-all font-mono text-sm leading-relaxed", children: displayAddress }), (0, jsx_runtime_1.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 ? (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { className: "h-4 w-4" }) : (0, jsx_runtime_1.jsx)(lucide_react_1.Copy, { className: "h-4 w-4" }) })] })] })] }), (0, jsx_runtime_1.jsx)(WarningText_1.ChainWarningText, { chainId: destinationChainId }), (0, jsx_runtime_1.jsxs)(WarningText_1.WarningText, { children: ["Only send ", sourceToken.symbol, " on ", anyspend_1.ALL_CHAINS[sourceChainId]?.name ?? "the specified chain", ". Other tokens will not be converted."] }), isPureTransfer && isWatchingTransfer && ((0, jsx_runtime_1.jsxs)("div", { className: classes?.watchingIndicator ||
+                                                "anyspend-qr-copy-icon text-as-secondary hover:text-as-primary mt-0.5 shrink-0", children: copied ? (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { className: "h-4 w-4" }) : (0, jsx_runtime_1.jsx)(lucide_react_1.Copy, { className: "h-4 w-4" }) })] })] })] }), (0, jsx_runtime_1.jsx)(WarningText_1.ChainWarningText, { chainId: effectiveDestinationChainId }), (0, jsx_runtime_1.jsxs)(WarningText_1.WarningText, { children: ["Only send ", sourceToken.symbol, " on ", anyspend_1.ALL_CHAINS[sourceChainId]?.name ?? "the specified chain", ". Other tokens will not be converted."] }), isPureTransfer && isWatchingTransfer && ((0, jsx_runtime_1.jsxs)("div", { className: classes?.watchingIndicator ||
                         "anyspend-qr-watching flex items-center justify-center gap-2 rounded-lg bg-blue-500/10 p-3", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Loader2, { className: "h-4 w-4 animate-spin text-blue-500" }), (0, jsx_runtime_1.jsx)("span", { className: "text-sm text-blue-500", children: "Watching for incoming transfer..." })] })), (0, jsx_runtime_1.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/cjs/global-account/react/components/SignInWithB3/BetterAuthSignIn.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BetterAuthSignIn = BetterAuthSignIn;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("../../../../global-account/react");
+const utils_1 = require("../../../../shared/utils");
 const debug_1 = require("../../../../shared/utils/debug");
 const react_2 = require("react");
 const useBetterAuth_1 = require("../../hooks/useBetterAuth");
@@ -16,6 +17,7 @@ const DEFAULT_SOCIAL_PROVIDERS = [
     { id: "discord", label: "Discord" },
     { id: "microsoft", label: "Microsoft" },
     { id: "slack", label: "Slack" },
+    { id: "twitter", label: "X" },
 ];
 /**
  * Standalone inline sign-in component for Better Auth.
@@ -165,7 +167,7 @@ function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access
                             const icon = signInUtils_1.strategyIcons[provider.id];
                             const label = signInUtils_1.strategyLabels[provider.id] || provider.label;
                             const isProviderLoading = loadingProvider === provider.id;
-                            return ((0, jsx_runtime_1.jsxs)("button", { onClick: () => handleSocialSignIn(provider.id), disabled: isLoading, style: { paddingTop: "12px", paddingBottom: "12px" }, className: "flex w-full items-center justify-center gap-3 rounded-lg border border-gray-200 bg-white px-4 text-[14px] font-medium text-gray-700 transition-colors hover:bg-gray-50 disabled:opacity-50 dark:border-gray-700 dark:bg-gray-800 dark:text-gray-200 dark:hover:bg-gray-700", children: [isProviderLoading ? ((0, jsx_runtime_1.jsxs)("svg", { className: "h-5 w-5 animate-spin text-gray-400", viewBox: "0 0 24 24", fill: "none", children: [(0, jsx_runtime_1.jsx)("circle", { className: "opacity-25", cx: "12", cy: "12", r: "10", stroke: "currentColor", strokeWidth: "4" }), (0, jsx_runtime_1.jsx)("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" })] })) : (icon && (0, jsx_runtime_1.jsx)("img", { src: icon, alt: "", className: "h-5 w-5" })), (0, jsx_runtime_1.jsx)("span", { children: isProviderLoading ? "Redirecting..." : label })] }, provider.id));
+                            return ((0, jsx_runtime_1.jsxs)("button", { onClick: () => handleSocialSignIn(provider.id), disabled: isLoading, style: { paddingTop: "12px", paddingBottom: "12px" }, className: "flex w-full items-center justify-center gap-3 rounded-lg border border-gray-200 bg-white px-4 text-[14px] font-medium text-gray-700 transition-colors hover:bg-gray-50 disabled:opacity-50 dark:border-gray-700 dark:bg-gray-800 dark:text-gray-200 dark:hover:bg-gray-700", children: [isProviderLoading ? ((0, jsx_runtime_1.jsxs)("svg", { className: "h-5 w-5 animate-spin text-gray-400", viewBox: "0 0 24 24", fill: "none", children: [(0, jsx_runtime_1.jsx)("circle", { className: "opacity-25", cx: "12", cy: "12", r: "10", stroke: "currentColor", strokeWidth: "4" }), (0, jsx_runtime_1.jsx)("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z" })] })) : (icon && ((0, jsx_runtime_1.jsx)("img", { src: icon, alt: "", className: (0, utils_1.cn)("h-5 w-5", (provider.id === "github" || provider.id === "twitter") && "dark:invert") }))), (0, jsx_runtime_1.jsx)("span", { children: isProviderLoading ? "Redirecting..." : label })] }, provider.id));
                         }) })] })), showEmail && mode !== "forgot-password" && ((0, jsx_runtime_1.jsxs)("p", { className: "mt-8 text-center text-[14px] text-gray-500 dark:text-gray-400", children: [mode === "sign-in" ? "Don't have an account? " : "Already have an account? ", (0, jsx_runtime_1.jsx)("button", { onClick: () => {
                             setMode(mode === "sign-in" ? "sign-up" : "sign-in");
                             setError(null);

package/dist/cjs/global-account/react/components/SignInWithB3/components/AuthButton.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthButton = AuthButton;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const Button_1 = require("../../custom/Button");
+const utils_1 = require("../../../../../shared/utils");
 const lucide_react_1 = require("lucide-react");
 const signInUtils_1 = require("../utils/signInUtils");
 const fallbackIcons = {
@@ -14,5 +15,5 @@ function AuthButton({ strategy, onClick, isLoading, }) {
     const strategyLabel = signInUtils_1.strategyLabels[strategy] || strategy;
     const FallbackIcon = fallbackIcons[strategy];
     const buttonLabel = `Sign in with ${strategyLabel}`;
-    return ((0, jsx_runtime_1.jsx)(Button_1.Button, { onClick: onClick, disabled: isLoading, "aria-label": buttonLabel, title: buttonLabel, className: "flex w-full items-center justify-center bg-gray-100 px-2 py-3 hover:bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-700", children: strategyIcon ? ((0, jsx_runtime_1.jsx)("img", { src: strategyIcon, alt: `${strategyLabel} icon`, className: "h-9 w-9" })) : FallbackIcon ? ((0, jsx_runtime_1.jsx)(FallbackIcon, { className: "h-9 w-9 text-gray-900 dark:text-gray-100" })) : ((0, jsx_runtime_1.jsx)("span", { className: "text-sm font-semibold text-gray-900 dark:text-gray-100", children: strategyLabel.charAt(0) })) }, strategy));
+    return ((0, jsx_runtime_1.jsx)(Button_1.Button, { onClick: onClick, disabled: isLoading, "aria-label": buttonLabel, title: buttonLabel, className: "flex w-full items-center justify-center bg-gray-100 px-2 py-3 hover:bg-gray-200 dark:bg-gray-800 dark:hover:bg-gray-700", children: strategyIcon ? ((0, jsx_runtime_1.jsx)("img", { src: strategyIcon, alt: `${strategyLabel} icon`, className: (0, utils_1.cn)("h-9 w-9", (strategy === "github" || strategy === "twitter" || strategy === "x") && "dark:invert") })) : FallbackIcon ? ((0, jsx_runtime_1.jsx)(FallbackIcon, { className: "h-9 w-9 text-gray-900 dark:text-gray-100" })) : ((0, jsx_runtime_1.jsx)("span", { className: "text-sm font-semibold text-gray-900 dark:text-gray-100", children: strategyLabel.charAt(0) })) }, strategy));
 }

package/dist/cjs/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.js

@@ -16,6 +16,7 @@ const SOCIAL_PROVIDERS = [
     { id: "discord", label: "Discord" },
     { id: "microsoft", label: "Microsoft" },
     { id: "slack", label: "Slack" },
+    { id: "twitter", label: "X" },
 ];
 function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }) {
     const { partnerId } = (0, react_1.useB3Config)();

package/dist/cjs/global-account/react/components/SignInWithB3/utils/signInUtils.js

@@ -49,6 +49,7 @@ exports.strategyIcons = {
     google: "https://cdn.b3.fun/google.svg",
     github: "https://cdn.jsdelivr.net/gh/devicons/devicon/icons/github/github-original.svg",
     x: "https://cdn.b3.fun/x.svg?1",
+    twitter: "https://cdn.b3.fun/x.svg?1",
     discord: "https://cdn.b3.fun/discord.svg",
     apple: "https://cdn.b3.fun/apple.svg",
     guest: "https://cdn.b3.fun/incognito.svg",
@@ -58,6 +59,7 @@ exports.strategyIcons = {
 exports.strategyLabels = {
     google: "Google",
     x: "X",
+    twitter: "X",
     discord: "Discord",
     apple: "Apple",
     guest: "Guest",

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

@@ -1,4 +1,4 @@
-export type BetterAuthSocialProvider = "google" | "discord" | "apple" | "github" | "slack" | "microsoft";
+export type BetterAuthSocialProvider = "google" | "discord" | "apple" | "github" | "slack" | "microsoft" | "twitter";
 /** Thrown when email verification is required before the user can sign in. */
 export declare class EmailVerificationRequiredError extends Error {
     constructor(message?: string);

package/dist/cjs/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>;
 }

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

@@ -28,6 +28,13 @@ export declare function AnySpend(props: {
     sourceChainId?: number;
     destinationTokenAddress?: string;
     destinationTokenChainId?: number;
+    /**
+     * When false, the destination token is user-selectable even if 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 buy-mode display, current behavior).
+     */
+    lockDestinationToken?: boolean;
     recipientAddress?: string;
     loadOrder?: string;
     hideTransactionHistoryButton?: boolean;

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

@@ -60,7 +60,7 @@ export function AnySpend(props) {
     const fingerprintConfig = getFingerprintConfig();
     return (_jsx(AnySpendFingerprintWrapper, { fingerprint: fingerprintConfig, children: _jsx(AnySpendCustomizationProvider, { slots: props.slots, content: props.content, theme: props.theme, children: _jsx(AnySpendInner, { ...props }) }) }));
 }
-function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationTokenChainId, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, hideHeader, hideBottomNavigation = false, disableUrlParamManagement = false, returnToHomeUrl, customRecipientLabel, returnHomeLabel, classes, allowDirectTransfer = false, destinationTokenAmount, callbackMetadata, senderAddress, kycEnabled = false, showFiatOption = true, }) {
+function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationTokenChainId, lockDestinationToken = true, mode = "modal", defaultActiveTab = "crypto", loadOrder, hideTransactionHistoryButton, recipientAddress: recipientAddressFromProps, onTokenSelect, onSuccess, customUsdInputValues, hideHeader, hideBottomNavigation = false, disableUrlParamManagement = false, returnToHomeUrl, customRecipientLabel, returnHomeLabel, classes, allowDirectTransfer = false, destinationTokenAmount, callbackMetadata, senderAddress, kycEnabled = false, showFiatOption = true, }) {
     const { slots, content } = useAnySpendCustomization();
     const searchParams = useSearchParamsSSR();
     const router = useRouter();
@@ -74,8 +74,10 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     // in the same frame that onStatusResolved sets it (setState is async).
     // When kycEnabled is false (default), pre-approve so the KYC gate is skipped.
     const kycApprovedRef = useRef(!kycEnabled);
-    // Determine if we're in "buy mode" based on whether destination token props are provided
-    const isBuyMode = !!(destinationTokenAddress && destinationTokenChainId);
+    // Determine if we're in "buy mode" based on whether destination token props are provided.
+    // When lockDestinationToken is false, the provided destination is only a default and the user
+    // can change the receive token, so we stay out of buy mode (selectable swap mode).
+    const isBuyMode = !!(destinationTokenAddress && destinationTokenChainId) && lockDestinationToken;
     // Add refs to track URL state
     const initialUrlProcessed = useRef(false);
     const lastUrlUpdate = useRef(null);
@@ -135,9 +137,14 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     useEffect(() => {
         sessionStorage.setItem("anyspend_fiat_method", selectedFiatPaymentMethod);
     }, [selectedFiatPaymentMethod]);
+    // Whether a default destination token was provided. When lockDestinationToken is false this is
+    // used only as the INITIAL/default value (the user can still change the receive token), so the
+    // wallet-funding deposit flow defaults to Base USDC but stays selectable.
+    const hasProvidedDestination = !!(destinationTokenAddress && destinationTokenChainId);
     // Get initial chain IDs from URL or defaults
     const initialSrcChainId = sourceChainId || parseInt(searchParams.get("fromChainId") || "0") || mainnet.id;
-    const initialDstChainId = parseInt(searchParams.get("toChainId") || "0") || (isBuyMode ? destinationTokenChainId : base.id);
+    const initialDstChainId = parseInt(searchParams.get("toChainId") || "0") ||
+        (isBuyMode ? destinationTokenChainId : hasProvidedDestination ? destinationTokenChainId : base.id);
     // State for source chain/token selection
     const [selectedSrcChainId, setSelectedSrcChainId] = useState(initialSrcChainId);
     const defaultSrcToken = getDefaultToken(selectedSrcChainId);
@@ -174,19 +181,25 @@ function AnySpendInner({ sourceChainId, destinationTokenAddress, destinationToke
     });
     // Helper to check if address is Hyperliquid USDC (supports both 34-char and 42-char formats)
     const isHyperliquidUSDCAddress = (address) => eqci(address, HYPERLIQUID_USDC_ADDRESS) || eqci(address, ZERO_ADDRESS);
-    const defaultDstToken = isBuyMode
-        ? // Special case: Hyperliquid uses zero address for USDC
-            destinationTokenChainId === HYPERLIQUID_CHAIN_ID && isHyperliquidUSDCAddress(destinationTokenAddress)
-                ? getHyperliquidUSDCToken()
-                : {
-                    symbol: "",
-                    chainId: destinationTokenChainId,
-                    address: destinationTokenAddress,
-                    name: "",
-                    decimals: 18,
-                    metadata: {},
-                }
-        : getDefaultToken(selectedDstChainId);
+    // Build a token object from the provided destination props (handles the Hyperliquid USDC special case).
+    // The inline truthiness check lets TypeScript narrow both props to non-null, so it is `undefined`
+    // unless both props are provided — i.e. only meaningful when hasProvidedDestination/isBuyMode is true.
+    const providedDstToken = destinationTokenChainId && destinationTokenAddress
+        ? destinationTokenChainId === HYPERLIQUID_CHAIN_ID && isHyperliquidUSDCAddress(destinationTokenAddress)
+            ? getHyperliquidUSDCToken()
+            : {
+                symbol: "",
+                chainId: destinationTokenChainId,
+                address: destinationTokenAddress,
+                name: "",
+                decimals: 18,
+                metadata: {},
+            }
+        : undefined;
+    // In buy mode the provided destination is locked. Otherwise, if a default destination was provided
+    // (selectable deposit flow) seed it as the default; falling back to the chain's default token only
+    // when no destination prop is given (standard swap mode).
+    const defaultDstToken = (isBuyMode || hasProvidedDestination) && providedDstToken ? providedDstToken : getDefaultToken(selectedDstChainId);
     const dstTokenFromUrl = useTokenFromUrl({
         defaultToken: defaultDstToken,
         prefix: "to",