@swype-org/react-sdk 0.2.315 → 0.2.323

package/dist/index.d.cts

@@ -589,6 +589,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 +755,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 +767,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 {
@@ -1224,6 +1231,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;
@@ -1290,6 +1305,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[];
@@ -1417,6 +1439,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 +1503,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
@@ -1674,6 +1707,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. */
@@ -2023,6 +2062,14 @@ 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;
 }
@@ -2291,12 +2338,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;
@@ -2462,8 +2516,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 +2574,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 };

package/dist/index.d.ts

@@ -589,6 +589,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 +755,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 +767,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 {
@@ -1224,6 +1231,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;
@@ -1290,6 +1305,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[];
@@ -1417,6 +1439,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 +1503,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
@@ -1674,6 +1707,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. */
@@ -2023,6 +2062,14 @@ 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;
 }
@@ -2291,12 +2338,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;
@@ -2462,8 +2516,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 +2574,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 };