From 6ea9bcaa933d34f05d080345aa8d0e9a21f8f2c9 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Fri, 21 Nov 2025 12:39:29 +0000 Subject: [PATCH 01/14] light style pass: catches minor errors too Signed-off-by: m4sterbunny --- embedded-wallets/README.mdx | 18 +++++++-------- embedded-wallets/authentication/README.mdx | 10 ++++----- .../basic-logins/email-passwordless.mdx | 4 ++-- .../basic-logins/external-wallets.mdx | 2 +- .../authentication/basic-logins/sms-otp.mdx | 4 ++-- .../custom-connections/auth0.mdx | 10 ++++----- .../custom-connections/aws-cognito.mdx | 8 +++---- .../custom-connections/custom-jwt.mdx | 14 ++++++------ .../custom-connections/firebase.mdx | 10 ++++----- .../authentication/group-connections.mdx | 8 +++---- embedded-wallets/authentication/id-token.mdx | 16 +++++++------- .../authentication/social-logins/discord.mdx | 6 ++--- .../authentication/social-logins/facebook.mdx | 4 ++-- .../authentication/social-logins/google.mdx | 4 ++-- .../authentication/social-logins/oauth.mdx | 22 +++++++++---------- .../authentication/social-logins/twitch.mdx | 12 +++++----- 16 files changed, 77 insertions(+), 75 deletions(-) diff --git a/embedded-wallets/README.mdx b/embedded-wallets/README.mdx index f4cea8712e0..cf60ab8f108 100644 --- a/embedded-wallets/README.mdx +++ b/embedded-wallets/README.mdx @@ -111,7 +111,7 @@ export const GetStarted = [ slug="/embedded-wallets/" /> -MetaMask Embedded Wallets (formerly Web3Auth) is a pluggable embedded wallet infrastructure that simplifies Web3 wallet integration and user onboarding. It supports OAuth-based logins and multiple platforms, allowing users to access Web3 applications through familiar authentication methods in under a minute. +MetaMask Embedded Wallets (formerly Web3Auth) provides a pluggable embedded wallet infrastructure to simplify Web3 wallet integration and user onboarding. It supports OAuth-based logins and multiple platforms, allowing users to access Web3 applications through familiar authentication methods in under a minute. Users enjoy seamless onboarding while maintaining full control of their non-custodial wallets, ensuring both convenience and security. @@ -121,11 +121,11 @@ The SDKs are now branded as MetaMask Embedded Wallet SDKs (formerly Web3Auth Plu ::: -## Get Started +## Get started -## Key Features +## Key features {() => { @@ -134,15 +134,15 @@ The SDKs are now branded as MetaMask Embedded Wallet SDKs (formerly Web3Auth Plu }} -### 🔐 Authentication Made Simple +### 🔐 Authentication made simple Get your users started in seconds with familiar login methods they already use: -- Sign in with Google, Twitter, GitHub and other popular social accounts -- Passwordless login via email, SMS, authenticator apps or passkeys +- Sign in with Google, Twitter, GitHub, and other popular social accounts +- Passwordless login via email, SMS, authenticator apps, or passkeys - Bring your own auth system while leveraging our secure wallet infrastructure -### 🛡️ Bank-Grade Security +### 🛡️ Bank-grade security Enterprise-level protection for your users' digital assets: @@ -151,7 +151,7 @@ Enterprise-level protection for your users' digital assets: - Distributed architecture prevents single points of failure - Multiple backup options for worry-free recovery -### 💻 Built for Developers +### 💻 Built for developers Integrate MetaMask Embedded Wallets into your app with minimal effort: @@ -160,7 +160,7 @@ Integrate MetaMask Embedded Wallets into your app with minimal effort: - Full control to customize the look and feel - Support for web, mobile, and gaming platforms -### 👥 Designed for Users +### 👥 Designed for users The smoothest path to Web3 for your users: diff --git a/embedded-wallets/authentication/README.mdx b/embedded-wallets/authentication/README.mdx index 6413ccda2cc..edf1139fc01 100644 --- a/embedded-wallets/authentication/README.mdx +++ b/embedded-wallets/authentication/README.mdx @@ -17,19 +17,19 @@ The SDKs are now branded as MetaMask Embedded Wallet SDKs (formerly Web3Auth Plu :::: -## Supported Authentication Methods +## Supported authentication methods Embedded Wallets supports a wide range of authentication options, enabling developers to meet the needs of diverse user bases and platform requirements. -### Native Email & SMS Login +### Native email & SMS login Provides passwordless login via one-time passcodes (OTP)/ magic links sent to the user's [email address](/embedded-wallets/authentication/basic-logins/email-passwordless) or [phone number](/embedded-wallets/authentication/basic-logins/sms-otp). This method is widely accessible and especially useful for onboarding users unfamiliar with Web3 or crypto wallets. -### External Wallets +### 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. -### OAuth and Social Login +### OAuth and social login Embedded Wallets supports a variety of social identity providers, allowing users to authenticate using accounts they already trust and use daily. Supported providers include: @@ -124,7 +124,7 @@ export const SocialLoginSetup = [ Social login simplifies onboarding by reducing friction and improving usability—particularly in consumer-facing applications. -### JWT-Based Authentication +### JWT-based authentication Embedded Wallets allows integration with any existing JWT-based authentication system. This includes OpenID Connect (OIDC) and OAuth 2.0 compliant identity providers such as: diff --git a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx index c63f5d85e65..d0fae39ad69 100644 --- a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx +++ b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx @@ -23,7 +23,7 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow /> -## Set Up a Custom Email Connection +## Set up a Custom email connection :::success Enable on Dashboard @@ -96,4 +96,4 @@ const web3AuthContextConfig: Web3AuthContextConfig = { export default web3AuthContextConfig ``` -Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. diff --git a/embedded-wallets/authentication/basic-logins/external-wallets.mdx b/embedded-wallets/authentication/basic-logins/external-wallets.mdx index 2fa02ade1a3..64e98d8c734 100644 --- a/embedded-wallets/authentication/basic-logins/external-wallets.mdx +++ b/embedded-wallets/authentication/basic-logins/external-wallets.mdx @@ -9,7 +9,7 @@ import ExternalWalletsSelectWallets from '@site/static/img/embedded-wallets/w3a- 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. -## Enable External Wallets +## Enable external wallets :::success Enable on Dashboard diff --git a/embedded-wallets/authentication/basic-logins/sms-otp.mdx b/embedded-wallets/authentication/basic-logins/sms-otp.mdx index 32e94ab3c9c..cd2feda6cd6 100644 --- a/embedded-wallets/authentication/basic-logins/sms-otp.mdx +++ b/embedded-wallets/authentication/basic-logins/sms-otp.mdx @@ -22,7 +22,7 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow /> -## Set Up a Custom SMS OTP Connection +## Set up a custom SMS OTP connection :::success Enable on Dashboard @@ -96,4 +96,4 @@ const web3AuthContextConfig: Web3AuthContextConfig = { export default web3AuthContextConfig ``` -Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. diff --git a/embedded-wallets/authentication/custom-connections/auth0.mdx b/embedded-wallets/authentication/custom-connections/auth0.mdx index d4cc4c32f26..67399876eff 100644 --- a/embedded-wallets/authentication/custom-connections/auth0.mdx +++ b/embedded-wallets/authentication/custom-connections/auth0.mdx @@ -15,11 +15,11 @@ import JwtLoginAuth0 from '../../sdk/react/advanced/_custom-authentication-snipp import ImplicitLoginAuth0Google from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_auth0_google.mdx' import ImplicitLoginAuth0Spa from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_auth0_spa.mdx' -Auth0 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. +[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) -## Create an Auth0 Application +## 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. @@ -66,7 +66,7 @@ export const Auth0Setup = [ -## Create an Auth0 Connection +## Create an Auth0 connection :::success Create Auth0 Connection on Dashboard @@ -132,7 +132,7 @@ Since, the `Auth0 Connection` details are available from Dashboard, developers d ### Android -##### Create Web3Auth Instance +##### Create Web3Auth instance In your activity, create a `Web3Auth` instance with your Web3Auth project's configurations. @@ -184,7 +184,7 @@ When connecting, the `login` function takes the LoginParams arguments for the lo ### Flutter -##### Create Web3Auth Instance +##### Create a Web3Auth instance In your `main.dart` file, initialize the `Web3AuthFlutter` plugin at the very beginning such as in the overriden `initState` function diff --git a/embedded-wallets/authentication/custom-connections/aws-cognito.mdx b/embedded-wallets/authentication/custom-connections/aws-cognito.mdx index 28fa93df282..ffbe1393004 100644 --- a/embedded-wallets/authentication/custom-connections/aws-cognito.mdx +++ b/embedded-wallets/authentication/custom-connections/aws-cognito.mdx @@ -8,11 +8,11 @@ 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 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. Web3Auth supports AWS Cognito as a service provider, allowing seamless integration between AWS Cognito’s authentication capabilities and Web3Auth’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) -## Create an AWS Cognito Application +## 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. @@ -20,7 +20,7 @@ Once the AWS Cognito application is created, developers can proceed to add it as [Learn how to set up AWS Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-console). -## Create an AWS Cognito Connection +## Create an AWS Cognito connection :::success Create AWS Cognito Connection on Dashboard @@ -75,6 +75,6 @@ Since, the `AWS Cognito Connection` details are available from Dashboard, develo > Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. -### Login with AWS Cognito +### Log in with AWS Cognito diff --git a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx index 3e24bde22ab..86dd2840b97 100644 --- a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx +++ b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx @@ -12,13 +12,13 @@ import CustomConnectionOptions from '@site/static/img/embedded-wallets/w3a-dashb import CustomJWTConnection from '@site/static/img/embedded-wallets/w3a-dashboard/custom-connection.png' import JwtLoginCustom from '../../sdk/react/advanced/_custom-authentication-snippets/_jwt_login_custom.mdx' -Web3Auth supports integration with custom login providers through JWT-based authentication schemes, allowing developers to maintain their existing authentication infrastructure while leveraging Web3Auth’s wallet and key management capabilities. Custom authentication can be implemented using industry-standard cryptographic algorithms such as RSA or ECDSA signatures. +Web3Auth supports integration with custom login providers through [JWT-based](https://www.jwt.io/introduction#what-is-json-web-token) authentication schemes, allowing developers to maintain their existing authentication infrastructure while leveraging Web3Auth’s wallet and key management capabilities. Custom authentication can be implemented using industry-standard cryptographic algorithms such as RSA or ECDSA signatures. To use this feature, developers must ensure that their JWTs adhere to the [JWT specification](https://datatracker.ietf.org/doc/html/rfc7519). Each JWT must be signed using a private key, and its corresponding public key must be accessible via a [JWKS (JSON Web Key Set)](https://datatracker.ietf.org/doc/html/rfc7517) endpoint. Web3Auth will use this endpoint to verify the integrity and authenticity of incoming tokens during login. -Once the Custom JWT login is working, developers can proceed to add it as a custom connection in the Embedded Wallets Dashboard. +Once the custom JWT login is working, developers can proceed to add it as a custom connection in the Embedded Wallets Dashboard. -## Set up Custom JWT Connection +## Set up Custom JWT connection :::success Create Custom Connection on Dashboard @@ -38,7 +38,7 @@ To use this feature, developers must go to the `Custom Connections` tab in the [ /> -Follow these steps to create a AWS Cognito connection: +Follow these steps to create a JWT custom connection: 1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io). 1. Go to the `Custom Connections` section. @@ -69,7 +69,7 @@ Follow these steps to create a AWS Cognito connection: To generate the JWT, developers may use a package of their choice. Web3Auth provides documentation and examples using both the `jsonwebtoken` and `jose` libraries. -### Generate Private Key +### Generate a private key Developers can generate a private key using the `openssl` command-line tool. This private key will be used to sign the ID token. @@ -113,7 +113,7 @@ openssl ec -in ec-secp256k1-privateKey.pem -pubout -out ec-secp256k1-publicKey.p -### Install JWT Library +### Install the JWT library Developers can install a JWT library of their choice. Following are the documentation and examples using both the `jsonwebtoken` and `jose` libraries. @@ -251,7 +251,7 @@ Since, the `Custom Connection` details are available from Dashboard, developers > Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. -### Login with JWT +### Log in with JWT diff --git a/embedded-wallets/authentication/custom-connections/firebase.mdx b/embedded-wallets/authentication/custom-connections/firebase.mdx index 5efc6b5967f..211a5140487 100644 --- a/embedded-wallets/authentication/custom-connections/firebase.mdx +++ b/embedded-wallets/authentication/custom-connections/firebase.mdx @@ -10,11 +10,11 @@ import CustomConnectionOptions from '@site/static/img/embedded-wallets/w3a-dashb import FirebaseConnection from '@site/static/img/embedded-wallets/w3a-dashboard/firebase-connection.png' import JwtLoginFirebase from '../../sdk/react/advanced/_custom-authentication-snippets/_jwt_login_firebase.mdx' -Firebase is a popular backend platform that enables developers to seamlessly integrate authentication, databases, and other services into their applications. Web3Auth supports Firebase as an authentication provider, allowing developers to leverage Firebase Authentication within the Web3Auth framework for secure user login and key management. +[Firebase](https://firebase.google.com/) is a popular backend platform that enables developers to seamlessly integrate authentication, databases, and other services into their applications. Web3Auth supports Firebase as an authentication provider, allowing developers to leverage Firebase Authentication within the Web3Auth framework for secure user login and key management. [Take a look at the supported social logins on Firebase](https://firebase.google.com/docs/auth) -## Create a Firebase Project +## Create a Firebase project To get started, developers must first create a Firebase project in the Firebase Console. This is a required step before integrating Firebase with Web3Auth. Once the Firebase project is set up, developers can proceed to configure a Firebase connection in the Embedded Wallets Dashboard. @@ -63,7 +63,7 @@ export const FirebaseSetup = [ -## Create a Firebase Connection +## Create a Firebase connection :::success Create Firebase Connection on Dashboard @@ -122,7 +122,7 @@ Since, the `Firebase Connection` details are available from Dashboard, developer ### Android -##### Create Web3Auth Instance +##### Create a Web3Auth instance In your activity, create a `Web3Auth` instance with your Web3Auth project's configurations. @@ -204,7 +204,7 @@ When connecting, the `login` function takes the LoginParams arguments for the lo ### Flutter -##### Create Web3Auth Instance +##### Create a Web3Auth instance In your `main.dart` file, initialize the `Web3AuthFlutter` plugin at the very beginning such as in the overriden `initState` function diff --git a/embedded-wallets/authentication/group-connections.mdx b/embedded-wallets/authentication/group-connections.mdx index 8d412d5efd4..55fc8c3756b 100644 --- a/embedded-wallets/authentication/group-connections.mdx +++ b/embedded-wallets/authentication/group-connections.mdx @@ -17,11 +17,11 @@ import GroupConnectionAuth0Implicit from '../sdk/react/advanced/_custom-authenti import GroupConnectionAuth0JWT from '../sdk/react/advanced/_custom-authentication-snippets/_grouped_auth_jwt_auth0.mdx' import GroupModal from '../sdk/react/advanced/_custom-authentication-snippets/_grouped_modal_connections.mdx' -Group Connections enable multiple login methods to be linked to the same on-chain user identity. This means that users logging in with different authentication providers (e.g., **_Google and Email Passwordless_**) can still access the **same wallet address**—ensuring a unified user experience. +Group Connections enable multiple login methods to be linked to the same on-chain user identity. This means that users logging in with different authentication providers (for example, **_Google and Email Passwordless_**) can still access the **same wallet address**—ensuring a unified user experience. > _Before setting up a group connection, developers must first configure individual login connections that are eligible._ -## Set Up a Group Connection +## Set up a group connection :::success Create Group Connection on Dashboard @@ -76,9 +76,9 @@ Follow these steps: ## Usage -Since, the `Group Connections` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. +Since, the `Group Connections` details are available from the dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. diff --git a/embedded-wallets/authentication/id-token.mdx b/embedded-wallets/authentication/id-token.mdx index b11e8640335..3dddfc7cb1e 100644 --- a/embedded-wallets/authentication/id-token.mdx +++ b/embedded-wallets/authentication/id-token.mdx @@ -12,15 +12,15 @@ The **Identity Token** (ID Token) issued by Web3Auth is a JSON Web Token (JWT) t Once a user successfully authenticates via Web3Auth, the platform issues an ID token which can then be used to authorize client-to-server requests or verify ownership of associated wallet addresses. -#### Purpose of the ID Token +#### Purpose of the ID token -- **User Identity Verification**: Ensures that the client user is indeed who they claim to be. -- **Secure Backend Requests**: The token should be passed in API requests to validate sessions server-side. -- **Wallet Ownership Proof**: Includes public wallet keys to prove a user owns a particular wallet. +- **User identity verification**: Ensures that the client user is indeed who they claim to be. +- **Secure backend requests**: The token should be passed in API requests to validate sessions server-side. +- **Wallet ownership proof**: Includes public wallet keys to prove a user owns a particular wallet. When making a backend request from the frontend, the client must include this ID token to ensure the backend can verify the authenticated user. -## ID Token Format +## ID Token format Web3Auth tokens are ES256-signed JWTs containing various identity claims about the user. @@ -130,7 +130,7 @@ try { To validate an ID token server-side, use Web3Auth's JWKS endpoint or project-specific verification key. This process ensures the JWT was issued by Web3Auth and its contents have not been tampered with. -### Using JWKS Endpoint +### Using JWKS endpoint @@ -318,7 +318,7 @@ const validateIdToken = async () => { -### Using Verification Key +### Using the verification key To manually verify the token, use your **Verification Key** available on the **Project Settings** page in the Embedded Wallets Dashboard. @@ -384,7 +384,7 @@ If the token is valid, the payload will contain identity claims (e.g., userId). ::: -## Things to Remember +## Things to remember - The `iss` field in the token must be `https://api-auth.web3auth.io`. - The `aud` field must match your **Project Client ID**. diff --git a/embedded-wallets/authentication/social-logins/discord.mdx b/embedded-wallets/authentication/social-logins/discord.mdx index 07c4ab7464f..707a7ea075d 100644 --- a/embedded-wallets/authentication/social-logins/discord.mdx +++ b/embedded-wallets/authentication/social-logins/discord.mdx @@ -7,7 +7,7 @@ description: 'Discord Social Login with Embedded Wallets | Embedded Wallets' import DiscordToggle from '@site/static/img/embedded-wallets/w3a-dashboard/authentication-social-connections.png' import DiscordConnection from '@site/static/img/embedded-wallets/w3a-dashboard/discord-connection.png' -Discord Login is a social login provider that allows users to sign in using their Discord credentials. Web3Auth supports Discord as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Discord accounts. +[Discord Login](https://discord.com/developers/docs/topics/oauth2) is a social login provider that allows users to sign in using their Discord credentials. Web3Auth supports Discord as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Discord accounts. To integrate Discord with Web3Auth, developers must first create a Discord App via the [Discord Developer Portal](https://discord.com/developers/applications). @@ -26,7 +26,7 @@ To integrate Discord with Web3Auth, developers must first create a Discord App v ![Discord OAuth2.0 App Client ID and Secret](/img/embedded-wallets/authentication/discord/discord-clientid-secret.png) -## Create a Discord Connection +## Create a Discord connection :::success Enable on Dashboard @@ -75,7 +75,7 @@ Since, the `Discord Connection` details are available from Dashboard, developers > Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. -### Login with Discord +### Log in with Discord ```jsx await connectTo(WALLET_CONNECTORS.AUTH, { diff --git a/embedded-wallets/authentication/social-logins/facebook.mdx b/embedded-wallets/authentication/social-logins/facebook.mdx index ecede80a30c..3c245bf7512 100644 --- a/embedded-wallets/authentication/social-logins/facebook.mdx +++ b/embedded-wallets/authentication/social-logins/facebook.mdx @@ -8,7 +8,7 @@ import FacebookToggle from '@site/static/img/embedded-wallets/w3a-dashboard/auth import FacebookConnection from '@site/static/img/embedded-wallets/w3a-dashboard/facebook-connection.png' import ImplicitLoginFacebook from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_facebook.mdx' -Facebook Login enables users to sign in using their Facebook credentials. Web3Auth supports Facebook as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Facebook accounts. +[Facebook Login](https://developers.facebook.com/docs/facebook-login/) enables users to sign in using their Facebook credentials. Web3Auth supports Facebook as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Facebook accounts. To integrate Facebook with Web3Auth, developers must first create a Facebook App via the [Meta for Developers Console](https://developers.facebook.com/). @@ -30,7 +30,7 @@ To integrate Facebook with Web3Auth, developers must first create a Facebook App ![Facebook OAuth2.0 App Dashboard](/img/embedded-wallets/authentication/facebook/facebook-app-id-secret.png) -## Create a Facebook Connection +## Create a Facebook connection :::success Enable on Dashboard diff --git a/embedded-wallets/authentication/social-logins/google.mdx b/embedded-wallets/authentication/social-logins/google.mdx index 2eef380d48c..746d6dd24a0 100644 --- a/embedded-wallets/authentication/social-logins/google.mdx +++ b/embedded-wallets/authentication/social-logins/google.mdx @@ -12,7 +12,7 @@ import GoogleConnection from '@site/static/img/embedded-wallets/w3a-dashboard/go import JwtLoginGoogle from '../../sdk/react/advanced/_custom-authentication-snippets/_jwt_login_google_one_tap.mdx' import ImplicitLoginGoogle from '../../sdk/react/advanced/_custom-authentication-snippets/_implicit_login_google.mdx' -Google Sign-In is a widely adopted authentication method that allows users to log in using their existing Google accounts. Web3Auth supports Google as a social login provider, enabling seamless onboarding and authentication experiences for users with Google credentials. +[Google Sign-In](https://developers.google.com/identity/sign-in/web/sign-in) is a widely adopted authentication method that allows users to log in using their existing Google accounts. Web3Auth supports Google as a social login provider, enabling seamless onboarding and authentication experiences for users with Google credentials. To integrate Google Sign-In with Web3Auth, developers must first configure a Google OAuth 2.0 Client ID in the Google Cloud Console. @@ -26,7 +26,7 @@ To integrate Google Sign-In with Web3Auth, developers must first configure a Goo 3. Obtain the OAuth `Client ID` from the [App on the Google Developer dashboard](https://console.developers.google.com/) -## Create a Google Connection +## Create a Google connection :::success Enable on Dashboard diff --git a/embedded-wallets/authentication/social-logins/oauth.mdx b/embedded-wallets/authentication/social-logins/oauth.mdx index 6173f7035fe..5d1da0d056d 100644 --- a/embedded-wallets/authentication/social-logins/oauth.mdx +++ b/embedded-wallets/authentication/social-logins/oauth.mdx @@ -6,7 +6,7 @@ description: 'OAuth 2.0 Login with Embedded Wallets | Embedded Wallets' import OAuthToggle from '@site/static/img/embedded-wallets/w3a-dashboard/authentication-social-connections.png' -OAuth 2.0 is a widely adopted standard that enables users to authenticate with third-party identity providers in a secure and user-friendly manner. Web3Auth offers native support for multiple OAuth 2.0 login options, allowing developers to integrate familiar authentication experiences directly into their applications. +[OAuth 2.0](https://oauth.net/2/) is a widely adopted standard that enables users to authenticate with third-party identity providers in a secure and user-friendly manner. Web3Auth offers native support for multiple OAuth 2.0 login options, allowing developers to integrate familiar authentication experiences directly into their applications. :::success Enable on Dashboard @@ -32,7 +32,7 @@ To use this feature, please enable `X(Twitter)`, `Farcaster`, `Apple`, `GitHub`, > Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. -### Login with X +### Log in with X > Don't forget to enable X(Twitter) on the Dashboard. @@ -61,7 +61,7 @@ function CustomConnectors() { } ``` -### Login with Farcaster +### Log in with Farcaster > Don't forget to enable Farcaster on the Dashboard. @@ -90,7 +90,7 @@ function CustomConnectors() { } ``` -### Login with Apple +### Log in with Apple > Don't forget to enable Apple on the Dashboard. @@ -119,7 +119,7 @@ function CustomConnectors() { } ``` -### Login with GitHub +### Log in with GitHub > Don't forget to enable GitHub on the Dashboard. @@ -148,7 +148,7 @@ function CustomConnectors() { } ``` -### Login with Reddit +### Log in with Reddit > Don't forget to enable Reddit on the Dashboard. @@ -177,7 +177,7 @@ function CustomConnectors() { } ``` -### Login with Line +### Log in with Line > Don't forget to enable Line on the Dashboard. @@ -206,7 +206,7 @@ function CustomConnectors() { } ``` -### Login with Kakao +### Log in with Kakao > Don't forget to enable Kakao on the Dashboard. @@ -235,7 +235,7 @@ function CustomConnectors() { } ``` -### Login with LinkedIn +### Log in with LinkedIn > Don't forget to enable LinkedIn on the Dashboard. @@ -264,9 +264,9 @@ function CustomConnectors() { } ``` -### Login with Wechat +### Log in with WeChat -> Don't forget to enable Wechat on the Dashboard. +> Don't forget to enable WeChat on the Dashboard. ```tsx title="App.tsx" import { useWeb3AuthConnect } from '@web3auth/modal/react' diff --git a/embedded-wallets/authentication/social-logins/twitch.mdx b/embedded-wallets/authentication/social-logins/twitch.mdx index 6732d9b2a12..93b97fb138e 100644 --- a/embedded-wallets/authentication/social-logins/twitch.mdx +++ b/embedded-wallets/authentication/social-logins/twitch.mdx @@ -7,13 +7,15 @@ description: 'Twitch Social Login with Embedded Wallets | Embedded Wallets' import TwitchToggle from '@site/static/img/embedded-wallets/w3a-dashboard/authentication-social-connections.png' import TwitchConnection from '@site/static/img/embedded-wallets/w3a-dashboard/twitch-connection.png' -Twitch Login is a social login provider that allows users to sign in using their Twitch credentials. Web3Auth supports Twitch as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Twitch accounts. +Twitch supports social log in, allowing users to [sign in using their Twitch credentials](https://dev.twitch.tv/docs/authentication/#user-access-tokens). Web3Auth supports Twitch as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Twitch accounts. -To integrate Twitch with Web3Auth, developers must first create a Twitch App via the [Twitch Developer Portal](https://dev.twitch.tv/console/apps). +## Prerequisites + +- Registered [Twitch App](https://dev.twitch.tv/docs/authentication/#registration) ## Create a Twitch app -1. Follow Twitch's [registration instructions](https://dev.twitch.tv/docs/authentication/#registration) to (register your app)[https://dev.twitch.tv/console/apps/create]. +1. Follow Twitch's [registration instructions](https://dev.twitch.tv/docs/authentication/#registration) to [register your app](https://dev.twitch.tv/console/apps/create). 2. Paste the following as a Redirect URI into the "OAuth Redirect URLs" field. - [https://auth.web3auth.io/auth](https://auth.web3auth.io/auth) @@ -27,7 +29,7 @@ To integrate Twitch with Web3Auth, developers must first create a Twitch App via ![Twitch OAuth2.0 App Manage](/img/embedded-wallets/authentication/twitch/twitch-client-id.png) -## Create a Twitch Connection +## Create a Twitch connection :::success Enable on Dashboard @@ -76,7 +78,7 @@ Since, the `Twitch Connection` details are available from Dashboard, developers > Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. -### Login with Twitch +### Log in with Twitch ```jsx await connectTo(WALLET_CONNECTORS.AUTH, { From 237a8eee7599bbb7258962d6665edf16c674f75b Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Fri, 21 Nov 2025 12:55:25 +0000 Subject: [PATCH 02/14] light style pass: catches minor errors too Signed-off-by: m4sterbunny --- embedded-wallets/authentication/README.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/embedded-wallets/authentication/README.mdx b/embedded-wallets/authentication/README.mdx index edf1139fc01..81cf2151efd 100644 --- a/embedded-wallets/authentication/README.mdx +++ b/embedded-wallets/authentication/README.mdx @@ -21,15 +21,15 @@ The SDKs are now branded as MetaMask Embedded Wallet SDKs (formerly Web3Auth Plu Embedded Wallets supports a wide range of authentication options, enabling developers to meet the needs of diverse user bases and platform requirements. -### Native email & SMS login +### Native email & SMS log in -Provides passwordless login via one-time passcodes (OTP)/ magic links sent to the user's [email address](/embedded-wallets/authentication/basic-logins/email-passwordless) or [phone number](/embedded-wallets/authentication/basic-logins/sms-otp). This method is widely accessible and especially useful for onboarding users unfamiliar with Web3 or crypto wallets. +Provides passwordless log in via one-time passcodes (OTP)/ magic links sent to the user's [email address](/embedded-wallets/authentication/basic-logins/email-passwordless) or [phone number](/embedded-wallets/authentication/basic-logins/sms-otp). This method is widely accessible and especially useful for onboarding users unfamiliar with Web3 or crypto wallets. ### 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. -### OAuth and social login +### OAuth and social log in Embedded Wallets supports a variety of social identity providers, allowing users to authenticate using accounts they already trust and use daily. Supported providers include: From 33c476778a24134f033c4681d424a070ab1caf97 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:22:46 +0000 Subject: [PATCH 03/14] Update embedded-wallets/authentication/basic-logins/email-passwordless.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- .../authentication/basic-logins/email-passwordless.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx index d0fae39ad69..d017c5613c1 100644 --- a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx +++ b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx @@ -23,7 +23,7 @@ Web3Auth provides built-in support for email and SMS-based authentication, allow /> -## Set up a Custom email connection +## Set up a custom email connection :::success Enable on Dashboard From cff697e9e965b07ae3be85b7ab22ac198c944755 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:23:29 +0000 Subject: [PATCH 04/14] Update embedded-wallets/authentication/basic-logins/email-passwordless.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- .../authentication/basic-logins/email-passwordless.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx index d017c5613c1..c2a4511d7a1 100644 --- a/embedded-wallets/authentication/basic-logins/email-passwordless.mdx +++ b/embedded-wallets/authentication/basic-logins/email-passwordless.mdx @@ -96,4 +96,4 @@ const web3AuthContextConfig: Web3AuthContextConfig = { export default web3AuthContextConfig ``` -Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. From 6fa701e31466e0f9fc309fd25ad02a5d5f97227f Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:23:41 +0000 Subject: [PATCH 05/14] Update embedded-wallets/authentication/basic-logins/sms-otp.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- embedded-wallets/authentication/basic-logins/sms-otp.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/basic-logins/sms-otp.mdx b/embedded-wallets/authentication/basic-logins/sms-otp.mdx index cd2feda6cd6..a66ffeb3631 100644 --- a/embedded-wallets/authentication/basic-logins/sms-otp.mdx +++ b/embedded-wallets/authentication/basic-logins/sms-otp.mdx @@ -96,4 +96,4 @@ const web3AuthContextConfig: Web3AuthContextConfig = { export default web3AuthContextConfig ``` -Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. From 68f9549062c5458faca1a1452a6632b8037a4774 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:23:53 +0000 Subject: [PATCH 06/14] Update embedded-wallets/authentication/custom-connections/auth0.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- embedded-wallets/authentication/custom-connections/auth0.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/custom-connections/auth0.mdx b/embedded-wallets/authentication/custom-connections/auth0.mdx index 67399876eff..5cdc431e212 100644 --- a/embedded-wallets/authentication/custom-connections/auth0.mdx +++ b/embedded-wallets/authentication/custom-connections/auth0.mdx @@ -132,7 +132,7 @@ Since, the `Auth0 Connection` details are available from Dashboard, developers d ### Android -##### Create Web3Auth instance +##### Create a Web3Auth instance In your activity, create a `Web3Auth` instance with your Web3Auth project's configurations. From 87b21b9edd09e8cf87471869d82cbb10920e06d3 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:24:05 +0000 Subject: [PATCH 07/14] Update embedded-wallets/authentication/custom-connections/custom-jwt.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- .../authentication/custom-connections/custom-jwt.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx index 86dd2840b97..3e0e5e02beb 100644 --- a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx +++ b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx @@ -18,7 +18,7 @@ To use this feature, developers must ensure that their JWTs adhere to the [JWT s Once the custom JWT login is working, developers can proceed to add it as a custom connection in the Embedded Wallets Dashboard. -## Set up Custom JWT connection +## Set up a custom JWT connection :::success Create Custom Connection on Dashboard From e46f0a2e944a5f7e7e07396ed6b980b7caafd47f Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:24:12 +0000 Subject: [PATCH 08/14] Update embedded-wallets/authentication/custom-connections/custom-jwt.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- .../authentication/custom-connections/custom-jwt.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx index 3e0e5e02beb..97b2d7d8374 100644 --- a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx +++ b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx @@ -38,7 +38,7 @@ To use this feature, developers must go to the `Custom Connections` tab in the [ /> -Follow these steps to create a JWT custom connection: +Follow these steps to create a custom JWT connection: 1. Visit the [Embedded Wallets Dashboard](https://dashboard.web3auth.io). 1. Go to the `Custom Connections` section. From 7194b39bd72d075fa07ff4d36e8a1907cdbe2eb9 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:24:24 +0000 Subject: [PATCH 09/14] Update embedded-wallets/authentication/group-connections.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- embedded-wallets/authentication/group-connections.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/group-connections.mdx b/embedded-wallets/authentication/group-connections.mdx index 55fc8c3756b..d1eab022c9b 100644 --- a/embedded-wallets/authentication/group-connections.mdx +++ b/embedded-wallets/authentication/group-connections.mdx @@ -78,7 +78,7 @@ Follow these steps: Since, the `Group Connections` details are available from the dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Start](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. From 3ee85fa46298eff0e928ea5eb9789c2abb073abe Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:24:34 +0000 Subject: [PATCH 10/14] Update embedded-wallets/authentication/id-token.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- embedded-wallets/authentication/id-token.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/id-token.mdx b/embedded-wallets/authentication/id-token.mdx index 3dddfc7cb1e..aa21c605898 100644 --- a/embedded-wallets/authentication/id-token.mdx +++ b/embedded-wallets/authentication/id-token.mdx @@ -20,7 +20,7 @@ Once a user successfully authenticates via Web3Auth, the platform issues an ID t When making a backend request from the frontend, the client must include this ID token to ensure the backend can verify the authenticated user. -## ID Token format +## ID token format Web3Auth tokens are ES256-signed JWTs containing various identity claims about the user. From 18ece34770ed9451b219cf466c3a1e8f258cab07 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:24:46 +0000 Subject: [PATCH 11/14] Update embedded-wallets/authentication/id-token.mdx Co-authored-by: Alexandra Carrillo <12214231+alexandratran@users.noreply.github.com> --- embedded-wallets/authentication/id-token.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/embedded-wallets/authentication/id-token.mdx b/embedded-wallets/authentication/id-token.mdx index aa21c605898..1167d68f1a3 100644 --- a/embedded-wallets/authentication/id-token.mdx +++ b/embedded-wallets/authentication/id-token.mdx @@ -130,7 +130,7 @@ try { To validate an ID token server-side, use Web3Auth's JWKS endpoint or project-specific verification key. This process ensures the JWT was issued by Web3Auth and its contents have not been tampered with. -### Using JWKS endpoint +### Using the JWKS endpoint From 207a261190dbb7a44ec3564abee305f8e70abbdb Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 08:57:56 +0000 Subject: [PATCH 12/14] locks in several more noun vs verb and fixes links for the same --- embedded-wallets/authentication/README.mdx | 22 +++++++++---------- .../custom-connections/auth0.mdx | 2 +- .../custom-connections/aws-cognito.mdx | 2 +- .../custom-connections/custom-jwt.mdx | 2 +- .../custom-connections/firebase.mdx | 2 +- .../authentication/social-logins/discord.mdx | 2 +- .../authentication/social-logins/facebook.mdx | 2 +- .../authentication/social-logins/google.mdx | 2 +- .../authentication/social-logins/oauth.mdx | 2 +- .../authentication/social-logins/twitch.mdx | 8 +++---- 10 files changed, 23 insertions(+), 23 deletions(-) diff --git a/embedded-wallets/authentication/README.mdx b/embedded-wallets/authentication/README.mdx index 81cf2151efd..ccfc999235d 100644 --- a/embedded-wallets/authentication/README.mdx +++ b/embedded-wallets/authentication/README.mdx @@ -21,7 +21,7 @@ The SDKs are now branded as MetaMask Embedded Wallet SDKs (formerly Web3Auth Plu Embedded Wallets supports a wide range of authentication options, enabling developers to meet the needs of diverse user bases and platform requirements. -### Native email & SMS log in +### Native email & SMS login Provides passwordless log in via one-time passcodes (OTP)/ magic links sent to the user's [email address](/embedded-wallets/authentication/basic-logins/email-passwordless) or [phone number](/embedded-wallets/authentication/basic-logins/sms-otp). This method is widely accessible and especially useful for onboarding users unfamiliar with Web3 or crypto wallets. @@ -29,7 +29,7 @@ Provides passwordless log in via one-time passcodes (OTP)/ magic links sent to t 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. -### OAuth and social log in +### OAuth and social login Embedded Wallets supports a variety of social identity providers, allowing users to authenticate using accounts they already trust and use daily. Supported providers include: @@ -48,13 +48,13 @@ export const SocialLoginSetup = [ key: 'apple', title: 'Apple', icon: 'logo-apple.png', - path: 'social-logins/oauth/#login-with-apple', + path: 'social-logins/oauth/##log-in-with-apple', }, { key: 'twitter', title: 'Twitter (X)', icon: 'logo-twitter.png', - path: 'social-logins/oauth/#login-with-x', + path: 'social-logins/oauth/##log-in-with-x', }, { key: 'facebook', @@ -78,43 +78,43 @@ export const SocialLoginSetup = [ key: 'github', title: 'GitHub', icon: 'logo-github.png', - path: 'social-logins/oauth/#login-with-github', + path: 'social-logins/oauth/#log-in-with-github', }, { key: 'farcaster', title: 'Farcaster', icon: 'logo-farcaster.png', - path: 'social-logins/oauth/#login-with-farcaster', + path: 'social-logins/oauth/##log-in-with-farcaster', }, { key: 'reddit', title: 'Reddit', icon: 'logo-reddit.png', - path: 'social-logins/oauth/#login-with-reddit', + path: 'social-logins/oauth/#log-in-with-reddit', }, { key: 'kakao', title: 'Kakao', icon: 'logo-kakao.png', - path: 'social-logins/oauth/#login-with-kakao', + path: 'social-logins/oauth/#log-in-with-kakao', }, { key: 'linkedin', title: 'LinkedIn', icon: 'logo-linkedin.png', - path: 'social-logins/oauth/#login-with-linkedin', + path: 'social-logins/oauth/#log-in-with-linkedin', }, { key: 'line', title: 'Line', icon: 'logo-line.png', - path: 'social-logins/oauth/#login-with-line', + path: 'social-logins/oauth/#log-in-with-line', }, { key: 'wechat', title: 'WeChat', icon: 'logo-wechat.png', - path: 'social-logins/oauth/#login-with-wechat', + path: 'social-logins/oauth/#log-in-with-wechat', }, ], }, diff --git a/embedded-wallets/authentication/custom-connections/auth0.mdx b/embedded-wallets/authentication/custom-connections/auth0.mdx index 5cdc431e212..9b38dc52da3 100644 --- a/embedded-wallets/authentication/custom-connections/auth0.mdx +++ b/embedded-wallets/authentication/custom-connections/auth0.mdx @@ -114,7 +114,7 @@ Follow these steps to create an Auth0 connection: Since, the `Auth0 Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Web diff --git a/embedded-wallets/authentication/custom-connections/aws-cognito.mdx b/embedded-wallets/authentication/custom-connections/aws-cognito.mdx index ffbe1393004..b7b3e35e26d 100644 --- a/embedded-wallets/authentication/custom-connections/aws-cognito.mdx +++ b/embedded-wallets/authentication/custom-connections/aws-cognito.mdx @@ -73,7 +73,7 @@ Follow these steps to create a AWS Cognito connection: Since, the `AWS Cognito Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Log in with AWS Cognito diff --git a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx index 97b2d7d8374..7e5d9a84985 100644 --- a/embedded-wallets/authentication/custom-connections/custom-jwt.mdx +++ b/embedded-wallets/authentication/custom-connections/custom-jwt.mdx @@ -249,7 +249,7 @@ Check out [**this troubleshooting page to fix those.**](/embedded-wallets/troubl Since, the `Custom Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Log in with JWT diff --git a/embedded-wallets/authentication/custom-connections/firebase.mdx b/embedded-wallets/authentication/custom-connections/firebase.mdx index 211a5140487..2da918a032f 100644 --- a/embedded-wallets/authentication/custom-connections/firebase.mdx +++ b/embedded-wallets/authentication/custom-connections/firebase.mdx @@ -114,7 +114,7 @@ Follow these steps to create a Firebase connection: Since, the `Firebase Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Web diff --git a/embedded-wallets/authentication/social-logins/discord.mdx b/embedded-wallets/authentication/social-logins/discord.mdx index 707a7ea075d..be2de0718e1 100644 --- a/embedded-wallets/authentication/social-logins/discord.mdx +++ b/embedded-wallets/authentication/social-logins/discord.mdx @@ -73,7 +73,7 @@ Follow these steps to create a Discord connection: Since, the `Discord Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Log in with Discord diff --git a/embedded-wallets/authentication/social-logins/facebook.mdx b/embedded-wallets/authentication/social-logins/facebook.mdx index 3c245bf7512..b06ef9b03b1 100644 --- a/embedded-wallets/authentication/social-logins/facebook.mdx +++ b/embedded-wallets/authentication/social-logins/facebook.mdx @@ -78,7 +78,7 @@ Follow these steps to create a Facebook connection: Since, the `Facebook Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Implicit Login with Facebook diff --git a/embedded-wallets/authentication/social-logins/google.mdx b/embedded-wallets/authentication/social-logins/google.mdx index 746d6dd24a0..51972f71b1d 100644 --- a/embedded-wallets/authentication/social-logins/google.mdx +++ b/embedded-wallets/authentication/social-logins/google.mdx @@ -73,7 +73,7 @@ Follow these steps to create a Google connection: Since, the `Google Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. diff --git a/embedded-wallets/authentication/social-logins/oauth.mdx b/embedded-wallets/authentication/social-logins/oauth.mdx index 5d1da0d056d..b02081b7f41 100644 --- a/embedded-wallets/authentication/social-logins/oauth.mdx +++ b/embedded-wallets/authentication/social-logins/oauth.mdx @@ -30,7 +30,7 @@ To use this feature, please enable `X(Twitter)`, `Farcaster`, `Apple`, `GitHub`, ## Usage -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Log in with X diff --git a/embedded-wallets/authentication/social-logins/twitch.mdx b/embedded-wallets/authentication/social-logins/twitch.mdx index 93b97fb138e..c1de7970a47 100644 --- a/embedded-wallets/authentication/social-logins/twitch.mdx +++ b/embedded-wallets/authentication/social-logins/twitch.mdx @@ -7,7 +7,7 @@ description: 'Twitch Social Login with Embedded Wallets | Embedded Wallets' import TwitchToggle from '@site/static/img/embedded-wallets/w3a-dashboard/authentication-social-connections.png' import TwitchConnection from '@site/static/img/embedded-wallets/w3a-dashboard/twitch-connection.png' -Twitch supports social log in, allowing users to [sign in using their Twitch credentials](https://dev.twitch.tv/docs/authentication/#user-access-tokens). Web3Auth supports Twitch as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Twitch accounts. +Twitch supports social login, allowing users to [sign in using their Twitch credentials](https://dev.twitch.tv/docs/authentication/#user-access-tokens). Web3Auth supports Twitch as a social login provider, allowing developers to offer a familiar and quick authentication method for users with Twitch accounts. ## Prerequisites @@ -21,11 +21,11 @@ Twitch supports social log in, allowing users to [sign in using their Twitch cre ![Twitch OAuth2.0 App Dashboard](/img/embedded-wallets/authentication/twitch/twitch-app.png) -3. After creation of your Twitch app, click **Manage** +3. After creation of your Twitch app, click **Manage**. ![Twitch OAuth2.0 App Manage](/img/embedded-wallets/authentication/twitch/twitch-manage.png) -4. Obtain the **Client ID** +4. Obtain the **Client ID**. ![Twitch OAuth2.0 App Manage](/img/embedded-wallets/authentication/twitch/twitch-client-id.png) @@ -76,7 +76,7 @@ Follow these steps to create a Twitch connection: Since, the `Twitch Connection` details are available from Dashboard, developers don't need to pass any additional parameters to the `Web3AuthProvider`. -> Follow our [Quick Starts](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to setup the basic flow. +> Follow our [quickstart](/quickstart/?product=EMBEDDED_WALLETS&walletAggregatorOnly=NO&framework=REACT&stepIndex=0) to set up the basic flow. ### Log in with Twitch From 14e54d507d17a539ef213d5b36568e6cb460f7f4 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 09:08:56 +0000 Subject: [PATCH 13/14] fixes for link issues --- embedded-wallets/authentication/README.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/embedded-wallets/authentication/README.mdx b/embedded-wallets/authentication/README.mdx index ccfc999235d..46179c5226b 100644 --- a/embedded-wallets/authentication/README.mdx +++ b/embedded-wallets/authentication/README.mdx @@ -48,13 +48,13 @@ export const SocialLoginSetup = [ key: 'apple', title: 'Apple', icon: 'logo-apple.png', - path: 'social-logins/oauth/##log-in-with-apple', + path: 'social-logins/oauth/#log-in-with-apple', }, { key: 'twitter', title: 'Twitter (X)', icon: 'logo-twitter.png', - path: 'social-logins/oauth/##log-in-with-x', + path: 'social-logins/oauth/#log-in-with-x', }, { key: 'facebook', @@ -84,7 +84,7 @@ export const SocialLoginSetup = [ key: 'farcaster', title: 'Farcaster', icon: 'logo-farcaster.png', - path: 'social-logins/oauth/##log-in-with-farcaster', + path: 'social-logins/oauth/#log-in-with-farcaster', }, { key: 'reddit', From a24a53943b30bf5657698ec8903ac85e53d34b14 Mon Sep 17 00:00:00 2001 From: m4sterbunny Date: Mon, 24 Nov 2025 09:17:18 +0000 Subject: [PATCH 14/14] fixes for link issues --- embedded-wallets/dashboard/authentication.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/embedded-wallets/dashboard/authentication.mdx b/embedded-wallets/dashboard/authentication.mdx index 2b201f9f1b5..a18aa5b33df 100644 --- a/embedded-wallets/dashboard/authentication.mdx +++ b/embedded-wallets/dashboard/authentication.mdx @@ -53,7 +53,7 @@ export const tileGroupsDataSocial = [ key: "twitter", title: "X (Twitter)", icon: "logo-twitter.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-x", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-x", }, { key: "facebook", @@ -71,44 +71,44 @@ export const tileGroupsDataSocial = [ key: "farcaster", title: "Farcaster", icon: "logo-farcaster.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-farcaster", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-farcaster", }, { key: "apple", title: "Apple", icon: "logo-apple.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-apple", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-apple", }, { key: "github", title: "GitHub", icon: "logo-github.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-github", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-github", }, { key: "reddit", title: "Reddit", icon: "logo-reddit.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-reddit", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-reddit", }, { key: "line", title: "Line", icon: "logo-line.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-line", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-line", }, { key: "kakao", title: "KaKao", icon: "logo-kakao.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-kakao", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-kakao", }, { key: "linkedin", title: "Linkedin", icon: "logo-linkedin.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-linkedin", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-linkedin", }, { key: "twitch", @@ -120,7 +120,7 @@ export const tileGroupsDataSocial = [ key: "wechat", title: "WeChat", icon: "logo-wechat.png", - path: "/embedded-wallets/authentication/social-logins/oauth/#login-with-wechat", + path: "/embedded-wallets/authentication/social-logins/oauth/#log-in-with-wechat", }, { key: "new",