cerc-io/lotus
16
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 27 Wiki Activity
3c7880cc10
lotus/documentation/en/join-testnet.md
Aayush Rajasekaran c4b790a910 Use HTTPS for links to the dashboard 
- The link doesn't reliably work without HTTPS specified
2020-02-11 11:51:11 -08:00

2.5 KiB
Raw Blame History

Join Testnet

Introduction

Anyone can set up a Lotus Node and connect to the Lotus Testnet. This is the best way to explore the current CLI and the Filecoin Decentralized Storage Market.

If you have installed older versions, you may need to clear existing chain data, stored wallets and miners if you run into any errors. You can use this command:

rm -rf ~/.lotus ~/.lotusstorage

Note: Using the Lotus Node from China

If you are trying to use lotus from China. You should set this environment variable on your machine:

IPFS_GATEWAY="https://proof-parameters.s3.cn-south-1.jdcloud-oss.com/ipfs/"

Get started

Start the daemon using the default configuration in ./build:

lotus daemon

In another terminal window, check your connection with peers:

lotus net peers | wc -l

In order to connect to the network, you need to be connected to at least 1 peer. If you’re seeing 0 peers, read our troubleshooting notes.

Chain sync

While the daemon is running, the next requirement is to sync the chain. Run the command below to start the chain sync progress. To see current chain height, visit the network stats page.

lotus sync wait
  • This step will take anywhere between 30 minutes to a few hours.
  • You will be able to perform Lotus Testnet operations after it is finished.

Create your first address

Initialize a new wallet:

lotus wallet new

Sometimes your operating system may limit file name length to under 150 characters. You need to use a file system that supports long filenames.

Here is an example of the response:

t1aswwvjsae63tcrniz6x5ykvsuotlgkvlulnqpsi
  • Visit the faucet to add funds.
  • Paste the address you created.
  • Press the send button.

Check wallet address balance

Wallet balances in the Lotus Testnet are in FIL, the smallest denomination of FIL is an attoFil, where 1 attoFil = 10^-18 FIL.

lotus wallet balance <YOUR_NEW_ADDRESS>

You will not see any attoFIL in your wallet if your chain is not fully synced.

Send FIL to another wallet

To send FIL to another wallet, use this command:

lotus send <target> <amount>

Monitor the dashboard

To see the latest network activity, including chain block height, block height, blocktime, total network power, largest block producer miner, check out the monitoring dashboard.