@pollar/react 0.11.3-rc.1 → 0.11.4-rc.1

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, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, PasskeyCeremony, PasskeySigner, WalletId, WalletChain, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampTxStatus, RampDepositInstructions, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, PasskeyCeremony, PasskeySigner, WalletChain, KycStatus as KycStatus$1, RampQuote, WalletId, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampQuoteRequirement, RampTxStatus, RampDepositInstructions, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
 export { AuthProviderContext, PollarAuthProvider, SessionsState } from '@pollar/core';
 import { ReactNode, CSSProperties } from 'react';
 
@@ -22,13 +22,13 @@ interface PollarContextValue {
     /**
      * The authenticated user's wallet as a discriminated union over `custody`
      * (`internal` | `smart` | `external`), or `null` when unauthenticated. Every
-     * field is meaningful for any login method — `custody` is always present and
+     * field is meaningful for any login method - `custody` is always present and
      * strictly determines the shape of `provider`. Use `wallet.address` for the
      * on-chain address and `wallet.provider` for the wallet/login provider.
      */
     wallet: WalletInfo | null;
     /**
-     * Every wallet the user holds, one per chain — a superset of {@link wallet},
+     * Every wallet the user holds, one per chain - a superset of {@link wallet},
      * with `chain` populated. `[]` when unauthenticated. Drives the network
      * selector in the Send / Wallet Balance / Assets modals: each entry is a
      * network the user can switch to, and the first one is the default.
@@ -40,7 +40,7 @@ interface PollarContextValue {
     /**
      * `true` once the server has confirmed the session (login / refresh /
      * `/auth/session/resume`). `false` while a cold-start session is still
-     * optimistic — gate sensitive actions (e.g. signing) on this.
+     * optimistic - gate sensitive actions (e.g. signing) on this.
      */
     verified: boolean;
     login: (options: PollarLoginOptions) => void;
@@ -52,7 +52,7 @@ interface PollarContextValue {
     styles: PollarStyles;
     /** Remote app-config load state. 'loading' while the initial fetch is in
      *  flight, 'error' if it failed (styles fall back to empty defaults), 'ready'
-     *  once resolved — or immediately 'ready' when `appConfig` is passed as a prop.
+     *  once resolved - or immediately 'ready' when `appConfig` is passed as a prop.
      *  The login modal shows a spinner/retry instead of an empty shell until this
      *  is 'ready'. */
     configStatus: 'loading' | 'ready' | 'error';
@@ -63,17 +63,17 @@ interface PollarContextValue {
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
     signAndSubmitTx: (unsignedXdr?: string) => Promise<SubmitOutcome>;
-    /** External-wallet only. Custodial flows should use `signAndSubmitTx`. */
+    /** Sign only. Embedded sessions sign server-side, external sessions through their adapter. Smart wallets use `signAndSubmitTx`. */
     signTx: (unsignedXdr: string) => Promise<SignOutcome>;
     submitTx: (signedXdr: string) => Promise<SubmitOutcome>;
-    /** One-shot: build → sign → submit. Drives the same TransactionState flow as the split calls. */
+    /** One-shot: build -> sign -> submit. Drives the same TransactionState flow as the split calls. */
     buildAndSignAndSubmitTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
     /** Alias of `buildAndSignAndSubmitTx`. */
     runTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
     /**
      * Send a payment on any chain the user holds a wallet on. Stellar keeps the
      * split flow (so external adapters and passkeys still work); a chain whose
-     * signature expires goes through one server-side call and is custodial-only.
+     * signature expires goes through one server-side call and is embedded-only.
      */
     sendPayment: (params: SendPaymentParams) => Promise<SubmitOutcome>;
     network: StellarNetwork;
@@ -104,6 +104,8 @@ interface PollarContextValue {
     /** Open the enabled-assets / trustline-state modal. */
     openEnabledAssetsModal: () => void;
     openKycModal: (options?: {
+        corridorId?: string;
+        providerId?: string;
         country?: string;
         level?: 'basic' | 'intermediate' | 'enhanced';
         onApproved?: () => void;
@@ -194,13 +196,13 @@ interface PollarProviderProps {
      * bypass the type anyway (plain JS, or a cast), each missing field lands on a
      * default scattered across the components rather than on anything central:
      *
-     *   chains       absent → the chain order/filter falls back to the order the
+     *   chains       absent -> the chain order/filter falls back to the order the
      *                         session listed the user's wallets in (see useChains)
-     *   name         absent → 'Pollar'
-     *   theme        absent → 'light'
-     *   accentColor  absent → '#005DB4'
+     *   name         absent -> 'Pollar'
+     *   theme        absent -> 'light'
+     *   accentColor  absent -> '#005DB4'
      *   emailEnabled, providers, embeddedWallets, smartWallet
-     *                absent → false. NOTE: that means EVERY login method is off
+     *                absent -> false. NOTE: that means EVERY login method is off
      *                         and the login modal renders with no way in.
      *
      * Leave this `undefined` to have the SDK fetch `/applications/config` on
@@ -235,16 +237,16 @@ declare function createPollarAdapterHook<T extends PollarAdapter>(key: string):
  *
  * `mode` is set explicitly by the caller's button, so there's no ambiguous
  * autodetect:
- *   - `'login'`    → `get()` only (returning user — the OS shows the account
+ *   - `'login'`    -> `get()` only (returning user - the OS shows the account
  *                    picker for discoverable credentials on this domain). A
  *                    failure here is surfaced as-is; it never falls through to
  *                    registration, so cancelling the prompt can't accidentally
  *                    create a second wallet.
- *   - `'register'` → `create()` only (new user → the server deploys the
+ *   - `'register'` -> `create()` only (new user -> the server deploys the
  *                    C-address).
  *
  * rpId = the current page's hostname (the customer app's domain), which is what
- * the passkey is bound to — the anti-phishing guarantee.
+ * the passkey is bound to - the anti-phishing guarantee.
  */
 declare const browserPasskeyCeremony: PasskeyCeremony;
 /**
@@ -256,6 +258,25 @@ declare const browserPasskeyCeremony: PasskeyCeremony;
  */
 declare const browserPasskeySigner: PasskeySigner;
 
+/**
+ * The one place the widget decides whether a wallet can act on-chain, and what
+ * to say when it cannot.
+ *
+ * Only STELLAR is gated: `provisioning` describes the Stellar account, and a
+ * Solana wallet has nothing to wait for. Only the ACCOUNT is described, never
+ * trustlines - an asset the app enabled yesterday is not a reason to stop a
+ * user from sending the one they already hold.
+ *
+ * A `null` chain is "not known yet" (the app's chain order comes from
+ * `/config`, which is still in flight on a cold start) and reads as no reason
+ * to block. Guessing STELLAR there would tell a Solana-first user their wallet
+ * is being prepared, next to a Solana address that sends and receives fine.
+ *
+ * Returns null when the wallet is usable, so a caller reads it as "no reason to
+ * block".
+ */
+declare function walletNotReadyReason(wallet: WalletInfo | null | undefined, chain: WalletChain | null | undefined): string | null;
+
 declare function WalletButton(): react_jsx_runtime.JSX.Element;
 
 interface WalletButtonTemplateProps {
@@ -268,9 +289,15 @@ interface WalletButtonTemplateProps {
     itemColor: string;
     wrapperRef: React.RefObject<HTMLDivElement>;
     isInProgress: boolean;
-    walletType: WalletId | null;
     /** Show the "Create account" action (external wallet not yet on-chain, IMMEDIATE funding). */
     showCreateAccount: boolean;
+    /**
+     * Why the wallet cannot act on-chain yet (its account is being created, or
+     * that failed), or null when it can. Shown as a banner in the dropdown, since
+     * the address itself is valid and worth copying either way. Optional, so a
+     * custom template written before this existed keeps compiling.
+     */
+    notReadyReason?: string | null;
     creatingAccount: boolean;
     onToggleOpen: () => void;
     onCreateAccount: () => void;
@@ -286,7 +313,7 @@ interface WalletButtonTemplateProps {
     onLogout: () => void;
     onLogin: () => void;
 }
-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;
+declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied, dropdownBg, dropdownBorder, itemColor, wrapperRef, isInProgress, showCreateAccount, notReadyReason, creatingAccount, onToggleOpen, onCreateAccount, onCopy, onWalletBalance, onTxHistory, onSend, onReceive, onSessions, onKyc, onRamp, onDistributionRules, onLogout, onLogin, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
 
 /**
  * The chain a record lives on, with the legacy shape folded in: sessions and
@@ -295,9 +322,9 @@ declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied
  */
 declare function resolveChain(chain: WalletChain | undefined): WalletChain;
 /**
- * The selectable chains — the first is the default everywhere (network picker,
+ * The selectable chains - the first is the default everywhere (network picker,
  * the address the wallet button shows). De-duplicated because two wallets on one
- * chain (e.g. a custodial and a linked external Stellar wallet) are still one
+ * chain (e.g. an embedded and a linked external Stellar wallet) are still one
  * network choice.
  *
  * `order` is the app's chain list from `/applications/config`, as arranged in the
@@ -347,21 +374,74 @@ interface UseChainsResult {
 declare function useChains(): UseChainsResult;
 
 interface KycModalProps {
+    corridorId?: string;
+    /** Open this option directly instead of listing the choices (the one a ramp's KYC gate names). */
+    providerId?: string;
     onClose: () => void;
     /** ISO 3166-1 alpha-2 country code to filter providers. Defaults to 'MX'. */
     country?: string;
-    /** KYC level required. Defaults to 'basic'. */
+    /** Legacy fallback for older backends. Named options select their own workflow. */
     level?: 'basic' | 'intermediate' | 'enhanced';
     /** Called when KYC is successfully approved. */
     onApproved?: () => void;
 }
-declare function KycModal({ onClose, country, level, onApproved }: KycModalProps): react_jsx_runtime.JSX.Element;
+declare function KycModal({ onClose, country, level, onApproved, corridorId, providerId }: KycModalProps): react_jsx_runtime.JSX.Element;
+
+interface RequirementFormModalProps {
+    formId: string;
+    /** Position of this step over the route's steps, when known. */
+    progress?: {
+        position: number;
+        total: number;
+    };
+    onClose: () => void;
+    /** Called once the answers are stored. */
+    onSubmitted: () => void;
+}
+/** One FORM requirement step: the form a route asks for, prefilled with the user's previous answers. */
+declare function RequirementFormModal({ formId, progress, onClose, onSubmitted }: RequirementFormModalProps): react_jsx_runtime.JSX.Element;
+
+interface RegistryCheckModalProps {
+    optionId: string;
+    /** Position of this step over the route's steps, when known. */
+    progress?: {
+        position: number;
+        total: number;
+    };
+    onClose: () => void;
+    /** Called once the registry confirmed the data. */
+    onApproved: () => void;
+}
+/**
+ * One REGISTRY_CHECK step (SEGIP): the user's verified data, prefilled and read-only
+ * except for the surname split and the CI complement, sent to the registry on confirm.
+ */
+declare function RegistryCheckModal({ optionId, progress, onClose, onApproved }: RegistryCheckModalProps): react_jsx_runtime.JSX.Element;
+
+interface ProviderRegistrationModalProps {
+    corridorId: string;
+    /** Position of this step over the route's steps, when known. */
+    progress?: {
+        position: number;
+        total: number;
+    };
+    onClose: () => void;
+    /** Called once the user is registered with the provider. */
+    onRegistered: () => void;
+}
+/**
+ * One PROVIDER_REGISTRATION step: what the ramp provider receives, listed before the
+ * user consents. Registering is the consent; nothing is sent until then.
+ */
+declare function ProviderRegistrationModal({ corridorId, progress, onClose, onRegistered }: ProviderRegistrationModalProps): react_jsx_runtime.JSX.Element;
 
 interface KycStatusProps {
     status: KycStatus$1;
+    /** Replaces the status label, keeping its color. */
+    label?: string;
     className?: string;
 }
-declare function KycStatus({ status, className }: KycStatusProps): react_jsx_runtime.JSX.Element;
+declare function KycStatus({ status, label, className }: KycStatusProps): react_jsx_runtime.JSX.Element;
 
 interface RampWidgetProps {
     onClose: () => void;
@@ -370,7 +450,7 @@ declare function RampWidget({ onClose }: RampWidgetProps): react_jsx_runtime.JSX
 
 interface RouteDisplayProps {
     quote: RampQuote;
-    /** This route is the one being started — it owns the in-flight request. */
+    /** This route is the one being started - it owns the in-flight request. */
     busy?: boolean;
     /** Another route is starting, so this one is not selectable meanwhile. */
     disabled?: boolean;
@@ -428,7 +508,7 @@ interface ModalStyleOverrides {
      *  keeps its theme color, so the two stay distinguishable. */
     textColor?: string | null | undefined;
     /** Fill of the SECONDARY buttons (the wallet / social / provider entries, the
-     *  retry button). The primary button is the accent's job. Unset ⇒ the theme's
+     *  retry button). The primary button is the accent's job. Unset => the theme's
      *  own surface color, which is what these buttons always used. */
     buttonColor?: string | null | undefined;
     /** Radius of the modal card itself, in px. */
@@ -438,17 +518,17 @@ interface ModalStyleOverrides {
 }
 /** Text color that stays legible on `background`. The primary button's label was
  *  hardcoded white, which a light fill (the Amber accent preset, say) turns
- *  invisible — so it follows the fill's luminance instead. Unparseable colors
+ *  invisible - so it follows the fill's luminance instead. Unparseable colors
  *  keep white, the pre-existing behavior. */
 declare function readableTextOn(background: string): string;
 /** How much room a modal gives its header. 'hero' is the identity-forward set
  *  (login, KYC, ramp, the Privy sub-modal): roomier padding and a larger
  *  centered heading. 'compact' is every utility modal (send, balance, history,
- *  …), which keeps the card's own 1.75rem padding. */
+ *  ...), which keeps the card's own 1.75rem padding. */
 type ModalVariant = 'hero' | 'compact';
 /** Theme-derived CSS custom properties shared by every Pollar modal, plus the
  *  per-app overrides on top. One definition so the whole modal family stays
- *  visually in lockstep — a var added here reaches all of them at once. */
+ *  visually in lockstep - a var added here reaches all of them at once. */
 declare function buildModalCssVars(theme: string, accentColor: string, overrides?: ModalStyleOverrides, variant?: ModalVariant): CSSProperties;
 /** Everything a modal wrapper needs to dress itself from the app's branding:
  *  the theme pair its template already took, the overrides to forward to that
@@ -490,7 +570,7 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
-    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, ...). */
     walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
@@ -522,13 +602,20 @@ interface KycModalTemplateProps {
     selectedProvider: KycProvider | null;
     session: KycStartResponse | null;
     kycStatus: KycStatus$1;
+    /** Set when the decision is held for manual review (e.g. DUPLICATE_DOCUMENT). */
+    reviewReason?: string | null;
+    /** The vendor approved and Pollar is still recording it (`kycStatus` stays `pending`). */
+    processing?: boolean;
     isLoading: boolean;
+    error?: string | null;
     onSelectProvider: (provider: KycProvider) => void;
     onDoneVerifying: () => void;
+    /** Open a new session after the previous one expired. */
+    onStartAgain?: () => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function KycModalTemplate({ theme, accentColor, styleOverrides, step, providers, selectedProvider, session, kycStatus, isLoading, onSelectProvider, onDoneVerifying, onRefresh, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function KycModalTemplate({ theme, accentColor, styleOverrides, step, providers, selectedProvider, session, kycStatus, reviewReason, processing, isLoading, error, onSelectProvider, onDoneVerifying, onStartAgain, onRefresh, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 type RampStep = 'input' | 'loading_quote' | 'select_route' | 'contact' | 'status' | 'error';
 /** A field a provider declares (via the quote) that the client must collect. */
@@ -537,7 +624,7 @@ interface RampFieldSpec {
     label: string;
     type: 'text' | 'email' | 'tel' | 'select';
     bankType?: 'CLABE' | 'PIX' | 'PSE' | 'ACH' | 'BREB';
-    /** For `type: 'select'` — dropdown choices (e.g. Stereum's Bolivian banks). */
+    /** For `type: 'select'` - dropdown choices (e.g. Stereum's Bolivian banks). */
     options?: {
         value: string;
         label: string;
@@ -580,6 +667,8 @@ interface RampWidgetTemplateProps {
     countriesLoading: boolean;
     refreshing: boolean;
     quotes: RampQuote[];
+    /** Routes not quoted until the user completes the requirement step their corridor names (KYC, form, registry check or provider registration). */
+    kycRequired: RampQuoteRequirement[];
     isLoading: boolean;
     provider: string;
     txStatus: RampTxStatus | null;
@@ -587,7 +676,14 @@ interface RampWidgetTemplateProps {
     tosUrl: string | null;
     /** Provider gated the flow on KYC and published no link; nothing was signed. */
     kycBlocking: boolean;
-    /** The gate has since cleared — the user needs a fresh quote to continue. */
+    /**
+     * Which part of provider onboarding is outstanding, when any is. Optional
+     * because this template is exported for integrators who render their own
+     * chrome: a required prop would break every one of them on upgrade. Omitted,
+     * the gate falls back to the identity-verification wording.
+     */
+    onboardingStatus?: 'kyc' | 'endorsement' | 'awaiting_provider' | null;
+    /** The gate has since cleared - the user needs a fresh quote to continue. */
     kycJustApproved: boolean;
     stellarTxHash: string | null;
     /** Stellar Expert URL for `stellarTxHash` (network-aware); null when unknown. */
@@ -596,12 +692,15 @@ interface RampWidgetTemplateProps {
     canComplete: boolean;
     completing: boolean;
     errorMsg: string | null;
+    /** Neutral guidance on the route list, e.g. after identity verification sent the user back to it. */
+    noticeMsg?: string | null;
     onDirectionChange: (d: RampDirection) => void;
     onAmountChange: (v: string) => void;
     onFieldChange: (key: string, value: string) => void;
     onCountryChange: (v: string) => void;
     onFindRoute: () => void;
     onSelectQuote: (q: RampQuote) => void;
+    onVerifyRoute: (requirement: RampQuoteRequirement) => void;
     onContactContinue: () => void;
     onOpenKyc: () => void;
     onOpenTos: () => void;
@@ -613,7 +712,7 @@ interface RampWidgetTemplateProps {
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function RampWidgetTemplate({ theme, accentColor, styleOverrides, step, flowSteps, flowStepIndex, startingQuoteId, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, isLoading, provider, txStatus, kycUrl, tosUrl, kycBlocking, kycJustApproved, stellarTxHash, explorerUrl, depositInstructions, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onContactContinue, onOpenKyc, onOpenTos, onCompleteWithdraw, onBack, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
+declare function RampWidgetTemplate({ theme, accentColor, styleOverrides, step, flowSteps, flowStepIndex, startingQuoteId, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, kycRequired, isLoading, provider, txStatus, kycUrl, tosUrl, kycBlocking, onboardingStatus, kycJustApproved, stellarTxHash, explorerUrl, depositInstructions, canComplete, completing, errorMsg, noticeMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onVerifyRoute, onContactContinue, onOpenKyc, onOpenTos, onCompleteWithdraw, onBack, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TransactionModalTemplateProps {
     theme: string;
@@ -675,16 +774,21 @@ interface WalletBalanceModalTemplateProps {
     walletBalance: WalletBalanceState;
     /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
-    /** Networks the user holds a wallet on; the first one is the default. */
-    chains: WalletChain[];
+    /** Asset catalog metadata, when already available in the provider. */
+    assetMetadata?: EnabledAssetRecord[];
+    /**
+     * The networks the user holds a wallet on, in the app's configured order.
+     * The picker renders only with two or more, so a single-chain app shows none.
+     */
+    chains?: WalletChain[];
     selectedChain: WalletChain | null;
-    /** testnet vs mainnet — gates the Solana devnet faucet hint. */
+    /** testnet vs mainnet - gates the Solana devnet faucet hint. */
     network: StellarNetwork;
-    onSelectChain: (chain: WalletChain) => void;
+    onSelectChain?: (chain: WalletChain) => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function WalletBalanceModalTemplate({ theme, accentColor, styleOverrides, walletBalance, walletAddress, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function WalletBalanceModalTemplate({ theme, accentColor, styleOverrides, walletBalance, walletAddress, assetMetadata, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface EnabledAssetsModalTemplateProps {
     theme: string;
@@ -732,14 +836,28 @@ interface SendModalTemplateProps {
     txTitle: string;
     assets: WalletBalanceRecord[];
     selectedAsset: WalletBalanceRecord | null;
-    /** Networks the user holds a wallet on; the first one is the default. */
-    chains: WalletChain[];
     selectedChain: WalletChain | null;
-    /** Address of the wallet on {@link selectedChain}, shown under the picker. */
-    walletAddress: string;
+    /**
+     * The networks the user can send from, in the app's configured order. The
+     * picker renders only with two or more, so a single-chain app shows none.
+     */
+    chains?: WalletChain[];
+    /** @deprecated Kept for compatibility; the sender address is no longer shown. */
+    walletAddress?: string;
     /** Can a payment be built on {@link selectedChain}? Stellar and Solana only. */
     canSendOnChain: boolean;
-    onSelectChain: (chain: WalletChain) => void;
+    /**
+     * Why the wallet cannot act on-chain right now (its Stellar account is still
+     * being created, or its creation failed), or null when it can.
+     *
+     * Separate from {@link canSendOnChain}: that one is about the NETWORK not
+     * having a transfer path, this one about the user's own account. Collapsing
+     * them would tell someone waiting on a brand-new wallet that Stellar does not
+     * support sending. Optional, so a custom template written before this existed
+     * keeps compiling.
+     */
+    notReadyReason?: string | null;
+    onSelectChain?: (chain: WalletChain) => void;
     amount: string;
     destination: string;
     formError: string;
@@ -756,6 +874,8 @@ interface SendModalTemplateProps {
     onRefresh: () => void;
     onSelectAsset: (asset: WalletBalanceRecord) => void;
     onAmountChange: (value: string) => void;
+    onMax: () => void;
+    onPaste: () => void;
     onDestinationChange: (value: string) => void;
     onSubmit: () => void;
     onSignAndSend: () => void;
@@ -764,9 +884,8 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-declare function SendModalTemplate({ theme, accentColor, styleOverrides, step, txTitle, assets, selectedAsset, chains, selectedChain, walletAddress, canSendOnChain, onSelectChain, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectAsset, onAmountChange, onDestinationChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SendModalTemplate({ theme, accentColor, styleOverrides, step, txTitle, assets, selectedAsset, selectedChain, canSendOnChain, notReadyReason, chains, onSelectChain, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectAsset, onAmountChange, onMax, onPaste, onDestinationChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-/** A selectable asset in the sell/buy pickers, normalized across balance/enabled records. */
 interface SwapAssetOption {
     ref: SwapQuoteParams['sellAsset'];
     code: string;
@@ -777,7 +896,6 @@ interface SwapAssetOption {
 interface SwapModalTemplateProps {
     theme: string;
     accentColor: string;
-    /** Per-app modal chrome overrides (background, card + button radius). */
     styleOverrides?: ModalStyleOverrides;
     step: 'form' | 'tx';
     txTitle: string;
@@ -794,11 +912,8 @@ interface SwapModalTemplateProps {
     formError: string;
     isLoadingData: boolean;
     smartUnsupported: boolean;
-    /** Swap config is still loading. */
     configLoading: boolean;
-    /** Config loaded and this app exposes no swap venues — swap is disabled. */
     swapUnavailable: boolean;
-    /** Buying the selected asset will create a trustline first (~0.5 XLM reserve). */
     buyNeedsTrustline: boolean;
     transaction: TransactionState;
     showXdr: boolean;
@@ -812,7 +927,8 @@ interface SwapModalTemplateProps {
     onRefresh: () => void;
     onSelectSell: (o: SwapAssetOption) => void;
     onSelectBuy: (o: SwapAssetOption) => void;
-    /** Add a user-pasted token (code + issuer) to the buy list. Returns an error or null. */
+    onReverse: () => void;
+    onMax: () => void;
     onAddCustomToken: (code: string, issuer: string) => string | null;
     onAmountChange: (value: string) => void;
     onProviderChange: (p: SwapProvider) => void;
@@ -822,7 +938,7 @@ interface SwapModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-declare function SwapModalTemplate({ theme, accentColor, styleOverrides, step, txTitle, sellOptions, buyOptions, selectedSell, selectedBuy, amount, provider, providers, quote, quoteLoading, quoteError, formError, isLoadingData, smartUnsupported, configLoading, swapUnavailable, buyNeedsTrustline, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectSell, onSelectBuy, onAddCustomToken, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SwapModalTemplate({ theme, accentColor, styleOverrides, step, txTitle, sellOptions, buyOptions, selectedSell, selectedBuy, amount, provider, providers, quote, quoteLoading, quoteError, formError, isLoadingData, smartUnsupported, configLoading, swapUnavailable, buyNeedsTrustline, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectSell, onSelectBuy, onAddCustomToken, onReverse, onMax, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface ReceiveModalTemplateProps {
     theme: string;
@@ -831,15 +947,27 @@ interface ReceiveModalTemplateProps {
     styleOverrides?: ModalStyleOverrides;
     /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
-    /** Networks the user holds a wallet on; the first one is the default. */
-    chains: WalletChain[];
+    /**
+     * The networks the user holds an address on, in the app's configured order.
+     * The picker renders only with two or more, so a single-chain app shows none.
+     */
+    chains?: WalletChain[];
     selectedChain: WalletChain | null;
-    onSelectChain: (chain: WalletChain) => void;
+    onSelectChain?: (chain: WalletChain) => void;
     copied: boolean;
+    /**
+     * Why the wallet cannot receive yet (its Stellar account is still being
+     * created, or its creation failed), or null when it can.
+     *
+     * The address itself is valid either way - what is missing is the account
+     * behind it, so a payment sent now is rejected by the network. Optional, so a
+     * custom template written before this existed keeps compiling.
+     */
+    notReadyReason?: string | null;
     onCopy: () => void;
     onClose: () => void;
 }
-declare function ReceiveModalTemplate({ theme, accentColor, styleOverrides, walletAddress, chains, selectedChain, onSelectChain, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function ReceiveModalTemplate({ theme, accentColor, styleOverrides, walletAddress, chains, selectedChain, onSelectChain, copied, notReadyReason, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SessionsModalTemplateProps {
     theme: string;
@@ -849,12 +977,13 @@ interface SessionsModalTemplateProps {
     state: SessionsState;
     revokingFamilyId: string | null;
     signingOutEverywhere: boolean;
+    revokeError: string | null;
     onRefresh: () => void;
     onRevoke: (familyId: string) => void;
     onLogoutEverywhere: () => void;
     onClose: () => void;
 }
-declare function SessionsModalTemplate({ theme, accentColor, styleOverrides, state, revokingFamilyId, signingOutEverywhere, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SessionsModalTemplate({ theme, accentColor, styleOverrides, state, revokingFamilyId, signingOutEverywhere, revokeError, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface DistributionRulesModalTemplateProps {
     theme: string;
@@ -871,4 +1000,4 @@ interface DistributionRulesModalTemplateProps {
 }
 declare function DistributionRulesModalTemplate({ theme, accentColor, styleOverrides, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, DistributionRulesModal, DistributionRulesModalTemplate, EarnModal, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type ModalChrome, type ModalStyleOverrides, type ModalVariant, 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, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, browserPasskeyCeremony, browserPasskeySigner, buildModalCssVars, chainsOf, createPollarAdapterHook, modalChrome, readableTextOn, resolveChain, useChains, usePollar };
+export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, DistributionRulesModal, DistributionRulesModalTemplate, EarnModal, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type ModalChrome, type ModalStyleOverrides, type ModalVariant, type PollarConfig, PollarProvider, type PollarStyles, ProviderRegistrationModal, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, RegistryCheckModal, RequirementFormModal, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, browserPasskeyCeremony, browserPasskeySigner, buildModalCssVars, chainsOf, createPollarAdapterHook, modalChrome, readableTextOn, resolveChain, useChains, usePollar, walletNotReadyReason };