Розробка смарт-контрактів краудфандингу (ICO/IDO/IEO)

Уявіть: ви зібрали $2 млн через ICO, але контракт не захищений від reentrancy — хакер виводить всі ETH за одну транзакцію. Або обрали IDO, але не врахували slippage, і інвестори втратили половину токенів через маніпуляції з пулом. Такі помилки коштують грошей та репутації. Ми, команда з понад 5-річним досвідом у блокчейн-розробці, проєктуємо архітектуру краудфандингу так, щоб виключити ці ризики.

ICO, IDO та IEO — три різних механізми продажу токенів з різною архітектурою смарт-контрактів, різними вимогами до безпеки та різними правовими ризиками. Плутати їх на етапі проєктування — дорога помилка.

ICO (Initial Coin Offering) — прямий продаж токенів з контракту. Повний контроль, жодних посередників, але й жодних гарантій для покупців. Розквіт припав на початкові етапи розвитку, зараз асоціюється з високим ризиком шахрайства та регуляторною увагою.

IDO (Initial DEX Offering) — продаж через DEX-механізм (Uniswap, PancakeSwap, Raydium). Ліквідність додається одночасно з продажем, ціна визначається ринком або через спеціалізовану launchpad платформу. IDO-механізм часто безпечніший за ICO через автоматичну ліквідність: інвестори можуть продати токени одразу після TGE.

IEO (Initial Exchange Offering) — продаж через централізовану біржу. Біржа виступає посередником та KYC провайдером. Смарт-контракт у цьому випадку спрощений, основна логіка на стороні біржі.

Як вибрати механізм продажу токенів? — розробка контрактів краудфандингу

Вибір залежить від цілей: ICO дає повний контроль, але вимагає юридичного опрацювання. IDO швидше та дешевше, але підходить лише для ліквідних токенів на DEX. IEO додає довіру за рахунок біржі, але вимагає її схвалення та комісії. Ми допомагаємо обрати оптимальний варіант під ваш проєкт та реалізуємо його під ключ.

Як захистити контракт від rugpull та маніпуляцій?

Всі функції owner (setPrice(), withdraw(), pause()) блокуються timelock або multisig (Gnosis Safe). Для чесного розподілу використовуємо commit-reveal або randomized start block. Для рефанду при недосягненні softcap — pull-pattern з ReentrancyGuard. Стандартні практики безпеки описані в документації OpenZeppelin.

Структура crowdsale контракту

Базова архітектура, застосовна для більшості продажів:

