@pollar/react 0.11.1-rc.3 → 0.11.1

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, 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';
+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, WalletId, WalletChain, 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';
 
@@ -27,6 +27,13 @@ interface PollarContextValue {
      * 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},
+     * 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.
+     */
+    wallets: WalletInfo[];
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
@@ -63,6 +70,12 @@ interface PollarContextValue {
     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.
+     */
+    sendPayment: (params: SendPaymentParams) => Promise<SubmitOutcome>;
     network: StellarNetwork;
     setNetwork: (network: StellarNetwork) => void;
     walletBalance: WalletBalanceState;
@@ -76,16 +89,17 @@ interface PollarContextValue {
     refreshAssets: () => Promise<void>;
     /**
      * Establishes (omit `limit`) or removes (`limit: '0'`) a trustline for an
-     * asset. Pass the asset's `sponsored` flag so the app covers the reserve + fee
-     * when eligible; otherwise the user's own wallet pays. Mirrors
-     * {@link PollarClient.setTrustline}.
+     * asset. Sponsorship is derived automatically from the app's dashboard config
+     * (the app covers the reserve + fee when eligible); pass `skipSponsorship` to
+     * force the user's own wallet to pay. Mirrors {@link PollarClient.setTrustline}.
      */
     setTrustline: (asset: {
         code: string;
         issuer: string;
     }, opts?: {
         limit?: string;
-        sponsored?: boolean;
+        /** Force self-pay even when the app would sponsor the trustline. */
+        skipSponsorship?: boolean;
     }) => Promise<TrustlineOutcome>;
     /** Open the enabled-assets / trustline-state modal. */
     openEnabledAssetsModal: () => void;
@@ -165,10 +179,29 @@ interface PollarProviderProps {
      */
     client: PollarClient | PollarClientConfig;
     /**
-     * Local override of the `/applications/config` response. If provided (even
-     * `{}`), the remote fetch is skipped and missing fields fall back to the
-     * defaults in `LoginModalTemplate`. If `undefined`, the SDK fetches
-     * `/applications/config` on mount.
+     * Local REPLACEMENT for the `/applications/config` response, not a patch over
+     * it. Passing anything at all skips the remote fetch entirely; what you pass
+     * is used verbatim and is never merged with the server's answer, so there is
+     * no "fill in the fields I left out".
+     *
+     * `styles` may be partial (every field in it is optional), but `application`
+     * may not: `name`, `network` and `chains` are all required by the type. If you
+     * 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
+     *                         session listed the user's wallets in (see useChains)
+     *   name         absent → 'Pollar'
+     *   theme        absent → 'light'
+     *   accentColor  absent → '#005DB4'
+     *   emailEnabled, providers, embeddedWallets, smartWallet
+     *                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
+     * mount, which is also what keeps branding, login methods and chains current:
+     * that fetch re-runs on every mount, so dashboard changes land on the next
+     * page load. Supplying this prop opts out of that too.
      */
     appConfig?: PollarConfig;
     adapters?: PollarAdapters;
@@ -224,6 +257,64 @@ interface WalletButtonTemplateProps {
 }
 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;
 
+/**
+ * The chain a record lives on, with the legacy shape folded in: sessions and
+ * balance rows minted before multi-chain carry no `chain` and are Stellar by
+ * definition, so absent counts as STELLAR rather than as "unknown".
+ */
+declare function resolveChain(chain: WalletChain | undefined): WalletChain;
+/**
+ * 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
+ * network choice.
+ *
+ * `order` is the app's chain list from `/applications/config`, as arranged in the
+ * dashboard. When passed it both ORDERS and FILTERS: a chain missing from it is
+ * dropped, because the app switched it off and must stop appearing everywhere.
+ *
+ * Filtering here and not only in the backend is deliberate. `wallets` comes from
+ * the session, which is written at login and then persisted for as long as the
+ * session lives; `/config` is refetched on every page load. So a chain disabled
+ * today disappears on the next reload even for a user who logged in last week
+ * and still carries it in their stored session.
+ *
+ * Without `order` (config still loading) the fallback is the order the backend
+ * listed the wallets in.
+ */
+declare function chainsOf(wallets: WalletInfo[], order?: readonly WalletChain[]): WalletChain[];
+/** The address to show for `chain`, or '' when the user has no wallet there. */
+declare function addressForChain(wallets: WalletInfo[], chain: WalletChain | null): string;
+interface ChainSelectProps {
+    label?: string;
+    value: WalletChain | null;
+    options: WalletChain[];
+    onChange: (chain: WalletChain) => void;
+    disabled?: boolean;
+}
+declare function ChainSelect({ label, value, options, onChange, disabled }: ChainSelectProps): react_jsx_runtime.JSX.Element | null;
+
+interface UseChainsResult {
+    /**
+     * Chains to offer, in the app's configured order: those the app serves AND the
+     * user already holds a wallet on. `[]` until `/config` resolves, so a network
+     * picker driven by this renders nothing rather than a list it may have to
+     * reorder a moment later.
+     */
+    chains: WalletChain[];
+    /** The app's first configured chain that the user holds. `null` until ready. */
+    primaryChain: WalletChain | null;
+    /**
+     * The address on {@link primaryChain}. While `/config` is still in flight this
+     * falls back to the first wallet the session lists, so a logged-in user never
+     * sees the wallet button blank out into a "Connect" state on every reload.
+     */
+    primaryAddress: string;
+    /** `false` while `/config` is in flight or failed. Gate any chain UI on it. */
+    ready: boolean;
+}
+declare function useChains(): UseChainsResult;
+
 interface KycModalProps {
     onClose: () => void;
     /** ISO 3166-1 alpha-2 country code to filter providers. Defaults to 'MX'. */
@@ -455,17 +546,29 @@ interface WalletBalanceModalTemplateProps {
     theme: string;
     accentColor: string;
     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[];
+    selectedChain: WalletChain | null;
+    /** testnet vs mainnet — gates the Solana devnet faucet hint. */
+    network: StellarNetwork;
+    onSelectChain: (chain: WalletChain) => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface EnabledAssetsModalTemplateProps {
     theme: string;
     accentColor: string;
     enabledAssets: EnabledAssetsState;
+    /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
+    /** Networks the user holds a wallet on; the first one is the default. */
+    chains: WalletChain[];
+    selectedChain: WalletChain | null;
+    onSelectChain: (chain: WalletChain) => void;
     /** Key (`code+issuer`) of the asset whose trustline action is in flight. */
     busyKey: string | null;
     actionError: string | null;
@@ -474,7 +577,20 @@ interface EnabledAssetsModalTemplateProps {
     onToggleTrustline: (record: EnabledAssetRecord) => void;
     onAddCustom: () => void;
 }
-declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, chains, selectedChain, onSelectChain, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+interface CustomTrustlineModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    busy: boolean;
+    actionError: string | null;
+    onBack: () => void;
+    onClose: () => void;
+    onSubmit: (input: {
+        code: string;
+        issuer: string;
+        limit?: string;
+    }) => void;
+}
 
 interface SendModalTemplateProps {
     theme: string;
@@ -483,6 +599,14 @@ 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;
+    /** Can a payment be built on {@link selectedChain}? Stellar and Solana only. */
+    canSendOnChain: boolean;
+    onSelectChain: (chain: WalletChain) => void;
     amount: string;
     destination: string;
     formError: string;
@@ -507,7 +631,7 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-declare function SendModalTemplate({ theme, accentColor, step, txTitle, assets, selectedAsset, 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, 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;
 
 /** A selectable asset in the sell/buy pickers, normalized across balance/enabled records. */
 interface SwapAssetOption {
@@ -568,12 +692,17 @@ declare function SwapModalTemplate({ theme, accentColor, step, txTitle, sellOpti
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
+    /** Networks the user holds a wallet on; the first one is the default. */
+    chains: WalletChain[];
+    selectedChain: WalletChain | null;
+    onSelectChain: (chain: WalletChain) => void;
     copied: boolean;
     onCopy: () => void;
     onClose: () => void;
 }
-declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, chains, selectedChain, onSelectChain, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SessionsModalTemplateProps {
     theme: string;
@@ -601,4 +730,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, 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 };
+export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, 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, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, chainsOf, createPollarAdapterHook, resolveChain, useChains, usePollar };

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, 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';
+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, WalletId, WalletChain, 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';
 
@@ -27,6 +27,13 @@ interface PollarContextValue {
      * 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},
+     * 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.
+     */
+    wallets: WalletInfo[];
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
@@ -63,6 +70,12 @@ interface PollarContextValue {
     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.
+     */
+    sendPayment: (params: SendPaymentParams) => Promise<SubmitOutcome>;
     network: StellarNetwork;
     setNetwork: (network: StellarNetwork) => void;
     walletBalance: WalletBalanceState;
@@ -76,16 +89,17 @@ interface PollarContextValue {
     refreshAssets: () => Promise<void>;
     /**
      * Establishes (omit `limit`) or removes (`limit: '0'`) a trustline for an
-     * asset. Pass the asset's `sponsored` flag so the app covers the reserve + fee
-     * when eligible; otherwise the user's own wallet pays. Mirrors
-     * {@link PollarClient.setTrustline}.
+     * asset. Sponsorship is derived automatically from the app's dashboard config
+     * (the app covers the reserve + fee when eligible); pass `skipSponsorship` to
+     * force the user's own wallet to pay. Mirrors {@link PollarClient.setTrustline}.
      */
     setTrustline: (asset: {
         code: string;
         issuer: string;
     }, opts?: {
         limit?: string;
-        sponsored?: boolean;
+        /** Force self-pay even when the app would sponsor the trustline. */
+        skipSponsorship?: boolean;
     }) => Promise<TrustlineOutcome>;
     /** Open the enabled-assets / trustline-state modal. */
     openEnabledAssetsModal: () => void;
@@ -165,10 +179,29 @@ interface PollarProviderProps {
      */
     client: PollarClient | PollarClientConfig;
     /**
-     * Local override of the `/applications/config` response. If provided (even
-     * `{}`), the remote fetch is skipped and missing fields fall back to the
-     * defaults in `LoginModalTemplate`. If `undefined`, the SDK fetches
-     * `/applications/config` on mount.
+     * Local REPLACEMENT for the `/applications/config` response, not a patch over
+     * it. Passing anything at all skips the remote fetch entirely; what you pass
+     * is used verbatim and is never merged with the server's answer, so there is
+     * no "fill in the fields I left out".
+     *
+     * `styles` may be partial (every field in it is optional), but `application`
+     * may not: `name`, `network` and `chains` are all required by the type. If you
+     * 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
+     *                         session listed the user's wallets in (see useChains)
+     *   name         absent → 'Pollar'
+     *   theme        absent → 'light'
+     *   accentColor  absent → '#005DB4'
+     *   emailEnabled, providers, embeddedWallets, smartWallet
+     *                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
+     * mount, which is also what keeps branding, login methods and chains current:
+     * that fetch re-runs on every mount, so dashboard changes land on the next
+     * page load. Supplying this prop opts out of that too.
      */
     appConfig?: PollarConfig;
     adapters?: PollarAdapters;
@@ -224,6 +257,64 @@ interface WalletButtonTemplateProps {
 }
 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;
 
+/**
+ * The chain a record lives on, with the legacy shape folded in: sessions and
+ * balance rows minted before multi-chain carry no `chain` and are Stellar by
+ * definition, so absent counts as STELLAR rather than as "unknown".
+ */
+declare function resolveChain(chain: WalletChain | undefined): WalletChain;
+/**
+ * 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
+ * network choice.
+ *
+ * `order` is the app's chain list from `/applications/config`, as arranged in the
+ * dashboard. When passed it both ORDERS and FILTERS: a chain missing from it is
+ * dropped, because the app switched it off and must stop appearing everywhere.
+ *
+ * Filtering here and not only in the backend is deliberate. `wallets` comes from
+ * the session, which is written at login and then persisted for as long as the
+ * session lives; `/config` is refetched on every page load. So a chain disabled
+ * today disappears on the next reload even for a user who logged in last week
+ * and still carries it in their stored session.
+ *
+ * Without `order` (config still loading) the fallback is the order the backend
+ * listed the wallets in.
+ */
+declare function chainsOf(wallets: WalletInfo[], order?: readonly WalletChain[]): WalletChain[];
+/** The address to show for `chain`, or '' when the user has no wallet there. */
+declare function addressForChain(wallets: WalletInfo[], chain: WalletChain | null): string;
+interface ChainSelectProps {
+    label?: string;
+    value: WalletChain | null;
+    options: WalletChain[];
+    onChange: (chain: WalletChain) => void;
+    disabled?: boolean;
+}
+declare function ChainSelect({ label, value, options, onChange, disabled }: ChainSelectProps): react_jsx_runtime.JSX.Element | null;
+
+interface UseChainsResult {
+    /**
+     * Chains to offer, in the app's configured order: those the app serves AND the
+     * user already holds a wallet on. `[]` until `/config` resolves, so a network
+     * picker driven by this renders nothing rather than a list it may have to
+     * reorder a moment later.
+     */
+    chains: WalletChain[];
+    /** The app's first configured chain that the user holds. `null` until ready. */
+    primaryChain: WalletChain | null;
+    /**
+     * The address on {@link primaryChain}. While `/config` is still in flight this
+     * falls back to the first wallet the session lists, so a logged-in user never
+     * sees the wallet button blank out into a "Connect" state on every reload.
+     */
+    primaryAddress: string;
+    /** `false` while `/config` is in flight or failed. Gate any chain UI on it. */
+    ready: boolean;
+}
+declare function useChains(): UseChainsResult;
+
 interface KycModalProps {
     onClose: () => void;
     /** ISO 3166-1 alpha-2 country code to filter providers. Defaults to 'MX'. */
@@ -455,17 +546,29 @@ interface WalletBalanceModalTemplateProps {
     theme: string;
     accentColor: string;
     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[];
+    selectedChain: WalletChain | null;
+    /** testnet vs mainnet — gates the Solana devnet faucet hint. */
+    network: StellarNetwork;
+    onSelectChain: (chain: WalletChain) => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface EnabledAssetsModalTemplateProps {
     theme: string;
     accentColor: string;
     enabledAssets: EnabledAssetsState;
+    /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
+    /** Networks the user holds a wallet on; the first one is the default. */
+    chains: WalletChain[];
+    selectedChain: WalletChain | null;
+    onSelectChain: (chain: WalletChain) => void;
     /** Key (`code+issuer`) of the asset whose trustline action is in flight. */
     busyKey: string | null;
     actionError: string | null;
@@ -474,7 +577,20 @@ interface EnabledAssetsModalTemplateProps {
     onToggleTrustline: (record: EnabledAssetRecord) => void;
     onAddCustom: () => void;
 }
-declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, chains, selectedChain, onSelectChain, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+interface CustomTrustlineModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    busy: boolean;
+    actionError: string | null;
+    onBack: () => void;
+    onClose: () => void;
+    onSubmit: (input: {
+        code: string;
+        issuer: string;
+        limit?: string;
+    }) => void;
+}
 
 interface SendModalTemplateProps {
     theme: string;
@@ -483,6 +599,14 @@ 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;
+    /** Can a payment be built on {@link selectedChain}? Stellar and Solana only. */
+    canSendOnChain: boolean;
+    onSelectChain: (chain: WalletChain) => void;
     amount: string;
     destination: string;
     formError: string;
@@ -507,7 +631,7 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-declare function SendModalTemplate({ theme, accentColor, step, txTitle, assets, selectedAsset, 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, 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;
 
 /** A selectable asset in the sell/buy pickers, normalized across balance/enabled records. */
 interface SwapAssetOption {
@@ -568,12 +692,17 @@ declare function SwapModalTemplate({ theme, accentColor, step, txTitle, sellOpti
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
+    /** Networks the user holds a wallet on; the first one is the default. */
+    chains: WalletChain[];
+    selectedChain: WalletChain | null;
+    onSelectChain: (chain: WalletChain) => void;
     copied: boolean;
     onCopy: () => void;
     onClose: () => void;
 }
-declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, chains, selectedChain, onSelectChain, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SessionsModalTemplateProps {
     theme: string;
@@ -601,4 +730,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, 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 };
+export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, 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, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, chainsOf, createPollarAdapterHook, resolveChain, useChains, usePollar };