Отладка и тестирование 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.

Как устроена структура проекта?

Используем разделение на модули: 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, }, }