Utility Release Information

On this page, you will find all relevant details about upcoming releases, including the schedule, system update requirements, and current environment versions. It is essential that all participants complete updates within the specified time frame to maintain compatibility across systems.

0.7.3

This version fixes a UI bug where certain operations cannot be performed if the counterparty did not vet the utility-commercials-v0 package.

Moreover, the UI does not poll for the utility-collateral-app package, which logged a noisy error in the previous UI version.

0.7.2

This is a technical release required as part of the work on Helm Charts for the Utilities.

The DAR files and the UI are unchanged from the previous version.

0.7.1

This version fixes a bug that was surfaced on the 0.7.0 UI and Top up app.

The DAR files are unchanged.

0.7.0

This version includes the following improvements to the Utilities:

  • Make the Utilities compatible with splice-0.1.9

  • Enable cross-provider compatibility, meaning that tokens can be transferred between owners onboarded by different providers

  • Integrating the token standard to enable the settlement of Delivery-versus-Payment workflows (DvPs)

The following additional DARS should be installed on your validator node:

  • utility-commercials-v0-0.2.0.dar

  • utility-credential-app-v0-0.2.2.dar

  • utility-registry-app-v0-0.2.0

Moreover, in order to deploy the UI, the environment variable UTILITY_APP_UTILITY_BACKEND_URL must be configured as follows:

Environment

Value

Dev Net

https://api.utilities.digitalasset-dev.com

Test Net

https://api.utilities.digitalasset-staging.com

Main Net

https://api.utilities.digitalasset.com

0.6.1

This version introduces two improvements to the Utility UI:

  • Optimize polling frequency: refresh active contract queries only when the ledger end has advanced

  • Fixing a bug which removed the ability to accept commercial agreements if CurrentVersion was not set

Users can deploy this release of the Utility directly together with the update to Canton 3.3. There is no need to apply 0.6.0 before upgrading to 0.6.1.

0.6.0

This version updates the Utility UI for compatibility with the latest Canton/Daml 3.3.

0.6.0 can be applied to Test Net from June, 11th 2025, and then to Main Net from June, 25th 2025 in line with the Canton/Daml 3.3 rollout schedule listed here

The UI is available here

The Utility Daml models are unchanged from the previous version.

The Utility UI requires Canton/Daml version 3.3 or later.

0.5.3

This release introduces a new application that automatically tops up either CredentialBilling or CommercialAgreement contracts when their locked deposits fall below a configurable threshold. The application can be deployed as a native Kubernetes cron job or as a long-running container, depending on your infrastructure needs.

  • Setup documentation: here

  • Application image: here

The UI has been updated - UI image: here

This version includes a bugfix to remove refetch interval for ledger offset.

This version is fully compatible with existing versions of the application.

0.5.1

This version introduces a new feature to the “Commercial Agreement” component, facilitating base fee payments. The following additional DARS should be installed on your Participant:

  • utility-commercials-v0-0.1.0.dar

The bundle files containing the DAR packages for the Utility are available in JFrog. Download version 0.5.1 of the bundle. The UI is available here

The release is compatible with existing versions of the application.

0.4.1

This version introduces a new component called “Commercial Agreement” and includes an update to the Credential Utility.

The billing processing for paid credentials incurs a service fee. To use this service provided by Digital Asset, a Commercial Agreement must be established. This agreement, issued by Digital Asset, can be accepted via the user interface and outlines the service fee terms.

Additionally, the credential billing process includes an on-ledger accounting feature for rewards that can be used in combination with a Reward Share component (not released yet). In order to support external signing, the CredentialOffer_AcceptFree and CredentialOffer_AcceptPaid will now set validFrom = None.

The new functionality is exposed through the User Interface. In addition, the User Interface includes numerous improvements to enhance usability and user experience.

The following additional DARS should be installed on your Participant Node:

  • utility-credential-app-v0-0.2.1

  • utility-commercials-v0-0.0.1

The bundle files containing the DAR packages for the Utility are available in JFrog. Download version 0.4.1 of the bundle. The UI is available here

The release is compatible with existing versions of the application.

0.3.5

This version introduces a fix to the Utility UI to ensure compatibility with the latest Daml models for Splice (specifically splice-amulet-0.1.6).

The Utility Daml models are unchanged from the previous version.

This version can be deployed by users who are on 0.3.4 at any time, as it does not require synchronisation.

0.3.4

This version introduces an update to the Utility Daml models for the Registry component.

An EnforcementService contract is introduced which, when setup between a holder and a registrar, allows the registrar to transfer the holder’s assets to another receiver under certain conditions.

A RegistrarConfiguration contract is introduced to define the required credentials in order to enter into an EnforcementService.

The Utility UI exposes these new features to users.

The following DARS must be installed in order to proceed with the release:

  • utility-credential-app-v0-0.1.0

  • utility-registry-app-v0-0.0.1

  • utility-registry-app-v0-0.1.0

  • utility-version-v0-0.0.1

The bundle files containing the DAR packages for the Utility are available in JFrog. Download version 0.3.4 of the bundle.

Rollout Schedule

The following schedule outlines the planned updates for each environment:

Environment

Rollout Date

Dev Net

15th Nov

Test Net

28th Nov

Main Net

9th Dec

All client nodes must be updated within this time frame to ensure compatibility and minimize disruptions.

Package Versions

After the rollout, all environments will be running on:

Credential App

Registry App

Frontend Image

Version

0.1.0

0.1.0

0.3.3