github.com/decred/dcrlnd@v0.7.6/docs/release-notes/release-notes-0.3.0.md (about)

     1  # dcrlnd v0.3.0
     2  
     3  _Please note that while Bitcoin's Lightning Network has been in production for a few years, Decred's version still hasn't seen extensive use in mainnet. Users should be mindful of the total amount of funds comitted to dcrlnd wallets and channels._
     4  
     5  This is a major dcrlnd release including significant amount of changes.
     6  
     7  This release brings dcrlnd in line with the upstream lnd [release v0.11.1](https://github.com/lightningnetwork/lnd/releases/tag/v0.11.1-beta) and also includes ports for versions [v0.11.0](https://github.com/lightningnetwork/lnd/releases/tag/v0.11.0-beta), [v0.10.0](https://github.com/lightningnetwork/lnd/releases/tag/v0.10.0-beta) and [v0.9.0](https://github.com/lightningnetwork/lnd/releases/tag/v0.9.0-beta).
     8  
     9  ## Vulnerability Fixes
    10  
    11  This release includes fixes for [CVE-2020-26896](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-October/002857.html) and [CVE-2020-895](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-October/002858.html) made in the upstream lnd project. Fixes for these were released in upstream versions v0.11.0 and v0.10.0 respectively and the underlying issues were fully disclosed in Oct 20, 2020.
    12  
    13  Additional context for the vulnerabilities and its impact in LN implementations, written by the original discoverer can be found [here](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-October/002859.html) and [here](https://lists.linuxfoundation.org/pipermail/lightning-dev/2020-October/002855.html)
    14  
    15  ## Database Migrations
    16  
    17  This release contains database migrations for the new TLV encoding of invoices, payment address indexing and close summary information. Old versions of dcrlnd cannot use the new database version once these migrations are applied.
    18  
    19  ## Changelog
    20  
    21  The major Decred-specific feature introduced in this release is the ability to run a dcrlnd instance connected to a dcrwallet running in SPV mode. This is useful mostly for Decrediton users that will now have the option to run dcrlnd even when their wallet is using the SPV configuration.
    22  
    23  ### Node Syncing Config
    24  
    25  CLI users now have two options for the `--node` argument:
    26  
    27    - `--node=dcrd` instructs dcrlnd to connect to a dcrd instance for on-chain operations.
    28    - `--node=dcrw` instructs dcrlnd to use the underlying dcrwallet instance for on-chain operations.
    29  
    30  When using `--node=dcrd`, the `--dcrd.`-namespaced options should be used to configure the connection to the underlying dcrd node.
    31  
    32  When using `--node=dcrw`, either the `--dcrd.`-namespaced options should be used, in order to use an _embedded_ dcrwallet instance (that is, dcrwallet runs automatically inside dcrlnd) **or** the `--dcrw.`-namespaced options should be used to configure a __remote__ dcrwallet instance.
    33  
    34  Note that SPV mode is only supported on remote dcrwallet instances.
    35  
    36  For hub nodes (that is, nodes that are online most of the time and offer the ability to receive open channel requests) the recommended config setting is to use embedded wallets with a dcrd instance.
    37  
    38  ### Wumbo Channel Support
    39  
    40  This release adapts the [Wumbo](https://github.com/lightningnetwork/lnd/pull/4429) feature for the realities of Decred. Wumbo channel support can be enabled by running dcrlnd with `--protocol.wumbo-channels` and has a global maximum channel size of 500 DCR.
    41  
    42  ### Relevant Upstream Changes
    43  
    44  The following is a non-exhaustive list of the relevant upstream changes that were ported to dcrlnd. These include changes from the upstream [v0.9](https://github.com/decred/dcrlnd/pull/74), [v0.10](https://github.com/decred/dcrlnd/pull/99) and [v0.11](https://github.com/decred/dcrlnd/pull/103) lines. Please refer to the respective upstream releases for additional information.
    45  
    46    - Multi Path Payment (MPP) support so that a single payment can be split among multiple channels.
    47    - Track payments with a new Payment Address field.
    48    - Additional TLV data sent in payments, which allows creating new use cases to deliver payload data via LN payments.
    49    - Keysend payment experiment which allows spontaneous payments without the need for a precreated invoice.
    50    - Upfront shutdown script support to enforce channel closure to pay to pre-configured addresses.
    51    - HTLC Interception API to allow creation of custom payment forwarding engines.
    52    - Additional data in Channel Close Summaries.
    53    - Add ability to limit max remote pending HTLC amount during channel opening.
    54    - Anchor outputs experimental feature.
    55    - External channel funding experimental feature.
    56    - Healthchecks to ensure adequate operating conditions of the node
    57    - Several bug fixes throughout the app.
    58  
    59  # Porting Effort
    60  
    61  A total of 450 upstream PRs were considered for inclusion. The list of of PRs can be found in the acompanying [upstream-prs.csv](/docs/upstream-prs.csv) doc.
    62  
    63  
    64  # Decred Contributors (Alphabetical Order)
    65  
    66    - Fernando Guisso
    67    - Matheus Degiovani
    68    - Ole Andre Birkedal
    69  
    70  # Acknowledgement
    71  
    72  The majority of the work included in this release is from features and bugfixes performed by the contributors to the upstream [lnd](https://github.com/lightningnetwork/lnd) project that were ported to Decred.
    73  
    74  We wish to sincerely thank them for providing such a high quality project and hope we can continue to contribute in building a large scale and cross-coin LN ecosystem.
    75