@metamask-previews/seedless-onboarding-controller 0.0.0-preview-c4b7ea2e → 0.0.0-preview-e9f8bc88

package/dist/SeedlessOnboardingController.cjs

@@ -10,13 +10,14 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _SeedlessOnboardingController_instances, _SeedlessOnboardingController_vaultEncryptor, _SeedlessOnboardingController_vaultOperationMutex, _SeedlessOnboardingController_isUnlocked, _SeedlessOnboardingController_setUnlocked, _SeedlessOnboardingController_persistOprfKey, _SeedlessOnboardingController_recoverEncKey, _SeedlessOnboardingController_changeEncryptionKey, _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup, _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey, _SeedlessOnboardingController_withPersistedSeedPhraseBackupsState, _SeedlessOnboardingController_filterDupesAndUpdateSocialBackupsMetadata, _SeedlessOnboardingController_createNewVaultWithAuthData, _SeedlessOnboardingController_updateVault, _SeedlessOnboardingController_withVaultLock, _SeedlessOnboardingController_serializeKeyData, _SeedlessOnboardingController_parseVaultData, _SeedlessOnboardingController_assertIsUnlocked, _SeedlessOnboardingController_assertIsAuthenticatedUser, _SeedlessOnboardingController_assertIsValidVaultData;
+var _SeedlessOnboardingController_instances, _SeedlessOnboardingController_vaultEncryptor, _SeedlessOnboardingController_controllerOperationMutex, _SeedlessOnboardingController_vaultOperationMutex, _SeedlessOnboardingController_isUnlocked, _SeedlessOnboardingController_recoverPassword, _SeedlessOnboardingController_setUnlocked, _SeedlessOnboardingController_persistOprfKey, _SeedlessOnboardingController_persistAuthPubKey, _SeedlessOnboardingController_recoverAuthPubKey, _SeedlessOnboardingController_recoverEncKey, _SeedlessOnboardingController_changeEncryptionKey, _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup, _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey, _SeedlessOnboardingController_withPersistedSeedPhraseBackupsState, _SeedlessOnboardingController_filterDupesAndUpdateSocialBackupsMetadata, _SeedlessOnboardingController_createNewVaultWithAuthData, _SeedlessOnboardingController_updateVault, _SeedlessOnboardingController_withControllerLock, _SeedlessOnboardingController_withVaultLock, _SeedlessOnboardingController_serializeKeyData, _SeedlessOnboardingController_parseVaultData, _SeedlessOnboardingController_assertIsUnlocked, _SeedlessOnboardingController_assertIsAuthenticatedUser, _SeedlessOnboardingController_assertIsSRPBackedUpUser, _SeedlessOnboardingController_assertPasswordInSync, _SeedlessOnboardingController_resetPasswordOutdatedCache, _SeedlessOnboardingController_assertIsValidVaultData;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SeedlessOnboardingController = exports.getDefaultSeedlessOnboardingControllerState = void 0;
 const auth_network_utils_1 = require("@metamask/auth-network-utils");
 const base_controller_1 = require("@metamask/base-controller");
 const toprf_secure_backup_1 = require("@metamask/toprf-secure-backup");
 const utils_1 = require("@metamask/utils");
+const secp256k1_1 = require("@noble/curves/secp256k1");
 const async_mutex_1 = require("async-mutex");
 const constants_1 = require("./constants.cjs");
 const errors_1 = require("./errors.cjs");
