|
1 | 1 | --- |
2 | 2 | title: 'Connecting to Base' |
3 | | -description: Documentation about Base Mainnet and Base Testnet. This page covers network information for the Base network, including network names, descriptions, RPC endpoints, chain IDs, currency symbols, and block explorers. |
| 3 | +description: Network details and wallet setup for Base Mainnet, Base Testnet (Sepolia), and Base Vibenet. |
4 | 4 | --- |
5 | 5 |
|
6 | | -## Base Mainnet |
7 | | - |
8 | | -| Name | Value | |
9 | | -| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------ | |
10 | | -| Network Name | Base Mainnet | |
11 | | -| Description | The public mainnet for Base. | |
12 | | -| RPC Endpoint | [https://mainnet.base.org](https://mainnet.base.org)<br/>_Flashblocks-enabled. Rate limited and not for production systems._ | |
13 | | -| Chain ID | 8453 | |
14 | | -| Currency Symbol | ETH | |
15 | | -| Block Explorer | [https://base.blockscout.com/](https://base.blockscout.com/) | |
16 | | - |
17 | | -## Base Testnet (Sepolia) |
18 | | - |
19 | | -| Name | Value | |
20 | | -| :-------------------------- | :------------------------------------------------------------------------------------------------------------------------ | |
21 | | -| Network Name | Base Sepolia | |
22 | | -| Description | A public testnet for Base. | |
23 | | -| RPC Endpoint | [https://sepolia.base.org](https://sepolia.base.org)<br/>_Flashblocks-enabled. Rate limited and not for production systems._ | |
24 | | -| Chain ID | 84532 | |
25 | | -| Currency Symbol | ETH | |
26 | | -| Block Explorer | [https://sepolia-explorer.base.org](https://sepolia-explorer.base.org) | |
27 | | - |
28 | | -<Note> |
29 | | -L1 & L2 protocol and network-related smart contract deployments can be found on the [Base Contracts](/base-chain/network-information/base-contracts) page. |
30 | | -</Note> |
31 | | - |
| 6 | +export const AddToMetaMask = ({ chainId, chainName, rpcUrl, blockExplorer }) => { |
| 7 | + const addNetwork = async () => { |
| 8 | + if (typeof window === 'undefined' || !window.ethereum) { |
| 9 | + alert('MetaMask is not installed. Visit metamask.io to get started.'); |
| 10 | + return; |
| 11 | + } |
| 12 | + try { |
| 13 | + await window.ethereum.request({ |
| 14 | + method: 'wallet_addEthereumChain', |
| 15 | + params: [ |
| 16 | + { |
| 17 | + chainId: '0x' + Number(chainId).toString(16), |
| 18 | + chainName, |
| 19 | + nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 }, |
| 20 | + rpcUrls: [rpcUrl], |
| 21 | + blockExplorerUrls: [blockExplorer], |
| 22 | + }, |
| 23 | + ], |
| 24 | + }); |
| 25 | + } catch (error) { |
| 26 | + console.error('Failed to add network:', error); |
| 27 | + } |
| 28 | + }; |
| 29 | + return ( |
| 30 | + <button |
| 31 | + onClick={addNetwork} |
| 32 | + style={{ |
| 33 | + display: 'inline-flex', |
| 34 | + alignItems: 'center', |
| 35 | + padding: '8px 16px', |
| 36 | + backgroundColor: '#0052FF', |
| 37 | + color: 'white', |
| 38 | + border: 'none', |
| 39 | + borderRadius: '8px', |
| 40 | + cursor: 'pointer', |
| 41 | + fontWeight: 600, |
| 42 | + fontSize: '14px', |
| 43 | + }} |
| 44 | + > |
| 45 | + Add {chainName} |
| 46 | + </button> |
| 47 | + ); |
| 48 | +}; |
| 49 | + |
| 50 | +Base is an EVM-compatible Layer 2 network. Use the details below to connect your wallet or application. |
| 51 | + |
| 52 | +## Network details |
| 53 | + |
| 54 | +<Tabs> |
| 55 | + <Tab title="Mainnet"> |
| 56 | + | | | |
| 57 | + | :--- | :--- | |
| 58 | + | **Network Name** | Base Mainnet | |
| 59 | + | **RPC Endpoint** | [mainnet.base.org](https://mainnet.base.org) | |
| 60 | + | **Chain ID** | 8453 | |
| 61 | + | **Currency Symbol** | ETH | |
| 62 | + | **Block Explorer** | [basescan.org](https://basescan.org) | |
| 63 | + |
| 64 | + |
| 65 | + </Tab> |
| 66 | + <Tab title="Sepolia (Testnet)"> |
| 67 | + | | | |
| 68 | + | :--- | :--- | |
| 69 | + | **Network Name** | Base Sepolia | |
| 70 | + | **RPC Endpoint** | [sepolia.base.org](https://sepolia.base.org) | |
| 71 | + | **Chain ID** | 84532 | |
| 72 | + | **Currency Symbol** | ETH | |
| 73 | + | **Block Explorer** | [sepolia.basescan.org](https://sepolia.basescan.org) | |
| 74 | + |
| 75 | + |
| 76 | + </Tab> |
| 77 | + <Tab title="Vibenet"> |
| 78 | + Vibenet is Base's experimental preview network where new chain-level features are available before they roll out to Sepolia or Mainnet. It currently hosts [B20 tokens](/get-started/launch-b20-token) — an ERC-20 superset with built-in roles, supply caps, pausing, policy gating, and `permit` implemented as a native precompile. |
| 79 | + |
| 80 | + Use Vibenet to build against cutting-edge Base features. It is not intended for production or user-facing applications. Learn more at [vibes.base.org](https://vibes.base.org). |
| 81 | + |
| 82 | + | | | |
| 83 | + | :--- | :--- | |
| 84 | + | **Network Name** | Base Vibenet | |
| 85 | + | **RPC Endpoint** | [rpc.vibes.base.org](https://rpc.vibes.base.org) | |
| 86 | + | **Chain ID** | 84538453 | |
| 87 | + | **Currency Symbol** | ETH | |
| 88 | + | **Faucet** | [faucet.vibes.base.org](https://faucet.vibes.base.org) | |
| 89 | + | **Block Explorer** | [explorer.vibes.base.org](https://explorer.vibes.base.org) | |
| 90 | + |
| 91 | + </Tab> |
| 92 | +</Tabs> |
| 93 | + |
| 94 | +<Info> |
| 95 | +The public endpoints above are rate-limited and not suitable for production traffic. For production use, connect through a [node provider](/base-chain/node-operators/node-providers). |
| 96 | +</Info> |
32 | 97 |
|
33 | 98 | <Note> |
34 | | -For production systems, we recommend using a node from one of our [node partners](/base-chain/node-operators/node-providers), or [running your own Base node](/base-chain/node-operators/run-a-base-node). |
| 99 | +The public Base endpoints are **HTTP only**. WebSocket RPC connections (`eth_subscribe`, `newHeads`, `logs`) are not available on public Base endpoints — use a [node provider](/base-chain/node-operators/node-providers) such as Alchemy or QuickNode for WebSocket support. |
35 | 100 | </Note> |
36 | 101 |
|
37 | | -# Using Base with your wallet |
38 | | - |
39 | | -### Coinbase Wallet |
40 | | - |
41 | | -The [Coinbase Wallet](https://chrome.google.com/webstore/detail/coinbase-wallet-extension/hnfanknocfeofbddgcijnmhnfnkdnaad?hl=en) browser extension provides support for Base by default. |
42 | | - |
43 | | -To use Base with Coinbase Wallet: |
44 | | - |
45 | | -1. Open the Coinbase Wallet browser extension and log in to your account. |
46 | | -2. Connect to an app using Coinbase Wallet. |
47 | | -3. Open the network selection menu by clicking the network icon in the upper right-hand corner. |
48 | | -4. Select **Base**. |
49 | | - |
50 | | -Your active network should now be switched to Base. |
51 | | - |
52 | | - |
53 | | -### Other wallets |
54 | | - |
55 | | -Base can be added as a custom network to any EVM-compatible wallet (i.e. [MetaMask](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn)). |
56 | | - |
57 | | -#### MetaMask |
58 | | - |
59 | | -To add Base as a custom network to MetaMask: |
60 | | - |
61 | | -1. Open the MetaMask browser extension. |
62 | | -2. Open the network selection dropdown menu by clicking the dropdown button at the top of the extension. |
63 | | -3. Click the **Add network** button. |
64 | | -4. Click **Add a network manually**. |
65 | | -5. In the **Add a network manually** dialog that appears, enter the following information for Base mainnet: |
66 | | - |
67 | | - | Name | Value | |
68 | | - | :-------------- | :----------------------------------------------------------- | |
69 | | - | Network Name | Base Mainnet | |
70 | | - | Description | The public mainnet for Base. | |
71 | | - | RPC Endpoint | [https://mainnet.base.org](https://mainnet.base.org) | |
72 | | - | Chain ID | 8453 | |
73 | | - | Currency Symbol | ETH | |
74 | | - | Block Explorer | [https://base.blockscout.com/](https://base.blockscout.com/) | |
75 | | - |
76 | | -6. Tap the Save button to save Base as a network. |
77 | | - |
78 | | -You should now be able to connect to the Base by selecting it from the network selection dropdown menu. |
79 | | - |
80 | | - |
| 102 | +## Wallet setup |
81 | 103 |
|
82 | | -## Testnet |
| 104 | +<Tabs> |
| 105 | + <Tab title="Coinbase Wallet"> |
83 | 106 |
|
84 | | -#### Coinbase Wallet browser extension provides support for Base Sepolia testnet by default. |
| 107 | + [Coinbase Wallet](https://chrome.google.com/webstore/detail/coinbase-wallet-extension/hnfanknocfeofbddgcijnmhnfnkdnaad?hl=en) supports Base networks by default. |
85 | 108 |
|
86 | | -To use Base Sepolia with Coinbase Wallet: |
| 109 | + **Mainnet** |
87 | 110 |
|
88 | | -1. Open the Coinbase Wallet browser extension and log in to your account. |
89 | | -2. Connect to an app using Coinbase Wallet. |
90 | | -3. Open the network selection menu by clicking the network icon in the upper right-hand corner. |
91 | | -4. Click the **More networks** button. |
92 | | -5. Navigate to the **Testnets** tab. |
93 | | -6. Select **Base Sepolia**. |
| 111 | + 1. Open the Coinbase Wallet extension and log in. |
| 112 | + 2. Connect to your app. |
| 113 | + 3. Click the network icon in the upper right corner. |
| 114 | + 4. Select **Base**. |
94 | 115 |
|
95 | | -Your active network should now be switched to Base testnet. |
| 116 | + **Base Sepolia** |
96 | 117 |
|
97 | | -#### Other wallets |
| 118 | + 1. Open the Coinbase Wallet extension and log in. |
| 119 | + 2. Connect to your app. |
| 120 | + 3. Click the network icon in the upper right corner. |
| 121 | + 4. Click **More networks** and go to the **Testnets** tab. |
| 122 | + 5. Select **Base Sepolia**. |
98 | 123 |
|
99 | | -Base Sepolia can be added as a custom network to any EVM-compatible wallet (e.g., [MetaMask](https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn)). |
| 124 | + </Tab> |
| 125 | + <Tab title="MetaMask"> |
100 | 126 |
|
101 | | -#### MetaMask |
| 127 | + Click a button to automatically add a Base network to [MetaMask](https://metamask.io): |
102 | 128 |
|
103 | | -To add Base Sepolia as a custom network in MetaMask: |
| 129 | + <div style={{ display: 'flex', flexDirection: 'row', flexWrap: 'wrap', gap: '8px', marginTop: '12px' }}> |
| 130 | + <AddToMetaMask chainId="8453" chainName="Base Mainnet" rpcUrl="https://mainnet.base.org" blockExplorer="https://basescan.org" /> |
| 131 | + <AddToMetaMask chainId="84532" chainName="Base Sepolia" rpcUrl="https://sepolia.base.org" blockExplorer="https://sepolia.basescan.org" /> |
| 132 | + <AddToMetaMask chainId="84538453" chainName="Base Vibenet" rpcUrl="https://rpc.vibes.base.org" blockExplorer="https://explorer.vibes.base.org" /> |
| 133 | + </div> |
104 | 134 |
|
105 | | -1. Open the MetaMask browser extension. |
106 | | -2. Open the network selection dropdown menu by clicking the dropdown button at the top of the extension. |
107 | | -3. Click the **Add network** button. |
108 | | -4. Click **Add a network manually**. |
109 | | -5. In the **Add a network manually** dialog that appears, enter the following information for the Base Sepolia testnet: |
| 135 | + To add a network manually, use the details from the [Network details](#network-details) section above. |
110 | 136 |
|
111 | | - | Name | Sepolia | |
112 | | - | :-------------- | :--------------------------------------------------------------------- | |
113 | | - | Network Name | Base Sepolia | |
114 | | - | RPC Endpoint | [https://sepolia.base.org](https://sepolia.base.org) | |
115 | | - | Chain ID | 84532 | |
116 | | - | Currency Symbol | ETH | |
117 | | - | Block Explorer | [https://sepolia-explorer.base.org](https://sepolia-explorer.base.org) | |
| 137 | + </Tab> |
| 138 | + <Tab title="Other EVM wallets"> |
118 | 139 |
|
119 | | -6. Tap the Save button to save Base Sepolia as a network. |
| 140 | + Base can be added as a custom network to any EVM-compatible wallet. Use the connection details from the [Network details](#network-details) section above. |
120 | 141 |
|
121 | | -You should now be able to connect to the Base testnet by selecting it from the network selection dropdown menu. |
| 142 | + </Tab> |
| 143 | +</Tabs> |
0 commit comments