@seams/wallet 0.29.0 → 0.31.0

package/dist/public/wallet-service/index.html

@@ -5,14 +5,14 @@
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Web3Authn Wallet Service</title>
     <!-- Surface styles are external so strict CSP can keep style-src 'self' -->
-    <link rel="stylesheet" href="/sdk/wallet-ui.css?v=0.29.0" />
+    <link rel="stylesheet" href="/sdk/wallet-ui.css?v=0.31.0" />
     <!-- Minimal shims some ESM bundles expect (externalized to enable strict CSP) -->
-    <script src="/sdk/wallet-shims.js?v=0.29.0"></script>
+    <script src="/sdk/wallet-shims.js?v=0.31.0"></script>
     <!-- Hint the browser to fetch the host script earlier -->
-    <link rel="modulepreload" href="/sdk/wallet-iframe-host-runtime.js?v=0.29.0" crossorigin>
+    <link rel="modulepreload" href="/sdk/wallet-iframe-host-runtime.js?v=0.31.0" crossorigin>
   </head>
   <body>
     <!-- sdkBasePath points to the SDK root (e.g. '/sdk'). Load the host directly. -->
-    <script type="module" src="/sdk/wallet-iframe-host-runtime.js?v=0.29.0"></script>
+    <script type="module" src="/sdk/wallet-iframe-host-runtime.js?v=0.31.0"></script>
   </body>
 </html>

package/dist/types/wallet/src/SeamsWeb/index.d.ts

