Интеграция MetaMask для авторизации на сайте (Web3 Login)

Интеграция MetaMask для авторизации на сайте (Web3 Login)

Web3 Login через MetaMask позволяет пользователям авторизоваться на сайте, подписав сообщение криптографическим ключом кошелька. Никаких паролей — доказательство владения адресом через подпись.

Механизм авторизации

1. Фронтенд запрашивает nonce у сервера для адреса кошелька
2. MetaMask показывает пользователю сообщение для подписи
3. Пользователь подписывает — MetaMask возвращает подпись
4. Сервер верифицирует подпись и выдаёт JWT

Frontend: подключение MetaMask

import { ethers } from 'ethers';

async function loginWithMetaMask(): Promise<void> {
  // 1. Проверить наличие MetaMask
  if (!window.ethereum) {
    throw new Error('MetaMask не установлен');
  }

  // 2. Запросить доступ к аккаунтам
  const provider = new ethers.BrowserProvider(window.ethereum);
  await provider.send('eth_requestAccounts', []);
  const signer = await provider.getSigner();
  const address = await signer.getAddress();

  // 3. Получить nonce от сервера
  const nonceResponse = await fetch(`/api/auth/nonce?address=${address}`);
  const { nonce } = await nonceResponse.json();

  // 4. Подписать сообщение
  const message = `Войти на example.com\n\nNonce: ${nonce}\nTime: ${new Date().toISOString()}`;
  const signature = await signer.signMessage(message);

  // 5. Отправить подпись серверу
  const authResponse = await fetch('/api/auth/web3', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ address, signature, message })
  });

  const { token } = await authResponse.json();
  localStorage.setItem('auth_token', token);
}

Backend: верификация подписи

// Node.js + ethers.js
import { ethers } from 'ethers';
import { randomBytes } from 'crypto';

// Хранение nonce (Redis с TTL 5 мин)
async function getNonce(address: string): Promise<string> {
  const normalized = address.toLowerCase();
  const existing = await redis.get(`nonce:${normalized}`);
  if (existing) return existing;

  const nonce = randomBytes(16).toString('hex');
  await redis.setex(`nonce:${normalized}`, 300, nonce);
  return nonce;
}

// Верификация
async function verifyWeb3Auth(req, res) {
  const { address, signature, message } = req.body;
  const normalized = address.toLowerCase();

  // Проверить nonce в сообщении
  const storedNonce = await redis.get(`nonce:${normalized}`);
  if (!storedNonce || !message.includes(storedNonce)) {
    return res.status(401).json({ error: 'Invalid or expired nonce' });
  }

  // Восстановить адрес из подписи
  const recoveredAddress = ethers.verifyMessage(message, signature).toLowerCase();

  if (recoveredAddress !== normalized) {
    return res.status(401).json({ error: 'Signature verification failed' });
  }

  // Удалить использованный nonce
  await redis.del(`nonce:${normalized}`);

  // Найти или создать пользователя
  let user = await userRepo.findByWalletAddress(normalized);
  if (!user) {
    user = await userRepo.create({ walletAddress: normalized });
  }

  const token = jwt.sign(
    { sub: user.id, walletAddress: normalized },
    process.env.JWT_SECRET,
    { expiresIn: '7d' }
  );

  res.json({ token, userId: user.id });
}

Поддержка нескольких кошельков

// Привязка дополнительного кошелька к аккаунту
async function linkWallet(userId: string, address: string, signature: string) {
  const existing = await walletRepo.findByAddress(address.toLowerCase());
  if (existing) throw new Error('Wallet already linked to another account');

  await walletRepo.create({
    userId,
    address: address.toLowerCase(),
    linkedAt: new Date()
  });
}

Сроки

MetaMask Login с nonce-верификацией и JWT — 2–3 дня.