@seams/wallet 0.28.0 → 0.30.0

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

@@ -1,3 +1,5 @@
+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';
 import type { TransactionReviewWire, TransactionReviewStateMessage } from './transactionReview';
@@ -16,7 +18,7 @@ import type { TempoSignedResult } from '../../../core/signingEngine/chains/tempo
 import type { KeyExportUiOptions } from '../../../core/signingEngine/flows/recovery/keyExportFlow';
 import type { EvmEip155ChainTarget, NearAccountRef, TempoChainTarget, ThresholdEcdsaChainTarget, WalletSessionRef } from '../../../core/signingEngine/interfaces/ecdsaChainTarget';
 import type { EmailOtpAuthPolicy } from '../../../core/types/seams';
-import type { WalletCustodyAdminOperation } from '../../../../../shared-ts/src/authorization/walletCustodyOperation';
+import type { WalletOwnerAdminOperation } from '../../../../../shared-ts/src/authorization/walletOwnerOperation';
 import type { MpcMaterialActivationRef } from '../../../../../shared-ts/src/utils/domainIds';
 import type { RegistrationTimingSpanV1, SdkLifecycleEvent, WalletFlowEvent } from '../../../core/types/sdkSentEvents';
 import type { GoogleEmailOtpWalletAuthDelivery, GoogleEmailOtpWalletAuthEcdsaTargets, GoogleEmailOtpWalletAuthFailure, GoogleEmailOtpWalletAuthPromptCopy, GoogleEmailOtpWalletAuthRegistrationCompleted, GoogleEmailOtpWalletAuthResolvedMode, GoogleEmailOtpWalletAuthRequestedMode, GoogleEmailOtpWalletAuthSubmitSuccess, RequestEmailCodeInput, WalletRecoveryRotationAuthorization } from '../../publicApi/types';
