docs: polishing and audit

README.md

@@ -41,6 +41,7 @@ $$\text{minimum weight} \leq \text{weight} \leq \text{fee splitter cap}$$
 
 - Upper bounded by whatever percentage cap the fee splitter has. (Controlled by the DAO)
 - Lower bounded by the `minimum_weight` parameter in the rewards handler. (Controlled by any `RATE_MANAGER` appointed by the DAO, or the DAO itself)
+- The weight can be adjusted using a `scaling_factor` if necessary. (Controlled by any `RATE_MANAGER` appointed by the DAO, or the DAO itself)
 
 
 Furthermore, it can be adjusted at any time by any `RATE_MANAGER` by calling the `set_distribution_time` function in the rewards' handler to prevent manipulation (i.e. MEV on the snapshots).

contracts/StablecoinLens.vy

@@ -37,10 +37,8 @@ def _circulating_supply() -> uint256:
     @dev This function sacrifices some gas to fetch peg keepers from a unique source
     of truth to avoid having to manually maintain multiple lists across several
     contracts. For this reason we read the list of peg keepers contained in the
-    monetary policy returned by a controller in the factory. factory -> weth
-    controller -> monetary policy -> peg keepers This function is not exposed as
-    external as it can be easily manipulated and should not be used by third party
-    contracts.
+    monetary policy returned by a controller in the factory.
+    factory -> weth controller -> monetary policy -> peg keepers
     """
 
     circulating_supply: uint256 = 0