@unifold/ui-react 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,565 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+import * as SelectPrimitive from '@radix-ui/react-select';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import { ClassValue } from 'clsx';
+
+interface DepositModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    userId: string;
+    publishableKey: string;
+    modalTitle?: string;
+    destinationTokenSymbol?: string;
+    recipientAddress?: string;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    hideDepositTracker?: boolean;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+    theme?: 'light' | 'dark' | 'auto';
+}
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainId, destinationTokenAddress, hideDepositTracker, onDepositSuccess, onDepositError, theme, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+
+interface DepositHeaderProps {
+    title: string;
+    showBack?: boolean;
+    showClose?: boolean;
+    onBack?: () => void;
+    onClose?: () => void;
+    badge?: {
+        count: number;
+    };
+}
+declare function DepositHeader({ title, showBack, showClose, onBack, onClose, badge, }: DepositHeaderProps): react_jsx_runtime.JSX.Element;
+
+interface TransferCryptoProps {
+    userId: string;
+    publishableKey: string;
+    recipientAddress?: string;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    copyButtonMode?: "compact" | "fullWidth";
+    onExecutionsChange?: (executions: any[]) => void;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+}
+declare function TransferCrypto(props: TransferCryptoProps): react_jsx_runtime.JSX.Element;
+
+interface TransferCrypto2Props {
+    userId: string;
+    publishableKey: string;
+    recipientAddress?: string;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    copyButtonMode?: "compact" | "fullWidth";
+    onExecutionsChange?: (executions: any[]) => void;
+}
+declare function TransferCrypto2(props: TransferCrypto2Props): react_jsx_runtime.JSX.Element;
+
+declare function setApiConfig(config: {
+    baseUrl?: string;
+    publishableKey?: string;
+    defaultConfig?: {
+        destinationChainId?: string;
+        destinationTokenAddress?: string;
+        recipientAddress?: string;
+    };
+}): void;
+declare function getApiBaseUrl(): string;
+/**
+ * Build an icon URL using the API base URL
+ * Converts relative paths like "/icons/networks/ethereum.svg" to full URLs
+ * like "http://localhost:3002/api/public/icons/networks/ethereum.svg"
+ */
+declare function getIconUrl(iconPath: string): string;
+interface Wallet {
+    id: string;
+    chain_type: "ethereum" | "solana" | "bitcoin";
+    address_type: string | null;
+    address: string;
+    destination_chain_type: string;
+    destination_chain_id: string;
+    destination_token_address: string;
+    recipient_address: string;
+    is_primary: boolean;
+}
+interface EOAResponse {
+    data: Wallet[];
+}
+interface CreateEOARequest {
+    user_id: string;
+    destination_chain_type: string;
+    destination_chain_id: string;
+    destination_token_address: string;
+    recipient_address: string;
+    client_metadata?: Record<string, unknown>;
+}
+/**
+ * Create EOA wallets for a user
+ * @param overrides - Override default configuration (user_id, recipient_address, etc.)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function createEOA(overrides?: Partial<CreateEOARequest>, publishableKey?: string): Promise<EOAResponse>;
+/**
+ * Get wallet address for a specific chain type
+ */
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin"): Wallet | undefined;
+interface AutoSwapRequest {
+    wallet_id: string;
+    origin_currency: string;
+}
+declare enum ExecutionStatus {
+    DELAYED = "delayed",
+    FAILED = "failed",
+    PENDING = "pending",
+    REFUNDED = "refunded",
+    SUCCEEDED = "succeeded",
+    WAITING = "waiting"
+}
+interface AutoSwapResponse {
+    id: string;
+    project_id: string;
+    user_id: string;
+    wallet_id: string;
+    transaction_hash: string;
+    recipient_address: string;
+    provider: string;
+    provider_id: string;
+    source_chain_type: string;
+    source_chain_id: string;
+    source_token_address: string;
+    destination_chain_type: string;
+    destination_chain_id: string;
+    destination_token_address: string;
+    source_amount_base_unit: string;
+    destination_amount_base_unit: string;
+    provider_metadata: unknown;
+    created_at?: string;
+    updated_at?: string;
+    explorer_url: string;
+    destination_transaction_hashes: string[];
+    status: ExecutionStatus;
+    source_token_metadata?: {
+        icon_url: string;
+    };
+}
+declare const SOLANA_USDC_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+interface QueryExecutionsRequest {
+    external_user_id: string;
+}
+interface QueryExecutionsResponse {
+    data: AutoSwapResponse[];
+}
+/**
+ * Query all direct executions for a user
+ * Returns ALL executions - filter client-side for new ones
+ * @param externalUserId - External user ID
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function queryExecutions(externalUserId: string, publishableKey?: string): Promise<QueryExecutionsResponse>;
+interface SupportedChain {
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+    icon_url: string;
+    token_address: string;
+    estimated_price_impact_percent: number;
+    max_slippage_percent: number;
+    estimated_processing_time: number | null;
+    minimum_deposit_amount_usd: number;
+}
+interface SupportedToken {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    is_newly_added: boolean;
+    chains: SupportedChain[];
+}
+interface SupportedDepositTokensResponse {
+    data: SupportedToken[];
+}
+/**
+ * Get supported deposit tokens
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getSupportedDepositTokens(publishableKey?: string): Promise<SupportedDepositTokensResponse>;
+interface MeldQuote {
+    transaction_type: string;
+    payment_method_type: string;
+    source_amount: number;
+    source_amount_without_fees: number;
+    fiat_amount_without_fees: number;
+    destination_amount_without_fees: number | null;
+    source_currency_code: string;
+    country_code: string;
+    total_fee: number;
+    network_fee: number;
+    transaction_fee: number;
+    destination_amount: number;
+    destination_currency_code: string;
+    exchange_rate: number;
+    customer_score: number;
+    service_provider: string;
+    service_provider_display_name: string;
+    institution_name: string | null;
+    low_kyc: boolean | null;
+    partner_fee: number | null;
+    icon_url: string;
+}
+interface MeldQuotesRequest {
+    country_code: string;
+    destination_currency_code: string;
+    source_amount: string;
+    source_currency_code: string;
+}
+interface MeldQuotesResponse {
+    data: MeldQuote[];
+}
+/**
+ * Get Meld onramp quotes
+ * @param request - Meld quotes request
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getMeldQuotes(request: MeldQuotesRequest, publishableKey?: string): Promise<MeldQuotesResponse>;
+interface MeldSessionRequest {
+    service_provider: string;
+    country_code: string;
+    destination_currency_code: string;
+    source_currency_code: string;
+    wallet_address: string;
+    source_amount: string;
+}
+interface MeldSessionResponse {
+    id: string;
+    external_session_id: string | null;
+    external_customer_id: string | null;
+    customer_id: string;
+    widget_url: string;
+    service_provider_widget_url: string;
+    token: string;
+}
+/**
+ * Create a Meld onramp session
+ * @param request - Meld session request
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function createMeldSession(request: MeldSessionRequest, publishableKey?: string): Promise<MeldSessionResponse>;
+interface FiatCurrency {
+    currency_code: string;
+    name: string;
+    icon_url: string;
+}
+interface FiatCurrenciesResponse {
+    data: FiatCurrency[];
+    preferred: string[];
+}
+/**
+ * Get supported fiat currencies
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+
+type LayoutVariant = "horizontal" | "vertical";
+interface TransferCryptoBaseProps {
+    userId: string;
+    publishableKey: string;
+    recipientAddress?: string;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    copyButtonMode?: "compact" | "fullWidth";
+    layoutVariant?: LayoutVariant;
+    showDetailedDropdowns?: boolean;
+    onExecutionsChange?: (executions: AutoSwapResponse[]) => void;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+}
+declare function TransferCryptoBase({ userId, publishableKey, recipientAddress, destinationChainId, destinationTokenAddress, copyButtonMode, layoutVariant, showDetailedDropdowns, onExecutionsChange, onDepositSuccess, onDepositError, }: TransferCryptoBaseProps): react_jsx_runtime.JSX.Element;
+
+interface BuyWithCardProps {
+    userId: string;
+    publishableKey: string;
+    view?: "amount" | "quotes" | "onramp";
+    onViewChange?: (view: "amount" | "quotes" | "onramp", quotesCount?: number) => void;
+    maxAmountUsd?: number;
+    accentColor?: string;
+    destinationTokenSymbol?: string;
+    recipientAddress?: string;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+    themeClass?: string;
+}
+declare function BuyWithCard({ userId, publishableKey, view: externalView, onViewChange, maxAmountUsd, accentColor, destinationTokenSymbol, recipientAddress, destinationChainId, destinationTokenAddress, themeClass, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
+
+interface CurrencyModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    currencies: FiatCurrency[];
+    preferredCurrencyCodes: string[];
+    selectedCurrency: string;
+    onSelectCurrency: (currencyCode: string) => void;
+    themeClass?: string;
+}
+declare function CurrencyModal({ open, onOpenChange, currencies, preferredCurrencyCodes, selectedCurrency, onSelectCurrency, themeClass, }: CurrencyModalProps): react_jsx_runtime.JSX.Element;
+
+interface DepositSuccessToastProps {
+    depositTx: string;
+    completionTx?: string;
+    orderSubmittedAt: string;
+    orderFilledAt: string;
+    explorerUrl: string;
+    completionExplorerUrl?: string;
+    status: ExecutionStatus;
+    tokenIconUrl?: string;
+    onClose: () => void;
+}
+declare function DepositSuccessToast({ depositTx, completionTx, orderSubmittedAt, orderFilledAt, explorerUrl, completionExplorerUrl, status, tokenIconUrl, onClose, }: DepositSuccessToastProps): react_jsx_runtime.JSX.Element;
+
+interface DepositsModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    executions: AutoSwapResponse[];
+    userId: string;
+    publishableKey: string;
+    themeClass?: string;
+}
+declare function DepositsModal({ open, onOpenChange, executions: sessionExecutions, userId, publishableKey, themeClass, }: DepositsModalProps): react_jsx_runtime.JSX.Element;
+
+interface StyledQRCodeProps {
+    value: string;
+    size?: number;
+    imageUrl?: string;
+    imageSize?: number;
+    darkMode?: boolean;
+}
+declare function StyledQRCode({ value, size, imageUrl, imageSize, darkMode, }: StyledQRCodeProps): react_jsx_runtime.JSX.Element;
+
+interface TransferCryptoButtonProps {
+    onClick: () => void;
+    title: string;
+    subtitle: string;
+}
+declare function TransferCryptoButton({ onClick, title, subtitle, }: TransferCryptoButtonProps): react_jsx_runtime.JSX.Element;
+
+interface DepositWithCardButtonProps {
+    onClick: () => void;
+    title: string;
+    subtitle: string;
+}
+declare function DepositWithCardButton({ onClick, title, subtitle, }: DepositWithCardButtonProps): react_jsx_runtime.JSX.Element;
+
+interface DepositTrackerButtonProps {
+    onClick: () => void;
+    title: string;
+    subtitle: string;
+    badge?: number;
+}
+declare function DepositTrackerButton({ onClick, title, subtitle, badge, }: DepositTrackerButtonProps): react_jsx_runtime.JSX.Element;
+
+interface DepositExecutionItemProps {
+    execution: AutoSwapResponse;
+    showCloseButton?: boolean;
+    onClose?: () => void;
+}
+declare function DepositExecutionItem({ execution, showCloseButton, onClose, }: DepositExecutionItemProps): react_jsx_runtime.JSX.Element;
+
+interface CurrencyListItemProps {
+    currency: FiatCurrency;
+    isSelected: boolean;
+    onSelect: (currencyCode: string) => void;
+}
+declare function CurrencyListItem({ currency, isSelected, onSelect, }: CurrencyListItemProps): react_jsx_runtime.JSX.Element;
+
+interface CurrencyListSectionProps {
+    title: string;
+    currencies: FiatCurrency[];
+    selectedCurrency: string;
+    onSelect: (currencyCode: string) => void;
+}
+declare function CurrencyListSection({ title, currencies, selectedCurrency, onSelect, }: CurrencyListSectionProps): react_jsx_runtime.JSX.Element | null;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const Dialog: React.FC<DialogPrimitive.DialogProps>;
+declare const DialogTrigger: React.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const DialogPortal: React.FC<DialogPrimitive.DialogPortalProps>;
+declare const DialogClose: React.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const DialogContent: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const DialogHeader: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const DialogFooter: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const DialogTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+declare const DialogDescription: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+
+declare const Select: React.FC<SelectPrimitive.SelectProps>;
+declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
+declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
+declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const SelectScrollUpButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectScrollDownButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectContent: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectLabel: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectItem: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectSeparator: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+declare const TooltipProvider: React.FC<TooltipPrimitive.TooltipProviderProps>;
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * User IP information interface
+ */
+interface UserIpInfo {
+    alpha2: string;
+    state?: string;
+}
+/**
+ * Hook to fetch user's IP-based location information
+ *
+ * Implements a two-tier fallback strategy:
+ * 1. Primary: Moonpay IP API (if API key is provided)
+ * 2. Fallback: ipapi.co
+ *
+ * The result is cached in-memory using React Query:
+ * - Data persists for the entire browser session
+ * - Shared across all components using this hook
+ * - Reduces API calls and protects against rate limiting
+ *
+ * @param moonpayApiKey - Optional Moonpay API key for primary lookup
+ * @returns User IP information including country code
+ */
+declare function useUserIp(moonpayApiKey?: string): {
+    userIpInfo: UserIpInfo | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+
+interface ThemeContextValue {
+    themeClass: string;
+}
+declare function ThemeProvider({ children, themeClass }: {
+    children: React.ReactNode;
+    themeClass: string;
+}): react_jsx_runtime.JSX.Element;
+declare function useTheme(): ThemeContextValue;
+
+declare function cn(...inputs: ClassValue[]): string;
+
+declare const i18n: {
+    transferCrypto: {
+        priceImpact: {
+            label: string;
+            tooltip: string;
+            finalCost: string;
+        };
+        slippage: {
+            label: string;
+            auto: string;
+            tooltip: string;
+            finalCost: string;
+        };
+        processingTime: {
+            label: string;
+            lessThanMinutes: string;
+            lessThanHours: string;
+        };
+        minDeposit: {
+            label: string;
+            tooltip: string;
+        };
+        help: {
+            needHelp: string;
+            contactSupport: string;
+        };
+        terms: {
+            termsApply: string;
+        };
+        supportedToken: string;
+        supportedChain: string;
+        depositAddress: {
+            label: string;
+            tooltip: string;
+        };
+        copyAddress: string;
+        copied: string;
+        loading: string;
+        loadingQRCode: string;
+        noAddressAvailable: string;
+        noChainsAvailable: string;
+    };
+    depositModal: {
+        transferCrypto: {
+            title: string;
+            subtitle: string;
+        };
+        depositWithCard: {
+            title: string;
+            subtitle: string;
+        };
+        quotes: string;
+    };
+    buyWithCard: {
+        onramp: {
+            completeTransaction: string;
+            canCloseModal: string;
+            youUse: string;
+            youBuy: string;
+            youReceive: string;
+            intentAddressNote: string;
+        };
+    };
+};
+type I18nStrings = typeof i18n;
+
+export { type AutoSwapRequest, type AutoSwapResponse, Button, type ButtonProps, BuyWithCard, type CreateEOARequest, CurrencyListItem, CurrencyListSection, CurrencyModal, DepositExecutionItem, DepositHeader, DepositModal, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type EOAResponse, ExecutionStatus, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type MeldQuote, type MeldQuotesRequest, type MeldQuotesResponse, type MeldSessionRequest, type MeldSessionResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, StyledQRCode, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, ThemeProvider, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCrypto, TransferCrypto2, TransferCryptoBase, TransferCryptoButton, type UserIpInfo, type Wallet, buttonVariants, cn, createEOA, createMeldSession, getApiBaseUrl, getFiatCurrencies, getIconUrl, getMeldQuotes, getSupportedDepositTokens, getWalletByChainType, i18n, queryExecutions, setApiConfig, useTheme, useUserIp };