Conversation
…rification) Covers: - Arc domain 26 finalized-finality attestation latency (2-6 hours, not minutes) and why pending_confirmations + message:null is not a failure - Recommended TypeScript polling pattern with 30s interval / 8h deadline - Fast-finality alternative for latency-sensitive applications - PUSH0/Osaka EVM compatibility correction (Arc Mainnet is Osaka-active; evm_version=paris workaround no longer needed) - EIP-7825 gas cap note (2^24 gas, -32003 on exceed) - Sourcify-based contract verification workaround for Cloudflare-blocked block explorer API Fixes circlefin#428, circlefin#429, partially documents circlefin#425 and circlefin#427
osr21
requested review from
ZhiyuCircle,
ancazamfir,
romac and
sergio-mena
as code owners
September 17, 2026 22:20
Contributor
|
Hi @osr21, Thank you for your interest in contributing to Arc Node. This PR has been automatically closed because you are not assigned to issue #428. We require contributors to be explicitly assigned to an issue before submitting a PR. To contribute properly:
Please see our CONTRIBUTING.md for more details. |
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
1 participant
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
Closes #428, #429. Partially documents #425 and #427.
Adds
docs/cctp-integration.md— a developer-facing integration guide collecting information that is currently absent from the repo and frequently causes support requests.Contents
CCTP parameters
Canonical table of Arc Mainnet domain (26), chain ID (5042), TOKEN_MESSENGER_V2, MESSAGE_TRANSMITTER_V2, and USDC addresses.
Attestation timing (fixes #428)
Explains that
finalized-finality attestations for Arc domain 26 take 2–6 hours (not seconds like other CCTP chains), whypending_confirmations+message: nullis normal and not a failure, why callingreattestreturns"already finalized"for burns that are real but not yet indexed, and what retry interval and max-wait to use. Includes a TypeScript polling example. Recommendsfastfinality for latency-sensitive applications.EVM compatibility (fixes #429)
Corrects the impression that Arc rejects
PUSH0(EIP-3855). Arc Mainnet is Osaka-active;PUSH0is fully supported andevm_version = "paris"workarounds are no longer needed. Also documents the EIP-7825 gas cap (2²⁴ = 16,777,216 gas) and its-32003error on exceed.Contract verification (documents #425)
Explains the Cloudflare WAF issue that blocks
--verifier blockscoutand shows the--verifier sourcify --skip-is-verified-checkworkaround.