# Harmonize 1.3 (March 10, 2022)

Welcome to the 1.3 release of Harmonize. There are many updates in this version that we hope you will like. Some of the key highlights include:

- [A new online documentation portal](#a-new-online-documentation-portal)
- [A revamped application dashboard](#a-revamped-application-dashboard)
- [A visual policy builder](#a-visual-policy-builder)
- [An integration of Tezos](#an-integration-of-tezos)
- [An integration of Polkadot](#an-integration-of-polkadot)
- [A new API Management](#a-new-api-management)
- [A more elaborate support for cold vaults](#a-more-elaborate-support-for-cold-vaults)
- [Additional enhancements](#additional-enhancements)


## Metaco and You

### A new online documentation portal

We are happy to welcome you on this new portal for documentation and news, which we hope will further reinforce our collaborative efforts with our clients and will bring more transparency to our platform capabilities and improvements.

Multiple sections have been introduced and the design has been refreshed. New sections include:

- A Getting started guide, which covers the essential principles of Harmonize, examples of the main use cases, and describes the product architecture and security model
- A Blog section, which we will use to communicate the evolution of our platform and services
- A Versioning page, which describes our versioning strategy and **an up-to-date list of our APIs deprecations**


As usual, the latest API specification is also available.

## Platform

### A revamped application dashboard

We make a big effort to always improve the user experience of our web application.

This release introduces a new **dashboard**, which presents a summary of the key information of the system: a list of the last **requests**, the **tasks** waiting to be approved, the last **transfers** or even the balances of the cryptos that contribute most to assets under management.

We are looking forward to your feedback!

### A visual policy builder

Security and governance are at the core of Harmonize.

This release introduces a visual policy builder allowing the selection of **policy conditions** and **approval workflows** directly from the user interface, with a rich library. An advanced edition mode is still available for power users looking to customize policies beyond default use cases.

This is only the **beginning** and we plan to regularly grow the library of policies based on your requests and needs.

### An integration of Tezos

This release introduces additional support for the **Tezos** cryptocurrency, with full support for account creation, regular transactions, and baking delegation operations. We are working on adding a full support of smart contracts in a future release.

### Deployment

As Tezos is a new ledger, its ***deployment is optional*** and requires, at a high level, configuration changes to the following components:

- Ledger Accounting
- Tezos Indexer


Our customer service will be happy to help you configure according to your infrastructure and needs.

## An integration of Polkadot

This release introduces a native support for the **Polkadot network**, with full support of account creation and DOT transfer operations. The staking delegation API is already present if you want to start integrating it, however it will only be fully operational as part of our **1.4 release**.

> *Note: we refer to Polkadot as Substrate in the Harmonize configuration, as we aim to continue the integration of chain parallel or parachain.*


### Deployment

As Polkadot is a new ledger, its ***deployment is optional*** and requires, at a high level, configuration changes to the following components:

- Accounting ledger
- Polkadot indexer


Our customer service will be happy to help you configure according to your infrastructure and needs.

## A new API Management

The **evolutivity of Harmonize is key** to us and we take great care in applying the best patterns for this.

This release introduces an API management component that allows us to guarantee a single interface for integrations, despite the growing number of services. For the most curious developers, this approach is what allows us to integrate the new "Cold Vault" APIs.

### Possible impact

***If you are using our web application, please read this section.***
Following the deployment of the API Management (APIM) component, all endpoints will be grouped under the same URL.

With default values, your deployment process should not be affected, though an action will be required for all registered mobile phones. Each user will need to update its application (>= 0.10.10) and change the ***Harmonize URL*** directly on the application. This new URL will be available on the authentication page, as a QR Code, under the ***Create new account*** link.

### Deployment

Our API management is being deployed as a new component, which is **mandatory** from Harmonize 1.3.
Two main values must be provided on our distributed Helm chart:

- `api-management.cors.allowedOrigin` in order to configure CORS
- `api-management.ingress.host` in order to configure ingress URL


## A more elaborate support for cold vaults

Since **our architecture was designed to be open**, it was already possible to fully disconnect a vault to set up an air-gapped, cold storage.

We have however taken your requests into account and introduce in this release an **official API** to manage cold vaults and a **turnkey component** to bridge the Cold Vault side.

## Additional enhancements

- 100+ filter parameters added to our query API
- Intent status are automatically updated when the intent is stalled or expired
- API schema names are now prefixed with a namespace
- The genesis operation now supports multi domain creation
- Numbers are now allowed into role names
- HTTP is now supported as communication protocol for notary
- A new intent `v0_ExecuteExtension` was introduced for future purpose