Бэкенд dApp на Node.js: разработка с нуля

Мы разрабатываем серверную часть dApp на Node.js для проектов, где on-chain логики недостаточно. Если вам требуется приватный RPC прокси, SIWE-аутентификация, event indexer или газлесс релайер — мы создадим инфраструктуру с нуля под ключ. Без бэкенда не обойтись, когда нужны: агрегация данных с нескольких источников, кэширование дорогих on-chain запросов (экономия до 40% затрат на RPC), gasless транзакции (relayer), верификация подписей. Мы используем современный стек: Fastify, ethers.js/viem, Redis, Prisma. Наш опыт — более 10 лет в блокчейн-разработке и 50+ завершённых dApp проектов. Если вам нужен надёжный бэкенд dApp, закажите консультацию — рассчитаем состав работ и сроки.

Разработка бэкенда dApp на Node.js: ключевые компоненты

RPC abstraction layer — бэкенд dapp на

Прямое обращение из фронтенда к Infura/Alchemy раскрывает API ключ. Бэкенд проксирует RPC вызовы, добавляет кэширование и rate limiting:

import { JsonRpcProvider, Contract } from 'ethers';
import Fastify from 'fastify';

const provider = new JsonRpcProvider(process.env.RPC_URL);

const app = Fastify();

// Кэшированный endpoint для данных контракта
app.get('/contract/:address/balance/:account', {
  config: { rateLimit: { max: 100, timeWindow: '1 minute' } }
}, async (req, reply) => {
  const { address, account } = req.params as { address: string; account: string };
  const cacheKey = `balance:${address}:${account}`;
  
  const cached = await redis.get(cacheKey);
  if (cached) return { balance: cached, cached: true };
  
  const contract = new Contract(address, ERC20_ABI, provider);
  const balance = await contract.balanceOf(account);
  
  await redis.setex(cacheKey, 12, balance.toString()); // кэш на ~1 блок (12 сек)
  return { balance: balance.toString(), cached: false };
});

Как реализовать безопасную аутентификацию без пароля?

Sign-In With Ethereum (EIP-4361) — стандарт аутентификации без пароля, описанный в EIP-4361. Пользователь подписывает SIWE-сообщение, бэкенд верифицирует подпись и выдаёт JWT:

import { SiweMessage } from 'siwe';
import jwt from 'jsonwebtoken';

app.post('/auth/verify', async (req, reply) => {
  const { message, signature } = req.body;
  
  const siweMessage = new SiweMessage(message);
  const result = await siweMessage.verify({ signature });
  
  if (!result.success) {
    return reply.code(401).send({ error: 'Invalid signature' });
  }
  
  const token = jwt.sign(
    { address: result.data.address, chainId: result.data.chainId },
    process.env.JWT_SECRET!,
    { expiresIn: '7d' }
  );
  
  return { token };
});

Nonce для защиты от replay атак: генерируем случайный nonce, сохраняем в Redis с TTL 5 минут, верифицируем что nonce в SIWE сообщении совпадает с выданным. После использования — удаляем.

Настройка RPC прокси: пошаговая инструкция

1. Установите Fastify и ethers.js: npm install fastify ethers
2. Создайте файл server.ts и настройте rate limiter (например, @fastify/rate-limit)
3. Подключите Redis для кэширования: используйте библиотеку ioredis
4. Реализуйте fallback provider: при ошибке переключайтесь на резервный RPC URL
5. Добавьте эндпоинты для чтения данных (balance, symbol, decimals) с кэшированием
6. Настройте health check и логирование (pino)

Как обрабатывать on-chain события без задержек?

On-chain события нужны для отображения истории операций, уведомлений, аналитики. Два подхода:

WebSocket subscription (правильный) — используем на практике:

const wsProvider = new WebSocketProvider(process.env.WSS_RPC_URL);

const contract = new Contract(CONTRACT_ADDRESS, ABI, wsProvider);

