Skip to content

Files

Latest commit

7244ff9 · Mar 17, 2022

History

History
3106 lines (2561 loc) · 234 KB

CHANGELOG.md

File metadata and controls

3106 lines (2561 loc) · 234 KB

Lotus changelog

1.15.1-rc1 / 2022-03-16

This is the first release candidate of the next highly recommended feature release v1.15.1. This feature release introduces Index Provider, GraphSync v2, and many other latest functionalities, improvements and bug fixes. More importantly, node operator can now enable the FVM(experimental) to sync mainnet!!

Highlights

🔥🔥🔥 FVM (Experimental) 🔥🔥🔥

  • feat: fvm: FVM integration (filecoin-project/lotus#8332) The lotus team is excited to announce the launch of experimental non-programmable FVM on mainnet. By enabling "LOTUS_USE_FVM_EXPERIMENTAL=1 envvar, the lotus daemon will be running the WASM-compiled built-in actors that is compatible with the existing chain(Network v15 OhSnap). If you are trying it out and having any questions or feedbacks, please leave a comment here!

🌟🌟🌟 Index Provider (Production Ready!) 🌟🌟🌟

More and more useful data is being stored on Filecoin via deals made by clients to Storage Providers. The goal is that this content is discoverable when people need them. To achieve that goal, one of the projects the Bedrock team is working on is building an Indexer Ecosystem, a project that's focus on content addressing on Filecoin, then potentially have interoperability with IPFS in the future and eventually serve the retrieval market. The Indexer Ecosystem high level architecture overview diagram can be found here and a detailed write up about can be found here.

That being said, with this release, lotus Storage Providers can easily become an Index Provider and serve the Indexer Content Addressing System. Index Providers generate advertisements from the deals made by a storage provider and announces the data to the indexer nodes for further processing:

  • To learn more about what is an Index Provider and how to be an Index Provider, read it here in lotus docuementation.
  • An one-off migration is needed in order for a Storage Provider to become an Index Provider and announce the proper formatted index. It's highly recommended for all Index Provider to do a force bulk initialization to enable index announcement on all existing deals.
    • Note that the Initialization places IO workload on your storage system. SP should set a proper concurrency based on your hardware or can stop/start initialization at their wish/convenience as proving deadlines approach and elapse, to avoid IOPS starvation or competition with window PoSt.
  • After the first one-time migration, being an Index Provider barely puts any extra usage on SP's market system.
    • You can find the testing result by SPX fellows here.

We recommend all Storage Providers that are serving deals in the Filecoin network to become a Index Provider, make the data you are storing discoverable for the retrieval market and retrieval clients!

❗️❗️❗️ Dag Migration For New CAR index format in DagStore ❗️❗️❗️

The index provider leverages the latest CARv2 indexing format MultihashIndexSorted, which stores the multihash code as well as the digest of all CIDs in a CAR file. Thus, all Storage Providers SHOULD perform an one-off DAG mirgation to regenerate DagStore CARv2 indices. You have to do it to become an index provider, failing to do so may also impact your future deal making. Follow the instruction here to perform the migration.

New Features

Improvements

Bug Fixes

Dependency Updates

Others

1.15.0 / 2022-03-09

This is an optional release with retrieval improvements(client side), SP ux with unsealing, snap deals and regular deal making and many other new features, improvements and bug fixes.

Highlights

  • feat:sealing: StartEpochSealingBuffer triggers packing on time(filecoin-project/lotus#7905)
    • use the StartEpochSealingBuffer configuration variable as a way to enforce that sectors are packed for sealing / updating no matter how many deals they have if the nearest deal start date is close enough to the present.
  • feat: #6017 market: retrieval ask CLI command (filecoin-project/lotus#7814)
  • feat(graphsync): allow setting of per-peer incoming requests for miners (filecoin-project/lotus#7578)
    • by setting SimultaneousTransfersForStoragePerClient in deal making configuration.
  • Make retrieval even faster (filecoin-project/lotus#7746)
  • feat: #7747 sealing: Adding conf variable for capping number of concurrent unsealing jobs (#7884) (filecoin-project/lotus#7884)
    • by setting MaxConcurrentUnseals in DAGStoreConfig

New Features

Improvements

Bug Fixes

Dependency Updates

  • github.com/filecoin-project/go-commp-utils (v0.1.2 -> v0.1.3):
  • github.com/filecoin-project/dagstore (v0.4.3 -> v0.4.4):
  • github.com/filecoin-project/go-fil-markets (v1.13.4 -> v1.19.2):
  • github.com/filecoin-project/go-statestore (v0.1.1 -> v0.2.0):
  • github.com/filecoin-project/go-storedcounter (v0.0.0-20200421200003-1c99c62e8a5b -> v0.1.0):
  • github.com/filecoin-project/specs-actors/v2 (v2.3.5 -> v2.3.6):

Others

Contributors

Contributor Commits Lines ± Files Changed
@arajasek 73 +7232/-2778 386
@zenground0 27 +5604/-1049 219
@vyzo 118 +4356/-1470 253
@zl 1 +3725/-309 8
@dirkmc 7 +1392/-1110 61
arajasek 37 +221/-1329 90
@magik6k 33 +1138/-336 101
@whyrusleeping 2 +483/-585 28
Darko Brdareski 14 +725/-276 154
@rvagg 2 +43/-947 10
@hannahhoward 5 +436/-335 31
@hannahhoward 12 +507/-133 37
@jennijuju 27 +333/-178 54
@TheMenko 8 +237/-179 17
c r 2 +227/-45 12
@dirkmck 12 +188/-40 27
@ribasushi 3 +128/-62 3
@raulk 6 +128/-49 9
@Whyrusleeping 1 +76/-70 8
@Stebalien 1 +55/-37 1
@jennijuju 11 +29/-16 11
@aarshkshah1992 1 +23/-19 5
@travisperson 1 +0/-18 2
@gstuart 3 +12/-1 3
@coryschwartz 4 +5/-6 4
@pefish 1 +4/-3 1
@Kubuxu 1 +5/-2 2
Colin Kennedy 1 +4/-2 1
Rob Quist 1 +2/-2 1
@shotcollin 1 +1/-1 1

1.14.4 / 2022-03-03

This is a highly recommended optional release for storage providers that are doing snap deals. This fix the bug that causes some snap deal sectors are stuck in FinalizeReplicaUpdate. In addition, SPs should be able to force update sectors status without getting blocked by normal shutdown of state machine.

v1.14.3 / 2022-02-28

This is an optional release, that includes a fix to properly register the --really-do-it flag for abort-upgrade.

1.14.2 / 2022-02-24

This is an optional release of lotus, that's had a couple more improvements w.r.t Snap experience for storage providers in preparation of theupcoming OhSnap upgrade.

Note that the network is STILL scheduled to upgrade to v15 on March 1st at 2022-03-01T15:00:00Z. All node operators, including storage providers, must upgrade to at least Lotus v1.14.0 before that time. Storage providers must update their daemons, miners, and worker(s).

Wanna know how to Snap your deal? Check this out!

Bug Fixes

  • fix lotus-bench for sealing jobs (#8173)
  • fix:sealing:really-do-it flag for abort upgrade (#8181)
  • fix:proving:post check sector handles snap deals replica faults (#8177)
  • fix: sealing: missing file type (#8180)

Others

  • Retract force-pushed v1.14.0 to work around stale gomod caches (#8159): We originally tagged v1.14.0 off the wrong commit and fixed that by a force push, in which is a really bad practise since it messes up the go mod. Therefore, we want to retract it and users may use v1.14.1&^.

Contributors

Contributor Commits Lines ± Files Changed
@zenground0 2 +73/-58 12
@eben.xie 1 +7/-0 1
@jennijuju 1 +4/-0 1
@jennijuju 1 +2/-1 1
@ribasushi 1 +2/-0 1

1.14.1 / 2022-02-18

This is an optional release of lotus, that fixes the incorrect comment of network v15 OhSnap upgrade date. Note the actual upgrade epoch in v1.14.0 was correct.

1.14.0 / 2022-02-17

This is a MANDATORY release of Lotus that introduces Filecoin network v15, codenamed the OhSnap upgrade.

The network is scheduled to upgrade to v15 on March 1st at 2022-03-01T15:00:00Z. All node operators, including storage providers, must upgrade to this release (or a later release) before that time. Storage providers must update their daemons, miners, and worker(s).

The OhSnap upgrade introduces the following FIPs, delivered in actors v7:

It is recommended that storage providers download the new params before updating their node, miner, and workers. To do so:

  • Download Lotus v1.14.0 or later
  • run make lotus-shed
  • run ./lotus-shed fetch-params with the appropriate proving-params flag
  • Upgrade the Lotus daemon and miner when the previous step is complete

All node operators, including storage providers, should be aware that a pre-migration will begin at 2022-03-01T13:30:00Z (90 minutes before the real upgrade). The pre-migration will take between 20 and 50 minutes, depending on hardware specs. During this time, expect slower block validation times, increased CPU and memory usage, and longer delays for API queries.

New Features and Changes

  • Integrate actor v7-rc1:
    • Integrate v7 actors (#7617)
    • feat: state: Fast migration for v15 (#7933)
    • fix: blockstore: Add missing locks to autobatch::Get() #7939)
    • correctness fixes for the autobatch blockstore (#7940)
  • Implement and support FIP-0019 Snap Deals
    • chore: deps: Integrate proof v11.0.0 (#7923)
    • Snap Deals Lotus Integration: FSM Posting and integration test (#7810)
    • Feat/sector storage unseal (#7730)
    • Feat/snap deals storage (#7615)
    • fix: sealing: Add more deal expiration checks during PRU pipeline (#7871)
    • chore: deps: Update go-paramfetch (#7917)
    • feat: #7880 gas: add gas charge for VerifyReplicaUpdate (#7897)
    • enhancement: sectors: disable existing cc upgrade path 2 days before the upgrade epoch (#7900)

Improvements

  • updating to new datastore/blockstore code with contexts (#7646)
  • reorder transfer checks so as to ensure sending 2B FIL to yourself fails if you don't have that amount (#7637)
  • VM: Circ supply should be constant per epoch (#7811)

Bug Fixes

  • Fix: state: circsuypply calc around null blocks (#7890)
  • Mempool msg selection should respect block message limits (#7321) SplitStore: supress compaction near upgrades (#7734)

Others

  • chore: create pull_request_template.md (#7726)

Contributors

Contributor Commits Lines ± Files Changed
Aayush Rajasekaran 41 +5538/-1205 189
zenground0 11 +3316/-524 124
Jennifer Wang 29 +714/-599 68
ZenGround0 3 +263/-25 11
c r 2 +198/-30 6
vyzo 4 +189/-7 7
Aayush 11 +146/-48 49
web3-bot 10 +99/-17 10
Steven Allen 1 +55/-37 1
Jiaying Wang 5 +30/-8 5
Jakub Sztandera 2 +8/-3 3
Łukasz Magiera 1 +3/-3 2
Travis Person 1 +2/-2 2
Rod Vagg 1 +2/-2 2

v1.13.2 / 2022-01-09

Lotus v1.13.2 is a highly recommended feature release with remarkable retrieval improvements, new features like worker management, schedule enhancements and so on.

Highlights

  • 🚀🚀🚀Improve retrieval deal experience
    • Testing result with MinerX.3 shows the retrieval deal success rate has increased dramatically with faster transfer speed, you can join or follow along furthur performance testings here. We recommend application developers to integrate with the new retrieval APIs to provide a better client experience.
    • 🌟🌟🌟 Reduce retrieval Time-To-First-Byte over 100x (#7693)
      • This change makes most free, small retrievals sub-second
    • 🌟🌟🌟 Partial retrieval ux improvements (#7610)
      • New retrieval commands for clients:
        • lotus client ls: retrieve and list desired object links
        • lotus client cat: retrieve and print the data from the network
      • 🌟🌟 The monolith ClientRetrieve method was broken into:
        • ClientRetrieve which retrieves data into the local repo (or into an IPFS node if ipfs integration is enabled)
        • ClientRetrieveWait which will wait for the retrieval to complete
        • ClientExport which will export data from the local node
        • Note: this change only applies to v1 API. v0 API remains unchanged.
      • 🌟 Support for full ipld selectors was added (for example making it possible to only retrieve list of directories in a deal, without fetching any file data)
        • To learn more, see here
  • 🚀🚀 Sealing scheduler enhancements (#7703, #7269), #7714
  • 🚀🚀 Sector storage groups (#7453)
    • Storage groups allow for better control of data flow between workers, for example, it makes it possible to define that data from PC1 on a given worker has to have it's PC2 step executed on the same worker
    • To set it up, follow the instructions under the Sector Storage Group section here

New Features

  • Add RLE dump code (#7691)
  • Shed: Add a util to list miner faults (#7605)
  • lotus-shed msg: Decode submessages/msig proposals (#7639)
  • CLI: Add a lotus multisig cancel command (#7645)
  • shed: simple wallet balancer util (#7414)
    • balancing token balance between multiple accounts

Improvements

  • Add verbose mode to lotus-miner pieces list-cids (#7699)
  • retrieval: Only output matching nodes, MatchPath dagspec (#7706)
  • Cleanup partial retrieval codepaths ( zero functional changes ) (#7688)
  • storage: Use 1M buffers for Tar transfers (#7681)
  • Chore/dm level tests plus merkle proof cars (#7673)
  • Shed: Add a util to create miners more easily (#7595)
  • add timeout flag to wait-api command (#7592)
  • add log for restart windows post scheduler (#7613)
  • remove jaeger envvars (#7631)
  • remove api and jaeger env from docker file (#7624)
  • Wdpost worker: Reduce challenge confidence to 1 epoch (#7572)
  • add additional methods to lotus gateway (#7644)
  • Add caches to lotus-stats and splitcode (#7329)
  • remote store: Remove debug printf (#7664)
  • docsgen-cli: Handle commands with no description correctly (#7659)

Bug Fixes

  • fix docker logic error (#7709)
  • add missing NodeType tag (#7559)
  • checkCommit should return SectorCommitFailed (#7555)
  • ffiwrapper: Validate PC2 by calling C1 with random seeds (#7710)

Dependency Updates

  • Update go-graphsync v0.10.6 (#7708)
  • update go-libp2p-pubsub to v0.5.6 (#7581)
  • Update go-state-types (#7591)
  • disable mplex stream muxer (#7689)
  • Bump ws from 5.2.2 to 5.2.3 in /lotuspond/front (#7660)
  • Bump color-string from 1.5.3 to 1.6.0 in /lotuspond/front (#7658)
  • Bump postcss from 7.0.17 to 7.0.39 in /lotuspond/front (#7657)
  • Bump path-parse from 1.0.6 to 1.0.7 in /lotuspond/front (#7656)
  • Bump tmpl from 1.0.4 to 1.0.5 in /lotuspond/front (#7655)
  • Bump url-parse from 1.4.7 to 1.5.3 in /lotuspond/front (#7654)
  • github.com/filecoin-project/go-state-types (v0.1.1-0.20210915140513-d354ccf10379 -> v0.1.1):

Others

  • Update archive script (#7690)

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 89 +5200/-1818 232
Travis Person 5 +1473/-953 38
@arajasek 6 +550/-38 19
@clinta 4 +393/-123 26
@ribasushi 3 +334/-68 7
@jennijuju 13 +197/-120 67
@Kubuxu 10 +153/-30 10
@coryschwartz 6 +18/-26 6
Marten Seemann 2 +6/-34 5
@vyzo 1 +3/-3 2
@hannahhoward 1 +3/-3 2
@zenground0 2 +2/-2 2
@yaohcn 2 +2/-2 2
@jennijuju 1 +1/-1 1
@hunjixin 1 +1/-0 1

v1.13.1 / 2021-11-26

This is an optional Lotus v1.13.1 release.

New Features

Improvements

Bug Fixes

Dependency Updates

  • Update go-graphsync v0.10.1 (filecoin-project/lotus#7457)
  • update to proof v10.1.0 (filecoin-project/lotus#7564)
  • github.com/filecoin-project/specs-actors/v6 (v6.0.0 -> v6.0.1):
  • github.com/filecoin-project/go-jsonrpc (v0.1.4-0.20210217175800-45ea43ac2bec -> v0.1.5):
  • github.com/filecoin-project/go-fil-markets (v1.13.1 -> v1.13.3):
  • github.com/filecoin-project/go-data-transfer (v1.11.1 -> v1.11.4):
  • github.com/filecoin-project/go-crypto (v0.0.0-20191218222705-effae4ea9f03 -> v0.0.1):
  • github.com/filecoin-project/go-commp-utils (v0.1.1-0.20210427191551-70bf140d31c7 -> v0.1.2):
  • github.com/filecoin-project/go-cbor-util (v0.0.0-20191219014500-08c40a1e63a2 -> v0.0.1):
  • github.com/filecoin-project/go-address (v0.0.5 -> v0.0.6):
  • unpin the yamux dependency (filecoin-project/lotus#7532
  • [email protected] was withdrawn, let's not depend on it directly (filecoin-project/lotus#7481)
  • chore(deps): use tagged github.com/ipld/go-ipld-selector-text-lite (filecoin-project/lotus#7464)
  • Stop indirectly depending on deprecated github.com/prometheus/common (filecoin-project/lotus#7473)

Others

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 27 +1285/-531 76
@ribasushi 7 +265/-1635 21
@raulk 2 +2/-737 13
@nonsens 4 +391/-21 19
@arajasek 6 +216/-23 14
@jennijuju 8 +102/-37 29
Steven Allen 2 +77/-29 6
@jennijuju 4 +19/-18 11
@dirkmc 2 +9/-9 4
@@coryschwartz 1 +16/-2 2
@frrist 1 +12/-0 2
@Kubuxu 5 +5/-5 5
@hunjixin 2 +6/-3 2
@vyzo 1 +3/-3 2
@@rvagg 1 +3/-3 2
@hannahhoward 1 +3/-2 2
Marten Seemann 1 +3/-0 1
@ZenGround0 1 +1/-1 1

v1.13.0 / 2021-10-18

Lotus v1.13.0 is a highly recommended feature release for all lotus users(i.e: storage providers, data brokers, application developers and so on) that supports the upcoming Network v14 Chocolate upgrade. This feature release includes the latest functionalities and improvements, like data transfer rate-limiting for both storage and retrieval deals, proof v10 with CUDA support, etc. You can find more details in the Changelog below.

Highlights

  • Enable separate storage and retrieval transfer limits (filecoin-project/lotus#7405)
    • SimultaneousTransfer is now replaced by SimultaneousTransfersForStorage and SimultaneousTransfersForRetrieval, where users may set the amount of ongoing data transfer for storage and retrieval deals in parallel separately. The default value for both is set to 20.
    • If you are using the lotus client, these two configuration variables are under the Client section in ./lotus/config.toml.
    • If you are a service provider, these two configuration variables should be set under the Dealmaking section in /.lotusminer/config.toml.
  • Update proofs to v10.0.0 (filecoin-project/lotus#7420)
    • This version supports CUDA. To enable CUDA instead of openCL, build lotus with FFI_USE_CUDA=1 FFI_BUILD_FROM_SOURCE=1 ....
    • You can find additional Nvidia driver installation instructions written by MinerX fellows here and perf improvements result on PC2/C2/WindowPoSt computation on different profiles here, most people observe a 30-50% decrease in computation time.

New Features

Improvements

Bug Fixes

Dependency Updates

  • github.com/filecoin-project/go-data-transfer (v1.10.1 -> v1.11.1):
  • github.com/filecoin-project/go-fil-markets (v1.12.0 -> v1.13.1):
  • github.com/filecoin-project/go-paramfetch (v0.0.2-0.20210614165157-25a6c7769498 -> v0.0.2):
  • update go-libp2p to v0.15.0 (filecoin-project/lotus#7362)
  • update to go-graphsync v0.10.1 (filecoin-project/lotus#7359)

Others

Contributors

Contributor Commits Lines ± Files Changed
@dirkmc 8 +845/-375 55
@magik6k 10 +1056/-60 26
@aarshkshah1992 6 +813/-259 16
@arajasek 10 +552/-251 43
@ribasushi 6 +505/-78 22
@jennijuju 7 +212/-323 34
@nonsense 10 +335/-139 19
@dirkmc 8 +149/-55 16
@hannahhoward 4 +56/-32 17
@rvagg 4 +61/-13 9
@jennijuju 2 +0/-57 2
@hannahhoward 1 +33/-18 7
@Kubuxu 8 +27/-16 9
@coryschwartz 1 +16/-2 2
@travisperson 1 +14/-0 1
@frrist 1 +12/-0 2
@ognots 1 +0/-10 2
@lanzafame 1 +3/-3 1
@jennijuju 1 +2/-2 1
@swift-mx 1 +1/-1 1

v1.12.0 / 2021-10-12

This is a mandatory release of Lotus that introduces Filecoin Network v14, codenamed the Chocolate upgrade. The Filecoin mainnet will upgrade at epoch 1231620, on 2021-10-26T13:30:00Z.

The Chocolate upgrade introduces the following FIPs, delivered in v6 actors

  • FIP-0020: Add return value to WithdrawBalance
  • FIP-0021: Correct quality calculation on expiration
  • FIP-0022: Bad deals don't fail PublishStorageDeals
  • FIP-0023: Break ties between tipsets of equal weight
  • FIP-0024: BatchBalancer & BatchDiscount Post-HyperDrive Adjustment
  • FIP-0026: Extend sector faulty period from 2 weeks to 6 weeks

Note that this release is built on top of lotus v1.11.3. Enterprising users like storage providers, data brokers and others are recommended to use lotus v1.13.0 for latest new features, improvements and bug fixes.

New Features and Changes

  • Implement and support FIP-0024 BatchBalancer & BatchDiscount Post-HyperDrive Adjustment:
    • Precommit batch balancer support/config (filecoin-project/lotus#7410)
      • Set BatchPreCommitAboveBaseFee to decide whether sending out a PreCommits in individual messages or in a batch.
      • The default value of BatchPreCommitAboveBaseFee and AggregateAboveBaseFee are now updated to 0.32nanoFIL.
  • The amount of FIL withdrawn from WithdrawBalance from miner or market via lotus CLI is now printed out upon message landing on the chain.

Improvements

Bug Fixes

Dependency Updates

  • Add v6 actors
    • Protocol changes
      • Multisig Approve only hashes when hash in params
      • FIP 0020 WithdrawBalance methods return withdrawn value
      • FIP 0021 Fix bug in power calculation when extending verified deals sectors
      • FIP 0022 PublishStorageDeals drops errors in batch
      • FIP 0024 BatchBalancer update and burn added to PreCommitBatch
      • FIP 0026 Add FaultMaxAge extension
      • Reduce calls to power and reward actors by passing values from power cron
      • Defensive programming hardening power cron against programmer error
    • Implementation changes
      • Move to xerrors
      • Improved logging: burn events are not logged with reasons and burned value.
  • github.com/filecoin-project/go-state-types (v0.1.1-0.20210810190654-139e0e79e69e -> v0.1.1-0.20210915140513-d354ccf10379):

Others

Contributors

Contributor Commits Lines ± Files Changed
@ZenGround0 12 +4202/-2752 187
@arajasek 25 +4567/-854 190
@laudiacay 4 +1276/-435 37
@laudiacay 12 +1350/-209 43
@magik6k 1 +171/-13 8
@Stebalien 2 +115/-12 6
@jennijuju 7 +73/-34 26
@travisperson 2 +19/-19 7
@coryschwartz 1 +16/-2 2
@Kubuxu 5 +5/-5 5
@ribasushi 1 +5/-3 1

v1.11.3 / 2021-09-29

lotus v1.11.3 is a feature release that's highly recommended to ALL lotus users to upgrade, including node operators, storage providers and clients. It includes many improvements and bug fixes that result in perf improvements in different area, like deal making, sealing and so on.

Highlights

  • 🌟🌟Introduce `MaxStagingDealsBytes - reject new deals if our staging deals area is full (filecoin-project/lotus#7276)
    • Set MaxStagingDealsBytes under the [Dealmaking] section of the markets' subsystem's config.toml to reject new incoming deals when the deal-staging directory of market subsystem's repo gets too large.
  • 🌟🌟miner: Command to list/remove expired sectors locally (filecoin-project/lotus#7140)
    • run ./lotus-miner sectors expired -h for more details.
  • 🚀update to ffi to update-bellperson-proofs-v9-0-2 (filecoin-project/lotus#7369)
    • MinerX fellows(early testers of lotus releases) have reported faster WindowPoSt computation!
  • 🌟dealpublisher: Fully validate deals before publishing (filecoin-project/lotus#7234)
    • This excludes the expired deals before sending out a PSD message which reduces the chances of PSD message failure due to invalid deals.
  • 🌟Simple alert system; FD limit alerts (filecoin-project/lotus#7108)

New Features

Improvements

Bug Fixes

Dependency Updates

  • github.com/filecoin-project/go-fil-markets (v1.8.1 -> v1.12.0):
  • github.com/filecoin-project/go-data-transfer (v1.7.8 -> v1.10.1):
  • update to ffi to update-bellperson-proofs-v9-0-2 (filecoin-project/lotus#7369)
  • fix(deps): use go-graphsync v0.9.3 with hotfix
  • Update to unified go-graphsync v0.9.0 (filecoin-project/lotus#7197)

Others

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 39 +3311/-1825 179
@Stebalien 23 +1935/-1417 84
@dirkmc 12 +921/-732 111
@dirkmc 12 +663/-790 30
@hannahhoward 3 +482/-275 46
@travisperson 1 +317/-65 5
@jennijuju 11 +223/-126 24
@hannahhoward 7 +257/-55 16
@nonsense 9 +258/-37 19
@raulk 4 +127/-36 13
@raulk 1 +43/-60 15
@arajasek 4 +74/-8 10
@Frank 2 +68/-8 3
@placer14 2 +52/-1 4
@ldoublewood 2 +15/-13 3
@lanzafame 1 +16/-2 1
@aarshkshah1992 2 +11/-6 2
@ZenGround0 2 +7/-6 2
@ognots 1 +0/-10 2
@KAYUII 2 +4/-4 2
@lanzafame 1 +6/-0 1
@jacobheun 1 +3/-3 1
@frank 1 +4/-0 1

v1.11.2 / 2021-09-06

lotus v1.11.2 is a feature release that's highly recommended ALL lotus users to upgrade, including node operators, storage providers and clients.

Highlights

  • 🌟🌟🌟 Introduce Dagstore and CARv2 for deal-making (#6671) (filecoin-project/lotus#6671)
    • lotus miner markets' Dagstore is a component of the markets subsystem in lotus-miner. It is a sharded store to hold large IPLD graphs efficiently, packaged as location-transparent attachable CAR files and it replaces the former Badger staging blockstore. It is designed to provide high efficiency and throughput, and minimize resource utilization during deal-making operations.
      The dagstore also leverages the indexing features of CARv2 to enable plan CAR files to act as read and write blockstores, which are served as the direct medium for data exchanges in markets for both storage and retrieval deal making without requiring intermediate buffers.
    • In the future, lotus will leverage and interact with Dagstore a lot for new features and improvements for deal making, therefore, it's highly recommended to lotus users to go through Lotus Miner: About the markets dagstore thoroughly to learn more about Dagstore's conceptual overview, terminology, directory structure, configuration and so on.
    • Note:
      • When you first start your lotus-miner or market subsystem with this release, a one-time/first-time dagstore migration will be triggered which replaces the former Badger staging blockstore with dagstore. We highly recommend storage providers to read this section to learn more about what the process does, what to expect and how monitor it.
      • It is highly recommended to wait all ongoing data transfer to finish or cancel inbound storage deals that are still transferring, using the lotus-miner data-transfers cancel command before upgrade your market nodes. Reason being that the new dagstore changes attributes in the internal deal state objects, and the paths to the staging CARs where the deal data was being placed will be lost.
      • ‼️Having your dags initialized will become important in the near feature for you to provide a better storage and retrieval service. We'd suggest you to start [forced bulk initialization] soon if possible as this process places relatively high IP workload on your storage system and is better to be carried out gradually and over a longer timeframe. Read how to do properly perform a force bulk initialization here.
      • ⏮ Rollback Alert(from v1.11.2-rcX to any version lower): If a storages deal is initiated with M1/v1.11.2(-rcX) release, it needs to get to the StorageDealAwaitingPrecommit state before you can do a version rollback or the markets process may panic.
    • 💙 Special thanks to MinerX fellows for testing and providing valuable feedbacks for Dagstore in the past month!
  • 🌟🌟 rpcenc: Support reader redirect (filecoin-project/lotus#6952)
    • This allows market processes to send piece bytes directly to workers involved on AddPiece.
  • Extending sectors: more practical and flexible tools (filecoin-project/lotus#6097)
    • lotus-miner sectors check-expire to inspect expiring sectors.
    • lotus-miner sectors renew for renewing expiring sectors, see the command help menu for customizable option like extension, new-expiration and so on.
  • ‼️ MpoolReplaceCmd ( lotus mpool replace`) now takes FIL for fee-limit (filecoin-project/lotus#6927)
  • Drop townhall/chainwatch (filecoin-project/lotus#6912)
    • ChainWatch is no longer supported by lotus.
  • Configurable CC Sector Expiration (filecoin-project/lotus#6803)
    • Set CommittedCapacitySectorLifetime in lotus-miner/config.toml to specify the default expiration for a new CC sector, value must be between 180-540 days inclusive.

New Features

Improvements

Bug Fixes

Dependency Updates

Others

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 23 +5040/-8389 114
@aarshkshah1992 11 +4859/-1078 101
@raulk 5 +4170/-1662 104
@vyzo 30 +1092/-702 49
@nonsense 6 +630/-472 19
@ZenGround0 31 +556/-274 74
@He Weidong 16 +680/-128 16
@raulk 16 +444/-277 49
@Stebalien 11 +403/-259 48
@jennijuju 17 +276/-281 42
@dirkmc 5 +204/-138 20
@placer14 7 +178/-77 17
@BlocksOnAChain 1 +138/-0 1
@Frrist 1 +63/-56 2
@arajasek 7 +74/-42 13
@frrist 2 +67/-6 6
@hannahhoward 2 +13/-11 3
@coryschwartz 1 +16/-6 3
@whyrusleeping 1 +7/-7 1
@hunjixin 1 +8/-6 1
@aarshkshah1992 1 +6/-6 2
@dirkmc 2 +8/-0 2
@mx 2 +6/-1 2
@travisperson 1 +3/-2 1
@jennijuju 2 +2/-2 2
@ribasushi 1 +1/-2 2

1.11.1 / 2021-08-16

Note: for discussion about this release, please comment here

This is a highly recommended but optional Lotus v1.11.1 release that introduces many deal making and datastore improvements and new features along with other bug fixes.

Highlights

  • ⭐️⭐️⭐️lotus-miner market subsystem is introduced in this release! It is highly recommended for storage providers to run markets processes on a separate machine! Doing so, only this machine needs to exposes public ports for deal making. This also means that the other miner operations can now be completely isolated by from the deal making processes and storage providers can stop and restarts the markets process without affecting an ongoing Winning/Window PoSt!
    • More details on the concepts, architecture and how to split the market process can be found here.
    • Base on your system setup(running on separate machines, same machine and so on), please see the suggested practice by community members here.
      • Note: if you are running lotus-worker on a different machine, you will need to set MARKETS_API_INFO for certain CLI to work properly. This will be improved by #7072.
    • Huge thanks to MinerX fellows for helping testing the implementation, reporting the issues so they were fixed by now and providing feedbacks to user docs in the past three weeks!
  • Config for collateral from miner available balance (filecoin-project/lotus#6629)
    • Better control your sector collateral payment by setting CollateralFromMinerBalance, AvailableBalanceBuffer and DisableCollateralFallback.
      • CollateralFromMinerBalance: whether to use available miner balance for sector collateral instead of sending it with each message, default is false.
      • AvailableBalanceBuffer: minimum available balance to keep in the miner actor before sending it with messages, default is 0FIL.
      • DisableCollateralFallback: whether to send collateral with messages even if there is no available balance in the miner actor, default is false.
  • Config for deal publishing control addresses (filecoin-project/lotus#6697)
    • Set DealPublishControl to set the wallet used for sending PublishStorageDeals messages, instructions here.
  • Config UX improvements (filecoin-project/lotus#6848)
    • You can now preview the the default and updated node config by running lotus/lotus-miner config default/updated

New Features

Bug Fixes

Improvements

Dependency Updates

  • Update to proof v8.0.3 (filecoin-project/lotus#6890)
  • update to go-fil-market v1.6.0 (filecoin-project/lotus#6885)
  • Bump go-multihash, adjust test for supported version (filecoin-project/lotus#6674)
  • github.com/filecoin-project/go-data-transfer (v1.6.0 -> v1.7.2):
  • github.com/filecoin-project/go-fil-markets (v1.5.0 -> v1.6.2):
  • github.com/filecoin-project/go-padreader (v0.0.0-20200903213702-ed5fae088b20 -> v0.0.0-20210723183308-812a16dc01b1)
  • github.com/filecoin-project/go-state-types (v0.1.1-0.20210506134452-99b279731c48 -> v0.1.1-0.20210810190654-139e0e79e69e)
  • github.com/filecoin-project/go-statemachine (v0.0.0-20200925024713-05bd7c71fbfe -> v1.0.1)
  • update go-libp2p-pubsub to v0.5.0 (filecoin-project/lotus#6764)

Others

Contributors

Contributor Commits Lines ± Files Changed
@vyzo 313 +8928/-6010 415
@nonsense 103 +6041/-4041 304
@magik6k 37 +3851/-1611 146
@ZenGround0 24 +1693/-1394 95
@placer14 1 +2310/-578 8
@dirkmc 7 +1154/-726 29
@raulk 44 +969/-616 141
@jennijuju 15 +682/-354 47
@ribasushi 18 +469/-273 64
@coryschwartz 5 +576/-135 14
@hunjixin 7 +404/-82 19
@dirkmc 17 +348/-47 17
@tchardin 2 +262/-34 5
@aarshkshah1992 9 +233/-63 44
@Kubuxu 4 +254/-16 4
@hannahhoward 6 +163/-75 8
@whyrusleeping 4 +157/-16 9
@Whyrusleeping 2 +87/-66 10
@arajasek 10 +81/-53 13
@zgfzgf 2 +104/-4 2
@aarshkshah1992 6 +85/-19 10
@llifezou 4 +59/-20 4
@Stebalien 7 +47/-17 9
@johnli-helloworld 3 +46/-15 5
@frrist 1 +28/-23 2
@hannahhoward 4 +46/-5 11
@Jennifer 4 +31/-2 4
@wangchao 1 +1/-27 1
@jennijuju 2 +7/-21 2
@chadwick2143 1 +15/-1 1
@Jerry 2 +9/-4 2
Steve Loeppky 2 +12/-0 2
David Dias 1 +9/-0 1
dependabot[bot] 1 +3/-3 1
zhoutian527 1 +2/-2 1
xloem 1 +4/-0 1
2 +2/-2 3
Liviu Damian 2 +2/-2 2
@jimpick 2 +2/-2 2
Frank 1 +3/-0 1
turuslan 1 +1/-1 1
Kirk Baird 1 +0/-0 1

1.11.0 / 2021-07-22

This is a highly recommended release of Lotus that have many bug fixes, improvements and new features.

Highlights

More New Features

Bug Fixes

Improvements

Dependency Updates

Others

Contributors

Contributor Commits Lines ± Files Changed
@raulk 118 +11972/-10860 472
@magik6k 65 +10824/-4158 353
@aarshkshah1992 59 +8057/-3355 224
@arajasek 41 +8786/-1691 331
@Stebalien 106 +7653/-2718 273
dirkmc 11 +2580/-1371 77
@dirkmc 39 +1865/-1194 79
19 +1973/-485 81
@vyzo 4 +1748/-330 50
@aarshkshah1992 5 +1462/-213 27
@coryschwartz 35 +568/-206 59
@chadwick2143 3 +739/-1 4
@ribasushi 21 +487/-164 36
@hannahhoward 5 +544/-5 19
@jennijuju 9 +241/-174 19
@frrist 1 +137/-88 7
@travisperson 3 +175/-6 7
@wadeAlexC 1 +48/-129 1
@whyrusleeping 8 +161/-13 11
lotus 1 +114/-46 1
@nonsense 8 +107/-53 20
@rjan90 4 +115/-33 4
@ZenGround0 3 +114/-1 4
@Aloxaf 1 +43/-61 7
@yaohcn 4 +89/-9 5
@mitchellsoo 1 +51/-0 1
@placer14 3 +28/-18 4
@jennijuju 6 +9/-14 6
@Frank 2 +11/-10 2
@wangchao 3 +5/-4 4
@Steve Loeppky 1 +7/-1 1
@Lion 1 +4/-2 1
@Mimir 1 +2/-2 1
@raulk 1 +1/-1 1
@Jack Yao 1 +1/-1 1
@IPFSUnion 1 +1/-1 1

1.10.1 / 2021-07-05

This is an optional but highly recommended release of Lotus for lotus miners that has many bug fixes and improvements based on the feedback we got from the community since HyperDrive.

New Features

  • commit batch: AggregateAboveBaseFee config #6650
    • AggregateAboveBaseFee is added to miner sealing configuration for setting the network base fee to start aggregating proofs. When the network base fee is lower than this value, the prove commits will be submitted individually via ProveCommitSector. According to the Batch Incentive Alignment introduced in FIP-0013, we recommend miners to set this value to 0.15 nanoFIL(which is the default value) to avoid unexpected aggregation fee in burn and enjoy the most benefits of aggregation!

Bug Fixes

  • storage: Fix FinalizeSector with sectors in storage paths #6652
  • Fix tiny error in check-client-datacap #6664
  • Fix: precommit_batch method used the wrong cfg.PreCommitBatchWait #6658
  • to optimize the batchwait #6636
  • fix getTicket: sector precommitted but expired case #6635
  • handleSubmitCommitAggregate() exception handling #6595
  • remove precommit check in handleCommitFailed #6634
  • ensure agg fee is adequate
  • fix: miner balance is not enough, so that ProveCommitAggregate msg exec failed #6623
  • commit batch: Initialize the FailedSectors map #6647

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 7 +151/-56 21
@llifezou 4 +59/-20 4
@johnli-helloworld 2 +45/-14 4
@wangchao 1 +1/-27 1
Jerry 2 +9/-4 2
@zhoutian527 1 +2/-2 1
@ribasushi 1 +1/-1 1

1.10.1 / 2021-07-05

This is an optional but highly recommended release of Lotus for lotus miners that has many bug fixes and improvements based on the feedback we got from the community since HyperDrive.

New Features

  • commit batch: AggregateAboveBaseFee config #6650
    • AggregateAboveBaseFee is added to miner sealing configuration for setting the network base fee to start aggregating proofs. When the network base fee is lower than this value, the prove commits will be submitted individually via ProveCommitSector. According to the Batch Incentive Alignment introduced in FIP-0013, we recommend miners to set this value to 0.15 nanoFIL(which is the default value) to avoid unexpected aggregation fee in burn and enjoy the most benefits of aggregation!

Bug Fixes

  • storage: Fix FinalizeSector with sectors in storage paths #6652
  • Fix tiny error in check-client-datacap #6664
  • Fix: precommit_batch method used the wrong cfg.PreCommitBatchWait #6658
  • to optimize the batchwait #6636
  • fix getTicket: sector precommitted but expired case #6635
  • handleSubmitCommitAggregate() exception handling #6595
  • remove precommit check in handleCommitFailed #6634
  • ensure agg fee is adequate
  • fix: miner balance is not enough, so that ProveCommitAggregate msg exec failed #6623
  • commit batch: Initialize the FailedSectors map #6647

Contributors

Contributor Commits Lines ± Files Changed
@magik6k 7 +151/-56 21
@llifezou 4 +59/-20 4
@johnli-helloworld 2 +45/-14 4
@wangchao 1 +1/-27 1
Jerry 2 +9/-4 2
@zhoutian527 1 +2/-2 1
@ribasushi 1 +1/-1 1

1.10.0 / 2021-06-23

This is a mandatory release of Lotus that introduces Filecoin network v13, codenamed the HyperDrive upgrade. The Filecoin mainnet will upgrade, which is epoch 892800, on 2021-06-30T22:00:00Z. The network upgrade introduces the following FIPs:

  • FIP-0008: Add miner batched sector pre-commit method
  • FIP-0011: Remove reward auction from reporting consensus faults
  • FIP-0012: DataCap Top up for FIL+ Client Addresses
  • FIP-0013: Add ProveCommitSectorAggregated method to reduce on-chain congestion
  • FIP-0015: Revert FIP-0009(Exempt Window PoSts from BaseFee burn)

Note that this release is built on top of Lotus v1.9.0. Enterprising users can use the master branch of Lotus to get the latest functionality, including all changes in this release candidate.

Proof batching and aggregation

FIPs 0008 and 0013 combine to allow for a significant increase in the rate of onboarding storage on the Filecoin network. This aims to lead to more useful data being stored on the network, reduced network congestion, and lower network base fee.

Check out the documentation here for details on the new Lotus miner sealing config options, here for fee config options, and explanations of the new features.

Note:

  • We recommend to keep PreCommitSectorsBatch as 1.
  • We recommend miners to set PreCommitBatchWait lower than 30 hours.
  • We recommend miners to set a longer CommitBatchSlack and PreCommitBatchSlack to prevent message failures due to expirations.

Projected state tree growth

In order to validate the Hyperdrive changes, we wrote a simulation to seal as many sectors as quickly as possible, assuming the same number and mix of 32GiB and 64GiB miners as the current network.

Given these assumptions:

  • We'd expect a network storage growth rate of around 530PiB per day. 😳 🎉 🥳 😅
  • We'd expect network bandwidth dedicated to SubmitWindowedPoSt to grow by about 0.02% per day.
  • We'd expect the state-tree (and therefore snapshot) size to grow by 1.16GiB per day.
    • Nearly all of the state-tree growth is expected to come from new sector metadata.
  • We'd expect the daily lotus datastore growth rate to increase by about 10-15% (from current ~21GiB/day).
    • Most "growth" of the lotus datastore is due to "churn", historical data that's no longer referenced by the latest state-tree.

Future improvements

Various Lotus improvements are planned moving forward to mitigate the effects of the growing state tree size. The primary improvement is the Lotus splitstore, which will soon be enabled by default. The feature allows for online garbage collection for nodes that do not seek to maintain full chain and state history, thus eliminating the need for users to delete their datastores and sync from snapshots.

Other improvements including better compressed snapshots, faster pre-migrations, and improved chain exports are in the roadmap.

WindowPost base fee burn

Included in the HyperDrive upgrade is FIP-0015 which eliminates the special-case gas treatment of SubmitWindowedPoSt messages that was introduced in FIP-0009. Although SubmitWindowedPoSt messages will be relatively cheap, thanks to the introduction of optimistic acceptance of these proofs in FIP-0010, storage providers should pay attention to their MaxWindowPoStGasFee config option: too low and PoSts may not land on chain; too high and they may cost an exorbitant amount!

Changelog

New Features

Bug Fixes

Improvements

Dependency Updates

  • Proofs v8.0.2 (filecoin-project/lotus#6524)
  • Update to fixed Bellperson (filecoin-project/lotus#6480)
  • Update to go-praamfetch with fslocks (filecoin-project/lotus#6473)
  • Update ffi with fixed multicore sdr support (filecoin-project/lotus#6471)
  • github.com/filecoin-project/go-paramfetch (v0.0.2-0.20200701152213-3e0f0afdc261 -> v0.0.2-0.20210614165157-25a6c7769498)
  • github.com/filecoin-project/specs-actors/v5 (v5.0.0-20210512015452-4fe3889fff57 -> v5.0.0)
  • github.com/filecoin-project/go-hamt-ipld/v3 (v3.0.1 -> v3.1.0)
  • github.com/ipfs/go-log/v2 (v2.1.2-0.20200626104915-0016c0b4b3e4 -> v2.1.3)
  • github.com/filecoin-project/go-amt-ipld/v3 (v3.0.0 -> v3.1.0)

Network Version v13 HyperDrive Upgrade

Contributors

💙Thank you to all the contributors!

Contributor Commits Lines ± Files Changed
@magik6k 81 +9606/-1536 361
@arajasek 41 +6543/-679 189
@ZenGround0 11 +4074/-727 110
@anorth 10 +2035/-1177 55
@iand 1 +779/-12 5
@frrist 2 +722/-6 6
@Stebalien 6 +368/-24 15
@jennijuju 11 +204/-111 19
@vyzo 6 +155/-66 13
@coryschwartz 10 +171/-27 14
@Kubuxu 4 +177/-13 7
@ribasushi 4 +65/-42 5
@travisperson 2 +11/-11 4
@kirk-baird 1 +1/-5 1
@wangchao 2 +3/-2 2

1.9.0 / 2021-05-17

This is an optional Lotus release that introduces various improvements to the sealing, mining, and deal-making processes.

Highlights

Changes

  • storagefsm: Apply global events even in broken states (#5962)
  • Default the AlwaysKeepUnsealedCopy flag to true (#5743)
  • splitstore: compact hotstore prior to garbage collection (#5778)
  • ipfs-force bootstrapper update (#5799)
  • better logging when unsealing fails (#5851)
  • perf: add cache for gas permium estimation (#5709)
  • backupds: Compact log on restart (#5875)
  • backupds: Improve truncated log handling (#5891)
  • State CLI improvements (State CLI improvements)
  • API proxy struct codegen (#5854)
  • move DI stuff for paychmgr into modules (#5791)
  • Implement Event observer and Settings for 3rd party dep injection (#5693)
  • Export developer and network commands for consumption by derivatives of Lotus (#5864)
  • mock sealer: Simulate randomness sideeffects (#5805)
  • localstorage: Demote reservation stat error to debug (#5976)
  • shed command to unpack miner info dumps (#5800)
  • Add two utils to Lotus-shed (#5867)
  • add shed election estimate command (#5092)
  • Add --actor flag in lotus-shed sectors terminate (#5819)
  • Move lotus mpool clear to lotus-shed (#5900)
  • Centralize everything on ipfs/go-log/v2 (#5974)
  • expose NextID from nice market actor interface (#5850)
  • add available options for perm on error (#5814)
  • API docs clarification: Document StateSearchMsg replaced message behavior (#5838)
  • api: Document StateReplay replaced message behavior (#5840)
  • add godocs to miner objects (#2184)
  • Add description to the client deal CLI command (#5999)
  • lint: don't skip builtin (#5881)
  • use deal duration from actors (#5270)
  • remote calc winningpost proof (#5884)
  • packer: other network images (#5930)
  • Convert the chainstore lock to RW (#5971)
  • Remove CachedBlockstore (#5972)
  • remove messagepool CapGasFee duplicate code (#5992)
  • Add a mining-heartbeat INFO line at every epoch (#6183)
  • chore(ci): Enable build on RC tags (#6245)
  • Upgrade nerpa to actor v4 and bump the version to rc4 (#6249)

Fixes

  • return buffers after canceling badger operation (#5796)
  • avoid holding a lock while calling the View callback (#5792)
  • storagefsm: Trigger input processing when below limits (#5801)
  • After importing a previously deleted key, be able to delete it again (#4653)
  • fix StateManager.Replay on reward actor (#5804)
  • make sure atomic 64bit fields are 64bit aligned (#5794)
  • Import secp sigs in paych tests (#5879)
  • fix ci build-macos (#5934)
  • Fix creation of remainder account when it's not a multisig (#5807)
  • Fix fallback chainstore (#6003)
  • fix 4857: show help for set-addrs (#5943)
  • fix health report (#6011)
  • fix(ci): Use recent ubuntu LTS release; Update release params ((#6011))

1.8.0 / 2021-04-05

This is a mandatory release of Lotus that upgrades the network to version 12, which introduces various performance improvements to the cron processing of the power actor. The network will upgrade at height 712320, which is 2021-04-29T06:00:00Z.

Changes

  • v4 specs-actors integration, nv12 migration (#6116)

1.6.0 / 2021-04-05

This is a mandatory release of Lotus that upgrades the network to version 11, which implements FIP-0014. The network will upgrade at height 665280, which is 2021-04-12T22:00:00Z.

v1 sector extension CLI

This release also expands the lotus-miner sectors extend CLI, with a new option that automatically extends all extensible v1 sectors. The option can be run using lotus-miner sectors extend --v1-sectors.

  • The tolerance flag can be passed to indicate what durations aren't "worth" extending. It defaults to one week, which means that sectors whose current lifetime's are within one week of the maximum possible lifetime will not be extended.

  • The expiration-cutoff flag can be passed to skip sectors whose expiration is past a certain point from the current head. It defaults to infinity (no cutoff), but if, say, 28800 was specified, then only sectors expiring in the next 10 days would be extended (2880 epochs in 1 day).

Changes

  • Util for miners to extend all v1 sectors (#5924)
  • Upgrade the butterfly network (#5929)
  • Introduce the v11 network upgrade (#5904)
  • Debug mode: Make upgrade heights controllable by an envvar (#5919)

1.5.3 / 2021-03-24

This is a patch release of Lotus that introduces small fixes to the Storage FSM.

Changes

  • storagefsm: Fix double unlock with ready WaitDeals sectors (#5783)
  • backupds: Allow larger values in write log (#5776)
  • storagefsm: Don't log the SectorRestart event (#5779)

1.5.2 / 2021-03-11

This is an hotfix release of Lotus that fixes a critical bug introduced in v1.5.1 in the miner windowPoSt logic. This upgrade is only affecting miner nodes.

Changes

  • fix window post rand check (#5773)
  • wdpost: Always use head tipset to get randomness (#5774)

1.5.1 / 2021-03-10

This is an optional release of Lotus that introduces an important fix to the WindowPoSt computation process. The change is to wait for some confidence before drawing beacon randomness for the proof. Without this, invalid proofs might be generated as the result of a null tipset.

Splitstore

This release also introduces the splitstore, a new optional blockstore that segregates the monolithic blockstore into cold and hot regions. The hot region contains objects from the last 4-5 finalities plus all reachable objects from two finalities away. All other objects are moved to the cold region using a compaction process that executes every finality, once 5 finalities have elapsed.

The splitstore allows us to separate the two regions quite effectively, using two separate badger blockstores. The separation means that the live working set is much smaller, which results in potentially significant performance improvements. In addition, it means that the coldstore can be moved to a separate (bigger, slower, cheaper) disk without loss of performance.

The design also allows us to use different implementations for the two blockstores; for example, an append-only blockstore could be used for coldstore and a faster memory mapped blockstore could be used for the hotstore (eg LMDB). We plan to experiment with these options in the future.

Once the splitstore has been enabled, the existing monolithic blockstore becomes the coldstore. On the first head change notification, the splitstore will warm up the hotstore by copying all reachable objects from the current tipset into the hotstore. All new writes go into the hotstore, with the splitstore tracking the write epoch. Once 5 finalities have elapsed, and every finality thereafter, the splitstore compacts by moving cold objects into the coldstore. There is also experimental support for garbage collection, whereby nunreachable objects are simply discarded.

To enable the splitstore, add the following to config.toml:

[Chainstore]
  EnableSplitstore = true

Highlights

Other highlights include:

  • Improved deal data handling - now multiple deals can be adding to sectors in parallel
  • Rewriten sector pledging - it now actually cares about max sealing sector limits
  • Better handling for sectors stuck in the RecoverDealIDs state
  • lotus-miner sectors extend command
  • Optional configurable storage path size limit
  • Config to disable owner/worker fallback from control addresses (useful when owner is a key on a hardware wallet)
  • A write log for node metadata, which can be restored as a backup when the metadata leveldb becomes corrupted (e.g. when you run out of disk space / system crashes in some bad way)

Changes

  • avoid use mp.cfg directly to avoid race (#5350)
  • Show replacing message CID is state search-msg cli (#5656)
  • Fix riceing by importing the main package (#5675)
  • Remove sectors with all deals expired in RecoverDealIDs (#5658)
  • storagefsm: Rewrite input handling (#5375)
  • reintroduce Refactor send command for better testability (#5668)
  • Improve error message with importing a chain (#5669)
  • storagefsm: Cleanup CC sector creation (#5612)
  • chain list --gas-stats display capacity (#5676)
  • Correct some logs (#5694)
  • refactor blockstores (#5484)
  • Add idle to sync stage's String() (#5702)
  • packer provisioner (#5604)
  • add DeleteMany to Blockstore interface (#5703)
  • segregate chain and state blockstores (#5695)
  • fix(multisig): The format of the amount is not correct in msigLockApp (#5718)
  • Update butterfly network (#5627)
  • Collect worker task metrics (#5648)
  • Correctly format disputer log (#5716)
  • Log block CID in the large delay warning (#5704)
  • Move api client builders to a cliutil package (#5728)
  • Implement net peers --extended (#5734)
  • Command to extend sector expiration (#5666)
  • garbage collect hotstore after compaction (#5744)
  • tune badger gc to repeatedly gc the value log until there is no rewrite (#5745)
  • Add configuration option for pubsub IPColocationWhitelist subnets (#5735)
  • hot/cold blockstore segregation (aka. splitstore) (#4992)
  • Customize verifreg root key and remainder account when making genesis (#5730)
  • chore: update go-graphsync to 0.6.0 (#5746)
  • Add connmgr metadata to NetPeerInfo (#5749)
  • test: attempt to make the splitstore test deterministic (#5750)
  • Feat/api no dep build (#5729)
  • Fix bootstrapper profile setting (#5756)
  • Check liveness of sectors when processing termination batches (#5759)
  • Configurable storage path storage limit (#5624)
  • miner: Config to disable owner/worker address fallback (#5620)
  • Fix TestUnpadReader on Go 1.16 (#5761)
  • Metadata datastore log (#5755)
  • Remove the SR2 stats, leave just the network totals (#5757)
  • fix: wait a bit before starting to compute window post proofs (#5764)
  • fix: retry proof when randomness changes (#5768)

1.5.0 / 2021-02-23

This is a mandatory release of Lotus that introduces the fifth upgrade to the Filecoin network. The network upgrade occurs at height 550321, before which time all nodes must have updated to this release (or later). At this height, v3 specs-actors will take effect, which in turn implements the following two FIPs:

  • FIP-0007 h/amt-v3 which improves the performance of the Filecoin HAMT and AMT.
  • FIP-0010 off-chain Window PoSt Verification which reduces the gas consumption of SubmitWindowedPoSt messages significantly by optimistically accepting Window PoSt proofs without verification, and allowing them to be disputed later by off-chain verifiers.

Note that the integration of v3 actors was already completed in 1.4.2, this upgrade simply sets the epoch for the upgrade to occur.

Disputer

FIP-0010 introduces the ability to dispute bad Window PoSts. Node operators are encouraged to run the new Lotus disputer alongside their Lotus daemons. For more information, see the announcement here.

Changes

  • #5341 Add a LOTUS_DISABLE_V3_ACTOR_MIGRATION envvar
    • Setting this envvar to 1 disables the v3 actor migration, should only be used in the event of a failed migration

1.4.2 / 2021-02-17

This is a large, and highly recommended, optional release with new features and improvements for lotus miner and deal-making UX. The release also integrates v3 specs-actors, which implements two FIPs:

  • FIP-0007 h/amt-v3 which improves the performance of the Filecoin HAMT and AMT.
  • FIP-0010 off-chain Window PoSt Verification which reduces the gas consumption of SubmitWindowedPoSt messages significantly by optimistically accepting Window PoSt proofs without verification, and allowing them to be disputed later by off-chain verifiers.

Note that this release does NOT set an upgrade epoch for v3 actors to take effect. That will be done in the upcoming 1.5.0 release.

New Features

  • #5341 Added sector termination API and CLI
    • Run lotus-miner sectors terminate
  • #5342 Added CLI for using a multisig wallet as miner's owner address
    • See how to set it up here
  • #5363, #5418, #5476, #5459 Integrated spec-actor v3
    • #5472 Generate actor v3 methods for pond
  • #5379 Added WindowPoSt disputer
  • #5309 Batch multiple deals in one PublishStorageMessages
    • #5411 Handle batch PublishStorageDeals message in sealing recovery
    • #5505 Exclude expired deals from batching in PublishStorageDeals messages
    • Added PublishMsgPeriod and MaxDealsPerPublishMsg to miner Dealmaking configuration. See how they work here.
    • #5538, #5549 Added a command to list pending deals and force publish messages.
      • Run lotus-miner market pending-publish
    • #5428 Moved waiting for PublishStorageDeals messages' receipt from markets to lotus
  • #5510 Added nerpanet build option
    • To build nerpanet, run make nerpanet
  • #5433 Added AlwaysKeepUnsealedCopy option to the miner configuration
  • #5520 Added MsigGetPending to get pending transactions for multisig wallets
  • #5219 Added interactive mode for lotus-wallet
  • 5529 Added support for minder nodes in lotus-shed rpc util

Bug Fixes

  • #5210 Miner should not dial client on restart
  • #5403 When estimating GasLimit only apply prior messages up to the nonce
  • #5410 Fix the calibnet build option
  • #5492 Fixed has for ipfsbstore for non-existing blocks
  • #5361 Fixed retrieval hangs when using IpfsOnlineMode=true
  • #5493 Fixed retrieval failure when price-per-byte is zero
  • #5506 Fixed contexts in the storage adpater
  • #5515 Properly wire up StateReadState on gateway API
  • #5582 Fixed error logging format strings
  • #5614 Fixed websocket reconnecting handling

Improvements

  • #5389 Show verified indicator for ./lotus-miner storage-deals list
  • #5229 Show power for verified deals in ./lotus-miner setocr list
  • #5407 Added explicit check of the miner address protocol
  • #5399 watchdog: increase heapprof capture threshold to 90%
  • #5398 storageadapter: Look at precommits on-chain since deal publish msg
  • #5470 Added --no-timing option for ./lotus state compute-state --html
  • #5417 Storage Manager: Always unseal full sectors
  • #5393 Switched to filecoin-ffi bls api for bls signatures
  • #5380 Refactor deals API tests
  • #5397 Fixed a flake in the sync manager edge case test
  • #5406 Added a test to ensure a correct window post cannot be disputed
  • #5294 Added jobs to build Lotus docker image and push it to AWS ECR
  • #5387 Added network info(mainnet|calibnet) in version
  • #5497 Export metric for lotus-gateaway
  • #4950 Removed bench policy
  • #5047 Improved the UX for ./lotus-shed bitfield enc
  • #5282 Snake a context through the chian blockstore creation
  • #5350 Avoid using mp.cfg directrly to prevent race condition
  • #5449 Documented the block-header better
  • #5404 Added retrying proofs if an incorrect one is generated
  • #4545 Made state tipset usage consistent in the API
  • #5540 Removed unnecessary database reads in validation check
  • #5554 Fixed build lotus-soup CI job
  • #5552 Updated CircleCI to halt gracefully
  • #5555 Cleanup and add docstrings of node builder
  • #5564 Stopped depending on gocheck with gomod
  • #5574 Updated CLI UI
  • #5570 Added code CID to StateReadState return object
  • #5565 Added storageadapter.PublishMsgConfig to miner in testkit for lotus-soup testplan
  • #5571 Added lotus-seed gensis car to generate lotus block for devnets
  • #5613 Check format in client commP util
  • #5507 Refactored coalescing logic into its own function and take both cancellation sets into account
  • #5592 Verify FFI version before building

Dependency Updates

Network Version v10 Upgrade

  • #5473 Merged staging branch for v1.5.0
  • #5603 Set nerpanet's upgrade epochs up to v3 actors
  • #5471, #5456 Set calibration net actor v3 migration epochs for testing
  • #5434 Implemented pre-migration framework
  • #5476 Tune migration

1.4.1 / 2021-01-20

This is an optional Lotus release that introduces various improvements to the sealing, mining, and deal-making processes. In particular, #5341 introduces the ability for Lotus miners to terminate sectors.

Changes

Core Lotus

  • fix(sync): enforce ForkLengthThreshold for synced chain (#5182)
  • introduce memory watchdog; LOTUS_MAX_HEAP (#5101)
  • Skip bootstrapping if no peers specified (#5301)
  • Chainxchg write response timeout (#5254)
  • update NewestNetworkVersion (#5277)
  • fix(sync): remove checks bypass when we submit the block (#4192)
  • chore: export vm.ShouldBurn (#5355)
  • fix(sync): enforce fork len when changing head (#5244)
  • Use 55th percentile instead of median for gas-price (#5369)
  • update go-libp2p-pubsub to v0.4.1 (#5329)

Sealing

  • Sector termination support (#5341)
  • update weight canSeal and canStore when attach (https://github.com/filecoin-project/lotus/pull/5242/files)
  • sector-storage/mock: improve mocked readpiece (#5208)
  • Fix deadlock in runWorker in sched_worker.go (#5251)
  • Skip checking terminated sectors provable (#5217)
  • storagefsm: Fix unsealedInfoMap.lk init race (#5319)
  • Multicore AddPiece CommP (#5320)
  • storagefsm: Send correct event on ErrExpiredTicket in CommitFailed (#5366)
  • expose StateSearchMessage on gateway (#5382)
  • fix FileSize to return correct disk usage recursively (#5384)

Dealmaking

  • Better error message when withdrawing funds (#5293)
  • add verbose for list transfers (#5259)
  • cli - rename client info to client balances (#5304)
  • Better CLI for wallet market withdraw and client info (#5303)

UX

  • correct flag usages for replace cmd (#5255)
  • lotus state call will panic (#5275)
  • fix get sector bug (#4976)
  • feat: lotus wallet market add (adds funds to storage market actor) (#5300)
  • Fix client flag parsing in client balances cli (#5312)
  • delete slash-consensus miner (#4577)
  • add fund sufficient check in send (#5252)
  • enable parse and shorten negative FIL values (#5315)
  • add limit and rate for chain noise (#5223)
  • add bench env print (#5222)
  • Implement full-node restore option (#5362)
  • add color for token amount (#5352)
  • correct log in maybeUseAddress (#5359)
  • add slash-consensus from flag (#5378)

Testing

  • tvx extract: more tipset extraction goodness (#5258)
  • Fix race in blockstore test suite (#5297)

Build & Networks

  • Remove LOTUS_DISABLE_V2_ACTOR_MIGRATION envvar (#5289)
  • Create a calibnet build option (#5288)
  • Calibnet: Set Orange epoch (#5325)

Management

  • Update SECURITY.md (#5246)
  • README: Contribute section (#5330)
  • README: refine Contribute section (#5331)
  • Add misc tooling to codecov ignore list (#5347)

1.4.0 / 2020-12-19

This is a MANDATORY hotfix release of Lotus that resolves a chain halt at height 336,459 caused by nondeterminism in specs-actors. The fix is to update actors to 2.3.3 in order to incorporate this fix filecoin-project/specs-actors#1334.

1.3.0 / 2020-12-16

This is a mandatory release of Lotus that introduces the third post-liftoff upgrade to the Filecoin network. The network upgrade occurs at height 343200, before which time all nodes must have updated to this release (or later). The change that breaks consensus is an implementation of FIP-0009(https://github.com/filecoin-project/FIPs/blob/master/FIPS/fip-0009.md).

Changes

  • Disable gas burning for window post messages (#5200)
  • fix lock propose (#5197)

1.2.3 / 2020-12-15

This is an optional Lotus release that introduces many performance improvements, bugfixes, and UX improvements.

Changes

  • When waiting for deal commit messages, ignore unsuccessful messages (#5189)
  • Bigger copy buffer size for stores (#5177)
  • Print MinPieceSize when querying ask (#5178)
  • Optimize miner info & sectors list loading (#5176)
  • Allow miners to filter (un)verified deals (#5094)
  • Fix curSealing out of MaxSealingSectors limit (#5166)
  • Add mpool pending from / to filter (#5169)
  • Add metrics for delayed blocks (#5171)
  • Fix PushUntrusted publishing -- the message is local (#5173)
  • Avoid potential hang in events API when starting event listener (#5159)
  • Show data transfer ID in list-deals (#5150)
  • Fix events API mutex locking (#5160)
  • Message pool refactors (#5162)
  • Fix lotus-shed cid output (#5072)
  • Use FundManager to withdraw funds, add MarketWithdraw API (#5112)
  • Add keygen outfile (#5118)
  • Update sr2 stat aggregation (#5114)
  • Fix miner control address lookup (#5119)
  • Fix send with declared nonce 0 (#5111)
  • Introduce memory watchdog; LOTUS_MAX_HEAP (#5101)
  • Miner control address config for (pre)commits (#5103)
  • Delete repeated call func (#5099)
  • lotus-shed ledger show command (#5098)
  • Log a message when there aren't enough peers for sync (#5105)
  • Miner code cleanup (#5107)

1.2.2 / 2020-12-03

This is an optional Lotus release that introduces various improvements to the mining logic and deal-making workflow, as well as several new UX features.

Changes

  • Set lower feecap on PoSt messages with low balance (#4217)
  • Add options to set BlockProfileRate and MutexProfileFraction (#4140)
  • Shed/post find (#4355)
  • tvx extract: make it work with secp messages.(#4583)
  • update go from 1.14 to 1.15 (#4909)
  • print multiple blocks from miner cid (#4767)
  • Connection Gater support (#4849)
  • just return storedask.NewStoredAsk to reduce unuseful code (#4902)
  • add go main version (#4910)
  • Use version0 when pre-sealing (#4911)
  • optimize code UpgradeTapeHeight and go fmt (#4913)
  • CLI to get network version (#4914)
  • Improve error for ActorsVersionPredicate (#4915)
  • upgrade to go-fil-markets 1.0.5 (#4916)
  • bug:replace with func recordFailure (#4919)
  • Remove unused key (#4924)
  • change typeV7 make len (#4943)
  • emit events for peer disconnections and act upon them in the blocksync tracker (#4754)
  • Fix lotus bench error (#4305)
  • Reduce badger ValueTreshold to 128 (#4629)
  • Downgrade duplicate nonce logs to debug (#4933)
  • readme update golang version from 1.14.7 to 1.15.5 (#4974)
  • add data transfer logging (#4975)
  • Remove all temp file generation for deals (#4929)
  • fix get sector bug (#4976)
  • fix nil pointer in StateSectorPreCommitInfo (#4082)
  • Add logging on data-transfer to miner (#4980)
  • bugfix: fixup devnet script (#4956)
  • modify for unsafe (#4024)
  • move testground/lotus-soup testplan from oni to lotus (#4727)
  • Setup remainder msig signers when parsing genesis template (#4904)
  • Update JSON RPC server to enforce a maximum request size (#4923)
  • New SR-specific lotus-shed cmd (#4971)
  • update index to sectorNumber (#4987)
  • storagefsm: Fix expired ticket retry loop (#4876)
  • add .sec scale to measurements; humanize for metric tags (#4989)
  • Support seal proof type switching (#4873)
  • fix log format (#4984)
  • Format workerID as string (#4973)
  • miner: Winning PoSt Warmup (#4824)
  • Default StartDealParams's fast retrieval field to true over JSON (#4998)
  • Fix actor not found in chain inspect-usage (#5010)
  • storagefsm: Improve new deal sector logic (#5007)
  • Configure simultaneous requests (#4996)
  • miner: log winningPoSt duration separately (#5005)
  • fix wallet dead lock (#5002)
  • Update go-jsonrpc to v0.1.2 (#5015)
  • markets - separate watching for pre-commit from prove-commit (#4945)
  • storagefsm: Add missing planners (#5016)
  • fix wallet delete address where address is default (#5019)
  • worker: More robust remote checks (#5008)
  • Add new booststrappers (#4007)
  • add a tooling to make filecoin accounting a little easier (#5025)
  • fix: start a new line in print miner-info to avoid ambiguous display (#5029)
  • Print gas limit sum in mpool stat (#5035)
  • Fix chainstore tipset leak (#5037)
  • shed rpc: Allow calling with args (#5036)
  • Make --gas-limit optional in mpool replace cli (#5059)
  • client list-asks --by-ping (#5060)
  • Ledger signature verification (#5068)
  • Fix helptext for verified-deal default in client deal (#5074)
  • worker: Support setting task types at runtime (#5023)
  • Enable Callers tracing when GasTracing is enabled (#5080)
  • Cancel transfer cancels storage deal (#5032)
  • Sector check command (#5041)
  • add commp-to-cid base64 decode (#5079)
  • miner info cli improvements (#5083)
  • miner: Add slow mode to proving check (#5086)
  • Error out deals that are not activated by proposed deal start epoch (#5061)

1.2.1 / 2020-11-20

This is a very small release of Lotus that fixes an issue users are experiencing when importing snapshots. There is no need to upgrade unless you experience an issue with creating a new datastore directory in the Lotus repo.

Changes

  • fix blockstore directory not created automatically (#4922)
  • WindowPoStScheduler.checkSectors() delete useless judgment (#4918)

1.2.0 / 2020-11-18

This is a mandatory release of Lotus that introduces the second post-liftoff upgrade to the Filecoin network. The network upgrade occurs at height 265200, before which time all nodes must have updated to this release (or later). This release also bumps the required version of Go to 1.15.

The changes that break consensus are:

Other Changes

  • delayed pubsub subscribe for messages topic (#3646)
  • add chain base64 decode params (#4748)
  • chore(dep): update bitswap to fix an initialization race that could panic (#4855)
  • Chore/blockstore nits (#4813)
  • Print Consensus Faults in miner info (#4853)
  • Truncate genesis file before generating (#4851)
  • miner: Winning PoSt Warmup (#4824)
  • Fix init actor address map diffing (#4875)
  • Bump API versions to 1.0.0 (#4884)
  • Fix cid recording issue (#4874)
  • Speed up worker key retrieval (#4885)
  • Add error codes to worker return (#4890)
  • Update go to 1.15.5 (#4896)
  • Fix MaxSealingSectrosForDeals getting reset to 0 (#4879)
  • add sanity check for maximum block size (#3171)
  • Check (pre)commit receipt before other checks in failed states (#4712)
  • fix badger double open on daemon --import-snapshot; chainstore lifecycle (#4872)
  • Update to ipfs-blockstore 1.0.3 (#4897)
  • break loop when found warm up sector (#4869)
  • Tweak handling of bad beneficaries in DeleteActor (#4903)
  • cap maximum number of messages per block in selection (#4905)
  • Set Calico epoch (#4889)

1.1.3 / 2020-11-13

This is an optional release of Lotus that upgrades Lotus dependencies, and includes many performance enhancements, bugfixes, and UX improvements.

Highlights

  • Refactored much of the miner code (#3618), improving its recovery from restarts and overall sector success rate
  • Updated proofs to v5.3.0, which brings significant performance improvements
  • Updated markets to v1.0.4, which reduces failures due to reorgs (#4730) and uses the newly refactored fund manager (#4736)

Changes

Core Lotus

  • polish: add Equals method to MinerInfo shim (#4604)
  • Fix messagepool accounting (#4668)
  • Prep for gas balancing (#4651)
  • Reduce badger ValueThreshold to 128 (#4629)
  • Config for default max gas fee (#4652)
  • bootstrap: don't return early when one drand resolution fails (#4626)
  • polish: add ClaimsChanged and DiffClaims method to power shim (#4628)
  • Simplify chain event Called API (#4664)
  • Cache deal states for most recent old/new tipset (#4623)
  • Add miner available balance and power info to state miner info (#4618)
  • Call GetHeaviestTipSet() only once when syncing (#4696)
  • modify runtime gasUsed printf (#4704)
  • Rename builtin actor generators (#4697)
  • Move gas multiplier as property of pricelist (#4728)
  • polish: add msig pendingtxn diffing and comp (#4719)
  • Optional chain Bitswap (#4717)
  • rewrite sync manager (#4599)
  • async connect to bootstrappers (#4785)
  • head change coalescer (#4688)
  • move to native badger blockstore; leverage zero-copy View() to deserialize in-place (#4681)
  • badger blockstore: minor improvements (#4811)
  • Do not fail wallet delete because of pre-existing trashed key (#4589)
  • Correctly delete the default wallet address (#4705)
  • Reduce badger ValueTreshold to 128 (#4629)
  • predicates: Fast StateGetActor wrapper (#4835)

Mining

  • worker key should change when set sender found key not equal with the value on chain (#4595)
  • extern/sector-storage: fix GPU usage overwrite bug (#4627)
  • sectorstorage: Fix manager restart edge-case (#4645)
  • storagefsm: Fix GetTicket loop when the sector is already precommitted (#4643)
  • Debug flag to force running sealing scheduler (#4662)
  • Fix worker reenabling, handle multiple restarts in worker (#4666)
  • keep retrying the proof until we run out of sectors to skip (#4633)
  • worker: Commands to pause/resume task processing (#4615)
  • struct name incorrect (#4699)
  • optimize code replace strings with constants (#4769)
  • optimize pledge sector (#4765)
  • Track sealing processes across lotus-miner restarts (#3618)
  • Fix scheduler lockups after storage is freed (#4778)
  • storage: Track worker hostnames with work (#4779)
  • Expand sched-diag; Command to abort sealing calls (#4804)
  • miner: Winning PoSt Warmup (#4824)
  • docsgen: Support miner/worker (#4817)
  • miner: Basic storage cleanup command (#4834)

Markets and Data Transfer

  • Flesh out data transfer features (#4572)
  • Fix memory leaks in data transfer (#4619)
  • Handle deal id changes in OnDealSectorCommitted (#4730)
  • Refactor FundManager (#4736)
  • refactor: integrate new FundManager (#4787)
  • Fix race in paych manager when req context is cancelled (#4803)
  • fix race in paych manager add funds (#4597)
  • Fix panic in FundManager (#4808)
  • Fix: dont crash on startup if funds migration fails (#4827)

UX

  • Make EarlyExpiration in sectors list less scary (#4600)
  • Add commands to change the worker key (#4513)
  • Expose ClientDealSize via CLI (#4569)
  • client deal: Cache CommD when creating multiple deals (#4535)
  • miner sectors list: flags for events/seal time (#4649)
  • make IPFS online mode configurable (#4650)
  • Add sync status to miner info command (#4669)
  • Add a StateDecodeParams method (#4105)
  • sched: Interactive RPC Shell (#4692)
  • Add api for getting status given a code (#4210)
  • Update lotus-stats with a richer cli (#4718)
  • Use TSK passed to GasEstimateGasLimit (#4739)
  • match data type for reward state api (#4745)
  • Add termination-estimate to get an estimation for how much a termination penalty will be (#4617)
  • Restrict ParseFIL input length (#4780)
  • cmd sectors commitIDs len debug (#4786)
  • Add client deal-stats CLI (#4788)
  • Modify printf format (#4795)
  • Updated msig inspect (#4533)
  • Delete the duplicate output (#4819)
  • miner: Storage list sectors command (#4831)
  • drop a few logs down to debug (#4832)

Testing and Tooling

  • refactor: share code between CLI tests (#4598)
  • Fix flaky TestCLIDealFlow (#4608)
  • Fix flaky testMiningReal (#4609)
  • Add election run-dummy command (#4498)
  • Fix .gitmodules (#4713)
  • fix metrics wiring.(#4691)
  • shed: Util for creating ID CIDs (#4726)
  • Run kumquat upgrade on devnets (#4734)
  • Make pond work again (#4775)
  • lotus-stats: fix influx flags (#4810)
  • 2k sync BootstrapPeerThreshold (#4797)
  • test for FundManager panic to ensure it is fixed (#4825)
  • Stop mining at the end of tests (#4826)
  • Make some logs quieter (#4709)

Dependencies

  • update filecoin-ffi in go mod (#4584)
  • Update FFI (#4613)
  • feat: integrate new optional blst backend and verification optimizations from proofs (#4630)
  • Use https for blst submodule (#4710)
  • Update go-bitfield (#4756)
  • Update Yamux (#4758)
  • Update to latest go-bitfield (#4793)
  • Update to latest go-address (#4798)
  • update libp2p for stream interface changes (#4814)

1.1.2 / 2020-10-24

This is a patch release of Lotus that builds on the fixes involving worker keys that was introduced in v1.1.1. Miners and node operators should update to this release as soon as possible in order to ensure their blocks are propagated and validated.

Changes

  • Handle worker key changes correctly in runtime (#4579)

1.1.1 / 2020-10-24

This is a patch release of Lotus that addresses some issues caused by when miners change their worker keys. Miners and node operators should update to this release as soon as possible, especially any miner who has changed their worker key recently.

Changes

  • Miner finder for interactive client deal CLI (#4504)
  • Disable blockstore bloom filter (#4512)
  • Add api for getting status given a code (#4210)
  • add batch api for push messages (#4236)
  • add measure datastore wrapper around bench chain datastore (#4302)
  • Look at block base fee for PCR (#4313)
  • Add a shed util to determine % of power that has won a block (#4318)
  • Shed/borked cmd (#4339)
  • optimize mining code (#4379)
  • heaviestTipSet reurning nil is a ok (#4523)
  • Remove most v0 actor imports (#4383)
  • Small chain export optimization (#4536)
  • Add block list to pcr (#4314)
  • Fix circ supply default in conformance (#4449)
  • miner: fix init --create-worker-key (#4475)
  • make push and addLocal atomic (#4500)
  • add some methods that oni needs (#4501)
  • MinerGetBaseInfo: if miner is not found in lookback, check current (#4508)
  • Delete wallet from local wallet cache (#4526)
  • Fix lotus-shed ledger list (#4521)
  • Manage sectors by size instead of proof type (#4511)
  • Feat/api request metrics wrapper (#4516)
  • Fix chain sync stopping to sync (#4541)
  • Use the correct lookback for the worker key when creating blocks (#4539)
  • Cleanup test initialization and always validate VRFs in tests (#4538)
  • Add a market WithdrawBalance CLI (#4524)
  • wallet list: Add market balance and ID address flags (#4555)
  • tvx simulate command; tvx extract --ignore-sanity-checks (#4554)
  • lotus-lite: CLI tests for lotus client commands (#4497)
  • lite-mode - market storage and retrieval clients (#4263)
  • Chore: update drand to v1.2.0 (#4420)
  • Fix random test failures (#4559)
  • Fix flaky TestTimedBSSimple (#4561)
  • Make wallet market withdraw usable with miner addresses (#4556)
  • Fix flaky TestChainExportImportFull (#4564)
  • Use older randomness for the PoSt commit on specs-actors version 2 (#4563)
  • shed: Commad to decode messages (#4565)
  • Fetch worker key from correct block on sync (#4573)

1.1.0 / 2020-10-20

This is a mandatory release that introduces the first post-liftoff upgrade to the Filecoin network. The changes that break consensus are an upgrade to specs-actors v2.2.0 at epoch 170000.

Changes

  • Introduce Network version 6 (#4506)
  • Update markets v1.0.0 (#4505)
  • Add some extra logging to try and debug sync issues (#4486)
  • Circle: Run tests for some subsystems separately (#4496)
  • Add a terminate sectors command to lotus-shed (#4507)
  • Add a comment to BlockMessages to address #4446 (#4491)

1.0.0 / 2020-10-19

It's 1.0.0! This is an optional release of Lotus that introduces some UX improvements to the 0.10 series.

This very small release is largely cosmetic, and intended to flag the code that the Filecoin mainnet was launched with.

API changes

  • StateMsgGasCost has been removed. The equivalent information can be gained by calling StateReplay.
  • A GasCost field has been added to the InvocResult type, meaning detailed gas costs will be returned when calling StateReplay, StateCompute, and StateCall.
  • The behaviour of StateReplay in response to an empty tipset key has been changed. Instead of simply using the heaviest tipset (which is almost guaranteed to be an unsuccessful replay), we search now search the chain for the tipset that included the message, and replay the message in that tipset (we fail if no such tipset is found).

Changes

  • Increase code coverage! (#4410)
  • Mpool: Don't block node startup loading messages (#4411)
  • Improve the UX of multisig approves (#4398)
  • Use build.BlockDelaySecs for deal start buffer (#4415)
  • Conformance: support multiple protocol versions (#4393)
  • Ensure msig inspect cli works with lotus-lite (#4421)
  • Add command to (slowly) prune lotus chain datastore (#3876)
  • Add WalletVerify to lotus-gateway (#4373)
  • Improve StateMsg APIs (#4429)
  • Add endpoints needed by spacegap (#4426)
  • Make audit balances capable of printing robust addresses (#4423)
  • Custom filters for retrieval deals (#4424)
  • Fix message list api (#4422)
  • Replace bootstrap peers (#4447)
  • Don't overwrite previously-configured maxPieceSize for a persisted ask (#4480)
  • State: optimize state snapshot address cache (#4481)

0.10.2 / 2020-10-14

This is an optional release of Lotus that updates markets to 0.9.1, which fixes an issue affecting deals that were mid-transfer when the node was upgraded to 0.9.0. This release also includes some tweaks to default gas values and minor performance improvements.

Changes

  • Use updated stored ask API (#4384)
  • tvx: trace puts to blockstore for inclusion in CAR. (#4278)
  • Add propose remove (#4311)
  • Update to 0.9.1 bugfix release (#4402)
  • Update drand endpoints (#4125)
  • fix: return true when deadlines changed (#4403)
  • sync wait --watch (#4396)
  • reduce garbage in blockstore (#4406)
  • give the TimeCacheBS tests a bit more time (#4407)
  • Improve gas defaults (#4408)
  • Change default gas premium to for 10 block inclusion (#4222)

0.10.1 / 2020-10-14

This is an optional release of Lotus that updates markets to 0.9.0, which adds the ability to restart data transfers. This release also introduces Ledger support, and various UX improvements.

Changes

  • Test the tape upgrade (#4328)
  • Adding in Ledger support (#4290)
  • Improve the UX for lotus-miner sealing workers (#4329)
  • Add a CLI tool for miner's to repay debt (#4319)
  • Rename params_testnet to params_mainnet (#4336)
  • Use seal-duration in calculating the earliest StartEpoch (#4337)
  • Reject deals that are > 7 days in the future in the BasicDealFilter (#4173)
  • Add an API endpoint to calculate the exact circulating supply (#4148)
  • lotus-pcr: ignore all other market messages (#4341)
  • Add message CID to InvocResult (#4382)
  • types: Add CID fields to messages in json marshalers (#4338)
  • fix(sync state): set state height to actual tipset height (#4347)
  • Fix off by one tipset in searchBackForMsg (#4367)
  • fix a panic on startup when we fail to load the tipset (#4376)
  • Avoid having the same message CID show up in execution traces (#4350)
  • feat(markets): update markets 0.9.0 and add data transfer restart (#4363)

0.10.0 / 2020-10-12

This is a consensus-breaking hotfix that addresses an issue in specs-actors v2.0.3 that made it impossible to pledge new 32GiB sectors. The change in Lotus is to update to actors v2.1.0, behind the new network version 5.

Changes

  • make pledge test pass with the race detector (#4291)
  • fix a race in tipset cache usage (#4282)
  • add an api for removing multisig signers (#4274)
  • cli: Don't output errors to stdout (#4298)
  • Fix panic in wallet export when key is not found (#4299)
  • Dump the block validation cache whenever we perform an import (#4287)
  • Fix two races (#4301)
  • sync unmark-bad --all (#4296)
  • decode parameters for multisig transactions in inspect (#4312)
  • Chain is love (#4321)
  • lotus-stats: optmize getting miner power (#4315)
  • implement tape upgrade (#4322)

0.9.1 / 2020-10-10

This release fixes an issue which may cause the actors v2 migration to compute the state incorrectly when more than one migration is running in parallel.

Changes

  • Make concurrent actor migrations safe (#4293)
  • Remote wallet backends (#3583)
  • Track funds in FundMgr correctly in case of AddFunds failing (#4273)
  • Partial lite-node mode (#4095)
  • Fix potential infinite loop in GetBestMiningCandidate (#3444)
  • sync wait: Handle processed message offset (#4253)
  • Add some new endpoints for querying Msig info (#4250)
  • Update markets v0.7.1 (#4254)
  • Optimize SearchForMessage and GetReceipt (#4246)
  • Use FIL instead of attoFIL in CLI more consistently (#4249)
  • fix: clash between daemon --api flag and cli tests (#4241)
  • add more info to chain sync lookback failure (#4245)
  • Add message counts to inspect chain output (#4230)

0.9.0 / 2020-10-07

This consensus-breaking release of Lotus upgrades the actors version to v2.0.0. This requires migrating actor state from v0 to v2. The changes that break consensus are:

  • Introducing v2 actors and its migration (#3936)
  • Runtime's Receiver() should only return ID addresses (#3589)
  • Update miner eligibility checks for v2 actors (#4188)
  • Add funds that have left FilReserve to circ supply (#4160)
  • Set WinningPoStSectorSetLookback to finality post-v2 actors (#4190)
  • fix: error when actor panics directly (#3697)

Changes

Dependencies

  • Update go-bitfield (#4171)
  • update the AMT implementation (#4194)
  • Update to actors v0.2.1 (#4199)

Core Lotus

  • Paych: fix voucher amount verification (#3821)
  • Cap market provider messages (#4141)
  • Run fork function after cron for null block safety (#4114)
  • use bitswap sessions when fetching messages, and cancel them (#4142)
  • relax pubsub IPColocationFactorThreshold to 5 (#4183)
  • Support addresses with mainnet prefixes (#4186)
  • fix: make message signer nonce generation transactional (#4165)
  • build: Env var to keep test address output (#4213)
  • make vm.EnableGasTracing public (#4214)
  • introduce separate state-tree versions (#4197)
  • reject explicit "calls" at the upgrade height (#4231)
  • return an illegal actor error when we see an unsupported actor version (#4232)
  • Set head should unmark blocks as valid (https://gist.github.com/travisperson/3c7cddd77a33979a519ccef4e6515f20)

Mining

  • Increased ExpectedSealDuration and and WaitDealsDelay (#3743)
  • Miner backup/restore commands (#4133)
  • lotus-miner: add more help text to storage / attach (#3961)
  • Reject deals that are > 7 days in the future in the BasicDealFilter (#4173)
  • feat(miner): add miner deadline diffing logic (#4178)

UX

  • Improve the UX for replacing messages (#4134)
  • Add verified flag to interactive deal creation (#4145)
  • Add command to (slowly) prune lotus chain datastore (#3876)
  • Some helpers for verifreg work (#4124)
  • Always use default 720h for setask duration and hide the duration param option (#4077)
  • Convert ID addresses to key addresses before checking wallet (#4122)
  • add a command to view block space utilization (#4176)
  • allow usage inspection on a chain segment (#4177)
  • Add mpool stats for base fee (#4170)
  • Add verified status to api.DealInfo (#4153)
  • Add a CLI command to set a miner's owner address (#4189)

Tooling and validation

  • Lotus-pcr: add recover-miners command (#3714)
  • MpoolPushUntrusted API for gateway (#3915)
  • Test lotus-miner info all (#4166)
  • chain export: Error with unfinished exports (#4179)
  • add printf in TestWindowPost (#4043)
  • add trace wdpost (#4020)
  • Fix noncefix (#4202)
  • Lotus-pcr: Limit the fee cap of messages we will process, refund gas fees for windowed post and storage deals (#4198)
  • Fix pond (#4203)
  • allow manual setting of noncefix fee cap (#4205)
  • implement command to get execution traces of any message (#4200)
  • conformance: minor driver refactors (#4211)
  • lotus-pcr: ignore all other messages (#4218)
  • lotus-pcr: zero refund (#4229)

Contributors

The following contributors had 5 or more commits go into this release. We are grateful for every contribution!

Contributor Commits Lines ±
Stebalien 84 +3425/-2287
magik6k 41 +2121/-506
arajasek 39 +2467/-424
Kubuxu 25 +2344/-775
raulk 21 +287/-196
whyrusleeping 13 +727/-71
hsanjuan 13 +5886/-7956
dirkmc 11 +2634/-576
travisperson 8 +923/-202
ribasushi 6 +188/-128
zgfzgf 5 +21/-17

0.8.1 / 2020-09-30

This optional release of Lotus introduces a new version of markets which switches to CBOR-map encodings, and allows datastore migrations. The release also introduces several improvements to the mining process, a few performance optimizations, and a battery of UX additions and enhancements.

Changes

Dependencies

  • Markets 0.7.0 with updated data stores (#4089)
  • Update ffi to code with blst fixes (#3998)

Core Lotus

  • Fix GetPower with no miner address (#4049)
  • Refactor: Move nonce generation out of mpool (#3970)

Performance

  • Implement caching syscalls for import-bench (#3888)
  • Fetch tipset blocks in parallel (#4074)
  • Optimize Tipset equals() (#4056)
  • Make state transition in validation async (#3868)

Mining

  • Add trace window post (#4020)
  • Use abstract types for Dont recompute post on revert (#4022)
  • Fix injectNulls logic in test miner (#4058)
  • Fix potential panic in FinalizeSector (#4092)
  • Don't recompute post on revert (#3924)
  • Fix some failed precommit handling (#3445)
  • Add --no-swap flag for worker (#4107)
  • Allow some single-thread tasks to run in parallel with PC2/C2 (#4116)

UX

  • Add an envvar to set address network version (#4028)
  • Add logging to chain export (#4030)
  • Add JSON output to state compute (#4038)
  • Wallet list CLI: Print balances/nonces (#4088)
  • Added an option to show or not show sector info for lotus-miner info (#4003)
  • Add a command to import an ipld object into the chainstore (#3434)
  • Improve the lotus-shed dealtracker (#4051)
  • Docs review and re-organization (#3431)
  • Fix wallet list (#4104)
  • Add an endpoint to validate whether a string is a well-formed address (#4106)
  • Add an option to set config path (#4103)
  • Add printf in TestWindowPost (#4043)
  • Improve miner sectors list UX (#4108)

Tooling

  • Move policy change to seal bench (#4032)
  • Add back network power to stats (#4050)
  • Conformance: Record and feed circulating supply (#4078)
  • Snapshot import progress bar, add HTTP support (#4070)
  • Add lotus shed util to validate a tipset (#4065)
  • tvx: a test vector extraction and execution tool (#4064)

Bootstrap

  • Add new bootstrappers (#4007)
  • Add Glif node to bootstrap peers (#4004)
  • Add one more node located in China (#4041)
  • Add ipfsmain bootstrapper (#4067)

0.8.0 / 2020-09-26

This consensus-breaking release of Lotus introduces an upgrade to the network. The changes that break consensus are:

  • Upgrading to specs-actors v0.9.11, which reduces WindowPoSt faults per FIP 0002 to reduce cost for honest miners with occasional faults (see filecoin-project/specs-actors#1181)
  • Revisions to some cryptoeconomics and network params

This release also updates go-fil-markets to fix an incompatibility issue between v0.7.2 and earlier versions.

Changes

Dependencies

  • Update spec actors to 0.9.11 (#4039)
  • Update markets to 0.6.3 (#4013)

Core Lotus

  • Network upgrade (#4039)
  • Fix AddSupportedProofTypes (#4033)
  • Return an error when we fail to find a sector when checking sector expiration (#4026)
  • Batch blockstore copies after block validation (#3980)
  • Remove a misleading miner actor abstraction (#3977)
  • Fix out-of-bounds when loading all sector infos (#3976)
  • Fix break condition in the miner (#3953)

UX

  • Correct helptext around miners setting ask (#4009)
  • Make sync wait nicer (#3991)

Tooling and validation

  • Small adjustments following network upgradability changes (#3996)
  • Add some more big pictures stats to stateroot stat (#3995)
  • Add some actors policy setters for testing (#3975)

Contributors

The following contributors had 5 or more commits go into this release. We are grateful for every contribution!

Contributor Commits Lines ±
arajasek 66 +3140/-1261
Stebalien 64 +3797/-3434
magik6k 48 +1892/-976
raulk 40 +2412/-1549
vyzo 22 +287/-196
alanshaw 15 +761/-146
whyrusleeping 15 +736/-52
hannahhoward 14 +1237/-837
anton 6 +32/-8
travisperson 5 +502/-6
Frank 5 +78/-39
Jennifer 5 +148/-41

0.7.2 / 2020-09-23

This optional release of Lotus introduces a major refactor around how a Lotus node interacts with code from the specs-actors repo. We now use interfaces to read the state of actors, which is required to be able to reason about different versions of actors code at the same time.

Additionally, this release introduces various improvements to the sync process, as well as changes to better the overall UX experience.

Changes

Core Lotus

  • Network upgrade support (#3781)
  • Upgrade markets to v0.6.2 (#3974)
  • Validate chain sync response indices when fetching messages (#3939)
  • Add height diff to sync wait (#3926)
  • Replace Requires with Wants (#3898)
  • Update state diffing for market actor (#3889)
  • Parallel fetch for sync (#3887)
  • Fix SectorState (#3881)

User Experience

  • Add basic deal stats api server for spacerace slingshot (#3963)
  • When doing sectors update-state, show a list of existing states if user inputs an invalid one (#3944)
  • Fix lotus-miner storage find error (#3927)
  • Log shutdown method for lotus daemon and miner (#3925)
  • Update build and setup instruction link (#3919)
  • Add an option to hide removed sectors from sectors list output (#3903)

Testing and validation

  • Add init.State#Remove() for testing (#3971)
  • lotus-shed: add consensus check command (#3933)
  • Add keyinfo verify and jwt token command to lotus-shed (#3914)
  • Fix conformance gen (#3892)

0.7.1 / 2020-09-17

This optional release of Lotus introduces some critical fixes to the window PoSt process. It also upgrades some core dependencies, and introduces many improvements to the mining process, deal-making cycle, and overall User Experience.

Changes

Some notable improvements:

  • Correctly construct params for SubmitWindowedPoSt messages (#3909)
  • Skip sectors correctly for Window PoSt (#3839)
  • Split window PoST submission into multiple messages (#3689)
  • Improve journal coverage (#2455)
  • Allow retrievals while sealing (#3778)
  • Don't prune locally published messages (#3772)
  • Add get-ask, set-ask retrieval commands (#3886)
  • Consistently name winning and window post in logs (#3873))
  • Add auto flag to mpool replace (#3752))

Dependencies

  • Upgrade markets to v0.6.1 (#3906)
  • Upgrade specs-actors to v0.9.10 (#3846)
  • Upgrade badger (#3739)

0.7.0 / 2020-09-10

This consensus-breaking release of Lotus is designed to test a network upgrade on the space race testnet. The changes that break consensus are:

  • Upgrading the Drand network used from the test Drand network to the League of Entropy main drand network. This is the same Drand network that will be used in the Filecoin mainnet.
  • Upgrading to specs-actors v0.9.8, which adds a new method to the Multisig actor.

Changes

Core Lotus

  • Fix IsAncestorOf (#3717)
  • Update to specs-actors v0.9.8 (#3725)
  • Increase chain throughput by 20% (#3732)
  • Updare to go-libp2p-pubsub master (#3735)
  • Drand upgrade (#3670)
  • Multisig API additions (#3590)

Storage Miner

  • Increase the number of times precommit2 is attempted before moving back to precommit1 (#3720)

Message pool

  • Relax mpool add strictness checks for local pushes (#3724)

Maintenance

  • Fix devnets (#3712)
  • Fix(chainwatch): compare prev miner with cur miner (#3715)
  • CI: fix statediff build; make optional (#3729)
  • Feat: Chaos abort (#3733)

Contributors

The following contributors had commits go into this release. We are grateful for every contribution!

Contributor Commits Lines ±
arajasek 28 +1144/-239
Kubuxu 19 +452/-261
whyrusleeping 13 +456/-87
vyzo 11 +318/-20
raulk 10 +1289/-350
magik6k 6 +188/-55
dirkmc 3 +31/-8
alanshaw 3 +176/-37
Stebalien 2 +9/-12
lanzafame 1 +1/-1
frrist 1 +1/-1
mishmosh 1 +1/-1
nonsense 1 +1/-0

0.6.2 / 2020-09-09

This release introduces some critical fixes to message selection and gas estimation logic. It also adds the ability for nodes to mark a certain tipset as checkpointed, as well as various minor improvements and bugfixes.

Changes

Messagepool

  • Warn when optimal selection fails to pack a block and we fall back to random selection (#3708)
  • Add basic command for printing gas performance of messages in the mpool (#3701)
  • Adjust optimal selection to always try to fill blocks (#3685)
  • Fix very minor bug in repub baseFeeLowerBound (#3663)
  • Add an auto flag to mpool replace (#3676)
  • Fix mpool optimal selection packing failure (#3698)

Core Lotus

  • Don't use latency as initital estimate for blocksync (#3648)
  • Add niceSleep 1 second when drand errors (#3664)
  • Fix isChainNearSync check in block validator (#3650)
  • Add peer to peer manager before fetching the tipset (#3667)
  • Add StageFetchingMessages to sync status (#3668)
  • Pass tipset through upgrade logic (#3673)
  • Allow nodes to mark tipsets as checkpointed (#3680)
  • Remove hard-coded late-fee in window PoSt (#3702)
  • Gas: Fix median calc (#3686)

Storage

  • Storage manager: bail out with an error if unsealed cid is undefined (#3655)
  • Storage: return true from Sealer.ReadPiece() on success (#3657)

Maintenance

  • Resolve lotus, test-vectors, statediff dependency cycle (#3688)
  • Paych: add docs on how to use paych status (#3690)
  • Initial CODEOWNERS (#3691)

0.6.1 / 2020-09-08

This optional release introduces a minor improvement to the sync process, ensuring nodes don't fall behind and then resync.

Changes

  • Update test-vectors (#3645)
  • Revert "only subscribe to pubsub topics once we are synced" (#3643)

0.6.0 / 2020-09-07

This consensus-breaking release of Lotus is designed to test a network upgrade on the space race testnet. The changes that break consensus are:

This release also introduces many improvements to Lotus! Among them are a new version of go-fil-markets that supports non-blocking retrieval, various spam reduction measures in the messagepool and p2p logic, and UX improvements to payment channels, dealmaking, and state inspection.

Changes

Core Lotus and dependencies

  • Implement faucet funds reallocation logic (#3632)
  • Network upgrade: Upgrade to correct fork threshold (#3628)
  • Update to specs 0.9.7 and markets 0.6.0 (#3627)
  • Network upgrade: Perform base fee tamping (#3623)
  • Chain events: if cache best() is nil, return chain head (#3611)
  • Update to specs actors v0.9.6 (#3603)

Messagepool

  • Temporarily allow negative chains (#3625)
  • Improve publish/republish logic (#3592)
  • Fix selection bug; priority messages were not included if other chains were negative (#3580)
  • Add defensive check for minimum GasFeeCap for inclusion within the next 20 blocks (#3579)
  • Add additional info about gas premium (#3578)
  • Fix GasPremium capping logic (#3552)

Payment channels

  • Get available funds by address or by from/to (#3547)
  • Create lotus paych status command (#3523)
  • Rename CLI command from "paych get" to "paych add-funds" (#3520)

Peer-to-peer

  • Only subscribe to pubsub topics once we are synced (#3602)
  • Reduce mpool add failure log spam (#3562)
  • Republish messages even if the chains have negative performance(#3557)
  • Adjust gossipsub gossip factor (#3556)
  • Integrate pubsub Random Early Drop (#3518)

Miscellaneous

  • Fix panic in OnDealExpiredSlashed (#3553)
  • Robustify state manager against holes in actor method numbers (#3538)

UX

  • VM: Fix an error message (#3608)
  • Documentation: Batch replacement,update lotus-storage-miner to lotus-miner (#3571)
  • CLI: Robust actor lookup (#3535)
  • Add agent flag to net peers (#3534)
  • Add watch option to storage-deals list (#3527)

Testing & tooling

  • Decommission chain-validation (#3606)
  • Metrics: add expected height metric (#3586)
  • PCR: Use current tipset during refund (#3570)
  • Lotus-shed: Add math command (#3568)
  • PCR: Add tipset aggergation (#3565 Fix broken paych tests (#3551)
  • Make chain export ~1000x times faster (#3533)
  • Chainwatch: Stop SyncIncomingBlocks from leaking into chainwatch processing; No panics during processing (#3526)
  • Conformance: various changes (#3521)

0.5.10 / 2020-09-03

This patch includes a crucial fix to the message pool selection logic, strongly disfavouring messages that might cause a miner penalty.

Changes

  • Fix calculation of GasReward in messagepool (#3528)

0.5.9 / 2020-09-03

This patch includes a hotfix to the GasEstimateFeeCap method, capping the estimated fee to a reasonable level by default.

Changes

  • Added target height to sync wait (#3502)
  • Disable codecov annotations (#3514)
  • Cap fees to reasonable level by default (#3516)
  • Add APIs and command to inspect bandwidth usage (#3497)
  • Track expected nonce in mpool, ignore messages with large nonce gaps (#3450)

0.5.8 / 2020-09-02

This patch includes some bugfixes to the sector sealing process, and updates go-fil-markets. It also improves the performance of blocksync, adds a method to export chain state trees, and improves chainwatch.

Changes

0.5.7 / 2020-08-31

This patch release includes some bugfixes and enhancements to the sector lifecycle and message pool logic.

Changes

  • Rebuild unsealed infos on miner restart (#3401)
  • CLI to attach storage paths to workers (#3405)
  • Do not select negative performing message chains for inclusion (#3392)
  • Remove a redundant error-check (#3421)
  • Correctly move unsealed sectors in FinalizeSectors (#3424)
  • Improve worker selection logic (#3425)
  • Don't use context to close bitswap (#3430)
  • Correctly estimate gas premium when there is only one message on chain (#3428)

0.5.6 / 2020-08-29

Hotfix release that fixes a panic in the sealing scheduler (#3389).

0.5.5

This patch release introduces a large number of improvements to the sealing process. It also updates go-fil-markets to version 0.5.8, and go-libp2p-pubsub to v0.3.5.

Downstream upgrades

  • Upgrades markets to v0.5.8 (#3384)
  • Upgrades go-libp2p-pubsub to v0.3.5 (#3305)

Sector sealing

  • The following improvements were introduced in #3350.

    • Allow lotus-miner sectors remove to remove a sector in any state.
    • Create a separate state in the storage FSM dedicated to submitting the Commit message.
    • Recovery for when the Deal IDs of deals in a sector get changed in a reorg.
    • Auto-retry sending Precommit and Commit messages if they run out of gas
    • Auto-retry sector remove tasks when they fail
    • Compact worker windows, and allow their tasks to be executed in any order
  • Don't simply skip PoSt for bad sectors (#3323)

Message Pool

  • Spam Protection: Track required funds for pending messages (#3313)

Chainwatch

  • Add more power and reward metrics (#3367)
  • Fix raciness in sector deal table (#3275)
  • Parallelize miner processing (#3380)
  • Accept Lotus API and token (#3337)

0.5.4

A patch release, containing a few nice bugfixes and improvements:

  • Fix parsing of peer ID in lotus-miner actor set-peer-id (@whyrusleeping)
  • Update dependencies, fixing several bugs (@Stebalien)
  • Fix remaining linter warnings (@Stebalien)
  • Use safe string truncation (@Ingar)
  • Allow tweaking of blocksync message window size (@whyrusleeping)
  • Add some additional gas stats to metrics (@Kubuxu)
  • Fix an edge case bug in message selection, add many tests (@vyzo)

0.5.3

Yet another hotfix release. A lesson for readers, having people who have been awake for 12+ hours review your hotfix PR is not a good idea. Find someone who has enough slept recently enough to give you good code review, otherwise you'll end up quickly bumping versions again.

  • Fixed a bug in the mempool that was introduced in v0.5.2

0.5.2 / 2020-08-24

This is a hotfix release.

  • Fix message selection to not include messages that are invalid for block inclusion.
  • Improve SelectMessage handling of the case where the message pools tipset differs from our mining base.

0.5.1 / 2020-08-24

The Space Race release! This release contains the genesis car file and bootstrap peers for the space race network.

Additionally, we included two small fixes to genesis creation:

  • Randomize ticket value in genesis generation
  • Correctly set t099 (burnt funds actor) to have valid account actor state

0.5.0 / 2020-08-20

This version of Lotus will be used for the incentivized testnet Space Race competition, and can be considered mainnet-ready code. It includes some protocol changes, upgrades of core dependencies, and various bugfixes and UX/performance improvements.

Highlights

Among the highlights included in this release are:

  • Gas changes: We implemented EIP-1559 and introduced real gas values.
  • Deal-making: We now support "Committed Capacity" sectors, "fast-retrieval" deals, and the packing of multiple deals into a single sector.
  • Renamed features: We renamed some of the binaries, environment variables, and default paths associated with a Lotus node.

Gas changes

We made some significant changes to the mechanics of gas in this release.

Network fee

We implemented something similar to Ethereum's EIP-1559. The Message structure had three changes:

  • The GasPrice field has been removed
  • A new GasFeeCap field has been added, which controls the maximum cost the sender incurs for the message
  • A new GasPremium field has been added, which controls the reward a miner earns for including the message

A sender will never be charged more than GasFeeCap * GasLimit. A miner will typically earn GasPremium * GasLimit as a reward.

The Blockheader structure has one new field, called ParentBaseFee. Informally speaking,the ParentBaseFee is increased when blocks are densely packed with messages, and decreased otherwise.

The ParentBaseFee is used when calculating how much a sender burns when executing a message. Burning simply refers to sending attoFIL to a dedicated, unreachable account. A message causes ParentBaseFee * GasUsed attoFIL to be burnt.

Real gas values

This release also includes our first "real" gas costs for primitive operations. The costs were designed to account for both the time that message execution takes, as well as the space a message adds to the state tree.

Deal-making changes

There are three key changes to the deal-making process.

Committed Capacity sectors

Miners can now pledge "Committed Capacity" (CC) sectors, which are explicitly stated as containing junk data, and must not include any deals. Miners can do this to increase their storage power, and win block rewards from this pledged storage.

They can mark these sectors as "upgradable" with lotus-miner sectors mark-for-upgrade. If the miner receives and accepts one or more storage deals, the sector that includes those deals will replace the CC sector. This is intended to maximize the amount of useful storage on the Filecoin network.

Fast-retrieval deals

Clients can now include a fast-retrieval flag when proposing deals with storage miners. If set to true, the miner will include an extra copy of the deal data. This data can be quickly served in a retrieval deal, since it will not need to be unsealed.

Multiple deals per sector

Miners can now pack multiple deals into a single sector, so long as all the deals fit into the sector capacity. This should increase the packing efficiency of miners.

Renamed features

To improve the user experience, we updated several names to mainatin standard prefixing, and to better reflect the meaning of the features being referenced.

In particular, the Lotus miner binary is now called lotus-miner, the default path for miner data is now ~/.lotusminer, and the environment variable that sets the path for miner data is now $LOTUS_MINER_PATH. A full list of renamed features can be found here.

Changelog

Downstream upgrades

  • Upgrades markets to v0.5.6 (#3058)
  • Upgrades specs-actors to v0.9.3 (#3151)

Core protocol

  • Introduces gas values, replacing placeholders (#2343)
  • Implements EIP-1559, introducing a network base fee, message gas fee cap, and message gas fee premium (#2874)
  • Implements Poisson Sortition for elections (#2084)

Deal-making lifecycle

Enhancements

UX

  • Provide status updates for data-transfer (#3162, #3191)
  • Miners can customise asks (#2046)
  • Miners can toggle auto-acceptance of deals (#1994)
  • Miners can maintain a blocklist of piece CIDs (#2069)

Contributors

The following contributors had 10 or more commits go into this release. We are grateful for every contribution!

Contributor Commits Lines ±
magik6k 361 +13197/-6136
Kubuxu 227 +5670/-2587
arajasek 120 +2916/-1264
whyrusleeping 112 +3979/-1089
vyzo 99 +3343/-1305
dirkmc 68 +8732/-3621
laser 45 +1489/-501
hannahhoward 43 +2654/-990
frrist 37 +6630/-4338
schomatis 28 +3016/-1368
placer14 27 +824/-350
raulk 25 +28718/-29849
mrsmkl 22 +560/-368
travisperson 18 +1354/-314
nonsense 16 +2956/-2842
ingar 13 +331/-123
daviddias 11 +311/-11
Stebalien 11 +1204/-980
RobQuistNL 10 +69/-74

0.1.0 / 2019-12-11

We are very excited to release lotus 0.1.0. This is our testnet release. To install lotus and join the testnet, please visit lotu.sh. Please file bug reports as issues.

A huge thank you to all contributors for this testnet release!