Upload DARs

How to upload and deploy DAR files in CatalyX Blockchain Manager.

Overview

DAR (DAML Archive) files contain compiled DAML application packages. They must be uploaded to a participant before any DAML templates or ledger workflows from that package can be used.

DAR files are required to:

• deploy DAML applications

• enable ledger workflows

• install application templates on participants

• support CPM, billing, Tradecraft, and other Canton applications

DAR files use the .dar extension. Examples: cpm-<version>.dar, ieu-billing-<version>.dar, canton-swap-<version>.dar.

---

Upload Flow Overview

Uploading a DAR in CatalyX is typically a two-step process:

Step	Description
Step 1	Upload the DAR to Collections
Step 2	Deploy the DAR from Collections to a Participant

Storing DARs in Collections first allows packages to be reused across multiple participants and environments without re-uploading the source file each time.

You can also upload a DAR directly to a participant without going through Collections. See Part 2 below.

---

Part 1 — Upload DAR to Collections

Collections are reusable artifact repositories inside CatalyX. They support both DAR packages and UI packages. Once uploaded, a DAR in Collections can be deployed to any participant or referenced by applications.

For a full overview of Collections, see the Collections page.

1

Navigate to Collections

Open CatalyX Blockchain Manager and navigate to Collections from the left navigation menu. The page contains two sections: DAR Collections and UI Collections.

2

Open the Upload Dialog

In the DAR Collections section, click Upload DAR File.

3

Select the DAR File

Choose the .dar file from your local machine (e.g. cpm-0.2.1.dar, ieu-billing-1.0.0.dar).

4

Confirm the Upload

After upload, the DAR appears in the DAR Collections table with the following details:

• Package name

• File size

• Available actions: Deploy, Download, Remove

The package is now available for deployment to any participant.

---

Part 2 — Upload DAR to a Participant

1

Navigate to the Participant

Open Participants from the left navigation and select the target participant.

2

Open the DARs Tab

Inside the participant details page, open the DARs tab and click Upload DAR.

3

Select DAR Files

Choose one or multiple .dar files. Multi-file upload is supported.

After upload:

• The package appears in the participant DARs list

• The package hash becomes visible

• DAML templates from the package become available on the ledger

---

UI Package Uploads

UI packages provide frontend applications exposed through HTTPS. They are uploaded to Collections → UI Collections separately from DAR files.

UI packages must:

• be uploaded as .zip files

• contain a single root directory

• include an index.html at the root

1

Navigate to UI Collections

Go to Collections → UI Collections.

2

Upload the UI File

Click Upload UI File and select the .zip package.

After upload, the package appears in UI Collections and becomes available for deployment.

For a full overview of UI Collections and how to deploy UI packages as applications, see the Collections page.

---

Application-Specific DAR Deployments

CPM

1

Download cpm-${version}.dar

2

Upload the DAR to the target participant

3

Verify the DAR is visible in the participant DAR list

Billing Subscriber

1

Download ieu-billing-${version}.dar

2

Upload the DAR to the target participant

3

Confirm deployment completed successfully

Tradecraft (CantonSwap)

1

Download canton-swap-${version}.dar

2

Upload the DAR to the participant

3

Verify the package is visible in the DAR list

---

Verification Checklist

Validation	Expected Result
DAR visible in Collections	Package appears in DAR Collections table
DAR uploaded to participant	Package visible under Participant DARs
Package hash generated	Hash visible in DAR list
Application templates available	DAML workflows accessible on the ledger
No upload errors	Upload completed without errors

---

Troubleshooting

Issue	Cause	Resolution
DAR upload fails	Invalid file format	Verify the file uses the .dar extension
DAR not visible on participant	Upload incomplete or failed	Re-upload the package
Templates unavailable after upload	Package uploaded to Collections but not deployed to participant	Upload the DAR to the participant (Part 2)
UI deployment fails	Invalid ZIP structure	Ensure the ZIP contains a single root folder with index.html
Upload button disabled	Insufficient permissions	Verify your user has the required access rights

---

Best Practices

• Store reusable DARs in Collections so they can be deployed to multiple participants without re-uploading

• Use versioned naming conventions (e.g. cpm-0.2.1.dar) to distinguish package versions

• Keep older package versions in Collections for rollback purposes

• Verify package hashes after deployment

• Upload all required DARs before deploying dependent applications

• Keep production and development packages separate