Merge branch 'master' into scw-lookup

AyushBherwani1998 · web-flow · commit 721929c3feb9 · 2025-01-10T14:17:32.000+05:30
diff --git a/docs/features/account-dashboard.mdx b/docs/features/account-dashboard.mdx
@@ -5,15 +5,26 @@ description: "Account Dashboard | Documentation - Web3Auth"
 
 # Account Dashboard
 
-Web3Auth's Account Dashboard provides a unified platform for users to manage their Multi-Factor
-Authentication (MFA) and account security with ease. This document provides an overview of its
-features and how to integrate it seamlessly into your application.
+Web3Auth's [Account Dashboard](https://account.web3auth.io) provides a unified platform for users to
+manage their Multi-Factor Authentication (MFA) and account security with ease. This document
+provides an overview of its features and how to integrate it seamlessly into your application.
+
+Try now: [https://account.web3auth.io](https://account.web3auth.io)
+
+:::tip
+
+To implement the Account Dashboard in your custom verifier-based dApp, please refer to the
+[Manage MFA for No Modal SDK](/sdk/pnp/web/no-modal/usage#manage-multi-factor-authentication-mfa)
+and [Manage MFA for Modal SDK](/sdk/pnp/web/modal/usage#manage-multi-factor-authentication-mfa)
+sections.
+
+:::
 
 ![Unified Recovery Management Screenshot](/images/account-dashboard/unified-recovery-management.jpg)
 
 ### 1. Unified Recovery Management
 
-The Account Dashboard allows users to:
+The [Account Dashboard](https://account.web3auth.io) allows users to:
 
 - Set up recovery factors such as Password, Social Recovery, Authenticator App, and Recovery Phrase.
 - Manage and modify existing recovery factors.
diff --git a/docs/sdk/mpc-core-kit/mpc-core-kit-js/authentication/login-jwt.mdx b/docs/sdk/mpc-core-kit/mpc-core-kit-js/authentication/login-jwt.mdx
@@ -37,7 +37,7 @@ login function.
 | `additionalParams?`       | Any additional parameter (key-value pair) you'd like to pass to the login function.                                                                                                                                                                                                                                                                                                                                        |
 | `importTssKey?`           | Key to import key into TSS during first time login. For secp256k1 curve, you need to pass the private key, and for ed25519 curve you need to pass the seed. The ed25519 seed is hashed to generate 64 bytes, where first 32 bytes are used to generate the public key, and last 32 bytes are used as private key.                                                                                                          |
 | `prefetchTssPublicKeys?`  | Defines the number of TSS public keys to prefetch.The SDK by default starts with 2/2 flow, and this parameter should be used in the flow where you want to generate the recovery factor during first time login. The parameters helps you to reduce the operation time by pre-fetching the TSS public key and use it during generating new shares. For existing user you can set it to `0`. Default is `1`, maximum is `3` |
-| `registerExistingSFAKey?` | Allows to import the Single Factor Auth(SFA) Key into the MPC Core Kit SDK. Default value is `false`. Please note: <ul><li>Once SFA Key is imported, users won't be able to access their account using the SFA SDK.</li><li>SFA import can only be done for the Web3Auth SFA v2 users, and doesn't work for old(v1) users of SFA.</li></ul>                                                                                |
+| `registerExistingSFAKey?` | Allows to import the [Single Factor Auth(SFA) SDK](/docs/sdk/sfa/sfa-js/) key into the MPC Core Kit SDK. Default value is `false`. Please note, once SFA Key is imported, users won't be able to access their account using the SFA SDK.                                                                                                                                                                                   |
 
 </TabItem>
 <TabItem value="type">
@@ -167,8 +167,8 @@ await coreKitInstance.loginWithJWT(jwtLoginParams);
 
 ## Importing an existing Single Factor Auth(SFA) Key.
 
-When logging in for the first time, you can import an existing SFA key using the
-`registerExistingSFAKey` parameter. By default, the value of this parameter is `false`.
+When logging in for the first time, you can import an existing [SFA SDK](/docs/sdk/sfa/sfa-js/) key
+using the `registerExistingSFAKey` parameter. By default, the value of this parameter is `false`.
 
 Additionally, this parameter allows you to leverage the
 [wallet pregeneration API](/docs/features/wallet-pregeneration) to pre-generate a wallet address.
@@ -180,12 +180,8 @@ SDK/ Wallet Pregeneration API and MPC Core Kit SDK.
 
 :::info
 
-Please keep the following points in mind when using this feature:
-
-1. Once the SFA Key is imported, users will no longer be able to access their account through the
-   SFA SDK.
-2. SFA import is available exclusively for Web3Auth SFA v2 users and is not compatible with older
-   users (v1) of SFA.
+Please note, once the SFA Key is imported, users will no longer be able to access their account
+through the SFA SDK.
 
 :::
 
diff --git a/docs/sdk/mpc-core-kit/mpc-core-kit-js/authentication/login-oauth.mdx b/docs/sdk/mpc-core-kit/mpc-core-kit-js/authentication/login-oauth.mdx
@@ -36,10 +36,10 @@ genetate the same account across both authentication method, you need to use an
 The `OAuthLoginParams` has two additional properties which can be used to customize the login flow.
 Please check the table below for more details.
 
-| Parameter                 | Description                                                                                                                                                                                                                                                                                                                                 |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `importTssKey?`           | The TSS key to import an existing account.                                                                                                                                                                                                                                                                                                  |
-| `registerExistingSFAKey?` | Allows to import the Single Factor Auth(SFA) Key into the MPC Core Kit SDK. Default value is `false`. Please note: <ul><li>Once SFA Key is imported, users won't be able to access their account using the SFA SDK.</li><li>SFA import can only be done for the Web3Auth SFA v2 users, and doesn't work for old(v1) users of SFA.</li></ul> |
+| Parameter                 | Description                                                                                                                                                                                                                              |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `importTssKey?`           | The TSS key to import an existing account.                                                                                                                                                                                               |
+| `registerExistingSFAKey?` | Allows to import the [Single Factor Auth(SFA) SDK](/docs/sdk/sfa/sfa-js/) key into the MPC Core Kit SDK. Default value is `false`. Please note, once SFA Key is imported, users won't be able to access their account using the SFA SDK. |
 
 ### SubVerifierDetailsParams
 
@@ -220,8 +220,8 @@ await coreKitInstance.loginWithOAuth(verifierConfig);
 
 ## Importing an existing Single Factor Auth(SFA) Key.
 
-When logging in for the first time, you can import an existing SFA key using the
-`registerExistingSFAKey` parameter. By default, the value of this parameter is `false`.
+When logging in for the first time, you can import an existing [SFA SDK](/docs/sdk/sfa/sfa-js/) key
+using the `registerExistingSFAKey` parameter. By default, the value of this parameter is `false`.
 
 Additionally, this parameter allows you to leverage the
 [wallet pregeneration API](/docs/features/wallet-pregeneration) to pre-generate a wallet address.
@@ -233,12 +233,8 @@ SDK/ Wallet Pregeneration API and MPC Core Kit SDK.
 
 :::info
 
-Please keep the following points in mind when using this feature:
-
-1. Once the SFA Key is imported, users will no longer be able to access their account through the
-   SFA SDK.
-2. SFA import is available exclusively for Web3Auth SFA v2 users and is not compatible with older
-   users (v1) of SFA.
+Please note, once the SFA Key is imported, users will no longer be able to access their account
+through the SFA SDK.
 
 :::
 
diff --git a/docs/sdk/pnp/web/modal/usage.mdx b/docs/sdk/pnp/web/modal/usage.mdx
@@ -11,6 +11,7 @@ import ConnectBlockchain from "@site/src/common/sdk/pnp/web/_connect-blockchain.
 import GetIdTokenInfo from "@site/src/common/sdk/pnp/web/_get-idtoken-info.mdx";
 import GetUserInfo from "@site/src/common/sdk/pnp/web/_get-user-info.mdx";
 import EnableMFA from "@site/src/common/sdk/pnp/web/_enable-mfa.mdx";
+import ManageMFA from "@site/src/common/sdk/pnp/web/_manage-mfa.mdx";
 import LogOut from "@site/src/common/sdk/pnp/web/_logout.mdx";
 import SwitchChain from "@site/src/common/sdk/pnp/web/_switch-chain.mdx";
 import Status from "@site/src/common/sdk/pnp/web/_status-method.mdx";
@@ -28,6 +29,7 @@ following functions:
 - `connect()` - Showing the Modal and Logging in the User
 - `getUserInfo()` - Getting the User's Information
 - `enableMFA()` - Enable Multi Factor Authentication for the user
+- `manageMFA()` - Redirect the user to manage their MFA settings in the Web3Auth Account Dashboard
 - `authenticateUser()` - Getting the idToken from Web3Auth
 - `addChain()` - Add chain config details to the connected adapter.
 - `switchChain()` - Switch chain as per chainId already added to chain config.
@@ -100,6 +102,10 @@ Read more about connecting your users with the selected blockchain in the
 
 <EnableMFA />
 
+## Manage Multi Factor Authentication (MFA)
+
+<ManageMFA />
+
 ## Get idToken for Backend Verification
 
 <GetIdTokenInfo />
diff --git a/docs/sdk/pnp/web/no-modal/usage.mdx b/docs/sdk/pnp/web/no-modal/usage.mdx
@@ -13,6 +13,7 @@ import Provider from "@site/src/common/sdk/pnp/web/_provider-method.mdx";
 import ConnectedAdapterName from "@site/src/common/sdk/pnp/web/_connected-adapter-name-method.mdx";
 import Connected from "@site/src/common/sdk/pnp/web/_connected-method.mdx";
 import EnableMFA from "@site/src/common/sdk/pnp/web/_enable-mfa.mdx";
+import ManageMFA from "@site/src/common/sdk/pnp/web/_manage-mfa.mdx";
 import ExtraLoginOptions from "@site/src/common/sdk/pnp/web/_extra-login-options.mdx";
 import GetIdTokenInfo from "@site/src/common/sdk/pnp/web/_get-idtoken-info.mdx";
 import GetUserInfo from "@site/src/common/sdk/pnp/web/_get-user-info.mdx";
@@ -33,6 +34,7 @@ the following functions:
 - `connectTo()` - Logging in the User with the given Wallet Adapter and respective Login Parameters.
 - `getUserInfo()` - Getting the User's Information.
 - `enableMFA()` - Enable Multi Factor Authentication for the user.
+- `manageMFA()` - Redirect users to the Web3Auth Account Dashboard to manage their MFA settings.
 - `authenticateUser()` - Getting the idToken from Web3Auth.
 - `addChain()` - Add chain config details to the connected adapter.
 - `switchChain()` - Switch chain as per chainId already added to the chain config.
@@ -144,6 +146,10 @@ options.
 
 <EnableMFA />
 
+## Manage Multi Factor Authentication (MFA)
+
+<ManageMFA />
+
 ## Get idToken
 
 <GetIdTokenInfo />
diff --git a/src/common/sdk/pnp/web/_manage-mfa.mdx b/src/common/sdk/pnp/web/_manage-mfa.mdx
@@ -0,0 +1,32 @@
+import TabItem from "@theme/TabItem";
+import Tabs from "@theme/Tabs";
+
+#### `manageMFA()`
+
+You can redirect users to the Web3Auth Account Dashboard to manage their MFA settings by calling the
+`manageMFA()` function. This method ensures that identity details are injected into the dashboard
+internally for custom verifier-based dApps. In order to see what's present on the account dashboard,
+please refer to the [Account Dashboard](/features/account-dashboard).
+
+```javascript
+await web3auth.manageMFA();
+```
+
+#### Interface
+
+```typescript
+manageMFA<T>(loginParams?: T): Promise<void>;
+```
+
+- **`loginParams`** (optional): Optional parameters to include during the MFA management process.
+- **Returns**: A `Promise<void>` indicating successful redirection to the Account Dashboard.
+
+:::tip
+
+If MFA is not already enabled, the `manageMFA()` method will throw an error. Ensure you use
+`enableMFA()` before calling `manageMFA()`.
+
+If your dApp uses default verifiers, users can directly log in to the Account Dashboard to manage
+MFA. For custom verifier-based dApps, the `manageMFA()` method must be used.
+
+:::
