This is a Lotus Node only release, which includes a variety of new features, improvements, and fixes, particularly focused on enhancing ETH RPC functionality. Key highlights of this release include:
-
New Features:
- Trace Filter API: Added support for the
trace_filterRPC method, allowing users to configureEthTraceFilterMaxResultsto limit the number of results returned in any individualtrace_filterRPC API call. (filecoin-project/lotus#12123) - Filecoin to ETH Address Conversion: The
FilecoinAddressToEthAddressRPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on the client's re-org tolerance. Note that this is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but it is non-breaking when using the API via any other RPC method as it adds an optional second argument. (filecoin-project/lotus#12324) - Sending to ETH addresses The
lotus sendcommand now supports sending to ETH address recipients. (filecoin-project/lotus#12319)
- Trace Filter API: Added support for the
-
Improvements:
- Gateway Enhancements: Significant improvements to the
lotus-gatewayincluding better rate limiting and stateful handling. The--per-conn-rate-limitnow works as advertised, and a new--eth-max-filters-per-connoption allows setting the maximum number of filters and subscriptions per connection, defaulting to 16. Stateful Ethereum APIs are now disabled for plain HTTP connections and require websockets. Additionally, the default value for theEvents.FilterTTLconfig option has been reduced from 24h to 1h. (filecoin-project/lotus#12315) - Performance Improvements: Addressed SQLite index selection performance regressions, significantly improving query times for event-related data. (filecoin-project/lotus#12261).
- Gateway Enhancements: Significant improvements to the
☢️ Upgrade Warnings ☢️
lotus-gatewaybehaviour, CLI-arguments and APIs have received minor changes. See the improvements section in theOrganised Changelogsection below for more information.- The
FilecoinAddressToEthAddressRPC introduces a breaking change for users of the go-jsonrpc library or Lotus as a library. - We are aware that legacy/historical Drand lookups via
StateGetBeaconEntryare currently broken. If you rely onStateGetBeaconEntryfor looking up historic beacons, we recommend waiting for the Lotus v1.29.1 release. You can follow the progress on this issue in #12414.
📝 Changelog
See v1.28.2...release/v1.29.0 for the set of changes since the last release.
From v1.28.2...release/v1.29.0#diff-33ef32bf6c23acb95f5902d7097b7a1d5128ca061167ec0716715b0b9eeaa5f6
Organized Changelog
New features
trace_filter (filecoin-project/lotus#12123). Configuring EthTraceFilterMaxResults sets a limit on how many results are returned in any individual trace_filter RPC API call.
FilecoinAddressToEthAddress RPC can now return ETH addresses for all Filecoin address types ("f0"/"f1"/"f2"/"f3") based on client's re-org tolerance. This is a breaking change if you are using the API via the go-jsonrpc library or by using Lotus as a library, but is a non-breaking change when using the API via any other RPC method as it adds an optional second argument.
(filecoin-project/lotus#12324).
lotus-shed indexes inspect-events health-check command (filecoin-project/lotus#12346).
Improvements
lotus-gateway
--per-conn-rate-limit now works as advertised.
--eth-max-filters-per-conn is new and allows you to set the maximum number of filters and subscription per connection, it defaults to 16.
16 and applied separately to filters and subscriptions. This limit is now unified and applies to both filters and subscriptions.
Events.FilterTTL config option has been reduced from 24h to 1h. This means that filters will expire on a Lotus node after 1 hour of not being accessed by the client.
EthGetBlockByHash API (#12359) (filecoin-project/lotus#12359)
Dependencies
Chores
CONTRIBUTING.md and update README.md (#12366) (filecoin-project/lotus#12366)
Update_Dependencies_Lotus.md (#12107) (filecoin-project/lotus#12107)
embed pkg to split long template content to file (#12193) (filecoin-project/lotus#12193)
chore: all: fix comment (#12256) (filecoin-project/lotus#12256)
👨👩👧👦 Contributors
| Contributor | Commits | Lines ± | Files Changed |
|---|---|---|---|
| Rod Vagg | 45 | +4839/-2634 | 217 |
| Peter Rabbitson | 18 | +2503/-2195 | 209 |
| Jakub Sztandera | 5 | +2695/-1074 | 61 |
| Mikers | 1 | +1274/-455 | 23 |
| Masih H. Derkani | 7 | +873/-682 | 37 |
| Andrew Jackson (Ajax) | 3 | +732/-504 | 75 |
| LexLuthr | 3 | +167/-996 | 8 |
| Piotr Galar | 6 | +622/-372 | 15 |
| Aarsh Shah | 11 | +791/-177 | 44 |
| Phi-rjan | 15 | +476/-178 | 50 |
| web3-bot | 32 | +330/-319 | 39 |
| Steven Allen | 8 | +367/-165 | 41 |
| aarshkshah1992 | 17 | +379/-87 | 32 |
| Frrist | 1 | +403/-22 | 5 |
| Łukasz Magiera | 4 | +266/-27 | 13 |
| winniehere | 1 | +146/-144 | 3 |
| Steve Loeppky | 5 | +162/-53 | 7 |
| Aryan Tikarya | 2 | +183/-8 | 7 |
| adlrocha | 2 | +123/-38 | 21 |
| Jiaying Wang | 7 | +52/-68 | 9 |
| Ian Davis | 2 | +60/-38 | 5 |
| Aayush Rajasekaran | 1 | +80/-2 | 2 |
| hanabi1224 | 4 | +46/-4 | 5 |
| Laurent Senta | 1 | +44/-1 | 2 |
| jennijuju | 6 | +21/-20 | 17 |
| Brendan O'Brien | 1 | +25/-10 | 2 |
| Jennifer Wang | 4 | +24/-8 | 6 |
| dependabot[bot] | 4 | +15/-15 | 8 |
| riskrose | 1 | +8/-8 | 7 |
| Phi | 1 | +6/-6 | 6 |
| linghuying | 1 | +5/-5 | 5 |
| fsgerse | 2 | +3/-7 | 3 |
| PolyMa | 1 | +5/-5 | 5 |
| zhangguanzhang | 1 | +3/-3 | 2 |
| luozexuan | 1 | +3/-3 | 3 |
| Po-Chun Chang | 1 | +6/-0 | 2 |
| Kevin Martin | 1 | +4/-1 | 2 |
| simlecode | 1 | +2/-2 | 2 |
| ZenGround0 | 1 | +2/-2 | 2 |
| GFZRZK | 1 | +2/-1 | 1 |
| zl | 1 | +1/-1 | 1 |
| qwdsds | 1 | +1/-1 | 1 |
| Elias Rad | 1 | +1/-1 | 1 |