@swype-org/react-sdk 0.2.316 → 0.2.357

package/dist/index.d.ts

@@ -77,6 +77,21 @@ interface Account {
     nickname?: string | null;
     /** Optional display logo URL, e.g. the selected Reown wallet icon. */
     logoURI?: string;
+    /**
+     * WalletConnect identity recovered server-side from the account's session
+     * configs. Present only for WalletConnect-typed accounts — used to
+     * pre-check chain support before any reauthorization session exists (e.g.
+     * "Not supported" rows on the deposit-source sheet). `approvedChainIds` is
+     * the EIP-155 set the wallet approved at its most recent pairing — ground
+     * truth that overrides a stale Reown registry entry (registry listings lag
+     * the chains wallets actually support, e.g. newly launched mainnets).
+     */
+    walletConnect?: {
+        name: string;
+        reownWalletId?: string;
+        imageUrl?: string;
+        approvedChainIds?: number[];
+    };
     wallets: Wallet[];
     /** Remaining One-Tap allowance in USD, or null when not configured. */
     remainingAllowance?: number | null;
@@ -589,6 +604,12 @@ declare function fetchTransfer(apiBaseUrl: string, token: string, transferId: st
  * PATCH /v1/transfers/{transferId}
  */
 declare function signTransfer(apiBaseUrl: string, token: string, transferId: string, signedTransfer: Record<string, unknown>, authorizationSessionToken?: string): Promise<Transfer>;
+/**
+ * Regenerate a fresh sign payload for an SVM transfer whose signing window
+ * expired, reusing the same transfer id.
+ * POST /v1/transfers/{transferId}/sign-payload
+ */
+declare function regenerateTransferSignPayload(apiBaseUrl: string, token: string, transferId: string, authorizationSessionToken?: string): Promise<Transfer>;
 declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string): Promise<AuthorizationSessionDetail>;
 declare function fetchAuthorizationSessionByToken(apiBaseUrl: string, token: string): Promise<AuthorizationSessionDetail>;
 /**
@@ -749,6 +770,7 @@ declare const api_fetchUserConfig: typeof fetchUserConfig;
 declare const api_postTransferQuote: typeof postTransferQuote;
 declare const api_probeActionCompletion: typeof probeActionCompletion;
 declare const api_refreshManualTransferQuote: typeof refreshManualTransferQuote;
+declare const api_regenerateTransferSignPayload: typeof regenerateTransferSignPayload;
 declare const api_registerPasskey: typeof registerPasskey;
 declare const api_reportActionCompletion: typeof reportActionCompletion;
 declare const api_reportPasskeyActivity: typeof reportPasskeyActivity;
@@ -760,7 +782,7 @@ declare const api_updateUserConfig: typeof updateUserConfig;
 declare const api_updateUserConfigBySession: typeof updateUserConfigBySession;
 declare const api_waitForActionTransactionReceipt: typeof waitForActionTransactionReceipt;
 declare namespace api {
-  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_RefreshManualTransferQuoteResult as RefreshManualTransferQuoteResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_refreshManualTransferQuote as refreshManualTransferQuote, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionPaymentIntentAmount as setAuthorizationSessionPaymentIntentAmount, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_signTransfer as signTransfer, api_updateManualTransferDepositTargetChain as updateManualTransferDepositTargetChain, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
+  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_RefreshManualTransferQuoteResult as RefreshManualTransferQuoteResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_refreshManualTransferQuote as refreshManualTransferQuote, api_regenerateTransferSignPayload as regenerateTransferSignPayload, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionPaymentIntentAmount as setAuthorizationSessionPaymentIntentAmount, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_signTransfer as signTransfer, api_updateManualTransferDepositTargetChain as updateManualTransferDepositTargetChain, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
 }
 
 interface BlinkPaymentProps {
@@ -986,6 +1008,29 @@ interface ExecuteActionOptions {
     sessionId?: string;
     /** WalletConnect account/runtime key that owns this action. */
     walletConnectRuntimeKey?: string;
+    /**
+     * Chain id the WalletConnect OPEN_PROVIDER pairing must include (e.g. the
+     * reauth target token's chain). Overrides `action.metadata.requiredChainId`.
+     * A session reuse that doesn't approve this chain re-pairs with it required,
+     * and a pairing that comes back without it fails with a clear error instead
+     * of letting SELECT_SOURCE hit the backend's approved-chain validation.
+     */
+    walletConnectRequiredChainId?: number;
+    /**
+     * Human-readable name for `walletConnectRequiredChainId` (e.g. "HyperEVM"),
+     * used in the missing-required-chain error so users see the network name
+     * rather than a bare numeric chain id.
+     */
+    walletConnectRequiredChainLabel?: string;
+    /**
+     * EVM chain ids (from the backend's `/v1/chains`) proposed as optional
+     * namespaces in the WalletConnect pairing, on top of the runtime's
+     * hardcoded fallback. Keeps the proposal in sync with admin-managed source
+     * chains so a supporting wallet can approve them — chains missing from the
+     * proposal can never land in `approvedChainIds` and would be falsely
+     * reported as unsupported. The runtime remembers the list for re-pairs.
+     */
+    walletConnectOptionalChainIds?: number[];
     /**
      * Forwarded to APPROVE_SPL: invoked once after the Phantom signature is
      * returned and before client-side on-chain confirmation begins. The
@@ -995,6 +1040,16 @@ interface ExecuteActionOptions {
     onApproveSplConfirming?: (action: AuthorizationAction) => void;
     /** Emits the WalletConnect pairing URI so UI can render a QR/deeplink while connect is pending. */
     onWalletConnectDisplayUri?: (uri: string) => void;
+    /**
+     * Mobile only: foreground the ALREADY-CONNECTED WalletConnect wallet so the
+     * pending signing prompt surfaces, WITHOUT re-pairing. Fired immediately
+     * before each WC signing RPC (APPROVE_PERMIT2 / SIGN_PERMIT2 / EXECUTE_BRIDGE).
+     * The executor has no wallet-deeplink metadata, so the caller supplies this
+     * side-effect (e.g. `triggerDeeplink('rainbow://')`). No-op on desktop, where
+     * the caller passes `undefined` (signing happens in the same paired wallet /
+     * extension and a QR is shown for cross-device).
+     */
+    onWalletConnectForegroundWallet?: () => void;
     /**
      * Optional Promise resolved by an external (non-WC) connection that races the
      * WalletConnect pairing for `OPEN_PROVIDER`. Currently used by
@@ -1048,6 +1103,7 @@ interface UseAuthorizationExecutorResult {
         paymasterUrl?: string;
         walletConnectRuntimeKey?: string;
         onWalletConnectDisplayUri?: (uri: string) => void;
+        onWalletConnectForegroundWallet?: () => void;
     }) => Promise<BatchedWalletCallsResult>;
     /** Refresh wallet capabilities and return whether atomicBatch is supported. */
     canBatch: () => Promise<boolean>;
@@ -1171,6 +1227,51 @@ interface OrchestratorRunOptions {
     onApproveSplConfirming?: (action: AuthorizationAction) => void;
     /** Emits the direct WalletConnect pairing URI while OPEN_PROVIDER is connecting. */
     onWalletConnectDisplayUri?: (uri: string) => void;
+    /**
+     * Mobile only: foreground the ALREADY-CONNECTED WalletConnect wallet before
+     * each signing prompt (APPROVE_PERMIT2 / SIGN_PERMIT2 / EXECUTE_BRIDGE) via a
+     * bare deeplink — over the live session, NOT a re-pair. Supplied by
+     * `handleSelectWalletConnectWallet` / the reauth handlers, which hold the
+     * wallet's deeplink metadata. Omitted on desktop (QR + same-wallet signing).
+     */
+    onWalletConnectForegroundWallet?: () => void;
+    /**
+     * Pins ONE WalletConnect runtime key for the entire run, overriding the
+     * per-action resolution (`action.metadata.walletConnectAccountId` / tracked
+     * `session.accountId`). Supplied by the handler that performed the pairing
+     * (it knows the client `accountId` it paired under). Guarantees pairing
+     * (OPEN_PROVIDER) and signing (APPROVE_PERMIT2 / SIGN_PERMIT2 / EXECUTE_BRIDGE)
+     * use the SAME module-level runtime Map entry — closing the gap where
+     * `session.accountId` is null at OPEN_PROVIDER but non-null by APPROVE_PERMIT2,
+     * which otherwise makes signing look up a fresh, unpaired runtime and re-pair
+     * (a second QR / connection approval).
+     */
+    walletConnectRuntimeKey?: string;
+    /**
+     * Chain id the WalletConnect OPEN_PROVIDER pairing must include — the
+     * reauth target token's chain, supplied by the token-authorization
+     * handlers. Overrides `action.metadata.requiredChainId` so the SDK can
+     * require the right chain even when the backend didn't stamp it. A
+     * session that doesn't approve this chain re-pairs with it required; a
+     * pairing that still comes back without it fails OPEN_PROVIDER with a
+     * clear error instead of crashing SELECT_SOURCE auto-resolve on the
+     * backend's approved-chain validation (422 INVALID_SELECT_SOURCE_SELECTION).
+     */
+    walletConnectRequiredChainId?: number;
+    /**
+     * EVM chain ids from the backend's `/v1/chains`, proposed as optional
+     * namespaces at the WalletConnect pairing on top of the runtime's hardcoded
+     * fallback. Source chains are admin-managed server-side, so deriving the
+     * proposal from this list keeps newly-enabled chains approvable without an
+     * SDK release — a chain absent from the proposal can never be approved and
+     * would surface as a false "Not supported" row.
+     */
+    walletConnectOptionalChainIds?: number[];
+    /**
+     * Human-readable name for `walletConnectRequiredChainId` (e.g. "HyperEVM"),
+     * surfaced in the missing-required-chain error instead of a bare chain id.
+     */
+    walletConnectRequiredChainName?: string;
     /**
      * Optional Promise that races the WalletConnect pairing for OPEN_PROVIDER.
      * Used by `handleSelectWalletConnectWallet` when the picked Reown wallet is
@@ -1213,6 +1314,18 @@ interface UseAuthorizationOrchestratorResult {
     pendingSelectSourceAction: AuthorizationAction | null;
     /** Complete the pending SELECT_SOURCE action with a chosen source. */
     resolveSelectSource: (selection: SourceSelection) => void;
+    /**
+     * True once an INTERACTIVE SELECT_SOURCE has been resolved during the
+     * current run (i.e. the user picked a token on LinkTokensScreen and tapped
+     * Approve via `resolveSelectSource`). Reset to false at the start of each
+     * `run` and on `cancelPendingFlow`. The `autoResolveSource` path (WC
+     * reauthorization / token authorization) never sets this, because it
+     * resolves SELECT_SOURCE without pausing for the user. Consumed by
+     * StepRenderer to distinguish the post-Approve transient (where the
+     * executor's `currentAction` is still the stale OPEN_PROVIDER from pairing)
+     * from genuine pairing — so OpenWalletScreen doesn't flash after Approve.
+     */
+    sourceSelectionResolved: boolean;
     /** True after the most recent run drained all authorization actions. */
     orchestratorCompleted: boolean;
     /** Cancel any paused setup flow and reject the current orchestrator run. */
@@ -1224,6 +1337,14 @@ interface UseAuthorizationOrchestratorDeps {
 }
 declare function useAuthorizationOrchestrator(deps: UseAuthorizationOrchestratorDeps): UseAuthorizationOrchestratorResult;
 
+interface WalletAccountChange {
+    previousAddress: string | null;
+    nextAddress: string;
+    connectorId: string;
+    chainId: number | null;
+    accounts: readonly string[];
+}
+
 interface ReownWallet {
     id: string;
     name: string;
@@ -1261,6 +1382,20 @@ interface PreparedTokenAuthorization {
     providerId: string | null;
     providerName: string;
     depositAmount: number;
+    /**
+     * Present when the target account is WalletConnect-typed. There is no
+     * native wallet deeplink for WC, and the auth-app session URI cannot
+     * execute a WalletConnect session (it would strand the user on a loading
+     * LinkTokensScreen) — committing such a prepared authorization must run
+     * the inline WC orchestrator path in this tab instead. `deeplinkUri` is
+     * empty in this case and must not be navigated to.
+     */
+    walletConnect?: {
+        /** Reown metadata recovered from the session's OPEN_PROVIDER action. */
+        metadata: WalletConnectAccountMetadata | null;
+        /** Wallet name used for open-wallet branding and button copy. */
+        displayName: string;
+    };
 }
 
 /** Snapshot for restoring deposit source after cancelling token reauth / increase-limit subflows. */
@@ -1290,6 +1425,13 @@ interface PaymentState {
     amount: string;
     transfer: Transfer | null;
     creatingTransfer: boolean;
+    /**
+     * True when an SVM transfer's signing window expired (API returned
+     * `SVM_SIGN_PAYLOAD_EXPIRED`). Drives the friendly "sign within 20 seconds"
+     * message + Retry on the processing screen. Cleared when a new attempt
+     * starts or the transfer advances.
+     */
+    signPayloadExpired: boolean;
     passkeyConfigLoaded: boolean;
     activeCredentialId: string | null;
     knownCredentialIds: string[];
@@ -1323,6 +1465,13 @@ interface PaymentState {
         providerId: string | null;
         walletName?: string;
         walletLogoUrl?: string;
+        /**
+         * Bare WalletConnect wallet deeplink (no `wc:` pairing URI) used to
+         * FOREGROUND the already-connected wallet for a signing prompt on mobile.
+         * Powers the manual "Open {wallet}" button on `ApprovingInWalletScreen`.
+         * Distinct from `sessionUri` (the pairing QR/deeplink).
+         */
+        walletForegroundLink?: string;
     } | null;
     /**
      * Active authorization session id for the in-progress wallet-setup flow.
@@ -1417,6 +1566,15 @@ interface PaymentState {
      * — a genuine reopen should re-greet.
      */
     welcomeBackAcknowledged: boolean;
+    /**
+     * Latched `true` once the first accounts fetch resolves (`DATA_LOADED` /
+     * `ACCOUNTS_RELOADED`). Gates fresh-phase derivation for an authenticated
+     * user so we never derive a post-load screen (welcome-back / wallet-picker /
+     * deposit) from the empty initial `accounts` array — that race flashes
+     * `WelcomeBackScreen` before the real screen. Reset on de-auth so a new
+     * session re-shows the loader until its accounts arrive.
+     */
+    initialDataLoaded: boolean;
 }
 interface InitialStateConfig {
     depositAmount: number | null;
@@ -1472,6 +1630,8 @@ interface StepHandlers {
     onCancelLogin: () => void;
     /** Advance a returning user off WelcomeBackScreen toward the wallet picker. */
     onAcknowledgeWelcomeBack: () => void;
+    /** Back from WalletPickerScreen: return a walletless user to WelcomeBackScreen. */
+    onReturnToWelcomeBack: () => void;
     /**
      * Update the in-flow amount-entry value (string display). Called by
      * DepositScreen entry mode on every keypress / preset tap. The view-model
@@ -1486,6 +1646,13 @@ interface StepHandlers {
     onFinalizeAmount: () => void;
     onSetDepositToken: (symbol: string, chainName: string, walletId?: string, tokenAddress?: string, chainId?: number) => void;
     onConfirmSetupDeposit: () => void | Promise<void>;
+    /**
+     * Mobile only: foreground the already-connected WalletConnect wallet from the
+     * signing screen's manual "Open {wallet}" button. Opens the bare wallet
+     * deeplink (no `wc:` URI) so the pending Permit2 prompt surfaces without
+     * re-pairing. Undefined on desktop / when no foreground link is available.
+     */
+    onOpenWalletForeground?: () => void;
 }
 /** Flow identity: reducer state, auth, layout. */
 interface StepRendererFlowProps {
@@ -1533,10 +1700,25 @@ interface StepRendererRemoteProps {
     /** True while `executeSessionById` is running (desktop inline wallet steps). */
     authExecutorExecuting: boolean;
     authExecutorCurrentAction?: AuthorizationAction | null;
+    /** True once a run has drained all authorization actions (orchestrator
+     *  completed). Stays true through the post-sign settling window — when
+     *  `currentAction` is already null — until the next run resets it. Lets the
+     *  approving checklist render all items complete instead of reverting to the
+     *  default active state while the next screen loads. */
+    authExecutorCompleted: boolean;
     transferSigningSigning: boolean;
     transferSigningError: string | null;
     transferSigningPasskeyDismissed?: boolean;
     pendingSelectSource: AuthorizationAction | null;
+    /**
+     * True once the user interactively resolved a SELECT_SOURCE this run (picked
+     * a token on LinkTokensScreen and tapped Approve). Distinguishes the
+     * post-Approve transient — where the executor's `currentAction` is still the
+     * stale OPEN_PROVIDER from pairing — from genuine pairing, so OpenWalletScreen
+     * is not re-shown after Approve. False during WC reauthorization auto-resolve
+     * pairing, which keeps OpenWalletScreen visible until the wallet pairs.
+     */
+    sourceSelectionResolved: boolean;
 }
 /** Values derived from accounts / selection (plus select-source picker data). */
 interface StepRendererDerivedProps {
@@ -1548,11 +1730,19 @@ interface StepRendererDerivedProps {
     selectedAccount: Account | undefined;
     selectedSource: WalletSource | null;
     selectSourceChoices: SelectSourceChainChoice[];
+    /** Balances on chains the WalletConnect session did not approve — rendered as disabled "Not supported" rows. */
+    selectSourceUnsupportedChoices: SelectSourceChainChoice[];
     selectSourceRecommended: {
         chainName: string;
         tokenSymbol: string;
     } | null;
     selectSourceAvailableBalance: number;
+    /**
+     * Reown registry chain ids per WalletConnect-typed account id (null =
+     * registry has no opinion, fail open). Used to badge requires-auth deposit
+     * sources on chains the backing wallet cannot authorize.
+     */
+    walletConnectChainIdsByAccount: Record<string, number[] | null>;
 }
 /** Ephemeral form UI state. */
 interface StepRendererFormProps {
@@ -1674,6 +1864,12 @@ interface UseTransferSigningResult {
      * 3. Submits signed UserOp via PATCH /v1/transfers/{id}
      */
     signTransfer: (transferId: string, opts?: SignTransferOptions) => Promise<Transfer>;
+    /**
+     * Regenerates a fresh SVM sign payload for a transfer whose signing window
+     * expired (POST /v1/transfers/{id}/sign-payload), reusing the same transfer
+     * id. Returns the refreshed Transfer carrying the new signPayload.
+     */
+    regenerateSignPayload: (transferId: string) => Promise<Transfer>;
 }
 interface UseTransferSigningOptions {
     /** Optional API base URL override when used outside BlinkProvider. */
@@ -1714,8 +1910,25 @@ interface ScreenLayoutProps {
      * surrounding chrome (heading, banners, CTA) stays pinned. Defaults to true.
      */
     scrollableBody?: boolean;
+    /**
+     * When true, the footer floats over the body instead of taking its own band
+     * at the bottom of the sheet. Its background is a gradient that is
+     * transparent across the top half and fades to the solid sheet color for the
+     * bottom half, so the scroll content peeks through above the CTA while the
+     * button itself sits on a solid base. Only the footer's own children are
+     * interactive — the transparent gutter passes taps and scroll through to the
+     * list below. Screens that opt in must reserve bottom padding in their scroll
+     * container so the last row clears the floating footer. Defaults to false.
+     */
+    floatingFooter?: boolean;
+    /**
+     * When true, the body still scrolls but its scrollbar is visually hidden
+     * (overflow behaviour is unchanged). Use for screens that should never show
+     * scrollbar chrome. Defaults to false.
+     */
+    hideScrollbar?: boolean;
 }
-declare function ScreenLayout({ children, footer, scrollableBody }: ScreenLayoutProps): react_jsx_runtime.JSX.Element;
+declare function ScreenLayout({ children, footer, scrollableBody, floatingFooter, hideScrollbar }: ScreenLayoutProps): react_jsx_runtime.JSX.Element;
 
 interface ScreenHeaderProps {
     /** Center title text */
@@ -1958,13 +2171,18 @@ interface PasskeyScreenProps {
 declare function PasskeyScreen({ onCreatePasskey, onBack, onLogout, creating, error, popupFallback, onCreatePasskeyViaPopup, onCreateNewPasskey, onCreateNewPasskeyViaPopup, createNewPopupFallback, creatingNewPasskey, }: PasskeyScreenProps): react_jsx_runtime.JSX.Element;
 
 interface PasskeyPopupWelcomeScreenProps {
+    /** Begins passkey creation (Privy signup). */
     onCreatePasskey: () => void;
+    /** When set, renders an "or Sign in with passkey" secondary action for users who already have a passkey. */
+    onSignInWithPasskey?: () => void;
+    /** Disables the actions and shows the primary button's loading state. */
     creating?: boolean;
+    /** Error copy shown in a banner below the hero. */
     error?: string | null;
     onBack?: () => void;
     onLogout?: () => void;
 }
-declare function PasskeyPopupWelcomeScreen({ onCreatePasskey, creating, error, onBack, onLogout, }: PasskeyPopupWelcomeScreenProps): react_jsx_runtime.JSX.Element;
+declare function PasskeyPopupWelcomeScreen({ onCreatePasskey, onSignInWithPasskey, creating, error, onBack, onLogout, }: PasskeyPopupWelcomeScreenProps): react_jsx_runtime.JSX.Element;
 
 interface VerifyPasskeyScreenProps {
     onVerify: () => void;
@@ -2023,14 +2241,37 @@ interface SetupTokenOption {
     chainId?: number;
     /** Account this token belongs to; used by multi-account pickers to group rows. */
     accountId?: string;
+    /**
+     * Truncated wallet address (from `wallet.name`). One account may own wallets
+     * at several distinct addresses (e.g. multiple Solana accounts under one
+     * Phantom connection); multi-account pickers group rows by address so those
+     * are not collapsed under a single header. EVM wallets share one address per
+     * account, so this yields a single section there.
+     */
+    walletAddress?: string;
     /** Server-provided token logo URI from the catalog. Preferred over the local `TOKEN_LOGOS` map. */
     logoURI?: string | null;
+    /**
+     * WalletConnect-typed account only: the Reown registry says the backing
+     * wallet does not support this token's chain, so authorizing it would
+     * dead-end (the prepare/authorize handlers' pre-filter rejects it).
+     * Rendered as a disabled "Not supported, deposit manually" row. Never set
+     * on AUTHORIZED rows — those deposit via passkey without the wallet.
+     */
+    notSupported?: boolean;
 }
 
 interface LinkTokenEntry {
     tokenSymbol: string;
     chainName: string;
     balanceUsd: number;
+    /**
+     * WalletConnect-only: the connected wallet cannot sign on this token's
+     * chain (missing from both the session's approved chains and the Reown
+     * registry). Renders the "Not supported, deposit manually" pill and makes
+     * the row unselectable.
+     */
+    notSupported?: boolean;
 }
 interface LinkTokensScreenProps {
     entries: LinkTokenEntry[];
@@ -2291,12 +2532,19 @@ interface TransferStatusBaseProps {
     retryLabel?: string;
     retryAfterDelay?: boolean;
     showRetryOnError?: boolean;
+    /**
+     * Presentation of the error message. `error` (default) uses the red error
+     * banner for genuine failures; `info` uses the neutral informational
+     * NotificationBanner for benign, retryable conditions (e.g. an expired SVM
+     * signing window).
+     */
+    errorVariant?: 'error' | 'info';
 }
 
 interface DepositTransferStatusScreenProps extends TransferStatusBaseProps {
     visibleError?: string | null;
 }
-declare function DepositTransferStatusScreen({ phase, error, visibleError, onLogout, onRetry, }: DepositTransferStatusScreenProps): react_jsx_runtime.JSX.Element;
+declare function DepositTransferStatusScreen({ phase, error, visibleError, errorVariant, onLogout, onRetry, }: DepositTransferStatusScreenProps): react_jsx_runtime.JSX.Element;
 
 interface OpenWalletScreenProps {
     walletName: string | null;
@@ -2330,12 +2578,27 @@ interface ApprovingInWalletScreenProps {
      *  'sign'    = approval done (this session or previously) → step 1 checked, step 2 active;
      *  'spl'     = single Solana delegate approval (one item). */
     step: 'approve' | 'sign' | 'spl';
+    /** When true, every checklist item renders complete (checked). Set during the
+     *  post-sign settling window so the checkmarks persist until the next screen
+     *  loads, rather than reverting to the active/pending default. `step` still
+     *  selects the shape (one SPL item vs. two EVM items). */
+    complete?: boolean;
     error?: string | null;
     onRetry?: () => void;
     /** Desktop-only escape hatch back to the previous screen. */
     onBack?: () => void;
     /** Desktop-only settings/logout action. */
     onLogout?: () => void;
+    /** Mobile WalletConnect: connected wallet name, for the "Open {wallet}" button. */
+    walletName?: string | null;
+    /**
+     * Mobile WalletConnect: bare wallet deeplink (no `wc:` URI) for the manual
+     * "Open {wallet}" button. Foregrounds the already-connected wallet so the
+     * pending signing prompt surfaces — does NOT re-pair. Absent on desktop.
+     */
+    foregroundDeeplink?: string | null;
+    /** Fires when the user taps "Open {wallet}" (opens `foregroundDeeplink`). */
+    onOpenWallet?: () => void;
 }
 /**
  * Activation surface rendered while the user signs the Permit2 / SPL
@@ -2343,7 +2606,7 @@ interface ApprovingInWalletScreenProps {
  * Shares chrome with LinkTokensScreen (header wordmark, h2 heading, recessed
  * card, footer lock banner) so the link → authorize steps read as one page.
  */
-declare function ApprovingInWalletScreen({ tokenSymbol, chainName, step, error, onRetry, onBack, onLogout, }: ApprovingInWalletScreenProps): react_jsx_runtime.JSX.Element;
+declare function ApprovingInWalletScreen({ tokenSymbol, chainName, step, complete, error, onRetry, onBack, onLogout, walletName, foregroundDeeplink, onOpenWallet, }: ApprovingInWalletScreenProps): react_jsx_runtime.JSX.Element;
 
 interface ConfirmSignScreenProps {
     walletName: string | null;
@@ -2462,8 +2725,45 @@ declare function replaceOpenProviderForAccountSwitch(input: {
     sessionId: string;
     accounts: readonly string[];
     chainId: number | null;
+    /**
+     * SVM (Phantom) switches pass the new account's base58 pubkey here. The
+     * backend's SVM OPEN_PROVIDER re-report (`generateActionsAfterSvmOpenProvider`)
+     * prefers `userSolanaWalletPubkey` over `accounts[0]`, so passing it
+     * explicitly avoids the dual-mode `accounts[0]` ambiguity. EVM callers omit
+     * it (behavior unchanged).
+     */
+    userSolanaWalletPubkey?: string;
 }): Promise<WalletAccountSwitchResult>;
 
+interface SolanaAccountSwitchDeps {
+    /** Set to false to detach the listener without unmounting the hook. */
+    enabled?: boolean;
+    /** Called with the next account when a real Solana account change is observed. */
+    onAccountChanged: (change: WalletAccountChange) => void | Promise<void>;
+}
+/**
+ * SVM analogue of `useWalletAccountSwitchEffect`. Subscribes to the Solana
+ * wallet runtime's account-change channel (fed by the cached Phantom
+ * adapter's `connect` re-emission when the user switches accounts inside the
+ * wallet) and surfaces a `WalletAccountChange` on a genuine transition.
+ *
+ * The single effect synchronizes with an external system — the module-level
+ * adapter event channel in `solanaWalletRuntime` — so the subscription and
+ * its unsubscribe cleanup are a legitimate `useEffect`.
+ *
+ * Unlike the EVM hook (whose `useAccount` replays the current address on
+ * mount, requiring a silent baseline seed to avoid a spurious null→A switch),
+ * this channel is purely event-driven and the runtime already seeds its
+ * baseline from the connected account at bind time — so it emits *only*
+ * genuine transitions. Every emission is therefore fired through immediately;
+ * the local `baselineRef` exists only to populate `previousAddress` and to
+ * defensively drop a same-pubkey repeat. The emitted change is SVM-shaped —
+ * `chainId: null` and `accounts: [pubkey]` — which the switch helper uses to
+ * route the new Solana pubkey to the backend's preferred
+ * `userSolanaWalletPubkey` field.
+ */
+declare function useSolanaAccountSwitchEffect(deps: SolanaAccountSwitchDeps): void;
+
 type DebugLevel = 'info' | 'warn' | 'error';
 interface DebugEntry {
     id: number;
@@ -2483,4 +2783,4 @@ declare function clearDebugEntries(): void;
  */
 declare function useBlinkDebugLog(): DebugEntry[];
 
-export { ACCOUNT_SWITCH_CONFLICT_MESSAGE, type Account, type ActionExecutionResult, type AdvancedSettings, AdvancedSourceScreen, type Amount, ApprovingInWalletScreen, type ApprovingInWalletScreenProps, type AuthorizationAction, type AuthorizationSession, AuthorizationSessionCancelledError, type AuthorizationSessionDetail, BLINK_ERROR_ILLUSTRATION, BLINK_LOGO, BLINK_MASCOT, BLINK_PASSKEY_ILLUSTRATION, BLINK_SUCCESS_ILLUSTRATION, BlinkErrorScreen, BlinkInitialLoadingScreen, BlinkLoadingScreen, BlinkPayment, type BlinkPaymentProps, BlinkProvider, type BlinkProviderProps, type Chain, ConfirmSignScreen, type DebugEntry, type DebugLevel, DepositCompleteScreen, DepositOptionsScreen, DepositScreen, DepositTransferStatusScreen, type Destination, type ErrorResponse, type ExecutionResult, type GuestTokenEntry, type GuestTokenPickerRawRow, GuestTokenPickerScreen, IconCircle, InfoBanner, LOGIN_KEY_ILLUSTRATION, type LinkTokenEntry, LinkTokensScreen, type ListResponse, LoginScreen, ManualTransferPasskeyScreen, type MerchantAuthorization, type MerchantPublicKey, type MobileFlowState, OpenWalletScreen, type OrchestratorResult, type OrchestratorRunOptions, OtpVerifyScreen, OutlineButton, PasskeyIframeBlockedError, PasskeyPopupWelcomeScreen, PasskeyScreen, type PaymentPhase, type PaymentState, PoweredByFooter, type PreciseMoney, PrimaryButton, type Provider, ScreenHeader, ScreenLayout, type ScreenName, SecondaryButton, SelectDepositSourceScreen, SelectSourceScreen, SettingsMenu, type SetupTokenOption, type SourceOption, type SourceSelection, type SourceType, Spinner, type StepHandlers, type StepItem, StepList, StepRenderer, type StepRendererDerivedProps, type StepRendererFlowProps, type StepRendererFormProps, type StepRendererProps, type StepRendererRemoteProps, SuccessScreen, type ThemeMode, type ThemeTokens, type TokenBalance, TokenPickerScreen, type Transfer, type TransferDestination, type TransferPhase, type UseAuthorizationExecutorResult, type UseAuthorizationOrchestratorResult, type UserConfig, VerifyPasskeyScreen, type Wallet, type WalletAccountSwitchResult, type WalletCapabilities, type WalletCapabilitiesDebugSnapshot, type WalletDeeplink, WalletPickerScreen, type WalletSource, type WalletToken, WelcomeBackScreen, appendDebug, api as blinkApi, clearDebugEntries, createInitialState, credentialIdBase64ToBytes, darkTheme, darkThemeNew, darkTransparentTheme, darkTransparentThemeNew, deviceHasPasskey, encodePermit2ApproveCalldata, findDevicePasskey, findDevicePasskeyViaPopup, getAtomicBatchSupportDebugInfo, getDebugEntries, getDeviceBiometricUnlockText, getTheme, getThemeBase, getWalletCapabilities, isAuthorizationSessionCancelled, isExpectedAuthorizationCancellation, isTerminalTransferStatus, isTransferAwaitingCompletion, isTransparentTheme, isUserDismissedAuthorizationError, isVisibleUsdAmountAtTwoDecimals, lightTheme, lightThemeNew, lightTransparentTheme, lightTransparentThemeNew, mapGuestPickerEntries, replaceOpenProviderForAccountSwitch, resolvePasskeyRpId, screenForPhase, subscribeDebug, supportsAtomicBatch, supportsPaymasterService, useAuthorizationExecutor, useAuthorizationOrchestrator, useBlinkConfig, useBlinkDebugLog, useBlinkDepositAmount, useTransferPolling, useTransferSigning };
+export { ACCOUNT_SWITCH_CONFLICT_MESSAGE, type Account, type ActionExecutionResult, type AdvancedSettings, AdvancedSourceScreen, type Amount, ApprovingInWalletScreen, type ApprovingInWalletScreenProps, type AuthorizationAction, type AuthorizationSession, AuthorizationSessionCancelledError, type AuthorizationSessionDetail, BLINK_ERROR_ILLUSTRATION, BLINK_LOGO, BLINK_MASCOT, BLINK_PASSKEY_ILLUSTRATION, BLINK_SUCCESS_ILLUSTRATION, BlinkErrorScreen, BlinkInitialLoadingScreen, BlinkLoadingScreen, BlinkPayment, type BlinkPaymentProps, BlinkProvider, type BlinkProviderProps, type Chain, ConfirmSignScreen, type DebugEntry, type DebugLevel, DepositCompleteScreen, DepositOptionsScreen, DepositScreen, DepositTransferStatusScreen, type Destination, type ErrorResponse, type ExecutionResult, type GuestTokenEntry, type GuestTokenPickerRawRow, GuestTokenPickerScreen, IconCircle, InfoBanner, LOGIN_KEY_ILLUSTRATION, type LinkTokenEntry, LinkTokensScreen, type ListResponse, LoginScreen, ManualTransferPasskeyScreen, type MerchantAuthorization, type MerchantPublicKey, type MobileFlowState, OpenWalletScreen, type OrchestratorResult, type OrchestratorRunOptions, OtpVerifyScreen, OutlineButton, PasskeyIframeBlockedError, PasskeyPopupWelcomeScreen, PasskeyScreen, type PaymentPhase, type PaymentState, PoweredByFooter, type PreciseMoney, PrimaryButton, type Provider, ScreenHeader, ScreenLayout, type ScreenName, SecondaryButton, SelectDepositSourceScreen, SelectSourceScreen, SettingsMenu, type SetupTokenOption, type SolanaAccountSwitchDeps, type SourceOption, type SourceSelection, type SourceType, Spinner, type StepHandlers, type StepItem, StepList, StepRenderer, type StepRendererDerivedProps, type StepRendererFlowProps, type StepRendererFormProps, type StepRendererProps, type StepRendererRemoteProps, SuccessScreen, type ThemeMode, type ThemeTokens, type TokenBalance, TokenPickerScreen, type Transfer, type TransferDestination, type TransferPhase, type UseAuthorizationExecutorResult, type UseAuthorizationOrchestratorResult, type UserConfig, VerifyPasskeyScreen, type Wallet, type WalletAccountChange, type WalletAccountSwitchResult, type WalletCapabilities, type WalletCapabilitiesDebugSnapshot, type WalletDeeplink, WalletPickerScreen, type WalletSource, type WalletToken, WelcomeBackScreen, appendDebug, api as blinkApi, clearDebugEntries, createInitialState, credentialIdBase64ToBytes, darkTheme, darkThemeNew, darkTransparentTheme, darkTransparentThemeNew, deviceHasPasskey, encodePermit2ApproveCalldata, findDevicePasskey, findDevicePasskeyViaPopup, getAtomicBatchSupportDebugInfo, getDebugEntries, getDeviceBiometricUnlockText, getTheme, getThemeBase, getWalletCapabilities, isAuthorizationSessionCancelled, isExpectedAuthorizationCancellation, isTerminalTransferStatus, isTransferAwaitingCompletion, isTransparentTheme, isUserDismissedAuthorizationError, isVisibleUsdAmountAtTwoDecimals, lightTheme, lightThemeNew, lightTransparentTheme, lightTransparentThemeNew, mapGuestPickerEntries, replaceOpenProviderForAccountSwitch, resolvePasskeyRpId, screenForPhase, subscribeDebug, supportsAtomicBatch, supportsPaymasterService, useAuthorizationExecutor, useAuthorizationOrchestrator, useBlinkConfig, useBlinkDebugLog, useBlinkDepositAmount, useSolanaAccountSwitchEffect, useTransferPolling, useTransferSigning };