lnd/docs/release-notes/release-notes-0.21.0.md

Release Notes

• Bug Fixes
• New Features
  • Functional Enhancements
  • RPC Additions
  • lncli Additions
• Improvements
  • Functional Updates
  • RPC Updates
  • lncli Updates
  • Breaking Changes
  • Performance Improvements
  • Deprecations
• Technical and Architectural Updates
  • BOLT Spec Updates
  • Testing
  • Database
  • Code Health
  • Tooling and Documentation
• Contributors (Alphabetical Order)

Bug Fixes

• Chain notifier RPCs now return the gRPC Unavailable status while the sub-server is still starting. This allows clients to reliably detect the transient condition and retry without brittle string matching.

• Fixed an issue where the TLS manager would fail to start if only one of the TLS pair files (certificate or key) existed. The manager now correctly regenerates both files when either is missing, preventing "file not found" errors on startup.

• Fixed race conditions in the channel graph database. The Node.PubKey() and ChannelEdgeInfo.NodeKey1/NodeKey2() methods had check-then-act races when caching parsed public keys. Additionally, DisconnectBlockAtHeight was accessing the reject and channel caches without proper locking. The caching has been removed from the public key parsing methods, and proper mutex protection has been added to the cache access in DisconnectBlockAtHeight.

New Features

• Basic Support for onion messaging forwarding consisting of a new message type, OnionMessage. This includes the message's definition, comprising a path key and an onion blob, along with the necessary serialization and deserialization logic for peer-to-peer communication.

Functional Enhancements

RPC Additions

lncli Additions

Improvements

Functional Updates

• Added support for the upfront-shutdown-address configuration in lnd.conf, allowing users to specify an address for cooperative channel closures where funds will be sent. This applies to both funders and fundees, with the ability to override the value during channel opening or acceptance.

RPC Updates

lncli Updates

Breaking Changes

Performance Improvements

Deprecations

Technical and Architectural Updates

BOLT Spec Updates

Testing

Database

• Freeze the graph SQL migration code to prevent the need for maintenance as the sqlc code evolves.

Code Health

Tooling and Documentation

Contributors (Alphabetical Order)

• Boris Nagaev
• Elle Mouton
• Mohamed Awnallah
• Nishant Bansal