Merkle Tree whitelist для NFT — розробка під ключ

Колекція з 10 000 NFT з whitelist на 3 000 адрес. Зберігати whitelist в on-chain mapping — це 3 000 операцій SSTORE при заповненні, близько 0.5–0.8 ETH газу (≈$1,500–$2,500 USD за поточним курсом). Merkle Tree вирішує проблему: одна транзакція для кореня, 3–5k gas на верифікацію кожного мінта. Реальна економія — в 10+ разів порівняно з mapping. Правильна реалізація із захистом від double-leaf атаки та підтримкою multi-tier — завдання, яке ми вирішуємо вже понад 5 років для 30+ проєктів. OpenZeppelin MerkleProof забезпечує стандартну верифікацію. Замовте розробку під ключ — отримайте смарт-контракт, генератор proof-ів та frontend.

Побудова дерева Меркла для списку дозволених адрес

Листя дерева — keccak256 хеші адрес (іноді з додатковими даними: keccak256(abi.encodePacked(address, maxMintAmount))). Хеші сусідніх листів об'єднуються і хешуються від низу до верху. Корінь (root) — один bytes32, що зберігається в контракті. Алгоритм:

import { MerkleTree } from 'merkletreejs'
import { keccak256, encodePacked } from 'viem'

const leaves = whitelist.map(addr => 
  keccak256(encodePacked(['address'], [addr]))
)
const tree = new MerkleTree(leaves, keccak256, { sortPairs: true })
const root = tree.getHexRoot() // → bytes32 для контракту

sortPairs: true — критичний параметр. Він забезпечує детерміновану побудову дерева незалежно від порядку листів. Без нього один і той же список дає різні root-и при різному порядку адрес.

Верифікація в контракті

import "@openzeppelin/contracts/utils/cryptography/MerkleProof.sol";

bytes32 public merkleRoot;

function mint(uint256 amount, bytes32[] calldata proof) external payable {
    bytes32 leaf = keccak256(abi.encodePacked(msg.sender));
    require(MerkleProof.verify(proof, merkleRoot, leaf), "Invalid proof");
    // ... mint logic
}

MerkleProof.verify() з OpenZeppelin — стандартна реалізація з O(log n) складністю. Для 3 000 адрес — proof з 12 хешів (log2(3000) ≈ 12). Для 100 000 адрес — 17 хешів. Газові витрати верифікації зростають повільно.

Захист від double-leaf атаки та double-mint

Класична проблема Merkle Tree в смарт-контрактах: якщо leaf не унікальний — один proof може верифікувати декілька листів. Захист в OpenZeppelin MerkleProof 4.7+: бібліотека перевіряє, що leaf != internal_node. Додатковий захист: хешуйте лист двічі keccak256(keccak256(abi.encodePacked(addr))). Це робить співпадіння практично неможливим.

Розширений whitelist: тири та кількості

Простий список — тільки перевірка «адреса є / немає». Для багаторівневих whitelist (tier 1: 2 NFT, tier 2: 1 NFT) — включаємо дані в leaf:

bytes32 leaf = keccak256(abi.encodePacked(msg.sender, maxAmount));
require(MerkleProof.verify(proof, merkleRoot, leaf), "Invalid proof");
require(amount <= maxAmount, "Exceeds allocation");

Тепер proof верифікує не тільки адресу, але й максимальну кількість для цієї адреси. Одне дерево, один root, різні алокації.

Захист від повторного мінту

Merkle Proof тільки верифікує право мінтити — не запобігає повторному мінту. Потрібен окремий mapping використаних алокацій:

mapping(address => uint256) public mintedAmount;

function mint(uint256 amount, uint256 maxAmount, bytes32[] calldata proof) external {
    require(mintedAmount[msg.sender] + amount <= maxAmount, "Exceeds allocation");
    mintedAmount[msg.sender] += amount;
    // ...
}

mintedAmount займає SSTORE тільки при першому мінті користувача — це O(unique_minters) storage, а не O(whitelist_size).

Off-chain дистрибуція proof-ів

Три підходи до того, як користувач отримує свій proof.

Оновлення списку після деплою

Якщо контракт дозволяє зміну merkleRoot (через onlyOwner), то список можна оновити без передеплою. Будуємо нове дерево з доповненнями, оновлюємо root через setMerkleRoot(). Після зміни root старі proof-и перестають працювати. Необхідно повідомити користувачів.

Переваги Merkle Tree перед mapping

Порівняння газу для типового проєкту з 3000 адрес:

Merkle Tree кращий ніж mapping у 10+ разів при setup та в 1.5–2 рази при кожному mint. Для колекції на 10 000 токенів зі списком на 3 000 адрес економія газу на етапі заповнення становить 0.5–0.8 ETH.

Що входить в розробку whitelist під ключ

