Налаштування тестового середовища Solidity: Foundry, Hardhat, Anvil

Проблема: тести падають, довіри немає

Уявіть: ви деплоїте контракт у mainnet, але через годину виявляєте reentrancy-вразливість. Користувачі втратили кошти — репутація підірвана, аудит не допоміг. Кожна година простою коштує $5,000, а збиток від reentrancy-атак перевищує $100M. Або типова ситуація: новий розробник витрачає півдня на встановлення залежностей і запуск першого тесту. CI-пайплайн впав, але ніхто не знає чому — логи порожні.

Наша команда з 5-річним досвідом у блокчейн-розробці налаштувала такі середовища для 50+ проєктів, включаючи протоколи з сумарним TVL > $1B. У результаті час деплою скоротився на 40%, а кількість багів у продакшені — на 70%. Це не просто тулчейн — це гарантія стабільності та відтворюваності. Налаштування тестового середовища смарт-контрактів дозволяє швидко виявляти помилки.

Який фреймворк обрати під задачу?

Для Solidity-проєктів зараз два реальні варіанти: Foundry та Hardhat. Вони вирішують різні задачі і часто використовуються разом. Вибір залежить від того, що ви тестуєте: логіку контракту чи інтеграцію з фронтендом.

Наш стандарт: Foundry для unit та fuzz-тестів, Hardhat для скриптів деплою та інтеграції з frontend. Обидва конфіги співіснують в одному репозиторії — це дозволяє писати тести на Solidity, а деплоїти через TypeScript. Тестове середовище з Foundry скорочує час тестування до 5 разів порівняно з використанням тільки Hardhat.

Як влаштована структура проєкту?

Використовуємо розділення на модулі: contracts/core, contracts/interfaces, test/unit, test/integration, test/invariant, script (Foundry), deploy (Hardhat) та fixtures. Така організація дозволяє відокремити модульні тести (без RPC) від інтеграційних (з форком). Unit-тести мають виконуватися за лічені секунди, а інтеграційні — тільки при мержі в main.

Налаштування локальної мережі, моків та фікстур

Локальна мережа: Anvil замість Ganache

Anvil (входить до Foundry) — локальний EVM-нод на Rust. Швидший за Ganache в 10 разів, активно підтримується. Для розробки запускаємо в режимі форку mainnet або testnet:

# Форк Ethereum mainnet з конкретним блоком (відтворюваність) anvil --fork-url $MAINNET_RPC --fork-block-number 19500000 # Форк з попередньо визначеними акаунтами та балансами anvil --fork-url $MAINNET_RPC --accounts 10 --balance 10000 

Форк-тестування — єдиний спосіб перевірити інтеграцію з Uniswap, Aave, Chainlink без деплою на testnet. Транзакція в локальному форку — миттєво. На Sepolia — 12-15 секунд. Економія часу на кожній ітерації: замість 15 секунд — 0.1 секунди. Використовуйте Ethereum testnets для знайомства з мережами.

Моки та фікстури: ізоляція без крихкості

Для ізоляції тестів використовуємо ієрархію фікстур:

// BaseFixture.sol — спільні залежності abstract contract BaseFixture is Test { MockERC20 token; MockChainlinkOracle oracle; function setUp() public virtual { token = new MockERC20("Test", "TST", 18); oracle = new MockChainlinkOracle(2000e8); // $2000 price } } // ProtocolFixture.sol — деплой тестованого протоколу contract ProtocolFixture is BaseFixture { Protocol protocol; function setUp() public override { super.setUp(); protocol = new Protocol(address(token), address(oracle)); } } 

Не використовуємо vm.mockCall для основних залежностей — це крихко і не перевіряє інтерфейс. Створюємо повноцінні mock-контракти з мінімальною реалізацією. Такий підхід знижує кількість хибних спрацьовувань на 30%.

Покрокове налаштування та CI/CD

name: Tests on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Install Foundry uses: foundry-rs/foundry-toolchain@v1 - name: Run unit tests run: forge test --match-path "test/unit/*" -vvv - name: Run integration tests run: forge test --match-path "test/integration/*" --fork-url ${{ secrets.MAINNET_RPC }} - name: Coverage check run: forge coverage --min-line-coverage 80 

networks: { sepolia: { url: process.env.SEPOLIA_RPC, accounts: [process.env.DEPLOYER_KEY], chainId: 11155111, }, polygon_amoy: { url: process.env.AMOY_RPC, accounts: [process.env.DEPLOYER_KEY], chainId: 80002, }, }