@pollar/react 0.10.1-rc.4 → 0.10.1-rc.6

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, PollarAdapter, WalletId, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampTxStatus, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, WalletId, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampTxStatus, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
 export { AuthProviderContext, PollarAuthProvider, SessionsState } from '@pollar/core';
 import { ReactNode } from 'react';
 
@@ -115,6 +115,33 @@ interface PollarContextValue {
     }) => Promise<SubmitOutcome>;
     /** Open the swap modal. */
     openSwapModal: () => void;
+    /**
+     * The yield providers this app exposes to end-users (empty = Earn disabled,
+     * hide Earn UI). Mirrors {@link PollarClient.getEarnProviders}.
+     */
+    getEarnProviders: () => Promise<EarnProviderId[]>;
+    /**
+     * The vaults (DeFindex) or pools (Blend) a provider exposes, with live APY.
+     * Mirrors {@link PollarClient.getEarnOpportunities}.
+     */
+    getEarnOpportunities: (provider: EarnProviderId) => Promise<EarnOpportunity[]>;
+    /**
+     * The connected wallet's position (balance + APY) in a vault/pool. Read-only.
+     * Mirrors {@link PollarClient.getEarnPosition}.
+     */
+    getEarnPosition: (params: EarnPositionParams) => Promise<EarnPosition>;
+    /**
+     * Deposit into a vault/pool (asset amount). Drives the transaction state
+     * machine. Mirrors {@link PollarClient.earnDeposit}.
+     */
+    earnDeposit: (params: EarnTxParams) => Promise<SubmitOutcome>;
+    /**
+     * Withdraw from a vault/pool (amount in the position `withdrawUnit`). Mirrors
+     * {@link PollarClient.earnWithdraw}.
+     */
+    earnWithdraw: (params: EarnTxParams) => Promise<SubmitOutcome>;
+    /** Open the Earn modal. */
+    openEarnModal: () => void;
     openDistributionRulesModal: () => void;
     adapters?: PollarAdapters;
 }
@@ -169,7 +196,11 @@ interface WalletButtonTemplateProps {
     wrapperRef: React.RefObject<HTMLDivElement>;
     isInProgress: boolean;
     walletType: WalletId | null;
+    /** Show the "Create account" action (external wallet not yet on-chain, IMMEDIATE funding). */
+    showCreateAccount: boolean;
+    creatingAccount: boolean;
     onToggleOpen: () => void;
+    onCreateAccount: () => void;
     onCopy: () => void;
     onWalletBalance: () => void;
     onTxHistory: () => void;
@@ -182,7 +213,7 @@ interface WalletButtonTemplateProps {
     onLogout: () => void;
     onLogin: () => void;
 }
-declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied, dropdownBg, dropdownBorder, itemColor, wrapperRef, isInProgress, onToggleOpen, onCopy, onWalletBalance, onTxHistory, onSend, onReceive, onSessions, onKyc, onRamp, onDistributionRules, onLogout, onLogin, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
+declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied, dropdownBg, dropdownBorder, itemColor, wrapperRef, isInProgress, showCreateAccount, creatingAccount, onToggleOpen, onCreateAccount, onCopy, onWalletBalance, onTxHistory, onSend, onReceive, onSessions, onKyc, onRamp, onDistributionRules, onLogout, onLogin, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface KycModalProps {
     onClose: () => void;
@@ -232,6 +263,11 @@ interface SwapModalProps {
 }
 declare function SwapModal({ onClose }: SwapModalProps): react_jsx_runtime.JSX.Element;
 
+interface EarnModalProps {
+    onClose: () => void;
+}
+declare function EarnModal({ onClose }: EarnModalProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalProps {
     onClose: () => void;
 }
@@ -334,6 +370,7 @@ interface RampWidgetTemplateProps {
     provider: string;
     txStatus: RampTxStatus | null;
     kycUrl: string | null;
+    tosUrl: string | null;
     stellarTxHash: string | null;
     depositInstructions: Record<string, unknown> | null;
     canComplete: boolean;
@@ -347,12 +384,13 @@ interface RampWidgetTemplateProps {
     onSelectQuote: (q: RampQuote) => void;
     onContactContinue: () => void;
     onOpenKyc: () => void;
+    onOpenTos: () => void;
     onCompleteWithdraw: () => void;
     onRetry: () => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, isLoading, provider, txStatus, kycUrl, stellarTxHash, depositInstructions, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onContactContinue, onOpenKyc, onCompleteWithdraw, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
+declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, isLoading, provider, txStatus, kycUrl, tosUrl, stellarTxHash, depositInstructions, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onContactContinue, onOpenKyc, onOpenTos, onCompleteWithdraw, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TransactionModalTemplateProps {
     theme: string;
@@ -545,4 +583,4 @@ interface DistributionRulesModalTemplateProps {
 }
 declare function DistributionRulesModalTemplate({ theme, accentColor, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };
+export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EarnModal, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };