High-Load NFT Minting Page Development for Ethereum & L2
A collection of 10,000 tokens, launch in 48 hours, 500 concurrent users — and half leave because of a sluggish page. We commonly see this mistake: the minting page is thrown together in an evening, just a "Mint" button, MetaMask connection, simple as that. At the moment of the drop, MetaMask can't keep up, transactions hang, the whitelist doesn't verify, and the progress bar shows 0 even after 200 NFTs are minted. This isn't a hype problem — it's a frontend architecture problem under load. Building a reliable minting page requires deep Web3 stack expertise. Our team, with 7+ years of experience and 30+ delivered projects totaling over 2000 ETH, knows how to do it.
Critical Components for a Minting Page
Wallet connection and chain management. Wagmi v2 + viem is the current standard for Web3 React applications. The useConnect, useAccount, and useNetwork hooks handle basic scenarios. A critical point is network verification and switching. If the user is connected to Ethereum but the mint is on Base, you need useSwitchChain with an automatic prompt. If they decline, show a blocking warning.
const { switchChain } = useSwitchChain() const { chain } = useAccount() if (chain?.id !== TARGET_CHAIN_ID) { return <SwitchNetworkPrompt onSwitch={() => switchChain({ chainId: TARGET_CHAIN_ID })} /> } Solving Whitelist Verification with Merkle Proofs
Two approaches: on-chain mapping and Merkle proof. On-chain mapping (mapping(address => bool) public whitelist) is expensive. Adding 5000 addresses to a whitelist costs 5000 transactions (up to 1 ETH on mainnet). Merkle proof is the standard for large whitelists. The root is stored on-chain (a single bytes32), and the proof for each address is provided off-chain during minting. Setup costs are 10 times cheaper — one transaction instead of thousands. The frontend receives the proof via API or stores it in a public JSON.
Verification on the frontend before sending the transaction:
import { MerkleTree } from 'merkletreejs' import { keccak256 } from 'viem' const proof = merkleTree.getHexProof(keccak256(address)) const isValid = merkleTree.verify(proof, keccak256(address), merkleRoot) Important: frontend verification is only for UX. The final check must be in the smart contract. Never trust frontend verification.
Comparison of Whitelist Methods
| Method | Setup cost | Gas per mint | Scalability |
|---|---|---|---|
| On-chain mapping | High (up to 1 ETH for 5000 addresses) | Medium | Limited by block gas limit |
| Merkle proof | Minimal (one transaction) | Low | Virtually unlimited |
Merkle proof cuts setup costs from $10,000 (on-chain) to $100 — a 99% savings. More details at Wikipedia.
Why a Real Progress Bar Requires WebSocket
The problem of stale data. totalSupply() changes with every minted NFT. Reading it via useReadContract with default polling results in data that is 1-3 blocks stale. During a hot drop, that means the progress bar is lying.
Solution: WebSocket subscription to the contract's Transfer events. useWatchContractEvent from wagmi updates data 50 times faster than polling and doesn't waste RPC requests.
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) } }) This provides real-time updates without polling.
Transaction States
When the user clicks "Mint", you need to show at least 4 states explicitly:
| State | Indicator | Action |
|---|---|---|
| Awaiting signature | Spinner + 'Sign the transaction' | Wait for confirmation |
| Transaction pending | Spinner + transaction hash on Etherscan | Show link |
| Confirmed | Green checkmark + NFT preview | Show NFT |
| Failed | Red cross + user-friendly error | Offer retry |
useWriteContract + useWaitForTransactionReceipt from wagmi cover all states via isPending, isLoading, isSuccess, isError. A common mistake: showing a spinner without a transaction hash. The user doesn't know if the transaction went through, closes the tab, and mints again. Always show the transaction hash as soon as it exists.
Handling Contract Errors
Revert messages from Solidity custom errors need to be decoded. viem does this automatically if the ABI includes error definitions. But you must never show technical messages like ERC721: transfer to non ERC721Receiver implementer to the user. Map errors to user-friendly text:
-
MaxSupplyReached→ "All NFTs have already been minted" -
NotWhitelisted→ "Your address is not whitelisted" -
MintingPaused→ "Minting is temporarily paused" -
InsufficientFunds→ "Insufficient funds"
Performance Optimization for High Load
At the time of a drop, hundreds of users simultaneously hit the RPC provider. Public RPCs (Infura free tier) have rate limits. The solution: use Alchemy or QuickNode with a paid plan, and cache static data (totalSupply, mintPrice, whitelistRoot) on your own backend with a TTL of 2-5 seconds. Serve Merkle proofs for the whitelist via a CDN (Cloudflare) — sub-50ms responses with no server load.
What Our Development Service Includes
- Documentation: architecture description, deployment guide, contract specifications.
- Access to the repository, testnet, and monitoring tools (Tenderly, Etherscan).
- Team training: 1-2 hour online session on managing the minting page.
- Post-launch support: 2 weeks of monitoring and bug fixes.
Work Process
- Development (3-4 days). Next.js + wagmi + viem. Components: wallet connector, mint button with all states, progress bar with WebSocket, whitelist checker.
- Contract integration (1 day). Connect ABI, test on testnet (Sepolia), verify edge cases: wrong network, not whitelisted, sold out, paused.
- Optimization (1 day). RPC caching, CDN for proofs, gas estimation before transaction.
Timeline Estimates
A standard minting page with whitelist and progress bar — 3-5 days. A complex one with mint phases (presale, public), multiple wallet types, and custom design — up to 2 weeks. Cost is determined after clarifying functional requirements and design.
Typical Mistakes to Avoid
- Not checking the user's network — minting on a different network will fail.
- Showing only a spinner without a transaction hash — the user doesn't know the status.
- Using polling for totalSupply — stale data, progress bar lies.
- Trusting frontend verification of whitelist — must verify in the contract.
- Not caching Merkle proofs — high load on backend with large whitelists.
- Not handling a second mint from the same wallet — need to check token ownership.
Get a consultation on your project — contact us. We'll assess complexity and timeline for free. Order development of a minting page with guaranteed stability under load of up to 1000 concurrent users.
Our team: 7+ years of experience, 30+ delivered projects with total volume over 2000 ETH. We guarantee stable operation and gas savings through Merkle proofs and caching.







