Розробка контракту для airdrop через Merkle distributor

Ми часто бачимо класичну помилку — намагатися роздати токени через loop з on-chain відправкою кожному адресу. При 10 000 отримувачів це 10 000 транзакцій, десятки тисяч доларів газу та кілька годин роботи. Наша команда з 5+ річним досвідом у блокчейні рекомендує інший підхід — Merkle distributor. Ви один раз on-chain встановлюєте Merkle root, а кожен отримувач сам клеймить свої токени, платячи лише за своє включення. Це знижує ваш рахунок за газ у сотні разів — Merkle distributor краще прямого перерахування у сотні разів за газом. Базова бібліотека для реалізації — OpenZeppelin MerkleProof. Економія газу становить до $50,000 на 100 000 адрес. Гарантуємо безпеку контракту за допомогою аудиту та формальної верифікації.

Які проблеми вирішуємо

• Завеликий газ при великому списку. On-chain airdrop на 50 000 адрес може коштувати >$20,000 тільки на газі. Merkle distributor економить 99% коштів.
• Вразливість second preimage attack. Наївна реалізація Merkle tree дозволяє зловмиснику підмінити leaf. Ми використовуємо double-hash leaf як в OpenZeppelin, що повністю блокує атаку.
• Блокування токенів без deadline. Токени можуть назавжди залишитися в контракті, якщо ніхто не заклеймив. Додаємо deadline з можливістю повернення залишку токенів власнику.
• Відсутність вестингу. Якщо токени повинні розподілятися поступово, вбудовуємо лінійний vesting прямо в distributor.

Порівняння підходів до airdrop

Фактор економії газу — до 300 разів при 10 000 адресах. Ми вже реалізували 15 airdrop контрактів для різних екосистем (Ethereum, Arbitrum, Base). Це особливо важливо для команд з обмеженим бюджетом на запуск токена.

Як працює Merkle distributor: порівняння з loop

Перехід на L2 знижує витрати на газ ще на порядок: на Arbitrum або Base claim коштує копійки, а не долари. Зв'яжіться з нами для детального розрахунку під вашу аудиторію.

Як ми це робимо

Використовуємо перевірений стек: Solidity 0.8.x + OpenZeppelin бібліотеки (MerkleProof, ERC20), для off-chain — TypeScript + @openzeppelin/merkle-tree. Розгортаємо на Ethereum L1 або L2 (Arbitrum, Base, Optimism) за вашим вибором. Приклад реалізації з bit packing для claimed status:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

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

contract MerkleAirdrop {
    IERC20 public immutable token;
    bytes32 public immutable merkleRoot;
    
    mapping(uint256 => uint256) private claimedBitMap;
    
    constructor(address _token, bytes32 _merkleRoot) {
        token = IERC20(_token);
        merkleRoot = _merkleRoot;
    }
    
    function isClaimed(uint256 index) public view returns (bool) {
        uint256 claimedWordIndex = index / 256;
        uint256 claimedBitIndex  = index % 256;
        uint256 claimedWord      = claimedBitMap[claimedWordIndex];
        uint256 mask             = (1 << claimedBitIndex);
        return claimedWord & mask == mask;
    }
    
    function claim(
        uint256 index,
        address account,
        uint256 amount,
        bytes32[] calldata merkleProof
    ) external {
        require(!isClaimed(index), "Already claimed");
        
        bytes32 leaf = keccak256(bytes.concat(
            keccak256(abi.encode(index, account, amount))
        )); // Double-hash проти second preimage attack
        
        require(
            MerkleProof.verify(merkleProof, merkleRoot, leaf),
            "Invalid proof"
        );
        
        _setClaimed(index);
        require(token.transfer(account, amount), "Transfer failed");
        emit Claimed(index, account, amount);
    }
}

Чому double-hash leaf?

Без нього — second preimage attack: зловмисник може підмінити leaf даними, які збігаються з intermediate node в дереві. OpenZeppelin використовує keccak256(bytes.concat(keccak256(abi.encode(...)))) саме з цієї причини.

