Pledging sectors is a technique to seal sectors with random data to make increase the miner's power in the network. This guide covers the motivation, steps to create and upgrade pledged sectors back to a usable state.
Reasons to pledge sectors
As explained in “How mining works”, the amount of power of a miner in the Filecoin network is directly proportional to the amount of live storage (active sectors) contributed to the network. Miners with more power have more chances to be selected to mine new blocks.
By sealing sectors with random data, a miner can demonstrate to the network that it can potentially offer that much storage for real deals when there is enough demand or when it decides to do so. This is known as pledging. In the meantime, pledged sectors work similar to regular sectors and result in an increase in the miner’s power.
Taking the above into account, pledging sectors [on mainnet] network makes most sense when doing it at a scale where it provides enough power to have real chances to mine new blocks. Otherwise, it is only useful for testing purposes.
Pledging a sector
To pledge a sector use:
lotus-miner sectors pledge
In Lotus, this will pledge the space for ~538 days by default.
$TMPDIRso make sure that there is enough space available.
Check that the sealing job has started with:
lotus-miner sealing jobs
This will be accommpanied by a file in
After some minutes, you can check the sealing progress with:
lotus-miner sectors list # and lotus-miner sealing workers
When sealing for the new is complete,
pSet: NO will become
Adjusting the expected seal duration setting
If you pledged a sector, you can use the duration of the operation to update the
To find out how long it took to seal the sector, run:
lotus-miner sectors status --log 0
Then follow the instructions in the configuration reference linked above.
Upgrading pledged sectors
The minimum pledge period is 6 months. However, the pledged sector can be replaced before then by replacing it with a new sector containing deals, as long as the replacement sector expires after the pledged sector. The following command marks a sector for upgrade:
lotus-miner sectors mark-for-upgrade <sector number>
The sector should become inactive within 24 hours after a new replacement sector has sealed. From that point, the pledged storage can be re-used for new sectors.
Inspect expiring sectors
You can check which sectors are about to expire. Sectors that will expire within 60 days can be checked by default with the following command:
lotus-miner sectors check-expire
If you want to check for sectors that will expire within 33 days (669600 epoch in devnet) , add the
--cutoff option along with your desired epoch:
lotus-miner sectors check-expire --cutoff 669600
ID SealProof InitialPledge Activation Expiration MaxExpiration MaxExtendNow 5 5 59.605 nFIL 1519 (1 day 9 hours ago) 691857 (in 4 weeks 2 days) 5257519 (in 34 weeks 3 days) 1587303 (in 10 weeks 2 days) 10 5 59.605 nFIL 3588 (1 day 7 hours ago) 697617 (in 4 weeks 2 days) 5259588 (in 34 weeks 4 days) 1587303 (in 10 weeks 2 days) 11 5 59.605 nFIL 4695 (1 day 6 hours ago) 697617 (in 4 weeks 2 days) 5260695 (in 34 weeks 4 days) 1587303 (in 10 weeks 2 days) 15 5 59.605 nFIL 6891 (1 day 4 hours ago) 700497 (in 4 weeks 2 days) 5262891 (in 34 weeks 4 days) 1587303 (in 10 weeks 2 days) 17 5 59.605 nFIL 7004 (1 day 3 hours ago) 700497 (in 4 weeks 2 days) 5263004 (in 34 weeks 4 days) 1587303 (in 10 weeks 2 days)
You can extend the lifecycle of a sector with the command:
lotus-miner sectors renew [command options] [arguments...]
This is an example of selecting sectors with a lifecycle between
epochnumber-a epoch and
epochnumber-b epoch and updating it to 1555200 epoch:
lotus-miner sectors renew --from <epochnumber-a> --to <epochnumber-b> --new-expiration 1555200
This is an example of updating the lifecycle of a sector read from a file to 1555200 epoch:
lotus-miner sectors renew --sector-file <your-sectorfile> --new-expiration 1555200
You have to select the sectors to renew. That means you have to specify the
--to option, or specify the sector file, if no sector is selected this command will have no effect.
Format of sector file:
1 2 ...