@unifold/connect-react-native 0.1.50-beta.2 → 0.1.50

package/dist/index.d.mts

@@ -307,6 +307,61 @@ interface ThemeContextValue {
 }
 declare function useTheme(): ThemeContextValue;
 
+/** All chain types recognised by the Unifold platform. */
+type ChainType = "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl" | "cardano" | "n1";
+/** Subset of ChainType for which balance lookups are supported. */
+type BalanceChainType = "ethereum" | "solana" | "bitcoin" | "n1";
+/**
+ * Opt-in dev-only API base URL (staging, localhost, etc.).
+ * Stored on `globalThis` so it applies everywhere this file is inlined (e.g. Connect’s prebundle).
+ * No-op when not `__DEV__`; empty / whitespace clears the override.
+ */
+declare function setDevApiUrl(url: string): void;
+/**
+ * Normalize an icon URL from API response
+ * If the URL is relative (starts with /), prepend the API base URL
+ * If the URL contains localhost, replace with the configured API base URL
+ * If the URL is already absolute (starts with http), return as-is
+ */
+declare function normalizeIconUrl(iconUrl: string | undefined | null): string;
+interface IconUrl {
+    url: string;
+    format: "svg" | "png";
+}
+/**
+ * Get the preferred icon URL from an object with icon_url and icon_urls
+ * @param item - Object with icon_url and optional icon_urls array
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or icon_url as fallback
+ */
+declare function getPreferredIcon(item: {
+    icon_url: string;
+    icon_urls?: IconUrl[];
+} | undefined | null, preferredFormat?: "svg" | "png"): string;
+interface DestinationTokenChain {
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    icon_url: string;
+    icon_urls?: IconUrl[];
+    token_address: string;
+}
+interface DestinationToken {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls?: IconUrl[];
+    chains: DestinationTokenChain[];
+}
+interface SupportedDestinationTokensResponse {
+    data: DestinationToken[];
+}
+/**
+ * Get supported destination tokens for withdrawals
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
+
 interface BorderRadiusConfig {
     borderTopLeftRadius?: number;
     borderTopRightRadius?: number;
@@ -362,25 +417,29 @@ interface DepositModalProps {
     /** Recipient wallet address */
     recipientAddress?: string;
     /** Target chain type */
-    destinationChainType?: "ethereum" | "solana" | "bitcoin";
+    destinationChainType?: ChainType;
     /** Target chain ID (e.g., "137" for Polygon) */
     destinationChainId?: string;
     /** Target token contract address */
     destinationTokenAddress?: string;
     /** Default source chain type to pre-select in UI */
-    defaultChainType?: "ethereum" | "solana" | "bitcoin";
+    defaultChainType?: ChainType;
     /** Default source chain ID to pre-select in UI (e.g., "137" for Polygon) */
     defaultChainId?: string;
     /** Default source token address to pre-select in UI */
     defaultTokenAddress?: string;
     /** Show recipient's destination token balance in the header */
     showBalance?: boolean;
-    /** Hide the deposit tracker button */
+    /** Hide the deposit tracker button. Overrides dashboard default. */
     hideDepositTracker?: boolean;
-    /** Show "Pay with Cash App" option in the deposit menu */
+    /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+    enableTransferCrypto?: boolean;
+    /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableCashApp?: boolean;
-    /** Show "Connect Wallet" option in the deposit menu. When undefined, uses the project dashboard setting. */
+    /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableConnectWallet?: boolean;
+    /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+    enableFiatOnramp?: boolean;
     /** Show "Pay with Link" (Stripe) option in the deposit menu */
     enableStripeLinkPay?: boolean;
     /** Registered Stripe onramp component (Connect sets this from `enableStripeLinkPay`) */
@@ -419,7 +478,7 @@ interface DepositModalProps {
      * - 'main': show the menu (default)
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
-     * - 'tracker': open Deposit Tracker immediately (ignored if hideDepositTracker is true)
+     * - 'tracker': open Deposit Tracker immediately (ignored if the tracker is disabled)
      */
     initialScreen?: DepositInitialScreen;
     /** Callback when deposit succeeds */
@@ -472,57 +531,6 @@ interface DepositModalProps {
     };
 }
 
