ethers.js icon indicating copy to clipboard operation
ethers.js copied to clipboard

etherscan v1 deprecation (deletion 08/15)

Open prunelsigma opened this issue 4 months ago • 1 comments

Ethers Version

5.8.0

Search Terms

etherscan api v2 deprecation

Describe the Problem

Hi,

It seems the V1 API of etherscan will be soon deprecated and removed at least that is what some recent email let us believe (below, even though we didn't get any warnings of this but that is another subject). https://docs.etherscan.io/etherscan-v2

Over the past few months, we've extended deadlines and sent multiple reminders to give everyone more time to switch to Etherscan API V2. API V1 will be fully deprecated by August 15, 2025. After that, all V1 requests will stop working.

It seems that v5 of ethers still uses the V1 API of etherscan and v1 chain endpoints so if our assumption is correct, it will likely stop working after 08/15.

We are currently using the v5.7.2 version of ethers (but the same issue will apply to 5.8.0) and it will be difficult for us to upgrade in such a short window.

Would be possible to apply the same kind of minor version patch applied here (for v6, https://github.com/ethers-io/ethers.js/issues/4975) ?

If time, or human resource is an issue, we could contribute to it.

Thank you in advance for your time.

Note:

  • It seems that some domain names will be changed (since the chain id is an argument now) https://docs.etherscan.io/etherscan-v2/getting-started/supported-endpoints

Code Snippet

# external `etherscan` V1 Api deletion, so not testable yet
# the code at issue https://github.com/ethers-io/ethers.js/blob/5ff3dc99101d7291e34012f1a45f0f28b43fade9/packages/providers/src.ts/etherscan-provider.ts#L170

Contract ABI


Errors


Environment

Ethereum (mainnet/ropsten/rinkeby/goerli)

Environment (Other)

No response

prunelsigma avatar Aug 05 '25 05:08 prunelsigma

Sorry for the late reply.

There isn't really a plan to make these sorts of changes to v5. The primary changes I'm focused on for the legacy version are security updates. I am always available to assist in upgrading to v6 though. Keep in mind v5 (at this point) is over 3 years old since any non-security update has been applied.

If this is something that is essential, ping me and we can discuss it further though. :)

ricmoo avatar Aug 19 '25 05:08 ricmoo