Skip to main content

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 a post-redemption surplus.

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:

  1. Your trove must stay above MCR.
  2. Repays can't shrink the trove below the 2,000 RD minimum (1,800 net + the 200 RD reserve) without closing it entirely.
  3. In normal mode you can't push branch TCR into recovery; in recovery mode you can only adjust in ways that don't worsen TCR.

If any of these fail, the transaction reverts and nothing changes.

Closing your trove​

Closing burns RD from your wallet equal to your full debt (net debt + accrued interest), returns all of your collateral, refunds the 200 RD gas reserve, and removes the trove from the branch.

You need to hold enough RD to cover the full debt before closing. If you don't, repay partially first or buy RD from a DEX — the protocol won't let you close while you still owe net debt.

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 full debt.
Normal modeRecovery mode(TCR < CCR)Add collateral✓✓Repay debt✓✓Close trove✓✓Toggle shield✓✓Withdraw collateral≥ MCRICR can't dropBorrow more≥ MCRICR can't drop
Every adjustment must leave your trove above MCR. Recovery mode (branch TCR below CCR) adds one rule — about your own ICR, not the branch TCR: 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 borrow with a collateral top-up; a new borrow must also leave ICR ≥ CCR). Adding collateral, repaying, closing, and toggling shield never lower your ICR, so they stay available. A solid ✓ is always available; a half-filled ◐ is conditional on the note shown (in normal mode the same actions just need to stay ≥ MCR without pushing branch TCR into recovery).

The exact rules live in Liquidations & Recovery Mode — the on-chain check is _requireNewICRisAboveOldICR ("Cannot reduce ICR in RM").

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 MCRTop up collateral, or repay debt.
Branch TCR near CCRRecovery 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 parYou'll likely be partially redeemed against. Shield, top up, or accept it.
Effective borrow rate climbing past your comfort zoneRepay some debt, or close and reopen later.
Shield premium near its capBranch is overcrowded with Redemption Shield; consider disabling Redemption Shield if you can tolerate it.

Next​