Мы постоянно сталкиваемся с ситуацией, когда проект перерастает одну сеть. Деплой на 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 для управления порядком деплоя.
Сравним возможности:
| Параметр | Обычный deploy | hardhat-deploy |
|---|---|---|
| Идемпотентность | Нет | Да |
| Сохранение адресов | Вручную | Автоматически в JSON |
| Верификация | Отдельный скрипт | Встроена в deploy |
| Multi-chain | N скриптов | Один конфиг |
Почему 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 дней после сдачи
Чек-лист перед запуском деплоя
- Проверить RPC endpoints и API ключи
- Убедиться, что deployer кошелек имеет достаточный баланс
- Протестировать на локальной сети (hardhat)
- Запустить деплой на testnet (Goerli, Mumbai, Sepolia)
- Проверить верификацию на блокчейн-эксплорере
- Запустить параллельный деплой на все целевые сети
Срок настройки полноценного multi-chain деплой pipeline — 1-3 дня в зависимости от количества сетей и требований к CI/CD. Мы гарантируем идемпотентность и воспроизводимость деплоя. Наши инженеры сертифицированы по Solidity и имеют опыт работы с протоколами общей TVL $1B+. Свяжитесь с нами для оценки вашего проекта — получите консультацию по настройке multi-chain pipeline.