@pollar/react 0.11.4-rc.4 → 0.11.5

package/dist/index.d.mts

@@ -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, WalletChain, KycStatus as KycStatus$1, RampQuote, WalletId, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampQuoteRequirement, RampTxStatus, RampDepositInstructions, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, CosignState, PendingConfirmation, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, PasskeyCeremony, PasskeySigner, WalletChain, CosignRequest, CosignVerification, CosignQuorumReport, CosignDevicesContent, 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';
 
@@ -37,6 +37,14 @@ interface PollarContextValue {
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
+    /**
+     * Whether the signed-in user has a wallet. False for an app that creates
+     * wallets on demand until {@link createWallet} runs, and always for one that
+     * creates none.
+     */
+    hasWallet: boolean;
+    /** Create the signed-in user's wallet; see `PollarClient.createWallet`. */
+    createWallet: () => Promise<WalletInfo>;
     /**
      * `true` once the server has confirmed the session (login / refresh /
      * `/auth/session/resume`). `false` while a cold-start session is still
@@ -48,6 +56,12 @@ interface PollarContextValue {
     sessions: SessionsState;
     /** Open the active-sessions modal. */
     openSessionsModal: () => void;
+    /** Requests waiting for this device's vote. */
+    cosign: CosignState;
+    /** Open the approval prompt of a co-signed wallet. Opens by itself when a request arrives. */
+    openCosignModal: () => void;
+    /** Signing calls waiting for the user under `confirmation: 'prompt'`; the provider shows the first one. */
+    confirmations: PendingConfirmation[];
     appConfig: PollarConfig;
     styles: PollarStyles;
     /** Remote app-config load state. 'loading' while the initial fetch is in
@@ -305,6 +319,16 @@ interface WalletButtonTemplateProps {
      */
     notReadyReason?: string | null;
     creatingAccount: boolean;
+    /**
+     * Signed in with no wallet yet (an app that creates wallets on demand, or
+     * none). The button then shows the account menu instead of Login, with Create
+     * wallet only when `onCreateWallet` is set. Optional, so a custom template
+     * written before this existed keeps compiling.
+     */
+    signedIn?: boolean;
+    creatingWallet?: boolean;
+    createWalletError?: string | null;
+    onCreateWallet?: () => void;
     onToggleOpen: () => void;
     onCreateAccount: () => void;
     onCopy: () => void;
@@ -319,7 +343,7 @@ interface WalletButtonTemplateProps {
     onLogout: () => void;
     onLogin: () => void;
 }
-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;
+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, signedIn, creatingWallet, createWalletError, onCreateWallet, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
 
 /**
  * The chain a record lives on, with the legacy shape folded in: sessions and
@@ -379,6 +403,37 @@ interface UseChainsResult {
 }
 declare function useChains(): UseChainsResult;
 
+interface UseCosignResult {
+    /** Requests waiting for this device's vote, oldest first. */
+    pending: CosignRequest[];
+    /** The last request that reached a final state. */
+    lastResolved?: CosignRequest;
+    /** Whether the client's co-sign store has been read at least once. */
+    loaded: boolean;
+    /** Re-read the pending requests from the API. */
+    refresh: () => Promise<void>;
+    /** Verify the request against Turnkey and, when it checks out, vote yes. */
+    approve: (request: CosignRequest) => Promise<CosignRequest>;
+    /** Vote no. Final. */
+    reject: (request: CosignRequest) => Promise<CosignRequest>;
+    /** The verification a UI can show before the user decides. */
+    verify: (request: CosignRequest) => Promise<CosignVerification>;
+    /** Read the sub-organization from Turnkey with the device key and record whether it is the promised 2-of-2. */
+    inspectQuorum: () => Promise<CosignQuorumReport>;
+    /** The user's enrolled devices and the quorum state as sdk-api records it. */
+    devices: () => Promise<CosignDevicesContent>;
+    /** Revoke another enrolled device; `force` to revoke this one. */
+    revokeDevice: (deviceId: string, options?: {
+        force?: boolean;
+    }) => Promise<CosignDevicesContent>;
+}
+/**
+ * The user's side of a Turnkey co-signed wallet, for an app that renders its
+ * own confirmation UI instead of the provider's modal. Subscribes to the
+ * client's co-sign store and loads the pending requests once on mount.
+ */
+declare function useCosign(): UseCosignResult;
+
 interface KycModalProps {
     corridorId?: string;
     /** A card provider's steps, in place of a route's. */
@@ -509,6 +564,16 @@ interface SessionsModalProps {
 }
 declare function SessionsModal({ onClose }: SessionsModalProps): react_jsx_runtime.JSX.Element;
 
+interface CosignModalProps {
+    onClose: () => void;
+}
+/**
+ * The approval prompt of a Turnkey co-signed wallet. Verifies each request
+ * against Turnkey before enabling Approve, so the user only ever confirms a
+ * transaction the device checked itself.
+ */
+declare function CosignModal({ onClose }: CosignModalProps): react_jsx_runtime.JSX.Element;
+
 interface DistributionRulesModalProps {
     onClose: () => void;
 }
@@ -701,9 +766,23 @@ interface RampWidgetTemplateProps {
     onboardingStatus?: 'kyc' | 'endorsement' | 'awaiting_provider' | null;
     /** The gate has since cleared - the user needs a fresh quote to continue. */
     kycJustApproved: boolean;
+    /** Superseded by `txHash`, which carries the settlement on any chain; read when `txHash` is absent. */
     stellarTxHash: string | null;
-    /** Stellar Expert URL for `stellarTxHash` (network-aware); null when unknown. */
+    /** The on-chain transaction that settled the ramp, on `txChain`. */
+    txHash?: string | null;
+    /** Chain of `txHash`; Stellar when omitted. */
+    txChain?: 'STELLAR' | 'POLYGON' | 'SOLANA' | null;
+    /** Explorer URL for the transaction (chain- and network-aware); null when unknown. */
     explorerUrl: string | null;
+    /**
+     * The user's money is in one of their wallets between two steps of the route.
+     * Optional for integrators rendering their own chrome; omitted, the state is
+     * not shown.
+     */
+    fundsInTransit?: boolean;
+    /** A retry of the pending step is in flight. */
+    retrying?: boolean;
+    onRetryTransit?: () => void;
     depositInstructions: RampDepositInstructions | null;
     canComplete: boolean;
     completing: boolean;
@@ -728,7 +807,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, 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;
+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, txHash, txChain, explorerUrl, fundsInTransit, retrying, onRetryTransit, 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;
@@ -843,6 +922,8 @@ interface CustomTrustlineModalTemplateProps {
     }) => void;
 }
 
