Skip to main content

Glossary

Accumulated rate​

The per-second interest-accrual factor on a branch, maintained by InterestEngine. Each branch keeps two: accumulatedRate for troves without Redemption Shield and accumulatedShieldRate for troves with it enabled. Each trove stores a normalized debt; actual current debt is normalized debt × its cohort's accumulated rate. See Interest model.

Aggregator​

The singleton contract that coordinates across branches: routes redemptions and enforces the redemption quota, runs cross-branch drips, enforces issuance quotas, tracks per-branch debt EMAs, sets delta-rate offsets, and handles branch shutdown checks and the bad-debt sink. See Architecture.

ActivePool​

The per-branch custody contract for collateral backing active troves. Each branch has two: one for troves without Redemption Shield (ActivePool) and one for troves with it enabled (ActiveShieldedPool).

Trove without Redemption Shield​

A trove not opted into the shield. Sits in the base sorted list and is exposed to redemption. Pays the branch rate minus a shield-share discount: zero when no troves on the branch have Redemption Shield enabled, and larger when the Redemption Shield share is high (the base rate can turn negative above an 85% share). See Redemption shield.

Baton​

The control-loop concept in RateParControl: at any moment, exactly one of rate or par is "active" (has the baton). Switching is gated by dwell timers: 24 hours with the rate at a bound and still pushing, or 7 days of sustained same-direction error, to enter PAR mode; 12 hours to exit. See Peg control.

Bootstrap period​

The 14-day window after deployment (BOOTSTRAP_PERIOD = 14 days). Redemption is disabled, the rate controller commits no step (rate and par stay at their biases), and each branch's debt is capped by its fixed bootstrap ceiling instead of the issuance quota. Repaying, depositing and liquidations work normally.

Bootstrap ceiling​

A branch's fixed RD debt cap during the bootstrap period (6.375M to 38.25M RD depending on the branch). See Collateral parameters.

Branch​

A per-collateral instance of the trove/pool stack: WETH branch, wstETH branch, rETH branch, etc. Each branch has its own pools, sorted lists, oracle, and risk parameters. There are 7 branches, fixed at deployment.

CCR​

Critical collateral ratio. When a branch's TCR drops below CCR, the branch enters recovery mode. Per-branch parameter, set to MCR + 40 percentage points (150% on WETH).

CompositePriceFeedBase​

The abstract base for derivative-asset price feeds (wstETH, rETH, weETH, WBTC, tBTC, PAXG). Combines a base price (ETH/USD or BTC/USD), a market leg and, for liquid staking tokens, a canonical exchange rate to produce the collateral's USD price, and tracks which source the price currently comes from. See Collateral oracles.

Debt-utilization EMA​

An exponential moving average of branch debt with 72-hour half-life, maintained per branch by the Aggregator alongside a global debt EMA. A branch's debt utilization is its debt EMA divided by the global debt EMA; it is the input to the controller that sets the branch's delta-rate offset.

Delta-rate offset​

A per-branch signed offset added to the singleton system rate to produce that branch's rate. Driven by the branch's debt-utilization error. See Interest model.

Drip​

Folding accrued interest into a branch's debt accumulators and routing the resulting fees. Per-branch via TroveManager.drip() or InterestEngine.drip() (every borrower operation drips its branch); cross-branch via Aggregator.drip(). Keepers are paid through KeeperRewards.updateWithReward(), which calls Aggregator.dripWithRewardCap(): the reward is 2% of the interest accrued since the last rewarded drip, scaled by a cubic ramp from 0 at 3 hours to full at 8 hours since that drip, and capped by the KeeperRewards RD balance.

Dwarf​

A trove whose actual debt is between the 200 RD gas reserve and the 2,000 RD minimum (after a partial redemption or under a negative base rate). It stays an ordinary trove: it can be liquidated and redeemed against, and any debt increase must bring its debt back to at least 2,000 RD. See Liquidation paths.

Early-repayment fee​

2% of the principal repaid within 6 hours of the trove's last debt increase (EARLY_REPAY_FEE_BPS, EARLY_REPAY_WINDOW), paid in RD and routed to GlobalFeeRouter. See Fees.

FeeRouter / GlobalFeeRouter​

Each branch's FeeRouter splits that branch's borrow interest between its Stability Pool and the singleton GlobalFeeRouter, using a PI controller on Stability Pool utilization. GlobalFeeRouter also receives the redemption protocol fee and early-repayment fees, refills keeper rewards, pays the LP share (PI-controlled by LP utilization) and sends the rest to MOAI stakers, diverting part of the staker share to bad-debt repayment while a branch is under-collateralized. See Fees.

