Skip to content

Commit b19b9c6

Browse files
2483b embedded wallets pass (#2556)
* style updates * further style alignment * review over pr state --------- Co-authored-by: Yashovardhan Agrawal <yashovardhan.agrawal@gmail.com>
1 parent 1f57f21 commit b19b9c6

File tree

143 files changed

+826
-770
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

143 files changed

+826
-770
lines changed

embedded-wallets/authentication/README.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Provides passwordless log in via one-time passcodes (OTP)/ magic links sent to t
2727

2828
### External wallets
2929

30-
Users can also authenticate using [third-party wallets](/embedded-wallets/authentication/basic-logins/external-wallets) such as MetaMask and other WalletConnect supported wallets. Developers can select which wallets to display via the Embedded Wallets Dashboard, providing tailored options based on user preference or regional relevance.
30+
Users can also authenticate using [third-party wallets](/embedded-wallets/authentication/basic-logins/external-wallets) such as MetaMask and other WalletConnect supported wallets. Developers can select which wallets to display via the dashboard, providing tailored options based on user preference or regional relevance.
3131

3232
### OAuth and social login
3333

embedded-wallets/authentication/basic-logins/email-passwordless.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import EmailPasswordlessToggle from '@site/static/img/embedded-wallets/w3a-dashb
88
import EmailPasswordlessAddConnection from '@site/static/img/embedded-wallets/w3a-dashboard/email-passwordless-add-connection.png'
99
import EmailPasswordlessOnboarding from '@site/static/img/embedded-wallets/w3a-dashboard/email-passwordless-onboarding.gif'
1010

11-
Web3Auth provides built-in support for email and SMS-based authentication, allowing users to log in seamlessly using a one-time passcode (OTP) sent to their email address or phone number. This form of passwordless authentication simplifies the onboarding process, removes friction for end users, and expands accessibility—especially in regions where social login options may be limited.
11+
Embedded Wallets provides built-in support for email and SMS-based authentication, allowing users to log in seamlessly using a one-time passcode (OTP) sent to their email address or phone number. This form of passwordless authentication simplifies the onboarding process, removes friction for end users, and expands accessibility—especially in regions where social login options may be limited.
1212

1313
<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
1414
<img
@@ -25,9 +25,9 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow
2525

2626
## Set up a custom email connection
2727

28-
:::success Enable on Dashboard
28+
:::success Enable on dashboard
2929

30-
To use this feature, developers must first enable `Email Passwordless` from the Social Connections section in the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
30+
To use this feature, developers must first enable **Email Passwordless** from the Social Connections section in the [dashboard](https://dashboard.web3auth.io).
3131

3232
> By default, Web3Auth uses its own pre-configured credentials for email login.
3333
@@ -47,11 +47,11 @@ To use this feature, developers must first enable `Email Passwordless` from the
4747

4848
For enhanced control and branding, developers are encouraged to configure a custom email connection. Follow these steps:
4949

50-
1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
51-
2. Go to the `Social Connections` section.
52-
3. Click the `Settings` icon next to the toggle for `Email Passwordless`.
50+
1. Visit the [dashboard](https://dashboard.web3auth.io).
51+
2. Navigate to the **Social Connections** section.
52+
3. Click the **Settings** icon (next to the toggle for **Email Passwordless**.
5353
4. Enter your custom `Auth Connection ID`.
54-
5. Click `Add Connection` to complete the setup.
54+
5. Click **Add Connection** to complete the setup.
5555

5656
<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
5757
<img

embedded-wallets/authentication/basic-logins/external-wallets.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow
1111

1212
## Enable external wallets
1313

14-
:::success Enable on Dashboard
14+
:::success Enable on dashboard
1515

16-
To enable this feature, developers must first activate `External Wallets` from the Social Connections section in the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
16+
To enable this feature, developers must first activate **External Wallets** from the **Social Connections** section in the [dashboard](https://dashboard.web3auth.io).
1717

1818
:::
1919

@@ -29,11 +29,11 @@ To enable this feature, developers must first activate `External Wallets` from t
2929
/>
3030
</div>
3131

32-
To choose which external wallets to enable, click the `Settings` icon next to the **External Wallets** toggle in the Social Connections section of the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
32+
To choose which external wallets to enable, click the **Settings** icon next to the **External Wallets** toggle in the Social Connections section of the [dashboard](https://dashboard.web3auth.io).
3333

3434
:::note
3535

36-
Metamask Wallet is enabled by default and cannot be disabled.
36+
MetamMask Wallet is enabled by default and cannot be disabled.
3737

3838
:::
3939

embedded-wallets/authentication/basic-logins/sms-otp.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow
2424

2525
## Set up a custom SMS OTP connection
2626

27-
:::success Enable on Dashboard
27+
:::success Enable on dashboard
2828

29-
To use this feature, developers must first enable `SMS OTP` from the Social Connections section in the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
29+
To use this feature, developers must first enable **SMS OTP** from the **Social Connections** section in the [dashboard](https://dashboard.web3auth.io).
3030

3131
> By default, Web3Auth uses its own pre-configured credentials for SMS OTP login.
3232
@@ -46,11 +46,11 @@ To use this feature, developers must first enable `SMS OTP` from the Social Conn
4646

4747
For enhanced control and branding, developers are encouraged to configure a custom SMS OTP connection. Follow these steps:
4848

49-
1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
50-
2. Go to the `Social Connections` section.
51-
3. Click the `Settings` icon next to the toggle for `SMS OTP`.
49+
1. Visit the [dashboard](https://dashboard.web3auth.io).
50+
2. Go to the **Social Connections** section.
51+
3. Click the **Settings** icon next to the toggle for **SMS OTP**.
5252
4. Enter your custom `Auth Connection ID`.
53-
5. Click `Add Connection` to complete the setup.
53+
5. Click **Add Connection** to complete the setup.
5454

5555
<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
5656
<img

embedded-wallets/authentication/custom-connections/auth0.mdx

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ import ImplicitLoginAuth0Spa from '../../sdk/react/advanced/_custom-authenticati
1717

1818
[Auth0](https://auth0.com/docs/get-started/auth0-overview) is a powerful authentication and authorization platform that enables developers to securely manage user identities. Web3Auth offers native support for integrating Auth0 as a service provider, allowing projects to leverage Auth0’s robust authentication mechanisms within the Web3Auth ecosystem.
1919

20-
[Take a look at the supported social logins on Auth0](https://marketplace.auth0.com/categories/social-login)
20+
Auth0 supports a [wide set of social logins](https://marketplace.auth0.com/categories/social-login).
2121

2222
## Create an Auth0 application
2323

24-
To begin, developers must first create an Auth0 application specific to their project. This initial setup is essential before configuring the connection with Web3Auth. Once the Auth0 application is created, developers can proceed to establish an Auth0 connection within the Embedded Wallets Dashboard.
24+
To begin, developers must first create an Auth0 application specific to their project. This initial setup is essential before configuring the connection with Web3Auth. Once the Auth0 application is created, developers can proceed to establish an Auth0 connection within the [dashboard](https://dashboard.web3auth.io).
2525

2626
This integration allows users to authenticate through Auth0, while still benefiting from Web3Auth’s key management and wallet abstraction features. For platform-specific implementation details or additional customization, developers are encouraged to refer to the [official Auth0 documentation](https://auth0.com/docs/quickstart/native#webapp).
2727

@@ -68,9 +68,9 @@ export const Auth0Setup = [
6868

6969
## Create an Auth0 connection
7070

71-
:::success Create Auth0 Connection on Dashboard
71+
:::success Connect Auth0
7272

73-
To use this feature, developers must go to the `Custom Connections` tab in the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
73+
To use this feature, developers must go to the **Custom Connections** tab in the [dashboard](https://dashboard.web3auth.io).
7474

7575
:::
7676

@@ -88,15 +88,15 @@ To use this feature, developers must go to the `Custom Connections` tab in the [
8888

8989
Follow these steps to create an Auth0 connection:
9090

91-
1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
92-
2. Go to the `Custom Connections` section.
93-
3. Click on the `Settings` icon near the Auth0 connection.
91+
1. Visit the [dashboard](https://dashboard.web3auth.io).
92+
2. Go to the **Custom Connections** section.
93+
3. Click on the **Settings** icon near the Auth0 connection.
9494
4. Enter the `Auth Connection ID`.
95-
5. Select the `JWT user identifier`: `email`, `sub` or `custom`.
96-
6. Toggle the Case Sensitivity of `User Identifier`. (Optional)
95+
5. Select the **JWT user identifier**: `email`, `sub` or `custom`.
96+
6. (Optional) Toggle the case sensitivity of **User Identifier**.
9797
7. Enter `Auth0 Client ID`.
9898
8. Enter `Auth0 Domain`.
99-
9. Finally, click on the `Add Connection` button.
99+
9. Click on the **Add Connection** button to save the settings.
100100

101101
<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
102102
<img
@@ -112,7 +112,7 @@ Follow these steps to create an Auth0 connection:
112112

113113
## Usage
114114

115-
Since, the `Auth0 Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`.
115+
Since, the `Auth0 Connection` details are available from the dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`.
116116

117117
> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow.
118118
@@ -140,7 +140,7 @@ In your activity, create a `Web3Auth` instance with your Web3Auth project's conf
140140
web3Auth = Web3Auth(
141141
Web3AuthOptions(
142142
context = this,
143-
clientId = getString(R.string.web3auth_project_id), // pass over your Web3Auth Client ID from Developer Dashboard
143+
clientId = getString(R.string.web3auth_project_id), // pass over your Web3Auth Client ID from Embedded Wallets dashboard
144144
network = Network.SAPPHIRE_MAINNET
145145
redirectUrl = Uri.parse("{YOUR_APP_PACKAGE_NAME}://auth"), // your app's redirect URL
146146
// focus-start

embedded-wallets/authentication/custom-connections/aws-cognito.mdx

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -8,23 +8,23 @@ import CustomConnectionOptions from '@site/static/img/embedded-wallets/w3a-dashb
88
import AWSConnection from '@site/static/img/embedded-wallets/w3a-dashboard/aws-cognito-connection.png'
99
import ImplicitLoginCognito from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_aws_cognito.mdx'
1010

11-
[AWS Cognito](https://aws.amazon.com/cognito/) is a scalable authentication service provided by Amazon Web Services that enables developers to securely manage user sign-up, sign-in, and access control. Web3Auth supports AWS Cognito as a service provider, allowing seamless integration between AWS Cognito’s authentication capabilities and Web3Auth’s decentralized key management infrastructure.
11+
[AWS Cognito](https://aws.amazon.com/cognito/) is a scalable authentication service provided by Amazon Web Services that enables developers to securely manage user sign-up, sign-in, and access control. Embedded Wallets supports AWS Cognito as a service provider, allowing seamless integration between AWS Cognito’s authentication capabilities and Embedded Wallets’s decentralized key management infrastructure.
1212

13-
[Take a look at the supported social logins on AWS Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-social-idp.html)
13+
AWS Cognito [supports a wide set of social logins](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-social-idp.html).
1414

1515
## Create an AWS Cognito application
1616

1717
To begin the integration process, developers must first create a new AWS Cognito application using the [AWS Management Console](https://console.aws.amazon.com/). This initial setup is required before configuring the connection within Web3Auth.
1818

19-
Once the AWS Cognito application is created, developers can proceed to add it as a custom connection in the Embedded Wallets Dashboard.
19+
Once the AWS Cognito application is created, developers can proceed to add it as a custom connection in the dashboard.
2020

2121
[Learn how to set up AWS Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-console).
2222

2323
## Create an AWS Cognito connection
2424

25-
:::success Create AWS Cognito Connection on Dashboard
25+
:::success Create AWS Cognito Connection
2626

27-
To use this feature, developers must go to the `Custom Connections` tab in the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
27+
To use this feature, developers must go to the **Custom Connections** tab in the [dashboard](https://dashboard.web3auth.io).
2828

2929
:::
3030

@@ -42,18 +42,18 @@ To use this feature, developers must go to the `Custom Connections` tab in the [
4242

4343
Follow these steps to create a AWS Cognito connection:
4444

45-
1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io).
46-
1. Go to the `Custom Connections` section.
47-
1. Click on the `Settings` icon near the `AWS Cognito` connection.
45+
1. Visit the [dashboard](https://dashboard.web3auth.io).
46+
1. Go to the **Custom Connections** section.
47+
1. Click on the **Settings** icon near the `AWS Cognito` connection.
4848
1. Enter the `Cognito Connection ID`.
4949
1. Paste `https://cognito-idp.{REGION}.amazonaws.com/{USER_POOL_ID}/.well-known/jwks.json` as `JWKS Endpoint`.
50-
1. Paste a sample `JWT Token` to auto populate the best **JWT validations** possible.
51-
1. Select the `JWT user identifier`: `email`, `sub` or `custom`.
52-
1. Toggle the Case Sensitivity of `User Identifier`. (Optional)
53-
1. Click on `Add Custom Validations` to add validations manually.
50+
1. Paste a sample JWT Token to auto populate the best **JWT validations** possible.
51+
1. Select the **JWT user identifier**: `email`, `sub` or `custom`.
52+
1. (Optional) Toggle the case sensitivity of **User Identifier**.
53+
1. Click on **Add Custom Validations** to add validations manually.
5454
1. Type iss as a field and `https://cognito-idp.{REGION}.amazonaws.com/{USER_POOL_ID}` as a value.
5555
1. Next, type aud as a field and `APP_CLIENT_ID` as a value.
56-
1. Finally, click on the `Add Connection` button.
56+
1. Click on the **Add Connection** button to save the settings.
5757

5858
> Note: Replace the `REGION`, `USER_POOL_ID` and `APP_CLIENT_ID` with your Cognito specific details.
5959
@@ -71,7 +71,7 @@ Follow these steps to create a AWS Cognito connection:
7171

7272
## Usage
7373

74-
Since, the `AWS Cognito Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`.
74+
Since, the `AWS Cognito Connection` details are available from the dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`.
7575

7676
> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow.
7777

0 commit comments

Comments
 (0)