Розробка Discord-бота керування whitelist для NFT-колекцій

Стандартний Discord-бот для whitelist приймає будь-який гаманець, а Sybil-атаки викуповують до 30% слотів, руйнуючи екосистему. На одному з проєктів ми зіткнулися з ситуацією: за годину після відкриття реєстрації бот отримав понад 5000 заявок, з яких 80% були з підозрілих акаунтів — без історії, з нульовим балансом. Це коштувало проєкту десятків тисяч доларів упущеного мінту. Ми спроєктували систему, яка об'єднує дедуплікацію, on-chain верифікацію та генерацію Merkle Tree, скорочуючи підготовку WL з тижня до 3 днів. Результати: 99% фейкових акаунтів відсіюються, реальні холдери отримують пріоритет. Зв'яжіться з нами для обговорення вашого проєкту.

Як захистити whitelist від Sybil-атак?

Проблема Sybil та її рішення — розробка discord бота

Базовий бот просто записує адресу гаманця — жодного захисту від кількох акаунтів однієї людини. На великі колекції приходять сотні ботів-акаунтів з купленою історією в Discord.

• One wallet per Discord account — мінімальний рівень: якщо гаманець вже зареєстрований іншим Discord ID — відхилити. Не захищає від власника кількох Discord-акаунтів.
• Guild membership requirements — для реєстрації потрібно бути на сервері N днів, мати X повідомлень, мати певну роль. Це піднімає вартість атаки: купити прокачаний Discord-акаунт дорожче, ніж створити новий. Наприклад, вимоги "акаунт старше 7 днів і 50 повідомлень" відсіюють до 60% ботів.
• On-chain activity check — найнадійніший фільтр. Бот перевіряє через Alchemy/Etherscan API: чи є у гаманця історія транзакцій, NFT з конкретних колекцій (OG holder), POAPs, мінімальний баланс. Така верифікація в 3 рази ефективніша за базову дедуплікацію — це не лише анти-Sybil, але й target marketing: WL для реальних колекціонерів, а не для фліперів.

За даними нашого досвіду, on-chain верифікація скорочує кількість фейкових реєстрацій на 99%.

Ethereum address validation

Поширена помилка: бот приймає будь-який рядок, схожий на адресу, без checksum-перевірки. Користувач вводить адресу в нижньому регістрі — це валідний Ethereum адреса. Але при генерації Merkle Tree для контракту потрібна нормалізація: всі адреси через ethers.utils.getAddress() або viem.getAddress() для EIP-55 checksum. Невідповідність регістру в Merkle Tree призведе до того, що користувач не зможе замінтити навіть з правильною адресою.

Перевірка: ethers.isAddress(input) перед записом + нормалізація через ethers.getAddress(input).

Порівняння методів захисту

Як налаштувати багаторівневий захист: покрокове керівництво

1. Дедуплікація за двома зв'язками — база зберігає пари discord_id ↔ wallet, виключаючи повторні реєстрації. Налаштування займає 30 хвилин.
2. Фільтрація за guild-вимогами — задайте вік акаунту (>7 днів), мінімальну кількість повідомлень (50+) або роль. Збільшує вартість атаки в 5 разів.
3. On-chain верифікація — через Alchemy перевіряємо баланс (>0.01 ETH), історію (>10 tx) або наявність NFT з white list. Виявляє до 99% ботів.
4. Генерація Merkle Tree — після закриття реєстрації бот збирає всі валідні адреси, нормалізує (EIP-55) та будує дерево. Корінь надсилається в контракт, proof — користувачам.

Функціональність бота

Реєстрація гаманця. /wallet 0x... — користувач вводить адресу. Бот валідує, перевіряє дублікати (обидва напрямки: Discord ID → wallet та wallet → Discord ID), зберігає в базу даних.

Ролі та привілеї. Окремі ролі для різних категорій WL: OG (пріоритетний мінт, більше місць), WL (стандартний), Public. Бот автоматично призначає роль після перевірки on-chain критеріїв.

Керування листом. Admin-команди: /wl-export — вивантаження CSV, /wl-stats — кількість за категоріями, /wl-remove @user — видалення з листа, /wl-check 0x... — перевірка адреси.

Генерація Merkle Tree. За запитом або автоматично перед деплоєм — бот генерує Merkle Tree з накопичених адрес і видає root для контракту. Proof для кожної адреси — через API або в особистому повідомленні.

Чому варто довірити розробку професіоналам?

Наш досвід у сфері блокчейн-інструментів перевищує 5 років. Ми реалізували понад 30 проєктів для NFT-колекцій та DeFi-протоколів. Це не перша наша робота — ми знаємо типові помилки (відсутність checksum-нормалізації, витік даних через логи, неправильний розрахунок газу) та гарантуємо їх відсутність. On-chain верифікація знижує витрати на модерацію до 70% — замовте розробку для вашого проєкту. Отримайте консультацію з налаштування бота для вашої колекції.

Технічний стек

discord.js v14 — основна бібліотека. Slash commands замість prefix команд (сучасний стандарт Discord). Interaction handling з ephemeral responses для команд з особистими даними.

База даних — PostgreSQL (для production) або SQLite (для невеликих колекцій). Зберігання: discord_id, wallet_address, registered_at, wl_tier, on_chain_checks_passed.

ethers.js v6 — валідація адрес, генерація Merkle Tree через merkletreejs + keccak256.

Деплой — Railway або VPS з PM2. Для надійності — webhook-based deployment замість long-polling.

Порівняння етапів розробки

Вартість розраховується індивідуально після аналізу вимог — отримайте консультацію з налаштування.

Що входить в роботу

• Повний код бота з відкритою документацією
• Розгортання на хостингу (Railway / VPS)
• Налаштування on-chain перевірок через Alchemy / Tenderly
• Генерація Merkle Tree та його інтеграція зі смарт-контрактом
• Навчання адміністраторів (до 2 годин)
• Підтримка 30 днів після здачі

Чому розробка 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-проекту. Отримайте консультацію з архітектури маркетплейсу — залиште заявку, і ми оцінимо проект за три дні.