-/**
- * Opt-in dev-only API base URL (staging, localhost, etc.).
- * Stored on `globalThis` so it applies everywhere this file is inlined (e.g. Connect’s prebundle).
- * No-op when not `__DEV__`; empty / whitespace clears the override.
- */
-declare function setDevApiUrl(url: string): void;
-/**
- * Normalize an icon URL from API response
- * If the URL is relative (starts with /), prepend the API base URL
- * If the URL contains localhost, replace with the configured API base URL
- * If the URL is already absolute (starts with http), return as-is
- */
-declare function normalizeIconUrl(iconUrl: string | undefined | null): string;
-interface IconUrl {
-    url: string;
-    format: "svg" | "png";
-}
-/**
- * Get the preferred icon URL from an object with icon_url and icon_urls
- * @param item - Object with icon_url and optional icon_urls array
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or icon_url as fallback
- */
-declare function getPreferredIcon(item: {
-    icon_url: string;
-    icon_urls?: IconUrl[];
-} | undefined | null, preferredFormat?: "svg" | "png"): string;
-interface DestinationTokenChain {
-    chain_id: string;
-    chain_type: string;
-    chain_name: string;
-    icon_url: string;
-    icon_urls?: IconUrl[];
-    token_address: string;
-}
-interface DestinationToken {
-    symbol: string;
-    name: string;
-    icon_url: string;
-    icon_urls?: IconUrl[];
-    chains: DestinationTokenChain[];
-}
-interface SupportedDestinationTokensResponse {
-    data: DestinationToken[];
-}
-/**
- * Get supported destination tokens for withdrawals
- * @param publishableKey - Optional publishable key, defaults to configured key
- */
-declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
-
 interface WithdrawTransactionInfo {
     sourceChainType: string;
     sourceChainId: string;
@@ -621,10 +629,14 @@ interface UnifoldConnectProviderConfig {
          * Stripe onramp is bundled with Connect; set to false to hide the option.
          */
         enableStripeLinkPay?: boolean;
-        /** Show "Pay with Cash App" option in the deposit menu. Defaults to false. */
+        /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableTransferCrypto?: boolean;
+        /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableCashApp?: boolean;
-        /** Show "Connect Wallet" option in the deposit menu. When undefined, uses the dashboard setting. */
+        /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableConnectWallet?: boolean;
+        /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableFiatOnramp?: boolean;
         /**
          * Apple Pay merchant id (`merchant.com...`) for Stripe Link Pay. Must match the
          * `merchantIdentifier` in the `@stripe/stripe-react-native` Expo plugin (app.json).
@@ -650,12 +662,12 @@ interface DepositError {
 }
 interface DepositConfig {
     externalUserId: string;
-    destinationChainType?: "ethereum" | "solana" | "bitcoin";
+    destinationChainType?: ChainType;
     destinationChainId?: string;
     destinationTokenAddress?: string;
     destinationTokenSymbol?: string;
     recipientAddress?: string;
-    defaultChainType?: "ethereum" | "solana" | "bitcoin";
+    defaultChainType?: ChainType;
     defaultChainId?: string;
     defaultTokenAddress?: string;
     showBalance?: boolean;
@@ -704,7 +716,7 @@ interface WithdrawConfig {
     /** The user's wallet address — used to fetch balance. Wallet-agnostic: pass any address string. */
     senderAddress: string;
     /** Source token chain type (e.g. "ethereum") */
-    sourceChainType: "ethereum" | "solana" | "bitcoin";
+    sourceChainType: ChainType;
     /** Source token chain ID (e.g. "8453" for Base) */
     sourceChainId: string;
     /** Source token contract address */
@@ -747,4 +759,4 @@ interface UnifoldProviderProps {
 declare function UnifoldProvider({ children, publishableKey, config, }: UnifoldProviderProps): React$1.JSX.Element;
 declare function useUnifold(): ConnectContextValue;
 
-export { type AllowedCountryResult, type BorderRadiusConfig, BottomSheet, type ComponentConfig, type CustomThemeColors, type DepositConfig, type DepositError, type DepositInitialScreen, type DepositResult, type DestinationToken, type DestinationTokenChain, type FontConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeProviderConfig, type TransferInputVariant, type UnifoldConnectProviderConfig, UnifoldProvider, type UnifoldProviderProps, type WithdrawConfig, type WithdrawError, type WithdrawResult, type WithdrawTransactionInfo, getPreferredIcon, getSupportedDestinationTokens, normalizeIconUrl, registerStripeOnramp, setDevApiUrl, useAllowedCountry, useTheme, useUnifold };
+export { type AllowedCountryResult, type BalanceChainType, type BorderRadiusConfig, BottomSheet, type ChainType, type ComponentConfig, type CustomThemeColors, type DepositConfig, type DepositError, type DepositInitialScreen, type DepositResult, type DestinationToken, type DestinationTokenChain, type FontConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeProviderConfig, type TransferInputVariant, type UnifoldConnectProviderConfig, UnifoldProvider, type UnifoldProviderProps, type WithdrawConfig, type WithdrawError, type WithdrawResult, type WithdrawTransactionInfo, getPreferredIcon, getSupportedDestinationTokens, normalizeIconUrl, registerStripeOnramp, setDevApiUrl, useAllowedCountry, useTheme, useUnifold };

package/dist/index.d.ts

@@ -307,6 +307,61 @@ interface ThemeContextValue {
 }
 declare function useTheme(): ThemeContextValue;
 
+/** All chain types recognised by the Unifold platform. */
+type ChainType = "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl" | "cardano" | "n1";
+/** Subset of ChainType for which balance lookups are supported. */
+type BalanceChainType = "ethereum" | "solana" | "bitcoin" | "n1";
+/**
+ * Opt-in dev-only API base URL (staging, localhost, etc.).
+ * Stored on `globalThis` so it applies everywhere this file is inlined (e.g. Connect’s prebundle).
+ * No-op when not `__DEV__`; empty / whitespace clears the override.
+ */
+declare function setDevApiUrl(url: string): void;
+/**
+ * Normalize an icon URL from API response
+ * If the URL is relative (starts with /), prepend the API base URL
+ * If the URL contains localhost, replace with the configured API base URL
+ * If the URL is already absolute (starts with http), return as-is
+ */
+declare function normalizeIconUrl(iconUrl: string | undefined | null): string;
+interface IconUrl {
+    url: string;
+    format: "svg" | "png";
+}
+/**
+ * Get the preferred icon URL from an object with icon_url and icon_urls
+ * @param item - Object with icon_url and optional icon_urls array
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or icon_url as fallback
+ */
+declare function getPreferredIcon(item: {
+    icon_url: string;
+    icon_urls?: IconUrl[];
+} | undefined | null, preferredFormat?: "svg" | "png"): string;
+interface DestinationTokenChain {
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    icon_url: string;
+    icon_urls?: IconUrl[];
+    token_address: string;
+}
+interface DestinationToken {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls?: IconUrl[];
+    chains: DestinationTokenChain[];
+}
+interface SupportedDestinationTokensResponse {
+    data: DestinationToken[];
+}
+/**
+ * Get supported destination tokens for withdrawals
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
+
 interface BorderRadiusConfig {
     borderTopLeftRadius?: number;
     borderTopRightRadius?: number;
@@ -362,25 +417,29 @@ interface DepositModalProps {
     /** Recipient wallet address */
     recipientAddress?: string;
     /** Target chain type */
-    destinationChainType?: "ethereum" | "solana" | "bitcoin";
+    destinationChainType?: ChainType;
     /** Target chain ID (e.g., "137" for Polygon) */
     destinationChainId?: string;
     /** Target token contract address */
     destinationTokenAddress?: string;
     /** Default source chain type to pre-select in UI */
-    defaultChainType?: "ethereum" | "solana" | "bitcoin";
+    defaultChainType?: ChainType;
     /** Default source chain ID to pre-select in UI (e.g., "137" for Polygon) */
     defaultChainId?: string;
     /** Default source token address to pre-select in UI */
     defaultTokenAddress?: string;
     /** Show recipient's destination token balance in the header */
     showBalance?: boolean;
-    /** Hide the deposit tracker button */
+    /** Hide the deposit tracker button. Overrides dashboard default. */
     hideDepositTracker?: boolean;
-    /** Show "Pay with Cash App" option in the deposit menu */
+    /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+    enableTransferCrypto?: boolean;
+    /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableCashApp?: boolean;
-    /** Show "Connect Wallet" option in the deposit menu. When undefined, uses the project dashboard setting. */
+    /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableConnectWallet?: boolean;
+    /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+    enableFiatOnramp?: boolean;
     /** Show "Pay with Link" (Stripe) option in the deposit menu */
     enableStripeLinkPay?: boolean;
     /** Registered Stripe onramp component (Connect sets this from `enableStripeLinkPay`) */
@@ -419,7 +478,7 @@ interface DepositModalProps {
      * - 'main': show the menu (default)
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
-     * - 'tracker': open Deposit Tracker immediately (ignored if hideDepositTracker is true)
+     * - 'tracker': open Deposit Tracker immediately (ignored if the tracker is disabled)
      */
     initialScreen?: DepositInitialScreen;
     /** Callback when deposit succeeds */
@@ -472,57 +531,6 @@ interface DepositModalProps {
     };
 }
 
-/**
- * Opt-in dev-only API base URL (staging, localhost, etc.).
- * Stored on `globalThis` so it applies everywhere this file is inlined (e.g. Connect’s prebundle).
- * No-op when not `__DEV__`; empty / whitespace clears the override.
- */
-declare function setDevApiUrl(url: string): void;
-/**
- * Normalize an icon URL from API response
- * If the URL is relative (starts with /), prepend the API base URL
- * If the URL contains localhost, replace with the configured API base URL
- * If the URL is already absolute (starts with http), return as-is
- */
-declare function normalizeIconUrl(iconUrl: string | undefined | null): string;
-interface IconUrl {
-    url: string;
-    format: "svg" | "png";
-}
-/**
- * Get the preferred icon URL from an object with icon_url and icon_urls
- * @param item - Object with icon_url and optional icon_urls array
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or icon_url as fallback
- */
-declare function getPreferredIcon(item: {
-    icon_url: string;
-    icon_urls?: IconUrl[];
-} | undefined | null, preferredFormat?: "svg" | "png"): string;
-interface DestinationTokenChain {
-    chain_id: string;
-    chain_type: string;
-    chain_name: string;
-    icon_url: string;
-    icon_urls?: IconUrl[];
-    token_address: string;
-}
-interface DestinationToken {
-    symbol: string;
-    name: string;
-    icon_url: string;
-    icon_urls?: IconUrl[];
-    chains: DestinationTokenChain[];
-}
-interface SupportedDestinationTokensResponse {
-    data: DestinationToken[];
-}
-/**
- * Get supported destination tokens for withdrawals
- * @param publishableKey - Optional publishable key, defaults to configured key
- */
-declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
-
 interface WithdrawTransactionInfo {
     sourceChainType: string;
     sourceChainId: string;
@@ -621,10 +629,14 @@ interface UnifoldConnectProviderConfig {
          * Stripe onramp is bundled with Connect; set to false to hide the option.
          */
         enableStripeLinkPay?: boolean;
-        /** Show "Pay with Cash App" option in the deposit menu. Defaults to false. */
+        /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableTransferCrypto?: boolean;
+        /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableCashApp?: boolean;
-        /** Show "Connect Wallet" option in the deposit menu. When undefined, uses the dashboard setting. */
+        /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableConnectWallet?: boolean;
+        /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
+        enableFiatOnramp?: boolean;
         /**
          * Apple Pay merchant id (`merchant.com...`) for Stripe Link Pay. Must match the
          * `merchantIdentifier` in the `@stripe/stripe-react-native` Expo plugin (app.json).
@@ -650,12 +662,12 @@ interface DepositError {
 }
 interface DepositConfig {
     externalUserId: string;
-    destinationChainType?: "ethereum" | "solana" | "bitcoin";
+    destinationChainType?: ChainType;
     destinationChainId?: string;
     destinationTokenAddress?: string;
     destinationTokenSymbol?: string;
     recipientAddress?: string;
-    defaultChainType?: "ethereum" | "solana" | "bitcoin";
+    defaultChainType?: ChainType;
     defaultChainId?: string;
     defaultTokenAddress?: string;
     showBalance?: boolean;
@@ -704,7 +716,7 @@ interface WithdrawConfig {
     /** The user's wallet address — used to fetch balance. Wallet-agnostic: pass any address string. */
     senderAddress: string;
     /** Source token chain type (e.g. "ethereum") */
-    sourceChainType: "ethereum" | "solana" | "bitcoin";
+    sourceChainType: ChainType;
     /** Source token chain ID (e.g. "8453" for Base) */
     sourceChainId: string;
     /** Source token contract address */
@@ -747,4 +759,4 @@ interface UnifoldProviderProps {
 declare function UnifoldProvider({ children, publishableKey, config, }: UnifoldProviderProps): React$1.JSX.Element;
 declare function useUnifold(): ConnectContextValue;
 
-export { type AllowedCountryResult, type BorderRadiusConfig, BottomSheet, type ComponentConfig, type CustomThemeColors, type DepositConfig, type DepositError, type DepositInitialScreen, type DepositResult, type DestinationToken, type DestinationTokenChain, type FontConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeProviderConfig, type TransferInputVariant, type UnifoldConnectProviderConfig, UnifoldProvider, type UnifoldProviderProps, type WithdrawConfig, type WithdrawError, type WithdrawResult, type WithdrawTransactionInfo, getPreferredIcon, getSupportedDestinationTokens, normalizeIconUrl, registerStripeOnramp, setDevApiUrl, useAllowedCountry, useTheme, useUnifold };
+export { type AllowedCountryResult, type BalanceChainType, type BorderRadiusConfig, BottomSheet, type ChainType, type ComponentConfig, type CustomThemeColors, type DepositConfig, type DepositError, type DepositInitialScreen, type DepositResult, type DestinationToken, type DestinationTokenChain, type FontConfig, type ThemeColors, type ThemeConfig, type ThemeMode, type ThemeProviderConfig, type TransferInputVariant, type UnifoldConnectProviderConfig, UnifoldProvider, type UnifoldProviderProps, type WithdrawConfig, type WithdrawError, type WithdrawResult, type WithdrawTransactionInfo, getPreferredIcon, getSupportedDestinationTokens, normalizeIconUrl, registerStripeOnramp, setDevApiUrl, useAllowedCountry, useTheme, useUnifold };