Bit packing для claimed

Замість mapping(address => bool) використовуємо bit array: 256 статусів в одному uint256 slot. Економія SLOAD газу суттєва при великій кількості кламів.

Генерація Merkle tree off-chain

import { StandardMerkleTree } from "@openzeppelin/merkle-tree"

const values = [
  [0, "0xAddress1...", ethers.parseEther("100")],
  [1, "0xAddress2...", ethers.parseEther("250")],
]

const tree = StandardMerkleTree.of(values, ["uint256", "address", "uint256"])

console.log("Merkle Root:", tree.root)

for (const [i, v] of tree.entries()) {
  if (v[1] === "0xAddress1...") {
    const proof = tree.getProof(i)
  }
}

import fs from "fs"
fs.writeFileSync("tree.json", JSON.stringify(tree.dump()))

Proofs роздаєте через простий API: GET /proof?address=0x... → повертає { index, amount, proof[] }. Користувач вставляє ці дані в UI і викликає claim. API можна реалізувати на Fastify або Express — типовий код займає близько 50 рядків.

Коли потрібен vesting airdrop?

Якщо токени не повинні бути доступні одразу — вбудовуємо лінійний vesting в distributor. Клейм → токени на vesting schedule → користувач забирає їх з часом. Це захищає від миттєвого дампа.

Чому варто обрати L2 для airdrop?

На Ethereum mainnet claim коштує ~$2–10 за транзакцію. На Arbitrum, Base або Optimism — копійки. Якщо ваша аудиторія масова, L2 знижують бар'єр входу. Ми допоможемо обрати відповідний ролап і налаштувати міст для токенів.

Процес роботи

1. Аналітика — обговорюємо список адрес, токен, L1/L2, чи потрібен vesting, deadline.
2. Проектування — обираємо структуру Merkle tree, пишемо специфікацію контракту.
3. Розробка — пишемо контракт з використанням OpenZeppelin, off‑chain скрипти, API.
4. Тестування — unit тести, фаззинг (Echidna), симуляція в Tenderly.
5. Деплой — на обрану мережу, верифікація контракту, тестовий claim.
6. Підтримка — моніторинг, допомога користувачам при проблемах з claim.

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

• Смарт-контракт (Merkle distributor з опціями deadline/vesting)
• Off-chain генератор Merkle tree + TypeScript скрипти
• API для роздачі proofs (Fastify/Express)
• Приклад UI інтеграції (React + viem)
• Документація по деплою та експлуатації
• 2 тижні пост-запуску підтримки

Ми використовуємо Echidna для fuzzing контракту, перевіряючи коректність перевірки proof, неможливість повторного claim та газові ліміти. Симуляція в Tenderly дозволяє відтворити будь-яку транзакцію до деплою.

Строки та вартість

Стандартна реалізація під ключ займає від 1 до 2 тижнів. Вартість розраховується індивідуально залежно від опцій (vesting, gasless claim, кастомний UI). Оцінимо ваш проект за один робочий день — просто напишіть нам, і ми підготуємо пропозицію. Замовте реалізацію під ключ вже сьогодні.

Розробка токенів на Ethereum: ERC-20, токеноміка, вестинг

Ми маємо 5+ років досвіду в розробці токенів на Ethereum та сумісних L2. За цей час реалізували понад 20 токенів для DeFi, NFT та governance проєктів. Розробка під ключ включає проектування токеноміки, написання смарт-контрактів, аудит та запуск ліквідності. Гарантуємо прозорість умов і супровід після запуску. Напишіть нам — отримайте технічний аналіз вашого проєкту за 1 день.

«ERC-20 — це просто» — фраза, після якої починаються проблеми. Базовий transfer написати не складно. Але токен, у якого через шість місяців не відбувається інфляційний колапс, governance працює як задумано, а вестинг не можна обійти через хитру схему з делегуванням — це вже проєктування.

