> ## Documentation Index
> Fetch the complete documentation index at: https://loopscale.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vault Manager UI Guide

This page documents the Vault Manager interface used to configure a Loopscale vault. Only the vault's manager wallet can open it.

> [!NOTE]
>
> Some screenshots predate the current UI. Where a screenshot and this page disagree (for example, the older `Settings` layout), this page is correct.

Use it as the UI reference for:

* operational controls
* risk parameter updates
* cap and allocation limits
* rewards and timelock workflows

## Navigation

The vault manager UI is organized into tabs:

* `Overview`
* `Collateral`
* `Rates`
* `Allocation`
* `Principal Caps`
* `Settings`
* `Timelocks`
* `Rewards`

Most edit tabs follow the same pattern:

* inline field edits
* row-level `Reset` when a row has unsaved changes
* a `Summary of changes` panel
* a primary apply action (`Save changes`, `Create Limits`, or `Create Principal Caps`)
* a page-level `Reset` action

## Overview

Purpose: high-level monitoring and vault metadata.

Key elements:

* Metric cards: `Number of loans`, `Current APY`, `Total volume`, `Total interest`
* `Vault Info` chart with metric selectors (`APY`, `Deployed`, `Utilization`, `TVL`) and time ranges (`1D`, `1W`, `1M`)
* `Supply Utilization` donut with used %, supplied amount, and vault limit
* `Allocation` table with source, allocation amount/share, APY context, and pagination. Collateral rows link to the vault's loans against that asset
* `Vault Metadata` form for name, manager name, description, cap, theme color, banner, icon, and manager image URLs, and `URL Access` tags

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/overview-01-summary-and-vault-info.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=7fa0e3ae72b9221a8f9dc3c301b31328)

*Overview tab with metric cards, vault info trend chart, and supply utilization.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/overview-02-allocation-table.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=c86195f6ed80d80f0075fb7242efb2d5)

*Allocation subsection showing source-level deployed balances, share percentages, APY, and pagination.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/overview-03-vault-metadata.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=55c0e68940e39d348ef3bcf536ea358d)

*Vault metadata editor with branding, links, tags, and save/reset controls.*

## Collateral

Purpose: define allowed collateral assets and core risk limits per asset.

Key elements:

* Warning: increasing LTV triggers a 24-hour timelock
* `+ Add collateral` action
* Search and filter controls
* Table fields per token:
  * `LTV`
  * `Liquidation LTV`
  * Delete action
* Add-collateral modal:
  * category and custom views
  * token/address search
  * multi-select with `Clear`, `All`, and `Confirm selection`
  * lists collateral with a Loopscale-verified market configuration, whether or not your wallet holds it
  * oracle choice when an asset has more than one verified oracle
  * assets with a pending add can't be selected again until the timelock executes or is cancelled in `Timelocks`

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/collateral-01-table.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=4b3b58781b2da0b7faa196e1219a3a9b)

*Collateral table with token list and editable `LTV` and `Liquidation LTV` values.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/collateral-02-edited-summary.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=dc1acdcb4e924332e1102aefe452a358)

*Collateral edits with per-row reset, summarized diff, and `Save changes` action.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/collateral-03-add-collateral-modal.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=616ba781bf39c4f091e09f7252a1a937)

*Add Collateral modal with category tabs, token search, multi-select, and confirm action.*

## Rates

Purpose: set APY by token and tenor.

Key elements:

* Search and filters
* Token table with tenor columns:
  * `1 day APY`
  * `1 week APY`
  * `1 month APY`
  * `3 months APY`
* Each tenor can be set to:
  * a numeric percent value
  * `Disabled`

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/rates-01-table.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=13a06254944009e1715449024dd2fc5a)

*Rates table with APY controls across 1 day, 1 week, 1 month, and 3 month tenors.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/rates-02-edited-summary.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=44961e8b8240087c164738a38ce904f2)

*Rates edits summarized before save, including transitions from `Disabled` to active APY values.*

## Allocation

Purpose: cap max allocation per token.

Key elements:

* Warning: increasing allocation triggers a 24-hour timelock
* Search and filters
* `Max Allocation %` per token
* Values can be numeric or `Disabled`, and can't exceed 100%
* Primary action: `Create Limits`

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/allocation-01-table.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=168946d1a682946d03059c8b079e1486)

*Allocation table with per-token maximum allocation controls.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/allocation-02-edited-summary.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=b4fde103f186af77f19d004b4e589242)

*Allocation updates with pending changes summary and `Create Limits` apply action.*

## Settings

Purpose: configure vault-level operating and fee behavior.

Key elements:

* `Disable vault deposits` / `Enable vault deposits`, which sends its own transaction and takes effect immediately
* `Status`: `Disable originations` / `Enable originations`
* `Fees`:
  * `Origination fee`
  * `Interest fee`
* `Fund Management`:
  * `Idle capital` routing (`MarginFi` or `None`)
  * `Liquidity buffer`
  * `Max origination size` with principal symbol suffix (e.g. USDC)