@@ -51,7 +52,7 @@ const seedlessOnboardingMetadata = {
         anonymous: true,
     },
     nodeAuthTokens: {
-        persist: false,
+        persist: true,
         anonymous: true,
     },
     authConnection: {
@@ -82,6 +83,14 @@ const seedlessOnboardingMetadata = {
         persist: false,
         anonymous: true,
     },
+    authPubKey: {
+        persist: true,
+        anonymous: true,
+    },
+    passwordOutdatedCache: {
+        persist: true,
+        anonymous: true,
+    },
 };
 class SeedlessOnboardingController extends base_controller_1.BaseController {
     /**
@@ -105,6 +114,7 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
         });
         _SeedlessOnboardingController_instances.add(this);
         _SeedlessOnboardingController_vaultEncryptor.set(this, void 0);
+        _SeedlessOnboardingController_controllerOperationMutex.set(this, new async_mutex_1.Mutex());
         _SeedlessOnboardingController_vaultOperationMutex.set(this, new async_mutex_1.Mutex());
         /**
          * Controller lock state.
@@ -140,35 +150,37 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
      * @returns A promise that resolves to the authentication result.
      */
     async authenticate(params) {
-        try {
-            const { idTokens, authConnectionId, groupedAuthConnectionId, userId, authConnection, socialLoginEmail, } = params;
-            const hashedIdTokenHexes = idTokens.map((idToken) => {
-                return (0, utils_1.remove0x)((0, auth_network_utils_1.keccak256AndHexify)((0, utils_1.stringToBytes)(idToken)));
-            });
-            const authenticationResult = await this.toprfClient.authenticate({
-                authConnectionId: groupedAuthConnectionId || authConnectionId,
-                userId,
-                idTokens: hashedIdTokenHexes,
-                groupedAuthConnectionParams: {
-                    authConnectionId,
-                    idTokens,
-                },
-            });
-            // update the state with the authenticated user info
-            this.update((state) => {
-                state.nodeAuthTokens = authenticationResult.nodeAuthTokens;
-                state.authConnectionId = authConnectionId;
-                state.groupedAuthConnectionId = groupedAuthConnectionId;
-                state.userId = userId;
-                state.authConnection = authConnection;
-                state.socialLoginEmail = socialLoginEmail;
-            });
-            return authenticationResult;
-        }
-        catch (error) {
-            log('Error authenticating user', error);
-            throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.AuthenticationError);
-        }
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            try {
+                const { idTokens, authConnectionId, groupedAuthConnectionId, userId, authConnection, socialLoginEmail, } = params;
+                const hashedIdTokenHexes = idTokens.map((idToken) => {
+                    return (0, utils_1.remove0x)((0, auth_network_utils_1.keccak256AndHexify)((0, utils_1.stringToBytes)(idToken)));
+                });
+                const authenticationResult = await this.toprfClient.authenticate({
+                    authConnectionId: groupedAuthConnectionId || authConnectionId,
+                    userId,
+                    idTokens: hashedIdTokenHexes,
+                    groupedAuthConnectionParams: {
+                        authConnectionId,
+                        idTokens,
+                    },
+                });
+                // update the state with the authenticated user info
+                this.update((state) => {
+                    state.nodeAuthTokens = authenticationResult.nodeAuthTokens;
+                    state.authConnectionId = authConnectionId;
+                    state.groupedAuthConnectionId = groupedAuthConnectionId;
+                    state.userId = userId;
+                    state.authConnection = authConnection;
+                    state.socialLoginEmail = socialLoginEmail;
+                });
+                return authenticationResult;
+            }
+            catch (error) {
+                log('Error authenticating user', error);
+                throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.AuthenticationError);
+            }
+        });
     }
     /**
      * Create a new TOPRF encryption key using given password and backups the provided seed phrase.
@@ -182,27 +194,32 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
         // to make sure that fail fast,
         // assert that the user is authenticated before creating the TOPRF key and backing up the seed phrase
         __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsAuthenticatedUser).call(this, this.state);
-        // locally evaluate the encryption key from the password
-        const { encKey, authKeyPair, oprfKey } = this.toprfClient.createLocalKey({
-            password,
-        });
-        // encrypt and store the seed phrase backup
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup).call(this, {
-            keyringId,
-            seedPhrase,
-            encKey,
-            authKeyPair,
-        });
-        // store/persist the encryption key shares
-        // We store the seed phrase metadata in the metadata store first. If this operation fails,
-        // we avoid persisting the encryption key shares to prevent a situation where a user appears
-        // to have an account but with no associated data.
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistOprfKey).call(this, oprfKey, authKeyPair.pk);
-        // create a new vault with the resulting authentication data
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
-            password,
-            rawToprfEncryptionKey: encKey,
-            rawToprfAuthKeyPair: authKeyPair,
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            // locally evaluate the encryption key from the password
+            const { encKey, authKeyPair, oprfKey } = this.toprfClient.createLocalKey({
+                password,
+            });
+            // encrypt and store the seed phrase backup
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup).call(this, {
+                keyringId,
+                seedPhrase,
+                encKey,
+                authKeyPair,
+            });
+            // store/persist the encryption key shares
+            // We store the seed phrase metadata in the metadata store first. If this operation fails,
+            // we avoid persisting the encryption key shares to prevent a situation where a user appears
+            // to have an account but with no associated data.
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistOprfKey).call(this, oprfKey, authKeyPair.pk);
+            // create a new vault with the resulting authentication data
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
+                password,
+                rawToprfEncryptionKey: encKey,
+                rawToprfAuthKeyPair: authKeyPair,
+            });
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistAuthPubKey).call(this, {
+                authPubKey: authKeyPair.pk,
+            });
         });
     }
     /**
@@ -213,15 +230,21 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
      * @returns A promise that resolves to the success of the operation.
      */
     async addNewSeedPhraseBackup(seedPhrase, keyringId) {
-        __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
-        // verify the password and unlock the vault
-        const { toprfEncryptionKey, toprfAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this);
-        // encrypt and store the seed phrase backup
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup).call(this, {
-            keyringId,
-            seedPhrase,
-            encKey: toprfEncryptionKey,
-            authKeyPair: toprfAuthKeyPair,
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertPasswordInSync).call(this, {
+                skipCache: true,
+                skipLock: true, // skip lock since we already have the lock
+            });
+            // verify the password and unlock the vault
+            const { toprfEncryptionKey, toprfAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this);
+            // encrypt and store the seed phrase backup
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_encryptAndStoreSeedPhraseBackup).call(this, {
+                keyringId,
+                seedPhrase,
+                encKey: toprfEncryptionKey,
+                authKeyPair: toprfAuthKeyPair,
+            });
         });
     }
     /**
@@ -235,40 +258,45 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
     async fetchAllSeedPhrases(password) {
         // assert that the user is authenticated before fetching the seed phrases
         __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsAuthenticatedUser).call(this, this.state);
-        let encKey;
-        let authKeyPair;
-        if (password) {
-            const recoverEncKeyResult = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverEncKey).call(this, password);
-            encKey = recoverEncKeyResult.encKey;
-            authKeyPair = recoverEncKeyResult.authKeyPair;
-        }
-        else {
-            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
-            // verify the password and unlock the vault
-            const { toprfEncryptionKey, toprfAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this);
-            encKey = toprfEncryptionKey;
-            authKeyPair = toprfAuthKeyPair;
-        }
-        try {
-            const secretData = await this.toprfClient.fetchAllSecretDataItems({
-                decKey: encKey,
-                authKeyPair,
-            });
-            if (secretData?.length > 0 && password) {
-                // if password is provided, we need to create a new vault with the auth data. (supposedly the user is trying to rehydrate the wallet)
-                await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
-                    password,
-                    rawToprfEncryptionKey: encKey,
-                    rawToprfAuthKeyPair: authKeyPair,
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            let encKey;
+            let authKeyPair;
+            if (password) {
+                const recoverEncKeyResult = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverEncKey).call(this, password);
+                encKey = recoverEncKeyResult.encKey;
+                authKeyPair = recoverEncKeyResult.authKeyPair;
+            }
+            else {
+                __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
+                // verify the password and unlock the vault
+                const keysFromVault = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this);
+                encKey = keysFromVault.toprfEncryptionKey;
+                authKeyPair = keysFromVault.toprfAuthKeyPair;
+            }
+            try {
+                const secretData = await this.toprfClient.fetchAllSecretDataItems({
+                    decKey: encKey,
+                    authKeyPair,
                 });
+                if (secretData?.length > 0 && password) {
+                    // if password is provided, we need to create a new vault with the auth data. (supposedly the user is trying to rehydrate the wallet)
+                    await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
+                        password,
+                        rawToprfEncryptionKey: encKey,
+                        rawToprfAuthKeyPair: authKeyPair,
+                    });
+                    __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistAuthPubKey).call(this, {
+                        authPubKey: authKeyPair.pk,
+                    });
+                }
+                const secrets = SecretMetadata_1.SecretMetadata.parseSecretsFromMetadataStore(secretData, constants_1.SecretType.Mnemonic);
+                return secrets.map((secret) => secret.data);
             }
-            const secrets = SecretMetadata_1.SecretMetadata.parseSecretsFromMetadataStore(secretData, constants_1.SecretType.Mnemonic);
-            return secrets.map((secret) => secret.data);
-        }
-        catch (error) {
-            log('Error fetching seed phrase metadata', error);
-            throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.FailedToFetchSeedPhraseMetadata);
-        }
+            catch (error) {
+                log('Error fetching seed phrase metadata', error);
+                throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.FailedToFetchSeedPhraseMetadata);
+            }
+        });
     }
     /**
      * Update the password of the seedless onboarding flow.
@@ -277,25 +305,38 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
      *
      * @param newPassword - The new password to update.
      * @param oldPassword - The old password to verify.
+     * @returns A promise that resolves to the success of the operation.
      */
     async changePassword(newPassword, oldPassword) {
-        __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
-        // verify the old password of the encrypted vault
-        await this.verifyPassword(oldPassword);
-        try {
-            // update the encryption key with new password and update the Metadata Store
-            const { encKey: newEncKey, authKeyPair: newAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_changeEncryptionKey).call(this, newPassword, oldPassword);
-            // update and encrypt the vault with new password
-            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
-                password: newPassword,
-                rawToprfEncryptionKey: newEncKey,
-                rawToprfAuthKeyPair: newAuthKeyPair,
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsUnlocked).call(this);
+            // verify the old password of the encrypted vault
+            await this.verifyVaultPassword(oldPassword, {
+                skipLock: true, // skip lock since we already have the lock
             });
-        }
-        catch (error) {
-            log('Error changing password', error);
-            throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.FailedToChangePassword);
-        }
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertPasswordInSync).call(this, {
+                skipCache: true,
+                skipLock: true, // skip lock since we already have the lock
+            });
+            try {
+                // update the encryption key with new password and update the Metadata Store
+                const { encKey: newEncKey, authKeyPair: newAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_changeEncryptionKey).call(this, newPassword, oldPassword);
+                // update and encrypt the vault with new password
+                await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
+                    password: newPassword,
+                    rawToprfEncryptionKey: newEncKey,
+                    rawToprfAuthKeyPair: newAuthKeyPair,
+                });
+                __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistAuthPubKey).call(this, {
+                    authPubKey: newAuthKeyPair.pk,
+                });
+                __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_resetPasswordOutdatedCache).call(this);
+            }
+            catch (error) {
+                log('Error changing password', error);
+                throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.FailedToChangePassword);
+            }
+        });
     }
     /**
      * Update the backup metadata state for the given seed phrase.
@@ -312,13 +353,21 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
      * Verify the password validity by decrypting the vault.
      *
      * @param password - The password to verify.
+     * @param options - Optional options object.
+     * @param options.skipLock - Whether to skip the lock acquisition.
+     * @returns A promise that resolves to the success of the operation.
      * @throws {Error} If the password is invalid or the vault is not initialized.
      */
