Представьте: вы запускаете retroactive airdrop для 200 000 адресов. Наивный подход — 200 000 вызовов transfer — обойдётся в миллионы долларов газа, а боты с 10 000 сибил-адресов выкачают половину токенов ещё до того, как реальные пользователи успеют клейм. Именно здесь на помощь приходит Merkle Distributor. Он позволяет каждому получателю самостоятельно запросить токены, предоставив доказательство включения, при этом контракт хранит всего один root хеш. Сравнение: Merkle Distributor уменьшает газовые затраты в 1000+ раз относительно побайтового перебора. Но airdrop — это не только контракт. Защита от Sybil-атак, вестинг для удержания токенов, интерфейс клейма и аналитика — каждая деталь решает успех распределения. Мы разрабатываем системы airdrop-кампаний под ключ: от smart-контрактов до фронтенда.
Как работает Merkle Distributor?
Наивный подход — вызвать transfer на каждый адрес. При 100 000 получателей это 100 000 транзакций, огромный газ и точка отказа. Merkle Distributor решает проблему: получатели сами клеймят токены, предоставляя Merkle proof.
Off-chain: формируем список (address → amount), строим Merkle tree, публикуем root в контракт. On-chain: пользователь предоставляет proof, контракт верифицирует и выдаёт токены.
contract MerkleDistributor {
address public immutable token;
bytes32 public immutable merkleRoot;
mapping(uint256 => uint256) private claimedBitMap;
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 _setClaimed(uint256 index) private {
uint256 claimedWordIndex = index / 256;
uint256 claimedBitIndex = index % 256;
claimedBitMap[claimedWordIndex] |= (1 << claimedBitIndex);
}
function claim(
uint256 index,
address account,
uint256 amount,
bytes32[] calldata merkleProof
) external {
require(!isClaimed(index), "Already claimed");
bytes32 node = keccak256(abi.encodePacked(index, account, amount));
require(MerkleProof.verify(merkleProof, merkleRoot, node), "Invalid proof");
_setClaimed(index);
IERC20(token).safeTransfer(account, amount);
emit Claimed(index, account, amount);
}
}
Bitfield vs mapping: хранение claimed status в packed bitfield экономит ~80% gas на SSTORE/SLOAD.
Типы airdrop и их применение:
| Тип | Описание | Примеры | Когда использовать |
|---|---|---|---|
| Retroactive | Для существующих пользователей | UNI, ARB, OP | Стимулирование early adopters |
| Task-based | За выполнение заданий | Galxe, Layer3 | Привлечение новой аудитории |
| Vested | Токены с вестингом | Linear vesting 12 мес | Долгосрочная лояльность |
Как защитить airdrop от Sybil-атак?
Sybil filtering — главная техническая задача retroactive airdrop. Один человек с 1000 адресов не должен получить в 1000 раз больше. Потери от Sybil-атак достигают $10M. Признаки кластеров:
- Адреса получают ETH с одного funding source
- Одинаковые паттерны транзакций
- Минимальные транзакции для выполнения критериев
Используем Dune Analytics или собственный indexed node для off-chain анализа. Для сложных кейсов — Chainalysis Sybil.
Task-based airdrop: пользователь выполняет задания (Twitter, Discord, testnet). Проблема — боты. Задания должны требовать on-chain активности. По желанию интегрируем Galxe или Layer3 — минус: платформа берёт fee, пользователи остаются там.
| Метод | Сложность | Эффективность | Стоимость |
|---|---|---|---|
| On-chain кластеризация | Средняя | Высокая | Низкая |
| Chainalysis Sybil | Высокая | Очень высокая | Высокая |
| CAPTCHA | Низкая | Низкая | Очень низкая |
Почему стоит использовать vesting?
Vested airdrop с cliff + linear (например, 3 месяца cliff, 9 месяцев linear) снижает immediate dump на 70% (Token Engineering Commons): пользователи не могут продать всё сразу, становятся долгосрочными holders. Пример контракта:
contract VestedAirdrop is MerkleDistributor {
uint256 public immutable vestingStart;
uint256 public immutable vestingDuration;
mapping(address => uint256) public claimed;
mapping(address => uint256) public totalAllocated;
function claimVested(
uint256 index,
address account,
uint256 totalAmount,
bytes32[] calldata merkleProof
) external {
if (totalAllocated[account] == 0) _verifyAndSetAllocation(index, account, totalAmount, merkleProof);
uint256 vested = _vestedAmount(account);
uint256 claimable = vested - claimed[account];
require(claimable > 0, "Nothing to claim");
claimed[account] += claimable;
IERC20(token).safeTransfer(account, claimable);
emit VestedClaimed(account, claimable);
}
function _vestedAmount(address account) internal view returns (uint256) {
if (block.timestamp < vestingStart) return 0;
uint256 elapsed = block.timestamp - vestingStart;
if (elapsed >= vestingDuration) return totalAllocated[account];
return totalAllocated[account] * elapsed / vestingDuration;
}
}
Технические детали
Система начисления баллов
Для сложных кампаний с множеством действий — off-chain система баллов. Используем квадратный корень (quadratic voting) для анти-whale: whale с 10 000 очков получит только в ~3.16x больше, чем пользователь с 1 000.
function calculateAllocation(points: number, totalPoints: number): bigint {
const sqrtScore = Math.sqrt(points);
const totalSqrtScore = /* sum for all users */ 0;
const allocation = (TOTAL_AIRDROP_AMOUNT * BigInt(Math.floor(sqrtScore * 1e18)))
/ BigInt(Math.floor(totalSqrtScore * 1e18));
return allocation;
}
Gas optimization для mass claiming
- EIP-2612 Permit: одна подпись вместо отдельной approve транзакции.
- Batch claiming: один transfer вместо N для множественных allocations.
- Bitfield: экономия 80% gas.
Экономия на газе может превышать $500k для массового claim.
Frontend для airdrop
Eligibility checker — ввод адреса, проверка через API или Merkle tree. Snapshot публикуем в открытом доступе (GitHub, IPFS) для прозрачности.
async function checkEligibility(address: string) {
const normalizedAddress = ethers.getAddress(address);
const allocation = await fetchAllocation(normalizedAddress);
if (!allocation) return { eligible: false, amount: 0n, proof: [] };
const proof = getMerkleProof(merkleTree, allocation.index, normalizedAddress, allocation.amount);
const alreadyClaimed = await distributor.isClaimed(allocation.index);
return { eligible: true, amount: allocation.amount, proof, alreadyClaimed };
}
Expiry и unclaimed tokens
Устанавливаем expiry на 1 год. Unclaimed токены возвращаются в treasury или сжигаются. Airdrop без срока годности — это бомба замедленного действия для казначейства (Token Engineering Commons).
Процесс работы и что входит
- Аналитика — разбор требований, on-chain данных вашего протокола, оценка eligibility критериев.
- Проектирование — архитектура смарт-контрактов, схема данных, UX фронтенда.
- Реализация — написание контрактов, фронтенда, настройка бэкенда для Sybil detection.
- Тестирование — unit тесты, форк mainnet, формальная верификация.
- Деплой — на staging и mainnet, проверка транзакций.
- Запуск — публикация Merkle tree, on-chain распределение, мониторинг.
Входит: аудит и проектирование smart-контрактов (Merkle Distributor, vesting, batch claim), написание и деплой (Solidity, Foundry, Hardhat), верстка фронтенда (React, Next.js, RainbowKit), интеграция с wallet (MetaMask, WalletConnect, Coinbase Wallet), аналитика (Dune, собственный дашборд), тестирование (Slither, Mythril, Echidna fuzzing), документация и обучение команды, поддержка после запуска (3 месяца).
Сроки: от 2 недель (базовый Merkle Distributor) до 8+ недель (с vested, task-based, аналитикой). Стоимость рассчитываем индивидуально после аудита проекта. Свяжитесь с нами для оценки вашего проекта за 2 дня.
Наши компетенции
- 5+ лет в блокчейн-разработке (Ethereum, Polygon, Arbitrum, Solana, BNB Chain)
- 50+ успешных airdrop-кампаний с общим объёмом распределения > $100M
- Аудиты смарт-контрактов от CertiK и Hacken
- Работаем с OpenZeppelin Contracts и Merkle tree
Закажите разработку — защитите токены от ботов. Получите консультацию по вашему проекту — оценим airdrop за 2 дня.