FLX​

A separate token, not minted by the protocol. FLX stakers earn MOAI on a one-year linear stream from FLXStaking (2,000,000 MOAI in total). See FLX staking.

Gas compensation reserve​

The 200 RD per trove that the protocol holds in GasPool for the duration of the trove (RD_GAS_COMPENSATION = 200e18). Paid to the liquidator on liquidation. On close it is not refunded: it is burned against the trove's last 200 RD of debt, so the borrower repays only the net debt.

ICR​

Individual collateral ratio. For a single trove: collateral value in USD divided by debt valued at par. Must be at or above MCR to avoid liquidation.

Issuance quota​

A per-branch token bucket that limits how fast a branch's debt can grow after bootstrap. It refills at 50% of the branch's target debt per day and holds up to 24 hours of refill; repayments refund it. See Open a trove.

Liquidation penalty​

The cap on the collateral value seized on liquidation, as a multiple of the debt's value at par; collateral above the cap goes back to the borrower as surplus. Two variants:

  • LIQUIDATION_PENALTY, used in SP offset (105% on every branch).
  • LIQUIDATION_PENALTY_REDIST, used in redistribution (equal to the branch MCR, 110% to 130%).

Liquidity authority​

A scalar between 20% and 100% that RateParControl applies to the price error before it reaches the PI loops, based on RD market-pool liquidity. A thinner market moves the controller less. See Peg control.

Liquity v1​

The protocol RAI Dollar started as a fork of. See Comparison with Liquity.

LP share​

The ERC-20 token minted by an RD market pool's RdStableSwapHook when liquidity is added through the hook. LP shares are staked in that pool's LPStaking contract to earn MOAI and RD. See LP staking.

MarketOracleAggregator​

The singleton RD market oracle. It combines price and liquidity observations from the two Uniswap v4 RD market pools (RD/USDC and RD/USDT) into a 24-hour RD/USD TWAP and 24-hour and 4-hour liquidity TWALs, read only from windows ending at least 60 s in the past. Input to RateParControl and GlobalFeeRouter. See RD Market Oracle.

MCR​

Minimum collateral ratio. A trove with ICR below MCR is liquidatable. Per-branch parameter — 110% on WETH, ranging up to 130% on the WBTC, weETH and PAXG branches.

MinTrove​

Helper contract whose openTroveAtMCR opens a base trove at exactly ICR = MCR, for 1,800 to 10,000 RD of net debt (MIN_NET_DEBT to MAX_MCR_TROVE_NET_DEBT).

MIN_NET_DEBT​

1,800 RD. The minimum net (excluding gas comp) debt a trove can be opened with. With the 200 RD gas-comp reserve, the minimum total trove debt is 2,000 RD.

Mini-dwarf​

A trove whose actual debt is at or below the 200 RD gas reserve, so it has no redeemable debt left. Mini-dwarfs are skipped by redemption walks; anyone can close one with TroveManager.sweepCloseTrove or TroveManager.sweepMiniDwarves, which returns all of its collateral to the borrower. See Liquidation paths.

MOAI​

The protocol's value-capture token, with a fixed supply of 100,000,000 minted by MOAIToken at deployment. Emitted to Stability Pool depositors and LP stakers, and streamed to FLX stakers. MOAI stakers in MOAIStaking earn RD from protocol fees. See MOAI staking and MOAI emissions schedule.

NICR​

Nominal individual collateral ratio: collateral ÷ normalized debt (scaled by 1e20). It uses neither price, par nor the interest accumulator, so troves in one sorted list keep their order as those move. The sorted-trove lists are ordered by NICR, which makes inserts and removals cheap given correct hints.

Par​

The protocol's internal price for RD, used to value RD debt in collateral ratios, redemption and liquidation. Normally exactly $1.00. Under sustained stress the controller can adjust par within $0.75–$1.30 (max delta $0.001/hour) to make arbitrage more attractive and drive market RD back to $1. RD's target is always $1; par is a stress-response lever, not a target. See How RD stays near $1 and Peg control.

PriceFeed​

The per-branch collateral USD price feed. ETH/USD and BTC/USD come from a Chronicle primary with a Chainlink fallback; derivative feeds add Chainlink market legs and canonical-rate checks. On oracle failure the feed falls back to its last good price and shuts the branch down. See Collateral oracles.

RateParControl​

