Hardhat multi-deploy: налаштування автоматичного деплою смарт-контрактів

Ми постійно стикаємося з ситуацією, коли проект переростає одну мережу. Деплой на Polygon — ок, на Arbitrum — вже скрипт-монстр. А коли мереж вісім, а контрактів десять, і щоразу потрібно верифікувати вихідні коди на блокчейн-експлорерах — перетворюється на пекло. Наш підхід — hardhat-deploy плагін, який робить деплой декларативним, ідемпотентним та автоматизованим. Досвід нашої команди — 10+ років у Web3, понад 50 розгорнутих протоколів на Ethereum, Polygon, Arbitrum, Optimism, Base.

На одному проекті з 6 контрактами та 8 мережами ми впровадили hardhat-deploy і скоротили час деплою з 2 днів до 2 годин, а витрати на газ знизилися на 25% за рахунок кастомізації optimizer runs під кожну мережу. І це не межа — на деяких контрактах економія сягає 40%.

Чому стандартний Hardhat deploy недостатній?

Базовий підхід npx hardhat run scripts/deploy.ts — це імперативний скрипт без стану. Немає відстеження, що вже задеплоєно. Немає ідемпотентності. Запустити повторно — задеплоїть знову, отримаєш другий екземпляр контракту. Адреси ніде не зберігаються автоматично.

Нещодавно на одному проекті з деплоєм у 5 мереж ми витратили 2 дні на ручну верифікацію кожного контракту в блокчейн-експлорерах. Після впровадження hardhat-deploy цей процес скоротився до 1 години. А оптимізація газу під кожну мережу за допомогою налаштувань optimizer runs дозволила заощадити до 30% газу.

hardhat-deploy додає:

• Відстеження деплоїв — JSON-файли в deployments/<network>/ з адресою, ABI, bytecode, transaction hash
• Ідемпотентність — повторний запуск не деплоїть, якщо контракт вже є і не змінився
• Іменовані акаунти — namedAccounts у конфігу для читабельності
• Fixtures для тестів — deployments доступні в тестах через getNamedAccounts

Документація hardhat-deploy рекомендує використовувати tags та dependencies для управління порядком деплою.

Порівняємо можливості:

Чому hardhat-deploy кращий за звичайний deploy?

Плагін зберігає хеш байткоду та аргументів конструктора для кожного деплою. При повторному запуску перевіряє, чи змінився контракт. Якщо ні — пропускає. Це дозволяє безпечно запускати деплой на 10 мереж без ризику задвоєння. А якщо код змінився — плагін автоматично деплоїть нову версію, а старі адреси залишаються доступні. На відміну від ручного деплою, помилка при повторному запуску не призводить до дублювання контрактів — економія на газі становить до 30% на кожному передеплої.

Конфігурація multi-chain

// hardhat.config.ts import { HardhatUserConfig } from "hardhat/config"; import "@nomicfoundation/hardhat-toolbox"; import "hardhat-deploy"; const config: HardhatUserConfig = { solidity: { version: "0.8.24", settings: { optimizer: { enabled: true, runs: 200 }, viaIR: false, // вмикаємо тільки якщо потрібно }, }, namedAccounts: { deployer: { default: 0, // перший акаунт mainnet: "0x...", // конкретна адреса для mainnet }, treasury: { default: 1, mainnet: "0x...", }, }, networks: { mainnet: { url: process.env.MAINNET_RPC, accounts: [process.env.DEPLOYER_KEY!], chainId: 1 }, polygon: { url: process.env.POLYGON_RPC, accounts: [process.env.DEPLOYER_KEY!], chainId: 137 }, arbitrum: { url: process.env.ARBITRUM_RPC, accounts: [process.env.DEPLOYER_KEY!], chainId: 42161 }, optimism: { url: process.env.OPTIMISM_RPC, accounts: [process.env.DEPLOYER_KEY!], chainId: 10 }, base: { url: process.env.BASE_RPC, accounts: [process.env.DEPLOYER_KEY!], chainId: 8453 }, }, etherscan: { apiKey: { mainnet: process.env.ETHERSCAN_KEY!, polygon: process.env.POLYGONSCAN_KEY!, arbitrumOne: process.env.ARBISCAN_KEY!, optimisticEthereum: process.env.OPTIMISM_KEY!, base: process.env.BASESCAN_KEY!, }, }, }; 

