2019-12-06 15:26:03 +00:00
# Storage Mining
2019-12-01 08:21:20 +00:00
2019-12-18 21:46:09 +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 ).
2019-12-06 15:26:03 +00:00
2019-12-18 21:46:09 +00:00
It is useful to [join the Testnet ](https://docs.lotu.sh/en+join-testnet ) prior to attempting storage mining for the first time.
2019-12-06 15:26:03 +00:00
2020-07-11 08:55:13 +00:00
## Note: Using the Lotus Miner from China
2019-12-18 22:48:52 +00:00
2020-07-08 10:38:59 +00:00
If you are trying to use `lotus-miner` from China. You should set this **environment variable** on your machine.
2019-12-18 22:48:52 +00:00
```sh
2020-08-16 01:48:42 +00:00
export IPFS_GATEWAY="https://proof-parameters.s3.cn-south-1.jdcloud-oss.com/ipfs/"
2019-12-18 22:48:52 +00:00
```
2019-12-09 12:53:40 +00:00
2019-12-06 15:26:03 +00:00
## Get started
2020-02-12 23:36:56 +00:00
Please ensure that at least one **BLS address** (starts with `t3` ) in your wallet exists with the following command:
2019-12-01 08:21:20 +00:00
```sh
2019-12-06 15:26:03 +00:00
lotus wallet list
2019-12-01 08:21:20 +00:00
```
2020-02-12 23:36:56 +00:00
If you do not have a bls address, create a new bls wallet:
```sh
lotus wallet new bls
```
2019-12-09 12:53:40 +00:00
With your wallet address:
2020-05-14 22:27:47 +00:00
- Visit the [faucet ](https://faucet.testnet.filecoin.io )
2019-12-10 10:01:26 +00:00
- Click "Create Miner"
2019-12-09 12:53:40 +00:00
- DO NOT REFRESH THE PAGE. THIS OPERATION CAN TAKE SOME TIME.
2019-12-01 08:21:20 +00:00
2019-12-09 12:53:40 +00:00
The task will be complete when you see:
2019-12-01 08:21:20 +00:00
2019-12-06 15:26:03 +00:00
```sh
2020-07-11 08:55:13 +00:00
New miners address is: < YOUR_NEW_MINING_ADDRESS >
2019-12-06 15:26:03 +00:00
```
2019-12-02 00:08:53 +00:00
2020-07-11 08:55:13 +00:00
## Initialize the miner
2019-12-01 08:21:20 +00:00
2019-12-09 12:53:40 +00:00
In a CLI window, use the following command to start your miner:
2019-12-01 08:21:20 +00:00
```sh
2020-07-08 10:38:59 +00:00
lotus-miner init --actor=ACTOR_VALUE_RECEIVED --owner=OWNER_VALUE_RECEIVED
2019-12-01 08:21:20 +00:00
```
2019-12-06 15:26:03 +00:00
Example
2019-12-01 08:21:20 +00:00
```sh
2020-07-08 10:38:59 +00:00
lotus-miner init --actor=t01424 --owner=t3spmep2xxsl33o4gxk7yjxcobyohzgj3vejzerug25iinbznpzob6a6kexcbeix73th6vjtzfq7boakfdtd6a
2019-12-01 08:21:20 +00:00
```
2019-12-09 12:53:40 +00:00
You will have to wait some time for this operation to complete.
2019-12-06 15:26:03 +00:00
## Mining
To mine:
2019-12-01 08:21:20 +00:00
```sh
2020-07-08 10:38:59 +00:00
lotus-miner run
2019-12-01 08:21:20 +00:00
```
2019-12-18 21:46:09 +00:00
If you are downloading **Filecoin Proof Parameters** , the download can take some time.
2019-12-10 10:01:26 +00:00
2019-12-06 15:26:03 +00:00
Get information about your miner:
```sh
2020-07-08 10:38:59 +00:00
lotus-miner info
2019-12-06 15:26:03 +00:00
# example: miner id `t0111`
```
2019-12-01 08:21:20 +00:00
2019-12-04 15:39:41 +00:00
**Seal** random data to start producing **PoSts** :
2019-12-01 08:21:20 +00:00
```sh
2020-07-08 10:38:59 +00:00
lotus-miner sectors pledge
2019-12-01 08:21:20 +00:00
```
2019-12-18 21:46:09 +00:00
- Warning: On Linux configurations, this command will write data to `$TMPDIR` which is not usually the largest partition. You should point the value to a larger partition if possible.
2019-12-11 12:29:48 +00:00
2019-12-06 15:26:03 +00:00
Get **miner power** and **sector usage** :
2019-12-01 08:21:20 +00:00
```sh
2020-06-27 15:16:24 +00:00
lotus state power
2019-12-06 15:26:03 +00:00
# returns total power
2019-12-01 08:21:20 +00:00
2020-06-27 15:16:24 +00:00
lotus state power < miner >
2019-12-01 08:21:20 +00:00
2020-06-27 15:16:24 +00:00
lotus state sectors < miner >
2019-12-01 08:21:20 +00:00
```
2020-05-12 19:37:23 +00:00
## Performance tuning
### `FIL_PROOFS_MAXIMIZE_CACHING=1` Environment variable
2020-07-09 03:04:45 +00:00
This env var can be used with `lotus-miner` , `lotus-worker` , and `lotus-bench` to make the precommit1 step faster at the cost of some memory use (1x sector size)
2020-05-12 19:37:23 +00:00
### `FIL_PROOFS_USE_GPU_COLUMN_BUILDER=1` Environment variable
2020-07-09 03:04:45 +00:00
This env var can be used with `lotus-miner` , `lotus-worker` , and `lotus-bench` to enable experimental precommit2 GPU acceleration
2020-07-29 10:59:39 +00:00
### Setting multiaddresses
2020-07-31 12:02:04 +00:00
Set multiaddresses for the miner to listen on in a miner's `config.toml` file
2020-07-30 06:57:25 +00:00
(by default, it is located at `~/.lotusminer/config.toml` ). The `ListenAddresses` in this file should be interface listen addresses (usually `/ip4/0.0.0.0/tcp/PORT` ), and the `AnnounceAddresses` should match the addresses being passed to `set-addrs` .
2020-07-29 10:59:39 +00:00
2020-07-30 06:57:25 +00:00
The addresses passed to `set-addrs` parameter in the commands below should be currently active and dialable; confirm they are before entering them.
Once the config file has been updated, set the on-chain record of the miner's listen addresses:
2020-07-31 12:02:04 +00:00
2020-07-29 10:59:39 +00:00
```
lotus-miner actor set-addrs < multiaddr_1 > < multiaddr_2 > ... < multiaddr_n >
```
2020-07-30 06:57:25 +00:00
This updates the `MinerInfo` object in the miner's actor, which will be looked up
2020-07-29 10:59:39 +00:00
when a client attempts to make a deal. Any number of addresses can be provided.
2020-07-30 06:57:25 +00:00
Example:
2020-07-29 10:59:39 +00:00
```
2020-07-31 12:02:04 +00:00
lotus-miner actor set-addrs /ip4/123.123.73.123/tcp/12345 /ip4/223.223.83.223/tcp/23456
2020-07-29 10:59:39 +00:00
```