Розробка скриптів деплою смарт-контрактів під ключ

Разовий деплой через forge create або npx hardhat deploy з хардкодованими параметрами — це технічний борг. Коли потрібно задеплоїти на 5 чейнів, потім відтворити на тестнеті для аудиторів, а потім повторити через 3 місяці для нової версії — з'ясовується, що ніхто не пам'ятає точний порядок викликів, які контракти потрібно ініціалізувати після деплою і на якому блоці була верифікація. Нещодавно до нас звернулася команда протоколу, у якої після звільнення розробника ніхто не міг повторити деплой на мейннет. Ми написали скрипт за день, і тепер деплой займає 5 хвилин. Ми спеціалізуємося на створенні професійних скриптів деплою під ключ: від параметризації до інтеграції з CI/CD. Наш досвід — 5+ років у Web3, понад 50 успішних проектів. Зв'яжіться з нами для консультації або отримайте індивідуальну оцінку вашого проекту.

Які проблеми вирішують скрипти деплою?

Ручний деплой через forge create або Hardhat консоль призводить до кількох типових проблем:

• Відсутність відтворюваності: повторити точний порядок викликів через місяць — лотерея.
• Помилки ініціалізації: забули викликати initialize() після проксі — контракт непрацездатний.
• Втрата адрес: ніхто не записав, де лежить proxy або admin.
• Довге перемикання мереж: при деплої на 5 мереж вручну — втрата часу на 80%.

Скрипти вирішують ці проблеми: один запуск, повний лог, автоматична верифікація.

Чому Forge Script — стандарт індустрії?

Foundry Script (.s.sol) — Solidity-файл, який виконується як деплой-скрипт. Ключова перевага: одна мова для контрактів і деплою, перевірка типів компілятором, можливість тестувати сам скрипт. У документації Foundry підкреслюється, що це значно знижує кількість помилок порівняно з JS-скриптами.

// SPDX-License-Identifier: MIT pragma solidity ^0.8.24; import {Script, console} from "forge-std/Script.sol"; import {MyProtocol} from "../src/MyProtocol.sol"; import {ProxyAdmin} from "@openzeppelin/contracts/proxy/transparent/ProxyAdmin.sol"; contract DeployMyProtocol is Script { function run() external { uint256 deployerKey = vm.envUint("PRIVATE_KEY"); address deployer = vm.addr(deployerKey); vm.startBroadcast(deployerKey); ProxyAdmin admin = new ProxyAdmin(deployer); MyProtocol implementation = new MyProtocol(); bytes memory initData = abi.encodeCall( MyProtocol.initialize, (vm.envAddress("TREASURY"), vm.envUint("FEE_BPS")) ); TransparentUpgradeableProxy proxy = new TransparentUpgradeableProxy( address(implementation), address(admin), initData ); console.log("ProxyAdmin:", address(admin)); console.log("Implementation:", address(implementation)); console.log("Proxy:", address(proxy)); vm.stopBroadcast(); } } 

Запуск: forge script script/DeployMyProtocol.s.sol --rpc-url $RPC --broadcast --verify. Флаг --verify автоматично верифікує всі задеплоєні контракти через Etherscan API. --slow додає затримку між транзакціями — потрібно для RPC-провайдерів з rate limits.

Як параметризація виключає помилки?

Жодного хардкоду адрес у скрипті. Все через environment variables:

address treasury = vm.envAddress("TREASURY"); uint256 fee = vm.envUint("FEE_BPS"); bool isMainnet = vm.envBool("IS_MAINNET"); 

Для різних оточень: файли .env.sepolia, .env.mainnet, .env.polygon. Скрипт деплою один і той самий. Це економить до 40% часу на підготовку деплою.

Логування адрес задеплоєних контрактів

Після деплою адреси потрібно зафіксувати. Підходи:

JSON файл через foundry's --json флаг. forge script ... --json > deployments/sepolia.json — структурований вивід з адресами, transaction hashes, block numbers.

Кастомне логування у скрипті через vm.writeJson() і vm.writeFile():

string memory json = vm.serializeAddress("deployment", "proxy", address(proxy)); vm.writeJson(json, string.concat("deployments/", vm.toString(block.chainid), ".json")); 

Файли деплою комітимо в репозиторій — вони служать джерелом істини для frontend, аналітики та майбутніх upgrade-скриптів.

Upgrade скрипти та мультичейн деплой

Для UUPS і Transparent Proxy паттернів окремий скрипт для кожного upgrade:

contract UpgradeV2 is Script { function run() external { address proxy = vm.envAddress("PROXY_ADDRESS"); address admin = vm.envAddress("PROXY_ADMIN"); vm.startBroadcast(vm.envUint("PRIVATE_KEY")); MyProtocolV2 newImpl = new MyProtocolV2(); ProxyAdmin(admin).upgradeAndCall( ITransparentUpgradeableProxy(proxy), address(newImpl), "" ); vm.stopBroadcast(); } } 

Кожен upgrade-скрипт має ім'я з версією (UpgradeToV2.s.sol) і зберігається в історії репозиторію. Мультичейн деплой: скрипт запускається послідовно для кожного чейна:

forge script script/Deploy.s.sol --rpc-url $ETHEREUM_RPC --broadcast --verify forge script script/Deploy.s.sol --rpc-url $POLYGON_RPC --broadcast --verify --verifier-url $POLYGONSCAN_API forge script script/Deploy.s.sol --rpc-url $ARBITRUM_RPC --broadcast --verify 

Або через Makefile / shell скрипт з ітерацією по масиву RPC endpoints. Наші скрипти скорочують час деплою на 80% порівняно з ручним підходом.

Що входить у нашу роботу?

• Розробка базового деплой-скрипта з параметризацією (env).
• Налаштування автоматичної верифікації через Etherscan API.
• Логування всіх адрес і артефактів у JSON.
• Створення upgrade-скриптів для UUPS/Transparent Proxy.
• Підтримка мультичейн (Ethereum, Polygon, Arbitrum, BNB Chain та ін.).
• Інтеграція з CI/CD (GitHub Actions, GitLab CI).
• Документація та навчання вашої команди.
• Гарантія коректності деплою на тестнеті перед мейннетом.

Терміни та вартість

Написання базового деплой-скрипта з параметризацією та логуванням — 1 день. Повна deployment infrastructure з upgrade скриптами, мультичейн підтримкою та CI інтеграцією — 2-3 дні. Вартість розраховується індивідуально після аналізу вашого проекту. Клієнти економлять до 70% часу на деплої, що в перерахунку на зарплату інженера дає десятки тисяч доларів економії на рік. Оцінимо ваш проект безкоштовно — зв'яжіться з нами.

Порівняння: ручний деплой vs скрипти

Як ми гарантуємо коректність?

Ми пишемо тести на деплой-скрипти (наприклад, через Foundry), використовуємо симуляцію транзакцій в Tenderly, перевіряємо лог і проводимо code review. Після деплою контракти верифікуються автоматично. Отримайте консультацію інженера — обговоріть ваш проект і ми запропонуємо рішення.