2019-12-11 15:38:04 +00:00
|
|
|
|
# Join TestNet
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
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**.
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
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:
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
rm -rf ~/.lotus ~/.lotusstorage
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Get started
|
|
|
|
|
|
|
|
|
|
Start the **daemon** using the default configuration in `./build`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
lotus daemon
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
In another terminal window, check your connection with peers:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
lotus net peers | wc -l
|
|
|
|
|
```
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
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](https://docs.lotu.sh/en+setup-troubleshooting).
|
2019-12-09 12:53:40 +00:00
|
|
|
|
|
2019-12-11 15:38:04 +00:00
|
|
|
|
## Chain sync
|
2019-12-09 12:53:40 +00:00
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
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](http://stats.testnet.filecoin.io/).
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
lotus sync wait
|
|
|
|
|
```
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
- 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.
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-09 12:53:40 +00:00
|
|
|
|
## Create your first address
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-11 15:38:04 +00:00
|
|
|
|
Initialize a wallet using BLS signature formats:
|
|
|
|
|
|
2019-12-09 12:53:40 +00:00
|
|
|
|
```sh
|
|
|
|
|
lotus wallet new bls
|
|
|
|
|
```
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-11 15:38:04 +00:00
|
|
|
|
Here is an example of the response:
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
2019-12-09 12:53:40 +00:00
|
|
|
|
t3vhfme4qfvegqaz7m7q6o6afjcs67n6kpzv7t2eozio4chwpafwa2y4l7zhwd5eom7jmihzdg4s52dpvnclza
|
2019-12-06 15:26:03 +00:00
|
|
|
|
```
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
- Visit the [faucet](https://lotus-faucet.kittyhawk.wtf/funds.html) to add
|
|
|
|
|
funds.
|
2019-12-06 15:26:03 +00:00
|
|
|
|
- Paste the address you created.
|
|
|
|
|
- Press the send button.
|
|
|
|
|
|
|
|
|
|
## Check wallet address balance
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
Wallet balances in the Lotus TestNet are in **FIL**, the smallest denomination
|
|
|
|
|
of FIL is an **attoFil**, where 1 attoFil = 10^-18 FIL.
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
|
|
|
|
```sh
|
2019-12-09 12:53:40 +00:00
|
|
|
|
lotus wallet balance <YOUR_NEW_ADDRESS>
|
2019-12-06 15:26:03 +00:00
|
|
|
|
```
|
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
You will not see any attoFIL in your wallet if your **chain** is not fully
|
|
|
|
|
synced.
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-11 01:50:13 +00:00
|
|
|
|
## Send FIL to another wallet
|
|
|
|
|
|
|
|
|
|
To send FIL to another wallet, use this command:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
lotus send <target> <amount>
|
|
|
|
|
```
|
|
|
|
|
|
2019-12-09 12:53:40 +00:00
|
|
|
|
## Monitor the dashboard
|
2019-12-06 15:26:03 +00:00
|
|
|
|
|
2019-12-18 18:40:47 +00:00
|
|
|
|
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](https://stats.testnet.filecoin.io).
|