Developer Docs

Overview

Sign-In with Ethereum (SIWE) is a standard for passwordless authentication using Ethereum accounts. It allows users to authenticate to your application by signing a message with their Ethereum address, providing a self-custodied alternative to centralized identity providers. Learn more about the SIWE standard (EIP-4361).

Compatibility

SIWE SDK methods are available via the siwe module of the Web and React Native client-side SDKs.

Available Methods: Users authenticated through the SIWE extension can use the following user methods:

user.isLoggedIn()
user.getInfo()
user.logout()

SIWE authentication is designed for authentication purposes, so wallet operations are handled through the user’s third-party wallet provider.

Usage

Installation

npm install magic-sdk @magic-ext/siwe

yarn add magic-sdk @magic-ext/siwe

To authenticate users with a third-party wallet (e.g., MetaMask, Coinbase Wallet), follow these steps:

Generate a SIWE message using the wallet’s address
Sign the message with the third-party wallet
Complete authentication with Magic using the message and signature

JavaScript

import { Magic } from 'magic-sdk';
import { SiweExtension } from '@magic-ext/siwe';

const magic = new Magic('PUBLISHABLE_API_KEY', {
  extensions: [new SiweExtension()],
});

const signInWithWallet = async (walletProvider, walletAddress) => {
  try {
    // 1. Generate the SIWE message
    const message = await magic.siwe.generateMessage({
      address: walletAddress,
      chainId: 1, // Optional: defaults to Ethereum mainnet
    });

    // 2. Sign the message with the third-party wallet
    const signature = await walletProvider.request({
      method: 'personal_sign',
      params: [message, walletAddress],
    });

    // 3. Complete authentication with Magic
    const publicAddress = await magic.siwe.login({ message, signature });
    
    console.log('SIWE authentication complete! Public Address:', publicAddress);
    return publicAddress;
  } catch (error) {
    console.error('SIWE authentication error:', error);
    throw error;
  }
};

To authenticate users with Worldcoin Mini Apps, you can use World App’s native wallet integration. Follow these steps:

Generate a nonce from Magic
Request wallet authentication from World App
Extract the signed message and signature
Complete authentication with Magic

This example requires the @worldcoin/minikit-js package. See the Worldcoin Mini Apps documentation for setup instructions.

JavaScript

import { Magic } from 'magic-sdk';
import { SiweExtension } from '@magic-ext/siwe';
import { MiniKit } from '@worldcoin/minikit-js';

const magic = new Magic('PUBLISHABLE_API_KEY', {
  extensions: [new SiweExtension()],
});

const signInWithWorldcoin = async () => {
  try {
    // 1. Generate a nonce from Magic
    const nonce = await magic.siwe.generateNonce();

    // 2. Request wallet authentication from World App
    const { finalPayload } = await MiniKit.commandsAsync.walletAuth({
      nonce,
    });

    if (!finalPayload || finalPayload.status !== 'success') {
      throw new Error('World App wallet authentication failed');
    }

    // 3. Extract the signed message and signature
    const { message, signature } = finalPayload;

    // 4. Complete authentication with Magic
    const publicAddress = await magic.siwe.login({ message, signature });
    
    console.log('SIWE authentication complete! Public Address:', publicAddress);
    return publicAddress;
  } catch (error) {
    console.error('SIWE authentication error:', error);
    throw error;
  }
};

​Overview

​Compatibility

​Usage

​Installation

​Sign in with a Third-Party Wallet

​Sign in with Worldcoin Mini App

Overview

Compatibility

Usage

Installation

Sign in with a Third-Party Wallet

Sign in with Worldcoin Mini App