@compass-labs/widgets 0.1.38 → 0.1.40

package/dist/index.d.mts

@@ -273,6 +273,30 @@ interface TypedDataToSign {
     primaryType: string;
     message: Record<string, unknown>;
 }
+/**
+ * Parameters for the fiat on-ramp funding callback
+ */
+interface FundWalletParams {
+    /** Destination address (e.g. earn/credit account Safe proxy) */
+    address: string;
+    /** Target chain ID (e.g. 1 for Ethereum, 8453 for Base) */
+    chainId: number;
+    /** Token symbol to purchase (e.g. 'USDC') */
+    asset: string;
+    /** Decimal amount string (e.g. '50') */
+    amount: string;
+}
+/**
+ * Parameters for sending a raw transaction from the wallet
+ */
+interface SendTransactionParams {
+    /** Destination contract or EOA address */
+    to: string;
+    /** Encoded calldata (e.g. ERC-20 transfer) */
+    data?: string;
+    /** Value in wei (hex string) */
+    value?: string;
+}
 /**
  * Wallet adapter interface for bringing your own wallet
  *
@@ -325,6 +349,24 @@ interface WalletAdapter {
      * If provided, widgets will show a logout button when connected
      */
     logout?: () => Promise<void>;
+    /**
+     * Buy crypto via fiat on-ramp (optional)
+     * When provided, widgets show a "Buy crypto" option in Add/Fund modals.
+     * Implement with your on-ramp provider (e.g. Privy's useFundWallet).
+     */
+    fundWallet?: (params: FundWalletParams) => Promise<void>;
+    /**
+     * Whether the user has an external wallet connected (optional)
+     * When false, widgets hide Deposit/Withdraw tabs (email/social login users
+     * only see the Buy crypto option). Defaults to true if not provided.
+     */
+    hasExternalWallet?: boolean;
+    /**
+     * Send a raw transaction from the wallet (optional)
+     * When provided, widgets show a "Send" tab for email users to transfer
+     * tokens from their embedded wallet to any address.
+     */
+    sendTransaction?: (params: SendTransactionParams) => Promise<string>;
 }
 
 interface CompassProviderProps {
@@ -700,6 +742,12 @@ interface WalletContextValue {
     login: (() => void) | null;
     /** Disconnect wallet - may not be available depending on wallet adapter */
     logout: (() => Promise<void>) | null;
+    /** Buy crypto via fiat on-ramp - may not be available depending on wallet adapter */
+    fundWallet: ((params: FundWalletParams) => Promise<void>) | null;
+    /** Whether the user has an external wallet (false = email/social login, show Buy only) */
+    hasExternalWallet: boolean;
+    /** Send a raw transaction from the wallet - may not be available depending on wallet adapter */
+    sendTransaction: ((params: SendTransactionParams) => Promise<string>) | null;
 }
 /**
  * Hook to access the wallet context
@@ -857,7 +905,7 @@ interface CreditAccountGuardProps {
 }
 declare function CreditAccountGuard({ children, loadingComponent, createAccountComponent, }: CreditAccountGuardProps): react_jsx_runtime.JSX.Element;
 
-type TransferAction = 'deposit' | 'withdraw';
+type TransferAction = 'deposit' | 'withdraw' | 'buy' | 'send';
 interface EarnAccountBalanceProps {
     /** Compact mode - just show total USD value */
     compact?: boolean;
@@ -961,4 +1009,4 @@ interface ChainConfig {
 }
 declare const CHAINS: Record<SupportedChainId, ChainConfig>;
 
-export { AccountBalancesModal, type AccountBalancesModalProps, type AccountSummary, ActionModal, ApiProvider, CHAINS, type ChainConfig, ChainSwitcher, type CollateralPosition, CompassEarnWidget, type CompassEarnWidgetProps, CompassProvider, type CompassProviderProps, type CompassTheme, CopyableAddress, type CopyableAddressProps, CreditAccount, type CreditAccountContextValue, CreditAccountGuard, type CreditAccountProps, type CreditPositionsResponse, type TokenBalance as CreditTokenBalance, type DebtPosition, DepositWithdrawForm, EarnAccount, EarnAccountBalance, type EarnAccountBalanceProps, type EarnAccountContextValue, EarnAccountGuard, type EarnAccountProps, type FeaturePreset, type IdleBalance, PnLSummary, type PortfolioPosition, type PortfolioState, type RebalanceAction, type RebalanceActionType, type RebalancePlan, RebalancingWidget, type RebalancingWidgetProps, type SupportedChain, type SupportedChainId, SwapForm, type SwapFormProps, type SwapQuote, type TabConfig, type TabId, type TargetAllocation, type ThemeInput, type ThemeMode, type ThemePresetName, ThemeProvider, type TokenBalance$1 as TokenBalance, TransactionHistory, type TypedDataToSign, type VenueType$1 as VenueType, type WalletAdapter, WalletStatus, themePresets, useChain, useCompassApi, useCompassChain, useCompassWallet, useCreditAccount, useEarnAccount, useEmbeddableApi, useEmbeddableWallet, useRebalancingData, useSwapQuote, useTheme };
+export { AccountBalancesModal, type AccountBalancesModalProps, type AccountSummary, ActionModal, ApiProvider, CHAINS, type ChainConfig, ChainSwitcher, type CollateralPosition, CompassEarnWidget, type CompassEarnWidgetProps, CompassProvider, type CompassProviderProps, type CompassTheme, CopyableAddress, type CopyableAddressProps, CreditAccount, type CreditAccountContextValue, CreditAccountGuard, type CreditAccountProps, type CreditPositionsResponse, type TokenBalance as CreditTokenBalance, type DebtPosition, DepositWithdrawForm, EarnAccount, EarnAccountBalance, type EarnAccountBalanceProps, type EarnAccountContextValue, EarnAccountGuard, type EarnAccountProps, type FeaturePreset, type FundWalletParams, type IdleBalance, PnLSummary, type PortfolioPosition, type PortfolioState, type RebalanceAction, type RebalanceActionType, type RebalancePlan, RebalancingWidget, type RebalancingWidgetProps, type SendTransactionParams, type SupportedChain, type SupportedChainId, SwapForm, type SwapFormProps, type SwapQuote, type TabConfig, type TabId, type TargetAllocation, type ThemeInput, type ThemeMode, type ThemePresetName, ThemeProvider, type TokenBalance$1 as TokenBalance, TransactionHistory, type TypedDataToSign, type VenueType$1 as VenueType, type WalletAdapter, WalletStatus, themePresets, useChain, useCompassApi, useCompassChain, useCompassWallet, useCreditAccount, useEarnAccount, useEmbeddableApi, useEmbeddableWallet, useRebalancingData, useSwapQuote, useTheme };

package/dist/index.d.ts

@@ -273,6 +273,30 @@ interface TypedDataToSign {
     primaryType: string;
     message: Record<string, unknown>;
 }
+/**
+ * Parameters for the fiat on-ramp funding callback
+ */
+interface FundWalletParams {
+    /** Destination address (e.g. earn/credit account Safe proxy) */
+    address: string;
+    /** Target chain ID (e.g. 1 for Ethereum, 8453 for Base) */
+    chainId: number;
+    /** Token symbol to purchase (e.g. 'USDC') */
+    asset: string;
+    /** Decimal amount string (e.g. '50') */
+    amount: string;
+}
+/**
+ * Parameters for sending a raw transaction from the wallet
+ */
+interface SendTransactionParams {
+    /** Destination contract or EOA address */
+    to: string;
+    /** Encoded calldata (e.g. ERC-20 transfer) */
+    data?: string;
+    /** Value in wei (hex string) */
+    value?: string;
+}
 /**
  * Wallet adapter interface for bringing your own wallet
  *
@@ -325,6 +349,24 @@ interface WalletAdapter {
      * If provided, widgets will show a logout button when connected
      */
     logout?: () => Promise<void>;
+    /**
+     * Buy crypto via fiat on-ramp (optional)
+     * When provided, widgets show a "Buy crypto" option in Add/Fund modals.
+     * Implement with your on-ramp provider (e.g. Privy's useFundWallet).
+     */
+    fundWallet?: (params: FundWalletParams) => Promise<void>;
+    /**
+     * Whether the user has an external wallet connected (optional)
+     * When false, widgets hide Deposit/Withdraw tabs (email/social login users
+     * only see the Buy crypto option). Defaults to true if not provided.
+     */
+    hasExternalWallet?: boolean;
+    /**
+     * Send a raw transaction from the wallet (optional)
+     * When provided, widgets show a "Send" tab for email users to transfer
+     * tokens from their embedded wallet to any address.
+     */
+    sendTransaction?: (params: SendTransactionParams) => Promise<string>;
 }
 
 interface CompassProviderProps {
@@ -700,6 +742,12 @@ interface WalletContextValue {
     login: (() => void) | null;
     /** Disconnect wallet - may not be available depending on wallet adapter */
     logout: (() => Promise<void>) | null;
+    /** Buy crypto via fiat on-ramp - may not be available depending on wallet adapter */
+    fundWallet: ((params: FundWalletParams) => Promise<void>) | null;
+    /** Whether the user has an external wallet (false = email/social login, show Buy only) */
+    hasExternalWallet: boolean;
+    /** Send a raw transaction from the wallet - may not be available depending on wallet adapter */
+    sendTransaction: ((params: SendTransactionParams) => Promise<string>) | null;
 }
 /**
  * Hook to access the wallet context
@@ -857,7 +905,7 @@ interface CreditAccountGuardProps {
 }
 declare function CreditAccountGuard({ children, loadingComponent, createAccountComponent, }: CreditAccountGuardProps): react_jsx_runtime.JSX.Element;
 
-type TransferAction = 'deposit' | 'withdraw';
+type TransferAction = 'deposit' | 'withdraw' | 'buy' | 'send';
 interface EarnAccountBalanceProps {
     /** Compact mode - just show total USD value */
     compact?: boolean;
@@ -961,4 +1009,4 @@ interface ChainConfig {
 }
 declare const CHAINS: Record<SupportedChainId, ChainConfig>;
 
-export { AccountBalancesModal, type AccountBalancesModalProps, type AccountSummary, ActionModal, ApiProvider, CHAINS, type ChainConfig, ChainSwitcher, type CollateralPosition, CompassEarnWidget, type CompassEarnWidgetProps, CompassProvider, type CompassProviderProps, type CompassTheme, CopyableAddress, type CopyableAddressProps, CreditAccount, type CreditAccountContextValue, CreditAccountGuard, type CreditAccountProps, type CreditPositionsResponse, type TokenBalance as CreditTokenBalance, type DebtPosition, DepositWithdrawForm, EarnAccount, EarnAccountBalance, type EarnAccountBalanceProps, type EarnAccountContextValue, EarnAccountGuard, type EarnAccountProps, type FeaturePreset, type IdleBalance, PnLSummary, type PortfolioPosition, type PortfolioState, type RebalanceAction, type RebalanceActionType, type RebalancePlan, RebalancingWidget, type RebalancingWidgetProps, type SupportedChain, type SupportedChainId, SwapForm, type SwapFormProps, type SwapQuote, type TabConfig, type TabId, type TargetAllocation, type ThemeInput, type ThemeMode, type ThemePresetName, ThemeProvider, type TokenBalance$1 as TokenBalance, TransactionHistory, type TypedDataToSign, type VenueType$1 as VenueType, type WalletAdapter, WalletStatus, themePresets, useChain, useCompassApi, useCompassChain, useCompassWallet, useCreditAccount, useEarnAccount, useEmbeddableApi, useEmbeddableWallet, useRebalancingData, useSwapQuote, useTheme };
+export { AccountBalancesModal, type AccountBalancesModalProps, type AccountSummary, ActionModal, ApiProvider, CHAINS, type ChainConfig, ChainSwitcher, type CollateralPosition, CompassEarnWidget, type CompassEarnWidgetProps, CompassProvider, type CompassProviderProps, type CompassTheme, CopyableAddress, type CopyableAddressProps, CreditAccount, type CreditAccountContextValue, CreditAccountGuard, type CreditAccountProps, type CreditPositionsResponse, type TokenBalance as CreditTokenBalance, type DebtPosition, DepositWithdrawForm, EarnAccount, EarnAccountBalance, type EarnAccountBalanceProps, type EarnAccountContextValue, EarnAccountGuard, type EarnAccountProps, type FeaturePreset, type FundWalletParams, type IdleBalance, PnLSummary, type PortfolioPosition, type PortfolioState, type RebalanceAction, type RebalanceActionType, type RebalancePlan, RebalancingWidget, type RebalancingWidgetProps, type SendTransactionParams, type SupportedChain, type SupportedChainId, SwapForm, type SwapFormProps, type SwapQuote, type TabConfig, type TabId, type TargetAllocation, type ThemeInput, type ThemeMode, type ThemePresetName, ThemeProvider, type TokenBalance$1 as TokenBalance, TransactionHistory, type TypedDataToSign, type VenueType$1 as VenueType, type WalletAdapter, WalletStatus, themePresets, useChain, useCompassApi, useCompassChain, useCompassWallet, useCreditAccount, useEarnAccount, useEmbeddableApi, useEmbeddableWallet, useRebalancingData, useSwapQuote, useTheme };