Skip to main content

How to Add Custom Networks in Ronin Wallet (Mobile)

Updated

The Ronin Wallet allows users to connect to custom RPC networks for enhanced flexibility and control. This guide walks you through enabling Developer Mode and adding a Custom RPC network to your Ronin Mobile Wallet.

 

NOTE: The Custom RPC network enable is only available in the Ronin mobile wallet as of the time of writing. It will be available in the Ronin wallet extension in future updates.

 

Enabling Developer Mode

To add a custom RPC network, Developer Mode must first be enabled.

  1. Open the Ronin Mobile Wallet app.

  2. Navigate to Settings.
    IMG_6653.jpg

  3. Scroll down and select Developer Settings.
    IMG_6654.jpg

  4. Toggle Enable Dev-Mode to activate it.
    IMG_6655.png

 

Adding Custom RPC Network

Once Dev-mode is enabled, follow the steps below to add a Custom RPC.

  1. In the Settings > Developer Settings > Enable Dev-mode [toggled on], click on Custom RPC.
    IMG_6655.png

  2. Toggle Enable Custom RPC to allow adding custom networks.
    IMG_6656.png

  3. Tap on + Add more to open the Add Custom RPC page.
    IMG_6657.png

  4. Enter the following details:

    • Network Name: A descriptive name for the RPC network.

    • New RPC URL: The endpoint of the custom RPC server.
      Only trust custom networks from reliable sources to avoid risks. Malicious providers can falsify blockchain states and track your activity.

    • Chain ID: The unique identifier for the blockchain network.
      Adding a valid RPC URL will sometimes automatically input the Chain ID.

    • Currency Symbol: The native currency of the network (e.g., RON for Ronin, ETH for Ethereum).

    • Block Explorer URL (Optional): A URL to the block explorer for transaction tracking.

      IMG_6659.png
      In this example, let's try adding the Immutable Mainnet as custom RPC.

  5. Tap Add (or Save when editing) to finalize and add the custom RPC network.

  6. You should now be able to see the custom network in the available Switch Network options in the Ronin Wallet home page.

 

NOTE: Adding a network on one device does not mean it will appear on another device when accessing the same account. If you add it on your browser's Ronin wallet extension, it will not automatically be added to your Ronin Mobile app, and vice versa.

Additionally, custom networks will also need to be reconfigured if you reinstall your wallet.

 

Verifying the Connection

After adding the custom RPC, ensure it is working properly.

  1. Go to the Ronin wallet home page and switch to that network.
    IMG_6658.png

  2. Try sending a small transaction to confirm network functionality.

  3. If you encounter errors, proceed with the troubleshooting guide below.

 

Troubleshooting

If you encounter connection issues with your Custom RPC:

  1. Navigate to Settings > Developer Settings > Custom RPC.
    IMG_6660.png

  2. Check if the newly added network is listed in the CUSTOM RPC LIST.

  3. If edits are necessary, click on the pencil icon to start editing your custom RPC.
    - Ensure the RPC URL is correct and active.
    - Also double-check the Chain ID.

    Hit Save to finalize edits.

If transactions fail, re-verify the network settings and check the Block Explorer for errors.


In case you need further assistance, you may contact Ronin Support by submitting a ticket.

Related articles