@metamask-previews/profile-sync-controller 32.1.1-preview-f87e9ae41 → 32.2.0-preview-fb486948f

package/CHANGELOG.md

@@ -7,8 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Bump `immer` from `^9.0.6` to `^9.0.21` ([#10331](https://github.com/MetaMask/core/pull/10331))
+
+## [32.2.0]
+
 ### Added
 
+- Add `beginStepUp`, `completeStepUp`, `getElevatedProfileToken` and `clearStepUpSession` to `AuthenticationController`, holding the elevated token in memory only behind a hard-expiring `stepUpSessionExpiresAt` state ([#10267](https://github.com/MetaMask/core/pull/10267))
 - Add `refreshEnrolledCredentials`, `beginCredentialEnrollment` and `completeCredentialEnrollment` to `AuthenticationController`, backed by a memory-only `enrolledCredentials` state and an optional `trace` callback ([#10266](https://github.com/MetaMask/core/pull/10266))
 - Add passkey and email OTP enrollment, verification, credential-list, and elevated-token exchange SDK methods ([#10265](https://github.com/MetaMask/core/pull/10265))
 - Add validated MFA domain types and structured `MfaError` classes with a serialization-safe `mfaCode` ([#10264](https://github.com/MetaMask/core/pull/10264))
@@ -977,7 +984,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@32.1.1...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@32.2.0...HEAD
+[32.2.0]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@32.1.1...@metamask/profile-sync-controller@32.2.0
 [32.1.1]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@32.1.0...@metamask/profile-sync-controller@32.1.1
 [32.1.0]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@32.0.0...@metamask/profile-sync-controller@32.1.0
 [32.0.0]: https://github.com/MetaMask/core/compare/@metamask/profile-sync-controller@31.0.0...@metamask/profile-sync-controller@32.0.0

package/README.md

@@ -42,6 +42,23 @@ import { ... } from '@metamask/profile-sync-controller/auth/mocks'
 import { ... } from '@metamask/profile-sync-controller/user-storage/mocks'
 ```
 
+## Multi-factor authentication
+
+`AuthenticationController` exposes UI-independent primitives for passkey and
+email OTP enrollment and step-up verification:
+
+- `refreshEnrolledCredentials()` refreshes the in-memory credential list.
+- `beginCredentialEnrollment()` and `completeCredentialEnrollment()` surround
+  a client-owned passkey ceremony or email-code screen.
+- `beginStepUp()` and `completeStepUp()` verify an enrolled credential and
+  return an elevated profile token.
+- `getElevatedProfileToken()` reuses a live elevated session when it satisfies
+  the caller's freshness requirement; `clearStepUpSession()` clears it.
+
+Clients must retain the challenge `flowId`, perform the platform ceremony, and
+send the resulting proof to the matching completion method. OTP codes,
+passkey results, and elevated tokens are never persisted in controller state.
+
 ## Contributing
 
 This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

package/dist/controllers/authentication/AuthenticationController-method-action-types.d.ts

@@ -53,6 +53,48 @@ export type AuthenticationControllerCompleteCredentialEnrollmentAction = {
     type: `AuthenticationController:completeCredentialEnrollment`;
     handler: AuthenticationController['completeCredentialEnrollment'];
 };
+/**
+ * Begins step-up verification with an enrolled credential.
+ *
+ * @param request - Credential type and trace reason.
+ * @returns A challenge for the client-owned ceremony.
+ */
+export type AuthenticationControllerBeginStepUpAction = {
+    type: `AuthenticationController:beginStepUp`;
+    handler: AuthenticationController['beginStepUp'];
+};
+/**
+ * Completes step-up verification and opens a short-lived elevated session.
+ *
+ * The AAL2 assertion returned by the MFA service is exchanged at Hydra for
+ * an elevated access token, whose claims are checked before the session
+ * opens. The token itself never enters controller state.
+ *
+ * @param request - Flow identifier, platform or email proof, and trace reason.
+ * @returns The elevated profile access token.
+ */
+export type AuthenticationControllerCompleteStepUpAction = {
+    type: `AuthenticationController:completeStepUp`;
+    handler: AuthenticationController['completeStepUp'];
+};
+/**
+ * Returns the active elevated token when it meets the requested freshness.
+ *
+ * @param request - Optional maximum session age in milliseconds, measured
+ * from when the token was obtained. Zero always requires a new ceremony.
+ * @returns A live elevated token, or null when no reusable session exists.
+ */
+export type AuthenticationControllerGetElevatedProfileTokenAction = {
+    type: `AuthenticationController:getElevatedProfileToken`;
+    handler: AuthenticationController['getElevatedProfileToken'];
+};
+/**
+ * Clears the in-memory elevated session and its expiration timer.
+ */
+export type AuthenticationControllerClearStepUpSessionAction = {
+    type: `AuthenticationController:clearStepUpSession`;
+    handler: AuthenticationController['clearStepUpSession'];
+};
 export type AuthenticationControllerPerformSignOutAction = {
     type: `AuthenticationController:performSignOut`;
     handler: AuthenticationController['performSignOut'];
@@ -160,5 +202,5 @@ export type AuthenticationControllerIsSignedInAction = {
 /**
  * Union of all AuthenticationController action types.
  */
-export type AuthenticationControllerMethodActions = AuthenticationControllerPerformSignInAction | AuthenticationControllerRequestProfilePairingAction | AuthenticationControllerRefreshEnrolledCredentialsAction | AuthenticationControllerBeginCredentialEnrollmentAction | AuthenticationControllerCompleteCredentialEnrollmentAction | AuthenticationControllerPerformSignOutAction | AuthenticationControllerClearStateAction | AuthenticationControllerGetBearerTokenAction | AuthenticationControllerGetSessionProfileAction | AuthenticationControllerRefreshCanonicalProfileIdAction | AuthenticationControllerGetUserProfileLineageAction | AuthenticationControllerGetCustomerServiceTokenAction | AuthenticationControllerGetPartnerIdentityTokenAction | AuthenticationControllerIsSignedInAction;
+export type AuthenticationControllerMethodActions = AuthenticationControllerPerformSignInAction | AuthenticationControllerRequestProfilePairingAction | AuthenticationControllerRefreshEnrolledCredentialsAction | AuthenticationControllerBeginCredentialEnrollmentAction | AuthenticationControllerCompleteCredentialEnrollmentAction | AuthenticationControllerBeginStepUpAction | AuthenticationControllerCompleteStepUpAction | AuthenticationControllerGetElevatedProfileTokenAction | AuthenticationControllerClearStepUpSessionAction | AuthenticationControllerPerformSignOutAction | AuthenticationControllerClearStateAction | AuthenticationControllerGetBearerTokenAction | AuthenticationControllerGetSessionProfileAction | AuthenticationControllerRefreshCanonicalProfileIdAction | AuthenticationControllerGetUserProfileLineageAction | AuthenticationControllerGetCustomerServiceTokenAction | AuthenticationControllerGetPartnerIdentityTokenAction | AuthenticationControllerIsSignedInAction;
 //# sourceMappingURL=AuthenticationController-method-action-types.d.ts.map

package/dist/controllers/authentication/AuthenticationController-method-action-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthenticationController-method-action-types.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController-method-action-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AuthenticationController-method-action-types.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController-method-action-types.ts"],"names":[],"mappings":"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"}

package/dist/controllers/authentication/AuthenticationController-method-action-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthenticationController-method-action-types.js","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AuthenticationController } from './AuthenticationController.js';\n\nexport type AuthenticationControllerPerformSignInAction = {\n  type: `AuthenticationController:performSignIn`;\n  handler: AuthenticationController['performSignIn'];\n};\n\n/**\n * Marks profile pairing as needed. Clients call this when the SRP set\n * changes (e.g. a new keyring was added) so the next auto-sign-in cycle\n * re-runs `performSignIn` and re-pairs.\n */\nexport type AuthenticationControllerRequestProfilePairingAction = {\n  type: `AuthenticationController:requestProfilePairing`;\n  handler: AuthenticationController['requestProfilePairing'];\n};\n\n/**\n * Refreshes credentials enrolled on the canonical profile.\n *\n * @returns The current supported credentials.\n */\nexport type AuthenticationControllerRefreshEnrolledCredentialsAction = {\n  type: `AuthenticationController:refreshEnrolledCredentials`;\n  handler: AuthenticationController['refreshEnrolledCredentials'];\n};\n\n/**\n * Begins enrollment of a passkey or email OTP credential.\n *\n * @param request - Credential, optional email address, and trace reason.\n * @returns A challenge for the client-owned ceremony.\n */\nexport type AuthenticationControllerBeginCredentialEnrollmentAction = {\n  type: `AuthenticationController:beginCredentialEnrollment`;\n  handler: AuthenticationController['beginCredentialEnrollment'];\n};\n\n/**\n * Completes credential enrollment and refreshes the credential cache.\n *\n * A cache-refresh failure does not undo successful enrollment. Email\n * enrollment invalidates the primary SRP session *after* refresh so the\n * credentials call can reuse the still-valid access token; the next token\n * fetch then includes the newly verified email claim. That invalidation\n * happens even if the session ends mid-request: the enrollment succeeded\n * on the server, so a token cached across a lock must not be reused\n * without the new claim.\n *\n * @param request - Flow identifier, platform or email proof, and trace reason.\n * @returns The refreshed credentials, or the existing cache if refresh fails.\n */\nexport type AuthenticationControllerCompleteCredentialEnrollmentAction = {\n  type: `AuthenticationController:completeCredentialEnrollment`;\n  handler: AuthenticationController['completeCredentialEnrollment'];\n};\n\nexport type AuthenticationControllerPerformSignOutAction = {\n  type: `AuthenticationController:performSignOut`;\n  handler: AuthenticationController['performSignOut'];\n};\n\n/**\n * Resets the controller to `defaultState`. Clients call this on wallet reset\n * so the next wallet starts unsigned with both pairing gates re-armed.\n */\nexport type AuthenticationControllerClearStateAction = {\n  type: `AuthenticationController:clearState`;\n  handler: AuthenticationController['clearState'];\n};\n\n/**\n * Returns a bearer token for the specified SRP, logging in if needed.\n *\n * When called without `entropySourceId`, returns the primary (first) SRP's\n * access token, which is effectively the canonical\n * profile's token that can be used by alias-aware consumers for cross-SRP\n * operations.\n *\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The OIDC access token.\n */\nexport type AuthenticationControllerGetBearerTokenAction = {\n  type: `AuthenticationController:getBearerToken`;\n  handler: AuthenticationController['getBearerToken'];\n};\n\n/**\n * Returns the cached session profile, logging in if no session exists.\n *\n * The returned `canonicalProfileId` reflects the value from the most recent\n * login or pairing. In the rare event where a canonical changed because of\n * a pairing that happened on another device, the cached value may be stale\n * until the next login. For guaranteed freshness, call\n * `refreshCanonicalProfileId()` before reading `canonicalProfileId`.\n *\n * @param entropySourceId - The entropy source ID used to derive the key,\n * when multiple sources are available (Multi-SRP).\n * @returns profile for the session.\n */\nexport type AuthenticationControllerGetSessionProfileAction = {\n  type: `AuthenticationController:getSessionProfile`;\n  handler: AuthenticationController['getSessionProfile'];\n};\n\n/**\n * Forces a fresh retrieval of the canonical profile ID from the server\n * and propagates it to all cached SRP sessions.\n *\n * This method invalidates the primary SRP's cached session and forces a\n * re-login. Use it before operations that require a guaranteed-fresh\n * canonical (e.g. storage key derivation for Accounts ADR 0005). For\n * best-effort reads, use\n * `getSessionProfile().canonicalProfileId` instead.\n *\n * Only the primary SRP is re-logged-in regardless of how many SRPs exist —\n * the server returns the current canonical for the entire pairing group\n * from any single SRP login.\n *\n * @returns The refreshed canonical profile ID.\n */\nexport type AuthenticationControllerRefreshCanonicalProfileIdAction = {\n  type: `AuthenticationController:refreshCanonicalProfileId`;\n  handler: AuthenticationController['refreshCanonicalProfileId'];\n};\n\nexport type AuthenticationControllerGetUserProfileLineageAction = {\n  type: `AuthenticationController:getUserProfileLineage`;\n  handler: AuthenticationController['getUserProfileLineage'];\n};\n\n/**\n * Returns a Customer Service specific access token for the specified SRP,\n * logging in if needed.\n *\n * Exchanges the OIDC access token for a short-lived token scoped to the\n * customer-service audience. Customer Service tooling consumes this token to\n * identify and authenticate the user.\n *\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The customer-service access token.\n */\nexport type AuthenticationControllerGetCustomerServiceTokenAction = {\n  type: `AuthenticationController:getCustomerServiceToken`;\n  handler: AuthenticationController['getCustomerServiceToken'];\n};\n\n/**\n * Mints a partner identity token for the specified SRP, logging in if needed.\n *\n * Calls `POST /api/v2/oidc/token` with the Hydra login bearer and returns\n * the minted `access_token`. Email on live tokens is under JWT `ext`.\n * HTTP 422 throws `EmailRequiredError` when this profile has no\n * verified email.\n *\n * @param claims - Claim names to embed. Only `email` is supported.\n * @param audience - Partner audience (`kyc` or `iron`).\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The partner identity access token.\n */\nexport type AuthenticationControllerGetPartnerIdentityTokenAction = {\n  type: `AuthenticationController:getPartnerIdentityToken`;\n  handler: AuthenticationController['getPartnerIdentityToken'];\n};\n\nexport type AuthenticationControllerIsSignedInAction = {\n  type: `AuthenticationController:isSignedIn`;\n  handler: AuthenticationController['isSignedIn'];\n};\n\n/**\n * Union of all AuthenticationController action types.\n */\nexport type AuthenticationControllerMethodActions =\n  | AuthenticationControllerPerformSignInAction\n  | AuthenticationControllerRequestProfilePairingAction\n  | AuthenticationControllerRefreshEnrolledCredentialsAction\n  | AuthenticationControllerBeginCredentialEnrollmentAction\n  | AuthenticationControllerCompleteCredentialEnrollmentAction\n  | AuthenticationControllerPerformSignOutAction\n  | AuthenticationControllerClearStateAction\n  | AuthenticationControllerGetBearerTokenAction\n  | AuthenticationControllerGetSessionProfileAction\n  | AuthenticationControllerRefreshCanonicalProfileIdAction\n  | AuthenticationControllerGetUserProfileLineageAction\n  | AuthenticationControllerGetCustomerServiceTokenAction\n  | AuthenticationControllerGetPartnerIdentityTokenAction\n  | AuthenticationControllerIsSignedInAction;\n"]}
+{"version":3,"file":"AuthenticationController-method-action-types.js","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AuthenticationController } from './AuthenticationController.js';\n\nexport type AuthenticationControllerPerformSignInAction = {\n  type: `AuthenticationController:performSignIn`;\n  handler: AuthenticationController['performSignIn'];\n};\n\n/**\n * Marks profile pairing as needed. Clients call this when the SRP set\n * changes (e.g. a new keyring was added) so the next auto-sign-in cycle\n * re-runs `performSignIn` and re-pairs.\n */\nexport type AuthenticationControllerRequestProfilePairingAction = {\n  type: `AuthenticationController:requestProfilePairing`;\n  handler: AuthenticationController['requestProfilePairing'];\n};\n\n/**\n * Refreshes credentials enrolled on the canonical profile.\n *\n * @returns The current supported credentials.\n */\nexport type AuthenticationControllerRefreshEnrolledCredentialsAction = {\n  type: `AuthenticationController:refreshEnrolledCredentials`;\n  handler: AuthenticationController['refreshEnrolledCredentials'];\n};\n\n/**\n * Begins enrollment of a passkey or email OTP credential.\n *\n * @param request - Credential, optional email address, and trace reason.\n * @returns A challenge for the client-owned ceremony.\n */\nexport type AuthenticationControllerBeginCredentialEnrollmentAction = {\n  type: `AuthenticationController:beginCredentialEnrollment`;\n  handler: AuthenticationController['beginCredentialEnrollment'];\n};\n\n/**\n * Completes credential enrollment and refreshes the credential cache.\n *\n * A cache-refresh failure does not undo successful enrollment. Email\n * enrollment invalidates the primary SRP session *after* refresh so the\n * credentials call can reuse the still-valid access token; the next token\n * fetch then includes the newly verified email claim. That invalidation\n * happens even if the session ends mid-request: the enrollment succeeded\n * on the server, so a token cached across a lock must not be reused\n * without the new claim.\n *\n * @param request - Flow identifier, platform or email proof, and trace reason.\n * @returns The refreshed credentials, or the existing cache if refresh fails.\n */\nexport type AuthenticationControllerCompleteCredentialEnrollmentAction = {\n  type: `AuthenticationController:completeCredentialEnrollment`;\n  handler: AuthenticationController['completeCredentialEnrollment'];\n};\n\n/**\n * Begins step-up verification with an enrolled credential.\n *\n * @param request - Credential type and trace reason.\n * @returns A challenge for the client-owned ceremony.\n */\nexport type AuthenticationControllerBeginStepUpAction = {\n  type: `AuthenticationController:beginStepUp`;\n  handler: AuthenticationController['beginStepUp'];\n};\n\n/**\n * Completes step-up verification and opens a short-lived elevated session.\n *\n * The AAL2 assertion returned by the MFA service is exchanged at Hydra for\n * an elevated access token, whose claims are checked before the session\n * opens. The token itself never enters controller state.\n *\n * @param request - Flow identifier, platform or email proof, and trace reason.\n * @returns The elevated profile access token.\n */\nexport type AuthenticationControllerCompleteStepUpAction = {\n  type: `AuthenticationController:completeStepUp`;\n  handler: AuthenticationController['completeStepUp'];\n};\n\n/**\n * Returns the active elevated token when it meets the requested freshness.\n *\n * @param request - Optional maximum session age in milliseconds, measured\n * from when the token was obtained. Zero always requires a new ceremony.\n * @returns A live elevated token, or null when no reusable session exists.\n */\nexport type AuthenticationControllerGetElevatedProfileTokenAction = {\n  type: `AuthenticationController:getElevatedProfileToken`;\n  handler: AuthenticationController['getElevatedProfileToken'];\n};\n\n/**\n * Clears the in-memory elevated session and its expiration timer.\n */\nexport type AuthenticationControllerClearStepUpSessionAction = {\n  type: `AuthenticationController:clearStepUpSession`;\n  handler: AuthenticationController['clearStepUpSession'];\n};\n\nexport type AuthenticationControllerPerformSignOutAction = {\n  type: `AuthenticationController:performSignOut`;\n  handler: AuthenticationController['performSignOut'];\n};\n\n/**\n * Resets the controller to `defaultState`. Clients call this on wallet reset\n * so the next wallet starts unsigned with both pairing gates re-armed.\n */\nexport type AuthenticationControllerClearStateAction = {\n  type: `AuthenticationController:clearState`;\n  handler: AuthenticationController['clearState'];\n};\n\n/**\n * Returns a bearer token for the specified SRP, logging in if needed.\n *\n * When called without `entropySourceId`, returns the primary (first) SRP's\n * access token, which is effectively the canonical\n * profile's token that can be used by alias-aware consumers for cross-SRP\n * operations.\n *\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The OIDC access token.\n */\nexport type AuthenticationControllerGetBearerTokenAction = {\n  type: `AuthenticationController:getBearerToken`;\n  handler: AuthenticationController['getBearerToken'];\n};\n\n/**\n * Returns the cached session profile, logging in if no session exists.\n *\n * The returned `canonicalProfileId` reflects the value from the most recent\n * login or pairing. In the rare event where a canonical changed because of\n * a pairing that happened on another device, the cached value may be stale\n * until the next login. For guaranteed freshness, call\n * `refreshCanonicalProfileId()` before reading `canonicalProfileId`.\n *\n * @param entropySourceId - The entropy source ID used to derive the key,\n * when multiple sources are available (Multi-SRP).\n * @returns profile for the session.\n */\nexport type AuthenticationControllerGetSessionProfileAction = {\n  type: `AuthenticationController:getSessionProfile`;\n  handler: AuthenticationController['getSessionProfile'];\n};\n\n/**\n * Forces a fresh retrieval of the canonical profile ID from the server\n * and propagates it to all cached SRP sessions.\n *\n * This method invalidates the primary SRP's cached session and forces a\n * re-login. Use it before operations that require a guaranteed-fresh\n * canonical (e.g. storage key derivation for Accounts ADR 0005). For\n * best-effort reads, use\n * `getSessionProfile().canonicalProfileId` instead.\n *\n * Only the primary SRP is re-logged-in regardless of how many SRPs exist —\n * the server returns the current canonical for the entire pairing group\n * from any single SRP login.\n *\n * @returns The refreshed canonical profile ID.\n */\nexport type AuthenticationControllerRefreshCanonicalProfileIdAction = {\n  type: `AuthenticationController:refreshCanonicalProfileId`;\n  handler: AuthenticationController['refreshCanonicalProfileId'];\n};\n\nexport type AuthenticationControllerGetUserProfileLineageAction = {\n  type: `AuthenticationController:getUserProfileLineage`;\n  handler: AuthenticationController['getUserProfileLineage'];\n};\n\n/**\n * Returns a Customer Service specific access token for the specified SRP,\n * logging in if needed.\n *\n * Exchanges the OIDC access token for a short-lived token scoped to the\n * customer-service audience. Customer Service tooling consumes this token to\n * identify and authenticate the user.\n *\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The customer-service access token.\n */\nexport type AuthenticationControllerGetCustomerServiceTokenAction = {\n  type: `AuthenticationController:getCustomerServiceToken`;\n  handler: AuthenticationController['getCustomerServiceToken'];\n};\n\n/**\n * Mints a partner identity token for the specified SRP, logging in if needed.\n *\n * Calls `POST /api/v2/oidc/token` with the Hydra login bearer and returns\n * the minted `access_token`. Email on live tokens is under JWT `ext`.\n * HTTP 422 throws `EmailRequiredError` when this profile has no\n * verified email.\n *\n * @param claims - Claim names to embed. Only `email` is supported.\n * @param audience - Partner audience (`kyc` or `iron`).\n * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n * @returns The partner identity access token.\n */\nexport type AuthenticationControllerGetPartnerIdentityTokenAction = {\n  type: `AuthenticationController:getPartnerIdentityToken`;\n  handler: AuthenticationController['getPartnerIdentityToken'];\n};\n\nexport type AuthenticationControllerIsSignedInAction = {\n  type: `AuthenticationController:isSignedIn`;\n  handler: AuthenticationController['isSignedIn'];\n};\n\n/**\n * Union of all AuthenticationController action types.\n */\nexport type AuthenticationControllerMethodActions =\n  | AuthenticationControllerPerformSignInAction\n  | AuthenticationControllerRequestProfilePairingAction\n  | AuthenticationControllerRefreshEnrolledCredentialsAction\n  | AuthenticationControllerBeginCredentialEnrollmentAction\n  | AuthenticationControllerCompleteCredentialEnrollmentAction\n  | AuthenticationControllerBeginStepUpAction\n  | AuthenticationControllerCompleteStepUpAction\n  | AuthenticationControllerGetElevatedProfileTokenAction\n  | AuthenticationControllerClearStepUpSessionAction\n  | AuthenticationControllerPerformSignOutAction\n  | AuthenticationControllerClearStateAction\n  | AuthenticationControllerGetBearerTokenAction\n  | AuthenticationControllerGetSessionProfileAction\n  | AuthenticationControllerRefreshCanonicalProfileIdAction\n  | AuthenticationControllerGetUserProfileLineageAction\n  | AuthenticationControllerGetCustomerServiceTokenAction\n  | AuthenticationControllerGetPartnerIdentityTokenAction\n  | AuthenticationControllerIsSignedInAction;\n"]}

package/dist/controllers/authentication/AuthenticationController.d.ts

@@ -4,7 +4,7 @@ import type { TraceCallback } from '@metamask/controller-utils';
 import type { KeyringControllerGetStateAction, KeyringControllerLockEvent, KeyringControllerUnlockEvent, KeyringControllerWithKeyringV2UnsafeAction } from '@metamask/keyring-controller';
 import type { Messenger } from '@metamask/messenger';
 import type { SeedlessOnboardingControllerGetAccessTokenAction, SeedlessOnboardingControllerGetStateAction } from '@metamask/seedless-onboarding-controller';
-import type { LoginResponse, ProfileAlias, UserProfile, UserProfileLineage, OidcTokenAudience, OidcTokenClaims, BeginEnrollmentRequest, CompleteEnrollmentRequest, EnrolledCredential, EnrollmentChallenge } from '../../sdk/index.js';
+import type { LoginResponse, ProfileAlias, UserProfile, UserProfileLineage, OidcTokenAudience, OidcTokenClaims, BeginEnrollmentRequest, CompleteEnrollmentRequest, EnrolledCredential, EnrollmentChallenge, BeginStepUpRequest, CompleteStepUpRequest, ElevatedProfileToken, GetElevatedTokenRequest, StepUpChallenge } from '../../sdk/index.js';
 import { Env } from '../../sdk/index.js';
 import type { MetaMetricsAuth } from '../../shared/types/services.js';
 import { AuthenticationControllerMethodActions } from './AuthenticationController-method-action-types.js';
@@ -18,6 +18,11 @@ export type AuthenticationControllerState = {
      * assignable to the controller state type.
      */
     enrolledCredentials?: EnrolledCredential[];
+    /**
+     * Epoch-ms hard expiry of the in-memory elevated session, or undefined when
+     * none is open. Lets UI show "verified" state without holding the token.
+     */
+    stepUpSessionExpiresAt?: number;
     /**
      * Client gate for profile pairing. Defaults to `true` (fresh install /
      * upgrade), set to `false` after a successful `performSignIn` pair, set
@@ -45,6 +50,12 @@ export type AuthenticationControllerState = {
     needsSocialPairing?: boolean;
 };
 export declare const defaultState: AuthenticationControllerState;
+/**
+ * Lifetime of an elevated session. Deliberately shorter than the
+ * elevated token's own `exp` so a fresh ceremony is required per sensitive
+ * action window, per the MFA phase-1 specification.
+ */
+export declare const STEP_UP_SESSION_TTL_MS = 60000;
 type ControllerConfig = {
     env: Env;
     /**
@@ -122,6 +133,36 @@ export declare class AuthenticationController extends BaseController<typeof cont
      * @returns The refreshed credentials, or the existing cache if refresh fails.
      */
     completeCredentialEnrollment(request: CompleteEnrollmentRequest): Promise<EnrolledCredential[]>;
+    /**
+     * Begins step-up verification with an enrolled credential.
+     *
+     * @param request - Credential type and trace reason.
+     * @returns A challenge for the client-owned ceremony.
+     */
+    beginStepUp(request: BeginStepUpRequest): Promise<StepUpChallenge>;
+    /**
+     * Completes step-up verification and opens a short-lived elevated session.
+     *
+     * The AAL2 assertion returned by the MFA service is exchanged at Hydra for
+     * an elevated access token, whose claims are checked before the session
+     * opens. The token itself never enters controller state.
+     *
+     * @param request - Flow identifier, platform or email proof, and trace reason.
+     * @returns The elevated profile access token.
+     */
+    completeStepUp(request: CompleteStepUpRequest): Promise<ElevatedProfileToken>;
+    /**
+     * Returns the active elevated token when it meets the requested freshness.
+     *
+     * @param request - Optional maximum session age in milliseconds, measured
+     * from when the token was obtained. Zero always requires a new ceremony.
+     * @returns A live elevated token, or null when no reusable session exists.
+     */
+    getElevatedProfileToken(request?: GetElevatedTokenRequest): ElevatedProfileToken | null;
+    /**
+     * Clears the in-memory elevated session and its expiration timer.
+     */
+    clearStepUpSession(): void;
     performSignOut(): void;
     /**
      * Resets the controller to `defaultState`. Clients call this on wallet reset

package/dist/controllers/authentication/AuthenticationController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthenticationController.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,KAAK,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,EAC5B,0CAA0C,EAC3C,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EACV,gDAAgD,EAChD,0CAA0C,EAC3C,MAAM,0CAA0C,CAAC;AAQlD,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EAGZ,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,GAAG,EAIJ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOtE,OAAO,EAAE,qCAAqC,EAAE,MAAM,mDAAmD,CAAC;AAE1G,QAAA,MAAM,cAAc,6BAA6B,CAAC;AAGlD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,6BAK1B,CAAC;AA8DF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,GAAG,CAAC;IACT;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC;CACvC,CAAC;AAmBF,MAAM,MAAM,OAAO,GACf,sCAAsC,GACtC,qCAAqC,CAAC;AAE1C,MAAM,MAAM,sCAAsC,GAAG,wBAAwB,CAC3E,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAClD,0BAA0B,CACxB,OAAO,cAAc,EACrB,6BAA6B,CAC9B,CAAC;AAEJ,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0CAA0C,GAAG;IACvD,IAAI,EAAE,GAAG,OAAO,cAAc,gBAAgB,CAAC;IAC/C,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,MAAM,GACd,wCAAwC,GACxC,0CAA0C,CAAC;AAG/C,KAAK,cAAc,GACf,+BAA+B,GAC/B,0CAA0C,GAC1C,0CAA0C,GAC1C,gDAAgD,CAAC;AAErD,KAAK,aAAa,GAAG,0BAA0B,GAAG,4BAA4B,CAAC;AAG/E,MAAM,MAAM,iCAAiC,GAAG,SAAS,CACvD,OAAO,cAAc,EACrB,OAAO,GAAG,cAAc,EACxB,MAAM,GAAG,aAAa,CACvB,CAAC;AAEF;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,cAAc,CAC1D,OAAO,cAAc,EACrB,6BAA6B,EAC7B,iCAAiC,CAClC;;IAkDC,YAAY,EACV,SAAS,EACT,KAAK,EACL,MAAM,EACN,WAAW,EACX,KAAK,GACN,EAAE;QACD,SAAS,EAAE,iCAAiC,CAAC;QAC7C,KAAK,CAAC,EAAE,6BAA6B,CAAC;QACtC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACnC;;;WAGG;QACH,WAAW,EAAE,eAAe,CAAC;QAC7B,KAAK,CAAC,EAAE,aAAa,CAAC;KACvB,EAiDA;IA4KY,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAiC9C;IA+GD;;;;OAIG;IACI,qBAAqB,IAAI,IAAI,CAOnC;IAgJD;;;;OAIG;IACU,0BAA0B,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA+BvE;IAED;;;;;OAKG;IACU,yBAAyB,CACpC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAiB9B;IAED;;;;;;;;;;;;;OAaG;IACU,4BAA4B,CACvC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuC/B;IAoBM,cAAc,IAAI,IAAI,CAO5B;IAED;;;OAGG;IACI,UAAU,IAAI,IAAI,CAKxB;IAED;;;;;;;;;;OAUG;IACU,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;IAED;;;;;;;;;;;;OAYG;IACU,iBAAiB,CAC5B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,WAAW,CAAC,CAItB;IAED;;;;;;;;;;;;;;;OAeG;IACU,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBxD;IAcY,qBAAqB,CAChC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;IAED;;;;;;;;;;OAUG;IACU,uBAAuB,CAClC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAIjB;IAED;;;;;;;;;;;;OAYG;IACU,uBAAuB,CAClC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAQjB;IAEM,UAAU,IAAI,OAAO,CAE3B;CA8EF"}
+{"version":3,"file":"AuthenticationController.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController.ts"],"names":[],"mappings":"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"}

package/dist/controllers/authentication/AuthenticationController.js

@@ -1,7 +1,9 @@
 import { BaseController } from '@metamask/base-controller';
 import { selectHdKeyringEntropySourceIds } from '@metamask/keyring-controller';
-import { BeginEnrollmentRequestStruct, CompleteEnrollmentRequestStruct, assertValidMfaRequest, } from '../../sdk/authentication-jwt-bearer/mfa/schemas.js';
-import { assertMessageStartsWithMetamask, AuthType, Env, JwtBearerAuth, PairConflictError, getMfaErrorCode, } from '../../sdk/index.js';
+import { BeginEnrollmentRequestStruct, CompleteEnrollmentRequestStruct, assertValidMfaRequest, BeginStepUpRequestStruct, CompleteStepUpRequestStruct, GetElevatedTokenRequestStruct, parseElevatedTokenClaims, } from '../../sdk/authentication-jwt-bearer/mfa/schemas.js';
+import { assertMessageStartsWithMetamask, AuthType, Env, JwtBearerAuth, PairConflictError, getMfaErrorCode, ElevatedTokenInvalidError, } from '../../sdk/index.js';
+import { decodeJwtPayload } from '../../sdk/utils/jwt.js';
+import { toErrorMessage } from '../../sdk/utils/to-error-message.js';
 import { getPrimaryHdKeyringEntropySourceId } from '../../shared/utils/entropy-source.js';
 import { getHdKeyringSeed } from '../../shared/utils/hd-keyring-seed.js';
 import { getMessageSigningPublicKey, signMessageWithMessageSigningKey, } from '../../shared/utils/message-signing.js';
@@ -66,7 +68,19 @@ const metadata = {
         includeInDebugSnapshot: false,
         usedInUi: true,
     },
+    stepUpSessionExpiresAt: {
+        includeInStateLogs: false,
+        persist: false,
+        includeInDebugSnapshot: false,
+        usedInUi: true,
+    },
 };
+/**
+ * Lifetime of an elevated session. Deliberately shorter than the
+ * elevated token's own `exp` so a fresh ceremony is required per sensitive
+ * action window, per the MFA phase-1 specification.
+ */
+export const STEP_UP_SESSION_TTL_MS = 60_000;
 const MESSENGER_EXPOSED_METHODS = [
     'performSignIn',
     'performSignOut',
@@ -82,6 +96,10 @@ const MESSENGER_EXPOSED_METHODS = [
     'refreshEnrolledCredentials',
     'beginCredentialEnrollment',
     'completeCredentialEnrollment',
+    'beginStepUp',
+    'completeStepUp',
+    'getElevatedProfileToken',
+    'clearStepUpSession',
 ];
 /**
  * Controller that enables authentication for restricted endpoints.
@@ -101,6 +119,8 @@ export class AuthenticationController extends BaseController {
      * ceremony started under the previous session cannot apply its result.
      */
     #authSessionEpoch = 0;
+    #stepUpSession = null;
+    #stepUpTimer;
     /**
      * Sequence number of the most recently started credentials refresh. Only
      * that refresh may write the cache, so a slower, earlier request cannot
@@ -123,6 +143,7 @@ export class AuthenticationController extends BaseController {
             this.messenger.subscribe('KeyringController:lock', () => {
                 this.#authSessionEpoch += 1;
                 this.#isUnlocked = false;
+                this.clearStepUpSession();
             });
         },
     };
@@ -136,9 +157,10 @@ export class AuthenticationController extends BaseController {
         if (!metametrics) {
             throw new Error('`metametrics` field is required');
         }
+        // `??` per key so an explicit `undefined` keeps the default rather than
+        // clobbering it.
         this.#config = {
-            ...this.#config,
-            ...config,
+            env: config?.env ?? this.#config.env,
             isSocialPairingEnabled: config?.isSocialPairingEnabled ?? this.#config.isSocialPairingEnabled,
         };
         this.#metametrics = metametrics;
@@ -539,27 +561,43 @@ export class AuthenticationController extends BaseController {
      * @returns The step's result.
      */
     async #runMfaRequest(name, operation, credentialType, fn) {
-        const data = { outcome: 'pending' };
         return await this.#trace({
             name,
             tags: { operation, credentialType },
-            data,
-        }, async () => {
+        }, async (context) => {
             try {
                 const result = await fn();
-                data.outcome = 'success';
+                this.#setTraceAttribute(context, 'outcome', 'success');
                 return result;
             }
             catch (error) {
-                data.outcome = 'error';
+                this.#setTraceAttribute(context, 'outcome', 'error');
                 const mfaCode = getMfaErrorCode(error);
                 if (mfaCode) {
-                    data.mfaErrorCode = mfaCode;
+                    this.#setTraceAttribute(context, 'mfaErrorCode', mfaCode);
+                    if (mfaCode === 'authentication_required' && this.#isUnlocked) {
+                        this.#invalidateSrpSession(this.#getPrimaryEntropySourceId());
+                        // An elevated session must not outlive a rejected base session.
+                        this.clearStepUpSession();
+                    }
                 }
                 throw error;
             }
         });
     }
+    /**
+     * `TraceContext` is opaque in `@metamask/controller-utils`; both clients
+     * hand back a Sentry span, so attributes are set via duck typing and a
+     * non-Sentry context is a silent no-op.
+     *
+     * @param context - Span handed to the trace callback, if any.
+     * @param key - Attribute name.
+     * @param value - Attribute value.
+     */
+    #setTraceAttribute(context, key, value) {
+        const traceSpan = context;
+        traceSpan?.setAttribute?.(key, value);
+    }
     /**
      * Refreshes credentials enrolled on the canonical profile.
      *
@@ -636,6 +674,8 @@ export class AuthenticationController extends BaseController {
             }
             throw error;
         }
+        // The factor set changed: require a fresh ceremony against the new set.
+        this.clearStepUpSession();
         try {
             return await this.refreshEnrolledCredentials();
         }
@@ -648,6 +688,117 @@ export class AuthenticationController extends BaseController {
             }
         }
     }
+    /**
+     * Begins step-up verification with an enrolled credential.
+     *
+     * @param request - Credential type and trace reason.
+     * @returns A challenge for the client-owned ceremony.
+     */
+    async beginStepUp(request) {
+        this.#assertIsUnlocked('beginStepUp');
+        const sessionEpoch = this.#authSessionEpoch;
+        assertValidMfaRequest(request, BeginStepUpRequestStruct);
+        const primaryEntropySourceId = this.#getPrimaryEntropySourceId();
+        const challenge = await this.#runMfaRequest('MFA Step-Up Begin', request.reason.operation, request.type, async () => await this.#auth.beginMfaVerification(request.type, primaryEntropySourceId));
+        this.#assertAuthSessionEpoch(sessionEpoch, 'beginStepUp');
+        return challenge;
+    }
+    /**
+     * Completes step-up verification and opens a short-lived elevated session.
+     *
+     * The AAL2 assertion returned by the MFA service is exchanged at Hydra for
+     * an elevated access token, whose claims are checked before the session
+     * opens. The token itself never enters controller state.
+     *
+     * @param request - Flow identifier, platform or email proof, and trace reason.
+     * @returns The elevated profile access token.
+     */
+    async completeStepUp(request) {
+        this.#assertIsUnlocked('completeStepUp');
+        const sessionEpoch = this.#authSessionEpoch;
+        assertValidMfaRequest(request, CompleteStepUpRequestStruct);
+        const { type } = request.proof;
+        const { operation } = request.reason;
+        const primaryEntropySourceId = this.#getPrimaryEntropySourceId();
+        const assertion = await this.#runMfaRequest('MFA Step-Up Complete', operation, type, async () => await this.#auth.completeMfaVerification(request.flowId, request.proof, primaryEntropySourceId));
+        this.#assertAuthSessionEpoch(sessionEpoch, 'completeStepUp');
+        const accessToken = await this.#runMfaRequest('MFA Token Exchange', operation, type, async () => await this.#auth.exchangeMfaAssertion(assertion.token));
+        this.#assertAuthSessionEpoch(sessionEpoch, 'completeStepUp');
+        let decodedClaims;
+        try {
+            decodedClaims = decodeJwtPayload(accessToken.accessToken);
+        }
+        catch (error) {
+            throw new ElevatedTokenInvalidError(toErrorMessage(error));
+        }
+        const claims = parseElevatedTokenClaims(decodedClaims);
+        if (claims.exp * 1000 <= Date.now()) {
+            throw new ElevatedTokenInvalidError('Elevated token is expired');
+        }
+        const token = { ...accessToken, claims };
+        this.#openStepUpSession(token);
+        return token;
+    }
+    /**
+     * Returns the active elevated token when it meets the requested freshness.
+     *
+     * @param request - Optional maximum session age in milliseconds, measured
+     * from when the token was obtained. Zero always requires a new ceremony.
+     * @returns A live elevated token, or null when no reusable session exists.
+     */
+    getElevatedProfileToken(request = {}) {
+        this.#assertIsUnlocked('getElevatedProfileToken');
+        assertValidMfaRequest(request, GetElevatedTokenRequestStruct);
+        const session = this.#stepUpSession;
+        if (!session) {
+            return null;
+        }
+        const now = Date.now();
+        if (now >= session.expiresAt) {
+            // The hard-expiry timer has not fired yet (e.g. a suspended tab).
+            this.clearStepUpSession();
+            return null;
+        }
+        // `>=` so a zero max age always forces a fresh ceremony. Not cleared: the
+        // max age is this caller's requirement; others may still use the session.
+        const maxAge = request.maxSessionAgeMs;
+        if (maxAge !== undefined && now - session.token.obtainedAt >= maxAge) {
+            return null;
+        }
+        return session.token;
+    }
+    /**
+     * Opens the elevated session. Its lifetime is the session TTL clamped to
+     * the token's own `exp`, so the session never outlives the token.
+     *
+     * @param token - The freshly exchanged elevated token.
+     */
+    #openStepUpSession(token) {
+        this.clearStepUpSession();
+        const expiresAt = Math.min(token.obtainedAt + STEP_UP_SESSION_TTL_MS, token.claims.exp * 1000);
+        this.#stepUpSession = { token, expiresAt };
+        this.update((state) => {
+            state.stepUpSessionExpiresAt = expiresAt;
+        });
+        this.#stepUpTimer = setTimeout(() => this.clearStepUpSession(), Math.max(0, expiresAt - Date.now()));
+        // Never keep a Node process alive for the expiry timer (tests, tooling).
+        this.#stepUpTimer.unref?.();
+    }
+    /**
+     * Clears the in-memory elevated session and its expiration timer.
+     */
+    clearStepUpSession() {
+        if (this.#stepUpTimer !== undefined) {
+            clearTimeout(this.#stepUpTimer);
+            this.#stepUpTimer = undefined;
+        }
+        this.#stepUpSession = null;
+        if (this.state.stepUpSessionExpiresAt !== undefined) {
+            this.update((state) => {
+                state.stepUpSessionExpiresAt = undefined;
+            });
+        }
+    }
     /**
      * Drops the cached credential list. Callers that wipe profile state must go
      * through this so subscribers never keep credentials belonging to a profile
@@ -666,6 +817,7 @@ export class AuthenticationController extends BaseController {
     }
     performSignOut() {
         this.#authSessionEpoch += 1;
+        this.clearStepUpSession();
         this.#clearEnrolledCredentials();
         this.update((state) => {
             state.isSignedIn = false;
@@ -679,6 +831,7 @@ export class AuthenticationController extends BaseController {
     clearState() {
         this.#profilePairingRequestEpoch += 1;
         this.#authSessionEpoch += 1;
+        this.clearStepUpSession();
         this.#clearEnrolledCredentials();
         this.update(() => ({ ...defaultState }));
     }

package/dist/controllers/authentication/AuthenticationController.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthenticationController.js","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport { selectHdKeyringEntropySourceIds } from '@metamask/keyring-controller';\nimport type {\n  KeyringControllerGetStateAction,\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n  KeyringControllerWithKeyringV2UnsafeAction,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  SeedlessOnboardingControllerGetAccessTokenAction,\n  SeedlessOnboardingControllerGetStateAction,\n} from '@metamask/seedless-onboarding-controller';\nimport type { Json } from '@metamask/utils';\n\nimport {\n  BeginEnrollmentRequestStruct,\n  CompleteEnrollmentRequestStruct,\n  assertValidMfaRequest,\n} from '../../sdk/authentication-jwt-bearer/mfa/schemas.js';\nimport type {\n  LoginIdentifierType,\n  LoginResponse,\n  ProfileAlias,\n  SRPInterface,\n  SrpLoginTag,\n  UserProfile,\n  UserProfileLineage,\n  OidcTokenAudience,\n  OidcTokenClaims,\n  BeginEnrollmentRequest,\n  CompleteEnrollmentRequest,\n  EnrolledCredential,\n  EnrollmentChallenge,\n} from '../../sdk/index.js';\nimport {\n  assertMessageStartsWithMetamask,\n  AuthType,\n  Env,\n  JwtBearerAuth,\n  PairConflictError,\n  getMfaErrorCode,\n} from '../../sdk/index.js';\nimport type { MetaMetricsAuth } from '../../shared/types/services.js';\nimport { getPrimaryHdKeyringEntropySourceId } from '../../shared/utils/entropy-source.js';\nimport { getHdKeyringSeed } from '../../shared/utils/hd-keyring-seed.js';\nimport {\n  getMessageSigningPublicKey,\n  signMessageWithMessageSigningKey,\n} from '../../shared/utils/message-signing.js';\nimport { AuthenticationControllerMethodActions } from './AuthenticationController-method-action-types.js';\n\nconst controllerName = 'AuthenticationController';\n\n// State\nexport type AuthenticationControllerState = {\n  isSignedIn: boolean;\n  srpSessionData?: Record<string, LoginResponse>;\n  /**\n   * Credentials fetched for the current profile. The controller always seeds\n   * this to an empty array; it remains optional so partial-state selectors stay\n   * assignable to the controller state type.\n   */\n  enrolledCredentials?: EnrolledCredential[];\n  /**\n   * Client gate for profile pairing. Defaults to `true` (fresh install /\n   * upgrade), set to `false` after a successful `performSignIn` pair, set\n   * back to `true` via `requestProfilePairing()` when the SRP set changes,\n   * and left `true` on pair failure so the next state shift retries.\n   *\n   * Optional in the type so partial-state selectors stay assignable to\n   * `AuthenticationControllerState`. The controller seeds it via\n   * `defaultState` at construction; consumers should read `undefined` as\n   * `true` to mirror that runtime default.\n   */\n  needsProfilePairing?: boolean;\n  /**\n   * Client gate for social identifier pairing. Defaults to `true` (fresh\n   * install / upgrade), set to `false` after a successful or 409\n   * `POST /api/v2/profile/pair/identifier`, left `true` on other failures\n   * so the next `performSignIn` retries, and cleared without an API call\n   * when the user never logged in with a social provider.\n   *\n   * Optional in the type so partial-state selectors stay assignable to\n   * `AuthenticationControllerState`. The controller seeds it via\n   * `defaultState` at construction; consumers should read `undefined` as\n   * `true` to mirror that runtime default.\n   */\n  needsSocialPairing?: boolean;\n};\nexport const defaultState: AuthenticationControllerState = {\n  isSignedIn: false,\n  enrolledCredentials: [],\n  needsProfilePairing: true,\n  needsSocialPairing: true,\n};\nconst metadata: StateMetadata<AuthenticationControllerState> = {\n  isSignedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  needsProfilePairing: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  needsSocialPairing: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  srpSessionData: {\n    // Remove access token from state logs\n    includeInStateLogs: (srpSessionData) => {\n      // Unreachable branch, included just to fix a type error for the case where this property is\n      // unset. The type gets collapsed to include `| undefined` even though `undefined` is never\n      // set here, because we don't yet use `exactOptionalPropertyTypes`.\n      // TODO: Remove branch after enabling `exactOptionalPropertyTypes`\n      // ref: https://github.com/MetaMask/core/issues/6565\n      if (srpSessionData === null || srpSessionData === undefined) {\n        return null;\n      }\n      return Object.entries(srpSessionData).reduce<Record<string, Json>>(\n        (sanitizedSrpSessionData, [key, value]) => {\n          const { accessToken: _unused, ...tokenWithoutAccessToken } =\n            value.token;\n          sanitizedSrpSessionData[key] = {\n            ...value,\n            token: tokenWithoutAccessToken,\n          };\n          return sanitizedSrpSessionData;\n        },\n        {},\n      );\n    },\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n  enrolledCredentials: {\n    // Allow-list so new credential types cannot leak identifiers by default.\n    includeInStateLogs: (credentials) =>\n      credentials?.map(({ type, status, enrolledAt }) => ({\n        type,\n        status,\n        ...(enrolledAt === undefined ? {} : { enrolledAt }),\n      })) ?? null,\n    persist: false,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n};\n\ntype ControllerConfig = {\n  env: Env;\n  /**\n   * When `true`, `performSignIn` attempts to attach the Google/Apple/\n   * Telegram social identifier to the primary SRP profile. Defaults to\n   * `() => false`.\n   */\n  isSocialPairingEnabled: () => boolean;\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'performSignIn',\n  'performSignOut',\n  'getBearerToken',\n  'getSessionProfile',\n  'refreshCanonicalProfileId',\n  'getUserProfileLineage',\n  'getCustomerServiceToken',\n  'getPartnerIdentityToken',\n  'isSignedIn',\n  'requestProfilePairing',\n  'clearState',\n  'refreshEnrolledCredentials',\n  'beginCredentialEnrollment',\n  'completeCredentialEnrollment',\n] as const;\n\nexport type Actions =\n  | AuthenticationControllerGetStateAction\n  | AuthenticationControllerMethodActions;\n\nexport type AuthenticationControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AuthenticationControllerState\n>;\n\nexport type AuthenticationControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    AuthenticationControllerState\n  >;\n\nexport type ProfileSignInInfo = {\n  profileId: string;\n  profileAliases: ProfileAlias[];\n  profileIdChanged: boolean;\n};\n\nexport type AuthenticationControllerProfileSignInEvent = {\n  type: `${typeof controllerName}:profileSignIn`;\n  payload: [ProfileSignInInfo];\n};\n\nexport type Events =\n  | AuthenticationControllerStateChangeEvent\n  | AuthenticationControllerProfileSignInEvent;\n\n// Allowed Actions\ntype AllowedActions =\n  | KeyringControllerGetStateAction\n  | KeyringControllerWithKeyringV2UnsafeAction\n  | SeedlessOnboardingControllerGetStateAction\n  | SeedlessOnboardingControllerGetAccessTokenAction;\n\ntype AllowedEvents = KeyringControllerLockEvent | KeyringControllerUnlockEvent;\n\n// Messenger\nexport type AuthenticationControllerMessenger = Messenger<\n  typeof controllerName,\n  Actions | AllowedActions,\n  Events | AllowedEvents\n>;\n\n/**\n * Controller that enables authentication for restricted endpoints.\n * Used for Backup & Sync, Notifications, and other services.\n */\nexport class AuthenticationController extends BaseController<\n  typeof controllerName,\n  AuthenticationControllerState,\n  AuthenticationControllerMessenger\n> {\n  readonly #metametrics: MetaMetricsAuth;\n\n  readonly #auth: SRPInterface;\n\n  readonly #trace: TraceCallback;\n\n  readonly #config: ControllerConfig = {\n    env: Env.PRD,\n    isSocialPairingEnabled: () => false,\n  };\n\n  #isUnlocked = false;\n\n  /**\n   * Bumped whenever the authenticated session ends, so an in-flight MFA\n   * ceremony started under the previous session cannot apply its result.\n   */\n  #authSessionEpoch = 0;\n\n  /**\n   * Sequence number of the most recently started credentials refresh. Only\n   * that refresh may write the cache, so a slower, earlier request cannot\n   * overwrite a newer list (e.g. an explicit refresh landing after an\n   * enrollment's refresh).\n   */\n  #credentialsRefreshSeq = 0;\n\n  /**\n   * Bumped by `requestProfilePairing` and `clearState` so an in-flight\n   * `performSignIn` can't clear `needsProfilePairing` afterwards.\n   */\n  #profilePairingRequestEpoch = 0;\n\n  readonly #keyringController = {\n    setupLockedStateSubscriptions: () => {\n      const { isUnlocked } = this.messenger.call('KeyringController:getState');\n      this.#isUnlocked = isUnlocked;\n\n      this.messenger.subscribe('KeyringController:unlock', () => {\n        this.#isUnlocked = true;\n      });\n\n      this.messenger.subscribe('KeyringController:lock', () => {\n        this.#authSessionEpoch += 1;\n        this.#isUnlocked = false;\n      });\n    },\n  };\n\n  constructor({\n    messenger,\n    state,\n    config,\n    metametrics,\n    trace,\n  }: {\n    messenger: AuthenticationControllerMessenger;\n    state?: AuthenticationControllerState;\n    config?: Partial<ControllerConfig>;\n    /**\n     * Not using the Messaging System as we\n     * do not want to tie this strictly to extension\n     */\n    metametrics: MetaMetricsAuth;\n    trace?: TraceCallback;\n  }) {\n    super({\n      messenger,\n      metadata,\n      name: controllerName,\n      state: { ...defaultState, ...state },\n    });\n\n    if (!metametrics) {\n      throw new Error('`metametrics` field is required');\n    }\n\n    this.#config = {\n      ...this.#config,\n      ...config,\n      isSocialPairingEnabled:\n        config?.isSocialPairingEnabled ?? this.#config.isSocialPairingEnabled,\n    };\n\n    this.#metametrics = metametrics;\n    this.#trace = trace ?? (((_request, fn) => fn?.()) as TraceCallback);\n\n    this.#auth = new JwtBearerAuth(\n      {\n        env: this.#config.env,\n        platform: metametrics.agent,\n        type: AuthType.SRP,\n      },\n      {\n        storage: {\n          getLoginResponse: this.#getLoginResponseFromState.bind(this),\n          setLoginResponse: this.#setLoginResponseToState.bind(this),\n        },\n        signing: {\n          getIdentifier: this.#getPublicKey.bind(this),\n          signMessage: this.#signMessage.bind(this),\n        },\n        getLoginTag: this.#getLoginTag.bind(this),\n        getLoginIdentifierType: this.#getLoginIdentifierType.bind(this),\n        metametrics: this.#metametrics,\n      },\n    );\n\n    this.#keyringController.setupLockedStateSubscriptions();\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  async #getLoginResponseFromState(\n    entropySourceId?: string,\n  ): Promise<LoginResponse | null> {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    if (!this.state.srpSessionData?.[resolvedId]) {\n      return null;\n    }\n    return this.state.srpSessionData[resolvedId];\n  }\n\n  async #setLoginResponseToState(\n    loginResponse: LoginResponse,\n    entropySourceId?: string,\n  ) {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    const metaMetricsId = await this.#metametrics.getMetaMetricsId();\n    this.update((state) => {\n      state.isSignedIn = true;\n      if (!state.srpSessionData) {\n        state.srpSessionData = {};\n      }\n      state.srpSessionData[resolvedId] = {\n        ...loginResponse,\n        profile: {\n          ...loginResponse.profile,\n          metaMetricsId,\n        },\n      };\n    });\n  }\n\n  #assertIsUnlocked(methodName: string): void {\n    if (!this.#isUnlocked) {\n      throw new Error(`${methodName} - unable to proceed, wallet is locked`);\n    }\n  }\n\n  #assertAuthSessionEpoch(epoch: number, methodName: string): void {\n    if (!this.#isUnlocked || this.#authSessionEpoch !== epoch) {\n      throw new Error(\n        `${methodName} - unable to proceed, the authenticated session ended`,\n      );\n    }\n  }\n\n  /**\n   * Reads the HD keyring entropy source IDs from KeyringController.\n   *\n   * @returns The HD keyring metadata IDs, primary first.\n   */\n  #getHdKeyringEntropySourceIds(): string[] {\n    const keyringState = this.messenger.call('KeyringController:getState');\n    return selectHdKeyringEntropySourceIds(keyringState);\n  }\n\n  /**\n   * Resolves the primary SRP's entropy source ID from KeyringController rather\n   * than the message-signing snap, so callers like `getBearerToken()` are not\n   * blocked on snap boot.\n   *\n   * @returns The primary HD keyring metadata ID.\n   * @throws If no HD keyring is available; callers must only resolve while\n   * the wallet is unlocked.\n   */\n  #getPrimaryEntropySourceId(): string {\n    const keyringState = this.messenger.call('KeyringController:getState');\n    return getPrimaryHdKeyringEntropySourceId(keyringState);\n  }\n\n  /**\n   * Resolves the SRP login tag for `raw_message`.\n   *\n   * - `primary` for the first HD entropy source\n   * - `secondary` for any other entropy source\n   *\n   * @param entropySourceId - Entropy source for this login attempt.\n   * @returns The login tag to append to the signed message.\n   */\n  async #getLoginTag(entropySourceId?: string): Promise<SrpLoginTag> {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const resolvedId = entropySourceId ?? primaryEntropySourceId;\n\n    return resolvedId === primaryEntropySourceId ? 'primary' : 'secondary';\n  }\n\n  /**\n   * Resolves metametrics `identifier_type` for `/srp/login`\n   * (`SRP` | `GOOGLE` | `APPLE` | `TELEGRAM`).\n   *\n   * This is the auth method for the entropy source, independent of\n   * {@link SrpLoginTag} (`primary` / `secondary`).\n   *\n   * SeedlessOnboarding currently exposes a single vault-level\n   * `authConnection`, which always backs the primary entropy source. Non-\n   * primary sources therefore return `SRP`. If social identities become\n   * per-entropy later, resolve from that metadata instead of assuming\n   * primary === social.\n   *\n   * Soft-fails to `SRP` when SeedlessOnboarding is not registered.\n   *\n   * @param entropySourceId - Entropy source for this login attempt.\n   * @returns The login identifier type.\n   */\n  async #getLoginIdentifierType(\n    entropySourceId?: string,\n  ): Promise<LoginIdentifierType> {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const resolvedId = entropySourceId ?? primaryEntropySourceId;\n\n    // Social vault authConnection is only associated with the primary source.\n    if (resolvedId !== primaryEntropySourceId) {\n      return 'SRP';\n    }\n\n    return this.#resolveSocialIdentifierType();\n  }\n\n  /**\n   * Maps `SeedlessOnboardingController.state.authConnection` to a login\n   * identifier type when a social vault is present.\n   *\n   * Returns `SRP` if there is no vault, the provider is unrecognized, or\n   * SeedlessOnboardingController is unavailable on the messenger.\n   *\n   * @returns The social provider identifier type, or `SRP`.\n   */\n  #resolveSocialIdentifierType(): LoginIdentifierType {\n    try {\n      return this.#identifierTypeFromSeedlessState(\n        this.messenger.call('SeedlessOnboardingController:getState'),\n      );\n    } catch {\n      return 'SRP';\n    }\n  }\n\n  /**\n   * Maps SeedlessOnboarding vault + `authConnection` to a login identifier\n   * type. Does not catch messenger errors — callers decide whether a\n   * missing controller is `SRP` or a retryable failure.\n   *\n   * @param state - SeedlessOnboarding slice used for the mapping.\n   * @param state.vault - Encrypted social vault, if present.\n   * @param state.authConnection - Social provider id (`google` / `apple` /\n   * `telegram`).\n   * @returns The social provider identifier type, or `SRP`.\n   */\n  #identifierTypeFromSeedlessState(state: {\n    vault?: string | null;\n    authConnection?: string;\n  }): LoginIdentifierType {\n    if (state.vault === null || state.vault === undefined) {\n      return 'SRP';\n    }\n\n    // Match provider strings from SeedlessOnboarding state rather than\n    // importing AuthConnection — a value import would load that package\n    // (and its heavy deps) whenever this controller is imported.\n    switch (state.authConnection) {\n      case 'google':\n        return 'GOOGLE';\n      case 'apple':\n        return 'APPLE';\n      case 'telegram':\n        return 'TELEGRAM';\n      default:\n        return 'SRP';\n    }\n  }\n\n  public async performSignIn(): Promise<string[]> {\n    this.#assertIsUnlocked('performSignIn');\n\n    const epochAtStart = this.#profilePairingRequestEpoch;\n    const entropySourceIds = this.#getHdKeyringEntropySourceIds();\n    const accessTokens: string[] = [];\n\n    // We iterate sequentially in order to be sure that the first entry\n    // is the primary SRP LoginResponse.\n    for (const entropySourceId of entropySourceIds) {\n      const accessToken = await this.#auth.getAccessToken(entropySourceId);\n      accessTokens.push(accessToken);\n    }\n\n    if (entropySourceIds.length < 2) {\n      // Single-SRP wallet: nothing to pair.\n      this.#tryClearNeedsProfilePairing(epochAtStart);\n    } else {\n      // Pair failures must not break sign-in; the gate stays `true` for retry.\n      try {\n        await this.#doPair(accessTokens, epochAtStart);\n      } catch {\n        // noop\n      }\n    }\n\n    try {\n      await this.#trySocialPairing(accessTokens[0]);\n    } catch {\n      // noop\n    }\n\n    return accessTokens;\n  }\n\n  /**\n   * Attaches a Google/Apple/Telegram social identifier to the primary SRP\n   * profile via `POST /api/v2/profile/pair/identifier`.\n   *\n   * Runs only when `isSocialPairingEnabled()` is true and\n   * `needsSocialPairing` is not `false` (`undefined` is treated as true).\n   * No social provider (`authConnection` unset) → clear the flag (nothing\n   * to pair). Social provider set but vault missing → skip (onboarding\n   * still in flight). Google without email → skip (API requires it).\n   * Telegram never sends `email` (the field holds a display name, not an\n   * address). Missing social JWT → skip. 409 Conflict → clear the flag\n   * (identifier already owned; retry is pointless). Other errors\n   * propagate so the caller can swallow them and leave the flag set for\n   * retry.\n   *\n   * @param primaryAccessToken - Primary SRP OIDC access token used as the\n   * Bearer credential. The profile associated with this JWT becomes the\n   * canonical owner of the social identifier.\n   */\n  async #trySocialPairing(primaryAccessToken?: string): Promise<void> {\n    if (\n      !this.#config.isSocialPairingEnabled() ||\n      this.state.needsSocialPairing === false ||\n      !primaryAccessToken\n    ) {\n      return;\n    }\n\n    let seedlessState: {\n      vault?: string | null;\n      authConnection?: string;\n      socialLoginEmail?: string;\n    };\n    try {\n      seedlessState = this.messenger.call(\n        'SeedlessOnboardingController:getState',\n      );\n    } catch {\n      // Controller missing or getState failed — retry next performSignIn.\n      return;\n    }\n\n    // `SRP` here does not describe the vault: it is the mapping's \"no social\n    // identity\" result, returned when there is no seedless vault or the\n    // provider is unrecognised. In both cases there is nothing to pair.\n    const identifierType = this.#identifierTypeFromSeedlessState(seedlessState);\n    if (identifierType === 'SRP') {\n      const { vault, authConnection } = seedlessState;\n      // Vault not written yet but a social provider is already known —\n      // onboarding is still in flight. Do not clear; retry next sign-in.\n      if ((vault === null || vault === undefined) && Boolean(authConnection)) {\n        return;\n      }\n      this.#clearNeedsSocialPairing();\n      return;\n    }\n\n    // Email policy follows the API contract: GOOGLE requires `email` (400\n    // without it), APPLE accepts it optionally, TELEGRAM must not send it\n    // (clients store a display name in `socialLoginEmail` for Telegram).\n    // Clients request the `email` scope for Google, so a missing value is a\n    // defensive case rather than an expected one; returning here leaves\n    // `needsSocialPairing` set so the next sign-in retries instead of\n    // sending a request that would fail.\n    const { socialLoginEmail } = seedlessState;\n    let email: string | undefined;\n    if (identifierType === 'GOOGLE') {\n      if (!socialLoginEmail) {\n        return;\n      }\n      email = socialLoginEmail;\n    } else if (identifierType === 'APPLE') {\n      email = socialLoginEmail;\n    }\n\n    const socialJwt = await this.messenger.call(\n      'SeedlessOnboardingController:getAccessToken',\n    );\n    if (socialJwt === undefined || socialJwt === '') {\n      return;\n    }\n\n    try {\n      await this.#auth.pairSocialIdentifier(\n        {\n          identifierType,\n          socialJwt,\n          ...(email ? { email } : {}),\n        },\n        primaryAccessToken,\n      );\n      this.#clearNeedsSocialPairing();\n    } catch (error) {\n      if (error instanceof PairConflictError) {\n        this.#clearNeedsSocialPairing();\n        return;\n      }\n      throw error;\n    }\n  }\n\n  #clearNeedsSocialPairing(): void {\n    if (this.state.needsSocialPairing !== false) {\n      this.update((state) => {\n        state.needsSocialPairing = false;\n      });\n    }\n  }\n\n  /**\n   * Marks profile pairing as needed. Clients call this when the SRP set\n   * changes (e.g. a new keyring was added) so the next auto-sign-in cycle\n   * re-runs `performSignIn` and re-pairs.\n   */\n  public requestProfilePairing(): void {\n    this.#profilePairingRequestEpoch += 1;\n    if (!this.state.needsProfilePairing) {\n      this.update((state) => {\n        state.needsProfilePairing = true;\n      });\n    }\n  }\n\n  /**\n   * Clears `needsProfilePairing` only if no `requestProfilePairing` call\n   * landed since `epochAtStart` was captured. Prevents `performSignIn`\n   * from silently overwriting a concurrent rearm.\n   *\n   * @param epochAtStart - Epoch value captured at the start of `performSignIn`.\n   */\n  #tryClearNeedsProfilePairing(epochAtStart: number): void {\n    if (this.#profilePairingRequestEpoch !== epochAtStart) {\n      return;\n    }\n    if (this.state.needsProfilePairing) {\n      this.update((state) => {\n        state.needsProfilePairing = false;\n      });\n    }\n  }\n\n  /**\n   * Pairs all SRPs via `POST /profile/pair`, propagates the canonical\n   * profile ID, clears `needsProfilePairing`, and emits\n   * `AuthenticationController:profileSignIn` when the canonical changes or\n   * new aliases are returned. Throws on failure.\n   *\n   * @param accessTokens - Per-SRP access tokens, primary first.\n   * @param epochAtStart - Pairing-request epoch captured by the caller.\n   * Used to skip the gate clear if `requestProfilePairing` ran while the\n   * pair API call was in-flight.\n   */\n  async #doPair(accessTokens: string[], epochAtStart: number): Promise<void> {\n    const previousCanonical = this.#getCanonicalProfileId();\n\n    const profileAliases = await this.#pairSrpProfiles(accessTokens);\n    const newCanonical = this.#getCanonicalProfileId();\n\n    // If somehow we cannot compute the new canonical profile ID after pairing,\n    // we just return now and do not update the `needsProfilePairing` flag.\n    if (!newCanonical) {\n      return;\n    }\n\n    this.#tryClearNeedsProfilePairing(epochAtStart);\n\n    const profileIdChanged = previousCanonical !== newCanonical;\n    const shouldEmitProfileSignInEvent =\n      profileIdChanged || profileAliases.length > 0;\n\n    if (shouldEmitProfileSignInEvent) {\n      this.messenger.publish('AuthenticationController:profileSignIn', {\n        profileId: newCanonical,\n        profileAliases,\n        profileIdChanged,\n      });\n    }\n  }\n\n  async #pairSrpProfiles(accessTokens: string[]): Promise<ProfileAlias[]> {\n    if (accessTokens.length < 2) {\n      return [];\n    }\n    const primaryAccessToken = accessTokens[0]; // Associated with primary SRP.\n    const {\n      profileAliases,\n      profile: { canonicalProfileId },\n    } = await this.#auth.pairSrpProfiles(accessTokens, primaryAccessToken);\n    this.#propagateCanonical(canonicalProfileId);\n    return profileAliases;\n  }\n\n  #propagateCanonical(canonicalProfileId: string): void {\n    const { srpSessionData } = this.state;\n    if (!srpSessionData) {\n      return;\n    }\n\n    this.update((state) => {\n      for (const entry of Object.values(state.srpSessionData ?? {})) {\n        if (entry?.profile) {\n          entry.profile.canonicalProfileId = canonicalProfileId;\n        }\n      }\n    });\n  }\n\n  /**\n   * Returns the canonical profile id from the primary SRP's cached session.\n   * Returns `null` when no session exists yet for the primary SRP.\n   *\n   * Always reads from the primary SRP because the canonical is shared across\n   * all paired SRPs after `#propagateCanonical`.\n   *\n   * @returns The canonical profile id, or `null` if unavailable.\n   */\n  #getCanonicalProfileId(): string | null {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    return (\n      this.state.srpSessionData?.[primaryEntropySourceId]?.profile\n        ?.canonicalProfileId ?? null\n    );\n  }\n\n  /**\n   * Runs one MFA network step inside a trace span tagged with the caller's\n   * operation and the credential type, recording the outcome and MFA error\n   * code.\n   *\n   * @param name - Span name.\n   * @param operation - Caller-supplied `reason.operation`.\n   * @param credentialType - Credential type the step concerns.\n   * @param fn - The network step.\n   * @returns The step's result.\n   */\n  async #runMfaRequest<Result>(\n    name: string,\n    operation: string,\n    credentialType: string,\n    fn: () => Promise<Result>,\n  ): Promise<Result> {\n    const data: Record<string, string> = { outcome: 'pending' };\n    return await this.#trace(\n      {\n        name,\n        tags: { operation, credentialType },\n        data,\n      },\n      async () => {\n        try {\n          const result = await fn();\n          data.outcome = 'success';\n          return result;\n        } catch (error) {\n          data.outcome = 'error';\n          const mfaCode = getMfaErrorCode(error);\n          if (mfaCode) {\n            data.mfaErrorCode = mfaCode;\n          }\n          throw error;\n        }\n      },\n    );\n  }\n\n  /**\n   * Refreshes credentials enrolled on the canonical profile.\n   *\n   * @returns The current supported credentials.\n   */\n  public async refreshEnrolledCredentials(): Promise<EnrolledCredential[]> {\n    this.#assertIsUnlocked('refreshEnrolledCredentials');\n    const sessionEpoch = this.#authSessionEpoch;\n    this.#credentialsRefreshSeq += 1;\n    const refreshSeq = this.#credentialsRefreshSeq;\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const credentials = await this.#runMfaRequest(\n      'MFA Credentials Refresh',\n      'credentials.refresh',\n      'all',\n      async () => await this.#auth.getMfaCredentials(primaryEntropySourceId),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'refreshEnrolledCredentials');\n\n    // A newer refresh started while this one was in flight; its result is at\n    // least as fresh, so defer to it rather than overwrite with older data.\n    if (refreshSeq !== this.#credentialsRefreshSeq) {\n      return this.#getEnrolledCredentials();\n    }\n\n    // Skip the write when nothing changed so subscribers are not woken up by\n    // a fresh-but-identical array.\n    if (\n      JSON.stringify(credentials) !==\n      JSON.stringify(this.#getEnrolledCredentials())\n    ) {\n      this.update((state) => {\n        state.enrolledCredentials = credentials;\n      });\n    }\n    return credentials;\n  }\n\n  /**\n   * Begins enrollment of a passkey or email OTP credential.\n   *\n   * @param request - Credential, optional email address, and trace reason.\n   * @returns A challenge for the client-owned ceremony.\n   */\n  public async beginCredentialEnrollment(\n    request: BeginEnrollmentRequest,\n  ): Promise<EnrollmentChallenge> {\n    this.#assertIsUnlocked('beginCredentialEnrollment');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, BeginEnrollmentRequestStruct);\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const challenge = await this.#runMfaRequest(\n      'MFA Enroll Begin',\n      request.reason.operation,\n      request.type,\n      async () =>\n        await this.#auth.beginMfaEnrollment(request.type, {\n          email: request.email,\n          entropySourceId: primaryEntropySourceId,\n        }),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'beginCredentialEnrollment');\n    return challenge;\n  }\n\n  /**\n   * Completes credential enrollment and refreshes the credential cache.\n   *\n   * A cache-refresh failure does not undo successful enrollment. Email\n   * enrollment invalidates the primary SRP session *after* refresh so the\n   * credentials call can reuse the still-valid access token; the next token\n   * fetch then includes the newly verified email claim. That invalidation\n   * happens even if the session ends mid-request: the enrollment succeeded\n   * on the server, so a token cached across a lock must not be reused\n   * without the new claim.\n   *\n   * @param request - Flow identifier, platform or email proof, and trace reason.\n   * @returns The refreshed credentials, or the existing cache if refresh fails.\n   */\n  public async completeCredentialEnrollment(\n    request: CompleteEnrollmentRequest,\n  ): Promise<EnrolledCredential[]> {\n    this.#assertIsUnlocked('completeCredentialEnrollment');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, CompleteEnrollmentRequestStruct);\n    const { type } = request.proof;\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    await this.#runMfaRequest(\n      'MFA Enroll Complete',\n      request.reason.operation,\n      type,\n      async () =>\n        await this.#auth.completeMfaEnrollment(\n          request.flowId,\n          request.proof,\n          primaryEntropySourceId,\n        ),\n    );\n\n    try {\n      this.#assertAuthSessionEpoch(\n        sessionEpoch,\n        'completeCredentialEnrollment',\n      );\n    } catch (error) {\n      if (type === 'email_otp') {\n        this.#invalidateSrpSession(primaryEntropySourceId);\n      }\n      throw error;\n    }\n\n    try {\n      return await this.refreshEnrolledCredentials();\n    } catch {\n      return this.#getEnrolledCredentials();\n    } finally {\n      if (type === 'email_otp') {\n        this.#invalidateSrpSession(primaryEntropySourceId);\n      }\n    }\n  }\n\n  /**\n   * Drops the cached credential list. Callers that wipe profile state must go\n   * through this so subscribers never keep credentials belonging to a profile\n   * that is no longer active.\n   */\n  #clearEnrolledCredentials(): void {\n    if (this.#getEnrolledCredentials().length === 0) {\n      return;\n    }\n    this.update((state) => {\n      state.enrolledCredentials = [];\n    });\n  }\n\n  #getEnrolledCredentials(): EnrolledCredential[] {\n    return this.state.enrolledCredentials ?? [];\n  }\n\n  public performSignOut(): void {\n    this.#authSessionEpoch += 1;\n    this.#clearEnrolledCredentials();\n    this.update((state) => {\n      state.isSignedIn = false;\n      state.srpSessionData = undefined;\n    });\n  }\n\n  /**\n   * Resets the controller to `defaultState`. Clients call this on wallet reset\n   * so the next wallet starts unsigned with both pairing gates re-armed.\n   */\n  public clearState(): void {\n    this.#profilePairingRequestEpoch += 1;\n    this.#authSessionEpoch += 1;\n    this.#clearEnrolledCredentials();\n    this.update(() => ({ ...defaultState }));\n  }\n\n  /**\n   * Returns a bearer token for the specified SRP, logging in if needed.\n   *\n   * When called without `entropySourceId`, returns the primary (first) SRP's\n   * access token, which is effectively the canonical\n   * profile's token that can be used by alias-aware consumers for cross-SRP\n   * operations.\n   *\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The OIDC access token.\n   */\n  public async getBearerToken(entropySourceId?: string): Promise<string> {\n    this.#assertIsUnlocked('getBearerToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getAccessToken(resolvedId);\n  }\n\n  /**\n   * Returns the cached session profile, logging in if no session exists.\n   *\n   * The returned `canonicalProfileId` reflects the value from the most recent\n   * login or pairing. In the rare event where a canonical changed because of\n   * a pairing that happened on another device, the cached value may be stale\n   * until the next login. For guaranteed freshness, call\n   * `refreshCanonicalProfileId()` before reading `canonicalProfileId`.\n   *\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns profile for the session.\n   */\n  public async getSessionProfile(\n    entropySourceId?: string,\n  ): Promise<UserProfile> {\n    this.#assertIsUnlocked('getSessionProfile');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getUserProfile(resolvedId);\n  }\n\n  /**\n   * Forces a fresh retrieval of the canonical profile ID from the server\n   * and propagates it to all cached SRP sessions.\n   *\n   * This method invalidates the primary SRP's cached session and forces a\n   * re-login. Use it before operations that require a guaranteed-fresh\n   * canonical (e.g. storage key derivation for Accounts ADR 0005). For\n   * best-effort reads, use\n   * `getSessionProfile().canonicalProfileId` instead.\n   *\n   * Only the primary SRP is re-logged-in regardless of how many SRPs exist —\n   * the server returns the current canonical for the entire pairing group\n   * from any single SRP login.\n   *\n   * @returns The refreshed canonical profile ID.\n   */\n  public async refreshCanonicalProfileId(): Promise<string> {\n    this.#assertIsUnlocked('refreshCanonicalProfileId');\n\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    this.#invalidateSrpSession(primaryEntropySourceId);\n    await this.#auth.getAccessToken(primaryEntropySourceId);\n\n    const canonical = this.#getCanonicalProfileId();\n    if (!canonical) {\n      throw new Error(\n        'refreshCanonicalProfileId - Unable to resolve canonical profile ID',\n      );\n    }\n\n    this.#propagateCanonical(canonical);\n    return canonical;\n  }\n\n  #invalidateSrpSession(entropySourceId: string): void {\n    this.update((state) => {\n      const entry = state.srpSessionData?.[entropySourceId];\n      if (entry?.profile) {\n        // Setting canonicalProfileId to '' forces a re-fetch on the next\n        // #getAuthSession call. The falsy check (!auth.profile.canonicalProfileId)\n        // treats '' the same as undefined/null — all signal an invalid session.\n        entry.profile.canonicalProfileId = '';\n      }\n    });\n  }\n\n  public async getUserProfileLineage(\n    entropySourceId?: string,\n  ): Promise<UserProfileLineage> {\n    this.#assertIsUnlocked('getUserProfileLineage');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getUserProfileLineage(resolvedId);\n  }\n\n  /**\n   * Returns a Customer Service specific access token for the specified SRP,\n   * logging in if needed.\n   *\n   * Exchanges the OIDC access token for a short-lived token scoped to the\n   * customer-service audience. Customer Service tooling consumes this token to\n   * identify and authenticate the user.\n   *\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The customer-service access token.\n   */\n  public async getCustomerServiceToken(\n    entropySourceId?: string,\n  ): Promise<string> {\n    this.#assertIsUnlocked('getCustomerServiceToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getCustomerServiceToken(resolvedId);\n  }\n\n  /**\n   * Mints a partner identity token for the specified SRP, logging in if needed.\n   *\n   * Calls `POST /api/v2/oidc/token` with the Hydra login bearer and returns\n   * the minted `access_token`. Email on live tokens is under JWT `ext`.\n   * HTTP 422 throws `EmailRequiredError` when this profile has no\n   * verified email.\n   *\n   * @param claims - Claim names to embed. Only `email` is supported.\n   * @param audience - Partner audience (`kyc` or `iron`).\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The partner identity access token.\n   */\n  public async getPartnerIdentityToken(\n    claims: OidcTokenClaims,\n    audience: OidcTokenAudience,\n    entropySourceId?: string,\n  ): Promise<string> {\n    this.#assertIsUnlocked('getPartnerIdentityToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getPartnerIdentityToken(\n      claims,\n      audience,\n      resolvedId,\n    );\n  }\n\n  public isSignedIn(): boolean {\n    return this.state.isSignedIn;\n  }\n\n  /**\n   * Reads the BIP-39 seed for an HD entropy source from KeyringController.\n   *\n   * @param entropySourceId - Entropy source ID. Defaults to the primary HD\n   * keyring.\n   * @returns The HD keyring seed.\n   */\n  async #getHdKeyringSeed(entropySourceId?: string): Promise<Uint8Array> {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return getHdKeyringSeed(this.messenger, resolvedId);\n  }\n\n  /**\n   * Returns the message-signing public key via native SIP-6 derivation\n   * (same key as `@metamask/message-signing-snap` with empty salt).\n   *\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns The public key hex.\n   */\n  async #getPublicKey(entropySourceId?: string): Promise<string> {\n    this.#assertIsUnlocked('#getPublicKey');\n    const seed = await this.#getHdKeyringSeed(entropySourceId);\n    return getMessageSigningPublicKey(seed);\n  }\n\n  #_signMessageCache: Record<string, string> = {};\n\n  /**\n   * Builds a cache key scoped to a specific entropy source, so each SRP's\n   * signature stays isolated (same pattern as `UserStorageController`).\n   *\n   * When `entropySourceId` is omitted (primary SRP), it is resolved to the\n   * primary HD keyring's metadata ID rather than a stable literal. Because that\n   * ID is randomly regenerated whenever the vault is recreated (e.g. on\n   * restore), the cached entry is naturally invalidated across vaults — a\n   * different SRP can never inherit the previous primary's cached signature.\n   *\n   * @param message - The tagged message used for signing.\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The scoped cache key.\n   */\n  #scopedCacheKey(\n    message: `metamask:${string}`,\n    entropySourceId?: string,\n  ): string {\n    return `${entropySourceId ?? this.#getPrimaryEntropySourceId()}:${message}`;\n  }\n\n  /**\n   * Signs a `metamask:…` message with the native SIP-6 message-signing key.\n   *\n   * @param message - A specific tagged message to sign.\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns Compact secp256k1 signature hex.\n   */\n  async #signMessage(\n    message: string,\n    entropySourceId?: string,\n  ): Promise<string> {\n    assertMessageStartsWithMetamask(message);\n    this.#assertIsUnlocked('#signMessage');\n\n    const cacheKey = this.#scopedCacheKey(message, entropySourceId);\n    if (this.#_signMessageCache[cacheKey]) {\n      return this.#_signMessageCache[cacheKey];\n    }\n\n    const seed = await this.#getHdKeyringSeed(entropySourceId);\n    const result = await signMessageWithMessageSigningKey(message, seed);\n\n    this.#_signMessageCache[cacheKey] = result;\n\n    return result;\n  }\n}\n"]}
+{"version":3,"file":"AuthenticationController.js","sourceRoot":"","sources":["../../../src/controllers/authentication/AuthenticationController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type { TraceCallback, TraceContext } from '@metamask/controller-utils';\nimport { selectHdKeyringEntropySourceIds } from '@metamask/keyring-controller';\nimport type {\n  KeyringControllerGetStateAction,\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n  KeyringControllerWithKeyringV2UnsafeAction,\n} from '@metamask/keyring-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n  SeedlessOnboardingControllerGetAccessTokenAction,\n  SeedlessOnboardingControllerGetStateAction,\n} from '@metamask/seedless-onboarding-controller';\nimport type { Json } from '@metamask/utils';\n\nimport {\n  BeginEnrollmentRequestStruct,\n  CompleteEnrollmentRequestStruct,\n  assertValidMfaRequest,\n  BeginStepUpRequestStruct,\n  CompleteStepUpRequestStruct,\n  GetElevatedTokenRequestStruct,\n  parseElevatedTokenClaims,\n} from '../../sdk/authentication-jwt-bearer/mfa/schemas.js';\nimport type {\n  LoginIdentifierType,\n  LoginResponse,\n  ProfileAlias,\n  SRPInterface,\n  SrpLoginTag,\n  UserProfile,\n  UserProfileLineage,\n  OidcTokenAudience,\n  OidcTokenClaims,\n  BeginEnrollmentRequest,\n  CompleteEnrollmentRequest,\n  EnrolledCredential,\n  EnrollmentChallenge,\n  BeginStepUpRequest,\n  CompleteStepUpRequest,\n  ElevatedProfileToken,\n  GetElevatedTokenRequest,\n  StepUpChallenge,\n} from '../../sdk/index.js';\nimport {\n  assertMessageStartsWithMetamask,\n  AuthType,\n  Env,\n  JwtBearerAuth,\n  PairConflictError,\n  getMfaErrorCode,\n  ElevatedTokenInvalidError,\n} from '../../sdk/index.js';\nimport { decodeJwtPayload } from '../../sdk/utils/jwt.js';\nimport { toErrorMessage } from '../../sdk/utils/to-error-message.js';\nimport type { MetaMetricsAuth } from '../../shared/types/services.js';\nimport { getPrimaryHdKeyringEntropySourceId } from '../../shared/utils/entropy-source.js';\nimport { getHdKeyringSeed } from '../../shared/utils/hd-keyring-seed.js';\nimport {\n  getMessageSigningPublicKey,\n  signMessageWithMessageSigningKey,\n} from '../../shared/utils/message-signing.js';\nimport { AuthenticationControllerMethodActions } from './AuthenticationController-method-action-types.js';\n\nconst controllerName = 'AuthenticationController';\n\n// State\nexport type AuthenticationControllerState = {\n  isSignedIn: boolean;\n  srpSessionData?: Record<string, LoginResponse>;\n  /**\n   * Credentials fetched for the current profile. The controller always seeds\n   * this to an empty array; it remains optional so partial-state selectors stay\n   * assignable to the controller state type.\n   */\n  enrolledCredentials?: EnrolledCredential[];\n  /**\n   * Epoch-ms hard expiry of the in-memory elevated session, or undefined when\n   * none is open. Lets UI show \"verified\" state without holding the token.\n   */\n  stepUpSessionExpiresAt?: number;\n  /**\n   * Client gate for profile pairing. Defaults to `true` (fresh install /\n   * upgrade), set to `false` after a successful `performSignIn` pair, set\n   * back to `true` via `requestProfilePairing()` when the SRP set changes,\n   * and left `true` on pair failure so the next state shift retries.\n   *\n   * Optional in the type so partial-state selectors stay assignable to\n   * `AuthenticationControllerState`. The controller seeds it via\n   * `defaultState` at construction; consumers should read `undefined` as\n   * `true` to mirror that runtime default.\n   */\n  needsProfilePairing?: boolean;\n  /**\n   * Client gate for social identifier pairing. Defaults to `true` (fresh\n   * install / upgrade), set to `false` after a successful or 409\n   * `POST /api/v2/profile/pair/identifier`, left `true` on other failures\n   * so the next `performSignIn` retries, and cleared without an API call\n   * when the user never logged in with a social provider.\n   *\n   * Optional in the type so partial-state selectors stay assignable to\n   * `AuthenticationControllerState`. The controller seeds it via\n   * `defaultState` at construction; consumers should read `undefined` as\n   * `true` to mirror that runtime default.\n   */\n  needsSocialPairing?: boolean;\n};\nexport const defaultState: AuthenticationControllerState = {\n  isSignedIn: false,\n  enrolledCredentials: [],\n  needsProfilePairing: true,\n  needsSocialPairing: true,\n};\nconst metadata: StateMetadata<AuthenticationControllerState> = {\n  isSignedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  needsProfilePairing: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  needsSocialPairing: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  srpSessionData: {\n    // Remove access token from state logs\n    includeInStateLogs: (srpSessionData) => {\n      // Unreachable branch, included just to fix a type error for the case where this property is\n      // unset. The type gets collapsed to include `| undefined` even though `undefined` is never\n      // set here, because we don't yet use `exactOptionalPropertyTypes`.\n      // TODO: Remove branch after enabling `exactOptionalPropertyTypes`\n      // ref: https://github.com/MetaMask/core/issues/6565\n      if (srpSessionData === null || srpSessionData === undefined) {\n        return null;\n      }\n      return Object.entries(srpSessionData).reduce<Record<string, Json>>(\n        (sanitizedSrpSessionData, [key, value]) => {\n          const { accessToken: _unused, ...tokenWithoutAccessToken } =\n            value.token;\n          sanitizedSrpSessionData[key] = {\n            ...value,\n            token: tokenWithoutAccessToken,\n          };\n          return sanitizedSrpSessionData;\n        },\n        {},\n      );\n    },\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n  enrolledCredentials: {\n    // Allow-list so new credential types cannot leak identifiers by default.\n    includeInStateLogs: (credentials) =>\n      credentials?.map(({ type, status, enrolledAt }) => ({\n        type,\n        status,\n        ...(enrolledAt === undefined ? {} : { enrolledAt }),\n      })) ?? null,\n    persist: false,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n  stepUpSessionExpiresAt: {\n    includeInStateLogs: false,\n    persist: false,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n};\n\n/**\n * Lifetime of an elevated session. Deliberately shorter than the\n * elevated token's own `exp` so a fresh ceremony is required per sensitive\n * action window, per the MFA phase-1 specification.\n */\nexport const STEP_UP_SESSION_TTL_MS = 60_000;\n\ntype ControllerConfig = {\n  env: Env;\n  /**\n   * When `true`, `performSignIn` attempts to attach the Google/Apple/\n   * Telegram social identifier to the primary SRP profile. Defaults to\n   * `() => false`.\n   */\n  isSocialPairingEnabled: () => boolean;\n};\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'performSignIn',\n  'performSignOut',\n  'getBearerToken',\n  'getSessionProfile',\n  'refreshCanonicalProfileId',\n  'getUserProfileLineage',\n  'getCustomerServiceToken',\n  'getPartnerIdentityToken',\n  'isSignedIn',\n  'requestProfilePairing',\n  'clearState',\n  'refreshEnrolledCredentials',\n  'beginCredentialEnrollment',\n  'completeCredentialEnrollment',\n  'beginStepUp',\n  'completeStepUp',\n  'getElevatedProfileToken',\n  'clearStepUpSession',\n] as const;\n\nexport type Actions =\n  | AuthenticationControllerGetStateAction\n  | AuthenticationControllerMethodActions;\n\nexport type AuthenticationControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AuthenticationControllerState\n>;\n\nexport type AuthenticationControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    AuthenticationControllerState\n  >;\n\nexport type ProfileSignInInfo = {\n  profileId: string;\n  profileAliases: ProfileAlias[];\n  profileIdChanged: boolean;\n};\n\nexport type AuthenticationControllerProfileSignInEvent = {\n  type: `${typeof controllerName}:profileSignIn`;\n  payload: [ProfileSignInInfo];\n};\n\nexport type Events =\n  | AuthenticationControllerStateChangeEvent\n  | AuthenticationControllerProfileSignInEvent;\n\n// Allowed Actions\ntype AllowedActions =\n  | KeyringControllerGetStateAction\n  | KeyringControllerWithKeyringV2UnsafeAction\n  | SeedlessOnboardingControllerGetStateAction\n  | SeedlessOnboardingControllerGetAccessTokenAction;\n\ntype AllowedEvents = KeyringControllerLockEvent | KeyringControllerUnlockEvent;\n\n// Messenger\nexport type AuthenticationControllerMessenger = Messenger<\n  typeof controllerName,\n  Actions | AllowedActions,\n  Events | AllowedEvents\n>;\n\n/**\n * Controller that enables authentication for restricted endpoints.\n * Used for Backup & Sync, Notifications, and other services.\n */\nexport class AuthenticationController extends BaseController<\n  typeof controllerName,\n  AuthenticationControllerState,\n  AuthenticationControllerMessenger\n> {\n  readonly #metametrics: MetaMetricsAuth;\n\n  readonly #auth: SRPInterface;\n\n  readonly #trace: TraceCallback;\n\n  readonly #config: ControllerConfig = {\n    env: Env.PRD,\n    isSocialPairingEnabled: () => false,\n  };\n\n  #isUnlocked = false;\n\n  /**\n   * Bumped whenever the authenticated session ends, so an in-flight MFA\n   * ceremony started under the previous session cannot apply its result.\n   */\n  #authSessionEpoch = 0;\n\n  #stepUpSession: {\n    token: ElevatedProfileToken;\n    expiresAt: number;\n  } | null = null;\n\n  #stepUpTimer: ReturnType<typeof setTimeout> | undefined;\n\n  /**\n   * Sequence number of the most recently started credentials refresh. Only\n   * that refresh may write the cache, so a slower, earlier request cannot\n   * overwrite a newer list (e.g. an explicit refresh landing after an\n   * enrollment's refresh).\n   */\n  #credentialsRefreshSeq = 0;\n\n  /**\n   * Bumped by `requestProfilePairing` and `clearState` so an in-flight\n   * `performSignIn` can't clear `needsProfilePairing` afterwards.\n   */\n  #profilePairingRequestEpoch = 0;\n\n  readonly #keyringController = {\n    setupLockedStateSubscriptions: () => {\n      const { isUnlocked } = this.messenger.call('KeyringController:getState');\n      this.#isUnlocked = isUnlocked;\n\n      this.messenger.subscribe('KeyringController:unlock', () => {\n        this.#isUnlocked = true;\n      });\n\n      this.messenger.subscribe('KeyringController:lock', () => {\n        this.#authSessionEpoch += 1;\n        this.#isUnlocked = false;\n        this.clearStepUpSession();\n      });\n    },\n  };\n\n  constructor({\n    messenger,\n    state,\n    config,\n    metametrics,\n    trace,\n  }: {\n    messenger: AuthenticationControllerMessenger;\n    state?: AuthenticationControllerState;\n    config?: Partial<ControllerConfig>;\n    /**\n     * Not using the Messaging System as we\n     * do not want to tie this strictly to extension\n     */\n    metametrics: MetaMetricsAuth;\n    trace?: TraceCallback;\n  }) {\n    super({\n      messenger,\n      metadata,\n      name: controllerName,\n      state: { ...defaultState, ...state },\n    });\n\n    if (!metametrics) {\n      throw new Error('`metametrics` field is required');\n    }\n\n    // `??` per key so an explicit `undefined` keeps the default rather than\n    // clobbering it.\n    this.#config = {\n      env: config?.env ?? this.#config.env,\n      isSocialPairingEnabled:\n        config?.isSocialPairingEnabled ?? this.#config.isSocialPairingEnabled,\n    };\n\n    this.#metametrics = metametrics;\n    this.#trace = trace ?? (((_request, fn) => fn?.()) as TraceCallback);\n\n    this.#auth = new JwtBearerAuth(\n      {\n        env: this.#config.env,\n        platform: metametrics.agent,\n        type: AuthType.SRP,\n      },\n      {\n        storage: {\n          getLoginResponse: this.#getLoginResponseFromState.bind(this),\n          setLoginResponse: this.#setLoginResponseToState.bind(this),\n        },\n        signing: {\n          getIdentifier: this.#getPublicKey.bind(this),\n          signMessage: this.#signMessage.bind(this),\n        },\n        getLoginTag: this.#getLoginTag.bind(this),\n        getLoginIdentifierType: this.#getLoginIdentifierType.bind(this),\n        metametrics: this.#metametrics,\n      },\n    );\n\n    this.#keyringController.setupLockedStateSubscriptions();\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  async #getLoginResponseFromState(\n    entropySourceId?: string,\n  ): Promise<LoginResponse | null> {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    if (!this.state.srpSessionData?.[resolvedId]) {\n      return null;\n    }\n    return this.state.srpSessionData[resolvedId];\n  }\n\n  async #setLoginResponseToState(\n    loginResponse: LoginResponse,\n    entropySourceId?: string,\n  ) {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    const metaMetricsId = await this.#metametrics.getMetaMetricsId();\n    this.update((state) => {\n      state.isSignedIn = true;\n      if (!state.srpSessionData) {\n        state.srpSessionData = {};\n      }\n      state.srpSessionData[resolvedId] = {\n        ...loginResponse,\n        profile: {\n          ...loginResponse.profile,\n          metaMetricsId,\n        },\n      };\n    });\n  }\n\n  #assertIsUnlocked(methodName: string): void {\n    if (!this.#isUnlocked) {\n      throw new Error(`${methodName} - unable to proceed, wallet is locked`);\n    }\n  }\n\n  #assertAuthSessionEpoch(epoch: number, methodName: string): void {\n    if (!this.#isUnlocked || this.#authSessionEpoch !== epoch) {\n      throw new Error(\n        `${methodName} - unable to proceed, the authenticated session ended`,\n      );\n    }\n  }\n\n  /**\n   * Reads the HD keyring entropy source IDs from KeyringController.\n   *\n   * @returns The HD keyring metadata IDs, primary first.\n   */\n  #getHdKeyringEntropySourceIds(): string[] {\n    const keyringState = this.messenger.call('KeyringController:getState');\n    return selectHdKeyringEntropySourceIds(keyringState);\n  }\n\n  /**\n   * Resolves the primary SRP's entropy source ID from KeyringController rather\n   * than the message-signing snap, so callers like `getBearerToken()` are not\n   * blocked on snap boot.\n   *\n   * @returns The primary HD keyring metadata ID.\n   * @throws If no HD keyring is available; callers must only resolve while\n   * the wallet is unlocked.\n   */\n  #getPrimaryEntropySourceId(): string {\n    const keyringState = this.messenger.call('KeyringController:getState');\n    return getPrimaryHdKeyringEntropySourceId(keyringState);\n  }\n\n  /**\n   * Resolves the SRP login tag for `raw_message`.\n   *\n   * - `primary` for the first HD entropy source\n   * - `secondary` for any other entropy source\n   *\n   * @param entropySourceId - Entropy source for this login attempt.\n   * @returns The login tag to append to the signed message.\n   */\n  async #getLoginTag(entropySourceId?: string): Promise<SrpLoginTag> {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const resolvedId = entropySourceId ?? primaryEntropySourceId;\n\n    return resolvedId === primaryEntropySourceId ? 'primary' : 'secondary';\n  }\n\n  /**\n   * Resolves metametrics `identifier_type` for `/srp/login`\n   * (`SRP` | `GOOGLE` | `APPLE` | `TELEGRAM`).\n   *\n   * This is the auth method for the entropy source, independent of\n   * {@link SrpLoginTag} (`primary` / `secondary`).\n   *\n   * SeedlessOnboarding currently exposes a single vault-level\n   * `authConnection`, which always backs the primary entropy source. Non-\n   * primary sources therefore return `SRP`. If social identities become\n   * per-entropy later, resolve from that metadata instead of assuming\n   * primary === social.\n   *\n   * Soft-fails to `SRP` when SeedlessOnboarding is not registered.\n   *\n   * @param entropySourceId - Entropy source for this login attempt.\n   * @returns The login identifier type.\n   */\n  async #getLoginIdentifierType(\n    entropySourceId?: string,\n  ): Promise<LoginIdentifierType> {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const resolvedId = entropySourceId ?? primaryEntropySourceId;\n\n    // Social vault authConnection is only associated with the primary source.\n    if (resolvedId !== primaryEntropySourceId) {\n      return 'SRP';\n    }\n\n    return this.#resolveSocialIdentifierType();\n  }\n\n  /**\n   * Maps `SeedlessOnboardingController.state.authConnection` to a login\n   * identifier type when a social vault is present.\n   *\n   * Returns `SRP` if there is no vault, the provider is unrecognized, or\n   * SeedlessOnboardingController is unavailable on the messenger.\n   *\n   * @returns The social provider identifier type, or `SRP`.\n   */\n  #resolveSocialIdentifierType(): LoginIdentifierType {\n    try {\n      return this.#identifierTypeFromSeedlessState(\n        this.messenger.call('SeedlessOnboardingController:getState'),\n      );\n    } catch {\n      return 'SRP';\n    }\n  }\n\n  /**\n   * Maps SeedlessOnboarding vault + `authConnection` to a login identifier\n   * type. Does not catch messenger errors — callers decide whether a\n   * missing controller is `SRP` or a retryable failure.\n   *\n   * @param state - SeedlessOnboarding slice used for the mapping.\n   * @param state.vault - Encrypted social vault, if present.\n   * @param state.authConnection - Social provider id (`google` / `apple` /\n   * `telegram`).\n   * @returns The social provider identifier type, or `SRP`.\n   */\n  #identifierTypeFromSeedlessState(state: {\n    vault?: string | null;\n    authConnection?: string;\n  }): LoginIdentifierType {\n    if (state.vault === null || state.vault === undefined) {\n      return 'SRP';\n    }\n\n    // Match provider strings from SeedlessOnboarding state rather than\n    // importing AuthConnection — a value import would load that package\n    // (and its heavy deps) whenever this controller is imported.\n    switch (state.authConnection) {\n      case 'google':\n        return 'GOOGLE';\n      case 'apple':\n        return 'APPLE';\n      case 'telegram':\n        return 'TELEGRAM';\n      default:\n        return 'SRP';\n    }\n  }\n\n  public async performSignIn(): Promise<string[]> {\n    this.#assertIsUnlocked('performSignIn');\n\n    const epochAtStart = this.#profilePairingRequestEpoch;\n    const entropySourceIds = this.#getHdKeyringEntropySourceIds();\n    const accessTokens: string[] = [];\n\n    // We iterate sequentially in order to be sure that the first entry\n    // is the primary SRP LoginResponse.\n    for (const entropySourceId of entropySourceIds) {\n      const accessToken = await this.#auth.getAccessToken(entropySourceId);\n      accessTokens.push(accessToken);\n    }\n\n    if (entropySourceIds.length < 2) {\n      // Single-SRP wallet: nothing to pair.\n      this.#tryClearNeedsProfilePairing(epochAtStart);\n    } else {\n      // Pair failures must not break sign-in; the gate stays `true` for retry.\n      try {\n        await this.#doPair(accessTokens, epochAtStart);\n      } catch {\n        // noop\n      }\n    }\n\n    try {\n      await this.#trySocialPairing(accessTokens[0]);\n    } catch {\n      // noop\n    }\n\n    return accessTokens;\n  }\n\n  /**\n   * Attaches a Google/Apple/Telegram social identifier to the primary SRP\n   * profile via `POST /api/v2/profile/pair/identifier`.\n   *\n   * Runs only when `isSocialPairingEnabled()` is true and\n   * `needsSocialPairing` is not `false` (`undefined` is treated as true).\n   * No social provider (`authConnection` unset) → clear the flag (nothing\n   * to pair). Social provider set but vault missing → skip (onboarding\n   * still in flight). Google without email → skip (API requires it).\n   * Telegram never sends `email` (the field holds a display name, not an\n   * address). Missing social JWT → skip. 409 Conflict → clear the flag\n   * (identifier already owned; retry is pointless). Other errors\n   * propagate so the caller can swallow them and leave the flag set for\n   * retry.\n   *\n   * @param primaryAccessToken - Primary SRP OIDC access token used as the\n   * Bearer credential. The profile associated with this JWT becomes the\n   * canonical owner of the social identifier.\n   */\n  async #trySocialPairing(primaryAccessToken?: string): Promise<void> {\n    if (\n      !this.#config.isSocialPairingEnabled() ||\n      this.state.needsSocialPairing === false ||\n      !primaryAccessToken\n    ) {\n      return;\n    }\n\n    let seedlessState: {\n      vault?: string | null;\n      authConnection?: string;\n      socialLoginEmail?: string;\n    };\n    try {\n      seedlessState = this.messenger.call(\n        'SeedlessOnboardingController:getState',\n      );\n    } catch {\n      // Controller missing or getState failed — retry next performSignIn.\n      return;\n    }\n\n    // `SRP` here does not describe the vault: it is the mapping's \"no social\n    // identity\" result, returned when there is no seedless vault or the\n    // provider is unrecognised. In both cases there is nothing to pair.\n    const identifierType = this.#identifierTypeFromSeedlessState(seedlessState);\n    if (identifierType === 'SRP') {\n      const { vault, authConnection } = seedlessState;\n      // Vault not written yet but a social provider is already known —\n      // onboarding is still in flight. Do not clear; retry next sign-in.\n      if ((vault === null || vault === undefined) && Boolean(authConnection)) {\n        return;\n      }\n      this.#clearNeedsSocialPairing();\n      return;\n    }\n\n    // Email policy follows the API contract: GOOGLE requires `email` (400\n    // without it), APPLE accepts it optionally, TELEGRAM must not send it\n    // (clients store a display name in `socialLoginEmail` for Telegram).\n    // Clients request the `email` scope for Google, so a missing value is a\n    // defensive case rather than an expected one; returning here leaves\n    // `needsSocialPairing` set so the next sign-in retries instead of\n    // sending a request that would fail.\n    const { socialLoginEmail } = seedlessState;\n    let email: string | undefined;\n    if (identifierType === 'GOOGLE') {\n      if (!socialLoginEmail) {\n        return;\n      }\n      email = socialLoginEmail;\n    } else if (identifierType === 'APPLE') {\n      email = socialLoginEmail;\n    }\n\n    const socialJwt = await this.messenger.call(\n      'SeedlessOnboardingController:getAccessToken',\n    );\n    if (socialJwt === undefined || socialJwt === '') {\n      return;\n    }\n\n    try {\n      await this.#auth.pairSocialIdentifier(\n        {\n          identifierType,\n          socialJwt,\n          ...(email ? { email } : {}),\n        },\n        primaryAccessToken,\n      );\n      this.#clearNeedsSocialPairing();\n    } catch (error) {\n      if (error instanceof PairConflictError) {\n        this.#clearNeedsSocialPairing();\n        return;\n      }\n      throw error;\n    }\n  }\n\n  #clearNeedsSocialPairing(): void {\n    if (this.state.needsSocialPairing !== false) {\n      this.update((state) => {\n        state.needsSocialPairing = false;\n      });\n    }\n  }\n\n  /**\n   * Marks profile pairing as needed. Clients call this when the SRP set\n   * changes (e.g. a new keyring was added) so the next auto-sign-in cycle\n   * re-runs `performSignIn` and re-pairs.\n   */\n  public requestProfilePairing(): void {\n    this.#profilePairingRequestEpoch += 1;\n    if (!this.state.needsProfilePairing) {\n      this.update((state) => {\n        state.needsProfilePairing = true;\n      });\n    }\n  }\n\n  /**\n   * Clears `needsProfilePairing` only if no `requestProfilePairing` call\n   * landed since `epochAtStart` was captured. Prevents `performSignIn`\n   * from silently overwriting a concurrent rearm.\n   *\n   * @param epochAtStart - Epoch value captured at the start of `performSignIn`.\n   */\n  #tryClearNeedsProfilePairing(epochAtStart: number): void {\n    if (this.#profilePairingRequestEpoch !== epochAtStart) {\n      return;\n    }\n    if (this.state.needsProfilePairing) {\n      this.update((state) => {\n        state.needsProfilePairing = false;\n      });\n    }\n  }\n\n  /**\n   * Pairs all SRPs via `POST /profile/pair`, propagates the canonical\n   * profile ID, clears `needsProfilePairing`, and emits\n   * `AuthenticationController:profileSignIn` when the canonical changes or\n   * new aliases are returned. Throws on failure.\n   *\n   * @param accessTokens - Per-SRP access tokens, primary first.\n   * @param epochAtStart - Pairing-request epoch captured by the caller.\n   * Used to skip the gate clear if `requestProfilePairing` ran while the\n   * pair API call was in-flight.\n   */\n  async #doPair(accessTokens: string[], epochAtStart: number): Promise<void> {\n    const previousCanonical = this.#getCanonicalProfileId();\n\n    const profileAliases = await this.#pairSrpProfiles(accessTokens);\n    const newCanonical = this.#getCanonicalProfileId();\n\n    // If somehow we cannot compute the new canonical profile ID after pairing,\n    // we just return now and do not update the `needsProfilePairing` flag.\n    if (!newCanonical) {\n      return;\n    }\n\n    this.#tryClearNeedsProfilePairing(epochAtStart);\n\n    const profileIdChanged = previousCanonical !== newCanonical;\n    const shouldEmitProfileSignInEvent =\n      profileIdChanged || profileAliases.length > 0;\n\n    if (shouldEmitProfileSignInEvent) {\n      this.messenger.publish('AuthenticationController:profileSignIn', {\n        profileId: newCanonical,\n        profileAliases,\n        profileIdChanged,\n      });\n    }\n  }\n\n  async #pairSrpProfiles(accessTokens: string[]): Promise<ProfileAlias[]> {\n    if (accessTokens.length < 2) {\n      return [];\n    }\n    const primaryAccessToken = accessTokens[0]; // Associated with primary SRP.\n    const {\n      profileAliases,\n      profile: { canonicalProfileId },\n    } = await this.#auth.pairSrpProfiles(accessTokens, primaryAccessToken);\n    this.#propagateCanonical(canonicalProfileId);\n    return profileAliases;\n  }\n\n  #propagateCanonical(canonicalProfileId: string): void {\n    const { srpSessionData } = this.state;\n    if (!srpSessionData) {\n      return;\n    }\n\n    this.update((state) => {\n      for (const entry of Object.values(state.srpSessionData ?? {})) {\n        if (entry?.profile) {\n          entry.profile.canonicalProfileId = canonicalProfileId;\n        }\n      }\n    });\n  }\n\n  /**\n   * Returns the canonical profile id from the primary SRP's cached session.\n   * Returns `null` when no session exists yet for the primary SRP.\n   *\n   * Always reads from the primary SRP because the canonical is shared across\n   * all paired SRPs after `#propagateCanonical`.\n   *\n   * @returns The canonical profile id, or `null` if unavailable.\n   */\n  #getCanonicalProfileId(): string | null {\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    return (\n      this.state.srpSessionData?.[primaryEntropySourceId]?.profile\n        ?.canonicalProfileId ?? null\n    );\n  }\n\n  /**\n   * Runs one MFA network step inside a trace span tagged with the caller's\n   * operation and the credential type, recording the outcome and MFA error\n   * code.\n   *\n   * @param name - Span name.\n   * @param operation - Caller-supplied `reason.operation`.\n   * @param credentialType - Credential type the step concerns.\n   * @param fn - The network step.\n   * @returns The step's result.\n   */\n  async #runMfaRequest<Result>(\n    name: string,\n    operation: string,\n    credentialType: string,\n    fn: () => Promise<Result>,\n  ): Promise<Result> {\n    return await this.#trace(\n      {\n        name,\n        tags: { operation, credentialType },\n      },\n      async (context) => {\n        try {\n          const result = await fn();\n          this.#setTraceAttribute(context, 'outcome', 'success');\n          return result;\n        } catch (error) {\n          this.#setTraceAttribute(context, 'outcome', 'error');\n          const mfaCode = getMfaErrorCode(error);\n          if (mfaCode) {\n            this.#setTraceAttribute(context, 'mfaErrorCode', mfaCode);\n            if (mfaCode === 'authentication_required' && this.#isUnlocked) {\n              this.#invalidateSrpSession(this.#getPrimaryEntropySourceId());\n              // An elevated session must not outlive a rejected base session.\n              this.clearStepUpSession();\n            }\n          }\n          throw error;\n        }\n      },\n    );\n  }\n\n  /**\n   * `TraceContext` is opaque in `@metamask/controller-utils`; both clients\n   * hand back a Sentry span, so attributes are set via duck typing and a\n   * non-Sentry context is a silent no-op.\n   *\n   * @param context - Span handed to the trace callback, if any.\n   * @param key - Attribute name.\n   * @param value - Attribute value.\n   */\n  #setTraceAttribute(\n    context: TraceContext | undefined,\n    key: string,\n    value: string,\n  ): void {\n    const traceSpan = context as\n      | { setAttribute?: (attribute: string, data: string) => void }\n      | undefined;\n    traceSpan?.setAttribute?.(key, value);\n  }\n\n  /**\n   * Refreshes credentials enrolled on the canonical profile.\n   *\n   * @returns The current supported credentials.\n   */\n  public async refreshEnrolledCredentials(): Promise<EnrolledCredential[]> {\n    this.#assertIsUnlocked('refreshEnrolledCredentials');\n    const sessionEpoch = this.#authSessionEpoch;\n    this.#credentialsRefreshSeq += 1;\n    const refreshSeq = this.#credentialsRefreshSeq;\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const credentials = await this.#runMfaRequest(\n      'MFA Credentials Refresh',\n      'credentials.refresh',\n      'all',\n      async () => await this.#auth.getMfaCredentials(primaryEntropySourceId),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'refreshEnrolledCredentials');\n\n    // A newer refresh started while this one was in flight; its result is at\n    // least as fresh, so defer to it rather than overwrite with older data.\n    if (refreshSeq !== this.#credentialsRefreshSeq) {\n      return this.#getEnrolledCredentials();\n    }\n\n    // Skip the write when nothing changed so subscribers are not woken up by\n    // a fresh-but-identical array.\n    if (\n      JSON.stringify(credentials) !==\n      JSON.stringify(this.#getEnrolledCredentials())\n    ) {\n      this.update((state) => {\n        state.enrolledCredentials = credentials;\n      });\n    }\n    return credentials;\n  }\n\n  /**\n   * Begins enrollment of a passkey or email OTP credential.\n   *\n   * @param request - Credential, optional email address, and trace reason.\n   * @returns A challenge for the client-owned ceremony.\n   */\n  public async beginCredentialEnrollment(\n    request: BeginEnrollmentRequest,\n  ): Promise<EnrollmentChallenge> {\n    this.#assertIsUnlocked('beginCredentialEnrollment');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, BeginEnrollmentRequestStruct);\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const challenge = await this.#runMfaRequest(\n      'MFA Enroll Begin',\n      request.reason.operation,\n      request.type,\n      async () =>\n        await this.#auth.beginMfaEnrollment(request.type, {\n          email: request.email,\n          entropySourceId: primaryEntropySourceId,\n        }),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'beginCredentialEnrollment');\n    return challenge;\n  }\n\n  /**\n   * Completes credential enrollment and refreshes the credential cache.\n   *\n   * A cache-refresh failure does not undo successful enrollment. Email\n   * enrollment invalidates the primary SRP session *after* refresh so the\n   * credentials call can reuse the still-valid access token; the next token\n   * fetch then includes the newly verified email claim. That invalidation\n   * happens even if the session ends mid-request: the enrollment succeeded\n   * on the server, so a token cached across a lock must not be reused\n   * without the new claim.\n   *\n   * @param request - Flow identifier, platform or email proof, and trace reason.\n   * @returns The refreshed credentials, or the existing cache if refresh fails.\n   */\n  public async completeCredentialEnrollment(\n    request: CompleteEnrollmentRequest,\n  ): Promise<EnrolledCredential[]> {\n    this.#assertIsUnlocked('completeCredentialEnrollment');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, CompleteEnrollmentRequestStruct);\n    const { type } = request.proof;\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    await this.#runMfaRequest(\n      'MFA Enroll Complete',\n      request.reason.operation,\n      type,\n      async () =>\n        await this.#auth.completeMfaEnrollment(\n          request.flowId,\n          request.proof,\n          primaryEntropySourceId,\n        ),\n    );\n\n    try {\n      this.#assertAuthSessionEpoch(\n        sessionEpoch,\n        'completeCredentialEnrollment',\n      );\n    } catch (error) {\n      if (type === 'email_otp') {\n        this.#invalidateSrpSession(primaryEntropySourceId);\n      }\n      throw error;\n    }\n    // The factor set changed: require a fresh ceremony against the new set.\n    this.clearStepUpSession();\n\n    try {\n      return await this.refreshEnrolledCredentials();\n    } catch {\n      return this.#getEnrolledCredentials();\n    } finally {\n      if (type === 'email_otp') {\n        this.#invalidateSrpSession(primaryEntropySourceId);\n      }\n    }\n  }\n\n  /**\n   * Begins step-up verification with an enrolled credential.\n   *\n   * @param request - Credential type and trace reason.\n   * @returns A challenge for the client-owned ceremony.\n   */\n  public async beginStepUp(\n    request: BeginStepUpRequest,\n  ): Promise<StepUpChallenge> {\n    this.#assertIsUnlocked('beginStepUp');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, BeginStepUpRequestStruct);\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const challenge = await this.#runMfaRequest(\n      'MFA Step-Up Begin',\n      request.reason.operation,\n      request.type,\n      async () =>\n        await this.#auth.beginMfaVerification(\n          request.type,\n          primaryEntropySourceId,\n        ),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'beginStepUp');\n    return challenge;\n  }\n\n  /**\n   * Completes step-up verification and opens a short-lived elevated session.\n   *\n   * The AAL2 assertion returned by the MFA service is exchanged at Hydra for\n   * an elevated access token, whose claims are checked before the session\n   * opens. The token itself never enters controller state.\n   *\n   * @param request - Flow identifier, platform or email proof, and trace reason.\n   * @returns The elevated profile access token.\n   */\n  public async completeStepUp(\n    request: CompleteStepUpRequest,\n  ): Promise<ElevatedProfileToken> {\n    this.#assertIsUnlocked('completeStepUp');\n    const sessionEpoch = this.#authSessionEpoch;\n    assertValidMfaRequest(request, CompleteStepUpRequestStruct);\n    const { type } = request.proof;\n    const { operation } = request.reason;\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    const assertion = await this.#runMfaRequest(\n      'MFA Step-Up Complete',\n      operation,\n      type,\n      async () =>\n        await this.#auth.completeMfaVerification(\n          request.flowId,\n          request.proof,\n          primaryEntropySourceId,\n        ),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'completeStepUp');\n    const accessToken = await this.#runMfaRequest(\n      'MFA Token Exchange',\n      operation,\n      type,\n      async () => await this.#auth.exchangeMfaAssertion(assertion.token),\n    );\n    this.#assertAuthSessionEpoch(sessionEpoch, 'completeStepUp');\n\n    let decodedClaims: unknown;\n    try {\n      decodedClaims = decodeJwtPayload(accessToken.accessToken);\n    } catch (error) {\n      throw new ElevatedTokenInvalidError(toErrorMessage(error));\n    }\n    const claims = parseElevatedTokenClaims(decodedClaims);\n    if (claims.exp * 1000 <= Date.now()) {\n      throw new ElevatedTokenInvalidError('Elevated token is expired');\n    }\n\n    const token: ElevatedProfileToken = { ...accessToken, claims };\n    this.#openStepUpSession(token);\n    return token;\n  }\n\n  /**\n   * Returns the active elevated token when it meets the requested freshness.\n   *\n   * @param request - Optional maximum session age in milliseconds, measured\n   * from when the token was obtained. Zero always requires a new ceremony.\n   * @returns A live elevated token, or null when no reusable session exists.\n   */\n  public getElevatedProfileToken(\n    request: GetElevatedTokenRequest = {},\n  ): ElevatedProfileToken | null {\n    this.#assertIsUnlocked('getElevatedProfileToken');\n    assertValidMfaRequest(request, GetElevatedTokenRequestStruct);\n    const session = this.#stepUpSession;\n    if (!session) {\n      return null;\n    }\n    const now = Date.now();\n    if (now >= session.expiresAt) {\n      // The hard-expiry timer has not fired yet (e.g. a suspended tab).\n      this.clearStepUpSession();\n      return null;\n    }\n    // `>=` so a zero max age always forces a fresh ceremony. Not cleared: the\n    // max age is this caller's requirement; others may still use the session.\n    const maxAge = request.maxSessionAgeMs;\n    if (maxAge !== undefined && now - session.token.obtainedAt >= maxAge) {\n      return null;\n    }\n    return session.token;\n  }\n\n  /**\n   * Opens the elevated session. Its lifetime is the session TTL clamped to\n   * the token's own `exp`, so the session never outlives the token.\n   *\n   * @param token - The freshly exchanged elevated token.\n   */\n  #openStepUpSession(token: ElevatedProfileToken): void {\n    this.clearStepUpSession();\n    const expiresAt = Math.min(\n      token.obtainedAt + STEP_UP_SESSION_TTL_MS,\n      token.claims.exp * 1000,\n    );\n    this.#stepUpSession = { token, expiresAt };\n    this.update((state) => {\n      state.stepUpSessionExpiresAt = expiresAt;\n    });\n    this.#stepUpTimer = setTimeout(\n      () => this.clearStepUpSession(),\n      Math.max(0, expiresAt - Date.now()),\n    );\n    // Never keep a Node process alive for the expiry timer (tests, tooling).\n    (this.#stepUpTimer as { unref?: () => void }).unref?.();\n  }\n\n  /**\n   * Clears the in-memory elevated session and its expiration timer.\n   */\n  public clearStepUpSession(): void {\n    if (this.#stepUpTimer !== undefined) {\n      clearTimeout(this.#stepUpTimer);\n      this.#stepUpTimer = undefined;\n    }\n    this.#stepUpSession = null;\n    if (this.state.stepUpSessionExpiresAt !== undefined) {\n      this.update((state) => {\n        state.stepUpSessionExpiresAt = undefined;\n      });\n    }\n  }\n\n  /**\n   * Drops the cached credential list. Callers that wipe profile state must go\n   * through this so subscribers never keep credentials belonging to a profile\n   * that is no longer active.\n   */\n  #clearEnrolledCredentials(): void {\n    if (this.#getEnrolledCredentials().length === 0) {\n      return;\n    }\n    this.update((state) => {\n      state.enrolledCredentials = [];\n    });\n  }\n\n  #getEnrolledCredentials(): EnrolledCredential[] {\n    return this.state.enrolledCredentials ?? [];\n  }\n\n  public performSignOut(): void {\n    this.#authSessionEpoch += 1;\n    this.clearStepUpSession();\n    this.#clearEnrolledCredentials();\n    this.update((state) => {\n      state.isSignedIn = false;\n      state.srpSessionData = undefined;\n    });\n  }\n\n  /**\n   * Resets the controller to `defaultState`. Clients call this on wallet reset\n   * so the next wallet starts unsigned with both pairing gates re-armed.\n   */\n  public clearState(): void {\n    this.#profilePairingRequestEpoch += 1;\n    this.#authSessionEpoch += 1;\n    this.clearStepUpSession();\n    this.#clearEnrolledCredentials();\n    this.update(() => ({ ...defaultState }));\n  }\n\n  /**\n   * Returns a bearer token for the specified SRP, logging in if needed.\n   *\n   * When called without `entropySourceId`, returns the primary (first) SRP's\n   * access token, which is effectively the canonical\n   * profile's token that can be used by alias-aware consumers for cross-SRP\n   * operations.\n   *\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The OIDC access token.\n   */\n  public async getBearerToken(entropySourceId?: string): Promise<string> {\n    this.#assertIsUnlocked('getBearerToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getAccessToken(resolvedId);\n  }\n\n  /**\n   * Returns the cached session profile, logging in if no session exists.\n   *\n   * The returned `canonicalProfileId` reflects the value from the most recent\n   * login or pairing. In the rare event where a canonical changed because of\n   * a pairing that happened on another device, the cached value may be stale\n   * until the next login. For guaranteed freshness, call\n   * `refreshCanonicalProfileId()` before reading `canonicalProfileId`.\n   *\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns profile for the session.\n   */\n  public async getSessionProfile(\n    entropySourceId?: string,\n  ): Promise<UserProfile> {\n    this.#assertIsUnlocked('getSessionProfile');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getUserProfile(resolvedId);\n  }\n\n  /**\n   * Forces a fresh retrieval of the canonical profile ID from the server\n   * and propagates it to all cached SRP sessions.\n   *\n   * This method invalidates the primary SRP's cached session and forces a\n   * re-login. Use it before operations that require a guaranteed-fresh\n   * canonical (e.g. storage key derivation for Accounts ADR 0005). For\n   * best-effort reads, use\n   * `getSessionProfile().canonicalProfileId` instead.\n   *\n   * Only the primary SRP is re-logged-in regardless of how many SRPs exist —\n   * the server returns the current canonical for the entire pairing group\n   * from any single SRP login.\n   *\n   * @returns The refreshed canonical profile ID.\n   */\n  public async refreshCanonicalProfileId(): Promise<string> {\n    this.#assertIsUnlocked('refreshCanonicalProfileId');\n\n    const primaryEntropySourceId = this.#getPrimaryEntropySourceId();\n    this.#invalidateSrpSession(primaryEntropySourceId);\n    await this.#auth.getAccessToken(primaryEntropySourceId);\n\n    const canonical = this.#getCanonicalProfileId();\n    if (!canonical) {\n      throw new Error(\n        'refreshCanonicalProfileId - Unable to resolve canonical profile ID',\n      );\n    }\n\n    this.#propagateCanonical(canonical);\n    return canonical;\n  }\n\n  #invalidateSrpSession(entropySourceId: string): void {\n    this.update((state) => {\n      const entry = state.srpSessionData?.[entropySourceId];\n      if (entry?.profile) {\n        // Setting canonicalProfileId to '' forces a re-fetch on the next\n        // #getAuthSession call. The falsy check (!auth.profile.canonicalProfileId)\n        // treats '' the same as undefined/null — all signal an invalid session.\n        entry.profile.canonicalProfileId = '';\n      }\n    });\n  }\n\n  public async getUserProfileLineage(\n    entropySourceId?: string,\n  ): Promise<UserProfileLineage> {\n    this.#assertIsUnlocked('getUserProfileLineage');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getUserProfileLineage(resolvedId);\n  }\n\n  /**\n   * Returns a Customer Service specific access token for the specified SRP,\n   * logging in if needed.\n   *\n   * Exchanges the OIDC access token for a short-lived token scoped to the\n   * customer-service audience. Customer Service tooling consumes this token to\n   * identify and authenticate the user.\n   *\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The customer-service access token.\n   */\n  public async getCustomerServiceToken(\n    entropySourceId?: string,\n  ): Promise<string> {\n    this.#assertIsUnlocked('getCustomerServiceToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getCustomerServiceToken(resolvedId);\n  }\n\n  /**\n   * Mints a partner identity token for the specified SRP, logging in if needed.\n   *\n   * Calls `POST /api/v2/oidc/token` with the Hydra login bearer and returns\n   * the minted `access_token`. Email on live tokens is under JWT `ext`.\n   * HTTP 422 throws `EmailRequiredError` when this profile has no\n   * verified email.\n   *\n   * @param claims - Claim names to embed. Only `email` is supported.\n   * @param audience - Partner audience (`kyc` or `iron`).\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The partner identity access token.\n   */\n  public async getPartnerIdentityToken(\n    claims: OidcTokenClaims,\n    audience: OidcTokenAudience,\n    entropySourceId?: string,\n  ): Promise<string> {\n    this.#assertIsUnlocked('getPartnerIdentityToken');\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return await this.#auth.getPartnerIdentityToken(\n      claims,\n      audience,\n      resolvedId,\n    );\n  }\n\n  public isSignedIn(): boolean {\n    return this.state.isSignedIn;\n  }\n\n  /**\n   * Reads the BIP-39 seed for an HD entropy source from KeyringController.\n   *\n   * @param entropySourceId - Entropy source ID. Defaults to the primary HD\n   * keyring.\n   * @returns The HD keyring seed.\n   */\n  async #getHdKeyringSeed(entropySourceId?: string): Promise<Uint8Array> {\n    const resolvedId = entropySourceId ?? this.#getPrimaryEntropySourceId();\n    return getHdKeyringSeed(this.messenger, resolvedId);\n  }\n\n  /**\n   * Returns the message-signing public key via native SIP-6 derivation\n   * (same key as `@metamask/message-signing-snap` with empty salt).\n   *\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns The public key hex.\n   */\n  async #getPublicKey(entropySourceId?: string): Promise<string> {\n    this.#assertIsUnlocked('#getPublicKey');\n    const seed = await this.#getHdKeyringSeed(entropySourceId);\n    return getMessageSigningPublicKey(seed);\n  }\n\n  #_signMessageCache: Record<string, string> = {};\n\n  /**\n   * Builds a cache key scoped to a specific entropy source, so each SRP's\n   * signature stays isolated (same pattern as `UserStorageController`).\n   *\n   * When `entropySourceId` is omitted (primary SRP), it is resolved to the\n   * primary HD keyring's metadata ID rather than a stable literal. Because that\n   * ID is randomly regenerated whenever the vault is recreated (e.g. on\n   * restore), the cached entry is naturally invalidated across vaults — a\n   * different SRP can never inherit the previous primary's cached signature.\n   *\n   * @param message - The tagged message used for signing.\n   * @param entropySourceId - The entropy source ID. Omit for the primary SRP.\n   * @returns The scoped cache key.\n   */\n  #scopedCacheKey(\n    message: `metamask:${string}`,\n    entropySourceId?: string,\n  ): string {\n    return `${entropySourceId ?? this.#getPrimaryEntropySourceId()}:${message}`;\n  }\n\n  /**\n   * Signs a `metamask:…` message with the native SIP-6 message-signing key.\n   *\n   * @param message - A specific tagged message to sign.\n   * @param entropySourceId - The entropy source ID used to derive the key,\n   * when multiple sources are available (Multi-SRP).\n   * @returns Compact secp256k1 signature hex.\n   */\n  async #signMessage(\n    message: string,\n    entropySourceId?: string,\n  ): Promise<string> {\n    assertMessageStartsWithMetamask(message);\n    this.#assertIsUnlocked('#signMessage');\n\n    const cacheKey = this.#scopedCacheKey(message, entropySourceId);\n    if (this.#_signMessageCache[cacheKey]) {\n      return this.#_signMessageCache[cacheKey];\n    }\n\n    const seed = await this.#getHdKeyringSeed(entropySourceId);\n    const result = await signMessageWithMessageSigningKey(message, seed);\n\n    this.#_signMessageCache[cacheKey] = result;\n\n    return result;\n  }\n}\n"]}

package/dist/controllers/authentication/index.d.ts

@@ -3,5 +3,5 @@ export { AuthenticationController as Controller };
 export default AuthenticationController;
 export * from './AuthenticationController.js';
 export * as Mocks from './mocks/index.js';
-export type { AuthenticationControllerPerformSignInAction, AuthenticationControllerPerformSignOutAction, AuthenticationControllerGetBearerTokenAction, AuthenticationControllerGetSessionProfileAction, AuthenticationControllerRefreshCanonicalProfileIdAction, AuthenticationControllerGetUserProfileLineageAction, AuthenticationControllerIsSignedInAction, AuthenticationControllerRequestProfilePairingAction, AuthenticationControllerGetPartnerIdentityTokenAction, AuthenticationControllerClearStateAction, AuthenticationControllerRefreshEnrolledCredentialsAction, AuthenticationControllerBeginCredentialEnrollmentAction, AuthenticationControllerCompleteCredentialEnrollmentAction, } from './AuthenticationController-method-action-types.js';
+export type { AuthenticationControllerPerformSignInAction, AuthenticationControllerPerformSignOutAction, AuthenticationControllerGetBearerTokenAction, AuthenticationControllerGetSessionProfileAction, AuthenticationControllerRefreshCanonicalProfileIdAction, AuthenticationControllerGetUserProfileLineageAction, AuthenticationControllerIsSignedInAction, AuthenticationControllerRequestProfilePairingAction, AuthenticationControllerGetPartnerIdentityTokenAction, AuthenticationControllerClearStateAction, AuthenticationControllerRefreshEnrolledCredentialsAction, AuthenticationControllerBeginCredentialEnrollmentAction, AuthenticationControllerCompleteCredentialEnrollmentAction, AuthenticationControllerBeginStepUpAction, AuthenticationControllerCompleteStepUpAction, AuthenticationControllerGetElevatedProfileTokenAction, AuthenticationControllerClearStepUpSessionAction, } from './AuthenticationController-method-action-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/controllers/authentication/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,wBAAwB,IAAI,UAAU,EAAE,CAAC;eACnC,wBAAwB;AACvC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,YAAY,EACV,2CAA2C,EAC3C,4CAA4C,EAC5C,4CAA4C,EAC5C,+CAA+C,EAC/C,uDAAuD,EACvD,mDAAmD,EACnD,wCAAwC,EACxC,mDAAmD,EACnD,qDAAqD,EACrD,wCAAwC,EACxC,wDAAwD,EACxD,uDAAuD,EACvD,0DAA0D,GAC3D,MAAM,mDAAmD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/authentication/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,wBAAwB,IAAI,UAAU,EAAE,CAAC;eACnC,wBAAwB;AACvC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAE1C,YAAY,EACV,2CAA2C,EAC3C,4CAA4C,EAC5C,4CAA4C,EAC5C,+CAA+C,EAC/C,uDAAuD,EACvD,mDAAmD,EACnD,wCAAwC,EACxC,mDAAmD,EACnD,qDAAqD,EACrD,wCAAwC,EACxC,wDAAwD,EACxD,uDAAuD,EACvD,0DAA0D,EAC1D,yCAAyC,EACzC,4CAA4C,EAC5C,qDAAqD,EACrD,gDAAgD,GACjD,MAAM,mDAAmD,CAAC"}

package/dist/controllers/authentication/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controllers/authentication/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,wBAAwB,IAAI,UAAU,EAAE,CAAC;AAClD,eAAe,wBAAwB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC","sourcesContent":["import { AuthenticationController } from './AuthenticationController.js';\n\nexport { AuthenticationController as Controller };\nexport default AuthenticationController;\nexport * from './AuthenticationController.js';\nexport * as Mocks from './mocks/index.js';\n\nexport type {\n  AuthenticationControllerPerformSignInAction,\n  AuthenticationControllerPerformSignOutAction,\n  AuthenticationControllerGetBearerTokenAction,\n  AuthenticationControllerGetSessionProfileAction,\n  AuthenticationControllerRefreshCanonicalProfileIdAction,\n  AuthenticationControllerGetUserProfileLineageAction,\n  AuthenticationControllerIsSignedInAction,\n  AuthenticationControllerRequestProfilePairingAction,\n  AuthenticationControllerGetPartnerIdentityTokenAction,\n  AuthenticationControllerClearStateAction,\n  AuthenticationControllerRefreshEnrolledCredentialsAction,\n  AuthenticationControllerBeginCredentialEnrollmentAction,\n  AuthenticationControllerCompleteCredentialEnrollmentAction,\n} from './AuthenticationController-method-action-types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controllers/authentication/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,wBAAwB,IAAI,UAAU,EAAE,CAAC;AAClD,eAAe,wBAAwB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC","sourcesContent":["import { AuthenticationController } from './AuthenticationController.js';\n\nexport { AuthenticationController as Controller };\nexport default AuthenticationController;\nexport * from './AuthenticationController.js';\nexport * as Mocks from './mocks/index.js';\n\nexport type {\n  AuthenticationControllerPerformSignInAction,\n  AuthenticationControllerPerformSignOutAction,\n  AuthenticationControllerGetBearerTokenAction,\n  AuthenticationControllerGetSessionProfileAction,\n  AuthenticationControllerRefreshCanonicalProfileIdAction,\n  AuthenticationControllerGetUserProfileLineageAction,\n  AuthenticationControllerIsSignedInAction,\n  AuthenticationControllerRequestProfilePairingAction,\n  AuthenticationControllerGetPartnerIdentityTokenAction,\n  AuthenticationControllerClearStateAction,\n  AuthenticationControllerRefreshEnrolledCredentialsAction,\n  AuthenticationControllerBeginCredentialEnrollmentAction,\n  AuthenticationControllerCompleteCredentialEnrollmentAction,\n  AuthenticationControllerBeginStepUpAction,\n  AuthenticationControllerCompleteStepUpAction,\n  AuthenticationControllerGetElevatedProfileTokenAction,\n  AuthenticationControllerClearStepUpSessionAction,\n} from './AuthenticationController-method-action-types.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/profile-sync-controller",
-  "version": "32.1.1-preview-f87e9ae41",
+  "version": "32.2.0-preview-fb486948f",
   "description": "The profile sync helps developers synchronize data across multiple clients and devices in a privacy-preserving way. All data saved in the user storage database is encrypted client-side to preserve privacy. The user storage provides a modular design, giving developers the flexibility to construct and manage their storage spaces in a way that best suits their needs",
   "keywords": [
     "Ethereum",
@@ -86,13 +86,13 @@
     "@noble/curves": "^1.9.2",
     "@noble/hashes": "^1.8.0",
     "@signinwithethereum/siwe": "^4.2.1",
-    "immer": "^9.0.6",
+    "immer": "^9.0.21",
     "loglevel": "^1.8.1"
   },
   "devDependencies": {
-    "@lavamoat/allow-scripts": "^3.0.4",
+    "@lavamoat/allow-scripts": "^3.4.3",
     "@lavamoat/preinstall-always-fail": "^2.1.0",
-    "@metamask/auto-changelog": "^6.1.0",
+    "@metamask/auto-changelog": "^6.2.1",
     "@metamask/eth-hd-keyring": "^15.0.0",
     "@metamask/keyring-api": "^24.0.0",
     "@metamask/keyring-internal-api": "^12.0.0",
@@ -101,13 +101,13 @@
     "@types/jest": "^30.0.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "deepmerge": "^4.2.2",
-    "ethers": "^6.12.0",
+    "ethers": "^6.17.0",
     "jest": "^30.4.2",
     "jest-environment-jsdom": "^30.4.1",
-    "nock": "^13.3.1",
-    "rimraf": "^5.0.5",
-    "ts-jest": "^29.4.11",
-    "tsx": "^4.20.5",
+    "nock": "^13.5.6",
+    "rimraf": "^6.1.3",
+    "ts-jest": "^29.4.12",
+    "tsx": "^4.23.13",
     "typedoc": "^0.25.13",
     "typedoc-plugin-missing-exports": "^2.0.0",
     "typescript": "npm:@typescript/typescript6@^6.0.2",