Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Contract Doesn’t Match

“Compiled contract deployment bytecode does NOT match the transaction deployment bytecode”
The submitted source code does not match the contract code deployed on chain. Common causes include using a different compiler version or enabling optimisation runs. For an exact match to be found, both source code and compiler settings specified have to exactly match the deployment conditions, for the same bytecode to be reproduced.

​
Solidity Compilation Error

“Solidity Compilation Error: Identifier not found or not unique”
A compilation issue occured due to syntax errors in your Solidity source code. Consider debugging your contract with any compiler such as Remix or Hardhat and reference the error from Solidity’s official documentation.

​
Contract Not Deployed

“Unable to locate ContractCode at 0x539a277b12a3f6723f4c1769edb11b0be7c214da”
The contract has not been deployed at the specific address at the specific chain. Check the contract address you’ve deployed, if your contract deployment transaction has succeeded or if the chainId specified is correct. We usually pick up deployments within a few blocks from the chaintip, this will be delayed if the chain is having high activity. But no more than a few mins, ping us if you’ve verified the contract is deployed with the Etherscan link.

​
Missing or Invalid Library Names

“Library was required but suitable match not found”
A library was used in your contract deployment, but was not specified, misspelt or using the wrong library address. Double check on your library names ( case sensitive such as “PRBMath” ) or ensure that a matching library name and library address is provided.

​
Missing Contract Name

“Unable to locate ContractName , did you specify the correct Contract Name ?”
A match was not found with the name of the contract specified when multiple files are provided. Ensure that you have provided the correct contract name to be matched against, and making sure you submit the main contract name not its dependencies.

​
Missing/Invalid Constructor Arguments

“Please check if the correct constructor argument was entered”
if your contract utilized the constructor keyword, you should provide it in hex format. Otherwise, leave this field empty as it is. You may reference your original deployment’s constructor arguments or determine it from the end of your compiled bytecode.

​
Mismatched bytecode metadata hash

“Please check if the correct bytecodehash was specified via standard-json verification.”
The metadata hash settings of your submitted source code differs from the settings of your original contract deployment, such as being set to ipfs or none. Submit your contract verification using the solc json input format, and specify the settings accordingly there. Other submission formats such as single file or multifile do not support changing this setting, and will use the compiler defaults.

​
Similar Match Found

“This contract already Similar Matches the deployed ByteCode at 0x4200000000000000000000000000000000000042”
This error indicates that the contract has already been verified via Similar Match to another contract. Kindly reach out to us at this point of time to have this updated to Full Match if required.

​
Unsupported Solc Version

“Invalid or not supported solc version, see https://etherscan.io/solcversions for list”
This error is thrown when you specify to use an invalid or unsupported version of the Solidity Compiler ie. below v0.4.11-nightly.2017.3.15+. Do let us know if you need to verify a contract below this supported version such as to prove you deployed the first NFT.

​
Source Code Already Verified

“Source code already verified”
An Exact Match has been obtained, get back to having your coffee. If you think this might be a mistake, do check if you’ve submitted verification to the right explorer/chain, a contract that is verified on Etherscan is not automatically verified on other explorers.

​
Unsupported File Import Callback

“Source “@openzeppelin/contracts/ERC20.sol” not found: File import callback not supported”
This error is thrown when contracts reference imports from external sources, such as OpenZeppelin libraries or Github links. Consider flattening your source code into a single file, or use the Solidity Standard Json Input format that comes with tools such as Hardhat to resolve these external imports.

​
Temporary Error

“This could be a temporary error, please retry or contact us (Error Code 10001/10002/10003)”
Something went wrong on our end, which could include downtime or maintenance windows. Please retry this in a while or ping us if this continues to persist.