How to ask the metamask user to switch its network?

Question

Some web3 enabled websites ask you to switch your network on metamask. How can I do so? Some other websites also allow you to add a network you don't have (for example https://chainlist.org/). I would like to do it too. Example:

I am using react and web3 react (https://www.npmjs.com/package/web3-react), which means I am using ethers.js under the hood.

Thank you very much, Thomas

Answer 1

Here is an example how to make your website to ask the users so they can add and switch to the Matic network:

window.ethereum.request({
    method: "wallet_addEthereumChain",
    params: [{
        chainId: "0x89",
        rpcUrls: ["https://rpc-mainnet.matic.network/"],
        chainName: "Matic Mainnet",
        nativeCurrency: {
            name: "MATIC",
            symbol: "MATIC",
            decimals: 18
        },
        blockExplorerUrls: ["https://polygonscan.com/"]
    }]
});