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:\

  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.

Last updated