+/** The memo types the backend accepts on a Stellar payment. */
+type SendMemoType = 'text' | 'id';
 interface SendModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -893,6 +974,15 @@ interface SendModalTemplateProps {
     onMax: () => void;
     onPaste: () => void;
     onDestinationChange: (value: string) => void;
+    /**
+     * Optional Stellar memo. The field renders only on Stellar and only when
+     * {@link onMemoChange} is passed, so a custom template written before it
+     * existed keeps compiling.
+     */
+    memo?: string;
+    memoType?: SendMemoType;
+    onMemoChange?: (value: string) => void;
+    onMemoTypeChange?: (type: SendMemoType) => void;
     onSubmit: () => void;
     onSignAndSend: () => void;
     onToggleXdr: () => void;
@@ -900,7 +990,7 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-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;
+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, memo, memoType, onMemoChange, onMemoTypeChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SwapAssetOption {
     ref: SwapQuoteParams['sellAsset'];
@@ -1001,6 +1091,32 @@ interface SessionsModalTemplateProps {
 }
 declare function SessionsModalTemplate({ theme, accentColor, styleOverrides, state, revokingFamilyId, signingOutEverywhere, revokeError, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
 
+interface CosignModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
+    /** Requests waiting for this device's vote, oldest first. */
+    pending: CosignRequest[];
+    /** The request shown in detail; the first pending one when not chosen. */
+    current: CosignRequest | null;
+    /** Verification of `current`, or null while it runs. */
+    verification: CosignVerification | null;
+    busy: 'approving' | 'rejecting' | null;
+    error: string | null;
+    /** Approve stays off for a request whose approval just failed. */
+    approveBlocked?: boolean;
+    /** The last request that reached a final state, shown once the list is empty. */
+    lastResolved?: CosignRequest;
+    /** Explorer page of {@link lastResolved}'s transaction, when it was sent. */
+    explorerUrl?: string | null;
+    onSelect: (request: CosignRequest) => void;
+    onApprove: (request: CosignRequest) => void;
+    onReject: (request: CosignRequest) => void;
+    onClose: () => void;
+}
+declare function CosignModalTemplate({ theme, accentColor, styleOverrides, pending, current, verification, busy, error, approveBlocked, lastResolved, explorerUrl, onSelect, onApprove, onReject, onClose, }: CosignModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface DistributionRulesModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -1016,4 +1132,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, CardModal, 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 };
+export { type AuthModalProps, CardModal, ChainSelect, type ChainSelectProps, CosignModal, CosignModalTemplate, type CosignModalTemplateProps, 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, type SendMemoType, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, type UseChainsResult, type UseCosignResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, browserPasskeyCeremony, browserPasskeySigner, buildModalCssVars, chainsOf, createPollarAdapterHook, modalChrome, readableTextOn, resolveChain, useChains, useCosign, usePollar, walletNotReadyReason };

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, WalletChain, KycStatus as KycStatus$1, RampQuote, WalletId, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampQuoteRequirement, RampTxStatus, RampDepositInstructions, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, CosignState, PendingConfirmation, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, PasskeyCeremony, PasskeySigner, WalletChain, CosignRequest, CosignVerification, CosignQuorumReport, CosignDevicesContent, 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';
 
@@ -37,6 +37,14 @@ interface PollarContextValue {
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
+    /**
+     * Whether the signed-in user has a wallet. False for an app that creates
+     * wallets on demand until {@link createWallet} runs, and always for one that
+     * creates none.
+     */
+    hasWallet: boolean;
+    /** Create the signed-in user's wallet; see `PollarClient.createWallet`. */
+    createWallet: () => Promise<WalletInfo>;
     /**
      * `true` once the server has confirmed the session (login / refresh /
      * `/auth/session/resume`). `false` while a cold-start session is still
@@ -48,6 +56,12 @@ interface PollarContextValue {
     sessions: SessionsState;
     /** Open the active-sessions modal. */
     openSessionsModal: () => void;
+    /** Requests waiting for this device's vote. */
+    cosign: CosignState;
+    /** Open the approval prompt of a co-signed wallet. Opens by itself when a request arrives. */
+    openCosignModal: () => void;
+    /** Signing calls waiting for the user under `confirmation: 'prompt'`; the provider shows the first one. */
+    confirmations: PendingConfirmation[];
     appConfig: PollarConfig;
     styles: PollarStyles;
     /** Remote app-config load state. 'loading' while the initial fetch is in
@@ -305,6 +319,16 @@ interface WalletButtonTemplateProps {
      */
     notReadyReason?: string | null;
     creatingAccount: boolean;
+    /**
+     * Signed in with no wallet yet (an app that creates wallets on demand, or
+     * none). The button then shows the account menu instead of Login, with Create
+     * wallet only when `onCreateWallet` is set. Optional, so a custom template
+     * written before this existed keeps compiling.
+     */
+    signedIn?: boolean;
+    creatingWallet?: boolean;
+    createWalletError?: string | null;
+    onCreateWallet?: () => void;
     onToggleOpen: () => void;
     onCreateAccount: () => void;
     onCopy: () => void;
@@ -319,7 +343,7 @@ interface WalletButtonTemplateProps {
     onLogout: () => void;
     onLogin: () => void;
 }
-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;
+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, signedIn, creatingWallet, createWalletError, onCreateWallet, }: WalletButtonTemplateProps): react_jsx_runtime.JSX.Element;
 
 /**
  * The chain a record lives on, with the legacy shape folded in: sessions and
@@ -379,6 +403,37 @@ interface UseChainsResult {
 }
 declare function useChains(): UseChainsResult;
 
+interface UseCosignResult {
+    /** Requests waiting for this device's vote, oldest first. */
+    pending: CosignRequest[];
+    /** The last request that reached a final state. */
+    lastResolved?: CosignRequest;
+    /** Whether the client's co-sign store has been read at least once. */
+    loaded: boolean;
+    /** Re-read the pending requests from the API. */
+    refresh: () => Promise<void>;
+    /** Verify the request against Turnkey and, when it checks out, vote yes. */
+    approve: (request: CosignRequest) => Promise<CosignRequest>;
+    /** Vote no. Final. */
+    reject: (request: CosignRequest) => Promise<CosignRequest>;
+    /** The verification a UI can show before the user decides. */
+    verify: (request: CosignRequest) => Promise<CosignVerification>;
+    /** Read the sub-organization from Turnkey with the device key and record whether it is the promised 2-of-2. */
+    inspectQuorum: () => Promise<CosignQuorumReport>;
+    /** The user's enrolled devices and the quorum state as sdk-api records it. */
+    devices: () => Promise<CosignDevicesContent>;
+    /** Revoke another enrolled device; `force` to revoke this one. */
+    revokeDevice: (deviceId: string, options?: {
+        force?: boolean;
+    }) => Promise<CosignDevicesContent>;
+}
+/**
+ * The user's side of a Turnkey co-signed wallet, for an app that renders its
+ * own confirmation UI instead of the provider's modal. Subscribes to the
+ * client's co-sign store and loads the pending requests once on mount.
+ */
+declare function useCosign(): UseCosignResult;
+
 interface KycModalProps {
     corridorId?: string;
     /** A card provider's steps, in place of a route's. */
@@ -509,6 +564,16 @@ interface SessionsModalProps {
 }
 declare function SessionsModal({ onClose }: SessionsModalProps): react_jsx_runtime.JSX.Element;
 
+interface CosignModalProps {
+    onClose: () => void;
+}
+/**
+ * The approval prompt of a Turnkey co-signed wallet. Verifies each request
+ * against Turnkey before enabling Approve, so the user only ever confirms a
+ * transaction the device checked itself.
+ */
+declare function CosignModal({ onClose }: CosignModalProps): react_jsx_runtime.JSX.Element;
+
 interface DistributionRulesModalProps {
     onClose: () => void;
 }
@@ -701,9 +766,23 @@ interface RampWidgetTemplateProps {
     onboardingStatus?: 'kyc' | 'endorsement' | 'awaiting_provider' | null;
     /** The gate has since cleared - the user needs a fresh quote to continue. */
     kycJustApproved: boolean;
+    /** Superseded by `txHash`, which carries the settlement on any chain; read when `txHash` is absent. */
     stellarTxHash: string | null;
-    /** Stellar Expert URL for `stellarTxHash` (network-aware); null when unknown. */
+    /** The on-chain transaction that settled the ramp, on `txChain`. */
+    txHash?: string | null;
+    /** Chain of `txHash`; Stellar when omitted. */
+    txChain?: 'STELLAR' | 'POLYGON' | 'SOLANA' | null;
+    /** Explorer URL for the transaction (chain- and network-aware); null when unknown. */
     explorerUrl: string | null;
+    /**
+     * The user's money is in one of their wallets between two steps of the route.
+     * Optional for integrators rendering their own chrome; omitted, the state is
+     * not shown.
+     */
+    fundsInTransit?: boolean;
+    /** A retry of the pending step is in flight. */
+    retrying?: boolean;
+    onRetryTransit?: () => void;
     depositInstructions: RampDepositInstructions | null;
     canComplete: boolean;
     completing: boolean;
@@ -728,7 +807,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, 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;
+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, txHash, txChain, explorerUrl, fundsInTransit, retrying, onRetryTransit, 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;
@@ -843,6 +922,8 @@ interface CustomTrustlineModalTemplateProps {
     }) => void;
 }
 
+/** The memo types the backend accepts on a Stellar payment. */
+type SendMemoType = 'text' | 'id';
 interface SendModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -893,6 +974,15 @@ interface SendModalTemplateProps {
     onMax: () => void;
     onPaste: () => void;
     onDestinationChange: (value: string) => void;
+    /**
+     * Optional Stellar memo. The field renders only on Stellar and only when
+     * {@link onMemoChange} is passed, so a custom template written before it
+     * existed keeps compiling.
+     */
+    memo?: string;
+    memoType?: SendMemoType;
+    onMemoChange?: (value: string) => void;
+    onMemoTypeChange?: (type: SendMemoType) => void;
     onSubmit: () => void;
     onSignAndSend: () => void;
     onToggleXdr: () => void;
@@ -900,7 +990,7 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-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;
+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, memo, memoType, onMemoChange, onMemoTypeChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SwapAssetOption {
     ref: SwapQuoteParams['sellAsset'];
@@ -1001,6 +1091,32 @@ interface SessionsModalTemplateProps {
 }
 declare function SessionsModalTemplate({ theme, accentColor, styleOverrides, state, revokingFamilyId, signingOutEverywhere, revokeError, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
 
+interface CosignModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
+    /** Requests waiting for this device's vote, oldest first. */
+    pending: CosignRequest[];
+    /** The request shown in detail; the first pending one when not chosen. */
+    current: CosignRequest | null;
+    /** Verification of `current`, or null while it runs. */
+    verification: CosignVerification | null;
+    busy: 'approving' | 'rejecting' | null;
+    error: string | null;
+    /** Approve stays off for a request whose approval just failed. */
+    approveBlocked?: boolean;
+    /** The last request that reached a final state, shown once the list is empty. */
+    lastResolved?: CosignRequest;
+    /** Explorer page of {@link lastResolved}'s transaction, when it was sent. */
+    explorerUrl?: string | null;
+    onSelect: (request: CosignRequest) => void;
+    onApprove: (request: CosignRequest) => void;
+    onReject: (request: CosignRequest) => void;
+    onClose: () => void;
+}
+declare function CosignModalTemplate({ theme, accentColor, styleOverrides, pending, current, verification, busy, error, approveBlocked, lastResolved, explorerUrl, onSelect, onApprove, onReject, onClose, }: CosignModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface DistributionRulesModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -1016,4 +1132,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, CardModal, 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 };
+export { type AuthModalProps, CardModal, ChainSelect, type ChainSelectProps, CosignModal, CosignModalTemplate, type CosignModalTemplateProps, 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, type SendMemoType, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, type UseChainsResult, type UseCosignResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, browserPasskeyCeremony, browserPasskeySigner, buildModalCssVars, chainsOf, createPollarAdapterHook, modalChrome, readableTextOn, resolveChain, useChains, useCosign, usePollar, walletNotReadyReason };