Implement the Frontend
Here we learn how to connect the user's wallet with the web application and sign messages.
A completed version of this part can be found in the example repository (01_frontend). This example uses the browser console to print messages, so it should be actively monitored.
To sign in with Ethereum we only need to send two pieces of information:
  • The message
  • The signature of the message
On the previous page, we wrote a function that gives us the means to create messages, so now we only need the means to sign messages.
So we must first connect the web application and the user's wallet so that the application can request information about the Ethereum account and sign messages.
1. In order to do that we will need to add some new dependencies to our print project:
mkdir siwe-frontend && cd siwe-frontend/
npm init --yes
mkdir src/
npm install --save siwe ethers
npm install --save-dev html-webpack-plugin \
webpack \
webpack-cli \
2. Create a new file webpack.config.js and add the following:
const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
mode: 'development',
entry: './src/index.js',
resolve: {
fallback: {
fs: false,
path: false,
util: false
output: {
filename: 'main.js',
path: path.resolve(__dirname, 'dist')
plugins: [
new HtmlWebpackPlugin({
template: './src/index.html',
filename: 'index.html'
3. Make sure that package.json has the scripts section and match it to the following:
"name": "frontend",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"dev": "webpack serve"
"keywords": [],
"author": "",
"license": "ISC",
"dependencies": {
"ethers": "^5.5.3",
"siwe": "^1.0.0"
"devDependencies": {
"html-webpack-plugin": "^5.5.0",
"webpack": "^5.67.0",
"webpack-cli": "^4.9.2",
"webpack-dev-server": "^4.7.3"
4. Populate src/index.js with the following:
import { ethers } from 'ethers';
import { SiweMessage } from 'siwe';
const domain =;
const origin = window.location.origin;
const provider = new ethers.providers.Web3Provider(window.ethereum);
const signer = provider.getSigner();
function createSiweMessage (address, statement) {
const message = new SiweMessage({
uri: origin,
version: '1',
chainId: '1'
return message.prepareMessage();
function connectWallet () {
provider.send('eth_requestAccounts', [])
.catch(() => console.log('user rejected request'));
async function signInWithEthereum () {
const message = createSiweMessage(
await signer.getAddress(),
'Sign in with Ethereum to the app.'
console.log(await signer.signMessage(message));
// Buttons from the HTML page
const connectWalletBtn = document.getElementById('connectWalletBtn');
const siweBtn = document.getElementById('siweBtn');
connectWalletBtn.onclick = connectWallet;
siweBtn.onclick = signInWithEthereum;
5. Populate src/index.html with the following:
<!DOCTYPE html>
<meta charset="utf-8" />
<title>SIWE Quickstart</title>
<div><button id='connectWalletBtn'>Connect wallet</button></div>
<div><button id='siweBtn'>Sign-in with Ethereum</button></div>
6. Now run the following command and visit the URL printed to the console. After you connect your wallet and sign the message, the signature should appear in the console.
npm run dev

Explanation of Components

  • ​ethers.js is a library that provides functionality for interacting with the Ethereum blockchain. We use it here for connecting the webpage to extension wallets.
  • The Metamask extension injects the window.ethereum object into every webpage, and the ethers library provides a convenient provider class to wrap it. We then use this provider to connect to the wallet, and access signing capabilities:
const provider = new ethers.providers.Web3Provider(window.ethereum);
const signer = provider.getSigner();
  • Running the connectWallet function below will send a request to the MetaMask extension to ask permission to view information about the Ethereum accounts that it controls. MetaMask will then show a window to the user asking them to authorize our application to do so. If they authorize the request then we've connected their account:
function connectWallet () {
provider.send('eth_requestAccounts', [])
.catch(() => console.log('user rejected request'));
  • We can also now start signing requests with the following:
await signer.signMessage(message);
To disconnect an account, the user must do so from the MetaMask extension in this example.
Copy link