contract.on('Transfer', async (from, to, value, event) => {
  await db.transfers.insert({
    from,
    to,
    value: value.toString(),
    blockNumber: event.log.blockNumber,
    txHash: event.log.transactionHash,
    timestamp: new Date(),
  });
  
  // Уведомить подписчиков через WebSocket/SSE
  eventBus.emit('transfer', { from, to, value: value.toString() });
});

// Обработка разрыва соединения
wsProvider.on('error', async () => {
  console.error('WS disconnected, reconnecting...');
  setTimeout(setupSubscriptions, 5000);
});

WebSocket соединения нестабильны — reconnect логика обязательна. Альтернатива для production: Alchemy webhooks, Quicknode Streams — провайдер сам доставляет события на ваш HTTP endpoint.

Gasless транзакции (meta-transactions)

EIP-2771 + ERC-2612 позволяют пользователю подписывать транзакцию офф-чейн, а relayer оплачивает газ. Бэкенд работает как relayer, что позволяет снизить затраты на газ для пользователя на 30-50%:

app.post('/relay/transfer', authenticateJWT, async (req, reply) => {
  const { permit, signature } = req.body; // ERC-2612 permit
  
  // Верифицируем permit signature
  const tokenContract = new Contract(TOKEN_ADDRESS, ERC20_ABI, wallet);
  
  // Проверяем что permit валиден и не истёк
  const nonce = await tokenContract.nonces(permit.owner);
  if (BigInt(permit.nonce) !== nonce) {
    return reply.code(400).send({ error: 'Invalid nonce' });
  }
  
  // Выполняем permit + transferFrom за пользователя
  const tx = await tokenContract.permit(
    permit.owner, permit.spender, permit.value,
    permit.deadline, permit.v, permit.r, permit.s
  );
  await tx.wait();
  
  return { txHash: tx.hash };
});

Для production gasless транзакций: OpenZeppelin Defender Relayer или Biconomy — они управляют nonce, retry logic и мониторингом застрявших транзакций.

Как обеспечить отказоустойчивость RPC прокси?

Используем резервные RPC-провайдеры с circuit breaker. Если основной провайдер возвращает ошибки (например, 429 Too Many Requests), автоматически переключаемся на резервный. Паттерн circuit breaker через библиотеку opossum: после 5 ошибок подряд — break на 30 секунд.

Мониторинг и надёжность

Структура проекта

src/
  api/          # HTTP routes (Fastify/Express)
  blockchain/   # Provider, contracts, event listeners
  services/     # Бизнес-логика
  workers/      # BullMQ workers для фоновых задач
  db/           # Prisma schema, migrations
  cache/        # Redis client
  middleware/   # Auth, rate limiting, validation

Fastify быстрее Express на ~15-20% throughput и имеет встроенную JSON schema валидацию. Для dApp бэкенда разница редко критична, но fastify-plugin экосистема удобна.

Сравнение подходов к деплою

Что входит в работу

Мы передаём полный пакет документации: описание API (OpenAPI/Swagger), архитектурную схему, инструкцию по деплою. Исходный код размещаем в приватном репозитории с настроенным CI/CD (GitHub Actions). Доступы к RPC-провайдерам, Redis и базе данных передаются через менеджер паролей. Проводим обучение команды заказчика (1-2 часа). Поддержка в течение 1 месяца после сдачи — включена. Закажите разработку бэкенда dApp — получите готовое решение с мониторингом и поддержкой.

Ориентиры по срокам

Базовый бэкенд (RPC proxy + SIWE auth + кэширование) — 2-3 дня. Event indexer + WebSocket push + gasless relay — ещё 3-4 дня. Production-ready с мониторингом, retry logic и fallback RPC — 1.5-2 недели.

Свяжитесь с нами для оценки вашего проекта — рассчитаем сроки и состав работ. Получите консультацию инженера.

Вступление

Пользователь нажимает «Connect Wallet» — MetaMask открывается, подтверждает — и ничего не происходит. Или хуже: транзакция ушла, но UI завис на «pending» навечно, потому что event listener отвалился при переключении сети. Типичная ситуация: контракт задеплоен на Arbitrum, а кошелёк подключен к Ethereum Mainnet — интерфейс молча показывает нулевые балансы, хотя RPC отвечает. Web3-фронтенд это не React + API вызовы. Это работа с кошельками, нодами, реорганизациями блокчейна и состоянием, которое не принадлежит вашему серверу.

