Connect to Arc - Arc Docs

Connect a wallet to Arc using one-click setup or manual configuration.

Mainnet
Testnet

Wallet setup

Use the following button to add Arc Mainnet to your wallet automatically.

Manual setup

Arc uses USDC as the native gas token (18 decimals). If your wallet supports custom gas tokens, ensure display/decimals are set correctly. Wallets that don’t support custom gas tokens still work for signing and sending transactions; balances may display as “ETH” but the underlying token is USDC. See Gas and fees for details.

MetaMask
Rabby
Coinbase Wallet
Rainbow

Open network settings

Open MetaMask → Settings → Networks → Add network → Add a network manually.

Enter network details

Field	Value
Network name	Arc
New RPC URL	`https://rpc.mainnet.arc.io`
Chain ID	5042
Currency symbol	USDC
Explorer URL	`https://explorer.arc.io`

Save and switch

Click Save, then switch to Arc.

Open network settings

Open Rabby → click the network selector (top-left) → Add Custom Network.

Enter network details

Field	Value
Chain Name	Arc
Chain ID	5042
RPC URL	`https://rpc.mainnet.arc.io`
Currency	USDC
Block Explorer	`https://explorer.arc.io`

Confirm and switch

Click Confirm, then select Arc from the network list.

Open network settings

Open Coinbase Wallet → Settings → Networks → Add custom network.

Enter network details

Field	Value
Network name	Arc
RPC URL	`https://rpc.mainnet.arc.io`
Chain ID	5042
Currency symbol	USDC
Block explorer	`https://explorer.arc.io`

Save and switch

Click Save, then switch to Arc.

Open network settings

Open Rainbow → Settings (gear icon) → Networks → Custom Network.

Enter network details

Field	Value
Network name	Arc
RPC URL	`https://rpc.mainnet.arc.io`
Chain ID	5042
Symbol	USDC
Block explorer	`https://explorer.arc.io`

Save and switch

Click Save, then switch to Arc.

Any EVM-compatible wallet that supports adding a custom network works with . Use the network details below (Chain ID, RPC URL, currency symbol, and explorer) to add manually in wallets not listed above.

Network details

Parameter	Value
Chain ID	`5042`
Currency	USDC
Explorer	explorer.arc.io

RPC endpoints

https://rpc.mainnet.arc.io

https://arc-mainnet.g.alchemy.com/v2/YOUR_API_KEY

https://rpc.blockdaemon.mainnet.arc.io

https://rpc.drpc.mainnet.arc.io

https://rpc.quicknode.mainnet.arc.io

WebSocket endpoints

wss://arc-mainnet.g.alchemy.com/v2/YOUR_API_KEY

wss://rpc.blockdaemon.mainnet.arc.io/websocket

wss://rpc.quicknode.mainnet.arc.io

Wallet setup

Use the following button to add Arc Testnet to your wallet automatically.

Manual setup

MetaMask
Rabby
Coinbase Wallet
Rainbow

Open network settings

Open MetaMask → Settings → Networks → Add network → Add a network manually.

Enter network details

Field	Value
Network name	Arc Testnet
New RPC URL	`https://rpc.testnet.arc.io`
Chain ID	5042002
Currency symbol	USDC
Explorer URL	`https://explorer.testnet.arc.io`

Save and switch

Click Save, then switch to Arc Testnet.

Open network settings

Open Rabby → click the network selector (top-left) → Add Custom Network.

Enter network details

Field	Value
Chain Name	Arc Testnet
Chain ID	5042002
RPC URL	`https://rpc.testnet.arc.io`
Currency	USDC
Block Explorer	`https://explorer.testnet.arc.io`

Confirm and switch

Click Confirm, then select Arc Testnet from the network list.

Open network settings

Open Coinbase Wallet → Settings → Networks → Add custom network.

Enter network details

Field	Value
Network name	Arc Testnet
RPC URL	`https://rpc.testnet.arc.io`
Chain ID	5042002
Currency symbol	USDC
Block explorer	`https://explorer.testnet.arc.io`

Save and switch

Click Save, then switch to Arc Testnet.

Open network settings

Open Rainbow → Settings (gear icon) → Networks → Custom Network.

Enter network details

Field	Value
Network name	Arc Testnet
RPC URL	`https://rpc.testnet.arc.io`
Chain ID	5042002
Symbol	USDC
Block explorer	`https://explorer.testnet.arc.io`

Save and switch

Click Save, then switch to Arc Testnet.

Network details

Parameter	Value
Chain ID	`5042002`
Currency	USDC
Explorer	explorer.testnet.arc.io
Faucet	faucet.circle.com

RPC endpoints

https://rpc.testnet.arc.io

https://rpc.blockdaemon.testnet.arc.io

https://rpc.drpc.testnet.arc.io

https://rpc.quicknode.testnet.arc.io

WebSocket endpoints

wss://rpc.testnet.arc.io

wss://rpc.blockdaemon.testnet.arc.io:443/websocket

wss://rpc.drpc.testnet.arc.io

