Merge remote-tracking branch 'origin/docs/natspec-in-interface' into …

…fix/bound-rate

src/fixed-rate-irm/FixedRateIrm.sol

@@ -24,28 +24,19 @@ string constant RATE_TOO_HIGH = "rate too high";
 contract FixedRateIrm is IFixedRateIrm {
     using MarketParamsLib for MarketParams;
 
-    /* EVENTS */
-
-    /// @notice Emitted when a borrow rate is set.
-    event SetBorrowRate(Id indexed id, uint256 newBorrowRate);
-
     /* CONSTANTS */
 
-    /// @notice Max settable borrow rate (800%).
+    /// @inheritdoc IFixedRateIrm
     uint256 public constant MAX_BORROW_RATE = 8.0 ether / uint256(365 days);
 
     /* STORAGE */
 
-    /// @notice Borrow rates.
+    /// @inheritdoc IFixedRateIrm
     mapping(Id => uint256) public borrowRateStored;
 
     /* SETTER */
 
-    /// @notice Sets the borrow rate for a market.
-    /// @dev A rate can be set by anybody, but only once.
-    /// @dev `borrowRate` reverts on rate not set, so the rate needs to be set before the market creation.
-    /// @dev As interest are rounded down in Morpho, for markets with a low total borrow, setting a rate too low could
-    /// prevent interest from accruing if interactions are frequent.
+    /// @inheritdoc IFixedRateIrm
     function setBorrowRate(Id id, uint256 newBorrowRate) external {
         require(borrowRateStored[id] == 0, RATE_SET);
         require(newBorrowRate != 0, RATE_ZERO);

src/fixed-rate-irm/interfaces/IFixedRateIrm.sol

@@ -8,6 +8,23 @@ import {Id} from "../../../lib/morpho-blue/src/interfaces/IMorpho.sol";
 /// @author Morpho Labs
 /// @custom:contact security@morpho.org
 interface IFixedRateIrm is IIrm {
+    /* EVENTS */
+
+    /// @notice Emitted when a borrow rate is set.
+    event SetBorrowRate(Id indexed id, uint256 newBorrowRate);
+
+    /* EXTERNAL */
+
+    /// @notice Max settable borrow rate (800%).
+    function MAX_BORROW_RATE() external returns (uint256);
+
+    /// @notice Borrow rates.
     function borrowRateStored(Id id) external returns (uint256);
+
+    /// @notice Sets the borrow rate for a market.
+    /// @dev A rate can be set by anybody, but only once.
+    /// @dev `borrowRate` reverts on rate not set, so the rate needs to be set before the market creation.
+    /// @dev As interest are rounded down in Morpho, for markets with a low total borrow, setting a rate too low could
+    /// prevent interest from accruing if interactions are frequent.
     function setBorrowRate(Id id, uint256 newBorrowRate) external;
 }