1. Аналіз вимог: тири, ліміти, стандарт ERC-721.
2. Розробка смарт-контракту з Merkle proof верифікацією (Solidity з OpenZeppelin).
3. Генерація дерева Меркла та proof-ів (Node.js, бібліотека merkletreejs).
4. Створення API або статичного JSON для дистрибуції proof-ів.
5. Frontend інтеграція (wagmi, RainbowKit).
6. Тестування (Foundry: unit-тести, перевірка коректних/некоректних proof, double-mint захист).
7. Документація.

Орієнтовні терміни та вартість

Базова реалізація — 2–3 дні. З тирами, API та frontend — до 5 днів. Вартість розраховується індивідуально після аналізу вашого проєкту. Зв'яжіться з нами для точної оцінки — ми підготуємо комерційну пропозицію.

Чому варто довірити розробку нам?

Ми гарантуємо безпеку та якість. Наш досвід у блокчейн-розробці (Ethereum, Polygon, Arbitrum, Solana) налічує понад 5 років. Ми реалізували більше 30 смарт-контрактів, включаючи NFT колекції з whitelist. Кожна реалізація проходить внутрішній code review та формальну верифікацію ключових функцій. Отримайте консультацію — наші інженери готові проаналізувати ваш проєкт і запропонувати оптимальне рішення.

Чому розробка NFT маркетплейсів потребує комплексного підходу?

Ми бачимо, що на перший погляд NFT-контракт виглядає просто: ERC-721, mint(), IPFS для метаданих, і все. На практиці саме в цій «простоті» ховається більшість проблем — від ботів, які скуповують весь mint у першому блоці, до зламаних роялті на вторинному ринку. Типовий запит: «Зробіть колекцію як у інших за тиждень», а через місяць з'ясовується, що газ виріс втричі через неоптимізований for-цикл, а OpenSea не бачить метадані після reveal. Ми знаємо кожні з цих граблів і будуємо процеси так, щоб їх уникнути.

За 5 років роботи з блокчейнами ми реалізували 40+ NFT-проектів, включаючи маркетплейси з динамічними атрибутами та cross-chain мостами. Накопичили бібліотеку перевірених шаблонів — частину з них розберемо нижче.

Який стандарт вибрати: ERC-721 чи ERC-1155?

ERC-721 — кожен токен унікальний, один owner. Підходить для колекцій, де кожен NFT має індивідуальні атрибути та пряму прив'язку owner → tokenId.
ERC-1155 — multi-token стандарт: один контракт зберігає і fungible, і non-fungible токени. Використовує balanceOf(address, tokenId) замість ownerOf(tokenId). Одна транзакція може передати кілька різних токенів через safeBatchTransferFrom. Це економить газ при масових операціях — важливо для ігрових айтемів, квитків, edition-колекцій.

Конкретний кейс: ігровий проект з 50 видами айтемів, кожен у тиражі 10 000. ERC-721 — 500 000 унікальних токенів, величезний overhead на маппінги. ERC-1155 — 50 tokenId, balanceOf на кожного гравця. Газ на transfer нижче в 2–3 рази, деплой контракту дешевший. Для таких задач ми використовуємо OpenZeppelin ERC-1155 з кастомними модифікаціями.

Метадані: on-chain vs IPFS vs centralized

Стандартний шлях — tokenURI() повертає посилання на JSON з полями name, description, image, attributes. Три варіанти зберігання:

• Centralized server — найдешевший і гнучкий. Ризик: сервер падає, компанія закривається — NFT втрачає метадані. Не підходить для колекцій з претензією на довгострокову цінність.
• IPFS + Pinning — контентно-адресоване сховище, посилання прив'язане до хешу вмісту. Pinata або NFT.Storage забезпечують pіннінг. Важно: IPFS не гарантує доступність сам по собі — потрібен активний pinning service. Якщо він закриється, дані можуть зникнути, якщо ніхто не зберігає копію.
• On-chain metadata — base64-encoded SVG або JSON прямо в tokenURI. Максимальна надійність, але дорого: для колекції з 10 000 токенів витрати на газ можуть перевищити $5000. Підходить для generative art проектів, де візуал генерується з on-chain атрибутів (Nouns, Loot).

Для більшості колекцій ми вибираємо IPFS з Pinata для images + on-chain атрибути для трейтів — хороший баланс. Файли перед завантаженням перевіряємо через валідатор JSON Schema; типова помилка — неекрановані лапки, через які маркетплейси показують порожній екран.

Dynamic NFT: метадані, які змінюються

Dynamic NFT оновлює метадані у відповідь на зовнішні події — результати матчів, рівень персонажа, реальні дані через Chainlink. Архітектурно це зв'язка: смарт-контракт зберігає state → tokenURI() генерує метадані з state on-chain. Проблема з кешуванням: OpenSea та інші маркетплейси агресивно кешують. Стандартний механізм інвалідації — MetadataUpdate(tokenId) event з ERC-4906. OpenSea слухає цей event і скидає кеш. Без нього оновлені метадані можуть не відображатися тижнями.