wss://rpc.quicknode.testnet.arc.io

Frontend wallet libraries

Use wagmi and viem to integrate Arc into ConnectKit, Reown AppKit, or a bare WalletConnect connector.

Don’t display native USDC and ERC-20 USDC as separate balance rows. They’re the same balance; always show a single USDC balance.

Chain definition

Mainnet
Testnet

viem ships Arc Mainnet as a built-in chain. No manual definition is needed.

import { arc } from "viem/chains";

viem ships Arc Testnet as a built-in chain. No manual definition is needed.

import { arcTestnet } from "viem/chains";

Configure wallet connection

Pick the tab that matches your setup.

ConnectKit
Reown AppKit
WalletConnect

npm install connectkit wagmi viem

import { arc, arcTestnet, mainnet } from "viem/chains";
import { createConfig, http } from "wagmi";
import { getDefaultConfig } from "connectkit";

const config = createConfig(
  getDefaultConfig({
    chains: [arc, arcTestnet, mainnet],
    transports: {
      [arc.id]: http("https://rpc.mainnet.arc.io"),
      [arcTestnet.id]: http("https://rpc.testnet.arc.io"),
      [mainnet.id]: http("https://cloudflare-eth.com"),
    },
    walletConnectProjectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID,
    appName: "Your App Name",
  }),
);

When mainnet is omitted from chains, ConnectKit falls back to its own eth.merkle.io endpoint for ENS name lookups, which blocks cross-origin browser requests. Include mainnet with a CORS-safe transport (such as the Cloudflare endpoint shown earlier) to prevent this.

npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viem @tanstack/react-query

Import defineChain from @reown/appkit/networks, not from viem. AppKit requires two additional fields (caipNetworkId and chainNamespace) that viem’s version omits; using the wrong import causes a runtime error.

import { defineChain } from "@reown/appkit/networks";
import { WagmiAdapter } from "@reown/appkit-adapter-wagmi";
import { createAppKit } from "@reown/appkit/react";

const projectId = process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID;

const arc = defineChain({
  id: 5042,
  caipNetworkId: "eip155:5042",
  chainNamespace: "eip155",
  name: "Arc",
  nativeCurrency: { decimals: 18, name: "USDC", symbol: "USDC" },
  rpcUrls: {
    default: {
      http: ["https://rpc.mainnet.arc.io"],
      webSocket: ["wss://rpc.quicknode.mainnet.arc.io"],
    },
  },
  blockExplorers: {
    default: { name: "Arc Explorer", url: "https://explorer.arc.io" },
  },
});

const arcTestnet = defineChain({
  id: 5042002,
  caipNetworkId: "eip155:5042002",
  chainNamespace: "eip155",
  name: "Arc Testnet",
  nativeCurrency: { decimals: 18, name: "USDC", symbol: "USDC" },
  rpcUrls: {
    default: {
      http: ["https://rpc.testnet.arc.io"],
      webSocket: ["wss://rpc.testnet.arc.io"],
    },
  },
  blockExplorers: {
    default: { name: "Block Explorer", url: "https://explorer.testnet.arc.io" },
  },
  testnet: true,
});

const wagmiAdapter = new WagmiAdapter({
  networks: [arc, arcTestnet],
  projectId,
});

createAppKit({
  adapters: [wagmiAdapter],
  networks: [arc, arcTestnet],
  projectId,
  metadata: {
    name: "Your App Name",
    description: "Your App Description",
    url: "https://yourdomain.com",
    icons: ["https://yourdomain.com/icon.png"],
  },
});

Get a project ID at dashboard.reown.com. The same project ID works for the bare WalletConnect connector.

For wagmi apps that need WalletConnect sessions without Reown AppKit’s full modal UI.

import { arc, arcTestnet } from "viem/chains";
import { createConfig, http } from "wagmi";
import { walletConnect } from "wagmi/connectors";

const config = createConfig({
  chains: [arc, arcTestnet],
  connectors: [
    walletConnect({
      projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID,
      metadata: {
        name: "Your App",
        description: "Your App Description",
        url: "https://yourdomain.com",
        icons: ["https://yourdomain.com/icon.png"],
      },
    }),
  ],
  transports: {
    [arc.id]: http("https://rpc.mainnet.arc.io"),
    [arcTestnet.id]: http("https://rpc.testnet.arc.io"),
  },
});

Arc Testnet (chain ID 5042002) is not registered in the WalletConnect chain registry. On first connection, WalletConnect issues a wallet_addEthereumChain call per user.

​Wallet setup

​Manual setup

​Network details

​RPC endpoints

​WebSocket endpoints

​Wallet setup

​Manual setup

​Network details

​RPC endpoints

​WebSocket endpoints

​Frontend wallet libraries

​Chain definition

​Configure wallet connection

Wallet setup

Manual setup

Network details

RPC endpoints

WebSocket endpoints

Wallet setup

Manual setup

Network details

RPC endpoints

WebSocket endpoints

Frontend wallet libraries

Chain definition

Configure wallet connection