@@ -95,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';
@@ -141,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;
@@ -181,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;
@@ -192,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: '18.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_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_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;
@@ -264,6 +272,7 @@ type PMGoogleSsoRegistrationAuthMethod = Omit<Extract<EmailOtpRegistrationAuthMe
 };
 export type PMRegistrationAuthMethodInput = PasskeyRegistrationAuthMethodInput | PMEmailOtpChallengeRegistrationAuthMethod | PMGoogleSsoRegistrationAuthMethod;
 interface PMRegisterWalletPayload {
+    completion: import('../../../../../shared-ts/src/utils/registrationIntent').RegistrationCompletion;
     authMethod: PMRegistrationAuthMethodInput;
     wallet: RegisterWalletInput;
     signerSelection: RegistrationSignerSetSelection;
@@ -528,7 +537,7 @@ interface PMWalletRecoverySessionPayload {
 interface PMRequestWalletCustodyEmailOtpChallengePayload {
     walletId: string;
     providerSubjectId: string;
-    operation: WalletCustodyAdminOperation;
+    operation: WalletOwnerAdminOperation;
     payload: Record<string, unknown>;
     requestOrigin?: string;
 }
@@ -594,7 +603,7 @@ export declare function parseDeviceLinkTargetFactorActionPayloadV1(value: unknow
     readonly activationId: string;
     readonly action: DeviceLinkTargetFactorActionV1;
 } | null;
-export type ProgressPayload = WalletFlowEvent | RegistrationTimingSpanV1 | DeviceLinkTargetFactorActivationProgressV1 | DeviceLinkEmailOtpBaseFactorSelectionProgressV1;
+export type ProgressPayload = import('./ownerNearOperation').OwnerNearSubmissionProgress | WalletFlowEvent | RegistrationTimingSpanV1 | DeviceLinkTargetFactorActivationProgressV1 | DeviceLinkEmailOtpBaseFactorSelectionProgressV1;
 export declare function isDeviceLinkTargetFactorActivationProgressV1(value: ProgressPayload): value is DeviceLinkTargetFactorActivationProgressV1;
 export declare function isRegistrationTimingSpanV1(value: unknown): value is RegistrationTimingSpanV1;
 export interface PMResultPayload {
@@ -620,9 +629,15 @@ 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_UNLOCK_AUTH_METHOD', {
+}> | 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';
+}>> & {
+    payload: Extract<import('../../../../../shared-ts/src/auth/externalAuth').ExternalAuthCommand, {
+        action: 'associate' | 'unlink';
+    }>;
+}) | RpcEnvelope<'PM_UNLOCK_AUTH_METHOD', {
     walletId: string;
     walletAuthMethodId: string;
     method: WalletAuthMethodPlugin['kind'];
@@ -638,7 +653,9 @@ export type ParentToChildEnvelope = RpcEnvelope<'PM_ACTIVATE_TRANSACTION_REVIEW'
     readonly moveId: string;
 }> | RpcEnvelope<'PM_GET_WALLET_PLACEMENT', {
     readonly walletId: string;
-}> | RpcEnvelope<'PM_GET_WALLET_SESSION', PMGetWalletSessionPayload> | RpcEnvelope<'PM_GET_EXACT_WALLET_SESSION_STATE', PMGetExactWalletSessionStatePayload> | RpcEnvelope<'PM_GET_NEAR_PROVISIONING_STATE', PMGetNearProvisioningStatePayload> | RpcEnvelope<'PM_REQUEST_EMAIL_OTP_CHALLENGE', PMEmailOtpChallengePayload> | RpcEnvelope<'PM_BEGIN_GOOGLE_EMAIL_OTP_WALLET_AUTH', PMGoogleEmailOtpWalletAuthStartPayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_RESEND', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_REROLL_WALLET_ID', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_SUBMIT', PMGoogleEmailOtpWalletAuthSubmitPayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_COMPLETE_REGISTRATION', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_CANCEL', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GET_WALLET_RECOVERY_CODE_STATUS', PMWalletRecoveryOwnerPayload> | RpcEnvelope<'PM_ACKNOWLEDGE_WALLET_RECOVERY_CODE_BACKUP', PMWalletRecoveryOwnerPayload> | RpcEnvelope<'PM_ROTATE_WALLET_RECOVERY_CODES', PMRotateWalletRecoveryCodesPayload> | RpcEnvelope<'PM_REQUEST_WALLET_CUSTODY_EMAIL_OTP_CHALLENGE', PMRequestWalletCustodyEmailOtpChallengePayload> | RpcEnvelope<'PM_SIGN_TX_WITH_ACTIONS', PMSignTxPayload> | ReviewedTransactionEnvelope<RpcEnvelope<'PM_SIGN_AND_SEND_TX', PMSignAndSendTxPayload>> | RpcEnvelope<'PM_SEND_TRANSACTION', PMSendTxPayload> | RpcEnvelope<'PM_SIGN_DELEGATE_ACTION', PMSignDelegateActionPayload> | RpcEnvelope<'PM_SIGN_NEP413', PMSignNep413Payload> | ReviewedTransactionEnvelope<RpcEnvelope<'PM_SIGN_TEMPO', PMSignTempoPayload>> | RpcEnvelope<'PM_REPORT_TEMPO_BROADCAST_ACCEPTED', PMReportTempoBroadcastAcceptedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_BROADCAST_REJECTED', PMReportTempoBroadcastRejectedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_FINALIZED', PMReportTempoFinalizedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_DROPPED_OR_REPLACED', PMReportTempoDroppedOrReplacedPayload> | RpcEnvelope<'PM_RECONCILE_TEMPO_NONCE_LANE', PMReconcileTempoNonceLanePayload> | RpcEnvelope<'PM_RESOLVE_EXACT_KEY_EXPORT_LANE', PMResolveExactKeyExportLanePayload> | RpcEnvelope<'PM_EXPORT_KEYPAIR_UI', PMExportKeypairUiPayload> | RpcEnvelope<'PM_GET_RECENT_UNLOCKS'> | RpcEnvelope<'PM_SET_CONFIRM_BEHAVIOR', PMSetConfirmBehaviorPayload> | RpcEnvelope<'PM_SET_CONFIRMATION_CONFIG', PMSetConfirmationConfigPayload> | RpcEnvelope<'PM_GET_CONFIRMATION_CONFIG'> | RpcEnvelope<'PM_HAS_PASSKEY', PMHasPasskeyPayload> | RpcEnvelope<'PM_LIST_LINKED_DEVICES', PMListLinkedDevicesPayload> | RpcEnvelope<'PM_REVOKE_LINKED_DEVICE', PMRevokeLinkedDevicePayload> | RpcEnvelope<'PM_SCAN_AND_LINK_DEVICE', {
+}> | RpcEnvelope<'PM_GET_WALLET_SESSION', PMGetWalletSessionPayload> | RpcEnvelope<'PM_GET_EXACT_WALLET_SESSION_STATE', PMGetExactWalletSessionStatePayload> | RpcEnvelope<'PM_GET_NEAR_PROVISIONING_STATE', PMGetNearProvisioningStatePayload> | RpcEnvelope<'PM_REQUEST_EMAIL_OTP_CHALLENGE', PMEmailOtpChallengePayload> | RpcEnvelope<'PM_BEGIN_GOOGLE_EMAIL_OTP_WALLET_AUTH', PMGoogleEmailOtpWalletAuthStartPayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_RESEND', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_REROLL_WALLET_ID', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_SUBMIT', PMGoogleEmailOtpWalletAuthSubmitPayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_COMPLETE_REGISTRATION', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GOOGLE_EMAIL_OTP_WALLET_AUTH_CANCEL', PMGoogleEmailOtpWalletAuthHandlePayload> | RpcEnvelope<'PM_GET_WALLET_RECOVERY_CODE_STATUS', PMWalletRecoveryOwnerPayload> | RpcEnvelope<'PM_ACKNOWLEDGE_WALLET_RECOVERY_CODE_BACKUP', PMWalletRecoveryOwnerPayload> | RpcEnvelope<'PM_ROTATE_WALLET_RECOVERY_CODES', PMRotateWalletRecoveryCodesPayload> | RpcEnvelope<'PM_REQUEST_WALLET_CUSTODY_EMAIL_OTP_CHALLENGE', PMRequestWalletCustodyEmailOtpChallengePayload> | (RpcEnvelope<'PM_OWNER_NEAR_TRANSACTION', OwnerNearCommand> & {
+    payload: OwnerNearCommand;
+}) | RpcEnvelope<'PM_SIGN_TX_WITH_ACTIONS', PMSignTxPayload> | ReviewedTransactionEnvelope<RpcEnvelope<'PM_SIGN_AND_SEND_TX', PMSignAndSendTxPayload>> | RpcEnvelope<'PM_SEND_TRANSACTION', PMSendTxPayload> | RpcEnvelope<'PM_SIGN_DELEGATE_ACTION', PMSignDelegateActionPayload> | RpcEnvelope<'PM_SIGN_NEP413', PMSignNep413Payload> | ReviewedTransactionEnvelope<RpcEnvelope<'PM_SIGN_TEMPO', PMSignTempoPayload>> | RpcEnvelope<'PM_REPORT_TEMPO_BROADCAST_ACCEPTED', PMReportTempoBroadcastAcceptedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_BROADCAST_REJECTED', PMReportTempoBroadcastRejectedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_FINALIZED', PMReportTempoFinalizedPayload> | RpcEnvelope<'PM_REPORT_TEMPO_DROPPED_OR_REPLACED', PMReportTempoDroppedOrReplacedPayload> | RpcEnvelope<'PM_RECONCILE_TEMPO_NONCE_LANE', PMReconcileTempoNonceLanePayload> | RpcEnvelope<'PM_RESOLVE_EXACT_KEY_EXPORT_LANE', PMResolveExactKeyExportLanePayload> | RpcEnvelope<'PM_EXPORT_KEYPAIR_UI', PMExportKeypairUiPayload> | RpcEnvelope<'PM_GET_RECENT_UNLOCKS'> | RpcEnvelope<'PM_SET_CONFIRM_BEHAVIOR', PMSetConfirmBehaviorPayload> | RpcEnvelope<'PM_SET_CONFIRMATION_CONFIG', PMSetConfirmationConfigPayload> | RpcEnvelope<'PM_GET_CONFIRMATION_CONFIG'> | RpcEnvelope<'PM_HAS_PASSKEY', PMHasPasskeyPayload> | RpcEnvelope<'PM_LIST_LINKED_DEVICES', PMListLinkedDevicesPayload> | RpcEnvelope<'PM_REVOKE_LINKED_DEVICE', PMRevokeLinkedDevicePayload> | RpcEnvelope<'PM_SCAN_AND_LINK_DEVICE', {
     qrData: QrLinkedDeviceSessionPayloadV5;
     options?: {
         confirmationConfig?: Partial<ConfirmationConfig>;
@@ -666,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/ownerNearOperation.d.ts

@@ -0,0 +1,51 @@
+import { type SigningOperationId } from '../../../core/signingEngine/session/operationState/types';
+import { type WalletId } from '../../../../../shared-ts/src/utils/domainIds';
+import { type AccountId } from '../../../core/types/accountIds';
+import { type TransactionInputWasm } from '../../../core/types/actions';
+import type { ActionResult } from '../../../core/types/seams';
+import { type ExternalWalletAuthentication } from '../../../../../shared-ts/src/auth/externalAuth';
+import type { ReadonlyExclusiveUnion } from '../../../../../shared-ts/src/utils/variant';
+export type OwnerNearRecovery = Readonly<{
+    operationId: SigningOperationId;
+    walletId: WalletId;
+    nearAccountId: AccountId;
+}>;
+export type OwnerNearCommand = Readonly<{
+    authentication: ExternalWalletAuthentication;
+    recovery: OwnerNearRecovery;
+}> & ReadonlyExclusiveUnion<{
+    action: 'approve';
+    transaction: TransactionInputWasm;
+    expiresAtMs: number;
+} | {
+    action: 'recover';
+}>;
+export type OwnerNearOutcome = ReadonlyExclusiveUnion<{
+    kind: 'completed';
+    result: Extract<ActionResult, {
+        success: true;
+    }>;
+} | {
+    kind: 'reverted';
+    transactionId: string;
+    error: string;
+} | {
+    kind: 'cancelled';
+} | {
+    kind: 'expired';
+} | {
+    kind: 'unknown';
+    recovery: OwnerNearRecovery;
+} | {
+    kind: 'failed';
+    error: string;
+}>;
+export declare function parseOwnerNearRecovery(raw: unknown): OwnerNearRecovery;
+export declare function parseOwnerNearCommand(raw: unknown): OwnerNearCommand;
+export declare function parseOwnerNearOutcome(raw: unknown): OwnerNearOutcome;
+export type OwnerNearSubmissionProgress = Readonly<{
+    event: 'owner_near_submitting';
+    operationId: SigningOperationId;
+}>;
+export declare function parseOwnerNearSubmissionProgress(raw: unknown): OwnerNearSubmissionProgress | null;
+//# sourceMappingURL=ownerNearOperation.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/indexedDB/seamsWalletDB/registrationSetup.d.ts

@@ -24,6 +24,7 @@ export declare class RegistrationSetupRepository {
     private readonly manager;
     constructor(manager: SeamsWalletDBManager);
     begin(scopeDigest: string, request: {
+        readonly completion: import('../../../../../shared-ts/src/utils/registrationIntent').RegistrationCompletion;
         readonly wallet: RegisterWalletInput;
         readonly authMethod: RegistrationAuthMethodInput;
         readonly signerSelection: RegistrationSignerSetSelection;

package/dist/types/wallet/src/core/indexedDB/seamsWalletDB/repositories.d.ts

@@ -177,6 +177,10 @@ export type StoreWalletRegistrationPublicationInputV1 = Omit<StoreWalletRegistra
     };
 };
 type WalletRegistrationSessionPublicationV1 = {
+    readonly kind: 'owner_operations';
+    readonly walletSession?: never;
+    readonly operationCredential?: never;
+} | {
     readonly kind: 'issued';
     readonly walletSession: ActiveWalletSessionV1;
     readonly operationCredential: WalletSessionOperationCredentialV1;

package/dist/types/wallet/src/core/rpcClients/near/NearClient.d.ts

@@ -39,4 +39,8 @@ export declare class MinimalNearClient extends NearJsonRpcClient<SignedTransacti
     protected errorFromHttpStatus(response: Response): Error;
     protected sendWithRetry<T>(send: () => Promise<T>): Promise<T>;
 }
+/** An owner operation records its hash before one broadcast and then recovers by status. */
+export declare class OwnerOperationNearClient extends MinimalNearClient {
+    protected sendWithRetry<T>(send: () => Promise<T>): Promise<T>;
+}
 //# sourceMappingURL=NearClient.d.ts.map

package/dist/types/wallet/src/core/rpcClients/relayer/walletRecoveryRotate.d.ts

@@ -1,5 +1,5 @@
 import { type WalletRecoverySetRotationWireV1 } from '../../../../../shared-ts/src/wallet-recovery/walletRecoveryEnvelopeSet';
-import type { WalletCustodyAdminOperation } from '../../../../../shared-ts/src/authorization/walletCustodyOperation';
+import type { WalletOwnerAdminOperation } from '../../../../../shared-ts/src/authorization/walletOwnerOperation';
 import type { WebAuthnAuthenticationCredential } from '../../types/webauthn';
 export type WalletCustodyFactorProof = {
     readonly kind: 'passkey';
@@ -32,7 +32,7 @@ export declare function requestWalletCustodyEmailOtpChallenge(args: {
     readonly relayUrl: string;
     readonly walletId: string;
     readonly providerSubjectId: string;
-    readonly operation: WalletCustodyAdminOperation;
+    readonly operation: WalletOwnerAdminOperation;
     readonly payload: Record<string, unknown>;
     readonly requestOrigin?: string;
     readonly fetchImpl?: typeof fetch;

package/dist/types/wallet/src/core/rpcClients/relayer/walletRegistration.d.ts

@@ -502,6 +502,7 @@ export type WalletEcdsaKeyFactsInventoryResponse = {
 export declare function setupWalletRegistration(args: {
     relayerUrl: string;
     request: {
+        completion?: RegistrationIntentV1['completion'];
         wallet?: RegisterWalletInput;
         signerSelection: CreateRegistrationIntentRequest['signerSelection'];
         authMethod: CreateRegistrationIntentRequest['authMethod'];

package/dist/types/wallet/src/core/signingEngine/session/passkey/ed25519YaoLocalMaterial.d.ts

@@ -1,3 +1,4 @@
+import type { KeyMaterialRecord } from '../../../indexedDB/keyMaterial.types';
 import { type AccountKeyMaterialDeps } from '../../../indexedDB/accountKeyMaterial';
 import type { NearEd25519YaoOperationMaterial, NearResolvedEd25519SigningSessionState } from '../../interfaces/near';
 import { type ThresholdRuntimePolicyScope } from '../../threshold/sessionPolicy';
@@ -5,6 +6,7 @@ import { type RouterAbEd25519NormalSigningState } from '../../threshold/ed25519/
 import { type RouterAbEd25519YaoActiveClientV1, type RouterAbEd25519YaoSealableActiveClientV1 } from '../../threshold/ed25519/yaoClient';
 import { type MpcMaterialActivationRef } from '../../../../../../shared-ts/src/utils/domainIds';
 import { type NearEd25519YaoPublicLocatorObservationV1 } from '../material/nearEd25519YaoMaterialActivation';
+import type { RouterAbEd25519YaoRecoveryActivationReceiptV1 } from '../../../../../../shared-ts/src/utils/routerAbEd25519Yao';
 import { type WalletAuthAuthorityRef } from '../../../../../../shared-ts/src/utils/walletAuthAuthority';
 import { buildRestorableMpcMaterialRefInternal } from '../material/restorableMpcMaterialRef.internal';
 import type { MpcCapabilityHydrationPlan } from '../material/mpcCapabilityHydration';
@@ -62,6 +64,11 @@ type PersistPasskeyEd25519YaoSignerMaterialInputV1 = {
     stableServerScope: PasskeyEd25519YaoStableServerScopeV1;
     passkeyPrfFirstB64u: string;
 };
+type PasskeyEd25519YaoLocalMaterialTargetV1 = {
+    profileId: string;
+    chainIdKey: string;
+    accountAddress: string;
+};
 type HydratePasskeyEd25519YaoLocalMaterialResultV1 = {
     kind: 'live';
     plan: Extract<MpcCapabilityHydrationPlan, {
@@ -107,6 +114,20 @@ export type PasskeyEd25519YaoPublicLocatorObservationV1 = Omit<Extract<NearEd255
     kind: 'available';
 }>;
 export declare function ed25519YaoLocalMaterialIdentityFromWalletSession(walletSessionState: NearResolvedEd25519SigningSessionState, rpId: string, credentialIdB64u: string): Ed25519YaoLocalMaterialIdentity;
+export declare function buildPasskeyEd25519YaoLocalMaterialRecordV1(input: {
+    target: PasskeyEd25519YaoLocalMaterialTargetV1;
+    activeClient: RouterAbEd25519YaoSealableActiveClientV1;
+    identity: Ed25519YaoLocalMaterialIdentity;
+    stableServerScope: PasskeyEd25519YaoStableServerScopeV1;
+    ownedPasskeyPrfFirst: Uint8Array;
+    lifecycle: {
+        kind: 'registration_or_rehydration';
+        promotionReceipt?: never;
+    } | {
+        kind: 'recovery_promotion';
+        promotionReceipt: RouterAbEd25519YaoRecoveryActivationReceiptV1;
+    };
+}): KeyMaterialRecord;
 export declare function persistPasskeyEd25519YaoSignerMaterialV1(input: PersistPasskeyEd25519YaoSignerMaterialInputV1): Promise<void>;
 export declare function readPasskeyEd25519YaoLocalMaterialLocatorV1(input: ReadPasskeyEd25519YaoLocalMaterialLocatorInputV1): Promise<ReadPasskeyEd25519YaoLocalMaterialLocatorResultV1>;
 export declare function preparePasskeyEd25519YaoLocalMaterialRehydrationV1(input: {

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;
     /**
@@ -475,6 +475,13 @@ export type RegistrationNearProvisioningState = {
     errorCode: NearProvisioningErrorCode;
 };
 export type RegistrationResult = {
+    readonly success: true;
+    readonly kind: 'wallet_owner_registered';
+    readonly walletId: WalletId;
+    readonly capabilities: readonly [RegisteredNearEd25519Capability];
+    readonly error?: never;
+    readonly errorCode?: never;
+} | {
     readonly success: true;
     readonly kind: 'wallet_registered';
     readonly walletId: WalletId;