@@ -13,4 +13,5 @@ export type { DeviceLinkingSession, LinkDeviceResult, LinkedDeviceEmailOtpActiva
 export type { LinkedDeviceListRequestV1, LinkedDeviceListResultV1, LinkedDeviceManagementRequestV1, LinkedDeviceRevokeRequestV1, LinkedDeviceRevokeResultV1, LinkedDeviceSummaryV1, QrLinkedDeviceSessionPayloadV5, } from '../../../shared-ts/src/device-linking';
 export { LinkDeviceEventPhase, DeviceLinkingError, DeviceLinkingErrorCode, } from '../core/types/linkDevice';
 export type { SyncAccountResult } from '../core/types/sdkPublicResults';
+export type { WalletAlternatives, WalletAlternativeDescriptor, WalletConnectionRequest, WalletConnectionResolutionInput, WalletConnectionResult, } from './walletIframe/shared/walletAlternatives';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/wallet/src/SeamsWeb/publicApi/types.d.ts

@@ -1,3 +1,4 @@
+import type { WalletConnectionRequest, WalletConnectionResolutionInput } from '../walletIframe/shared/walletAlternatives';
 import type { AuthMethodAvailability } from '../../core/authMethods/availabilityTypes';
 import type { VoiceIdConfirmationOptions } from '../../core/authMethods/plugins';
 import type { SdkLifecycleEventListener } from '../../core/types/sdkSentEvents';
@@ -79,6 +80,8 @@ export interface AuthMenuCapability {
     cancel(args: {
         authMenuSessionId: HostedAuthMenuSessionId;
     }): Promise<void>;
+    onWalletConnectionRequest(listener: (request: WalletConnectionRequest) => void): () => void;
+    resolveWalletConnection(resolution: WalletConnectionResolutionInput): Promise<void>;
     onExternalAuthRequest(listener: (request: HostedAuthMenuExternalAuthRequest) => void): () => void;
     resolveExternalAuth(resolution: HostedAuthMenuExternalAuthResolutionInput): Promise<void>;
 }

package/dist/types/wallet/src/SeamsWeb/walletIframe/client/inboundMessages.d.ts

@@ -1,3 +1,4 @@
+import { parseWalletConnectionRequest } from '../shared/walletAlternatives';
 import { parseTransactionReviewState } from '../shared/transactionReview';
 import { type ProgressPayload, type PreferencesChangedPayload, type ErrorPayload, type PMResultPayload, parseWalletIframeSurfaceMeasurement, parseHostedAuthMenuErrorEvent } from '../shared/messages';
 import type { SdkLifecycleEvent } from '../../../core/types/sdkSentEvents';
@@ -13,6 +14,10 @@ type ParsedSdkLifecycleEnvelope = {
     readonly event: SdkLifecycleEvent;
 };
 type ParsedChildToParentEnvelope = {
+    readonly type: 'WALLET_CONNECTION_REQUEST';
+    readonly requestId?: string;
+    readonly payload: NonNullable<ReturnType<typeof parseWalletConnectionRequest>>;
+} | {
     readonly type: 'SESSION_CHANGED';
     readonly payload: WalletIframeExactSessionSnapshot;
 } | {

package/dist/types/wallet/src/SeamsWeb/walletIframe/client/router.d.ts

@@ -1,3 +1,4 @@
+import { type WalletConnectionRequest, type WalletConnectionResolutionInput } from '../shared/walletAlternatives';
 import type { ExecuteOwnerNearOperation } from '../../publicApi/ownerNearOperation';
 import type { VoiceIdConfirmationOptions } from '../../../core/authMethods/plugins';
 import type { WalletRegistrationCommand } from '../../publicApi/createPublicApi';
@@ -168,6 +169,8 @@ export declare class WalletIframeRouter {
     private hideRequestSurface;
     private finishDeviceLinkQrSurface;
     onConnectionClosed(listener: () => void): () => void;
+    onWalletConnectionRequest(listener: (request: WalletConnectionRequest) => void): () => void;
+    resolveWalletConnection(resolution: WalletConnectionResolutionInput): Promise<void>;
     onHostedAuthMenuExternalAuthRequest(listener: (payload: HostedAuthMenuExternalAuthRequest) => void): () => void;
     resolveHostedAuthMenuExternalAuth(resolution: HostedAuthMenuExternalAuthResolutionInput): Promise<void>;
     /**

package/dist/types/wallet/src/SeamsWeb/walletIframe/coordinator.d.ts

@@ -1,3 +1,4 @@
+import type { WalletConnectionRequest, WalletConnectionResolutionInput } from './shared/walletAlternatives';
 import type { ClientConnectionState } from '../publicApi/types';
 import type { PreferenceState } from './client/preferenceState';
 import type { AppearanceConfig, SeamsClientConfig, WalletSession } from '../../core/types/seams';
@@ -29,6 +30,8 @@ export declare class WalletIframeCoordinator {
     private walletIframeSessionUnsubscribe;
     private readonly sessionListeners;
     private walletIframeLifecycleUnsubscribe;
+    private walletConnectionUnsubscribe;
+    private readonly walletConnectionListeners;
     private walletIframeAuthMenuUnsubscribe;
     private readonly sdkLifecycleEventListeners;
     private readonly hostedAuthMenuExternalAuthRequestListeners;
@@ -60,6 +63,9 @@ export declare class WalletIframeCoordinator {
     cancelHostedAuthMenu(args: {
         authMenuSessionId: HostedAuthMenuSessionId;
     }): Promise<void>;
+    onWalletConnectionRequest(listener: (request: WalletConnectionRequest) => void): () => void;
+    resolveWalletConnection(resolution: WalletConnectionResolutionInput): Promise<void>;
+    private forwardWalletConnection;
     onHostedAuthMenuExternalAuthRequest(listener: (request: HostedAuthMenuExternalAuthRequest) => void): () => void;
     resolveHostedAuthMenuExternalAuth(resolution: HostedAuthMenuExternalAuthResolutionInput): Promise<void>;
     lockExactSession(identity: WalletIframeExactSessionIdentity): Promise<WalletIframeExactSessionLockResult>;

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/auth-menu/controller.d.ts

@@ -1,3 +1,4 @@
+import type { WalletConnectionResolution } from '../../shared/walletAlternatives';
 import type { AppearanceConfig } from '../../../../core/types/seams';
 import type { WalletHostRuntime } from '../WalletHostRuntime';
 import type { ChildToParentEnvelope, HostedAuthMenuCancelPayload, HostedAuthMenuExternalAuthResolution, HostedAuthMenuOpenRequest } from '../../shared/messages';
@@ -24,6 +25,7 @@ export declare class AuthMenuController {
     private cancelDeviceLinking;
     private prepareRegistration;
     cancel(payload: HostedAuthMenuCancelPayload): boolean;
+    resolveWalletConnection(resolution: WalletConnectionResolution): boolean;
     resolveExternalAuth(resolution: HostedAuthMenuExternalAuthResolution): boolean;
 }
 export {};

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/auth-menu/domain.d.ts

@@ -303,6 +303,9 @@ export type AuthMenuRecoveryViewModel = AuthMenuViewModelCommon & {
 export type AuthMenuViewModel = AuthMenuLoginViewModel | AuthMenuRegisterViewModel | AuthMenuGoogleLoginViewModel | AuthMenuGoogleRegistrationViewModel | AuthMenuLinkDeviceViewModel | AuthMenuRecoveryViewModel;
 type AuthMenuCloseReason = 'close_button' | 'escape';
 export type AuthMenuIntent = {
+    readonly kind: 'wallet_connection';
+    readonly alternativeId: string;
+} | {
     readonly kind: 'close';
     readonly reason: AuthMenuCloseReason;
 } | {

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/auth-menu/session.d.ts

@@ -1,3 +1,4 @@
+import { type WalletConnectionResolution } from '../../shared/walletAlternatives';
 import type { WalletHostSessionCommands } from '../createSessionCommands';
 import type { AppearanceConfig } from '../../../../core/types/seams';
 import { type AuthMenuAccountOption, type AuthMenuGoogleLoginViewModel, type AuthMenuGoogleRegistrationViewModel, type AuthMenuLinkDeviceViewModel, type AuthMenuRecoveryViewModel, type AuthMenuViewModel } from './domain';
@@ -164,6 +165,7 @@ export declare class AuthMenuSession {
     readonly request: HostedAuthMenuOpenRequest;
     private stateValue;
     private surface;
+    private walletConnection;
     private outcomeResolver;
     private outcomePromise;
     private successTimers;
@@ -246,6 +248,8 @@ export declare class AuthMenuSession {
     private currentViewModel;
     private updateElement;
     private reportPresentedError;
+    private requestWalletConnection;
+    acceptWalletConnection(resolution: WalletConnectionResolution): boolean;
     private onIntent;
     private selectMode;
     private showPasskeyMode;

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/requestRouter.d.ts

@@ -4,7 +4,7 @@ type WalletHostRequest<T extends ParentToChildType> = ParentToChildEnvelope & {
 };
 type BootWalletRequestType = 'PM_ACTIVATE_TRANSACTION_REVIEW' | 'PING' | 'PM_PREPARE_WALLET_RUNTIME' | 'PM_SET_CONFIG' | 'PM_CANCEL' | 'PM_SET_TRANSACTION_VIEW' | 'PM_TRANSACTION_BROADCAST_STARTED';
 type NearWalletRequestType = 'PM_OWNER_NEAR_TRANSACTION' | 'PM_REGISTER_WALLET' | 'PM_ADD_WALLET_SIGNER' | 'PM_ADD_PASSKEY' | 'PM_ACTIVATE_AUTH_METHOD' | 'PM_GET_AUTH_METHOD_AVAILABILITY' | 'PM_SET_AUTH_METHOD_ENABLED' | 'PM_ADD_EMAIL_OTP' | 'PM_REVOKE_AUTH_METHOD' | 'PM_GET_NEAR_PROVISIONING_STATE' | 'PM_SIGN_TX_WITH_ACTIONS' | 'PM_SIGN_AND_SEND_TX' | 'PM_SEND_TRANSACTION' | 'PM_SIGN_DELEGATE_ACTION' | 'PM_SIGN_NEP413';
-type AuthWalletRequestType = 'PM_OPEN_AUTH_MENU' | 'PM_CANCEL_AUTH_MENU' | 'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH' | 'PM_UNLOCK' | 'PM_UNLOCK_AUTH_METHOD' | 'PM_EXTERNAL_AUTH' | 'PM_EXTERNAL_OWNER_AUTH' | 'PM_LOCK' | 'PM_LOCK_EXACT_WALLET_SESSION' | 'PM_GET_LAST_WALLET_MOVE_REQUEST' | 'PM_MOVE_WALLET' | 'PM_GET_WALLET_MOVE' | 'PM_GET_WALLET_PLACEMENT' | 'PM_GET_WALLET_SESSION' | 'PM_GET_EXACT_WALLET_SESSION_STATE' | 'PM_GET_RECENT_UNLOCKS';
+type AuthWalletRequestType = 'PM_OPEN_AUTH_MENU' | 'PM_CANCEL_AUTH_MENU' | 'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH' | 'PM_RESOLVE_WALLET_CONNECTION' | 'PM_UNLOCK' | 'PM_UNLOCK_AUTH_METHOD' | 'PM_EXTERNAL_AUTH' | 'PM_EXTERNAL_OWNER_AUTH' | 'PM_LOCK' | 'PM_LOCK_EXACT_WALLET_SESSION' | 'PM_GET_LAST_WALLET_MOVE_REQUEST' | 'PM_MOVE_WALLET' | 'PM_GET_WALLET_MOVE' | 'PM_GET_WALLET_PLACEMENT' | 'PM_GET_WALLET_SESSION' | 'PM_GET_EXACT_WALLET_SESSION_STATE' | 'PM_GET_RECENT_UNLOCKS';
 type EcdsaWalletRequestType = 'PM_SIGN_TEMPO' | 'PM_REPORT_TEMPO_BROADCAST_ACCEPTED' | 'PM_REPORT_TEMPO_BROADCAST_REJECTED' | 'PM_REPORT_TEMPO_FINALIZED' | 'PM_REPORT_TEMPO_DROPPED_OR_REPLACED' | 'PM_RECONCILE_TEMPO_NONCE_LANE';
 type EmailOtpWalletRequestType = 'PM_REDEEM_HOSTED_WALLET_SEAMS_SESSION' | 'PM_REQUEST_EMAIL_OTP_CHALLENGE' | 'PM_BEGIN_GOOGLE_EMAIL_OTP_WALLET_AUTH' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_RESEND' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_REROLL_WALLET_ID' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_SUBMIT' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_COMPLETE_REGISTRATION' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_CANCEL' | 'PM_GET_WALLET_RECOVERY_CODE_STATUS' | 'PM_ACKNOWLEDGE_WALLET_RECOVERY_CODE_BACKUP' | 'PM_ROTATE_WALLET_RECOVERY_CODES' | 'PM_REQUEST_WALLET_CUSTODY_EMAIL_OTP_CHALLENGE';
 type RecoveryWalletRequestType = 'PM_SYNC_ACCOUNT_FLOW';

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/ui/auth-menu/AuthMenuSurface.d.ts

@@ -1,9 +1,13 @@
+/** @jsxImportSource preact */
+import type { WalletAlternatives, WalletConnectionState } from '../../../shared/walletAlternatives';
 import type { WalletLocale } from '../../../../../core/ui/locale';
 import { type RecoveryCodeSelection } from './recovery-code-input';
 import { Component, type ComponentChildren } from 'preact';
 import type { CspStylesheetManager } from '../../../../../core/browser/walletIframe/csp-stylesheet';
 import { type AuthMenuIntent, type AuthMenuViewModel } from '../../auth-menu/domain';
 type AuthMenuSurfaceProps = {
+    readonly walletAlternatives: WalletAlternatives;
+    readonly walletConnection: WalletConnectionState;
     readonly viewModel: AuthMenuViewModel;
     readonly element: HTMLElement;
     readonly onIntent: (intent: AuthMenuIntent) => void;
@@ -54,6 +58,7 @@ export declare class AuthMenuSurface extends Component<AuthMenuSurfaceProps, Aut
     private restoreFocus;
     private onKeydown;
     private focusableElements;
+    private onDismiss;
     private onBackClick;
     /**
      * Escape backs out of the in-progress views the back arrow already serves.

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/ui/auth-menu/WalletAlternativesSection.d.ts

@@ -0,0 +1,13 @@
+/** @jsxImportSource preact */
+import { Component, type ComponentChildren } from 'preact';
+import type { WalletAlternatives } from '../../../shared/walletAlternatives';
+import type { AuthMenuIntent } from '../../auth-menu/domain';
+export declare class WalletAlternativesSection extends Component<{
+    alternatives: WalletAlternatives;
+    onIntent: (intent: AuthMenuIntent) => void;
+}> {
+    private connect;
+    private renderWalletRows;
+    render(): ComponentChildren;
+}
+//# sourceMappingURL=WalletAlternativesSection.d.ts.map

package/dist/types/wallet/src/SeamsWeb/walletIframe/host/ui/auth-menu/mountAuthMenuSurface.d.ts

@@ -1,13 +1,16 @@
+import { type WalletAlternatives, type WalletConnectionState } from '../../../shared/walletAlternatives';
 import type { AuthMenuIntent, AuthMenuViewModel } from '../../auth-menu/domain';
 export type AuthMenuSurfaceHandle = {
     readonly element: HTMLElement;
     update(viewModel: AuthMenuViewModel): void;
+    updateWalletConnection(state: WalletConnectionState): void;
     dispose(): void;
 };
 type MountAuthMenuSurfaceInput = {
     readonly parent: HTMLElement;
     readonly viewModel: AuthMenuViewModel;
     readonly initialHeightCssPx?: number;
+    readonly walletAlternatives?: WalletAlternatives;
     readonly onIntent: (intent: AuthMenuIntent) => void;
 };
 export declare function mountAuthMenuSurface(input: MountAuthMenuSurfaceInput): AuthMenuSurfaceHandle;

package/dist/types/wallet/src/SeamsWeb/walletIframe/shared/messages.d.ts

@@ -1,3 +1,4 @@
+import { type WalletAlternatives, type WalletConnectionRequest, type WalletConnectionResolution } from './walletAlternatives';
 import type { OwnerNearCommand } from './ownerNearOperation';
 import type { WalletSessionHome } from '../../../../../shared-ts/src/device-linking/contracts';
 import type { SigningEngineResolveExactKeyExportLaneInput as ResolveExactKeyExportLaneInput } from '../../../core/signingEngine/flows/recovery/public';
@@ -96,6 +97,7 @@ export type HostedAuthMenuOpenRequest = {
     showProgress: boolean;
     copy: HostedAuthMenuCopy;
     enabledExternalProviders: readonly HostedAuthMenuExternalProvider[];
+    walletAlternatives: WalletAlternatives;
 };
 export type HostedAuthMenuExternalAuthRequest = {
     kind: 'hosted_auth_menu_external_auth_request_v1';
@@ -142,6 +144,10 @@ export type HostedAuthMenuCancelPayload = {
 };
 export type HostedAuthMenuFailureCode = 'invalid_request' | 'unsupported_provider' | 'provider_error' | 'invalid_evidence' | 'webauthn_failed' | 'wallet_error' | 'timeout' | 'connection_closed' | 'internal_error';
 export type HostedAuthMenuOutcome = {
+    kind: 'wallet_connected';
+    authMenuSessionId: HostedAuthMenuSessionId;
+    alternativeId: string;
+} | {
     kind: 'authenticated';
     authMenuSessionId: HostedAuthMenuSessionId;
     walletId: WalletId;
@@ -182,6 +188,7 @@ export declare function buildHostedAuthMenuOpenRequest(args: {
     showProgress?: boolean;
     copy?: HostedAuthMenuCopyInput;
     enabledExternalProviders?: readonly HostedAuthMenuExternalProvider[];
+    walletAlternatives?: WalletAlternatives;
 }): HostedAuthMenuOpenRequest;
 export declare function parseHostedAuthMenuExternalAuthRequest(value: unknown): HostedAuthMenuExternalAuthRequest | null;
 export declare function parseHostedAuthMenuErrorEvent(value: unknown): HostedAuthMenuErrorEvent | null;
@@ -193,10 +200,10 @@ export declare function buildHostedAuthMenuCancelPayload(args: {
     reason: HostedAuthMenuCancelReason;
 }): HostedAuthMenuCancelPayload;
 export declare function parseHostedAuthMenuOutcome(value: unknown): HostedAuthMenuOutcome | null;
-export declare const WALLET_PROTOCOL_VERSION: '19.0.0';
+export declare const WALLET_PROTOCOL_VERSION: '20.0.0';
 export declare const WALLET_IFRAME_PROTOCOL_VERSION_MISMATCH: 'WALLET_IFRAME_PROTOCOL_VERSION_MISMATCH';
 export type WalletProtocolVersion = typeof WALLET_PROTOCOL_VERSION;
-export type ParentToChildType = 'PM_SET_TRANSACTION_VIEW' | 'PM_TRANSACTION_BROADCAST_STARTED' | 'PING' | 'PM_PREPARE_WALLET_RUNTIME' | 'PM_SET_CONFIG' | 'PM_ACTIVATE_TRANSACTION_REVIEW' | 'PM_CANCEL' | 'PM_OPEN_AUTH_MENU' | 'PM_CANCEL_AUTH_MENU' | 'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH' | 'PM_REDEEM_HOSTED_WALLET_SEAMS_SESSION' | 'PM_REGISTER_WALLET' | 'PM_ADD_WALLET_SIGNER' | 'PM_ADD_PASSKEY' | 'PM_ACTIVATE_AUTH_METHOD' | 'PM_GET_AUTH_METHOD_AVAILABILITY' | 'PM_SET_AUTH_METHOD_ENABLED' | 'PM_ADD_EMAIL_OTP' | 'PM_REVOKE_AUTH_METHOD' | 'PM_UNLOCK' | 'PM_UNLOCK_AUTH_METHOD' | 'PM_EXTERNAL_AUTH' | 'PM_EXTERNAL_OWNER_AUTH' | 'PM_LOCK' | 'PM_LOCK_EXACT_WALLET_SESSION' | 'PM_GET_LAST_WALLET_MOVE_REQUEST' | 'PM_MOVE_WALLET' | 'PM_GET_WALLET_MOVE' | 'PM_GET_WALLET_PLACEMENT' | 'PM_GET_WALLET_SESSION' | 'PM_GET_EXACT_WALLET_SESSION_STATE' | 'PM_GET_NEAR_PROVISIONING_STATE' | 'PM_REQUEST_EMAIL_OTP_CHALLENGE' | 'PM_BEGIN_GOOGLE_EMAIL_OTP_WALLET_AUTH' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_RESEND' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_REROLL_WALLET_ID' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_SUBMIT' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_COMPLETE_REGISTRATION' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_CANCEL' | 'PM_GET_WALLET_RECOVERY_CODE_STATUS' | 'PM_ACKNOWLEDGE_WALLET_RECOVERY_CODE_BACKUP' | 'PM_ROTATE_WALLET_RECOVERY_CODES' | 'PM_REQUEST_WALLET_CUSTODY_EMAIL_OTP_CHALLENGE' | 'PM_SIGN_TX_WITH_ACTIONS' | 'PM_OWNER_NEAR_TRANSACTION' | 'PM_SIGN_AND_SEND_TX' | 'PM_SEND_TRANSACTION' | 'PM_SIGN_DELEGATE_ACTION' | 'PM_SIGN_NEP413' | 'PM_SIGN_TEMPO' | 'PM_REPORT_TEMPO_BROADCAST_ACCEPTED' | 'PM_REPORT_TEMPO_BROADCAST_REJECTED' | 'PM_REPORT_TEMPO_FINALIZED' | 'PM_REPORT_TEMPO_DROPPED_OR_REPLACED' | 'PM_RECONCILE_TEMPO_NONCE_LANE' | 'PM_RESOLVE_EXACT_KEY_EXPORT_LANE' | 'PM_EXPORT_KEYPAIR_UI' | 'PM_GET_RECENT_UNLOCKS' | 'PM_SET_CONFIRM_BEHAVIOR' | 'PM_SET_CONFIRMATION_CONFIG' | 'PM_GET_CONFIRMATION_CONFIG' | 'PM_HAS_PASSKEY' | 'PM_LIST_LINKED_DEVICES' | 'PM_REVOKE_LINKED_DEVICE' | 'PM_SCAN_AND_LINK_DEVICE' | 'PM_START_DEVICE2_LINKING_FLOW' | 'PM_DEVICE_LINK_TARGET_FACTOR_ACTION' | 'PM_DEVICE_LINK_EMAIL_OTP_BASE_FACTOR_ACTION' | 'PM_CANCEL_DEVICE_LINKING' | 'PM_SYNC_ACCOUNT_FLOW';
+export type ParentToChildType = 'PM_SET_TRANSACTION_VIEW' | 'PM_TRANSACTION_BROADCAST_STARTED' | 'PING' | 'PM_PREPARE_WALLET_RUNTIME' | 'PM_SET_CONFIG' | 'PM_ACTIVATE_TRANSACTION_REVIEW' | 'PM_CANCEL' | 'PM_OPEN_AUTH_MENU' | 'PM_CANCEL_AUTH_MENU' | 'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH' | 'PM_RESOLVE_WALLET_CONNECTION' | 'PM_REDEEM_HOSTED_WALLET_SEAMS_SESSION' | 'PM_REGISTER_WALLET' | 'PM_ADD_WALLET_SIGNER' | 'PM_ADD_PASSKEY' | 'PM_ACTIVATE_AUTH_METHOD' | 'PM_GET_AUTH_METHOD_AVAILABILITY' | 'PM_SET_AUTH_METHOD_ENABLED' | 'PM_ADD_EMAIL_OTP' | 'PM_REVOKE_AUTH_METHOD' | 'PM_UNLOCK' | 'PM_UNLOCK_AUTH_METHOD' | 'PM_EXTERNAL_AUTH' | 'PM_EXTERNAL_OWNER_AUTH' | 'PM_LOCK' | 'PM_LOCK_EXACT_WALLET_SESSION' | 'PM_GET_LAST_WALLET_MOVE_REQUEST' | 'PM_MOVE_WALLET' | 'PM_GET_WALLET_MOVE' | 'PM_GET_WALLET_PLACEMENT' | 'PM_GET_WALLET_SESSION' | 'PM_GET_EXACT_WALLET_SESSION_STATE' | 'PM_GET_NEAR_PROVISIONING_STATE' | 'PM_REQUEST_EMAIL_OTP_CHALLENGE' | 'PM_BEGIN_GOOGLE_EMAIL_OTP_WALLET_AUTH' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_RESEND' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_REROLL_WALLET_ID' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_SUBMIT' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_COMPLETE_REGISTRATION' | 'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_CANCEL' | 'PM_GET_WALLET_RECOVERY_CODE_STATUS' | 'PM_ACKNOWLEDGE_WALLET_RECOVERY_CODE_BACKUP' | 'PM_ROTATE_WALLET_RECOVERY_CODES' | 'PM_REQUEST_WALLET_CUSTODY_EMAIL_OTP_CHALLENGE' | 'PM_SIGN_TX_WITH_ACTIONS' | 'PM_OWNER_NEAR_TRANSACTION' | 'PM_SIGN_AND_SEND_TX' | 'PM_SEND_TRANSACTION' | 'PM_SIGN_DELEGATE_ACTION' | 'PM_SIGN_NEP413' | 'PM_SIGN_TEMPO' | 'PM_REPORT_TEMPO_BROADCAST_ACCEPTED' | 'PM_REPORT_TEMPO_BROADCAST_REJECTED' | 'PM_REPORT_TEMPO_FINALIZED' | 'PM_REPORT_TEMPO_DROPPED_OR_REPLACED' | 'PM_RECONCILE_TEMPO_NONCE_LANE' | 'PM_RESOLVE_EXACT_KEY_EXPORT_LANE' | 'PM_EXPORT_KEYPAIR_UI' | 'PM_GET_RECENT_UNLOCKS' | 'PM_SET_CONFIRM_BEHAVIOR' | 'PM_SET_CONFIRMATION_CONFIG' | 'PM_GET_CONFIRMATION_CONFIG' | 'PM_HAS_PASSKEY' | 'PM_LIST_LINKED_DEVICES' | 'PM_REVOKE_LINKED_DEVICE' | 'PM_SCAN_AND_LINK_DEVICE' | 'PM_START_DEVICE2_LINKING_FLOW' | 'PM_DEVICE_LINK_TARGET_FACTOR_ACTION' | 'PM_DEVICE_LINK_EMAIL_OTP_BASE_FACTOR_ACTION' | 'PM_CANCEL_DEVICE_LINKING' | 'PM_SYNC_ACCOUNT_FLOW';
 interface RpcEnvelope<T extends string = string, P = unknown> {
     type: T;
     requestId?: string;
@@ -622,7 +629,7 @@ export type ParentToChildEnvelope = RpcEnvelope<'PM_ACTIVATE_TRANSACTION_REVIEW'
     view: 'toast' | 'closed';
 }> | RpcEnvelope<'PM_TRANSACTION_BROADCAST_STARTED', {
     signedTransaction: string;
-}> | RpcEnvelope<'PING'> | RpcEnvelope<'PM_PREPARE_WALLET_RUNTIME'> | RpcEnvelope<'PM_SET_CONFIG', PMSetConfigPayload> | RpcEnvelope<'PM_CANCEL', PMCancelPayload> | RpcEnvelope<'PM_OPEN_AUTH_MENU', PMOpenAuthMenuPayload> | RpcEnvelope<'PM_CANCEL_AUTH_MENU', PMCancelAuthMenuPayload> | RpcEnvelope<'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH', PMResolveAuthMenuExternalAuthPayload> | RpcEnvelope<'PM_REDEEM_HOSTED_WALLET_SEAMS_SESSION', PMRedeemHostedWalletSeamsSessionPayload> | RpcEnvelope<'PM_REGISTER_WALLET', PMRegisterWalletPayload> | RpcEnvelope<'PM_ADD_WALLET_SIGNER', PMAddWalletSignerPayload> | RpcEnvelope<'PM_ADD_PASSKEY', PMAddPasskeyPayload> | RpcEnvelope<'PM_ACTIVATE_AUTH_METHOD', PMActivateAuthMethodPayload> | RpcEnvelope<'PM_GET_AUTH_METHOD_AVAILABILITY', PMActivateAuthMethodPayload> | RpcEnvelope<'PM_SET_AUTH_METHOD_ENABLED', PMActivateAuthMethodPayload & {
+}> | RpcEnvelope<'PING'> | RpcEnvelope<'PM_PREPARE_WALLET_RUNTIME'> | RpcEnvelope<'PM_SET_CONFIG', PMSetConfigPayload> | RpcEnvelope<'PM_CANCEL', PMCancelPayload> | RpcEnvelope<'PM_OPEN_AUTH_MENU', PMOpenAuthMenuPayload> | RpcEnvelope<'PM_CANCEL_AUTH_MENU', PMCancelAuthMenuPayload> | RpcEnvelope<'PM_RESOLVE_AUTH_MENU_EXTERNAL_AUTH', PMResolveAuthMenuExternalAuthPayload> | RpcEnvelope<'PM_RESOLVE_WALLET_CONNECTION', WalletConnectionResolution> | RpcEnvelope<'PM_REDEEM_HOSTED_WALLET_SEAMS_SESSION', PMRedeemHostedWalletSeamsSessionPayload> | RpcEnvelope<'PM_REGISTER_WALLET', PMRegisterWalletPayload> | RpcEnvelope<'PM_ADD_WALLET_SIGNER', PMAddWalletSignerPayload> | RpcEnvelope<'PM_ADD_PASSKEY', PMAddPasskeyPayload> | RpcEnvelope<'PM_ACTIVATE_AUTH_METHOD', PMActivateAuthMethodPayload> | RpcEnvelope<'PM_GET_AUTH_METHOD_AVAILABILITY', PMActivateAuthMethodPayload> | RpcEnvelope<'PM_SET_AUTH_METHOD_ENABLED', PMActivateAuthMethodPayload & {
     enabled: boolean;
 }> | RpcEnvelope<'PM_ADD_EMAIL_OTP', PMAddEmailOtpPayload> | RpcEnvelope<'PM_REVOKE_AUTH_METHOD', PMRevokeAuthMethodPayload> | RpcEnvelope<'PM_UNLOCK', PMUnlockPayload> | RpcEnvelope<'PM_EXTERNAL_AUTH', import('../../../../../shared-ts/src/auth/externalAuth').ExternalAuthCommand> | (RpcEnvelope<'PM_EXTERNAL_OWNER_AUTH', Extract<import('../../../../../shared-ts/src/auth/externalAuth').ExternalAuthCommand, {
     action: 'associate' | 'unlink';
@@ -676,5 +683,5 @@ export type ParentToChildEnvelope = RpcEnvelope<'PM_ACTIVATE_TRANSACTION_REVIEW'
 export type ChildToParentEnvelope = RpcEnvelope<'TRANSACTION_REVIEW_STATE', TransactionReviewStateMessage> | RpcEnvelope<'TRANSACTION_ACTIVITY', 'expanded' | 'toast' | 'closed'> | RpcEnvelope<'READY', ReadyPayload> | RpcEnvelope<'PONG'> | RpcEnvelope<'PROGRESS', ProgressPayload> | RpcEnvelope<'SDK_LIFECYCLE_EVENT', {
     readonly revision: number;
     readonly event: SdkLifecycleEvent;
-}> | RpcEnvelope<'SESSION_CHANGED', WalletIframeExactSessionSnapshot> | RpcEnvelope<'PREFERENCES_CHANGED', PreferencesChangedPayload> | RpcEnvelope<'AUTH_MENU_EXTERNAL_AUTH_REQUEST', HostedAuthMenuExternalAuthRequest> | RpcEnvelope<'AUTH_MENU_ERROR', HostedAuthMenuErrorEvent> | RpcEnvelope<'SURFACE_MEASUREMENT', WalletIframeSurfaceMeasurement> | RpcEnvelope<'PM_RESULT', PMResultPayload> | RpcEnvelope<'ERROR', ErrorPayload>;
+}> | RpcEnvelope<'SESSION_CHANGED', WalletIframeExactSessionSnapshot> | RpcEnvelope<'PREFERENCES_CHANGED', PreferencesChangedPayload> | RpcEnvelope<'AUTH_MENU_EXTERNAL_AUTH_REQUEST', HostedAuthMenuExternalAuthRequest> | RpcEnvelope<'WALLET_CONNECTION_REQUEST', WalletConnectionRequest> | RpcEnvelope<'AUTH_MENU_ERROR', HostedAuthMenuErrorEvent> | RpcEnvelope<'SURFACE_MEASUREMENT', WalletIframeSurfaceMeasurement> | RpcEnvelope<'PM_RESULT', PMResultPayload> | RpcEnvelope<'ERROR', ErrorPayload>;
 //# sourceMappingURL=messages.d.ts.map

package/dist/types/wallet/src/SeamsWeb/walletIframe/shared/walletAlternatives.d.ts

@@ -0,0 +1,52 @@
+import { type HostedAuthMenuSessionId } from './messages';
+import { type WalletIframeRequestId } from '../../../core/types/walletIframeIdentity';
+export type WalletAlternativeDescriptor = Readonly<{
+    id: string;
+    label: string;
+    description: string;
+    icon: string | null;
+}>;
+export type WalletAlternatives = Readonly<{
+    primary: readonly WalletAlternativeDescriptor[];
+    secondary: readonly WalletAlternativeDescriptor[];
+}>;
+export type WalletConnectionRequest = Readonly<{
+    authMenuSessionId: HostedAuthMenuSessionId;
+    connectionRequestId: string;
+    alternativeId: string;
+}>;
+export type WalletConnectionResult = {
+    readonly kind: 'connected';
+    readonly message?: never;
+} | {
+    readonly kind: 'cancelled';
+    readonly message?: never;
+} | {
+    readonly kind: 'failed';
+    readonly message: string;
+};
+export type WalletConnectionResolution = Readonly<{
+    authMenuSessionId: HostedAuthMenuSessionId;
+    connectionRequestId: string;
+    requestId: WalletIframeRequestId;
+    result: WalletConnectionResult;
+}>;
+export type WalletConnectionResolutionInput = Omit<WalletConnectionResolution, 'requestId'>;
+export type WalletConnectionState = {
+    readonly kind: 'idle';
+    readonly request?: never;
+    readonly message?: never;
+} | {
+    readonly kind: 'pending';
+    readonly request: WalletConnectionRequest;
+    readonly message?: never;
+} | {
+    readonly kind: 'failed';
+    readonly message: string;
+    readonly request?: never;
+};
+export declare function emptyWalletAlternatives(): WalletAlternatives;
+export declare function parseWalletAlternatives(value: unknown): WalletAlternatives | null;
+export declare function parseWalletConnectionRequest(value: unknown): WalletConnectionRequest | null;
+export declare function parseWalletConnectionResolution(value: unknown): WalletConnectionResolution | null;
+//# sourceMappingURL=walletAlternatives.d.ts.map

package/dist/types/wallet/src/core/types/seams.d.ts

@@ -168,8 +168,8 @@ export interface SeamsConfigsInput {
     /**
      * Warm signing session persistence mode.
      *
-     * - `none`: no refresh-time persistence (default).
-     * - `sealed_refresh_v1`: sealed refresh persistence via worker + server signing-session seal module.
+     * - `sealed_refresh_v1`: sealed refresh persistence via worker + server signing-session seal module (default).
+     * - `none`: explicitly disable refresh-time persistence.
      */
     signingSessionPersistenceMode?: SigningSessionPersistenceMode;
     /**