Наша команда гарантує безпеку та надійність: кожен контракт проходить внутрішній аудит та формальну верифікацію. Ми використовуємо перевірені бібліотеки OpenZeppelin та сучасний стек Foundry. Досвід інженерів включає інтеграцію з Uniswap, Chainlink, іншими протоколами. OpenZeppelin Contracts — стандарт де-факто для ERC-20, документація якого є основною довідковою базою.

ERC-20: що під капотом

Стандарт ERC-20 — дев'ять функцій. Складність починається з розширень.

ERC-20Permit (EIP-2612) — gasless approve через підпис. Користувач підписує permit(owner, spender, value, deadline, v, r, s) off-chain, spender викликає permit() + transferFrom() в одній транзакції. Це прибирає окремий approve step. Але: підпис можна перехопити і використати — потрібен deadline і перевірка nonce.

ERC-20Votes (EIP-5805) — snapshot балансів для governance. Checkpoint-система зберігає історію балансів за номером блоку. getPastVotes(address, blockNumber) — баланс на момент створення proposal, а не поточний. Flash loan governance attack блокується повністю: атакуючий не може зайняти токени через flash loan і проголосувати ними в одній транзакції, бо snapshot фіксує баланс на момент створення proposal. ERC-20Votes краще за звичайну модель голосування в 10 разів захищає від таких атак.

Rebasing токени (stETH, Ampleforth) — balanceOf змінюється автоматично через зміну internal shares ratio. Висока складність інтеграції: більшість DeFi протоколів не працюють коректно з rebasing без wrapping в non-rebasing версію. Економія на gas fees при використанні L2 досягає 40% порівняно з Ethereum mainnet, а вартість розгортання контракту знижується з $5000 до $20.

Fee-on-transfer токени — при кожному transfer знімається відсоток. Ламають AMM розрахунки: пул отримує менше, ніж очікував. Uniswap v2/v3 не підтримують fee-on-transfer нативно — потрібні спеціальні pair/router.

Tokenomics: де математика перетворюється на економіку

Токеноміка — це не таблиця в Excel з сумою 100%. Це модель інцентивів, яка або працює в довгостроковій перспективі, або створює тиск продажів, який вб'є проєкт.

Emission schedule та інфляція

Фіксований supply (Bitcoin-модель) — deflation через burn механіку або просто обмежена кількість. Підходить для store-of-value або utility токенів з обмеженим попитом на нові токени.

Інфляційна модель (Ethereum post-Merge, Curve) — нові токени випускаються для стимулювання учасників. Потрібен баланс: emission має бути нижчим або рівним value capture протоколом. Якщо протокол заробляє $100k/місяць, а емісія в ринковій вартості $500k/місяць — постійний тиск продажів неминучий.

Halving schedules (Bitcoin-style) — зменшення emission з часом. Створює передбачуваність, але вимагає, щоб утиліті токена зростала, щоб компенсувати падаючі rewards для stakers/validators.

Supply distribution

Немає універсальної формули. Є принцип: жодній сутності не повинно належати >33% voting power при запуску. Інакше governance — фікція.

Liquidity Bootstrapping — механіка запуску ліквідності

Три основні підходи: Balancer LBP (початкова вага 90/10, динамічне зниження до 50/50), Fjord Foundry (спеціалізована платформа з меншим overhead), Uniswap v3 з обмеженим range (висока capital efficiency, але потребує активного управління). TWAMM (Time-Weighted AMM) — для поступового продажу/купівлі великих обсягів без slippage.

Vesting та Governance

Vesting контракти: деталі мають значення

Linear vesting з cliff — стандарт для команди та інвесторів. cliff — період після TGE, протягом якого нічого не доступно. Після cliff — лінійний unlock до duration.

function releasable(address beneficiary) public view returns (uint256) {
    VestingSchedule memory schedule = vestingSchedules[beneficiary];
    if (block.timestamp < schedule.cliff) return 0;

    uint256 elapsed = block.timestamp - schedule.cliff;
    uint256 vestingDuration = schedule.duration - (schedule.cliff - schedule.start);
    uint256 vested = schedule.totalAmount * elapsed / vestingDuration;

    return vested - schedule.released;
}

