Comment on page

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

Networks - Previous

Local testnet

Next - Networks

Deprecated networks

Last modified 4mo ago