Skip to content

docs: clarify Arc Testnet chain ID is 5042002, not 1516#148

Open
memosr wants to merge 3 commits into
circlefin:mainfrom
memosr:fix/testnet-chain-id
Open

docs: clarify Arc Testnet chain ID is 5042002, not 1516#148
memosr wants to merge 3 commits into
circlefin:mainfrom
memosr:fix/testnet-chain-id

Conversation

@memosr

@memosr memosr commented Jun 14, 2026

Copy link
Copy Markdown

Closes #94.
Fixes #81.

Summary

Arc Testnet's chain ID is 5042002 (0x4cef52), but some third-party chain registries and older community guides circulate the incorrect value 1516, causing wallet connection failures. Separately, several Arc Testnet block explorer URLs that circulate in external guides and wallet configs are dead (unreachable / login-gated).

Note: this repo's code and config were already consistent on 5042002, and contained no dead explorer URLs — both bad values circulate outside this repo. The gap was the lack of a clear, discoverable network reference for people setting up wallets/tooling. This PR adds one.

Changes

Out of scope

Issue #94 also suggests submitting a PR to ethereum-lists/chains, and #81's remaining fixes live in third-party registries / MetaMask guides. Those are external registries, separate from this repo.

Test plan

  • README renders correctly on GitHub (tables + callouts)
  • Chain IDs match crates/shared/src/chain_ids.rs

memosr added 2 commits June 14, 2026 22:42
Add a Networks section to the README documenting Arc's official chain
IDs and the correct wallet configuration for Arc Testnet, with a
prominent note that the incorrectly-circulated value 1516 is wrong.

Fixes circlefin#94
Document that testnet.arcscan.app and docs.arc.network are the canonical
Arc Testnet explorer and docs, and that the dead explorer.testnet.arc.network,
explorer.arc.io, and docs.arc.io URLs should not be used.

Fixes circlefin#81
…laim

docs.arc.io is the live canonical docs host (docs.arc.network 301-redirects
to it), so it does not belong in the dead-URL list. Keep the note focused on
the block explorer: testnet.arcscan.app is canonical; explorer.testnet.arc.network
(unreachable) and explorer.arc.io (team-login-gated) are not publicly usable.
@osr21

osr21 commented Jun 27, 2026

Copy link
Copy Markdown

Confirming 5042002 — also documenting the USDC-as-native-gas decimal trap

We've been running on Chain ID 5042002 (0x4cef52) throughout our DApp development without issues, confirming the corrected value.

One additional nuance that trips up first-time Arc wallet integrations beyond the chain ID confusion:

The nativeCurrency.decimals: 18 requirement

When registering Arc via wallet_addEthereumChain, nativeCurrency.decimals must be 18, not 6 — even though USDC is a 6-decimal ERC-20 at 0x3600000000000000000000000000000000000000. The EVM gas layer uses 18-decimal wei units. Setting decimals: 6 causes MetaMask to show gas costs 10^12× too high.

// Correct wallet_addEthereumChain params for Arc Testnet
{
  chainId: '0x4cef52',   // 5042002
  chainName: 'Arc Testnet',
  nativeCurrency: { name: 'USDC', symbol: 'USDC', decimals: 18 }, // 18, NOT 6
  rpcUrls: ['https://rpc.testnet.arc.network'],
  blockExplorerUrls: ['https://testnet.arcscan.app'],
}

Full Arc Testnet reference (for anyone landing here)

Item Value
Chain ID 5042002 (0x4cef52)
RPC https://rpc.testnet.arc.network
Explorer https://testnet.arcscan.app
USDC ERC-20 0x3600000000000000000000000000000000000000
EURC ERC-20 0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a
nativeCurrency.decimals (for wallet registration) 18
CCTP Domain ID 26
TokenMessengerV2 0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA
MessageTransmitterV2 0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275
minFinalityThreshold for CCTP v2 2000

Source: wallet.tsx + contracts.ts

@memosr

memosr commented Jun 27, 2026

Copy link
Copy Markdown
Author

Thanks @osr21
And the decimals: 18 point is the important one to surface here. It's the flip side of the same USDC dual-view: USDC is a 6-decimal ERC-20 at 0x3600…0000, but the native gas layer denominates in 18-decimal (wei-equivalent) units, so nativeCurrency.decimals has to be 18. Set it to 6 and the wallet misreads the raw value and shows gas ~10^12× too high - exactly what you hit.

Independently checked the rest of your table against Circle's references earlier and it lines up: chain ID 5042002 / 0x4cef52, USDC at 0x3600…0000, CCTP domain 26, and the V2 TokenMessenger/MessageTransmitter addresses. Handy to have it all in one place for anyone landing on this PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants