Multi-File Contract Verification Bundler

WHAT IT DOES

The Multi-File Contract Verification Bundler is a developer tool that packages multiple Solidity source files into a standardized verification bundle for block explorer verification. It takes user-provided source files with their file names, generates a structured JSON bundle compatible with Etherscan and other explorers, and provides download functionality. This helps developers verify contracts that span multiple files, such as contracts with imports, libraries, or complex inheritance structures, without manually formatting the verification payload.

HOW TO USE

Enter your source files in the text area with "// File: filename.ext" comments separating each file. Specify the compiler version and the main contract name. Click "generate verification bundle" to create the JSON payload. The tool parses the files, builds a structured bundle with sources and compiler settings, and displays the JSON. Download the bundle and upload it to your block explorer's verification page. The tool also provides step-by-step instructions for completing the verification process.

TECHNICAL MECHANISM

The tool parses the user input by scanning for "// File: filename" markers to separate files. It extracts each file's name and content into a key-value map. The bundle generator creates a JSON object with the standard fields required by block explorers: language, sources (with file contents), and settings (including optimizer configuration and output selection). The tool includes default settings for the optimizer (enabled, 200 runs) and evmVersion (london). The generated JSON follows the standard format used by Hardhat, Foundry, and other frameworks for contract verification. The tool validates that at least one file is provided and generates a clean, formatted JSON output ready for upload.

WHAT IT CANNOT SEE

The tool cannot compile contracts or validate source code correctness. It cannot verify that the bundle matches the deployed bytecode without manual comparison. The tool cannot detect mismatches between source files and deployed bytecode. It cannot handle complex project structures with custom import paths without manual adjustment. The tool cannot automatically resolve import dependencies without user-provided file mapping. It cannot verify that the compiler version matches the deployment. The tool cannot detect if the bundle is complete or missing required files.

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains. The generated bundle follows the standard format used by Etherscan and other explorers, but specific explorers may have slightly different requirements. The compiler version must match the version used for deployment—verify this before uploading. The optimizer settings in the bundle should match the deployment configuration. The tool provides estimates only and should be used as a starting point for contract verification. Always verify that the generated bundle correctly represents your contract source.