1
0
Fork 0
mirror of https://github.com/ACINQ/eclair.git synced 2025-02-24 06:47:46 +01:00
eclair/docs/release-notes/eclair-vnext.md
Pierre-Marie Padiou b4d285f1c4
Proper types for UNIX timestamps (#1990)
We define `TimestampSecond` and `TimestampMilli` for second and millisecond precision UNIX-style timestamps.

Let me know what you think of the syntaxic sugar, I went for `123456 unixsec` and `123456789 unixms`.

Json serialization is as follows for resp. second and millisecond precision. Note that in both case we display the unix format in second precision, but the iso format is more precise:
```
{
  "iso": "2021-10-04T14:32:41Z",
  "unix": 1633357961
}
{
  "iso": "2021-10-04T14:32:41.456Z",
  "unix": 1633357961
}
```
2021-10-18 16:13:42 +02:00

2.3 KiB

Eclair vnext

Major changes

API changes

Timestamps

All timestamps are now returned as an object with two attributes:

  • iso: ISO-8601 format with GMT time zone. Precision may be second or millisecond depending on the timestamp.
  • unix: seconds since epoch formats (seconds since epoch). Precision is always second.

Examples:

  • second-precision timestamp:
    • before:
    {
      "timestamp": 1633357961
    }
    
    • after
    {
      "timestamp": {
        "iso": "2021-10-04T14:32:41Z",
        "unix": 1633357961
      }
    }
    
  • milli-second precision timestamp:
    • before:
    {
      "timestamp": 1633357961456
    }
    
    • after (note how the unix format is in second precision):
    {
      "timestamp": {
        "iso": "2021-10-04T14:32:41.456Z",
        "unix": 1633357961
      }
    }
    

Miscellaneous improvements and bug fixes

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 20.04
  • AdoptOpenJDK 11.0.6
  • Maven 3.8.1

Use the following command to generate the eclair-node package:

mvn clean install -DskipTests

That should generate eclair-node/target/eclair-node-<version>-XXXXXXX-bin.zip with sha256 checksums that match 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 previous eclair versions. You don't need to close your channels, just stop eclair, upgrade and restart.

Changelog

<fill this section when publishing the release with git log v0.6.2... --format=oneline --reverse>