Merge pull request #125 from brave/update-builtin-custom-chains-docs

Update docs for built-in and custom EVM chains
brave · Aug 2, 2023 · ceacb91 · ceacb91
2 parents e661178 + 6c77ec0
commit ceacb91
Show file tree

Hide file tree

Showing 2 changed files with 29 additions and 11 deletions.
diff --git a/docs/ethereum/builtin-chains.md b/docs/ethereum/builtin-chains.md
@@ -4,12 +4,19 @@ sidebar_position: 2
 
 # Built-in chains
 
-Brave preloads the following chains by default.
+Brave preloads the following EVM chains by default. Unless otherwise specified,
+the entries in the table are mainnet chains.
 
-| Chain ID    | Name                 | Native currency |
-| ----------- | -------------------- | --------------- |
-| 0x1         | Ethereum Mainnet     | ETH             |
-| 0x3         | Ropsten Testnet      | ETH             |
-| 0x4         | Rinkeby Testnet      | ETH             |
-| 0x5         | Görli Testnet        | ETH             |
-| 0x2a        | Kovan Testnet        | ETH             |
+| Chain ID    | Name                               | Native currency |
+| ----------- | ---------------------------------- | --------------- |
+| 0x1         | Ethereum                           | ETH             |
+| 0x89        | Polygon                            | MATIC           |
+| 0x38        | BNB Smart Chain                    | BNB             |
+| 0xa86a      | Avalanche C-Chain                  | AVAX            |
+| 0x4e454152  | Aurora                             | ETH             |
+| 0xfa        | Fantom                             | FTM             |
+| 0xa         | Optimism                           | ETH             |
+| 0x13a       | Filecoin (FEVM)                    | FIL             |
+| 0x5         | Görli Testnet                      | ETH             |
+| 0xaa36a7    | Sepolia Testnet                    | ETH             |
+| 0x4cb2f     | Filecoin (EVM) Calibration Testnet | tFIL            |
diff --git a/docs/ethereum/custom-chains.md b/docs/ethereum/custom-chains.md
@@ -35,11 +35,22 @@ export const Add = ({children, chainId, decimals, symbol, chainName, rpcUrl, blo
   </span>
 );
 
-Other chains can be added to Brave through a site like
-[chainlist.org](https://chainlist.org)
+You can add custom networks by navigating to `brave://settings/wallet/networks`
+and clicking on the "Add" button. You can enter the network details manually or
+search through a list of networks sourced from [chainlist.org](https://chainlist.org).
+This list is updated on a daily basis and served through user data files of
+the browser.
 
+**Troubleshooting note:** Normally, a browser restart is enough to ensure that
+you're using the latest networks list, if not already the case. Alternatively,
+you can force-check for new updates by going to `brave://components` and
+clicking on "Check for update" under "Brave Wallet data files".
+
+You can also add custom chains through sites like [chainlist.org](https://chainlist.org).
+Examples of the UX for adding custom chains through external websites can be
+found below:
 
 | Chain ID    | Name                 | Native currency | Decimals | Add    |
 | ----------- | -------------------- | --------------- | -------- | ------ |
 | 0xa4b1      | Arbitrum One         | AETH            | 18       | <Add decimals={18} chainId='0xa4b1' symbol='AETH' chainName='Arbitrum One' rpcUrl='https://arb1.arbitrum.io/rpc' blockExplorerUrl='https://arbiscan.io' />
-| 0x14a33     | Base Goerli Testnet  | ETH             | 18       | <Add decimals={18} chainId='0x14a33' symbol='ETH' chainName='Base Goerli Testnet' rpcUrl='https://goerli.base.org' blockExplorerUrl='https://goerli.basescan.org' />
+| 0x2105      | Base                 | ETH             | 18       | <Add decimals={18} chainId='0x2105' symbol='ETH' chainName='Base' rpcUrl='https://mainnet.base.org' blockExplorerUrl='https://basescan.org' />