lotus/documentation/en/mining.md

# Getting started

Ensure that at least one **BLS address** (`t3..`) in your wallet exists

```sh
$ lotus wallet list
t3...
```

With this address, go to the [faucet](https://lotus-faucet.kittyhawk.wtf/miner.html), and
click `Create Miner`

Wait for a page telling you the address of the newly created **Lotus Storage Miner** to appear.

The screen should show: `New storage miners address is: t0..`

## Initialize

```sh
$ lotus-storage-miner init --actor=t01.. --owner=t3....
```

This command should return successfully after **Lotus Storage Miner** is setup on **chain**. It usually takes 30 to 60 seconds.

## Start mining

```sh
$ lotus-storage-miner run
```

To view the miner id used for deals:

```sh
$ lotus-storage-miner info
```

e.g. miner id `t0111`

**Seal** random data to start producing **PoSts**:

```sh
$ lotus-storage-miner store-garbage
```

You can check **miner power** and **sector** usage with the miner id:

```sh
# Total power of the network
$ lotus-storage-miner state power

$ lotus-storage-miner state power <miner>

$ lotus-storage-miner state sectors <miner>
```

## Assign a nickname for your node

In the `.lotus` folder, modify `config.toml` with:

```sh
[Metrics]
Nickname="snoopy"
```
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			`# Getting started`
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			Ensure that at least one BLS address (`t3..`) in your wallet exists
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ lotus wallet list`
			`t3...`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`With this address, go to the [faucet](https://lotus-faucet.kittyhawk.wtf/miner.html), and`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			click `Create Miner`

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`Wait for a page telling you the address of the newly created Lotus Storage Miner to appear.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			The screen should show: `New storage miners address is: t0..`

			`## Initialize`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ lotus-storage-miner init --actor=t01.. --owner=t3....`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`This command should return successfully after Lotus Storage Miner is setup on chain. It usually takes 30 to 60 seconds.`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00			`## Start mining`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ lotus-storage-miner run`
			```

			`To view the miner id used for deals:`

			```sh
			`$ lotus-storage-miner info`
			```

			e.g. miner id `t0111`

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`Seal random data to start producing PoSts:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`$ lotus-storage-miner store-garbage`
			```

documentation: small copy updates 2019-12-04 15:39:41 +00:00			`You can check miner power and sector usage with the miner id:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
			`# Total power of the network`
			`$ lotus-storage-miner state power`

			`$ lotus-storage-miner state power <miner>`

			`$ lotus-storage-miner state sectors <miner>`
			```
documentation: small copy updates 2019-12-04 15:39:41 +00:00
			`## Assign a nickname for your node`

documentation: revisions 2019-12-04 17:53:36 +00:00			In the `.lotus` folder, modify `config.toml` with:
documentation: small copy updates 2019-12-04 15:39:41 +00:00
documentation: revisions 2019-12-04 17:53:36 +00:00			```sh
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`[Metrics]`
			`Nickname="snoopy"`
			```