* `Pending Update` values under a field while a change is waiting on its timelock
* Primary action: `Save changes`
* Fee claim action (`No fee to claim` when unavailable)

> [!WARNING]
>
> The banner on this tab says changes take effect immediately. On a live vault, everything saved with `Save changes` goes through a 24-hour timelock. See [Timelock delays](#timelock-delays).

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/settings-01-default.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=2b49281812a440153e7800212ff76120)

*Settings tab in default state with status controls and fee/risk parameters.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/settings-02-edited-summary.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=1ef8d05bef2467b34390f6aa294db997)

*Settings tab with pending updates and a detailed summary of parameter changes.*

## Principal Caps

Purpose: control borrow/supply/withdraw throughput over 1-hour and 24-hour windows. Each window starts with the first action after the previous one expires.

Key elements:

* Scope toggle:
  * `Borrow`
  * `Supply`
  * `Withdraw`
* Cap inputs by scope:
  * `Borrow`: `Max 1hr borrow`, `Max 24hr borrow`, `Max borrow`
  * `Supply`: `Max 1hr supply`, `Max 24hr supply`, `Max TVL`
  * `Withdraw`: `Max 1hr withdrawals`, `Max 24hr withdrawals`
* `Disabled` is supported for unset caps
* Usage progress bars show utilized value and percentage for active caps
* Primary action: `Create Principal Caps`
* Lowering caps has no delay

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/principal-caps-01-borrow-view.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=0cad0bea89d06ace183633613c176268)

*Principal Caps in Borrow mode, including active cap utilization bars and disabled cap state.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/principal-caps-02-withdraw-view-edited.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=f2374280d1107109f349e5b8205bfc01)

*Principal Caps in Withdraw mode with new limits staged and summarized before apply.*

## Timelocks

Purpose: inspect and filter scheduled and historical manager actions.

Key elements:

* Status filters:
  * `Pending`
  * `Executed`
  * `Cancelled`
* Sort direction toggle
* `Include Instant` filter (not available on `Pending`)
* Entry cards include:
  * status badge
  * action type badge (e.g. `Update LTV`, `Add Collateral`)
  * shortened reference
  * relative and absolute timestamps
  * expand/collapse caret
  * cancel action on pending entries

Pending entries are executed automatically by Loopscale once their delay has passed.

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/timelocks-01-pending.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=f98884c8fbd265f2057daa43624be754)

*Timelocks filtered to `Pending`, showing scheduled updates and time remaining.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/timelocks-02-executed.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=a5d828b4a1c3fafbc4496b682366a99c)

*Timelocks filtered to `Executed`, listing completed manager actions with timestamps.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/timelocks-03-cancelled.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=9a48fabe272cad75a7e19a4f23290051)

*Timelocks filtered to `Cancelled`, showing aborted actions and history metadata.*

### Timelock delays

Delays apply once a vault is live. A vault with deposits disabled and no LP supply has no delay on any change.

| Change | Delay |
| - | - |
| Add collateral | 24 hours |
| Increase `LTV` or `Liquidation LTV` | 24 hours |
| Decrease `LTV` or `Liquidation LTV` | None |
| Remove collateral | None |
| Increase `Max Allocation %` | 24 hours |
| Decrease `Max Allocation %` | None |
| Update APYs on the `Rates` tab | None |
| `Save changes` on the `Settings` tab (originations, idle capital, liquidity buffer, fees, max origination size) | 24 hours |
| Lower max early unstake fee | None |
| Enable or disable vault deposits | None (not a timelock) |

## Rewards

Purpose: manage reward schedules and emissions for vault depositors.

Key elements:

* Search by token/address
* `+ Add rewards` action
* Rewards table columns:
  * `Rewards`
  * `Emitted`
  * `Claimed`
  * `Start`
  * `End`
  * row action (`Edit`)
* Add Rewards modal:
  * token search
  * selectable wallet token list with amount and USD estimate
* Edit Rewards modal:
  * reward token summary and wallet balance
  * editable schedule end time
  * computed change preview (undistributed rewards, end time, emissions/week)
  * warning/info banners for historical schedule edits

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/rewards-01-table.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=64a8572a9fd30f94d99ff25dfb63d964)

*Rewards tab with active/inactive schedules, emitted/claimed totals, and edit controls.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/rewards-02-add-rewards-modal.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=ee79197be8ee4b3a31e58fc16fa41f45)

*Add Rewards modal with token search and selectable wallet inventory.*

![](https://mintcdn.com/loopscale/CTUsD-Ag-qq-yBFR/static/assets/images/curator/rewards-03-edit-rewards-modal.png?fit=max\&auto=format\&n=CTUsD-Ag-qq-yBFR\&q=85\&s=a6612fd83811ba0c3f85db24be8736b0)

*Edit Rewards modal with end-time adjustment, projected schedule changes, and contextual warnings.*

## Operational Notes

* Higher-risk changes are surfaced through timelock flows.
* Unsaved edits are explicitly summarized before apply.
* Disabled states are represented in-table (for example `Disabled` caps or APY tenors).
* Pagination appears in large lists (collateral, rates, allocation, timelocks).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.