Definitions
- S = Stable tranche capital (
seniorVaultInvestments) - J = Alpha tranche capital (
juniorVaultInvestments) - V = S + J (total vault capital)
- P = the vault’s profit or loss over a settlement interval
- r = the Stable target rate, set on-chain as a per-block rate (
seniorRatePerBlock) and compounded over the elapsed blocks of the interval. Any APY figure shown in the app is derived from this per-block rate and Berachain block times.
When the waterfall runs: continuous settlement
The waterfall is not settled weekly or per epoch. It is marked continuously, on every vault interaction: every deposit, every withdrawal, and every keeper-triggered update runs the settlement, applying the waterfall to the change in strategy balance since the previous settlement. Two practical consequences:- Withdrawals are always settled to the moment of exit. A withdrawal first runs settlement, then redeems at the resulting share price, you can never exit against a stale NAV.
- A “week” of performance is actually many small settlement intervals, and as the next section explains, that matters.
The yield waterfall (profitable interval)
When an interval is profitable, distribution follows strict priority:- Stable is paid first, up to its accrued target for the interval:
Stable receives min(P, S × r) - Alpha receives the entire residual:
Alpha receives max(0, P − S × r), subject to Alpha’s performance fee (below)
The Stable target is a cap, not a guarantee
This is the single most important thing for Stable depositors to understand.- Stable only accrues yield out of profit. The target claim is added only when an interval is profitable. In a flat or losing interval, Stable earns zero, time alone does not accrue yield; profit does.
- Shortfalls are forfeited, not carried forward. If a weak interval’s profit doesn’t cover Stable’s full target, Stable receives all of that profit and the clock resets. The missed amount is never owed later, there is no deficit accumulator in the contract.
- Consequence: Stable’s realized yield can drift below the nominal target rate across weak, flat, or losing stretches. The target defines Stable’s first-priority maximum per interval, not a promised return.
The loss waterfall (losing interval)
Losses flow in reverse priority:- Alpha absorbs all losses first, up to its entire capital: Alpha bears
min(L, J) - Stable is only touched once Alpha is exhausted: Stable bears
max(0, L − J)