evm: use proxy etherscan by default for typegen cli #425

shestakoven · 2026-01-13T09:08:34Z

No description provided.

iankressin · 2026-01-13T14:38:38Z

evm/evm-typegen/src/main.ts

      )
      .option('--etherscan-api-key <key>', 'etherscan API key')
      .option(
        '--etherscan-chain-id <id>', 


we probably want to this param to simply be called --chain-id.

it doesn't make sense anymore to have the param prefixed with etherscan, since the user isn't exposed to anything related to it default anymore.

npx @subsquid/evm-typegen@latest ./src/abis/ 0x123...000 --chain-id 1

that said, I think we should also remove the prefixes from the other params as well for consistency, but explain in the addHelpText the CLI Ethers-compatible and show an example how to use it with Ethers' URL and API key

Good point, but I think it would be better do duplicate params for backwards compatibility and add deprecation warning. wdyt?

added --chain-id param

I think it would be better do duplicate params for backwards compatibility

we've added the --etherscan params very recently, I don't think it's necessary. @abernatskiy @belopash @mo4islona opinions?

I think we can do without --etherscan params. We just need to release a major version cause it's a breaking change, but I think that's fine.

These params would be useful for users who don't want to rely on our infra for any reason, but such users can just fetch ABI with cURL and use typegen on the file. So I think deprecating and removing this function is fine.

@abernatskiy I did it like '--etherscan-chain-id <id>, --chain-id <id>' to support both. ok or better to remove?

@abernatskiy I did it like '--etherscan-chain-id , --chain-id ' to support both

if --etherscan-chain-id produces a warning

Parameter --etherscan-chain-id is deprecated. Please use --chain-id instead

it is a great but temporary option allowing gradual user migration

But ofc it should throw an error if both specified

@mo4islona @iankressin @abernatskiy Approved?

belopash · 2026-01-16T18:18:33Z

If you are working in this direction then it should be not chain-id but just chain which accepts known chain names or chain ids. That is how, for example, forge works.

It's annoying to search for the chainId every time. I don't remember any chainId except mainnet (because it is 1, lol)

belopash · 2026-01-16T18:24:27Z

Also, I'm kinda skeptical to etherscan proxy idea in general. The one can abuse our proxy url and make service unavailable. We won't be able to do anything since there is no token.

Like simple cron that contantly consumes full rps limit by requesting random addresses

iankressin · 2026-01-16T20:58:09Z

The one can abuse our proxy url and make service unavailable. We won't be able to do anything since there is no token.

We do have caching and ip blacklisting which mitigates that to a certain extent. Also this service is not a mission critical component, and there's ways around it if we experience down time.

I don't think it's a problem for the time being.

iankressin · 2026-01-16T21:03:48Z

@shestakoven the PR is missing the changelog

Check out the Pull Request section of CONTRIBUTING.md

belopash · 2026-01-16T22:44:34Z

I don't think it's a problem for the time being.

It's not the problem but just one of the reasons why it is doubtful.

What are you doing here is basically transforming the whole tool for a specific use case but instead you can simply create an alias via package.json scripts and specify URL

belopash · 2026-01-16T22:47:11Z

evm/evm-typegen/src/main.ts

 ): Promise<any> {
-  let api = config.api + (config.api.endsWith('/') ? '' : '/') + 'api'
+  let api: string
+  if (config.api === PROXY_ETHERSCAN ) {


If I provide API token, it will try to use it with our proxy service but should fallback to default etherscan API

iankressin · 2026-01-20T12:13:53Z

you can simply create an alias via package.json scripts and specify URL

that would still require an Ethers' API key, which is the source of the bad UX

shestakoven · 2026-01-22T10:14:42Z

It's annoying to search for the chainId every time.

as for me it's more annoying to find how to pass it correctly: eth, ethereum, mainnet, eth-mainnet? everyone uses their own slugs and this is really annoying.

belopash · 2026-01-22T12:45:09Z

as for me it's more annoying to find how to pass it correctly: eth, ethereum, mainnet, eth-mainnet? everyone uses their own slugs and this is really annoying.

so why not to support all of them as other tools do?

shestakoven · 2026-01-22T12:48:19Z

so why not to support all?

because we'll need a resolver for all the chains from slug to chain-id, because etherscan api uses chain-id

belopash · 2026-01-22T12:52:00Z

because we'll need a resolver for all the chains from slug to chain-id, because etherscan api uses chain-id

and what is the problem?

{
  // ethereum
  'ethereum': 1,
  'mainnet': 1,
  'eth-mainnet': 1,
  'eth': 1,
  
  // arbitrum
  'arbitrum': ...
  ...
}

belopash · 2026-01-22T12:55:42Z

Here is a lsit of supported chains
https://docs.etherscan.io/supported-chains

I think we can ask AI to generate alises for them. Also supporting aliases doesn't mean that we don't support chain Ids, we should support both

evm/evm-typegen/src/main.ts

Copilot

Pull request overview

This pull request enhances the EVM typegen CLI tool to use an SQD Etherscan proxy service by default, adds support for named chain identifiers, and deprecates the --etherscan-chain-id option in favor of --chain-id.

Changes:

Switches default Etherscan API endpoint to SQD proxy service when no API key is provided
Adds comprehensive named chain identifier support (e.g., "ethereum", "polygon", "arbitrum") for ~70+ chains
Deprecates --etherscan-chain-id option in favor of --chain-id with backward compatibility

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
evm/evm-typegen/src/main.ts	Updates option handling, API endpoint selection logic, and URL normalization; adds deprecation warning for old option
evm/evm-typegen/src/chainIds.ts	New file containing comprehensive chain ID mappings and parsing logic with fuzzy matching for suggestions
evm/evm-typegen/package.json	Adds `fastest-levenshtein` dependency for fuzzy string matching
common/config/rush/pnpm-lock.yaml	Updates lock file with new dependencies and Solana package version upgrades
common/changes/@subsquid/evm-typegen/use-proxy-etherscan-for-typegen_2026-01-24-18-35.json	Changelog entry documenting the three main changes

Files not reviewed (1)

common/config/rush/pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

evm/evm-typegen/src/chainIds.ts

evm/evm-typegen/src/main.ts

evm/evm-typegen/src/chainIds.ts

evm/evm-typegen/src/main.ts

evm/evm-typegen/src/chainIds.ts

evm/evm-typegen/src/main.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

use proxy etherscan by default for typegen cli

8b48844

shestakoven requested review from iankressin and mo4islona January 13, 2026 09:08

iankressin reviewed Jan 13, 2026

View reviewed changes

shestakoven added 2 commits January 14, 2026 09:45

add chain-id param

def721b

add etherscan-chain-id deprecation warning

b216747

iankressin approved these changes Jan 16, 2026

View reviewed changes

belopash requested changes Jan 16, 2026

View reviewed changes

fallback to original etherscan api if apikey is provided

214a8c7

belopash requested changes Jan 22, 2026

View reviewed changes

evm/evm-typegen/src/main.ts Outdated Show resolved Hide resolved

belopash reviewed Jan 22, 2026

View reviewed changes

evm/evm-typegen/src/main.ts Outdated Show resolved Hide resolved

belopash added 3 commits January 24, 2026 21:34

fixes + chainId alias parsing

e2aa25c

changes

1aa6f4d

better chai-id option description

9b09226

belopash self-requested a review January 24, 2026 18:40

belopash changed the title ~~use proxy etherscan by default for typegen cli~~ evm: use proxy etherscan by default for typegen cli Jan 24, 2026

belopash approved these changes Jan 24, 2026

View reviewed changes

changes

324d6b6

mo4islona requested a review from Copilot January 26, 2026 08:40

Copilot started reviewing on behalf of mo4islona January 26, 2026 08:40 View session

Copilot AI reviewed Jan 26, 2026

View reviewed changes

belopash and others added 2 commits January 26, 2026 11:54

Apply suggestions from code review

d3d4b26

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

do not apply default value to chain-id option

2c8e5c5

belopash merged commit dff3a8f into master Jan 26, 2026
1 check failed

belopash deleted the use-proxy-etherscan-for-typegen branch January 26, 2026 08:59

evm: use proxy etherscan by default for typegen cli #425

evm: use proxy etherscan by default for typegen cli #425

Conversation

shestakoven commented Jan 13, 2026

Uh oh!

iankressin Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shestakoven Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

shestakoven Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

iankressin Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

abernatskiy Jan 14, 2026

Choose a reason for hiding this comment

Uh oh!

shestakoven Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mo4islona Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shestakoven Jan 15, 2026

Choose a reason for hiding this comment

Uh oh!

belopash commented Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

belopash commented Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

iankressin commented Jan 16, 2026

Uh oh!

iankressin commented Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

belopash commented Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

belopash Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shestakoven Jan 22, 2026

Choose a reason for hiding this comment

Uh oh!

iankressin commented Jan 20, 2026

Uh oh!

shestakoven commented Jan 22, 2026

Uh oh!

belopash commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

shestakoven commented Jan 22, 2026

Uh oh!

belopash commented Jan 22, 2026

Uh oh!

belopash commented Jan 22, 2026

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

iankressin Jan 13, 2026 •

edited

Loading

iankressin Jan 14, 2026 •

edited

Loading

shestakoven Jan 14, 2026 •

edited

Loading

mo4islona Jan 15, 2026 •

edited

Loading

belopash commented Jan 16, 2026 •

edited

Loading

belopash commented Jan 16, 2026 •

edited

Loading

iankressin commented Jan 16, 2026 •

edited

Loading

belopash commented Jan 16, 2026 •

edited

Loading

belopash Jan 16, 2026 •

edited

Loading

belopash commented Jan 22, 2026 •

edited

Loading