# Metamask setup

## Using ChainID

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

{% tabs %}
{% tab title="Mainnet" %}

1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Mainnet`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to *Allow this site to add a network*.
5. Click **Switch network** when prompted by MetaMask.
6. Open MetaMask from the browser extensions tab.
7. You should see *Filecoin* listed at the top.

You can now use MetaMask to interact with the Filecoin network.
{% endtab %}

{% tab title="Calibration" %}

1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Calibration`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to *Allow this site to add a network*.
5. You may be shown a warning that you are connecting to a test network. If prompted, click **Accept**.
6. Click **Switch network** when prompted by MetaMask.
7. Open MetaMask from the browser extensions tab. You should see *Filecoin Calibration* listed at the top.

You can now use MetaMask to interact with the Filecoin network.
{% endtab %}

{% tab title="Local testnet" %}

1. Navigate to [chainid.network](https://chainid.network).
2. Search for `Filecoin Local testnet`.
3. Click **Connect Wallet**.
4. Click **Approve** when prompted to *Allow this site to add a network*.
5. You may be shown a warning that you are connecting to a test network. If prompted, click **Accept**.
6. Click **Switch network** when prompted by MetaMask.
7. 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.
{% endtab %}
{% endtabs %}

## Manual process

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

### Prerequisites

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

* A [Chromium-based browser](https://en.wikipedia.org/wiki/Chromium_web_browser#Browsers_based_on_Chromium), or [Firefox](https://www.mozilla.org/en-CA/firefox/products/).
* A browser with [MetaMask](https://metamask.io/) installed.

### 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:

{% tabs %}
{% tab title="Mainnet" %}

<table><thead><tr><th width="159">Field</th><th>Value</th></tr></thead><tbody><tr><td>Network name</td><td><code>Filecoin</code></td></tr><tr><td>New RPC URL</td><td>Either:<br>- <code>https://api.node.glif.io/rpc/v1</code><br>- <code>https://filecoin.chainup.net/rpc/v1</code><br>- <code>https://rpc.ankr.com/filecoin</code></td></tr><tr><td>Chain ID</td><td><code>314</code></td></tr><tr><td>Currency symbol</td><td><code>FIL</code></td></tr></tbody></table>
{% endtab %}

{% tab title="Calibration" %}

<table><thead><tr><th width="176">Field</th><th>Value</th></tr></thead><tbody><tr><td>Network name</td><td><code>Filecoin Calibration testnet</code></td></tr><tr><td>New RPC URL</td><td>Either:<br>- <code>https://api.calibration.node.glif.io/rpc/v1</code><br>- <code>https://filecoin-calibration.chainup.net/rpc/v1</code></td></tr><tr><td>Chain ID</td><td><code>314159</code></td></tr><tr><td>Currency symbol</td><td><code>tFIL</code></td></tr></tbody></table>
{% endtab %}

{% tab title="Local testnet" %}

<table><thead><tr><th width="201">Field</th><th>Value</th></tr></thead><tbody><tr><td>Network name</td><td><code>Filecoin Local testnet</code></td></tr><tr><td>New RPC URL</td><td><code>http://localhost:1234/rpc/v1</code></td></tr><tr><td>Chain ID</td><td><code>31415926</code></td></tr><tr><td>Currency symbol</td><td><code>tFIL</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

7. Pick one block explorer from the [Networks section](https://docs.filecoin.io/networks/mainnet), 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.

## Ledger hardware wallet

MetaMask is compatible with the Ledger hardware wallet. There are 2 options for Ledger apps that support Filecoin:

* **Filecoin Ledger App** - compatible with MetaMask or the [Glif.io](https://glif.io/en/wallet) wallet
* **Ethereum Ledger App** - ***currently deprecated*** for Filecoin as of v1.15.0 (previous versions will work) until Ledger releases their upcoming Dynamic Networks feature

#### Note on Filecoin EVM vs Filecoin Native addresses

Note that MetaMask supports Filecoin EVM addresses that follow the Ethereum `0x` format (see [this section](https://docs.filecoin.io/basics/assets/transfer-fil) for more info on address types). To use native Filecoin address types that begin with `f`, you can use:

* [Glif.io](https://glif.io/en/wallet) wallet (also compatible with the Filecoin Ledger App),
* Ledger Live and the Filecoin Ledger App or
* [Filecoin MetaMask Wallet](https://snaps.metamask.io/snap/npm/filsnap/) installable from the right menu in Metamask under *Snaps*

Some exchanges only support specific address types (see [this table on FilecoinTl;dr](https://filecointldr.io/how-to-buy-filecoin#buy) for more info). Which address types are best to use may depend on your use case and goals.

### Install the Ledger app

Follow these instructions to connect your Filecoin addresses within MetaMask to your Ledger wallet. This guide assumes you have [Ledger Live](https://www.ledger.com/ledger-live) and [MetaMask](https://metamask.io/) installed on your computer.

Before you can connect MetaMask to your Ledger, you must install the Filecoin Ledger App on your Ledger device.

1. Open Ledger Live and navigate to **My Ledger**.
2. Connect your Ledger device and unlock it.
3. Confirm that you allow My Ledger to access your Ledger device. You can do that by clicking both buttons on your Ledger device simultaneously.
4. Go back to Ledger Live on your computer.
5. In **My Ledger**, head over to **App catalog** and search for **Filecoin**.
6. Click **Install**.

For more details on the official Filecoin Ledger app, [check out the Ledger documentation](https://support.ledger.com/article/4402721277329-zd?redirect=false).

### Enable expert-mode

MetaMask requires that the Filecoin app on your Ledger device is set to *Expert mode*.

1. Open the Filecoin app on your Ledger device.

   ![A Ledger with the Filecoin app open.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-bcbd86e3eec2e63b0d84f799e81422dc36247a02%2Fbasics-assets-metamask-ledger-1-filecoin-app.jpg?alt=media\&token=ab7b6745-8660-4515-9ffb-19af1e3d8ea4)
2. Use the buttons on your device to navigate to **Expert mode**.

   ![A Ledger showing the expert mode option.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-c0ffa4b27da478bc2ce4f358ccf6b288d309c717%2Fbasics-assets-metamask-ledger-2-expert-mode.jpg?alt=media\&token=1d7d20ba-05b1-498a-a01f-89d356ef5d86)
3. Press both buttons simultaneously to *enable* **Expert mode**.

### Connect to MetaMask

Once you have installed the Filecoin app on your Ledger device and enabled expert mode, you can connect your device to MetaMask.

1. Open your browser and open the MetaMask extension.
2. In the **Accounts** menu, select **Add hardware wallet**.

   ![MetaMask with the 'Add hardware wallet' option highlighted.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-a121bd4870a2bf7aa4305d8a9114baf233a9a6c2%2Fbasics-assets-metamask-ledger-3-add-hw-wallet.jpg?alt=media\&token=03e5139d-7a8d-4219-99e9-b6851f44843c)
3. Select **Ledger**

   ![MetaMask showing the available hardware wallet options.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-6146c0bf6093d7cb34eaaa07f2d6ae70b218235c%2Fbasics-assets-metamask-ledger-4-select-ledger.jpg?alt=media\&token=eed8a189-4ed4-498f-9f44-4a713d8fea3f)
4. A list of accounts should appear. Select an `0x...` account.

   ![MetaMask showing multiple accounts from a Ledger device.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-a640f380f25cebf02ede899f0da12f3fe395ca66%2Fbasics-assets-metamask-ledger-5-select-account.jpg?alt=media\&token=34f77d68-1213-486b-b03b-58a8930f80fe)
5. Done!

That's it! You've now successfully connected your Ledger device to MetaMask. When you submit any transactions through MetaMask using this account, the Filecoin Ledger app will prompt you for a confirmation on the Ledger device.

You may see a *blind signing* warning on your MetaMask device. This is expected, and is the reason why **Expert Mode** must be enabled before you can interact with the Filecoin Ledger app.

![A Ledger device showing a blind signing warning.](https://3376433986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxNWFG7bQkjLkl5BBGjbD%2Fuploads%2Fgit-blob-4826ed940718c93766d9bc81404f6f0dabc4d1f8%2Fbasics-assets-metamask-ledger-7-blind-signing.jpg?alt=media\&token=14f2b8d5-0f9e-4689-8f2c-704db68f6ffa)

[Was this page helpful?](https://airtable.com/apppq4inOe4gmSSlk/pagoZHC2i1iqgphgl/form?prefill_Page+URL=https://docs.filecoin.io/basics/assets/metamask-setup)