@b3dotfun/sdk 0.0.42 → 0.0.43-alpha.1

package/dist/cjs/global-account/react/components/ui/dropdown-menu.js

@@ -0,0 +1,100 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DropdownMenu = DropdownMenu;
+exports.DropdownMenuTrigger = DropdownMenuTrigger;
+exports.DropdownMenuContent = DropdownMenuContent;
+exports.DropdownMenuItem = DropdownMenuItem;
+exports.DropdownMenuSeparator = DropdownMenuSeparator;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const utils_1 = require("../../../../shared/utils");
+const React = __importStar(require("react"));
+const DropdownMenuContext = React.createContext({
+    isOpen: false,
+    setIsOpen: () => { },
+});
+function DropdownMenu({ children }) {
+    const [isOpen, setIsOpen] = React.useState(false);
+    React.useEffect(() => {
+        const handleClickOutside = (event) => {
+            const target = event.target;
+            if (!target.closest("[data-dropdown-menu]")) {
+                setIsOpen(false);
+            }
+        };
+        if (isOpen) {
+            document.addEventListener("click", handleClickOutside);
+            return () => document.removeEventListener("click", handleClickOutside);
+        }
+    }, [isOpen]);
+    return ((0, jsx_runtime_1.jsx)(DropdownMenuContext.Provider, { value: { isOpen, setIsOpen }, children: (0, jsx_runtime_1.jsx)("div", { className: "relative", "data-dropdown-menu": true, children: children }) }));
+}
+function DropdownMenuTrigger({ children, asChild }) {
+    const { isOpen, setIsOpen } = React.useContext(DropdownMenuContext);
+    const handleClick = () => {
+        setIsOpen(!isOpen);
+    };
+    if (asChild) {
+        if (React.isValidElement(children)) {
+            return React.cloneElement(children, {
+                onClick: handleClick,
+            });
+        }
+    }
+    return (0, jsx_runtime_1.jsx)("button", { onClick: handleClick, children: children });
+}
+function DropdownMenuContent({ children, align = "start", className }) {
+    const { isOpen } = React.useContext(DropdownMenuContext);
+    if (!isOpen)
+        return null;
+    const alignmentClasses = {
+        start: "left-0",
+        center: "left-1/2 -translate-x-1/2",
+        end: "right-0",
+    };
+    return ((0, jsx_runtime_1.jsx)("div", { className: (0, utils_1.cn)("bg-popover text-popover-foreground absolute top-full z-50 mt-1 min-w-32 overflow-hidden rounded-md border p-1 shadow-md", "border-gray-200 bg-white dark:border-gray-700 dark:bg-gray-800", alignmentClasses[align], className), children: children }));
+}
+function DropdownMenuItem({ children, onClick, className }) {
+    const { setIsOpen } = React.useContext(DropdownMenuContext);
+    const handleClick = () => {
+        onClick?.();
+        setIsOpen(false);
+    };
+    return ((0, jsx_runtime_1.jsx)("div", { className: (0, utils_1.cn)("hover:bg-accent hover:text-accent-foreground relative flex cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none transition-colors data-[disabled]:pointer-events-none data-[disabled]:opacity-50", "hover:bg-gray-100 dark:hover:bg-gray-700", className), onClick: handleClick, children: children }));
+}
+function DropdownMenuSeparator({ className }) {
+    return (0, jsx_runtime_1.jsx)("div", { className: (0, utils_1.cn)("bg-muted -mx-1 my-1 h-px", "bg-gray-200 dark:bg-gray-600", className) });
+}

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

