Test funds are available to developers so that they can test their smart contracts and applications within the confines of a test network. This page covers how to get test funds.

Get test tokens

Calibration testnet

MetaMask is one of the easier ways to manage addresses on the Calibration testnet. MetaMask displays Filecoin EVM accounts in Ethereum 0x format; on Filecoin testnets those accounts map to delegated t4 addresses. Follow the MetaMask setup guide if you haven’t set up an address in your MetaMask wallet yet.

  1. In your browser, open MetaMask and copy your address to your clipboard.
  2. Go to faucet.calibnet.chainsafe-fil.io and click Send Funds.
  3. Paste your address into the address field and click Send funds:

    The Calibration faucet website.

  4. The webpage will give you a transaction ID:

    A transaction ID returned by the Calibration faucet.

  5. You can copy this ID into a block explorer to track the progress of your transaction:

    A block explorer showing a pending transaction on the Calibration testnet.

That’s all there is to it! Getting tFIL is easy!

Local testnet

Before we begin, you must have a local testnet running. Follow the Run a local network guide if you haven’t got a local testnet set up yet. Run the commands below from the directory that contains your local lotus binary, and replace the placeholder addresses with addresses from your local node.

  1. Change directory to where you created the lotus and lotus-miner binaries. If you followed the Run a local network guide these binaries will be in ~/lotus-devnet:
cd ~/lotus-devnet
  1. View the wallets available on this node with lotus wallet list:
./lotus wallet list
  1. Create the send request with lotus send, supplying a funded local wallet as the --from address, the receiving address, and the amount of FIL you want to send:
./lotus send --from <FUNDED_LOCAL_ADDRESS> <TO_ADDRESS> <VALUE>

To create a delegated address for local Filecoin EVM testing, run:

./lotus wallet new delegated
  1. Check the balance of your receiving address with lotus wallet balance:
./lotus wallet balance <ADDRESS>

If you want to manage your local testnet tokens in MetaMask, use a delegated address and connect MetaMask to your local testnet to see the new balance within the MetaMask extension.

Was this page helpful?