docs: added extra comments to clarify the settlement process on referendum

Author: geolffreym

contracts/custody/CustodianReferendum.sol

@@ -170,6 +170,11 @@ contract CustodianReferendum is
         //
         // The collected fees are used to support the protocol's operations, aligning
         // individual actions with the broader sustainability of the network.
+
+        // IMPORTANT:
+        // The expected fees are locked in the agreement, based on the custodians fees defined by the tollgate.
+        // If the fee amount is insufficient, the transaction will revert during agreement creation.
+        // Only valid agreements can be settled; the validity is guaranteed by the proof.
         T.Agreement memory agreement = AGREEMENT_SETTLER.settleAgreement(proof, msg.sender);
         if (agreement.parties[0] != custodian) {
             revert CustodianAgreementMismatch(custodian);

contracts/financial/AgreementManager.sol

@@ -184,7 +184,7 @@ contract AgreementManager is Initializable, UUPSUpgradeable, AccessControlledUpg
     /// @param currency The address of the currency for which the fee is being calculated.
     /// @return The calculated fee amount based on the applicable fee scheme.
     function _calcFees(uint256 total, address target, address currency) private view returns (uint256) {
-        // !IMPORTANT if fees manager does not support the currency, will revert..
+        // !IMPORTANT if fees manager does not support the currency or the target, will revert..
         (uint256 fees, T.Scheme scheme) = TOLLGATE.getFees(target, currency);
         if (scheme == T.Scheme.BPS) return total.perOf(fees); // bps calc
         if (scheme == T.Scheme.NOMINAL) return total.perOf(fees.calcBps()); // nominal to bps

test/rights/RightAssetCustodian.t.sol

@@ -87,7 +87,7 @@ contract RightAssetCustodianTest is CustodianShared {
         IRightsAssetCustodianRegistrable(rightAssetCustodian).grantCustody(custodian);
         IRightsAssetCustodianRegistrable(rightAssetCustodian).grantCustody(custodian2);
         IRightsAssetCustodianRegistrable(rightAssetCustodian).grantCustody(custodian3);
-        // 3 is reached, he validation is effective after this line
+        // 3 is reached, the validation is effective after this line
 
         // second expected failing attempt
         vm.expectRevert(abi.encodeWithSignature("MaxRedundancyAllowedReached()"));