Smart Contract Verification in Ethereum



The most significant feature of Ethereum is Ethereum Virtual Machine (EVM) that is used to run smart contracts. Smart contracts are little programs written in Solidity or other smart contract languages (LLL etc). EVM doesn’t run these smart contracts directly. It runs its byte code.


Byte code is used inside EVM and it’s not readable by a human. Users of smart contracts utilize blockchain explorers (BlockScout, Etherscan) to validate that they use correct smart contracts because they allow developers to verify their smart contracts and publish initial code written in a human-readable high-level programming language like Solidity. By the process of verification, I mean checking that byte code corresponds to the supposed smart contract.

In this post, I’ll describe how smart contracts can be verified. Blockchain explorers use the same concepts described in this post.

Input parameters

You should have the following data related to a smart contract that you want to verify:


  • byte code
  • solidity contract code
  • contract name
  • compiler version
  • optimization


  • optimizer runs count (if your contract has compiler optimization)
  • constructor arguments (if your smart contract has constructor arguments)
  • contract library addresses (if your smart contract uses external libraries)

Basically, we need to check:

byte_code == verify(solidity_contract_code, contract_name, compiler_version, optimization, optimizer_runs, constructor_arguments, contract_library_addresses)

Solidity compiler’s JSON-input-output interface

The process of verification is trivial. We will use solidity compiler to compile solidity contract code with provided parameters. Then we will check if initial byte code is equal to the obtained byte code.

The recommended way to interface with the Solidity compiler especially for more complex and automated setups is the so-called JSON-input-output interface. The same interface is provided by all distributions of the compiler. The fields are generally subject to change, some are optional (as noted), but we try to only make backwards compatible changes. The compiler API expects a JSON formatted input and outputs the compilation result in a JSON formatted output.

Solidity compiler docs

Let’s generate JSON input parameters for the compiler’s JSON-input-output interface:

  language: 'Solidity',
  sources: {
    [newContractName]: {
      content: sourceCode
  settings: {
    evmVersion: 'byzantium',
    optimizer: {
      enabled: optimize == '1',
      runs: 200
    libraries: {
      [newContractName]: externalLibraries
    outputSelection: {
      '*': {
        '*': ['*']
  • newContractName is the name of our contract
  • sourceCode is the source code of our contract
  • optimize is equal to 1 if we enabled compiler optimization
  • externalLibraries is key-value pairs of external libraries that we used in our contract

We pass the version of Solidity compiler directly to solc.loadRemoteVersion as the first argument

Constructor Arguments

The only thing left to do is to append constructor arguments to the compiled bytecode and check if it equals to the manually compiled byte code.