lotus/documentation/en/mining.md

# Storage Mining

Here are instructions to learn how to perform storage mining. For hardware specifications please read [this](https://docs.lotu.sh/en+hardware-mining).

It is useful to [join the DevNet](https://docs.lotu.sh/en+join-devnet) prior to attempting storage mining for the first time.

## Get started

Please ensure that at least one **BLS address** (`t3..`) in your wallet exists with the following command:

```sh
lotus wallet list
```

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

Await this response:

```sh
To initialize the storage miner run the following command
```

## Initialize the storage miner

```sh
lotus-storage-miner init --actor=ACTOR_VALUE_RECEIVED --owner=OWNER_VALUE_RECEIVED
```

Example

```sh
lotus-storage-miner init --actor=t01424 --owner=t3spmep2xxsl33o4gxk7yjxcobyohzgj3vejzerug25iinbznpzob6a6kexcbeix73th6vjtzfq7boakfdtd6a
```

This command will take 30-60 seconds.

## Mining

To mine:

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

Get information about your miner:

```sh
lotus-storage-miner info
# example: miner id `t0111`
```

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

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

Get **miner power** and **sector usage**:

```sh
lotus-storage-miner state power
# returns total power

lotus-storage-miner state power <miner>

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

## Change nickname

Update `~/.lotus/config.toml` with:


```sh
[Metrics]
Nickname="snoopy"
```

## Troubleshooting

```sh
lotus-storage-miner info
# WARN  main  lotus-storage-miner/main.go:73  failed to get api endpoint: (/Users/myrmidon/.lotusstorage) %!w(*errors.errorString=&{API not running (no endpoint)}):
```

If you see this, that means your **Lotus Storage Miner** isn't ready yet.
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`# Storage Mining`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`Here are instructions to learn how to perform storage mining. For hardware specifications please read [this](https://docs.lotu.sh/en+hardware-mining).`

			`It is useful to [join the DevNet](https://docs.lotu.sh/en+join-devnet) prior to attempting storage mining for the first time.`

			`## Get started`

			Please ensure that at least one BLS address (`t3..`) in your wallet exists with the following command:
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus wallet list`
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			`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: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`Await this response:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```sh
			`To initialize the storage miner run the following command`
			```
documentation: light copy adjustments before major revision 2019-12-02 00:08:53 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`## Initialize the storage miner`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner init --actor=ACTOR_VALUE_RECEIVED --owner=OWNER_VALUE_RECEIVED`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`Example`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner init --actor=t01424 --owner=t3spmep2xxsl33o4gxk7yjxcobyohzgj3vejzerug25iinbznpzob6a6kexcbeix73th6vjtzfq7boakfdtd6a`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`This command will take 30-60 seconds.`

			`## Mining`

			`To mine:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner run`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`Get information about your miner:`

			```sh
			`lotus-storage-miner info`
			# example: miner id `t0111`
			```
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			`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
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner store-garbage`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`Get miner power and sector usage:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner state power`
			`# returns total power`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner state power <miner>`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`lotus-storage-miner state sectors <miner>`
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
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`## Change nickname`

			Update `~/.lotus/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"`
			```
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			`## Troubleshooting`

			```sh
			`lotus-storage-miner info`
			`# WARN main lotus-storage-miner/main.go:73 failed to get api endpoint: (/Users/myrmidon/.lotusstorage) %!w(*errors.errorString=&{API not running (no endpoint)}):`
			```

			`If you see this, that means your Lotus Storage Miner isn't ready yet.`