Collections

This page explains how Collections in Catalyst are used to manage reusable artifacts such as DAML archive (DAR) packages and UI packages. Items uploaded to Collections can later be uploaded to participants or deployed as applications.

For a step-by-step guide on uploading DAR files — including direct participant uploads, application-specific deployments (CPM, billing, Tradecraft), and Canton console commands — see Upload DARs.

My Collection

In the My Collection tab, DAR packages and UI packages can be uploaded to the console. These can then be uploaded to participants or deployed as applications respectively.

DAR Collections

When a Daml project is compiled, the compiler produces a Daml archive. These are platform-independent packages of compiled Daml code that can be uploaded to a Daml ledger or imported in other Daml projects. Daml archives have a .dar file ending.

DAR files can be uploaded from the user's local computer, or obtained from the Catalyst Package Manager (CPM).

To read about CPM, see the Canton Package Manager section of this guide.

Upload a DAR file

To upload a DAR file, go to the Collections tab and click Upload DAR File to open a side window.

UI Collections

The UI Collections feature of Catalyst allows you to provide a frontend for your app by publishing files exposed by HTTPS over a ledger-specific subdomain.

UI Collections must be uploaded to the console and deployed in the form of .zip files. The .zip should contain a single root directory, and the contents of that directory should contain an index.html along with the rest of the resources for your UI.

To upload a UI file, go to the Collections tab and click Upload UI File to open a side window.

---