-    async verifyPassword(password) {
-        if (!this.state.vault) {
-            throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.VaultError);
-        }
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_vaultEncryptor, "f").decrypt(password, this.state.vault);
+    async verifyVaultPassword(password, options) {
+        const doVerify = async () => {
+            if (!this.state.vault) {
+                throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.VaultError);
+            }
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_vaultEncryptor, "f").decrypt(password, this.state.vault);
+        };
+        return options?.skipLock
+            ? await doVerify()
+            : await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, doVerify);
     }
     /**
      * Get the hash of the seed phrase backup for the given seed phrase, from the state.
@@ -341,10 +390,13 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
      * This operation is useful when user performs some actions that requires the user password/encryption key. e.g. add new srp backup
      *
      * @param password - The password to submit.
+     * @returns A promise that resolves to the success of the operation.
      */
     async submitPassword(password) {
-        await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this, password);
-        __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_setUnlocked).call(this);
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_unlockVaultAndGetBackupEncKey).call(this, password);
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_setUnlocked).call(this);
+        });
     }
     /**
      * Set the controller to locked state, and deallocate the secrets (vault encryption key and salt).
@@ -358,6 +410,98 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
         });
         __classPrivateFieldSet(this, _SeedlessOnboardingController_isUnlocked, false, "f");
     }
+    /**
+     * Sync the latest global password to the controller.
+     * reset vault with latest globalPassword,
+     * persist the latest global password authPubKey
+     *
+     * @param params - The parameters for syncing the latest global password.
+     * @param params.oldPassword - The old password to verify.
+     * @param params.globalPassword - The latest global password.
+     * @returns A promise that resolves to the success of the operation.
+     */
+    async syncLatestGlobalPassword({ oldPassword, globalPassword, }) {
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            // verify correct old password
+            await this.verifyVaultPassword(oldPassword, {
+                skipLock: true, // skip lock since we already have the lock
+            });
+            // update vault with latest globalPassword
+            const { encKey, authKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverEncKey).call(this, globalPassword);
+            // update and encrypt the vault with new password
+            await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_createNewVaultWithAuthData).call(this, {
+                password: globalPassword,
+                rawToprfEncryptionKey: encKey,
+                rawToprfAuthKeyPair: authKeyPair,
+            });
+            // persist the latest global password authPubKey
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_persistAuthPubKey).call(this, {
+                authPubKey: authKeyPair.pk,
+            });
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_resetPasswordOutdatedCache).call(this);
+        });
+    }
+    /**
+     * @description Fetch the password corresponding to the current authPubKey in state (current device password which is already out of sync with the current global password).
+     * then we use this recovered old password to unlock the vault and set the password to the new global password.
+     *
+     * @param params - The parameters for fetching the password.
+     * @param params.globalPassword - The latest global password.
+     * @returns A promise that resolves to the password corresponding to the current authPubKey in state.
+     */
+    async recoverCurrentDevicePassword({ globalPassword, }) {
+        return await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, async () => {
+            const currentDeviceAuthPubKey = __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverAuthPubKey).call(this);
+            const { password: currentDevicePassword } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverPassword).call(this, {
+                targetPwPubKey: currentDeviceAuthPubKey,
+                globalPassword,
+            });
+            return {
+                password: currentDevicePassword,
+            };
+        });
+    }
+    /**
+     * @description Check if the current password is outdated compare to the global password.
+     *
+     * @param options - Optional options object.
+     * @param options.skipCache - If true, bypass the cache and force a fresh check.
+     * @param options.skipLock - Whether to skip the lock acquisition.
+     * @returns A promise that resolves to true if the password is outdated, false otherwise.
+     */
+    async checkIsPasswordOutdated(options) {
+        // cache result to reduce load on infra
+        // Check cache first unless skipCache is true
+        if (!options?.skipCache) {
+            const { passwordOutdatedCache } = this.state;
+            const now = Date.now();
+            const isCacheValid = passwordOutdatedCache &&
+                now - passwordOutdatedCache.timestamp < constants_1.PASSWORD_OUTDATED_CACHE_TTL_MS;
+            if (isCacheValid) {
+                return passwordOutdatedCache.isExpiredPwd;
+            }
+        }
+        const doCheck = async () => {
+            __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsAuthenticatedUser).call(this, this.state);
+            const { nodeAuthTokens, authConnectionId, groupedAuthConnectionId, userId, } = this.state;
+            const currentDeviceAuthPubKey = __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverAuthPubKey).call(this);
+            const { authPubKey: globalAuthPubKey } = await this.toprfClient.fetchAuthPubKey({
+                nodeAuthTokens,
+                authConnectionId: groupedAuthConnectionId || authConnectionId,
+                userId,
+            });
+            // use noble lib to deserialize and compare curve point
+            const isExpiredPwd = !secp256k1_1.secp256k1.ProjectivePoint.fromHex(currentDeviceAuthPubKey).equals(secp256k1_1.secp256k1.ProjectivePoint.fromHex(globalAuthPubKey));
+            // Cache the result in state
+            this.update((state) => {
+                state.passwordOutdatedCache = { isExpiredPwd, timestamp: Date.now() };
+            });
+            return isExpiredPwd;
+        };
+        return options?.skipLock
+            ? await doCheck()
+            : await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_withControllerLock).call(this, doCheck);
+    }
     /**
      * Clears the current state of the SeedlessOnboardingController.
      */
