docs(contracts): document Arcscan Etherscan-compatible contract verification - #396
Open
kutluhaneth46 wants to merge 1 commit into
Open
docs(contracts): document Arcscan Etherscan-compatible contract verification#396kutluhaneth46 wants to merge 1 commit into
kutluhaneth46 wants to merge 1 commit into
Conversation
kutluhaneth46
requested review from
ZhiyuCircle,
ancazamfir,
romac and
sergio-mena
as code owners
September 12, 2026 21:26
Explain why Blockscout-native verify field names return a misleading Missing codeformat error (circlefin#210), and document working Foundry/Hardhat flows against https://testnet.arcscan.app/api. Register arc_testnet in foundry.toml so forge verify-contract can target Arc Testnet.
kutluhaneth46
force-pushed
the
cursor/docs-arcscan-verify-api-88c1
branch
from
September 12, 2026 22:56
48e3111 to
dfe5885
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
/apiverify endpoint is Etherscan V1 compatible, not Blockscout-native. Requests that sendaddressHash/name/contractSourceCodeget a misleadingMissing codeformat fieldresponse even whencodeformatis present.https://testnet.arcscan.app/api.arc_testnetentry infoundry.tomlsoforge verify-contractcan target Arc Testnet.Verification
Reproduced both shapes against live Arcscan:
Also confirmed:
forge verify-contract 0x5294E9927c3306DcBaDb03fe70b92e01cCede505 \ contracts/src/memo/Memo.sol:Memo \ --chain 5042002 \ --verifier custom \ --verifier-url https://testnet.arcscan.app/api \ --verifier-api-key empty # -> already verified (end-to-end API path works)Notes
Hardhat still needs an
etherscan.customChainsentry for chain5042002(tracked separately if not yet onmain). This PR documents the requirement and lands the Foundry side.Test plan
forge verify-contractagainst genesis Memo reaches Arcscan successfullycontracts/README.md+foundry.toml[etherscan]entry