> 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-1.11/validator-management/wallet-sweeps.md).

# Wallet Sweeps

This page explains how to configure wallet sweeps on a validator. A wallet sweep monitors the balance of a specific party (the sender). When the sender's balance exceeds a configured maximum threshold, the validator automatically initiates a transfer to another party (the receiver), ensuring only a defined minimum balance remains.

### Configure a Wallet Sweep

{% stepper %}
{% step %}
**Navigate to the Sweep section**

Go to the Validator's details page and locate the **Sweep** section.
{% endstep %}

{% step %}
**Add a new sweep**

Click the **+** icon to configure a new sweep.
{% endstep %}

{% step %}
**Provide sweep configuration**

Fill in the following information:

* **Primary party ID (sender)**
* **Secondary party ID (receiver)**
* **Maximum balance threshold (USD)**
* **Minimum balance to retain (USD)**
* **Toggle on/off: Use Transfer Preapproval**

<details>

<summary>More info about these fields</summary>

| Field                               | Description                                                          |
| ----------------------------------- | -------------------------------------------------------------------- |
| **Primary party ID (sender)**       | The hosted party whose wallet balance will be monitored and swept    |
| **Secondary party ID (receiver)**   | The party that will receive the swept funds                          |
| **Maximum balance threshold (USD)** | When the sender's balance exceeds this amount, the sweep is executed |
| **Minimum balance to retain (USD)** | The amount that will remain in the sender's wallet after the sweep   |
| **Use Transfer Preapproval**        | See below                                                            |

</details>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Use Transfer Preapproval toggle behavior:**

* **Enabled (true):** Performs a direct automatic transfer. No acceptance by the receiver is required.
* **Disabled (false):** Creates a transfer offer that must be accepted by the receiver (manually or via auto-accept).
  {% endhint %}

### Alternative Sweep Configuration Method

Wallet sweeps can also be configured during:

* Initial validator setup
* Editing an existing validator setup

This is done through the standard validator configuration flow.

***


---

# 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:

```
GET https://docs.catalyx.solutions/catalyx-blockchain-manager/canton-network/version-1.11/validator-management/wallet-sweeps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.