Connect MetaMask to the XRPL EVM Sidechain

Attention

The XRPL EVM compatible sidechain implementation is a proof of concept extension to the XRP Ledger protocol and is for development purposes only. There is no official amendment currently and it is not available on the production Mainnet. The EVM compatible sidechain bridge is connected to the XRP Ledger Devnet. Do not send transactions in Mainnet.

MetaMask is an extension for accessing Harmony-enabled distributed applications (dapps) from your browser. The extension injects the XRPL EVM sidechain Web3 API into every website's Javascript context, so that Web3 applications can read from the blockchain.

This tutorial walks through the process of installing MetaMask, configuring it on the XRPL EVM sidechain network, and importing an existing account using a previously generated private key.

1. Installing MetaMask

Install the MetaMask extension on your browser from https://metamask.io/download/. The extension supports most desktop browsers.

2. Create an Account on MetaMask

To create a new account on MetaMask:

  1. Click the MetaMask icon.

    Create an account on MetaMask

  2. Choose Create Account.

  3. Enter the Account Name.

  4. Click Create.

3. Adding XRPL EVM Sidechain to MetaMask

To add XRPL EVM Sidechain to MetaMask:

  1. Open the MetaMask extension.

  2. Use the drop-down menu to choose Add Network. Add the EVM Sidechain network to MetaMask

  3. Enter the XRP Ledger Devnet endpoint information.

    • Network Name: XRPL EVM Sidechain Devnet
    • New RPC URL: https://rpc-evm-sidechain.xrpl.org
    • Chain ID: 1440002
    • Currency Symbol: XRP
    • Block Explorer: https://explorer.xrplevm.org/