Skip to content

docs: add CCTP integration guide (attestation timing, Osaka/PUSH0, verification) - #431

Closed
osr21 wants to merge 1 commit into
circlefin:mainfrom
osr21:docs/cctp-attestation-timing
Closed

osr21 wants to merge 1 commit into
circlefin:mainfrom
osr21:docs/cctp-attestation-timing

Conversation

@osr21

@osr21 osr21 commented Sep 17, 2026

Copy link
Copy Markdown

Summary

Closes #428. Partially documents #425 and #427. Corrects the stale PUSH0 claim raised in #429.

Adds docs/cctp-integration.md — a developer-facing guide for integrating CCTP v2 on Arc Mainnet. The page collects information that is currently either absent or scattered across external sources and frequently causes support requests.

Contents

CCTP parameters

Canonical table of Arc Mainnet domain, chain ID, 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), why pending_confirmations + message: null is normal and not a failure, why calling reattest returns "already finalized", and what retry interval and max-wait to use. Includes a TypeScript polling example. Recommends fast finality when the application does not require finalized.

EVM compatibility (fixes #429)

Corrects the stale claim that Arc rejects PUSH0 (EIP-3855). Arc Mainnet is Osaka-active; PUSH0 is fully supported and evm_version = "paris" is no longer needed. Also notes the EIP-7825 gas cap (2²⁴) and its effect on eth_estimateGas/eth_call (partially documents #427).

Contract verification (documents #425)

Explains the Cloudflare WAF issue that blocks --verifier blockscout and shows the --verifier sourcify --skip-is-verified-check workaround that bypasses it.

…rification

Covers:
- Arc domain 26 finalized-finality attestation latency (2-6 hours, not minutes)
- Recommended retry pattern and fast-finality alternative
- PUSH0/Osaka EVM compatibility correction
- EIP-7825 gas cap note
- Sourcify-based contract verification workaround

Fixes circlefin#428, circlefin#429, partially documents circlefin#425 and circlefin#427
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Unsigned Commits Detected

The following commits are missing a verified signature:

  • f070db9 by osr21

How to fix: Sign your commits.

@github-actions

Copy link
Copy Markdown
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:

  1. Comment on issue Docs: CCTP domain 26 finalized-finality attestations take hours — undocumented latency and retry guidance #428 requesting assignment
  2. Wait for maintainer approval
  3. Only submit a PR after you have been assigned

Please see our CONTRIBUTING.md for more details.

@github-actions github-actions Bot closed this Sep 17, 2026
@osr21
osr21 deleted the docs/cctp-attestation-timing branch September 17, 2026 22:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

1 participant