Skip to content

2483b embedded wallets pass #2556

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
m4sterbunny wants to merge 6 commits into
base: main
Choose a base branch
from
Open

2483b embedded wallets pass #2556

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
7454d20
style updates
m4sterbunny Dec 3, 2025
981c8a3
further style alignment
m4sterbunny Dec 3, 2025
963f818
review over pr state
m4sterbunny Dec 3, 2025
bda9f08
Merge branch 'main' into 2483b-embedded-wallets-pass
m4sterbunny Dec 8, 2025
b9ece5d
Merge branch 'main' into 2483b-embedded-wallets-pass
m4sterbunny Dec 10, 2025
a8ea7cd
Merge branch 'main' into 2483b-embedded-wallets-pass
m4sterbunny Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion embedded-wallets/authentication/README.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Provides passwordless log in via one-time passcodes (OTP)/ magic links sent to t

### External wallets

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.
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.

### OAuth and social login

Expand Down
14 changes: 7 additions & 7 deletions embedded-wallets/authentication/basic-logins/email-passwordless.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ import EmailPasswordlessToggle from '@site/static/img/embedded-wallets/w3a-dashb
import EmailPasswordlessAddConnection from '@site/static/img/embedded-wallets/w3a-dashboard/email-passwordless-add-connection.png'
import EmailPasswordlessOnboarding from '@site/static/img/embedded-wallets/w3a-dashboard/email-passwordless-onboarding.gif'

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.
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.

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

## Set up a custom email connection

:::success Enable on Dashboard
:::success Enable on dashboard

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

> By default, Web3Auth uses its own pre-configured credentials for email login.

Expand All @@ -47,11 +47,11 @@ To use this feature, developers must first enable `Email Passwordless` from the

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

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

<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
<img
Expand Down
8 changes: 4 additions & 4 deletions embedded-wallets/authentication/basic-logins/external-wallets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow

## Enable external wallets

:::success Enable on Dashboard
:::success Enable on dashboard

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

:::

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

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).
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).

:::note

Metamask Wallet is enabled by default and cannot be disabled.
MetamMask Wallet is enabled by default and cannot be disabled.

:::

Expand Down
12 changes: 6 additions & 6 deletions embedded-wallets/authentication/basic-logins/sms-otp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow

## Set up a custom SMS OTP connection

:::success Enable on Dashboard
:::success Enable on dashboard

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

> By default, Web3Auth uses its own pre-configured credentials for SMS OTP login.

Expand All @@ -46,11 +46,11 @@ To use this feature, developers must first enable `SMS OTP` from the Social Conn

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

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

<div style={{ display: 'flex', margin: '20px 0', justifyContent: 'center' }}>
<img
Expand Down
24 changes: 12 additions & 12 deletions embedded-wallets/authentication/custom-connections/auth0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,11 @@ import ImplicitLoginAuth0Spa from '../../sdk/react/advanced/_custom-authenticati

[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.

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

## Create an Auth0 application

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.
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).

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).

Expand Down Expand Up @@ -68,9 +68,9 @@ export const Auth0Setup = [

## Create an Auth0 connection

:::success Create Auth0 Connection on Dashboard
:::success Connect Auth0

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

:::

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

Follow these steps to create an Auth0 connection:

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

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

## Usage

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

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

Expand Down Expand Up @@ -140,7 +140,7 @@ In your activity, create a `Web3Auth` instance with your Web3Auth project's conf
web3Auth = Web3Auth(
Web3AuthOptions(
context = this,
clientId = getString(R.string.web3auth_project_id), // pass over your Web3Auth Client ID from Developer Dashboard
clientId = getString(R.string.web3auth_project_id), // pass over your Web3Auth Client ID from Embedded Wallets dashboard
network = Network.SAPPHIRE_MAINNET
redirectUrl = Uri.parse("{YOUR_APP_PACKAGE_NAME}://auth"), // your app's redirect URL
// focus-start
Expand Down
28 changes: 14 additions & 14 deletions embedded-wallets/authentication/custom-connections/aws-cognito.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,23 +8,23 @@ import CustomConnectionOptions from '@site/static/img/embedded-wallets/w3a-dashb
import AWSConnection from '@site/static/img/embedded-wallets/w3a-dashboard/aws-cognito-connection.png'
import ImplicitLoginCognito from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_aws_cognito.mdx'

[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.
[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.

[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)
AWS Cognito [supports a wide set of social logins](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-social-idp.html).

## Create an AWS Cognito application

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.

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

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

## Create an AWS Cognito connection

:::success Create AWS Cognito Connection on Dashboard
:::success Create AWS Cognito Connection

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

:::

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

Follow these steps to create a AWS Cognito connection:

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

> Note: Replace the `REGION`, `USER_POOL_ID` and `APP_CLIENT_ID` with your Cognito specific details.

Expand All @@ -71,7 +71,7 @@ Follow these steps to create a AWS Cognito connection:

## Usage

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

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

Expand Down
Loading
Loading