lotus/documentation/en/join-devnet-cli.md

# Join DevNet

## Setup

If you have run Lotus before and want to remove all previous data: `rm -rf ~/.lotus ~/.lotusstorage`

## Genesis & Bootstrap

The current Lotus build will automatically join the **Lotus DevNet** using the genesis and bootstrap files in the `build/`.

## Start Daemon

```sh
$ lotus daemon
```

In another window check that you are connected to the network:

```sh
$ lotus net peers | wc -l
2 # number of peers
```

Wait for the **chain** to finish syncing:

```sh
$ lotus sync wait
```

You can view latest **chain block height** along with other network metrics at the [chain block height explorer](https://lotus-metrics.kittyhawk.wtf/chain).

## Basics

Create a new address:

```sh
$ lotus wallet new bls
t3...
```

- Visit the [faucet](https://lotus-faucet.kittyhawk.wtf/funds.html)
- Paste the address you created
- Press Send.

Check the wallet balance (balance is listed in attoFIL, where 1 attoFIL = 10^-18 FIL):

```sh
$ lotus wallet balance [optional address (t3...)]
```

If you see an error like `actor not found` after executing this command, it means that either:

* Your **Lotus Node** isn't fully synced
* There are no transactions to this address yet on chain. 

If the latter, using the **faucet** should fix this.

## Make a deal

It is possible for a **Lotus Node** Client to make a deal with a **Lotus Storage Miner** on the same **Lotus Node**.

```sh
# List all miners in the system. Choose one to make a deal with.

$ lotus state list-miners

# List asks proposed by a miner

$ lotus client query-ask <miner>

# Propose a deal with a miner. Price is in attoFIL/byte/block. Duration is # of blocks.

$ lotus client deal <Data CID> <miner> <price> <duration>
```

Here is an example of what could happen

> `$ lotus client deal bafkre...qvtjsi t0111 36000 12` proposes a deal to store **Data CID** `bafkre...qvtjsi` with miner `t0111` at price `36000` for a duration of `12` blocks. If successful, the `client deal` command will return a **Deal CID**.

## Monitoring Dashboard

To see the latest network activity, including **chain block height**, **blocktime**, **total network power**, largest **block producer miner**, check out the [monitoring dashboard](https://lotus-metrics.kittyhawk.wtf).
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`# Join DevNet`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`## Setup`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: small copy updates 2019-12-04 15:39:41 +00:00			If you have run Lotus before and want to remove all previous data: `rm -rf ~/.lotus ~/.lotusstorage`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`## Genesis & Bootstrap`

documentation: revisions 2019-12-04 17:53:36 +00:00			The current Lotus build will automatically join the Lotus DevNet using the genesis and bootstrap files in the `build/`.
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`## Start Daemon`

			```sh
			`$ lotus daemon`
			```

			`In another window check that you are connected to the network:`

			```sh
			`$ lotus net peers \| wc -l`
			`2 # number of peers`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`Wait for the chain to finish syncing:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ lotus sync wait`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`You can view latest chain block height along with other network metrics at the [chain block height explorer](https://lotus-metrics.kittyhawk.wtf/chain).`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`## Basics`

			`Create a new address:`

			```sh
			`$ lotus wallet new bls`
			`t3...`
			```

documentation: revisions 2019-12-04 17:53:36 +00:00			`- Visit the [faucet](https://lotus-faucet.kittyhawk.wtf/funds.html)`
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`- Paste the address you created`
			`- Press Send.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`Check the wallet balance (balance is listed in attoFIL, where 1 attoFIL = 10^-18 FIL):`

			```sh
			`$ lotus wallet balance [optional address (t3...)]`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			If you see an error like `actor not found` after executing this command, it means that either:

			`* Your Lotus Node isn't fully synced`
			`* There are no transactions to this address yet on chain.`

			`If the latter, using the faucet should fix this.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`## Make a deal`

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`It is possible for a Lotus Node Client to make a deal with a Lotus Storage Miner on the same Lotus Node.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`# List all miners in the system. Choose one to make a deal with.`

			`$ lotus state list-miners`

			`# List asks proposed by a miner`

			`$ lotus client query-ask <miner>`

			`# Propose a deal with a miner. Price is in attoFIL/byte/block. Duration is # of blocks.`

			`$ lotus client deal <Data CID> <miner> <price> <duration>`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`Here is an example of what could happen`

			> `$ lotus client deal bafkre...qvtjsi t0111 36000 12` proposes a deal to store Data CID `bafkre...qvtjsi` with miner `t0111` at price `36000` for a duration of `12` blocks. If successful, the `client deal` command will return a Deal CID.
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			`## Monitoring Dashboard`

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`To see the latest network activity, including chain block height, blocktime, total network power, largest block producer miner, check out the [monitoring dashboard](https://lotus-metrics.kittyhawk.wtf).`