Filecoin Docs
BasicsStorage providersNodesNetworksSmart contractsReference
  • 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
      • Forums and FIPs
      • 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
    • PDP
      • Prerequisites
      • Install & Run Lotus
      • Install & Run YugabyteDB
      • Install & Run Curio
      • Enable PDP
      • Use PDP
  • 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
      • Cross-Chain Data Bridge(CCDB)
      • 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
LogoLogo

Basics

  • Overview
  • Crypto-economics
  • Storage model
  • Reference

Developers

  • The FVM
  • EVM-runtime
  • Quickstart
  • Transfer FIL

Contact

  • GitHub
  • Slack
  • Twitter
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
  1. Basics
  2. 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

PreviousWalletsNextGet FIL

Last updated 2 days ago

Was this helpful?

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.

  1. Navigate to .

  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.

  1. Navigate to .

  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.

  1. Navigate to .

  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.

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

  • A browser with 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:

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

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

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

  3. 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:

  • 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

  • Ledger Live and the Filecoin Ledger App or

Install the Ledger app

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.

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.

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

  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.

  3. Select Ledger

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

  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.

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

Filecoin Ledger App - compatible with MetaMask or the wallet

Note that MetaMask supports Filecoin EVM addresses that follow the Ethereum 0x format (see for more info on address types). To use native Filecoin address types that begin with f, you can use:

wallet (also compatible with the Filecoin Ledger App),

installable from the right menu in Metamask under Snaps

Some exchanges only support specific address types (see for more info). Which address types are best to use may depend on your use case and goals.

Follow these instructions to connect your Filecoin addresses within MetaMask to your Ledger wallet. This guide assumes you have and installed on your computer.

For more details on the official Filecoin Ledger app, .

chainid.network
chainid.network
chainid.network
Chromium-based browser
Firefox
MetaMask
Networks section
Glif.io
this section
Glif.io
Filecoin MetaMask Wallet
this table on FilecoinTl;dr
Ledger Live
MetaMask
check out the Ledger documentation
Was this page helpful?
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.