Metamask setup

MetaMask is a popular browser extension that allows users to interact with blockchain applications. This guide shows you how to configure MetaMask to work with the Filecoin mainnet, Calibration testnet, or the Hyperspace testnet.

Using ChainList

Chainlist is a website that lets users easily connect their wallets to EVM-compatible blockchains. Chainlist is managed by DeFi Llama. Chainlist is the simplest way to add the Filecoin network to your MetaMask wallet.


  1. Search for Filecoin on chainlist.org.

  2. Click Connect Wallet.

  3. Click Approve when prompted to Allow this site to add a network.

  4. Click Switch network when prompted by MetaMask.

  5. Open MetaMask from the browser extensions tab.

  6. You should see Filecoin listed at the top.


  1. Go chainlist.org.

  2. Click the Include Testnets checkbox.

  3. Search for Filecoin Calibration.

  4. Click Connect Wallet.

  5. Click Approve when prompted to Allow this site to add a network.

  6. You may be shown a warning that you are connecting to a test network. If prompted, click Accept.

  7. Click Switch network when prompted by MetaMask.

  8. Open MetaMask from the browser extensions tab. You should see Filecoin Calibration listed at the top.


  1. Go chainlist.org.

  2. Click the Include Testnets checkbox.

  3. Search for Filecoin Hyperspace.

  4. Click Connect Wallet.

  5. Click Approve when prompted to Allow this site to add a network.

  6. You may be shown a warning that you are connecting to a test network. If prompted, click Accept.

  7. Click Switch network when prompted by MetaMask.

  8. Open MetaMask from the browser extensions tab. You should see Filecoin Hyperspace listed at the top.


  1. Go chainlist.org.

  2. Click the Include Testnets checkbox.

  3. Search for Filecoin Local testnet.

  4. Click Connect Wallet.

  5. Click Approve when prompted to Allow this site to add a network.

  6. You may be shown a warning that you are connecting to a test network. If prompted, click Accept.

  7. Click Switch network when prompted by MetaMask.

  8. Open MetaMask from the browser extensions tab. You should see Filecoin Local testnet listed at the top.

You can now use MetaMask to interact with the Filecoin network.

Manual process

If you can’t or don’t want to use Chainlist, you can add the Filecoin network to your MetaMask manually.

Prerequisites

Before we get started, you’ll need the following:

Steps

The process for configuring MetaMask to use Filecoin is fairly simple, but has some very specific variables that you must copy exactly.


  1. Open your browser and open the MetaMask plugin. If you haven’t opened the MetaMask plugin before, you’ll be prompted to create a new wallet. Follow the prompts to create a wallet.

  2. Click the user circle and select Settings:

  3. Select Networks.

  4. Click Add a network.

  5. Scroll down and click Add a network manually.

  6. Enter the following information into the fields:

    FieldValue
    Network nameFilecoin
    New RPC URLEither:
    - https://api.node.glif.io/rpc/v1
    - https://filecoin.chainup.net/rpc/v1
    - https://filecoin-mainnet.chainstacklabs.com/rpc/v1
    - https://infura.sftproject.io/filecoin/rpc/v1
    - https://rpc.ankr.com/filecoin
    Chain ID314
    Currency symbolFIL

  7. Pick one a block explorers, and enter the URL into the Block explorer (optional) field.

  8. Review the values in the fields and click Save.

  9. The Filecoin network should now be shown in your MetaMask window.

  10. Done!


  1. Open your browser and open the MetaMask plugin. If you haven’t opened the MetaMask plugin before, you’ll be prompted to create a new wallet. Follow the prompts to create a wallet.

  2. Click the user circle and select Settings:

  3. Select Networks.

  4. Click Add a network.

  5. Scroll down and click Add a network manually.

  6. Enter the following information into the fields:

    FieldValue
    Network nameFilecoin Calibration testnet
    New RPC URLEither:
    - https://api.calibration.node.glif.io/rpc/v1
    - https://filecoin-calibration.chainup.net/rpc/v1
    Chain ID314159
    Currency symbolFIL

  7. Pick one a block explorers, and enter the URL into the Block explorer (optional) field.

  8. Review the values in the fields and click Save.

  9. The Filecoin network should now be shown in your MetaMask window.

  10. Done!


  1. Open your browser and open the MetaMask plugin. If you haven’t opened the MetaMask plugin before, you’ll be prompted to create a new wallet. Follow the prompts to create a wallet.

  2. Click the user circle and select Settings:

  3. Select Networks.

  4. Click Add a network.

  5. Scroll down and click Add a network manually.

  6. Enter the following information into the fields:

    FieldValue
    Network nameFilecoin Hyperspace testnet
    New RPC URLEither:
    - https://api.calibration.node.glif.io/rpc/v1
    - https://filecoin-calibration.chainup.net/rpc/v1
    - https://filecoin-calibration.chainstacklabs.com/rpc/v1
    - https://rpc.ankr.com/filecoin_testnet
    Chain ID3141
    Currency symboltFIL

  7. Pick one a block explorers, and enter the URL into the Block explorer (optional) field.

  8. Review the values in the fields and click Save.

  9. The Filecoin network should now be shown in your MetaMask window.

  10. Done!


  1. Open your browser and open the MetaMask plugin. If you haven’t opened the MetaMask plugin before, you’ll be prompted to create a new wallet. Follow the prompts to create a wallet.

  2. Click the user circle and select Settings:

  3. Select Networks.

  4. Click Add a network.

  5. Scroll down and click Add a network manually.

  6. Enter the following information into the fields:

    FieldValue
    Network nameFilecoin Local testnet
    New RPC URLhttp://localhost:1234/rpc/v1
    Chain ID31415926
    Currency symboltFIL

  7. Pick one a block explorers, and enter the URL into the Block explorer (optional) field.

  8. Review the values in the fields and click Save.

  9. The Filecoin network should now be shown in your MetaMask window.

  10. Done!

You can now use MetaMask to interact with the Filecoin network.

Last updated on May 31, 2023
Edit this page on GitHub
← Wallets
Get FIL →