Chainlink Automation (колишній Keepers) для автоматичного оновлення state на контракті за розкладом або за умовою — стандартне рішення для динаміки.

Як захистити mint від ботів?

Allowlist через merkle tree — стандарт. Список адрес хешується в merkle root, зберігається в контракті. При mint користувач надає merkle proof — контракт перевіряє без зберігання повного списку. Використовуємо OpenZeppelin MerkleProof library.

Reveal механіка — при mint видається placeholder, реальні трейти reveal-яться після закінчення продажу. Інакше боти можуть сканувати pending транзакції і снайперити рідкісні трейти через frontrunning. Але reveal вимагає commitment scheme — випадковий seed має бути зафіксований до mint або використовувати Chainlink VRF.

Chainlink VRF для чесної рандомізації трейтів. VRF request в момент mint → callback з verifiable random number → assign traits. Це додає ~2 транзакції та latency, але гарантує чесність. Посилання на Chainlink VRF v2.5.

Rate limiting — require(mintedPerWallet[msg.sender] < maxPerWallet). Не захищає від мульти-гаманців, але піднімає вартість атаки. Для преміум-проектів часто додаємо proof-of-work прямо в контракт (через EIP-2612 signatures).

Royalties: реальний стан ринку

ERC-2981 — on-chain стандарт роялті. Контракт повертає (recipient, amount) для будь-якої sale price через royaltyInfo(tokenId, salePrice). Маркетплейси опитують це при кожному продажу. Проблема: дотримання роялті — добровільне рішення маркетплейсу. Blur запустився з нульовими роялті, що викликало хвилю інших платформ. Зараз ситуація частково стабілізувалася: OpenSea підтримує ERC-2981, Blur додав опціональні.

Спроби enforce роялті on-chain через обмеження transfers тільки на approved маркетплейси (operator filtering) OpenSea пропонував через OperatorFilterRegistry. Це ламає composability — не можна передати NFT через кастомний контракт. Більшість серйозних проектів відмовилися від цього підходу. Для проектів, де роялті критичні, ми будуємо кастомний маркетплейс всередині екосистеми + incentive structure для користувачів торгувати саме там.

Lazy minting та gas-free mint

Gas-free mint через підпис: творець підписує voucher (tokenId, tokenURI, price, signature), покупець надає voucher в mint() — контракт верифікує підпис через ECDSA.recover() і минтить. Працює на OpenSea через їх Seaport протокол. Seaport — оптимізований контракт з мінімальним gas usage. Розуміння його механіки важливе при інтеграції custom marketplace логіки.

Стек для NFT-проектів

• Контракти: Solidity 0.8.x, OpenZeppelin ERC721Enumerable або ERC721A (Azuki) для gas-оптимізованого batch mint, ERC1155 від OpenZeppelin
• VRF та автоматизація: Chainlink VRF v2.5, Chainlink Automation
• Зберігання: Pinata (IPFS pinning), NFT.Storage, Arweave для постійного зберігання
• Маркетплейс: OpenSea Seaport protocol, кастомна інтеграція
• Фронтенд: wagmi v2 + viem, RainbowKit для wallet connection, React + TypeScript

Процес розробки

1. Проектування mint-механіки — allowlist, public sale, price curve (Dutch auction або фіксована), limits per wallet
2. Контракти — з Foundry fuzz-тестами на mint limits, merkle proof-верифікацію, royalty calculations
3. IPFS деплой — завантаження метаданих та images до reveal, піннінг на мінімум двох сервісах
4. Reveal — якщо використовується Chainlink VRF, тест на testnet обов'язковий: VRF subscription має бути funded LINK токенами
5. Маркетплейс-інтеграція — верифікація колекції на OpenSea, налаштування роялті, тест MetadataUpdate events
6. Деплой та моніторинг — Tenderly для відлову reentrancy, Etherscan API для верифікації контракту, налаштування оповіщень за подіями

Що входить в роботу (deliverables)

• Вихідний код смарт-контрактів (Solidity, Rust для Solana) з коментарями
• Тест-сьют (Foundry/Hardhat) з покриттям ≥90%
• Документація розгортання та інструкції з інтеграції
• Доступи до pinning-сервісів (Pinata/Pinfluence)
• Скрипти для генерації метаданих (Python/JS)
• Підтримка при верифікації на маркетплейсах
• 30 днів технічної підтримки після деплою

Строки

Вартість розраховується індивідуально після аудиту вашого завдання. Надішліть brief з описом проекту — оцінимо прозоро протягом 3 робочих днів. Для постійних клієнтів діє гнучка система знижок на пакетні замовлення. Зв'яжіться з нами для детального обговорення вашого NFT-проекту. Отримайте консультацію з архітектури маркетплейсу — залиште заявку, і ми оцінимо проект за три дні.