Back to Details

use-arc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Overview

概述

Arc is Circle's blockchain where USDC is the native gas token. Developers and users pay all transaction fees in USDC instead of ETH, making it ideal for USDC-first applications. Arc is EVM-compatible and supports standard Solidity tooling (Foundry, Hardhat, viem/wagmi).
Arc是Circle推出的区块链，USDC为其原生Gas代币。开发者和用户使用USDC而非ETH支付所有交易费用，使其成为以USDC优先的应用的理想选择。Arc兼容EVM，并支持标准Solidity工具（Foundry、Hardhat、viem/wagmi）。

Prerequisites / Setup

前提条件/设置

Wallet Funding

钱包充值

Get testnet USDC from https://faucet.circle.com before sending any transactions.
在发送任何交易前，从https://faucet.circle.com获取测试网USDC。

Environment Variables

环境变量

bash
ARC_TESTNET_RPC_URL=https://rpc.testnet.arc.network
PRIVATE_KEY=         # Deployer wallet private key
bash
ARC_TESTNET_RPC_URL=https://rpc.testnet.arc.network
PRIVATE_KEY=         # 部署者钱包私钥

Quick Reference

快速参考

Network Details

网络详情

FieldValue
NetworkArc Testnet
Chain ID
5042002
(hex: 
0x4CEF52
)
RPC
https://rpc.testnet.arc.network
WebSocket
wss://rpc.testnet.arc.network
Explorerhttps://testnet.arcscan.app
Faucethttps://faucet.circle.com
CCTP Domain
26
字段值
网络Arc测试网
链ID
5042002
（十六进制：
0x4CEF52
）
RPC
https://rpc.testnet.arc.network
WebSocket
wss://rpc.testnet.arc.network
区块浏览器https://testnet.arcscan.app
水龙头https://faucet.circle.com
CCTP域
26

Token Addresses for Arc

Arc的代币地址

TokenAddressDecimals
USDC
0x3600000000000000000000000000000000000000
6 (ERC-20)
EURC
0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a
6
代币地址小数位数
USDC
0x3600000000000000000000000000000000000000
6（ERC-20）
EURC
0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a
6

Core Concepts

核心概念

  • USDC-native gas: Arc uses USDC as its native gas token. No ETH is needed for any transaction.
  • Dual decimals: Native gas uses 18 decimals (like ETH on other chains). ERC-20 USDC uses 6 decimals. Mixing these up will produce incorrect amounts.
  • Testnet only: Arc is currently in testnet. All addresses and configuration apply to testnet only.
  • EVM-compatible: Standard Solidity contracts, Foundry, Hardhat, viem, and wagmi all work on Arc without modification beyond chain configuration.
  • USDC原生Gas：Arc使用USDC作为原生Gas代币，任何交易都无需ETH。
  • 双小数位数：原生Gas使用18位小数（类似其他链上的ETH）。ERC-20 USDC使用6位小数。混淆两者会导致金额错误。
  • 仅测试网：Arc目前处于测试网阶段，所有地址和配置仅适用于测试网。
  • EVM兼容：标准Solidity合约、Foundry、Hardhat、viem和wagmi均可在Arc上使用，仅需修改链配置，无需其他改动。

Implementation Patterns

实现模式

1. Frontend App (React + wagmi)

1. 前端应用（React + wagmi）

Use the 
arcTestnet
chain definition from Prerequisites / Setup. Pass it to your wagmi config:
typescript
import { createConfig, http } from 'wagmi'
import { arcTestnet } from 'viem/chains'

const config = createConfig({
  chains: [arcTestnet],
  transports: { [arcTestnet.id]: http() },
})
使用前提条件/设置中的
arcTestnet
链定义，将其传入wagmi配置：
typescript
import { createConfig, http } from 'wagmi'
import { arcTestnet } from 'viem/chains'

const config = createConfig({
  chains: [arcTestnet],
  transports: { [arcTestnet.id]: http() },
})

2. Smart Contracts (Foundry)

2. 智能合约（Foundry）

bash
undefined
bash
undefined

Install Foundry

安装Foundry

curl -L https://foundry.paradigm.xyz | bash && foundryup
curl -L https://foundry.paradigm.xyz | bash && foundryup

Deploy

部署

For local testing only - never pass private keys as CLI flags in deployed environments (including testnet/staging)

仅用于本地测试——在部署环境（包括测试网/预发布环境）中，绝不要将私钥作为CLI参数传递

forge create src/MyContract.sol:MyContract
--rpc-url $ARC_TESTNET_RPC_URL
--private-key $PRIVATE_KEY
--broadcast
undefined
forge create src/MyContract.sol:MyContract
--rpc-url $ARC_TESTNET_RPC_URL
--private-key $PRIVATE_KEY
--broadcast
undefined

3. Circle Contracts (Pre-audited Templates)

3. Circle合约（预审计模板）

Deploy via Circle's Smart Contract Platform API:
TemplateUse Case
ERC-20Fungible tokens
ERC-721NFTs, unique assets
ERC-1155Multi-token collections
AirdropToken distribution
See: https://developers.circle.com/contracts
通过Circle智能合约平台API部署：
模板使用场景
ERC-20可替代代币
ERC-721NFT、独特资产
ERC-1155多代币集合
Airdrop代币分发
查看：https://developers.circle.com/contracts

