Разработка NFT-минтинг страницы
Коллекция из 10 000 токенов, запуск через 48 часов, 500 человек одновременно — и половина уходит из-за тормозящей страницы. Мы часто видим такую ошибку: минтинг-страница написана за вечер, кнопка «Mint», MetaMask подключение, всё просто. В момент дропа MetaMask не успевает, транзакции зависают, whitelist не верифицируется, прогресс-бар показывает 0 даже после 200 заминченных NFT. Это не проблема хайпа — это проблема frontend-архитектуры под нагрузку. Разработка надёжной минтинг-страницы требует глубокого понимания Web3-стека. Команда с 7+ летним опытом и 30+ реализованными проектами (объёмом более 2000 ETH) знает, как это сделать.
Какие компоненты критичны для минтинг-страницы?
Подключение кошелька и chain management. Wagmi v2 + viem — текущий стандарт для Web3 React приложений. useConnect, useAccount, useNetwork хуки покрывают базовые сценарии. Критический момент — проверка и переключение сети. Если пользователь подключён к Ethereum, а минтинг на Base, нужен useSwitchChain с автоматическим запросом. Если отказал — показываем блокирующее предупреждение.
const { switchChain } = useSwitchChain() const { chain } = useAccount() if (chain?.id !== TARGET_CHAIN_ID) { return <SwitchNetworkPrompt onSwitch={() => switchChain({ chainId: TARGET_CHAIN_ID })} /> } Как мы решаем проблему верификации whitelist?
Два подхода: on-chain mapping и Merkle proof. On-chain mapping (mapping(address => bool) public whitelist) — дорого. Добавить 5000 адресов в whitelist = 5000 транзакций (до 1 ETH на mainnet). Merkle proof — стандарт для крупных whitelist. Root хранится on-chain (один bytes32), доказательство для каждого адреса — off-chain, передаётся при минтинге. Настройка start стоит в 10 раз дешевле — одна транзакция вместо тысяч. Frontend получает proof через API или хранит в публичном JSON.
Верификация на frontend до отправки транзакции:
import { MerkleTree } from 'merkletreejs' import { keccak256 } from 'viem' const proof = merkleTree.getHexProof(keccak256(address)) const isValid = merkleTree.verify(proof, keccak256(address), merkleRoot) Важно: верификация на frontend — только для UX. Финальная проверка — в смарт-контракте. Никогда не доверяй frontend-верификации.
Сравнение методов whitelist
| Метод | Стоимость setup | Gas при минтинге | Масштабируемость |
|---|---|---|---|
| On-chain mapping | Высокая (до 1 ETH на 5000 адресов) | Средняя | Ограничена block gas limit |
| Merkle proof | Минимальная (одна транзакция) | Низкая | Практически неограниченна |
Merkle proof снижает затраты на setup с $10,000 (on-chain) до $100 — экономия 99%. Подробнее в Wikipedia.
Почему реальный прогресс-бар требует WebSocket?
Проблема stale data. totalSupply() меняется с каждым заминченным NFT. Если читать через useReadContract с дефолтным polling — данные устаревшие на 1-3 блока. На горячем дропе это значит прогресс-бар врёт.
Решение: WebSocket подписка на Transfer события контракта. useWatchContractEvent из wagmi обновляет данные в 50 раз быстрее, чем polling, и не тратит лишние RPC-запросы.
useWatchContractEvent({ address: CONTRACT_ADDRESS, abi: NFT_ABI, eventName: 'Transfer', onLogs: (logs) => { const mints = logs.filter(log => log.args.from === zeroAddress) setMintedCount(prev => prev + mints.length) } }) Это даёт realtime обновление без polling.
Состояния транзакции
Пользователь нажал «Mint» — нужно показать минимум 4 состояния явно:
| Состояние | Индикатор | Действие |
|---|---|---|
| Awaiting signature | Spinner + 'Подпишите транзакцию' | Ожидание подтверждения |
| Transaction pending | Spinner + transaction hash на Etherscan | Показать ссылку |
| Confirmed | Зелёный чек + NFT preview | Показать NFT |
| Failed | Красный крест + user-friendly ошибка | Предложить retry |
useWriteContract + useWaitForTransactionReceipt из wagmi покрывают все состояния через isPending, isLoading, isSuccess, isError. Типичная ошибка: показывать spinner без transaction hash. Пользователь не знает, прошла ли транзакция, закрывает вкладку и минтит снова. Всегда показывай transaction hash как только он есть.
Обработка ошибок из контракта
Revert messages из Solidity custom errors нужно декодировать. viem делает это автоматически если в ABI есть error definitions. Но пользователю нельзя показывать техническое сообщение вроде ERC721: transfer to non ERC721Receiver implementer. Маппинг ошибок в user-friendly текст:
-
MaxSupplyReached→ «Все NFT уже заминчены» -
NotWhitelisted→ «Ваш адрес не в whitelist» -
MintingPaused→ «Минтинг временно приостановлен» -
InsufficientFunds→ «Недостаточно средств»
Производительность под нагрузку
В момент дропа сотни пользователей одновременно обращаются к RPC-провайдеру. Публичные RPC (Infura free tier) имеют rate limits. Решение: Alchemy или QuickNode с платным планом + кеширование статических данных (totalSupply, mintPrice, whitelistRoot) в собственном backend с TTL 2-5 секунд. Merkle proof-ы для whitelist отдаём через CDN (Cloudflare) — sub-50ms ответ без нагрузки на сервер.
Что входит в разработку
- Документация: описание архитектуры, инструкция по деплою, спецификация контрактов.
- Доступы к репозиторию, тестовой сети и инструментам мониторинга (Tenderly, Etherscan).
- Обучение команды: 1-2 часа онлайн-сессия по управлению минтинг-страницей.
- Поддержка после запуска: 2 недели мониторинга и исправления ошибок.
Процесс разработки
- Разработка (3-4 дня). Next.js + wagmi + viem. Компоненты: wallet connector, mint button со всеми состояниями, progress bar с WebSocket, whitelist checker.
- Интеграция с контрактом (1 день). ABI подключение, тестирование на testnet (Sepolia), проверка edge cases: wrong network, not whitelisted, sold out, paused.
- Оптимизация (1 день). RPC кеширование, CDN для proof-ов, gas estimate перед транзакцией.
Ориентиры по срокам
Стандартная минтинг-страница с whitelist и прогресс-баром — 3-5 дней. Сложная с фазами минтинга (presale, public), multiple wallet types и кастомным дизайном — до 2 недель. Стоимость рассчитывается после уточнения функциональных требований и дизайна.
Типичные ошибки при разработке минтинг-страницы
- Не проверять сеть пользователя – минтинг в другой сети провалится.
- Показывать только spinner без transaction hash – пользователь не знает статус.
- Использовать polling для totalSupply – данные stale, прогресс-бар врет.
- Доверять frontend-верификации whitelist – нужно проверять в контракте.
- Не кешировать Merkle proof – нагрузка на backend при большом whitelist.
- Не обрабатывать добавление второго минтинга с тем же кошельком – нужно проверять владение токеном.
Получите консультацию по вашему проекту — свяжитесь с нами. Мы оценим сложность и сроки бесплатно. Закажите разработку минтинг-страницы с гарантией стабильности под нагрузкой до 1000 одновременных пользователей.
Наша команда: 7+ лет опыта, 30+ реализованных проектов с общим объёмом более 2000 ETH. Гарантируем стабильную работу и экономию на gas за счёт Merkle proof и кеширования.







