Eclair v0.3.4 Release Notes

Release Date: 2020-04-06 // about 4 years ago
  • ๐Ÿš€ This release includes many improvements, as well as a few bug fixes. Its is fully compatible with 0.3.3 (and all previous versions of eclair).

    Major changes

    Wumbo channels

    ๐Ÿ‘€ Eclair now supports wumbo channels (see lightningnetwork/lightning-rfc#596).
    โšก๏ธ To activate it, update your eclair.conf and set eclair.features = 080a8a (note that if you chose to enable/disable a different set of features from the recommended ones, that value will be slightly different).
    You also need to set an upper limit on channels size in eclair.max-funding-satoshis.

    ๐Ÿ”ง Once that's configured, you can open channels above the previous 0.167 BTC limit (if your peer accepts it).
    Be cautious though; bigger channels may attract more attackers towards your node.
    ๐Ÿš€ Make sure your node deployment is secure before you start opening many large channels.

    Packaging rework

    ๐Ÿ‘€ Eclair is now packaged as a zip folder (see #1307).
    ๐Ÿ— This new packaging allows us to provide verifiable builds for eclair-node and eclair-node-gui.
    ๐Ÿ— It also brings us one step closer to verifiable builds for eclair-mobile and phoenix.

    Note that you won't find a capsule jar as before.
    ๐Ÿ“ฆ To start eclair you should now use one of the scripts provided in the package.

    ๐Ÿ›  Miscellaneous improvements and bug fixes

    ๐Ÿ”Š We've done a lot of work on our metrics and logs; make sure to leverage those to improve your node's monitoring.

    ๐Ÿ‘€ We've added support for multiple Bitcoin wallets (see #1334).

    ๐Ÿš€ We've found and fixed a few more gossip bugs; if you previously had issues getting your node's information on explorers, this release should fix it.

    ๐ŸŽ We've also fixed many small bugs and heavily refactored parts of the codebase, which paves the way for more scalability and performance improvements.

    ๐Ÿ‘Œ Verifying signatures

    ๐Ÿš€ You will need gpg and our release signing key 7A73FE77DE2C4027. Note that you can get it:

    To import our signing key:

    $ gpg --import drouinf.asc
    

    ๐Ÿš€ To verify the release file checksums and signatures:

    $ gpg -d SHA256SUMS.asc \> SHA256SUMS.stripped $ sha256sum -c SHA256SUMS.stripped
    

    ๐Ÿ— Building

    ๐Ÿ— Eclair builds are deterministic. To reproduce our builds, please use the following environment (*):

    • Ubuntu 19.10
    • AdoptOpenJDK 11.0.6
    • Maven 3.6.3

    ๐Ÿ“ฆ Use the following command to generate the eclair-node package:

    mvn clean install -DskipTests
    

    That should generate an eclair-node-0.3.4-24aa710-bin.zip with a sha256 checksum that matches the one we provide and sign in SHA256SUMS.asc

    ๐Ÿ— (*) You may be able to build the exact same artefacts with other operating systems or versions of JDK 11, we have not tried everything.

    โฌ†๏ธ Upgrading

    ๐Ÿš€ This release is fully compatible with Eclair v0.3.3. You don't need to close your channels, just stop eclair, upgrade and restart.

    ๐Ÿ”„ Changelog

    • Electrum: allow watcher to watch for mempool transactions (#1298)
    • โšก๏ธ Notify change in balance when updating network fee (#1301)
    • ๐Ÿ›  Fix AuditDb flaky test (#1304)
    • ๐Ÿ‘ Better logging for transport handler (#1303)
    • ๐Ÿ›  Fix networkstats API call (#1309)
    • Payment request: ignore fields with invalid length (#1308)
    • Node relayer faster fulfill (#1306)
    • ๐Ÿ‘ Electrum: add support for socks5 proxies (#1315)
    • โšก๏ธ Re-send ChannelUpdate to private channels (#1317)
    • ๐Ÿ›  Fix random trampoline test failure (#1318)
    • SendToRoute with routing hints (#1325)
    • ๐Ÿ‘ Allow receiving non-standard payments (#1326)
    • โž• Add log for normal application shutdown. (#1329)
    • Rework packaging (#1307)
    • ๐Ÿ‘‰ Make Commitments method return Try[] (#1311)
    • Channel sends typed responses (#1321)
    • ๐Ÿ”จ Refactor MultiPartPaymentFSM (#1324)
    • ๐Ÿ‘‰ Make UpfrontShutdownScript a TLV record (#1333)
    • ๐Ÿ‘ Wumbo support (#1323)
    • Avoid illegal reflective operation during startup (#1313)
    • ๐Ÿ›  fixup! Use correct assembly descriptors and use bash explicitly. (#1337)
    • Send ping if no message received from peer for 30s (#1340)
    • Payment metrics (#1312)
    • โšก๏ธ Update kanela-agent 1.0.1->1.0.5 (#1341)
    • ๐Ÿ‘ Allow users to have multiple wallets in bitcoind (#1334)
    • โž• Add more information to GetInfoResponse (#1344)
    • โšก๏ธ Re-send ChannelUpdate on reconnection (fixes 8afc00d) (#1342)
    • Funder reserve for future fee increase (#1319)
    • ๐ŸŒฒ Minor: Reduced some log levels (#1348)
    • Harden requirements on htlc-minimum-msat (#1339)
    • ๐Ÿ“ฆ Centralize metrics per package (#1350)
    • ๐Ÿ‘Œ Improve AddHtlcFailed (#1349)
    • Split the Peer in two (#1347)
    • ๐Ÿšš Minor: removed unused code (#1353)
    • ๐Ÿ›  fixup! Support for Tor onion services (#736) (#1356)
    • ๐Ÿ— BUILD: mention that Docker is needed for tests (#1358)
    • ๐Ÿ›  fixup! Split the Peer in two (#1347) (#1357)
    • ๐Ÿ‘‰ Use CLTV as tie-breaker for offered htlc output sorting (#790)
    • โž• Add wallet balance metric (#1355)
    • ๐Ÿ›  fixup! Use CLTV as tie-breaker for offered htlc output sorting (#790) (#1360)
    • PostRestartHtlcCleaner handle channel closing (#1338)
    • ๐Ÿ›  fixup! Harden requirements on htlc-minimum-msat (#1339) (#1362)
    • ๐Ÿ›  fixup! Harden requirements on htlc-minimum-msat (#1339) (#1363)
    • ๐Ÿ›  fixup! Split the Peer in two (#1347) (#1365)