WhitePaperModel

WhitePaperInterestRateModel

The parameterized model described in section 2.4 of the original Venus Protocol whitepaper

Legacy BNB Core model reference. Some unlisted markets still retain supply or debt, so the ABI remains operationally relevant. Resolve the market's exact model and blocksPerYear at the historical block; do not use this page to infer that a market is active or deprecated.

Solidity API

blocksPerYear

Approximate blocks per year used to convert annual constructor parameters to per-block rates.

uint256 blocksPerYear

---

constructor

Construct an interest rate model

constructor(uint256 baseRatePerYear, uint256 multiplierPerYear, uint256 blocksPerYear_) public

Parameters

Name	Type	Description
baseRatePerYear	uint256	The approximate target base APR, as a mantissa (scaled by 1e18)
multiplierPerYear	uint256	The rate of increase in interest rate wrt utilization (scaled by 1e18)
blocksPerYear_	uint256	The approximate number of blocks per year assumed by this model

---

utilizationRate

Calculates the utilization rate of the market: borrows / (cash + borrows - reserves)

function utilizationRate(uint256 cash, uint256 borrows, uint256 reserves) public pure returns (uint256)

Parameters

Name	Type	Description
cash	uint256	The amount of cash in the market
borrows	uint256	The amount of borrows in the market
reserves	uint256	The amount of reserves in the market (currently unused)

Return Values

Name	Type	Description
[0]	uint256	The utilization rate as a mantissa between [0, 1e18]

---

getBorrowRate

Calculates the current borrow rate per block, with the error code expected by the market

function getBorrowRate(uint256 cash, uint256 borrows, uint256 reserves) public view returns (uint256)

Parameters

Name	Type	Description
cash	uint256	The amount of cash in the market
borrows	uint256	The amount of borrows in the market
reserves	uint256	The amount of reserves in the market

Return Values

Name	Type	Description
[0]	uint256	The borrow rate percentage per block as a mantissa (scaled by 1e18)

---

getSupplyRate

Calculates the current supply rate per block

function getSupplyRate(uint256 cash, uint256 borrows, uint256 reserves, uint256 reserveFactorMantissa) public view returns (uint256)

Parameters

Name	Type	Description
cash	uint256	The amount of cash in the market
borrows	uint256	The amount of borrows in the market
reserves	uint256	The amount of reserves in the market
reserveFactorMantissa	uint256	The current reserve factor for the market

Return Values

Name	Type	Description
[0]	uint256	The supply rate percentage per block as a mantissa (scaled by 1e18)

---