Skip to content

Releases: celestiaorg/celestia-node

v0.21.2-arabica

21 Jan 11:44
5707592
Compare
Choose a tag to compare
v0.21.2-arabica Pre-release
Pre-release

This release introduces two notable features:

  • Bridge node <> core endpoint sync over gRPC
  • Archival trimming of historic block files

Bridge node sync over gRPC

⚠️ In this release, bridge nodes (BNs) will no longer use RPC for syncing against the given core endpoint. It will now use gRPC via #3998. Please make sure to pass a gRPC compatible (v3.3.0-arabica) core endpoint, passing the port via the --core.grpc.port flag. ⚠️

Additionally, it's possible to configure TLS for the gRPC connection via the following new flags:

      --core.tls                    Specifies whether TLS is enabled or not. Default: false
      --core.xtoken.path string     specifies the file path to the JSON file containing the X-Token for gRPC authentication. The JSON file should have a key-value pair where the key is 'x-token' and the value is the authentication token. NOTE: the path is parsed only if coreTLS enabled.If left empty, the client will not include the X-Token in its requests.

Archival trimming of historic block files

For archival node runners (both full node and bridge node), archival trimming will now be enabled by default, cutting archival node disk use for historic blocks in roughly half via #4028.

Note that the previous shwap release contains a condition to prevent nodes freshly syncing from storing the fourth quadrant files (.q4 files) for historic blocks that are outside the sampling window, but did not contain the functionality to clean up .q4 files once a block becomes freshly outdated, so disk use reductions are noticed only for the period between the completed full sync --> now.


What's Changed

Full Changelog: v0.21.1-arabica...v0.21.2-arabica

v0.21.1-arabica

20 Jan 11:58
bb68a13
Compare
Choose a tag to compare
v0.21.1-arabica Pre-release
Pre-release

What's Changed

  • fix(share/shwap/p2p/bitswap): set archivalPool ctx by @renaynay in #4052

Full Changelog: v0.21.0-arabica...v0.21.1-arabica

v0.21.0-arabica

20 Jan 10:28
cec0abe
Compare
Choose a tag to compare
v0.21.0-arabica Pre-release
Pre-release

What's Changed

New Contributors

Full Changelog: v0.20.4-arabica...v0.21.0-arabica

v0.20.4

27 Nov 21:16
51b7943
Compare
Choose a tag to compare

This is a security patch release, please upgrade as soon as possible.

What's Changed

Full Changelog: v0.20.3...v0.20.4

v0.20.4-mocha

27 Nov 21:13
51b7943
Compare
Choose a tag to compare
v0.20.4-mocha Pre-release
Pre-release

This is a security patch release for the mocha network, please upgrade as soon as possible.

What's Changed

Full Changelog: v0.20.3-mocha...v0.20.4-mocha

v0.20.4-arabica

27 Nov 21:12
51b7943
Compare
Choose a tag to compare
v0.20.4-arabica Pre-release
Pre-release

This is a security patch release for the arabica network, please upgrade as soon as possible.

What's Changed

Full Changelog: v0.20.3-arabica...v0.20.4-arabica

v0.20.3

27 Nov 11:21
f5d9b32
Compare
Choose a tag to compare

This patch release fixes a JSON serialisation error with libshare.Blob via #3958, fixing the state.SubmitPayForBlob endpoint.

What's Changed

Full Changelog: v0.20.2...v0.20.3

v0.20.3-mocha

26 Nov 10:44
f019e10
Compare
Choose a tag to compare
v0.20.3-mocha Pre-release
Pre-release

This patch release fixes a JSON serialisation error with libshare.Blob via #3958.

What's Changed

Full Changelog: v0.20.2-mocha...v0.20.3-mocha

v0.20.3-arabica

25 Nov 16:17
f019e10
Compare
Choose a tag to compare
v0.20.3-arabica Pre-release
Pre-release

This patch release fixes a JSON serialisation error with libshare.Blob via #3958.

What's Changed

Full Changelog: v0.20.2-arabica...v0.20.3-arabica

v0.20.2

20 Nov 10:12
b24d47f
Compare
Choose a tag to compare

NOTE: v0.18 and v0.19 are skipped for mainnet

Hey everyone, this is quite a mammoth of a release, so please hang tight. We have two major changes packaged in this release:

  • Shwap (protocol-breaking)
  • Celestia v3 compatibility (API-breaking)

The migration period for this release is quite tight (a bit longer than 2 weeks), so we urge all node operators to upgrade to this version and re-sync against the network by December 2nd.

As this release is API-breaking, we also urge all integrations to migrate to this new version by December 2nd. (The list of API breaks can be found below).

Shwap

This release features Shwap(CIP-19), a protocol-breaking feature that brings massive optimizations to disk usage(16x) and data access latencies. The new protocol is not backwards compatible with the currently deployed protocol and software.

Both protocols will run side-by-side for about a two-week transition period, from November 20 to December 2. During this period, node operators should migrate to the new version. At the end of the period, posted historical and recent data will no longer be available on the old protocol.

Migration Notes

Migration requires resyncing the node from scratch, as it now contains a new storage format.

Migration Steps over the old node:

  • Remove old data:
    • In home directory(default .celestia-<type>) => rm -rf inverted_index index data transients blocks
    • Keep keys directory to preserve peer and chain identity keys in place
  • Config updates
    • If defaults were in use, remove the old config and re-init in the next step
    • If you want to preserve the old config - move BlockstoreCacheSize entry from [Share.EDSStoreParams] section to just [Share]and remove GCIntervalRoutingTableRefreshPeriod
  • Re-init node for the Mocha p2p network
    • celestia init
  • Start the node and monitor syncing
    • celestia start

If the old node has to be kept running - initiate and start the new version in a different directory:

  • celestia init --node.store <new_path>
  • celestia start --node.store <new_path>

Celestia V3 compatibility

This release contains an upgrade to the celestia-app version (to v3). v3 will only be live on the mainnet in mid-December, but this release contains the requirements for compatibility with the upgrade.

Notable API breaks include:

  • simplification of the blob share and state modules via the deduplication of types (via [#3782](#3782))
  • share module now takes height instead of the full ExtendedHeader (via [#3870](#3870))

Comprehensive list of API breaks:

  • GetSharesByNamespace renamed to GetNamespaceData
  • the share module returns shwap.NamespaceData for the GetNamespaceData method
  • the share module now takes height (uint64) instead of the full ExtendedHeader for all methods
  • both the share and blob modules now use the go-square v2 libshare.Namespace (from https://github.com/celestiaorg/go-square/tree/v2.0.0) instead of the old share.Namespace for all methods
  • the state module now uses the go-square v2 libshare.Blob type (from https://github.com/celestiaorg/go-square/tree/v2.0.0) instead of the old one from the state module
  • the blob package now embeds the new go-square v2 libshare.Blob type mentioned above in the blob.Blob struct instead of the old v1 type.

Miscellaneous

What to look out for in the following releases:

  • the -experimental-pruning flag will soon be deprecated in favour of pruning becoming the default mode for all node types, requiring users to pass -archival to retain block history beyond the sampling window
  • the API gateway will be deprecated

What's Changed

Features

Fixes

Read more