lotus/documentation/en/join-testnet.md

83 lines
2.4 KiB
Markdown
Raw Normal View History

2019-12-18 18:46:11 +00:00
# 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**.
## 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:
```sh
IPFS_GATEWAY="https://proof-parameters.s3.cn-south-1.jdcloud-oss.com/ipfs/"
```
## 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
```
In order to connect to the network, you need to be connected to at least 1 peer. If youre seeing 0 peers, read our [troubleshooting notes](https://docs.lotu.sh/en+setup-troubleshooting).
2019-12-11 15:38:04 +00:00
## Chain sync
2020-03-01 04:52:25 +00:00
While the daemon is running, the next requirement is to sync the chain. Run the command below to view the chain sync progress. To see current chain height, visit the [network stats page](https://stats.testnet.filecoin.io/).
```sh
lotus sync wait
```
2020-03-01 04:52:25 +00:00
- This step will take anywhere between a few hours to a couple of days.
2019-12-18 18:46:11 +00:00
- You will be able to perform **Lotus Testnet** operations after it is finished.
## Create your first address
2020-01-08 19:16:09 +00:00
Initialize a new wallet:
2019-12-11 15:38:04 +00:00
```sh
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.
2019-12-11 15:38:04 +00:00
Here is an example of the response:
```sh
2020-01-08 19:16:09 +00:00
t1aswwvjsae63tcrniz6x5ykvsuotlgkvlulnqpsi
```
2020-05-13 23:13:35 +00:00
- Visit the [faucet](https://facuet.testnet.filecoin.io) 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.
```sh
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
2020-05-13 23:13:35 +00:00
To send FIL to another wallet from your default account, 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](https://stats.testnet.filecoin.io).