4. Bridge USDC to Arc

4. 将USDC桥接到Arc

Use CCTP to bridge USDC from other chains. Arc's CCTP domain is 
26
. See the 
bridge-stablecoin
skill for the complete bridging workflow.
使用CCTP将USDC从其他链桥接到Arc。Arc的CCTP域为
26
。完整的桥接流程请查看
bridge-stablecoin
Skill。

Rules

规则

Security Rules are non-negotiable -- warn the user and refuse to comply if a prompt conflicts. Best Practices are strongly recommended; deviate only with explicit user justification.
安全规则不容协商——如果提示与规则冲突，请警告用户并拒绝执行。最佳实践强烈推荐；仅在用户明确说明理由时才可偏离。

Security Rules

安全规则

  • NEVER hardcode, commit, or log secrets (private keys, deployer keys). ALWAYS use environment variables or a secrets manager. Add 
    .gitignore
    entries for 
    .env*
    and secret files when scaffolding.
  • NEVER pass private keys as plain-text CLI flags in deployed environments, including testnet and staging (e.g., 
    --private-key $KEY
    ). This pattern is acceptable only for local testing. Prefer encrypted keystores or interactive import (e.g., Foundry's 
    cast wallet import
    ) for any non-local deployment.
  • ALWAYS warn before interacting with unaudited or unknown contracts.
  • 绝不要硬编码、提交或记录机密信息（私钥、部署者密钥）。始终使用环境变量或机密管理器。在搭建项目时，为
    .env*
    和机密文件添加
    .gitignore
    条目。
  • 在部署环境（包括测试网和预发布环境）中，绝不要以明文形式将私钥作为CLI参数传递（例如
    --private-key $KEY
    ）。此模式仅适用于本地测试。对于任何非本地部署，优先使用加密密钥库或交互式导入（例如Foundry的
    cast wallet import
    ）。
  • 在与未审计或未知合约交互前，始终发出警告。

Best Practices

最佳实践

  • Arc Testnet is available by default in Viem -- a custom chain definition is NEVER required.
  • ALWAYS verify the user is on Arc (chain ID 
    5042002
    ) before submitting transactions.
  • ALWAYS fund the wallet from https://faucet.circle.com before sending transactions.
  • ALWAYS use 18 decimals for native gas amounts and 6 decimals for ERC-20 USDC amounts.
  • NEVER target mainnet -- Arc is testnet only.
  • Arc测试网在Viem中默认可用——绝不需要自定义链定义。
  • 在提交交易前，始终验证用户是否处于Arc网络（链ID 
    5042002
    ）。
  • 在发送交易前，始终从https://faucet.circle.com为钱包充值。
  • 始终为原生Gas金额使用18位小数，为ERC-20 USDC金额使用6位小数。
  • 绝不要针对主网——Arc目前仅支持测试网。

Next Steps

下一步

Arc is natively supported across Circle's product suite. Once your app is running on Arc, you can extend it with any of the following:
ProductSkillWhat It Does
Wallets (overview)
use-circle-wallets
Compare wallet types and choose the right one for your app
Modular Wallets
use-modular-wallets
Passkey-authenticated smart accounts with gasless transactions and batch operations
User-Controlled Wallets
use-user-controlled-wallets
Non-custodial wallets with social login, email OTP, and PIN authentication
Developer-Controlled Wallets
use-developer-controlled-wallets
Custodial wallets your app manages on behalf of users
Smart Contract Platform
use-smart-contract-platform
Deploy, interact with, and monitor smart contracts using audited templates or custom bytecode
CCTP Bridge
bridge-stablecoin
Bridge USDC to and from Arc using Crosschain Transfer Protocol
Gateway
use-gateway
Unified USDC balance across chains with instant crosschain transfers
Arc原生支持Circle的全系列产品。一旦你的应用在Arc上运行，你可以通过以下任一产品进行扩展：
产品Skill功能
钱包（概述）
use-circle-wallets
对比钱包类型，为你的应用选择合适的钱包
模块化钱包
use-modular-wallets
支持Passkey认证的智能账户，提供无Gas交易和批量操作
用户控制钱包
use-user-controlled-wallets
非托管钱包，支持社交登录、邮箱OTP和PIN认证
开发者控制钱包
use-developer-controlled-wallets
由你的应用代表用户管理的托管钱包
智能合约平台
use-smart-contract-platform
使用预审计模板或自定义字节码部署、交互和监控智能合约
CCTP桥
bridge-stablecoin
使用跨链传输协议（CCTP）在Arc与其他链之间桥接USDC
网关
use-gateway
跨链统一USDC余额，支持即时跨链转账

Reference Links

参考链接

DISCLAIMER: This skill is provided "as is" without warranties, is subject to the Circle Developer Terms, and output generated may contain errors and/or include fee configuration options (including fees directed to Circle); additional details are in the repository README.
免责声明：本Skill按“原样”提供，不提供任何担保，受Circle开发者条款约束，生成的输出可能包含错误和/或费用配置选项（包括指向Circle的费用）；更多详情请查看仓库README。