Release notes

What has been changed, and how to update between versions.

Coconut update (v4.3.1)

Release date: 2022-11-28

This patch release fixes the following:

  • Synchronize calls to DIDMan to avoid parallel calls from clients creating conflicted DID documents

Full Changelog:…v4.3.1

Chestnut update (v4.3.0)

Release date: 2022-10-27

This update adds forward compatibility with the upcoming v5 release. It removes validation of legalBase from NutsAuthorizationCredential, which was never properly defined in the JSON-LD contexts. The upcoming v5 release will refuse to issue credentials with fields that were not defined in the credential’s context. But, since legalBase is required up until v4.3.0, it would mean future NutsAuthorizationCredentials issued by upcoming v5 can’t be used in v4. Hence, the removal of the validation, to become forwards compatible with v5.

See for more information

Full Changelog:…v4.3.0

Chestnut update (v4.2.4)

Release date: 2022-09-29

Set IRMA to production mode when the Nuts node is in strict-mode. This allows an IRMA app in non-developers-mode to connect to the Nuts node.

Full Changelog:…v4.2.4

Chestnut update (v4.2.3)

Release date: 2022-09-21

Bugfix for Hashicorp Vault key store backend: stacktrace on missing key

Bugfix VAULT_TOKEN gets overwritten with empty default

Full Changelog:…v4.2.3

Chestnut update (v4.2.2)

Release date: 2022-08-31

Bugfix for Redis: not being able to load state data from database.

Full Changelog:…v4.2.1

Chestnut update (v4.2.0)

Release date: 2022-08-29

Backports upstream features for connecting to Redis over TLS.

Full Changelog:…v4.2.0

Chestnut update (v4.1.1)

Release date: 2022-08-18

This patch adds TLS offloading for gRPC connections with support for DER encoded client certificates. This is required for supporting TLS offloading on HAProxy.

Full Changelog:…v4.1.1

Chestnut update (v4.1.0)

Release date: 2022-08-04

This minor release adds TLS offloading for gRPC connections. The TLS Configuration page contains instructions on how to setup various TLS deployment schemes.

Full Changelog:…v4.1.0

Chestnut (v4.0.0)

Release date: 2022-07-22

This release introduces a pluggable storage system and support for:

  • BBolt backups

  • Experimental Redis support

Full Changelog:…v4.0.0

Cashew (v3.0.0)

Release date: 2022-06-01

This release no longer contains the V1 network protocol.

Full Changelog:…v3.0.0

Brazil (v2.0.0)

Release date: 2022-04-29

This version implements the V2 network protocol. The V2 network protocol combines gossip style messages with a fast reconciliation protocol for larger difference sets. The protocol can quickly identify hundreds of missing transactions. The new protocol is much faster than the old protocol and its performance is currently limited by the database performance.

Besides the improved network protocol, this version also implements semantic searching for Verifiable Credentials. Till this version, searching for VCs only supported the NutsOrganizationCredential and NutsAuthorizationCredential. With the new semantic search capabilities all kinds of credentials can be issued and found. This is the first step for the Nuts node to become a toolbox that supports multiple domains.

Full Changelog:…v2.0.0

Almond (v1.0.0)

Release date: 2022-04-01

This is the initial release of the Nuts node reference implementation. It implements RFC001 - RFC016 specified by the Nuts specification. This release is intended for developers. It contains a stable API that will be backwards compatible for the next versions. The releases until the first production release will mainly focus on network and Ops related features.

To start using this release, please consult the getting started section.

Features / improvements

Future releases will list new features and improvements that have been added since the previous release.

Dropped features

New major releases might drop support for features that have been deprecated in a previous release. Keep an eye on this section for every release.

Deprecated features

Some features will be deprecated because they have been succeeded by an improved version or when they are no longer used. Removing old code helps in reducing maintenance costs of the code base. Features that are marked as deprecated will be listed here. Any vendor using these features will have until next version to migrate to the alternative. Keep an eye on this section for every release.

  • VCR V1 API is deprecated and will be removed in the next release. Please migrate all calls to the V2 API.


This section contains a list of bugfixes. It’ll match resolved Github issues with the bug tag.