Get test tokens

Test funds are available to developer so that they can test their smart contracts and applications within the confines of a test network. The process for getting test funds differs across test networks. This page covers how to get test funds from a 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.

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
   

2. View the wallets available on this node with lotus wallet list:

   ./lotus wallet list
   

   Address                                                                                 Balance                          Nonce  Default
   t1snly7vh4mjtjznwze56ihrdhzfwvbajywwmrenq                                               0 FIL                            0
   t3q4o7gkwe7p7xokhgws4rwntj7yqfhpj5pm6cqc7dycl7cwk4uvgh2odwdvge5re7ne5gcc6xluifss5uu5cq  49999999.999763880085417692 FIL  2      X
   

3. Create the send request with lotus send, supplying the pre-mined t3q4o... address as the --from address, the new t1snl... address as the receiving address, and the amount of FIL we want to send:

   ./lotus send --from <PRE-MINED ADDRESS> <TO ADDRESS> <VALUE>
   

   For example:

   ./lotus send --from t3q4o7gkwe7p7xokhgws4rwntj7yqfhpj5pm6cqc7dycl7cwk4uvgh2odwdvge5re7ne5gcc6xluifss5uu5cq t1snly7vh4mjtjznwze56ihrdhzfwvbajywwmrenq 2000
   

   bafy2bzaceaqzbgiazwvtpago6wpkxl42puxfkvwv5cwjpime2irqatamji2bq
   

4. Check the balance of your new t1snl... address with lotus wallet balance:

   ./lotus wallet balance <ADDRESS>
   

   For example:

   ./lotus wallet balance t1snly7vh4mjtjznwze56ihrdhzfwvbajywwmrenq
   

   2000 FIL
   

If you want to manage your local testnet tokens in MetaMask you will need to create a t4 address. You can create a t4 address using lotus wallet new deleated. Once you have a t4 address you can connect MetaMask to your local testnet to see the new balance within the MetaMask extension.