Skip to main content
import { useStytch } from '@stytch/react';
import { useCallback } from 'react';

export const Login = () => {
const stytch = useStytch();

const trigger = useCallback(async () => {
  /* Request user's address */
  const [crypto_wallet_address] = await ethereum.request({
    method: 'eth_requestAccounts',
  });

  /* Ask Stytch to generate a challenge for the user */
  const { challenge } = await stytch.cryptoWallets.authenticateStart({
    crypto_wallet_address,
    crypto_wallet_type: 'ethereum',
  });

  /* Ask the user to sign the challenge, this takes place on your frontend and uses the browser's built-in crypto provider API. */
  const signature = await ethereum.request({
    method: 'personal_sign',
    params: [challenge, crypto_wallet_address],
  });

  /* Send the signature back to Stytch for validation */
  await stytch.cryptoWallets.authenticate({
    crypto_wallet_address,
    crypto_wallet_type: 'ethereum',
    signature,
    session_duration_minutes: 60,
  });
}, [stytch]);

return <button onClick={trigger}>Sign in with Ethereum</button>;
};
{
  "challenge": "Signing in with Project: 7_EPetPqfdEiDCJtgad6-xsXytN3Ee9tx6mdRTQK3fC7-J2PDxpP1GAvYB9Ic4E09h-K88STiRIzKSGP",
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141"
  "status_code": 200
}
Wraps the Crypto Wallet Authenticate Start endpoint. Call this method to prompt the user to sign a challenge using their crypto wallet. For Ethereum crypto wallets, the challenge will follow the Sign In With Ethereum (SIWE) protocol if you have toggled SIWE Enabled in the SDK Configuration page . The domain and URI will be inferred automatically, but you may optionally override the URI. Load the challenge data by calling cryptoWallets.authenticateStart(). You’ll then pass this challenge to the user’s wallet for signing. You can do so by using the crypto provider’s built-in API and by including the crypto_wallet_address and challenge that is provided from cryptoWallets.authenticateStart(). See Ethereum’s EIP-1193 for an example of Ethereum’s provider API.

Parameters

crypto_wallet_type
string
required
The type of wallet to authenticate. Currently ethereum and solana are supported. Wallets for any EVM-compatible chains (such as Polygon or BSC) are also supported and are grouped under the ethereum type.
crypto_wallet_address
string
required
The crypto wallet address to authenticate.
siwe_params
object
The parameters for a Sign In With Ethereum (SIWE) message. May only be passed if the crypto_wallet_type is ethereum and if you have toggled SIWE Enabled in the Frontend SDK page.

Response

challenge
string
A challenge string to be signed by the wallet in order to prove ownership.
request_id
string
Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.
status_code
number
The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.