Верификация смарт-контрактов на BscScan
Задеплоенный контракт без верифицированного исходного кода — это байткод на блокчейне. BscScan показывает транзакции, но не показывает что именно делает функция. Пользователи не могут прочитать логику, аудиторы работают только с декомпилированным кодом, а интеграции через Read/Write Contract недоступны. Верификация превращает байткод обратно в читаемый Solidity.
Почему верификация иногда не проходит
Самая частая причина провала — несовпадение байткода. BscScan перекомпилирует загруженный исходник с указанными параметрами и сравнивает с on-chain байткодом. Если компилятор другой версии, другой optimizer runs, или не совпадает evmVersion — результат не сойдётся.
Флаттенинг контрактов с зависимостями. Если контракт импортирует OpenZeppelin, нужно либо загрузить все файлы через Standard JSON Input, либо сфлаттенить в один файл. При флаттенинге через hardhat flatten иногда дублируются SPDX-License-Identifier и pragma solidity — это ошибка компиляции. Нужно оставить по одной директиве в начале файла.
Immutable variables. Переменные immutable записываются в байткод при деплое с конкретными значениями. Верификация через стандартную форму иногда не позволяет указать аргументы конструктора корректно для immutable — Standard JSON Input надёжнее.
Как верифицируем
Три способа, от простого к надёжному:
Через Hardhat Verify плагин. Одна команда после деплоя:
npx hardhat verify --network bsc DEPLOYED_ADDRESS "arg1" "arg2"
Плагин автоматически определяет версию компилятора, optimizer settings из hardhat.config.ts и формирует корректный запрос к BscScan API. Работает для большинства случаев.
Standard JSON Input. Для сложных проектов с множеством зависимостей. Foundry генерирует его командой forge verify-contract или можно получить через hardhat compile --show-stack-traces. JSON содержит все исходники, настройки компилятора, metadata. Загружается через BscScan UI во вкладке «Standard Json-Input».
API верификация. Для CI/CD: POST-запрос на https://api.bscscan.com/api с API-ключом. Используем при автоматическом деплое — скрипт деплоит и сразу верифицирует. Foundry поддерживает это нативно через --verify --etherscan-api-key.
Сроки
Верификация одного контракта — 1-2 часа. Если контракт уже задеплоен и нет исходников с точными параметрами компилятора — до нескольких часов на восстановление конфигурации через анализ байткода.