Skip to main content

Getting started with Web3Auth (Web)


This guide is a hello world tutorial to get quickly familiar with Web3Auth.We will go through the use of Web3auth plug and play modal with minimal lines of code.


Install Web3Auth sdk from npm to use and configure web3auth modal. We are also installing @web3auth/base package to get access to common types and interfaces for web3auth.

npm i --save @web3auth/web3auth npm i --save @web3auth/base

Initialize web3auth instance

We need clientId and chainNamespace to initialize web3auth class. You can get your clientId by registering your app on developer dashboard, whereas chainNamespace signifies the type of chain you want to initialize web3auth with, currently it supports eip155 for evm compatible chains and solana for solana blockchain.

    import { Web3Auth } from "@web3auth/web3auth";
import { CHAIN_NAMESPACES } from "@web3auth/base";

// We are initializing with EIP155 namespace which
// will initialize the modal with ethereum mainnet
// by default.
const web3auth = new Web3Auth({
chainConfig: { chainNamespace: CHAIN_NAMESPACES.EIP155 }
clientId: "localhost-id" // get your clientId from

await web3auth.initModal();

Subscribe to login events

We can get notified by various events during user's login session by subscribing to web3auth events. You can implement the logic of checking whether user is logged in or not based on these events. Below is the code snippet for subscribing to web3auth events.

subscribeAuthEvents(web3auth: Web3Auth) {
console.log("Yeah!, you are successfully logged in", data);

web3auth.on(ADAPTER_STATUS.CONNECTING, () => {
web3auth.on(ADAPTER_STATUS.ERRORED, (error) => {
console.log("some error or user have cancelled login request", error);

Display web3Auth modal and authenticate user

So far we have successfully initialized web3auth sdk and subscribed to events.We just need to use connect function of web3auth instance to display modal and we will be notified under our subscribed events on any user interaction with the modal.

Also after successful user login, web3auth instance will expose a provider under web3auth.provider which we will use interact with blockchain and sign transactions.


Get authenticated user info

Once user is connected you can get the information available for authenticated user by calling getUserInfo function.

  const userInfo = await web3auth.getUserInfo();

Note: You will get different information about user based on the login method used by user. For ex: if user authenticates using social logins then you will get name, email and profile image of user whereas if user is using some wallet like metamask to login then you will get only ethereum address of user.

Using provider to sign blockchain transactions

We can do sign transactions and make rpc calls to connected chain by using provider available on web3auth instance once user is logged in. Refer to documentation about providers to know more about the rpc calls available on provider for each chainNamespace.


At last we can also add function to logout user session. Calling logout function will disconnect user session and it will emit DISCONNECTED event on successful disconnection on web3auth instance.

 await web3auth.logout();


You have completed this tutorial,you can refer to working code of this tutorial here.