Metamask setup | Filecoin Docs

2025.01.09 10:23


Filecoin Docs Basics Storage providers Nodes Networks Smart contracts Reference More Basics Storage providers Nodes Networks Smart contracts Reference Ask or search Ctrl +  K Welcome to Filecoin Docs Basics What is Filecoin Crypto-economics Blockchain Storage model Storage market Retrieval market Programming on Filecoin Networks The blockchain Actors Addresses Blocks and tipsets Consensus Drand Proofs Assets The FIL token Wallets Metamask setup Get FIL Transfer FIL Interplanetary consensus How storage works Filecoin plus Storage onramps Filecoin and IPFS How retrieval works Basic retrieval Serving retrievals Saturn Project and community Chat and discussion forums Filecoin compared to Filecoin FAQs Related projects Social media The Filecoin project Ways to contribute Storage providers Basics Quickstart guide Filecoin economics Storage proving FIL collateral Block rewards Slashing Committed capacity Filecoin deals Storage deals Verified deals Filecoin programs and tools Snap deals Charging for data Auxiliary services Return-on-investment Architecture Software components Storage provider automation Sealing pipeline Sealing rate Sealing-as-a-service Network indexer Infrastructure Storage Network Backup and disaster recovery Reference architectures Skills Linux Network Security Storage Sales Industry Nodes Implementations Lotus Venus Full-nodes Pre-requisites Basic setup Node providers Lite-nodes Spin up a lite-node Smart contracts Fundamentals The Filecoin Virtual Machine Filecoin EVM runtime ERC-20 quickstart Roadmap Support FAQs Filecoin EVM-runtime Actor types Address types FILForwarder Difference with Ethereum How gas works Precompiles Programmatic storage Aggregated deal-making Direct deal-making Data replication, renewal and repair (RaaS) RaaS interfaces Developing contracts Get test tokens Remix Hardhat Foundry Solidity libraries Call built-in actors Filecoin.sol Direct deal-making with Client contract Using RaaS Verify a contract Best practices Advanced Wrapped FIL Oracles Multicall Multisig FEVM Indexers Cross-chain bridges Aggregated deal-making Contract automation Relay Networks Mainnet Explorers RPCs Network performance Calibration Explorers RPCs Local testnet Get test tokens Deprecated networks Reference General Glossary Specifications Tools Exchanges Exchange integration Built-in actors Protocol API Filecoin.sol JSON-RPC Auth Chain Client Create Eth Gas I Log Market Miner Mpool Msig Net Node Paych Raft Start State Sync Wallet Web3 Builder Cookbook Overview Table of Contents Data Storage Store Data Retrieve Data Privacy & Access Control dApps Chain-Data Query Oracles Cross-Chain Bridges Decentralized Database Powered by GitBook On this page Using ChainID Manual process Prerequisites Steps Ledger hardware wallet Install the Ledger app Enable expert-mode Connect to MetaMask

Was this helpful?

Edit on GitHub Export as PDF Basics Assets

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

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.

Mainnet Calibration Local testnet

Navigate to chainid.network .

Search for Filecoin Mainnet .

Click Connect Wallet .

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

Click Switch network when prompted by MetaMask.

Open MetaMask from the browser extensions tab.

You should see Filecoin listed at the top.

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

Navigate to chainid.network .

Search for Filecoin Calibration .

Click Connect Wallet .

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

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

Click Switch network when prompted by MetaMask.

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.

Navigate to chainid.network .

Search for Filecoin Local testnet .

Click Connect Wallet .

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

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

Click Switch network when prompted by MetaMask.

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 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 , or Firefox .

A browser with MetaMask installed.

Steps

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

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.

Click the user circle and select Settings.

Select Networks .

Click Add a network .

Scroll down and click Add a network manually .

Enter the following information into the fields:

Mainnet Calibration Local testnet Field Value

Network name

Filecoin

New RPC URL

Either: - https://api.node.glif.io/rpc/v1 - https://filecoin.chainup.net/rpc/v1 - https://rpc.ankr.com/filecoin

Chain ID

314

Currency symbol

FIL

Field Value

Network name

Filecoin Calibration testnet

New RPC URL

Either: - https://api.calibration.node.glif.io/rpc/v1 - https://filecoin-calibration.chainup.net/rpc/v1

Chain ID

314159

Currency symbol

tFIL

Field Value

Network name

Filecoin Local testnet

New RPC URL

http://localhost:1234/rpc/v1

Chain ID

31415926

Currency symbol

tFIL

Pick one block explorer from the Networks section , and enter the URL into the Block explorer (optional) field.

Review the values in the fields and click Save .

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

Done!

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

Ledger hardware wallet

MetaMask is compatible with the Ledger hardware wallet. Follow these instructions to connect your Filecoin addresses within MetaMask to your Ledger wallet. This guide assumes you have Ledger Live and MetaMask installed on your computer.

Install the Ledger app

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

Open Ledger Live and navigate to My Ledger .

Connect your Ledger device and unlock it.

Confirm that you allow My Ledger to access your Ledger device. You can do that by clicking both buttons on your Ledger device simultaneously.

Go back to Ledger Live on your computer.

In My Ledger , head over to App catalog and search for Filecoin .

Click Install .

For more details on the official Filecoin Ledger app, check out the Ledger documentation .

Enable expert-mode

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

Open the Filecoin app on your Ledger device.

Use the buttons on your device to navigate to Expert mode .

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.

Open your browser and open the MetaMask extension.

In the Accounts menu, select Add hardware wallet .

Select Ledger

A list of accounts should appear. Select an 0x account.

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.

Was this page helpful?

Previous Wallets Next Get FIL

Last updated 2 months ago

Basics

Overview Crypto-economics Storage model Reference

Developers

The FVM EVM-runtime Quickstart Transfer FIL

Contact

GitHub Slack Twitter A Ledger with the Filecoin app open. A Ledger showing the expert mode option. MetaMask with the 'Add hardware wallet' option highlighted. MetaMask showing the available hardware wallet options. MetaMask showing multiple accounts from a Ledger device. A Ledger device showing a blind signing warning.

Menu

Last Photo