Add doc-comments to ITrustedTransfarableERC20
@@ -75,10 +75,12 @@ interface IERC20 {
event Approval(address indexed owner, address indexed spender, uint256 value);
}
-/**
- * @dev Interface of the ERC20 standard as defined in the EIP. Differs from `IERC20`
- * in that it only implements `transfer` and `transferFrom` with the expected return boolean.
- */
+/// @dev Interface of the ERC20 standard as defined in the EIP.
+/// 1. Implements only `transfer` and `transferFrom` methods
+/// 2. These methods return a boolean which indicates success of the transaction
+/// Note: It is assumed that the interface applies to those `ERC20` tokens whose code exactly matches the standard.
+/// Note: Used to perform transfers for tokens that explicitly return a boolean value
+/// (if the token returns any other data or does not return at all, then the function call will reverted)
interface ITrustedTransfarableERC20 {
/**
* @dev Moves `amount` tokens from the caller's account to `recipient`.
