DEV Community

Cover image for Metamask authentication with Moralis in Next.js
Avneesh Agarwal for ByteSlash

Posted on • Originally published at blog.avneesh.tech

Metamask authentication with Moralis in Next.js

If you haven't been living under a rock you have probably heard of Web 3.0!
Living under a rock

One of the most important parts of a full-stack is authentication. So let's see how to authorize users with their Metamask wallet in a Next.js app.

If you don't know what is metamask then check out their website

Setting up the app

Create a new next app

npx create-next-app next-metamask
Enter fullscreen mode Exit fullscreen mode

Navigate into the app

cd next-metamask
Enter fullscreen mode Exit fullscreen mode

Installing the required dependencies

npm i @walletconnect/web3-provider moralis react-moralis # npm

yarn add @walletconnect/web3-provider moralis react-moralis # yarn
Enter fullscreen mode Exit fullscreen mode

Start the server

npm run dev # npm

yarn dev # yarn
Enter fullscreen mode Exit fullscreen mode

Get Moralis Credentials

Go to moralis and signup/login. After that click on Create new Server and select TestNet Server

image.png

By selecting it you will see a popup. Fill in the details, and click the Add Instance button.

image.png

After the server is created click on view details

image.png

We are going to need the server URL and Application ID

image.png

Building out the authentication system

Adding the environment variables

Create a .env.local file in the root of your folder and add the env variables like this-

NEXT_PUBLIC_MORALIS_APP_ID=<app_id>
NEXT_PUBLIC_MORALIS_SERVER_ID=<server_id>
Enter fullscreen mode Exit fullscreen mode

You need to replace the values of the variables with the credentials you got from Moralis.

Wrap the app in a MoralisProvider

Go to _app.js and wrap the <Component {...pageProps} /> with the Moralis Provider with the env variables like this-

<MoralisProvider
  appId={process.env.NEXT_PUBLIC_MORALIS_APP_ID}
  serverUrl={process.env.NEXT_PUBLIC_MORALIS_SERVER_ID}
>
  <Component {...pageProps} />
</MoralisProvider>
Enter fullscreen mode Exit fullscreen mode

Now import MoralisProvider from react-moralis

import { MoralisProvider } from "react-moralis";
Enter fullscreen mode Exit fullscreen mode

Creating the sign-in button
I am going to do create the login button on the home page, feel free to create it on any page you need.

Get the authenticate function from the useMoralis hook-

const { authenticate } = useMoralis();
Enter fullscreen mode Exit fullscreen mode

You also need to import the hook from react-moralis

import { useMoralis } from "react-moralis";
Enter fullscreen mode Exit fullscreen mode

Create a button like this-

<button
  onClick={() => {
    authenticate({ provider: "metamask" });
  }}
>
  Sign in with MetaMask
</button>
Enter fullscreen mode Exit fullscreen mode

Now if we click on sign in, it will open the metamask extension for sign in.

%[https://www.loom.com/share/c2b1c9936ad44185810d9978ea5c2193]

Show signout button if the user is signed out

We need to get a few more things from the useMoralis hook like this-

const { authenticate, isAuthenticated, logout } = useMoralis();
Enter fullscreen mode Exit fullscreen mode

Create a ternary operator to show the logout button, if the user is signed in otherwise show the sign-in button-

{isAuthenticated ? (
    <button
      onClick={logout}
    >
      Logout
    </button>
  ) : (
    <button
      onClick={() => {
        authenticate({ provider: "metamask" });
      }}
    >
      Sign in with MetaMask
    </button>
  );
}
Enter fullscreen mode Exit fullscreen mode

Now our sign in and sign out is working 🥳🥳

Getting the user data
Let's see how to get some basic data like their eth address and username.

When the user is authenticated, you can add this fragment to show the userName and their address wallet-

<>
  <button onClick={logout}>Logout</button>
  <h2>Welcome {user.get("username")}</h2>
  <h2>Your wallet address is {user.get("ethAddress")}</h2>
</>
Enter fullscreen mode Exit fullscreen mode

You need to get the user from the useMoralis hook as well-

const { authenticate, isAuthenticated, logout, user } = useMoralis();
Enter fullscreen mode Exit fullscreen mode

image.png

The userName is very random 😂but it can help in some cases and the eth address can be used for transactions.

Signing off

It was this easy to implement authentication of metamask with moralis 🤯

Hope you found this tutorial useful and stay tuned for more of these web 3.0 tutorials ✌️

Useful links

GitHub repo

Moralis

Metamask

Connect with me

Discussion (2)

Collapse
obiknows profile image
OBINNA

thank you this helpul AF. the NEXT_PUBLIC_ piece is essential b/c you get an error if you don't put it b/c these env vars need to be exposed on the browser

Collapse
avneesh0612 profile image
Avneesh Agarwal Author

Yeah. Glad you found it useful