“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: 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.
“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.
“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.
“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.
“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.
“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.
“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.
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.
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.
“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.
“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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Etherscan","description":"The complete onchain data API for the crypto ecosystem, across 50+ chains.","colors":{"primary":"#0784C3","light":"#0784C3","dark":"#0784C3"},"logo":{"light":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-dark.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=4e966e2dc30e631ecd17c82d5445201f","dark":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-light.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=61cb0a4a7a22bd9667ac9f22f72ed85e"},"favicon":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-circle.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=e0afd6fa2127dcb9f05292b819cddb9f","api":{"playground":{"display":"interactive"},"examples":{"prefill":false},"mdx":{"server":"https://api.etherscan.io"}},"navbar":{"links":[{"href":"https://etherscan.io/api/pricing","label":"Pricing"},{"href":"https://etherscan.io/contactus","label":"Support"}],"primary":{"type":"button","label":"Get started","href":"/set-up-your-api-key"}},"footer":{"socials":{"x":"https://x.com/etherscan","website":"https://etherscan.io"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"etherscan","hasAudioNarration":false,"actualSubdomain":"etherscan","customDomains":["docs.etherscan.io"],"gitSource":{"type":"github","owner":"blocksolutions","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb0ec5b434e7d02a3a59df","collectionId":"3806edc7-5ab1-4759-a41c-0d7478bc153c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb0ec5b434e7d02a3a59df"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aeb0ec5b434e7d02a3a59df","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":190},{"language":"default","tag":"Overview","count":27},{"language":"default","tag":"Account","count":18},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Stats","count":14},{"language":"default","tag":"Geth/Parity Proxy","count":14},{"language":"default","tag":"Contract Verification","count":13},{"language":"default","tag":"Tokens","count":11},{"language":"default","tag":"Blocks","count":9},{"language":"default","tag":"Build with AI","count":9}]},"assistantConfig":{"deflection":{"enabled":true,"email":"apisupport@etherscan.io"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--color-rgb: 36, 107, 238;--navbar-bg-hsl: 220, 25%, 100%}:root.dark{--navbar-bg-hsl: 209, 23%, 9%}#navbar{overflow:hidden;background-color:hsla(var(--navbar-bg-hsl), 1);background-image:radial-gradient(at 14% 42%, hsla(var(--navbar-bg-hsl), 1) 0px, transparent 50%),\n radial-gradient(at 39% 9%, hsla(var(--navbar-bg-hsl), 1) 0px, transparent 50%),\n radial-gradient(at 95% 85%, hsla(var(--navbar-bg-hsl), 1) 0px, transparent 50%),\n radial-gradient(at 99% 61%, hsla(var(--navbar-bg-hsl), 1) 0px, transparent 50%),\n radial-gradient(at 91% 60%, rgba(var(--color-rgb), 0.4) 0px, transparent 50%),\n radial-gradient(at 69% 0%, rgba(var(--color-rgb), 0.4) 0px, transparent 50%)}#navbar::after{content:'';width:60rem;height:60rem;position:absolute;top:-150%;right:-30%;background-image:url('/images/abstract-lines-kb.svg');background-size:40rem;background-repeat:no-repeat;cursor:default;pointer-events:none}.data-\\[is-opaque\\=true\\]\\:bg-background-light[data-is-opaque=true]{background-color:initial!important}.data-\\[is-opaque\\=true\\]\\:dark\\:bg-background-dark\\/75:is(.dark *)[data-is-opaque=true]{background-color:initial!important}.prose:is(.dark *){color:#D1D1D1}.tryit-button{background-color:#0784C3!important}.nav-tag-pill-text[data-nav-tag]{background-color:#0784C3!important;color:#FFFFFF!important}.nav-tag-pill-text[data-nav-tag=\"PRO+\"]{background-color:#055a8c!important}a:has(.nav-tag-pill) div:has(>div>span.nav-tag-pill){display:block}a:has(.nav-tag-pill) div:has(>div>span.nav-tag-pill)>div:last-child{display:inline-flex;vertical-align:middle;margin-left:0.375rem}"}],"page":{"pagePath":"contract-verification/common-verification-errors","slug":"/contract-verification/common-verification-errors","pageMetadata":{"title":"Common Verification Errors","description":"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.","href":"/contract-verification/common-verification-errors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`contract-doesn’t-match`,children:`Contract Doesn’t Match`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Compiled contract deployment bytecode does NOT match the transaction deployment bytecode”`})}),`\n`,_jsx(_components.p,{children:`The submitted source code does not match the contract code deployed on chain.`}),`\n`,_jsx(_components.p,{children:`Common causes include using a different compiler version or enabling optimisation runs.`}),`\n`,_jsxs(_components.p,{children:[`For an exact match to be found, both `,_jsx(`strong`,{children:`source code`}),` and `,_jsx(`strong`,{children:`compiler settings`}),` specified have to exactly match the deployment conditions, for the same bytecode to be reproduced.`]}),`\n`,_jsx(Heading,{level:`3`,id:`solidity-compilation-error`,children:`Solidity Compilation Error`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Solidity Compilation Error: Identifier not found or not unique”`})}),`\n`,_jsx(_components.p,{children:`A compilation issue occured due to syntax errors in your Solidity source code.`}),`\n`,_jsxs(_components.p,{children:[`Consider debugging your contract with any compiler such as `,_jsx(`a`,{href:`https://remix.ethereum.org/`,children:_jsx(`strong`,{children:`Remix`})}),` or `,_jsx(`a`,{href:`https://hardhat.org/`,children:_jsx(`strong`,{children:`Hardhat`})}),` and reference the error from Solidity’s `,_jsx(`a`,{href:`https://docs.soliditylang.org`,children:_jsx(`strong`,{children:`official documentation`})}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`contract-not-deployed`,children:`Contract Not Deployed`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Unable to locate ContractCode at 0x539a277b12a3f6723f4c1769edb11b0be7c214da”`})}),`\n`,_jsx(_components.p,{children:`The contract has not been deployed at the specific address at the specific chain.`}),`\n`,_jsxs(_components.p,{children:[`Check the contract address you’ve deployed, if your contract deployment transaction has succeeded or if the `,_jsx(_components.a,{href:`/supported-chains`,children:_jsx(_components.strong,{children:`chainId`})}),` specified is correct.`]}),`\n`,_jsxs(_components.p,{children:[`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, `,_jsx(_components.a,{href:`/resources/contact-us`,children:_jsx(_components.strong,{children:`ping us`})}),` if you’ve verified the contract is deployed with the Etherscan link.`]}),`\n`,_jsx(Heading,{level:`3`,id:`missing-or-invalid-library-names`,children:`Missing or Invalid Library Names`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Library was required but suitable match not found”`})}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(`a`,{href:`https://solidity-by-example.org/library/`,children:_jsx(`strong`,{children:`library`})}),` was used in your contract deployment, but was not specified, misspelt or using the wrong library address.`]}),`\n`,_jsxs(_components.p,{children:[`Double check on your library names ( `,_jsx(`strong`,{children:`case sensitive`}),` such as “PRBMath” ) or ensure that a matching library name and library address is provided.`]}),`\n`,_jsx(Heading,{level:`3`,id:`missing-contract-name`,children:`Missing Contract Name`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Unable to locate ContractName , did you specify the correct Contract Name ?”`})}),`\n`,_jsx(_components.p,{children:`A match was not found with the name of the contract specified when multiple files are provided.`}),`\n`,_jsxs(_components.p,{children:[`Ensure that you have provided the correct contract name to be matched against, and making sure you submit the `,_jsx(`strong`,{children:`main contract`}),` name not its dependencies.`]}),`\n`,_jsx(Heading,{level:`3`,id:`missing/invalid-constructor-arguments`,children:`Missing/Invalid Constructor Arguments`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Please check if the correct constructor argument was entered”`})}),`\n`,_jsxs(_components.p,{children:[`if your contract utilized the `,_jsx(_components.code,{children:`constructor`}),` keyword, you should provide it in hex format. Otherwise, leave this field empty as it is.`]}),`\n`,_jsxs(_components.p,{children:[`You may reference your original deployment’s constructor arguments or determine it from the `,_jsx(`a`,{href:`https://info.etherscan.com/contract-verification-constructor-arguments/`,children:_jsx(`strong`,{children:`end of your compiled bytecode`})}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`mismatched-bytecode-metadata-hash`,children:`Mismatched bytecode metadata hash`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Please check if the correct bytecodehash was specified via standard-json verification.”`})}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(`a`,{href:`https://docs.soliditylang.org/en/v0.8.17/metadata.html#encoding-of-the-metadata-hash-in-the-bytecode`,children:_jsx(`strong`,{children:`metadata hash`})}),` settings of your submitted source code differs from the settings of your original contract deployment, such as being set to `,_jsx(_components.code,{children:`ipfs`}),` or `,_jsx(_components.code,{children:`none`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Submit your contract verification using the solc json input format, and `,_jsx(`a`,{href:`https://github.com/PaulRBerg/hardhat-template/blob/f6406c4e7c9e23d5169b39fb11d528a975b678e6/hardhat.config.ts#L104`,children:_jsx(`strong`,{children:`specify the settings`})}),` accordingly there.`]}),`\n`,_jsxs(_components.p,{children:[`Other submission formats such as single file or multifile `,_jsx(`strong`,{children:`do not support`}),` changing this setting, and will use the compiler defaults.`]}),`\n`,_jsx(Heading,{level:`3`,id:`similar-match-found`,children:`Similar Match Found`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“This contract already Similar Matches the deployed ByteCode at 0x4200000000000000000000000000000000000042”`})}),`\n`,_jsxs(_components.p,{children:[`This error indicates that the contract has already been verified via `,_jsx(`a`,{href:`https://info.etherscan.com/types-of-contract-verification/`,children:_jsx(`strong`,{children:`Similar Match`})}),` to another contract.`]}),`\n`,_jsxs(_components.p,{children:[`Kindly `,_jsx(`a`,{href:`https://info.etherscan.com/update-on-similar-match-contract-verification/`,children:_jsx(`strong`,{children:`reach out`})}),` to us at this point of time to have this updated to Full Match if required.`]}),`\n`,_jsx(Heading,{level:`3`,id:`unsupported-solc-version`,children:`Unsupported Solc Version`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`“Invalid or not supported solc version, see `,_jsx(_components.a,{href:`https://etherscan.io/solcversions`,children:`https://etherscan.io/solcversions`}),` for list”`]})}),`\n`,_jsxs(_components.p,{children:[`This error is thrown when you specify to use an invalid or unsupported version of the Solidity Compiler ie. below `,_jsx(_components.code,{children:`v0.4.11-nightly.2017.3.15+`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Do `,_jsx(_components.a,{href:`/resources/contact-us`,children:_jsx(_components.strong,{children:`let us know`})}),` if you need to verify a contract below this supported version such as to prove you deployed the first NFT.`]}),`\n`,_jsx(Heading,{level:`3`,id:`source-code-already-verified`,children:`Source Code Already Verified`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Source code already verified”`})}),`\n`,_jsxs(_components.p,{children:[`An `,_jsx(`a`,{href:`https://info.etherscan.com/types-of-contract-verification/`,children:_jsx(`strong`,{children:`Exact Match`})}),` has been obtained, get back to having your `,_jsx(`a`,{href:`https://media.giphy.com/media/11ISwbgCxEzMyY/giphy.gif`,children:_jsx(`strong`,{children:`coffee`})}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If you think this might be a mistake, do check if you’ve submitted verification to the right `,_jsx(`strong`,{children:`explorer/chain`}),`, a contract that is verified on Etherscan is `,_jsx(`strong`,{children:`not automatically verified`}),` on other explorers.`]}),`\n`,_jsx(Heading,{level:`3`,id:`unsupported-file-import-callback`,children:`Unsupported File Import Callback`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“Source “@openzeppelin/contracts/ERC20.sol” not found: File import callback not supported”`})}),`\n`,_jsxs(_components.p,{children:[`This error is thrown when contracts reference imports from external sources, such as `,_jsx(`a`,{href:`https://docs.openzeppelin.com/`,children:_jsx(`strong`,{children:`OpenZeppelin`})}),` libraries or Github links.`]}),`\n`,_jsxs(_components.p,{children:[`Consider `,_jsx(`a`,{href:`https://hardhat.org/hardhat-runner/docs/advanced/flattening#flattening-your-contracts`,children:_jsx(`strong`,{children:`flattening`})}),` your source code into a single file, or use the Solidity Standard Json Input format that comes with tools such as `,_jsx(`a`,{href:`https://hardhat.org/hardhat-runner/docs/guides/verifying#verifying-your-contracts`,children:_jsx(`strong`,{children:`Hardhat`})}),` to resolve these external imports.`]}),`\n`,_jsx(Heading,{level:`3`,id:`temporary-error`,children:`Temporary Error`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`“This could be a temporary error, please retry or contact us (Error Code 10001/10002/10003)”`})}),`\n`,_jsxs(_components.p,{children:[`Something went wrong on our end, which could include downtime or `,_jsx(`a`,{href:`https://status.etherscan.io/`,children:_jsx(`strong`,{children:`maintenance`})}),` windows.`]}),`\n`,_jsxs(_components.p,{children:[`Please retry this in a while or `,_jsx(_components.a,{href:`/resources/contact-us`,children:_jsx(_components.strong,{children:`ping us`})}),` if this continues to persist.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Common Verification Errors","description":"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.","href":"/contract-verification/common-verification-errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Contract Doesn’t Match","slug":"contract-doesn’t-match","depth":3,"children":[]},{"title":"Solidity Compilation Error","slug":"solidity-compilation-error","depth":3,"children":[]},{"title":"Contract Not Deployed","slug":"contract-not-deployed","depth":3,"children":[]},{"title":"Missing or Invalid Library Names","slug":"missing-or-invalid-library-names","depth":3,"children":[]},{"title":"Missing Contract Name","slug":"missing-contract-name","depth":3,"children":[]},{"title":"Missing/Invalid Constructor Arguments","slug":"missing/invalid-constructor-arguments","depth":3,"children":[]},{"title":"Mismatched bytecode metadata hash","slug":"mismatched-bytecode-metadata-hash","depth":3,"children":[]},{"title":"Similar Match Found","slug":"similar-match-found","depth":3,"children":[]},{"title":"Unsupported Solc Version","slug":"unsupported-solc-version","depth":3,"children":[]},{"title":"Source Code Already Verified","slug":"source-code-already-verified","depth":3,"children":[]},{"title":"Unsupported File Import Callback","slug":"unsupported-file-import-callback","depth":3,"children":[]},{"title":"Temporary Error","slug":"temporary-error","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"etherscan","siteName":"Etherscan","title":"Common Verification Errors - Etherscan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-20T09:11:03.276Z","originalFileLocation":"contract-verification/common-verification-errors.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Etherscan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Common Verification Errors - Etherscan\">\u003cmeta data-mint-head property=\"og:description\" content=\"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Etherscan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.etherscan.io/contract-verification/common-verification-errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://etherscan.mintlify.app/_mintlify/api/og/v2?division=Contract+Verification\u0026amp;title=Common+Verification+Errors\u0026amp;description=Diagnose+and+fix+common+contract+verification+errors+like+bytecode+and+compiler+mismatches.\u0026amp;theme=508771c6adde6156ee350715\u0026amp;signature=f661a88ed2b81f0d41066d0b69b28924d35b6795dfc2ce0b176a8c4f647dd5c6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Common Verification Errors - Etherscan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://etherscan.mintlify.app/_mintlify/api/og/v2?division=Contract+Verification\u0026amp;title=Common+Verification+Errors\u0026amp;description=Diagnose+and+fix+common+contract+verification+errors+like+bytecode+and+compiler+mismatches.\u0026amp;theme=508771c6adde6156ee350715\u0026amp;signature=f661a88ed2b81f0d41066d0b69b28924d35b6795dfc2ce0b176a8c4f647dd5c6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Etherscan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0784C3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.etherscan.io/contract-verification/common-verification-errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/contract-verification/common-verification-errors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.etherscan.io/#organization\",\"name\":\"Etherscan\",\"url\":\"https://docs.etherscan.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-dark.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=4e966e2dc30e631ecd17c82d5445201f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.etherscan.io#website\",\"name\":\"Etherscan\",\"url\":\"https://docs.etherscan.io\",\"publisher\":{\"@id\":\"https://docs.etherscan.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.etherscan.io/contract-verification/common-verification-errors#webpage\",\"url\":\"https://docs.etherscan.io/contract-verification/common-verification-errors\",\"name\":\"Common Verification Errors\",\"description\":\"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\",\"dateModified\":\"2026-08-20T09:11:03.276Z\",\"isPartOf\":{\"@id\":\"https://docs.etherscan.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.etherscan.io/contract-verification/common-verification-errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.etherscan.io/contract-verification/common-verification-errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.etherscan.io/contract-verification/verify-with-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Contract Verification\",\"item\":\"https://docs.etherscan.io/contract-verification\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Common Verification Errors\",\"item\":\"https://docs.etherscan.io/contract-verification/common-verification-errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.etherscan.io/contract-verification/common-verification-errors#article\",\"headline\":\"Common Verification Errors\",\"name\":\"Common Verification Errors\",\"description\":\"Diagnose and fix common contract verification errors like bytecode and compiler mismatches.\",\"url\":\"https://docs.etherscan.io/contract-verification/common-verification-errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.etherscan.io/contract-verification/common-verification-errors#webpage\"},\"dateModified\":\"2026-08-20T09:11:03.276Z\",\"publisher\":{\"@id\":\"https://docs.etherscan.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.etherscan.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Etherscan\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Etherscan","nav":{"global":null,"tabs":[{"tab":"Overview","groups":[{"group":"Get Started","pages":[{"title":"Welcome to the Etherscan API","sidebarTitle":"Introduction","mode":"wide","href":"/introduction"},{"group":"API Basics","expanded":true,"pages":[{"title":"Set Up Your API Key","href":"/set-up-your-api-key"},{"title":"Make Your First Call","href":"/make-your-first-call"},{"title":"Rate Limits","href":"/rate-limits"},{"title":"Common Error Messages","href":"/common-error-messages"},{"title":"API Status","href":"/api-status"}]},{"title":"Supported Chains","mode":"wide","href":"/supported-chains"}]},{"group":"Guides","pages":[{"group":"Contract Verification","root":{"title":"Contract Verification","sidebarTitle":"Contract Verification","href":"/contract-verification"},"pages":[{"title":"Verify with the API","sidebarTitle":"Verify with the API","href":"/contract-verification/verify-with-api"},{"title":"Get Verified Source Code","sidebarTitle":"Get Verified Source Code","href":"/contract-verification/get-source-code"},{"title":"Verify with Foundry","href":"/contract-verification/verify-with-foundry"},{"title":"Verify with Hardhat","href":"/contract-verification/verify-with-hardhat"},{"title":"Verify with Remix","description":"Verify a smart contract on Etherscan using the Remix contract verification plugin.","href":"/contract-verification/verify-with-remix"},{"title":"Common Verification Errors","href":"/contract-verification/common-verification-errors"}]},{"group":"Endpoint Showcase","root":{"title":"Endpoint Showcase","description":"See which Etherscan API endpoints power each page on etherscan.io, so you can rebuild them.","mode":"wide","href":"/endpoint-showcase"},"pages":[{"title":"Address Page","sidebarTitle":"Address","mode":"wide","href":"/endpoint-showcase/address"},{"title":"Token Page","sidebarTitle":"Token","mode":"wide","href":"/endpoint-showcase/token"},{"title":"Block Page","sidebarTitle":"Block","mode":"wide","href":"/endpoint-showcase/block"},{"title":"Transaction Page","sidebarTitle":"Transaction","mode":"wide","href":"/endpoint-showcase/transaction"},{"title":"Gas Tracker","sidebarTitle":"Gas Tracker","mode":"wide","href":"/endpoint-showcase/gas-tracker"},{"title":"Contract Page","sidebarTitle":"Contract","mode":"wide","href":"/endpoint-showcase/contract"},{"title":"Charts and Stats","sidebarTitle":"Charts and Stats","mode":"wide","href":"/endpoint-showcase/charts-and-stats"}]},{"group":"Common Use Cases","root":{"title":"Common Use Cases","sidebarTitle":"Common Use Cases","href":"/common-use-cases"},"pages":[{"title":"Wallet and Portfolio","sidebarTitle":"Wallet and Portfolio","href":"/resources/wallet-and-portfolio"},{"title":"Tax and Accounting","sidebarTitle":"Tax and Accounting","href":"/resources/tax-and-accounting"},{"title":"Security and Compliance","sidebarTitle":"Security and Compliance","href":"/resources/security-and-compliance"},{"title":"Onchain Analytics and Research","sidebarTitle":"Onchain Analytics and Research","href":"/resources/analytics-and-research"}]},{"title":"Best Practices","href":"/resources/best-practices"}]},{"group":"Resources","pages":[{"title":"Contact Us","href":"/resources/contact-us"},{"title":"Useful Links","href":"/resources/useful-links"}]}]},{"tab":"Build with AI","pages":[{"title":"Build with AI","href":"/build-with-ai/introduction"}]},{"tab":"API Endpoints","pages":[{"title":"API Endpoints","href":"/endpoint-overview"}]},{"tab":"Etherscan Metadata","pages":[{"title":"Etherscan Metadata","href":"/metadata/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Common Verification Errors - Etherscan","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":[],"chunks":[]}