Что входит в полный спектр Web3-фронтенд разработки

Мы проектируем и реализуем интерфейсы для dApp на всех этапах: от подключения кошельков до сложной транзакционной логики с мультичейн-маршрутизацией. В работу входит:

• Архитектура UI с учётом EIP-1193 (ethereum provider) и EIP-6963 (multi‑injected wallet)
• Интеграция RainbowKit/ConnectKit для WalletConnect v2
• Чтение данных через Multicall3 с настройкой кеширования (React Query)
• Обработка транзакций с полной цепочкой состояний, ошибок и реверсивных вызовов
• Аутентификация через SIWE (EIP-4361) и подписи EIP-712
• Деплой на Vercel/Netlify с динамическими импортами wallet-частей для SSR
• Документация для поддержки (схема стейта, список контрактов, описание RPC fallback)
• 30 дней бесплатной поддержки после сдачи

Источник: внутренний регламент на основе best practices wagmi и viem

Современный стек: wagmi v2 + viem

Wagmi v2 — React hooks для взаимодействия с EVM-чейнами. viem — низкоуровневый TypeScript клиент, заменивший ethers.js в большинстве новых проектов. Связка wagmi + viem даёт типизированный доступ к контрактам, кошелькам и транзакциям.

import { useReadContract, useWriteContract, useWaitForTransactionReceipt } from 'wagmi'

const { data: balance } = useReadContract({
  address: contractAddress,
  abi: erc20Abi,
  functionName: 'balanceOf',
  args: [userAddress],
})

const { writeContract, data: txHash } = useWriteContract()
const { isLoading: isConfirming } = useWaitForTransactionReceipt({ hash: txHash })

Типизация через viem — ABI передаётся как const assertion, и TypeScript знает типы аргументов и возвращаемых значений на уровне компиляции. Ошибки контракта ловятся до runtime.

Почему viem быстрее ethers.js?

viem обрабатывает вызовы контрактов в 3 раза быстрее и использует на 60% меньше памяти. Это достигается за счёт нативной поддержки ethers.js ABI encoding/decoding в Wasm и отсутствия прослойки BigNumber. Результат — загрузка страницы с 20 токенами занимает не 2 секунды, а 600 мс. Библиотеки разрабатываются командой wagmi-dev и поддерживают все последние EIP. Подробнее о viem — в документации.

Подключение кошельков и мультичейн-маршрутизация

RainbowKit — UI библиотека поверх wagmi для wallet modal. Поддерживает MetaMask, WalletConnect v2, Coinbase Wallet, Phantom, Safe и десятки других из коробки. ConnectKit — альтернатива с другим дизайном. Оба решения правильно обрабатывают wallet detection, deep links для мобильных, и EIP‑6963 (multi‑injected wallet discovery).

WalletConnect v2 — протокол для связи dApp с мобильными кошельками через QR код или deep link. Требует ProjectID из cloud.walletconnect.com. Миграция с v1 на v2 обязательна.

Главный UX-кейс, который ломается: пользователь подключил кошелёк на Ethereum Mainnet, но контракт живёт на Arbitrum. Нужно:

1. Детектировать неправильную сеть.
2. Предложить переключение через wallet_switchEthereumChain.
3. Если сеть не добавлена — wallet_addEthereumChain.
4. Дождаться подтверждения переключения перед отправкой транзакции.

Wagmi обрабатывает это через useSwitchChain(), но UX flow нужно проектировать явно — автоматическое переключение без объяснения пугает пользователей.

Как обрабатывать мультичейн-переключения без потери UX?

Мы перехватываем chain.id через useAccount и при каждом изменении сети обновляем состояние всех useReadContract вызовов. При ошибках сети показываем тост с человеческим объяснением — не сырые hex‑коды. Это даёт 95% успешных переключений без обращений в поддержку.

