Adjusting, repaying, and closing a trove
Once open, you can change your trove freely as long as the result stays above MCR (and respects recovery-mode rules, if active). All ops are on the same branch you opened on.
Adjusting your trove
You can add or withdraw collateral, borrow more or repay, and toggle shield — separately or combined in a single transaction — as long as the result stays above MCR. A combined adjustment handles collateral and debt together (one direction each: add or withdraw, borrow or repay); there are also one-action shortcuts for each common case: top up, withdraw, borrow more, repay, enable/disable shield, close, and claim surplus collateral left over after a liquidation, a full redemption, or a mini-dwarf sweep.
Developer reference: Borrowing operations for the exact adjust call, the convenience wrappers, and the shield-toggle cooldown.
Adjustment checks
Every adjustment ends with the same checks:
- In normal mode your trove must end at or above MCR. This applies to top-ups, repayments and shield toggles too: a trove that has fallen below MCR can't be improved a little at a time, it must be brought back to MCR in one transaction (or closed). In recovery mode, adding collateral and repaying are always allowed.
- Repays can't shrink the trove below the 2,000 RD minimum (1,800 net + the 200 RD reserve) without closing it entirely. Collateral withdrawals and borrows must also leave total debt at or above 2,000 RD.
- In normal mode you can't push branch TCR below CCR; in recovery mode you can't lower your own ICR (see below).
- A borrow must fit the branch's current borrow allowance (see the issuance quota), and a collateral top-up must fit the branch's collateral cap.
- Any change except a pure repayment needs a working price oracle.
If any of these fail, the transaction reverts and nothing changes.
A partial redemption can leave a trove below the 2,000 RD minimum. Such a trove stays open and keeps accruing interest. You can still add collateral, toggle shield, or close it, and a borrow is allowed if it brings total debt back to at least 2,000 RD; a collateral withdrawal is not allowed until it does. A plain repayment is not possible either, because it would leave net debt below 1,800 RD. A trove whose debt has fallen to 200 RD or less is skipped by redemptions and can be closed by anyone through TroveManager.sweepMiniDwarves: its collateral is credited to you as claimable surplus.
Closing your trove
Closing burns RD from your wallet equal to your debt minus the 200 RD gas reserve (that is, your net debt plus accrued interest), burns the 200 RD reserve from the gas pool to cover the rest, returns all of your collateral, and removes the trove from the branch. The reserve is not paid back to you; it pays off the last 200 RD of your debt.
You need to hold enough RD to cover that amount (plus any early-repayment fee) before closing; otherwise the close reverts. Repaying part of the debt first doesn't help, since the close still needs the full remainder. Buy or borrow the missing RD elsewhere first.
The app shows Keep available to close: its estimate of the repayment, allowing for five more minutes of interest when interest is accruing. This is a wallet-balance buffer, not an extra charge; closing takes only the amount actually due on-chain. The app simulates the close before asking you to sign and refreshes the estimate if that simulation fails. If the transaction is delayed beyond the buffer or your debt or balance changes, the close may still fail; review the refreshed amount and try again.
Early-repayment fee
If you repay or close within 6 hours of your trove's last debt increase (opening counts as one), you pay an extra 2% of the principal repaid (EARLY_REPAY_FEE_BPS = 200, EARLY_REPAY_WINDOW = 6 hours), in RD, on top of the repayment. The fee is rounded up and goes to the protocol fee routers (see Fees). After the 6-hour window there is no fee. BorrowerOperations.getEarlyRepayFee(borrower, amount) quotes it. The fee also applies after the branch has shut down.
While the fee applies, the app shows when the early-repay fee window ends in Your Position and includes the fee in the repayment or close amount. Max Repay is limited by both your wallet balance and the minimum debt the trove must retain; use Close trove to repay the rest and release all collateral.
Recovery-mode adjustments
When branch TCR is below CCR, the extra rule is about your trove's own ICR, not the branch TCR:
- You can repay debt or add collateral freely — both raise your ICR.
- You can still withdraw collateral or borrow more, but only if the result doesn't decrease your ICR: pair a withdrawal with a repayment, or a new borrow with a collateral top-up. A new borrow must also leave your ICR at or above CCR.
- Toggling shield is unaffected — it doesn't change your ICR (the usual shield-toggle cooldown still applies).
- Closing the trove is allowed; you just need to hold enough RD to repay the debt.
The exact rules live in Liquidations & Recovery Mode — the on-chain check is _requireNewICRisAboveOldICR ("Cannot reduce ICR in RM").
After a branch shutdown
On a shut-down branch only two borrower actions remain: a pure repayment and closing the trove (plus claiming any surplus collateral). Adding or withdrawing collateral, borrowing, and toggling shield all revert. See Collateral shutdown.
Practical notes
- Hints: collateral-ratio hints are advisory — a wrong hint burns gas but is otherwise safe. Front ends compute them for you (see the developer reference).
- Redemption Shield and base bookkeeping: toggling shield moves your collateral between the branch's two pools atomically. You don't see this; your trove is conceptually one position.
- Accrued interest: when you adjust, accrued interest is folded into your debt. Borrowing more or repaying part doesn't reset the clock; interest keeps accruing on the full outstanding debt.
When to act
| If you see… | Consider… |
|---|---|
| Your ICR is close to MCR | Top up collateral, or repay debt. |
| Branch TCR near CCR | Recovery mode is one bad print away. Don't add risk; consider repaying. |
| Your trove without Redemption Shield has one of the lowest ICRs on its branch and RD is below par | You'll likely be partially redeemed against. Shield, top up, or accept it. |
| Effective borrow rate climbing past your comfort zone | Repay some debt, or close and reopen later. |
| Shield premium near its cap | Branch is overcrowded with Redemption Shield; consider disabling Redemption Shield if you can tolerate it. |
Next
- Redemption shield: whether to toggle.
- Borrow rates: what you're paying.