The singleton split-range PI controller that produces the system rate and par. Two baton modes (RATE / PAR) with dwell-gated switching. See Peg control.

RD_GAS_COMPENSATION​

200 RD. The fixed amount the protocol reserves per trove for the eventual liquidator.

RD​

The protocol's stablecoin. ERC-20, 18 decimals. Minted only by authorized protocol contracts against collateralized trove debt; new debt must satisfy an MCR of 110% to 130%, depending on the branch, although later market moves can make existing debt undercollateralized.

RD market pools​

The two Uniswap v4 pools, RD/USDC and RD/USDT, each run by an RdStableSwapHook that prices swaps on a StableSwap curve and records price and liquidity observations for MarketOracleAggregator. See RD Market Oracle.

Recovery mode​

The state of a branch when its TCR falls below CCR. Liquidation is unchanged (the threshold is always ICR < MCR); borrow operations tighten instead — no adjustment may reduce a trove's ICR, and new debt or new opens must end at ICR ≥ CCR. Self-clearing, ends when TCR rises above CCR. See Liquidations & Recovery Mode.

Redemption​

The mechanism by which any RD holder can exchange RD for collateral at par minus a fee. Multi-branch, weighted by branch base debt EMAs. See Redemption.

Redemption fee​

The collateral-denominated fee on redemption, retained by the redeemed trove. Per-branch parameter, 0.75% on every mainnet branch; the contract bounds it to [MIN_REDEMPTION_FEE = 0.5%, MAX_REDEMPTION_FEE = 2.5%]. Separate from the redemption protocol fee.

Redemption protocol fee​

0.25% of the RD redeemed, paid in RD on top of every normal redemption and routed to GlobalFeeRouter. Not charged on shutdown redemptions. See Fees.

Redemption quota​

The token-bucket quota the Aggregator maintains on system-wide redemption. Refills at 4% per day of system debt (the lower of current global debt and the global debt EMA), holding up to 6 hours of refill; it starts empty when bootstrap ends. Read via Aggregator.redemptionQuotaAvailable(). See Redemption mechanism.

SCR​

Shutdown collateral ratio. When a branch's TCR falls below SCR, the branch becomes shutdownable via BorrowerOperations.shutdown(). Per-branch parameter set to MCR − 0.5pp, so SCR < MCR (e.g. 109.5% on WETH).

Shield / trove with Redemption Shield enabled​

An opt-in flag on a trove that moves it into the branch's separate Redemption Shield cohort book. Troves with Redemption Shield enabled are never redeemed against in normal operation. The only path that touches them is a full branch shutdown. In exchange, troves with Redemption Shield enabled pay a higher borrow rate. The setting can be changed at most once per 24 hours. See Redemption shield.

Shutdown discount​

The price multiplier applied to redemptions on a shutdown branch. Starts at a 1% premium (BASE_DISCOUNT, multiplier 1.01) and ramps in the redeemer's favor:

  • TCR below SCR or collateral failure: to a 1% discount in the first hour, then to a 5% discount by the end of the first day, then held.
  • Oracle failure: identical first-day ramp, then deepening to ~100% over 14 days.

SortedTroves​

The doubly-linked list of troves on a branch, ordered by NICR. Two per branch: one for base troves and one for troves with Redemption Shield enabled.

Stability Pool​

The per-branch pool of RD that absorbs undercollateralized debt on liquidation. Depositors receive a pro-rata slice of liquidated collateral, a share of the branch's borrow interest, and MOAI emissions. See Stability Pool.

System rate​

The per-second rate output of RateParControl. Same number across all branches. Each branch's rate is system_rate + delta_rate_offset, clamped to 0.1%–70% APY; troves with and without Redemption Shield then pay that rate plus or minus the shield adjustment.

TCR​

Total collateral ratio for a branch: aggregated collateral value / aggregated debt across all troves on that branch. Drives recovery mode and shutdown triggers.

TWAL​

Time-weighted average liquidity, as measured by MarketOracleAggregator (24-hour and 4-hour harmonic averages). Used to qualify pools for the price, to scale the controller's liquidity authority, and to measure LP utilization for GlobalFeeRouter.

TWAP​

Time-weighted average price. MarketOracleAggregator takes the mean of the qualifying RD market pools' 24-hour RD/USD TWAPs, reading only windows that end at least 60 s in the past.

base debt EMA​

A 72-hour-half-life EMA of base trove debt (troves without Redemption Shield) per branch. Used as the weight for that branch in the multi-branch redemption basket on Aggregator.redeemCollateral.