contract TokenSale { using SafeERC20 for IERC20; IERC20 public immutable token; address public immutable treasury; // Конфігурація раундів struct Round { uint256 price; // wei за 1 token (з урахуванням decimals) uint256 allocation; // всього токенів у раунді uint256 sold; uint256 minPurchase; uint256 maxPurchase; // per wallet cap uint256 startTime; uint256 endTime; bool whitelistRequired; } Round[] public rounds; uint256 public activeRound; mapping(address => uint256) public purchased; // total per wallet mapping(address => bool) public whitelist; mapping(address => bool) public claimed; // Vesting: токени видаються не одразу uint256 public tgePercent; // % одразу при TGE uint256 public cliffEnd; // timestamp кінця cliff періоду uint256 public vestingEnd; // timestamp кінця vesting event TokensPurchased(address indexed buyer, uint256 ethAmount, uint256 tokenAmount, uint256 round); event TokensClaimed(address indexed claimant, uint256 amount); } 

Обчислення кількості токенів

Часта помилка: неправильна обробка decimals. Якщо ETH має 18 decimals, а токен — теж 18, формула тривіальна. Але якщо токен має 6 decimals (USDC-style) або 0 (рідкісний випадок) — розрахунок інший.

function calculateTokens(uint256 ethAmount, uint256 roundIndex) public view returns (uint256) { Round storage round = rounds[roundIndex]; // price зберігається як wei ETH за 1 повний токен (з урахуванням token decimals) // Наприклад: якщо 1 token = 0.001 ETH, то price = 0.001 * 1e18 = 1e15 return (ethAmount * 10**token.decimals()) / round.price; } 

Whitelist та KYC

Для IDO на launchpad-платформах — whitelist через merkle proof (економія gas на зберіганні):

bytes32 public whitelistMerkleRoot; function purchaseWithProof(bytes32[] calldata proof) external payable { bytes32 leaf = keccak256(abi.encodePacked(msg.sender)); require( MerkleProof.verify(proof, whitelistMerkleRoot, leaf), "Not whitelisted" ); _purchase(); } 

Оновлення кореня Merkle-дерева при додаванні нових адрес — off-chain операція (generateMerkleTree + setMerkleRoot on-chain). Важно: при оновленні root старі proof інвалідуються — потрібна або плавна міграція, або зберігання кількох root-ів для перекривних вікон.

Vesting механізм

Продаж без vesting — червоний прапор для інвесторів. Стандартна схема: 10% TGE + 6 місяців cliff + 18 місяців лінійний vesting.

function claimableAmount(address beneficiary) public view returns (uint256) { uint256 total = purchased[beneficiary]; if (total == 0) return 0; uint256 tgeAmount = (total * tgePercent) / 100; uint256 vestingAmount = total - tgeAmount; if (block.timestamp < cliffEnd) { // Тільки TGE частина доступна (якщо TGE вже пройшов) return tgeReleased[beneficiary] ? 0 : tgeAmount; } if (block.timestamp >= vestingEnd) { return total - claimed[beneficiary]; // все } // Лінійний vesting після cliff uint256 elapsed = block.timestamp - cliffEnd; uint256 duration = vestingEnd - cliffEnd; uint256 vestedAmount = (vestingAmount * elapsed) / duration; uint256 totalClaimable = tgeAmount + vestedAmount; return totalClaimable - claimed[beneficiary]; } 

Ризики та захист

Front-running при старті продажу. MEV-боти відстежують mempool та вставляють транзакції в перший блок продажу. Для fair launch: commit-reveal схема або randomized start block.

Reentrancy при поверненні ETH. Якщо в логіку включений refund (наприклад, при недосягненні softcap), функція повернення повинна використовувати checks-effects-interactions pattern та ReentrancyGuard.

Manipulation з ціною через великий purchase. При bonding curve моделях (ціна зростає з кожною покупкою) — можлива маніпуляція через фіктивні покупки з подальшим перепродажем. Рішення: мінімальний lock period або фіксована ціна в раунді.

Owner privilege abuse. Функції setPrice(), withdraw(), pause() повинні мати або timelock, або multisig (Gnosis Safe). Безконтрольний owner — причина більшості rugpull сценаріїв.

Softcap та refund механізм. Якщо не зібрали minimum — покупці повинні отримати ETH назад. Стандартний патерн: зберігати contributions у mapping, pull-pattern для повернення (не push), активувати режим refund через функцію після finalization.

Тестування та аудит

Foundry fuzzing обов'язковий для crowdsale контрактів:

function testFuzz_purchaseCalculation(uint256 ethAmount, uint256 decimals) public { ethAmount = bound(ethAmount, 0.001 ether, 100 ether); decimals = bound(decimals, 0, 18); // Перевіряємо, що не буває overflow при різних комбінаціях uint256 tokens = sale.calculateTokens(ethAmount, 0); assertGt(tokens, 0, "Zero tokens for non-zero ETH"); } 

Ключові інваріанти для fuzzing:

• SUM(purchased) <= total allocation — ніколи не продаємо більше, ніж є
• SUM(claimed) <= SUM(purchased) — ніколи не видаємо більше, ніж продали
• Після finalization та refund mode: contract balance >= SUM(contributions для unfulfilled покупців)

Для продажів з суттєвим обсягом — зовнішній аудит обов'язковий. Мінімум одна команда з Tier 2 аудиторів (Pessimistic, MixBytes, Oxorio).

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

Ми надаємо повний комплект deliverables:

• Архітектурна документація та специфікація контракту
• Вихідний код з тестами (Foundry, unit + fuzzing)
• Розгортання в тестовій мережі (Goerli/Sepolia) з інструкцією
• Інтеграція з frontend (ethers.js/viem, приклади транзакцій)
• Скрипти для верифікації на Etherscan
• Консультації з безпеки та аудиту
• Підтримка після запуску (1 місяць базової підтримки)

Строки

Стандартний crowdsale контракт з vesting та merkle whitelist — 5-7 робочих днів розробки + 2-3 дні тестування. З нестандартною логікою (bonding curve, multi-currency, dynamic rounds) — 2-3 тижні. Пишіть — оцінимо ваш проєкт за один день.

Наша команда виконала понад 30 проєктів з краудфандингу, включаючи мультичейн-рішення з інтеграцією Chainlink oracles та аудитом. Зв'яжіться з нами, щоб обговорити ваш проєкт — допоможемо обрати правильний механізм та реалізувати його безпечно.