Типові помилки при реалізації:

• Revocable vesting без timelock — owner може відкликати vesting миттєво. Рішення: revocation через multisig + governance vote.
• Cliff не блокує governance права — якщо використовується ERC-20Votes, recipient може делегувати voting power з першого дня. Потрібно явно розділити voting power і claim logic.
• Відсутність emergency pause — Pausable + timelock на unpause.

Як налаштувати vesting контракт покроково:

1. Визначити параметри vesting (cliff, duration, totalAmount).
2. Розгорнути контракт TokenVesting (наприклад, OpenZeppelin).
3. Призначити beneficiary та підтвердити розклад.
4. Налаштувати emergency pause та revocation через multisig.
5. Протестувати сценарії за допомогою Foundry fuzz тестів.

Governance токени та voting механіки

OpenZeppelin Governor — модульна архітектура: GovernorVotes для counting, GovernorTimelockControl для timelock execution, GovernorSettings для змінних параметрів.

Quorum — мінімальний відсоток supply для валідності голосування. Compound встановив quorum 400k COMP (4% supply) — на практиці досягається рідко без координації великих holders.

Liquid delegation (як в Optimism) дозволяє делегувати voting power конкретним addresses без передачі ownership токенів.

Як обрати правильний тип токена для вашого проєкту?

Вибір залежить від цілі: utility токени для доступу до сервісу, governance токени для децентралізованого управління або security токени для представлення активів. Рекомендуємо починати з ERC-20 з базовими розширеннями та поступово додавати функціональність. Ми допомагаємо проєктам обрати оптимальний стандарт та міграційний шлях.

Які ризики виникають при використанні rebasing токенів?

Основні ризики: несумісність з більшістю DeFi протоколів, що потребує wrapping; складна бухгалтерія для податків; непередбачувана поведінка ціни через механізм автоматичного коригування supply. Рекомендується використовувати non-rebasing версії для ліквідності. Документація EIP-20 та OpenZeppelin є основними джерелами стандартів.

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

• Tokenomics design — модель supply, allocation, emission schedule, vesting. Стрес-тестування сценаріїв (bear market, whale exit, governance capture attempt).
• Контракт розробка — ERC-20 + extensions, vesting, governance. Foundry fuzz тести на vesting calculations, governance thresholds.
• Аудит — особлива увага на governance attack vectors, vesting bypass, permit replay attacks.
• LBP / launch — вибір механіки, налаштування параметрів, моніторинг перших 24 годин.
• Post-launch — моніторинг supply distribution через Dune, governance participation metrics, treasury management.

Стек: Solidity 0.8.x, OpenZeppelin Contracts 5.x, Foundry, Gnosis Safe, OpenZeppelin Defender, Dune Analytics.

Строки (залежать від складності):

• ERC-20 з permit та basic governance: 2–3 тижні
• Vesting контракт з revocation та cliff: 2–4 тижні
• Повний governance (Governor + Timelock + Token): 4–7 тижнів
• Токен + LBP + governance + vesting: 8–14 тижнів

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

• Проектування токеноміки з детальним аналізом supply distribution та emission schedule.
• Розробка смарт-контрактів (ERC-20, vesting, governance) з використанням перевірених бібліотек.
• Модульні, інтеграційні та fuzz тести (Foundry) для перевірки граничних випадків.
• Внутрішній аудит коду з використанням Slither та Mythril.
• Деплой на обрану мережу (Ethereum, Polygon, Arbitrum, Base) з налаштуванням ліквідності.
• Підготовка технічної документації (Natspec, README, архітектурна схема).
• Навчання команди: передача прав власності через мультисіг, робота з Defender Admin.
• Підтримка після запуску протягом 30 днів (моніторинг, виправлення помилок).

Зв'яжіться з нами для отримання консультації та оцінки вашого проєкту. Замовте розробку токена — ми підготуємо рішення під ключ.