> For the complete documentation index, see [llms.txt](https://docs.catalyx.solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-2.0/console-guide-canton/validators/dars.md).

# DARs

<div data-with-frame="true"><figure><img src="/files/JaWYnBGaxV9dpxHMc7H7" alt=""><figcaption></figcaption></figure></div>

## Columns

<table><thead><tr><th width="180">Column</th><th>Contents</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>The package name.</td></tr><tr><td><strong>Version</strong></td><td>The package version.</td></tr><tr><td><strong>Package ID</strong></td><td>The full package hash, truncated, with a copy button.</td></tr><tr><td><strong>Size</strong></td><td>Package size.</td></tr><tr><td><strong>Known since</strong></td><td>When the participant first saw the package.</td></tr></tbody></table>

## Searching

The search box matches on **name, version, or package ID**, and is forgiving: it matches substrings and in-order character sequences, so partial or approximate terms work. Search results replace the table; clear the box to return to the full list.

## Uploading a DAR

{% stepper %}
{% step %}
**Click `Upload .dar`**

A file picker opens, filtered to `.dar` files.
{% endstep %}

{% step %}
**Choose the file**

An upload strip appears below the toolbar showing the file name, its size, a progress bar, and the status **Ready to upload**.
{% endstep %}

{% step %}
**Click the upload button**

The status changes to **Uploading…** and the progress bar advances.
{% endstep %}

{% step %}
**Check the result**

On success the status becomes **Uploaded `<filename>`** and the package list refreshes. On failure the error message from the participant is shown in place of the status.
{% endstep %}
{% endstepper %}

Use the dismiss button to clear the strip and pick a different file.

{% hint style="danger" %}
**There is no confirmation step.** Clicking upload sends the DAR to the participant immediately. Uploading a Daml package cannot be undone — packages are permanent on the ledger — so check you have the right file and the right validator first.
{% endhint %}

{% hint style="warning" %}
The file picker will accept a file that is not really a DAR. Validation happens on the participant, so an invalid file produces an upload error rather than being rejected in the browser.
{% endhint %}

{% hint style="info" %}
Very large DARs may be rejected before reaching the participant, by the request size limit on the API. If a large upload fails with a size-related error rather than a Daml error, raise it with IntellectEU support — the limit is a platform setting, not something you can change from the console.
{% endhint %}

## States

| Situation              | What you see                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------- |
| No packages            | **No DAR packages yet** — *Upload a .dar file to deploy contracts to this validator.* |
| Search with no matches | **No packages match** — *Try a different search term.*                                |
| Load failed            | **Failed to load DAR packages**, with the error                                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-2.0/console-guide-canton/validators/dars.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
