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

   This command will output something like:\

   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

   This command will output something like:\

   bafy2bzaceaqzbgiazwvtpago6wpkxl42puxfkvwv5cwjpime2irqatamji2bq

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

   ./lotus wallet balance <ADDRESS>

   For example:\

   ./lotus wallet balance t1snly7vh4mjtjznwze56ihrdhzfwvbajywwmrenq

   This command will output something like:\

   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 delegated. Once you have a t4 address you can connect MetaMask to your local testnet to see the new balance within the MetaMask extension.

Was this page helpful?