Deploy скрипти з hardhat-deploy

// deploy/001_deploy_token.ts import { HardhatRuntimeEnvironment } from "hardhat/types"; import { DeployFunction } from "hardhat-deploy/types"; const func: DeployFunction = async (hre: HardhatRuntimeEnvironment) => { const { deployments, getNamedAccounts, network } = hre; const { deploy } = deployments; const { deployer, treasury } = await getNamedAccounts(); const token = await deploy("MyToken", { from: deployer, args: [treasury, "1000000000000000000000000"], // 1M tokens log: true, // логує адресу та tx hash autoMine: true, // автоматичний майнінг на локальній мережі waitConfirmations: network.name === "mainnet" ? 5 : 1, }); // Верифікація одразу після деплою if (network.name !== "hardhat" && network.name !== "localhost") { await hre.run("verify:verify", { address: token.address, constructorArguments: [treasury, "1000000000000000000000000"], }); } }; func.tags = ["Token", "all"]; func.dependencies = []; // цей скрипт без залежностей export default func; 

// deploy/002_deploy_staking.ts const func: DeployFunction = async (hre: HardhatRuntimeEnvironment) => { const { deployments, getNamedAccounts } = hre; const { deploy, get } = deployments; const { deployer } = await getNamedAccounts(); const token = await get("MyToken"); // отримуємо адресу вже задеплоєного токена await deploy("StakingContract", { from: deployer, args: [token.address], log: true, }); }; func.tags = ["Staking", "all"]; func.dependencies = ["Token"]; // деплоїться тільки після Token export default func; 

Порядок виконання управляється через tags та dependencies. Hardhat-deploy будує граф залежностей і деплоїть у правильному порядку.

Як налаштувати паралельний деплой одразу в 5 мереж?

# Одна мережа npx hardhat deploy --network polygon # Кілька мереж через скрипт for network in mainnet polygon arbitrum optimism base; do npx hardhat deploy --network $network --tags all done 

Для паралельного деплою на кілька мереж одночасно — невеликий bash скрипт:

#!/bin/bash networks=("polygon" "arbitrum" "optimism" "base") pids=() for network in "${networks[@]}"; do npx hardhat deploy --network $network --tags all & pids+=($!) done for pid in "${pids[@]}"; do wait $pid || exit 1 done echo "All deployments complete" 

Mainnet деплоїмо окремо, вручну, після перевірки всіх тестових мереж.

Зберігання та експорт адрес

Після деплою hardhat-deploy створює файли в deployments/polygon/MyToken.json з адресою та ABI. Для фронтенду — експортуємо в єдиний конфіг:

// scripts/export-addresses.ts import { deployments } from "hardhat"; const networks = ["mainnet", "polygon", "arbitrum", "optimism", "base"]; const contracts = ["MyToken", "StakingContract"]; const config: Record<string, Record<string, string>> = {}; for (const network of networks) { config[network] = {}; for (const contract of contracts) { try { const deployment = await deployments.get(contract); config[network][contract] = deployment.address; } catch { // контракт не задеплоєно на цю мережу } } } fs.writeFileSync("src/contracts/addresses.json", JSON.stringify(config, null, 2)); 

CI/CD інтеграція

GitHub Actions для автоматичного деплою при merge в main:

# .github/workflows/deploy.yml name: Deploy Contracts on: push: branches: [main] paths: ["contracts/**", "deploy/**"] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: "20" cache: "npm" - run: npm ci - name: Deploy to testnets env: DEPLOYER_KEY: ${{ secrets.DEPLOYER_KEY }} POLYGON_RPC: ${{ secrets.POLYGON_MUMBAI_RPC }} run: npx hardhat deploy --network polygonMumbai --tags all - name: Commit updated deployments run: | git config user.name "GitHub Actions" git config user.email "[email protected]" git add deployments/ git commit -m "chore: update deployment artifacts" || echo "No changes" git push 

Деплой артефактів комітяться назад у репозиторій — адреси завжди актуальні та версіоновані.

Що входить у налаштування multi-chain деплою?

Ми надаємо:

• Готовий конфіг hardhat.config.ts для 5+ мереж з оптимізацією газу
• Deploy-скрипти з ідемпотентністю та автоматичною верифікацією
• Інтеграцію з CI/CD (GitHub Actions / GitLab CI)
• Документацію з управління деплоєм
• Підтримку протягом 30 днів після здачі