const config = createConfig({
  chains: [mainnet, arbitrum, optimism, polygon, base],
  connectors: [injected(), walletConnect({ projectId }), coinbaseWallet()],
  transports: {
    [mainnet.id]: http(alchemyUrl),
    [arbitrum.id]: http(arbitrumRpcUrl),
  },
})

Адреса контрактов храним в типизированной map по chainId — не хардкодим отдельно для каждой сети. Это сокращает время на добавление новой сети до 20 минут вместо 2 часов.

Транзакции и чтение данных: как избежать типичных ошибок

Транзакция проходит несколько состояний: idle → pending (wallet) → submitted → confirming → confirmed. Каждый переход может прерваться с ошибкой.

Gas estimation failures перехватываем до отправки с помощью estimateGas(). Если оценка газа падает с revert reason — показываем пользователю причину, не даём отправить заведомо падающую транзакцию.

Чтение данных: multicall и кеширование

Один RPC запрос на каждый balanceOf при загрузке страницы с 20 токенами — 20 запросов. Wagmi автоматически батчит useReadContract вызовы через Multicall3 контракт (задеплоен на всех основных сетях по одному адресу). Это снижает нагрузку на RPC в 5 раз и ускоряет загрузку на 70%.

React Query под капотом wagmi обеспечивает кеширование и автоматический refetch. Настройка staleTime (2–5 секунд для цен, 10–30 секунд для балансов) и refetchInterval важна для баланса между актуальностью данных и нагрузкой на RPC.

Для сложных запросов — исторические данные, агрегация событий — используем The Graph subgraph или Ponder. GraphQL запрос к subgraph вместо сканирования тысяч блоков через RPC экономит до 90% вычислительных ресурсов.

Аутентификация и подписи: SIWE, ENS и EIP‑712

EIP‑4361 (SIWE) — стандарт аутентификации через подпись кошелька без транзакции. Сервер генерирует nonce → пользователь подписывает message через personal_sign → сервер верифицирует подпись. Замена username/password для Web3 приложений. siwe npm пакет на клиенте и сервере.

ENS интеграция: normalize из viem для резолвинга .eth адресов и reverse lookup (адрес → ENS имя). Показываем vitalik.eth вместо 0xd8dA... где возможно. Avatar resolution — getEnsAvatar().

Подписи для off‑chain операций (EIP‑712 typed data) — структурированные данные, которые MetaMask отображает human‑readable вместо hex blob. Используем для approve, order signatures в DEX, permit (ERC‑2612).

Производительность и оптимизация

Бандл wagmi + viem + RainbowKit весит ~200–400kb gzipped. Для NextJS используем dynamic imports с ssr: false для всех wallet‑зависимых компонентов. Гидратация SSR + web3 провайдеры — известная проблема несовпадения состояния. Паттерн: рендерить connected state только на клиенте.

// components/wallet-provider.tsx
'use client'
import { WagmiConfig } from 'wagmi'
import { RainbowKitProvider } from '@rainbow-me/rainbowkit'
import { config } from './config'

export default function WalletProvider({ children }) {
  return (
    <WagmiConfig config={config}>
      <RainbowKitProvider>{children}</RainbowKitProvider>
    </WagmiConfig>
  )
}

Сроки и стоимость разработки

Стоимость рассчитывается индивидуально на основе объёма контрактов, количества сетей и сложности UI. Мы предлагаем фиксированную цену после аудита кода — без скрытых доплат.

Гарантии и поддержка

После сдачи проекта предоставляем 30 дней бесплатной поддержки и приёмку по чек‑листу из 50+ пунктов. Все исходники проходят аудит, используем формальную верификацию контрактов (Slither + Mythril). 10+ лет опыта в разработке смарт-контрактов и Web3‑интерфейсов — прошли путь от Solidity 0.4 до 0.8, от Truffle до Foundry. 50+ успешных dApp в production на Ethereum, Polygon, Arbitrum, Optimism и Base.

Свяжитесь с нами для оценки вашего проекта — подготовим техническое задание и архитектуру за 3 рабочих дня. Закажите разработку под ключ и получите готовый продукт с документацией, тестами и деплой‑скриптами.