inkonchain / inkonchain/docs

This PR updates the “Verifying Your Contract” section in the Foundry deployment guide. Previously, the documentation referenced Etherscan verification using --etherscan-api-key while targeting the Ink Sepolia network, which uses Blockscout instead.

Open Beginner friendly
#609 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
MDX
Stars
36.5k
Forks
481
Avg merge
6h 16m
Merged PRs (30d)
12

Description

This PR updates the “Verifying Your Contract” section in the Foundry deployment guide. Previously, the documentation referenced Etherscan verification using --etherscan-api-key while targeting the Ink Sepolia network, which uses Blockscout instead.

This caused confusion and verification failures when developers attempted to verify contracts on Ink.

Changes:

Replaced all mentions of Etherscan with Blockscout.

Updated the example forge verify-contract command to use the proper Blockscout verifier flags: forge verify-contract <DEPLOYED_CONTRACT_ADDRESS> src/InkContract.sol:InkContract
--chain-id 763373
--verifier blockscout
--verifier-url https://explorer-sepolia.inkonchain.com/api
--verifier-api-key $BLOCKSCOUT_API_KEY

Clarified that the Ink Sepolia network is verified through Blockscout, not Etherscan.

Aligned environment variable names (INKSEPOLIA_RPC_URL instead of RPC_URL) for consistency with Foundry profiles.

Why:

Etherscan and Blockscout use different APIs and are not interchangeable. Ink’s Sepolia network is powered by Blockscout, so verification must target its API endpoint (https://explorer-sepolia.inkonchain.com/api). Without this fix, forge verify-contract fails with an “unsupported chain” error.

Originally posted by @HarleyQeen in https://github.com/inkonchain/docs/pull/572

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the Foundry deployment guide and its “Verifying Your Contract” section. Check all Etherscan references and the example forge verify-contract command, then update them for Blockscout, including the Ink Sepolia verifier URL, API key, and INKSEPOLIA_RPC_URL naming. Done means the section consistently describes Blockscout verification and the command targets chain ID 763373.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
74/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.