@@ -117,11 +117,13 @@ export interface AnySpendModalProps extends BaseModalProps {
     /** Whether to hide the transaction history button */
     hideTransactionHistoryButton?: boolean;
     /** Callback function called when the transaction is successful */
-    onSuccess?: () => void;
+    onSuccess?: (txHash?: string) => void;
     /** Token address of the destination token to buy (enables buy mode) */
     destinationTokenAddress?: string;
     /** Chain ID where the destination token exists (enables buy mode) */
     destinationTokenChainId?: number;
+    /** Custom USD input values for quick amount buttons in fiat onramp */
+    customUsdInputValues?: string[];
 }
 /**
  * Props for the AnySpend NFT modal
@@ -290,6 +292,8 @@ export interface AnySpendDepositHypeProps extends BaseModalProps {
     mainFooter?: React.ReactNode;
     /** Callback function called when the deposit is successful */
     onSuccess?: (amount?: string) => void;
+    /** Custom USD input values for quick amount buttons in fiat onramp */
+    customUsdInputValues?: string[];
 }
 export interface AvatarEditorModalProps extends BaseModalProps {
     /** Modal type identifier */

package/dist/cjs/shared/constants/currency.d.ts

@@ -0,0 +1 @@
+export declare const B3_COIN_IMAGE_URL = "https://cdn.b3.fun/b3-coin-3d.png";

package/dist/cjs/shared/constants/currency.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.B3_COIN_IMAGE_URL = void 0;
+// B3 Token image URL
+exports.B3_COIN_IMAGE_URL = "https://cdn.b3.fun/b3-coin-3d.png";

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

@@ -1,3 +1,4 @@
+export * from "./currency";
 export declare const siteURL = "https://basement.fun";
 export declare const b3CoinIcon = "https://cdn.b3.fun/b3-coin-3d.png";
 export declare const ecosystemWalletId: `ecosystem.${string}`;

package/dist/cjs/shared/constants/index.js

@@ -1,6 +1,21 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PUBLIC_BASE_RPC_URL = exports.ENS_GATEWAY_URL = exports.B3_AUTH_COOKIE_NAME = exports.CLIENT_APP_BUNDLE_ID = exports.THIRDWEB_CLIENT_ID = exports.THIRDWEB_SECRET_KEY = exports.tokenIcons = exports.ecosystemWalletId = exports.b3CoinIcon = exports.siteURL = void 0;
+__exportStar(require("./currency"), exports);
 exports.siteURL = "https://basement.fun";
 exports.b3CoinIcon = "https://cdn.b3.fun/b3-coin-3d.png";
 exports.ecosystemWalletId = (process.env.NEXT_PUBLIC_THIRDWEB_ECOSYSTEM_ID ||

package/dist/cjs/shared/react/components/CurrencySelector.d.ts

@@ -0,0 +1,7 @@
+interface CurrencySelectorProps {
+    labelClassName?: string;
+    buttonVariant?: "dark" | "primary" | "ghost" | "gold";
+    label?: string;
+}
+export declare function CurrencySelector({ labelClassName, buttonVariant, label }: CurrencySelectorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cjs/shared/react/components/CurrencySelector.js

@@ -0,0 +1,14 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencySelector = CurrencySelector;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const utils_1 = require("../../../shared/utils");
+const button_1 = require("../../../global-account/react/components/ui/button");
+const dropdown_menu_1 = require("../../../global-account/react/components/ui/dropdown-menu");
+const currencyStore_1 = require("../stores/currencyStore");
+const currencies = ["B3", "ETH", "SOL", "USD", "EUR", "GBP", "KRW", "JPY", "CAD", "AUD"];
+function CurrencySelector({ labelClassName, buttonVariant = "dark", label }) {
+    const { selectedCurrency, setSelectedCurrency } = (0, currencyStore_1.useCurrencyStore)();
+    return ((0, jsx_runtime_1.jsx)("div", { className: "flex items-center gap-2", children: (0, jsx_runtime_1.jsxs)(dropdown_menu_1.DropdownMenu, { children: [(0, jsx_runtime_1.jsx)(dropdown_menu_1.DropdownMenuTrigger, { asChild: true, children: (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3", children: [label && ((0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)("text-foreground text-sm font-medium leading-none tracking-tight sm:text-base", labelClassName), children: label })), (0, jsx_runtime_1.jsxs)(button_1.Button, { variant: buttonVariant, className: "flex items-center gap-2", children: [(0, jsx_runtime_1.jsx)("span", { className: "text-sm font-medium", children: currencyStore_1.CURRENCY_NAMES[selectedCurrency] }), (0, jsx_runtime_1.jsx)("svg", { className: "h-4 w-4", fill: "currentColor", viewBox: "0 0 20 20", children: (0, jsx_runtime_1.jsx)("path", { fillRule: "evenodd", d: "M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z", clipRule: "evenodd" }) })] })] }) }), (0, jsx_runtime_1.jsx)(dropdown_menu_1.DropdownMenuContent, { align: "end", className: "z-[100] min-w-[200px]", children: currencies.map(currency => ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsxs)(dropdown_menu_1.DropdownMenuItem, { onClick: () => setSelectedCurrency(currency), className: `flex cursor-pointer items-center justify-between gap-3 px-3 py-2.5 transition-colors ${selectedCurrency === currency ? "bg-accent" : "hover:bg-accent/50"}`, children: [(0, jsx_runtime_1.jsx)("span", { className: "text-foreground text-sm font-medium", children: currencyStore_1.CURRENCY_NAMES[currency] }), (0, jsx_runtime_1.jsx)("span", { className: "text-muted-foreground text-xs font-medium", children: currencyStore_1.CURRENCY_SYMBOLS[currency] })] }), currency === "SOL" && (0, jsx_runtime_1.jsx)(dropdown_menu_1.DropdownMenuSeparator, { className: "bg-border my-1" }, "separator")] }, currency))) })] }) }));
+}

package/dist/cjs/shared/react/components/FormattedCurrency.d.ts

@@ -0,0 +1,12 @@
+interface FormattedCurrencyProps {
+    amount: number;
+    showChange?: boolean;
+    showColor?: boolean;
+    className?: string;
+    subB3Icon?: boolean;
+    clickable?: boolean;
+    decimals?: number;
+    currency?: string;
+}
+export declare function FormattedCurrency({ amount, showChange, showColor, className, subB3Icon, clickable, decimals, currency, }: FormattedCurrencyProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cjs/shared/react/components/FormattedCurrency.js

@@ -0,0 +1,60 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormattedCurrency = FormattedCurrency;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const currency_1 = require("../../../shared/constants/currency");
+const utils_1 = require("../../../shared/utils");
+const tooltip_1 = require("../../../global-account/react/components/ui/tooltip");
+const useCurrencyConversion_1 = require("../hooks/useCurrencyConversion");
+const currencyModalStore_1 = require("../stores/currencyModalStore");
+function FormattedCurrency({ amount, showChange = false, showColor = false, className, subB3Icon = true, clickable = true, decimals, currency, }) {
+    const { formatCurrencyValue, formatTooltipValue, selectedCurrency, baseCurrency } = (0, useCurrencyConversion_1.useCurrencyConversion)();
+    const { openModal } = (0, currencyModalStore_1.useCurrencyModalStore)();
+    // Use passed currency or fall back to selected currency
+    const activeCurrency = currency || selectedCurrency;
+    const isPositive = amount >= 0;
+    // Get the formatted value (using absolute value for negative numbers when showing change)
+    const baseAmount = showChange ? Math.abs(amount) : amount;
+    // Use centralized formatting from hook with optional overrides
+    const formattedValue = formatCurrencyValue(baseAmount, {
+        decimals,
+        currency,
+    });
+    // Generate tooltip using the centralized hook function
+    const baseTooltipValue = formatTooltipValue(amount, currency);
+    // Add change indicator if needed
+    const tooltipValue = showChange ? `${isPositive ? "+" : "-"}${baseTooltipValue}` : baseTooltipValue;
+    // Determine color class
+    let colorClass = "";
+    if (showColor) {
+        if (isPositive) {
+            colorClass = "text-green-400";
+        }
+        else {
+            colorClass = "text-red-400";
+        }
+    }
+    // Add change indicator
+    let displayValue = formattedValue;
+    if (showChange) {
+        if (isPositive) {
+            displayValue = `+${formattedValue}`;
+        }
+        else {
+            displayValue = `-${formattedValue}`;
+        }
+    }
+    const handleClick = () => {
+        if (clickable) {
+            openModal();
+        }
+    };
+    return ((0, jsx_runtime_1.jsxs)(tooltip_1.Tooltip, { children: [(0, jsx_runtime_1.jsx)(tooltip_1.TooltipTrigger, { asChild: true, children: (0, jsx_runtime_1.jsxs)("span", { onClick: handleClick, className: (0, utils_1.cn)("inline-flex items-center gap-1 whitespace-nowrap", colorClass, className, clickable && "cursor-pointer transition-opacity hover:opacity-80"), children: [subB3Icon &&
+                            (currency === baseCurrency || (!currency && activeCurrency === baseCurrency)) &&
+                            baseCurrency === "B3"
+                            ? displayValue.split(" ")[0]
+                            : displayValue, subB3Icon &&
+                            (currency === baseCurrency || (!currency && activeCurrency === baseCurrency)) &&
+                            baseCurrency === "B3" && ((0, jsx_runtime_1.jsx)("img", { src: currency_1.B3_COIN_IMAGE_URL, className: "inline-block h-4 w-4 align-middle", alt: "B3 coin" }))] }) }), (0, jsx_runtime_1.jsx)(tooltip_1.TooltipContent, { children: tooltipValue })] }));
+}

package/dist/cjs/shared/react/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./CurrencySelector";
+export * from "./FormattedCurrency";

package/dist/cjs/shared/react/components/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CurrencySelector"), exports);
+__exportStar(require("./FormattedCurrency"), exports);

package/dist/cjs/shared/react/hooks/__tests__/useCurrencyConversion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/shared/react/hooks/__tests__/useCurrencyConversion.test.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const react_1 = require("@testing-library/react");
+const useCurrencyConversion_1 = require("../useCurrencyConversion");
+// Mock the external dependencies
+// Store mock rates for different quote currencies
+const mockRates = {};
+// Mock store state
+const mockStoreState = {
+    selectedCurrency: "B3",
+    baseCurrency: "B3",
+    setSelectedCurrency: vitest_1.vi.fn(),
+    setBaseCurrency: vitest_1.vi.fn(),
+};
+vitest_1.vi.mock("@b3dotfun/sdk/global-account/react", () => ({
+    useExchangeRate: vitest_1.vi.fn((params) => {
+        const rate = mockRates[params?.quoteCurrency];
+        return { rate };
+    }),
+}));
+vitest_1.vi.mock("@b3dotfun/sdk/shared/utils/number", () => ({
+    formatDisplayNumber: vitest_1.vi.fn((value) => {
+        const num = Number(value);
+        if (isNaN(num))
+            return "0";
+        return num.toLocaleString("en-US", { maximumFractionDigits: 6 });
+    }),
+}));
+vitest_1.vi.mock("../../stores/currencyStore", () => ({
+    useCurrencyStore: vitest_1.vi.fn((selector) => {
+        if (selector) {
+            return selector(mockStoreState);
+        }
+        return mockStoreState;
+    }),
+    CURRENCY_SYMBOLS: {
+        B3: "B3",
+        USD: "$",
+        EUR: "€",
+        GBP: "£",
+        JPY: "¥",
+        CAD: "C$",
+        AUD: "A$",
+        ETH: "ETH",
+        SOL: "SOL",
+        KRW: "₩",
+    },
+}));
+(0, vitest_1.describe)("useCurrencyConversion", () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        // Reset mock rates to default
+        Object.keys(mockRates).forEach(key => delete mockRates[key]);
+        mockRates.USD = 1.0;
+        // Reset store state
+        mockStoreState.selectedCurrency = "B3";
+        mockStoreState.baseCurrency = "B3";
+    });
+    (0, vitest_1.describe)("formatCurrencyValue", () => {
+        (0, vitest_1.it)("should format base currency (B3) without conversion", () => {
+            mockStoreState.selectedCurrency = "B3";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("B3");
+            (0, vitest_1.expect)(formatted).toContain("100");
+        });
+        (0, vitest_1.it)("should show base currency when exchange rate is unavailable", () => {
+            mockRates.USD = undefined;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("B3");
+            (0, vitest_1.expect)(formatted).not.toContain("$");
+        });
+        (0, vitest_1.it)("should format USD with prefix symbol", () => {
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toMatch(/^\$/);
+            (0, vitest_1.expect)(formatted).toContain("200");
+        });
+        (0, vitest_1.it)("should format EUR with prefix symbol", () => {
+            mockRates.EUR = 1.8;
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "EUR";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toMatch(/^€/);
+        });
+        (0, vitest_1.it)("should format JPY without decimals", () => {
+            mockRates.JPY = 150;
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "JPY";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("¥");
+            (0, vitest_1.expect)(formatted).not.toContain(".");
+        });
+        (0, vitest_1.it)("should format KRW without decimals", () => {
+            mockRates.KRW = 1300;
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "KRW";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("₩");
+            (0, vitest_1.expect)(formatted).not.toContain(".");
+        });
+        (0, vitest_1.it)("should format ETH with suffix symbol", () => {
+            mockRates.ETH = 0.0005;
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "ETH";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("ETH");
+            (0, vitest_1.expect)(formatted).not.toMatch(/^ETH/);
+        });
+        (0, vitest_1.it)("should format SOL with suffix symbol", () => {
+            mockRates.SOL = 0.05;
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "SOL";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(100);
+            (0, vitest_1.expect)(formatted).toContain("SOL");
+            (0, vitest_1.expect)(formatted).not.toMatch(/^SOL/);
+        });
+        (0, vitest_1.it)("should handle small USD amounts with proper conversion", () => {
+            mockRates.USD = 1.5;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const formatted = result.current.formatCurrencyValue(10);
+            // 10 * 1.5 = 15
+            (0, vitest_1.expect)(formatted).toMatch(/^\$/);
+            (0, vitest_1.expect)(formatted).toContain("15");
+        });
+        (0, vitest_1.it)("should apply correct exchange rate conversion", () => {
+            const testRate = 3.5;
+            mockRates.USD = testRate;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const inputValue = 100;
+            const formatted = result.current.formatCurrencyValue(inputValue);
+            (0, vitest_1.expect)(formatted).toContain("350");
+        });
+    });
+    (0, vitest_1.describe)("return values", () => {
+        (0, vitest_1.it)("should return selected currency", () => {
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            (0, vitest_1.expect)(result.current.selectedCurrency).toBe("USD");
+        });
+        (0, vitest_1.it)("should return base currency", () => {
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            (0, vitest_1.expect)(result.current.baseCurrency).toBe("B3");
+        });
+        (0, vitest_1.it)("should return exchange rate", () => {
+            const testRate = 2.5;
+            mockRates.USD = testRate;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            (0, vitest_1.expect)(result.current.exchangeRate).toBe(testRate);
+        });
+        (0, vitest_1.it)("should return correct currency symbols", () => {
+            mockStoreState.selectedCurrency = "EUR";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            (0, vitest_1.expect)(result.current.selectedCurrencySymbol).toBe("€");
+            (0, vitest_1.expect)(result.current.baseCurrencySymbol).toBe("B3");
+        });
+    });
+    (0, vitest_1.describe)("formatTooltipValue", () => {
+        (0, vitest_1.it)("should show USD equivalent when displaying base currency", () => {
+            mockRates.USD = 1.5;
+            mockStoreState.selectedCurrency = "B3";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(100);
+            (0, vitest_1.expect)(tooltip).toContain("USD");
+            (0, vitest_1.expect)(tooltip).toContain("150");
+        });
+        (0, vitest_1.it)("should show base currency when displaying other currency", () => {
+            mockRates.EUR = 0.9;
+            mockRates.USD = 1.2;
+            mockStoreState.selectedCurrency = "EUR";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(100);
+            (0, vitest_1.expect)(tooltip).toContain("B3");
+            (0, vitest_1.expect)(tooltip).toContain("100");
+        });
+        (0, vitest_1.it)("should handle custom currency for base currency", () => {
+            mockRates.USD = 2.0;
+            mockRates.EUR = 1.8;
+            mockStoreState.selectedCurrency = "EUR";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(100, "B3");
+            (0, vitest_1.expect)(tooltip).toContain("USD");
+            (0, vitest_1.expect)(tooltip).toContain("200");
+        });
+        (0, vitest_1.it)("should handle custom currency for non-base currency", () => {
+            mockRates.USD = 2.0;
+            mockStoreState.selectedCurrency = "USD";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(50, "ETH");
+            (0, vitest_1.expect)(tooltip).toContain("ETH");
+            (0, vitest_1.expect)(tooltip).toContain("50");
+        });
+        (0, vitest_1.it)("should handle absolute values for negative amounts", () => {
+            mockRates.USD = 1.5;
+            mockStoreState.selectedCurrency = "B3";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(-100);
+            (0, vitest_1.expect)(tooltip).toContain("USD");
+            (0, vitest_1.expect)(tooltip).toContain("150");
+            (0, vitest_1.expect)(tooltip).not.toContain("-");
+        });
+        (0, vitest_1.it)("should handle exchange rate unavailable", () => {
+            mockRates.USD = undefined;
+            mockStoreState.selectedCurrency = "B3";
+            mockStoreState.baseCurrency = "B3";
+            const { result } = (0, react_1.renderHook)(() => (0, useCurrencyConversion_1.useCurrencyConversion)());
+            const tooltip = result.current.formatTooltipValue(100);
+            (0, vitest_1.expect)(tooltip).toContain("USD");
+            (0, vitest_1.expect)(tooltip).toContain("100");
+        });
+    });
+});

package/dist/cjs/shared/react/hooks/index.d.ts

@@ -1 +1,2 @@
+export * from "./useCurrencyConversion";
 export * from "./useNavigation";

package/dist/cjs/shared/react/hooks/index.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useCurrencyConversion"), exports);
 __exportStar(require("./useNavigation"), exports);

package/dist/cjs/shared/react/hooks/useCurrencyConversion.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Hook for currency conversion and formatting with real-time exchange rates.
+ *
+ * This hook provides currency conversion functionality using live exchange rates
+ * and formats values according to currency-specific rules (decimals, symbols, etc.).
+ *
+ * @returns Currency conversion utilities and state
+ *
+ * @example
+ * ```tsx
+ * function PriceDisplay({ amount }: { amount: number }) {
+ *   const { formatCurrencyValue, selectedCurrency } = useCurrencyConversion();
+ *   return <div>{formatCurrencyValue(amount)}</div>;
+ * }
+ * ```
+ */
+export declare function useCurrencyConversion(): {
+    /** Currently selected display currency */
+    selectedCurrency: import("../stores/currencyStore").SupportedCurrency;
+    /** Base currency used for conversion (typically B3) */
+    baseCurrency: import("../stores/currencyStore").SupportedCurrency;
+    /** Current exchange rate from base to selected currency (undefined while loading) */
+    exchangeRate: number;
+    /** Format a value with currency conversion and proper symbol/decimal handling */
+    formatCurrencyValue: (value: number, options?: {
+        decimals?: number;
+        currency?: string;
+    }) => string;
+    /** Format a tooltip value showing alternate currency representation */
+    formatTooltipValue: (value: number, customCurrency?: string) => string;
+    /** Symbol for the currently selected currency (e.g., "$", "€", "ETH") */
+    selectedCurrencySymbol: string;
+    /** Symbol for the base currency */
+    baseCurrencySymbol: string;
+};