@@ -369,7 +513,29 @@ class SeedlessOnboardingController extends base_controller_1.BaseController {
     }
 }
 exports.SeedlessOnboardingController = SeedlessOnboardingController;
-_SeedlessOnboardingController_vaultEncryptor = new WeakMap(), _SeedlessOnboardingController_vaultOperationMutex = new WeakMap(), _SeedlessOnboardingController_isUnlocked = new WeakMap(), _SeedlessOnboardingController_instances = new WeakSet(), _SeedlessOnboardingController_setUnlocked = function _SeedlessOnboardingController_setUnlocked() {
+_SeedlessOnboardingController_vaultEncryptor = new WeakMap(), _SeedlessOnboardingController_controllerOperationMutex = new WeakMap(), _SeedlessOnboardingController_vaultOperationMutex = new WeakMap(), _SeedlessOnboardingController_isUnlocked = new WeakMap(), _SeedlessOnboardingController_instances = new WeakSet(), _SeedlessOnboardingController_recoverPassword = 
+/**
+ * @description Fetch the password corresponding to the targetPwPubKey.
+ *
+ * @param params - The parameters for fetching the password.
+ * @param params.targetPwPubKey - The target public key of the password to recover.
+ * @param params.globalPassword - The latest global password.
+ * @returns A promise that resolves to the password corresponding to the current authPubKey in state.
+ */
+async function _SeedlessOnboardingController_recoverPassword({ targetPwPubKey, globalPassword, }) {
+    const { encKey: latestPwEncKey, authKeyPair: latestPwAuthKeyPair } = await __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_recoverEncKey).call(this, globalPassword);
+    try {
+        const res = await this.toprfClient.recoverPassword({
+            targetPwPubKey,
+            curEncKey: latestPwEncKey,
+            curAuthKeyPair: latestPwAuthKeyPair,
+        });
+        return res;
+    }
+    catch (error) {
+        throw errors_1.PasswordSyncError.getInstance(error);
+    }
+}, _SeedlessOnboardingController_setUnlocked = function _SeedlessOnboardingController_setUnlocked() {
     __classPrivateFieldSet(this, _SeedlessOnboardingController_isUnlocked, true, "f");
 }, _SeedlessOnboardingController_persistOprfKey = 
 /**
@@ -395,6 +561,14 @@ async function _SeedlessOnboardingController_persistOprfKey(oprfKey, authPubKey)
         log('Error persisting local encryption key', error);
         throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.FailedToPersistOprfKey);
     }
+}, _SeedlessOnboardingController_persistAuthPubKey = function _SeedlessOnboardingController_persistAuthPubKey(params) {
+    this.update((state) => {
+        state.authPubKey = (0, utils_1.bytesToBase64)(params.authPubKey);
+    });
+}, _SeedlessOnboardingController_recoverAuthPubKey = function _SeedlessOnboardingController_recoverAuthPubKey() {
+    __classPrivateFieldGet(this, _SeedlessOnboardingController_instances, "m", _SeedlessOnboardingController_assertIsSRPBackedUpUser).call(this, this.state);
+    const { authPubKey } = this.state;
+    return (0, utils_1.base64ToBytes)(authPubKey);
 }, _SeedlessOnboardingController_recoverEncKey = 
 /**
  * Recover the encryption key from password.
@@ -631,6 +805,21 @@ async function _SeedlessOnboardingController_updateVault({ password, serializedV
             state.vaultEncryptionSalt = JSON.parse(vault).salt;
         });
     });
+}, _SeedlessOnboardingController_withControllerLock = 
+/**
+ * Lock the controller mutex before executing the given function,
+ * and release it after the function is resolved or after an
+ * error is thrown.
+ *
+ * This wrapper ensures that each mutable operation that interacts with the
+ * controller and that changes its state is executed in a mutually exclusive way,
+ * preventing unsafe concurrent access that could lead to unpredictable behavior.
+ *
+ * @param callback - The function to execute while the controller mutex is locked.
+ * @returns The result of the function.
+ */
+async function _SeedlessOnboardingController_withControllerLock(callback) {
+    return await withLock(__classPrivateFieldGet(this, _SeedlessOnboardingController_controllerOperationMutex, "f"), callback);
 }, _SeedlessOnboardingController_withVaultLock = 
 /**
  * Lock the vault mutex before executing the given function,
@@ -698,6 +887,28 @@ async function _SeedlessOnboardingController_withVaultLock(callback) {
     ) {
         throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.InsufficientAuthToken);
     }
+}, _SeedlessOnboardingController_assertIsSRPBackedUpUser = function _SeedlessOnboardingController_assertIsSRPBackedUpUser(value) {
+    if (!this.state.authPubKey) {
+        throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.SRPNotBackedUpError);
+    }
+}, _SeedlessOnboardingController_assertPasswordInSync = 
+/**
+ * Assert that the password is in sync with the global password.
+ *
+ * @param options - The options for asserting the password is in sync.
+ * @param options.skipCache - Whether to skip the cache check.
+ * @param options.skipLock - Whether to skip the lock acquisition.
+ * @throws If the password is outdated.
+ */
+async function _SeedlessOnboardingController_assertPasswordInSync(options) {
+    const isPasswordOutdated = await this.checkIsPasswordOutdated(options);
+    if (isPasswordOutdated) {
+        throw new Error(constants_1.SeedlessOnboardingControllerErrorMessage.OutdatedPassword);
+    }
+}, _SeedlessOnboardingController_resetPasswordOutdatedCache = function _SeedlessOnboardingController_resetPasswordOutdatedCache() {
+    this.update((state) => {
+        delete state.passwordOutdatedCache;
+    });
 }, _SeedlessOnboardingController_assertIsValidVaultData = function _SeedlessOnboardingController_assertIsValidVaultData(value) {
     // value is not valid vault data if any of the following conditions are true:
     if (!value || // value is not defined