// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
import "../utils/Context.sol";
import "../utils/Strings.sol";
import "../utils/introspection/ERC165.sol";
/**
* @dev Contract module that allows children to implement role-based access
* control mechanisms. This is a lightweight version that doesn't allow enumerating role
* members except through off-chain means by accessing the contract event logs. Some
* applications may benefit from on-chain enumerability, for those cases see
* {AccessControlEnumerable}.
*
* Roles are referred to by their `bytes32` identifier. These should be exposed
* in the external API and be unique. The best way to achieve this is by
* using `public constant` hash digests:
*
* ```
* bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
* ```
*
* Roles can be used to represent a set of permissions. To restrict access to a
* function call, use {hasRole}:
*
* ```
* function foo() public {
* require(hasRole(MY_ROLE, msg.sender));
* ...
* }
* ```
*
* Roles can be granted and revoked dynamically via the {grantRole} and
* {revokeRole} functions. Each role has an associated admin role, and only
* accounts that have a role's admin role can call {grantRole} and {revokeRole}.
*
* By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
* that only accounts with this role will be able to grant or revoke other
* roles. More complex role relationships can be created by using
* {_setRoleAdmin}.
*
* WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
* grant and revoke this role. Extra precautions should be taken to secure
* accounts that have been granted it.
*/
abstract contract AccessControl is Context, IAccessControl, ERC165 {
struct RoleData {
mapping(address => bool) members;
bytes32 adminRole;
}
mapping(bytes32 => RoleData) private _roles;
bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
/**
* @dev Modifier that checks that an account has a specific role. Reverts
* with a standardized message including the required role.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*
* _Available since v4.1._
*/
modifier onlyRole(bytes32 role) {
_checkRole(role, _msgSender());
_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) public view override returns (bool) {
return _roles[role].members[account];
}
/**
* @dev Revert with a standard message if `account` is missing `role`.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*/
function _checkRole(bytes32 role, address account) internal view {
if (!hasRole(role, account)) {
revert(
string(
abi.encodePacked(
"AccessControl: account ",
Strings.toHexString(uint160(account), 20),
" is missing role ",
Strings.toHexString(uint256(role), 32)
)
)
);
}
}
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) public view override returns (bytes32) {
return _roles[role].adminRole;
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_grantRole(role, account);
}
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_revokeRole(role, account);
}
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) public virtual override {
require(account == _msgSender(), "AccessControl: can only renounce roles for self");
_revokeRole(role, account);
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event. Note that unlike {grantRole}, this function doesn't perform any
* checks on the calling account.
*
* [WARNING]
* ====
* This function should only be called from the constructor when setting
* up the initial roles for the system.
*
* Using this function in any other way is effectively circumventing the admin
* system imposed by {AccessControl}.
* ====
*/
function _setupRole(bytes32 role, address account) internal virtual {
_grantRole(role, account);
}
/**
* @dev Sets `adminRole` as ``role``'s admin role.
*
* Emits a {RoleAdminChanged} event.
*/
function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
bytes32 previousAdminRole = getRoleAdmin(role);
_roles[role].adminRole = adminRole;
emit RoleAdminChanged(role, previousAdminRole, adminRole);
}
function _grantRole(bytes32 role, address account) private {
if (!hasRole(role, account)) {
_roles[role].members[account] = true;
emit RoleGranted(role, account, _msgSender());
}
}
function _revokeRole(bytes32 role, address account) private {
if (hasRole(role, account)) {
_roles[role].members[account] = false;
emit RoleRevoked(role, account, _msgSender());
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./IAccessControlEnumerable.sol";
import "./AccessControl.sol";
import "../utils/structs/EnumerableSet.sol";
/**
* @dev Extension of {AccessControl} that allows enumerating the members of each role.
*/
abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
using EnumerableSet for EnumerableSet.AddressSet;
mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers;
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) public view override returns (address) {
return _roleMembers[role].at(index);
}
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) public view override returns (uint256) {
return _roleMembers[role].length();
}
/**
* @dev Overload {grantRole} to track enumerable memberships
*/
function grantRole(bytes32 role, address account) public virtual override(AccessControl, IAccessControl) {
super.grantRole(role, account);
_roleMembers[role].add(account);
}
/**
* @dev Overload {revokeRole} to track enumerable memberships
*/
function revokeRole(bytes32 role, address account) public virtual override(AccessControl, IAccessControl) {
super.revokeRole(role, account);
_roleMembers[role].remove(account);
}
/**
* @dev Overload {renounceRole} to track enumerable memberships
*/
function renounceRole(bytes32 role, address account) public virtual override(AccessControl, IAccessControl) {
super.renounceRole(role, account);
_roleMembers[role].remove(account);
}
/**
* @dev Overload {_setupRole} to track enumerable memberships
*/
function _setupRole(bytes32 role, address account) internal virtual override {
super._setupRole(role, account);
_roleMembers[role].add(account);
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize, which returns 0 for contracts in
// construction, since the code is only stored at the end of the
// constructor execution.
uint256 size;
assembly {
size := extcodesize(account)
}
return size > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCall(target, data, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value
) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
require(isContract(target), "Address: call to non-contract");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
require(isContract(target), "Address: static call to non-contract");
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
require(isContract(target), "Address: delegate call to non-contract");
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
import "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "../interfaces/ISignatureVerifier.sol";
import "../interfaces/IVaultFactory.sol";
import {
IV_NoAmount,
IV_InvalidWildcard,
IV_ItemMissingAddress,
IV_InvalidCollateralType,
IV_NoPredicates,
IV_InvalidCollateralId
} from "../errors/Lending.sol";
/**
* @title ArcadeItemsVerifier
* @author Non-Fungible Technologies, Inc.
*
* This contract can be used for verifying complex signature-encoded
* bundle descriptions. This resolves on a new array of SignatureItems[],
* which outside of verification, is passed around as bytes memory.
*
* Each SignatureItem has the following fields:
* - cType (collateral Type)
* - asset (contract address of the asset)
* - tokenId (token ID of the asset, if applicable)
* - amount (amount of the asset, if applicable - if ERC721, set to "1")
* - anyIdAllowed (whether a wildcard is supported - see below)
*
* - For token ids part of ERC721, other features beyond direct tokenIds are supported:
* - If anyIdAllowed is true, then any token ID can be passed - the field will be ignored.
* - If anyIdAllowed is true, then the "amount" field can be read to require
* a specific amount of assets from the collection.
* - Wildcard token ids are not supported for ERC1155 or ERC20.
* - All amounts are taken as minimums. For instance, if the "amount" field of an ERC1155 is 5,
* then a bundle with 8 of those ERC1155s are accepted.
* - For an ERC20 cType, tokenId is ignored. For an ERC721 cType, amount is ignored unless wildcard (see above).
If a wildcard is used, 0 amount is invalid, and all nonzero amounts are ignored.
*
* - Any deviation from the above rules represents an unparseable signature and will always
* return invalid.
*
* - All multi-item signatures assume AND - any optional expressed by OR
* can be implemented by simply signing multiple separate signatures.
*/
contract ArcadeItemsVerifier is ISignatureVerifier {
/// @dev Enum describing the collateral type of a signature item
enum CollateralType {
ERC_721,
ERC_1155,
ERC_20
}
/// @dev Enum describing each item that should be validated
struct SignatureItem {
// The type of collateral - which interface does it implement
CollateralType cType;
// The address of the collateral contract
address asset;
// The token ID of the collateral (only applicable to 721 and 1155).
uint256 tokenId;
// The minimum amount of collateral. For ERC721 assets, pass 1 or the
// amount of assets needed to be held for a wildcard predicate. If the
// tokenId is specified, the amount is assumed to be 1.
uint256 amount;
// Whether any token ID should be allowed. Only applies to ERC721.
// Supersedes tokenId.
bool anyIdAllowed;
}
// ==================================== COLLATERAL VERIFICATION =====================================
/**
* @notice Verify that the items specified by the packed SignatureItem array are held by the vault.
* @dev Reverts on a malformed SignatureItem, returns false on missing contents.
*
* Verification for empty predicates array has been addressed in initializeLoanWithItems and
* rolloverLoanWithItems.
*
* @param collateralAddress The address of the loan's collateral.
* @param collateralId The tokenId of the loan's collateral.
* @param predicates The calldata needed for the verifier.
*
* @return verified Whether the bundle contains the specified items.
*/
// solhint-disable-next-line code-complexity
function verifyPredicates(
address, address,
address collateralAddress,
uint256 collateralId,
bytes calldata predicates
) external view override returns (bool) {
address vault = IVaultFactory(collateralAddress).instanceAt(collateralId);
// Make sure vault address, converted back into uint256, matches the original
// collateralId. An arbitrary collateralId could theoretically collide with the
// another vault's address, meaning the wrong vault would be checked.
if (collateralId != uint256(uint160(vault))) revert IV_InvalidCollateralId(collateralId);
// Unpack items
SignatureItem[] memory items = abi.decode(predicates, (SignatureItem[]));
if (items.length == 0) revert IV_NoPredicates();
for (uint256 i = 0; i < items.length;) {
SignatureItem memory item = items[i];
// No asset provided
if (item.asset == address(0)) revert IV_ItemMissingAddress();
// No amount provided
if (item.amount == 0) revert IV_NoAmount(item.asset, item.amount);
if (item.cType == CollateralType.ERC_721) {
IERC721 asset = IERC721(item.asset);
// Wildcard, but vault has no assets or not enough specified
if (item.anyIdAllowed && asset.balanceOf(vault) < item.amount) return false;
// Does not own specifically specified asset
if (!item.anyIdAllowed && asset.ownerOf(item.tokenId) != vault) return false;
} else if (item.cType == CollateralType.ERC_1155) {
IERC1155 asset = IERC1155(item.asset);
// Wildcard not allowed, since we can't check overall 1155 balances
if (item.anyIdAllowed) revert IV_InvalidWildcard(item.asset);
// Does not own specifically specified asset
if (asset.balanceOf(vault, item.tokenId) < item.amount) return false;
} else {
IERC20 asset = IERC20(item.asset);
// Wildcard not allowed, since nonsensical
if (item.anyIdAllowed) revert IV_InvalidWildcard(item.asset);
// Does not own specifically specified asset
if (asset.balanceOf(vault) < item.amount) return false;
}
// Predicates is calldata, overflow is impossible bc of calldata
// size limits vis-a-vis gas
unchecked {
i++;
}
}
// Loop completed - all items found
return true;
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
*
* These functions can be used to verify that a message was signed by the holder
* of the private keys of a given address.
*/
library ECDSA {
enum RecoverError {
NoError,
InvalidSignature,
InvalidSignatureLength,
InvalidSignatureS,
InvalidSignatureV
}
function _throwError(RecoverError error) private pure {
if (error == RecoverError.NoError) {
return; // no error: do nothing
} else if (error == RecoverError.InvalidSignature) {
revert("ECDSA: invalid signature");
} else if (error == RecoverError.InvalidSignatureLength) {
revert("ECDSA: invalid signature length");
} else if (error == RecoverError.InvalidSignatureS) {
revert("ECDSA: invalid signature 's' value");
} else if (error == RecoverError.InvalidSignatureV) {
revert("ECDSA: invalid signature 'v' value");
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature` or error string. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*
* Documentation for signature generation:
* - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
* - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
// Check the signature length
// - case 65: r,s,v signature (standard)
// - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
if (signature.length == 65) {
bytes32 r;
bytes32 s;
uint8 v;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
assembly {
r := mload(add(signature, 0x20))
s := mload(add(signature, 0x40))
v := byte(0, mload(add(signature, 0x60)))
}
return tryRecover(hash, v, r, s);
} else if (signature.length == 64) {
bytes32 r;
bytes32 vs;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
assembly {
r := mload(add(signature, 0x20))
vs := mload(add(signature, 0x40))
}
return tryRecover(hash, r, vs);
} else {
return (address(0), RecoverError.InvalidSignatureLength);
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature`. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*/
function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, signature);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
*
* See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
*
* _Available since v4.3._
*/
function tryRecover(
bytes32 hash,
bytes32 r,
bytes32 vs
) internal pure returns (address, RecoverError) {
bytes32 s;
uint8 v;
assembly {
s := and(vs, 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff)
v := add(shr(255, vs), 27)
}
return tryRecover(hash, v, r, s);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
*
* _Available since v4.2._
*/
function recover(
bytes32 hash,
bytes32 r,
bytes32 vs
) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, r, vs);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `v`,
* `r` and `s` signature fields separately.
*
* _Available since v4.3._
*/
function tryRecover(
bytes32 hash,
uint8 v,
bytes32 r,
bytes32 s
) internal pure returns (address, RecoverError) {
// EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
// unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
// the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
// signatures from current libraries generate a unique signature with an s-value in the lower half order.
//
// If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
// with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
// vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
// these malleable signatures as well.
if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
return (address(0), RecoverError.InvalidSignatureS);
}
if (v != 27 && v != 28) {
return (address(0), RecoverError.InvalidSignatureV);
}
// If the signature is valid (and not malleable), return the signer address
address signer = ecrecover(hash, v, r, s);
if (signer == address(0)) {
return (address(0), RecoverError.InvalidSignature);
}
return (signer, RecoverError.NoError);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `v`,
* `r` and `s` signature fields separately.
*/
function recover(
bytes32 hash,
uint8 v,
bytes32 r,
bytes32 s
) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, v, r, s);
_throwError(error);
return recovered;
}
/**
* @dev Returns an Ethereum Signed Message, created from a `hash`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32) {
// 32 is the length in bytes of hash,
// enforced by the type signature above
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n32", hash));
}
/**
* @dev Returns an Ethereum Signed Typed Data, created from a
* `domainSeparator` and a `structHash`. This produces hash corresponding
* to the one signed with the
* https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
* JSON-RPC method as part of EIP-712.
*
* See {recover}.
*/
function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19\x01", domainSeparator, structHash));
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position of the value in the `values` array, plus 1 because index 0
// means a value is not in the set.
mapping(bytes32 => uint256) _indexes;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._indexes[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We read and store the value's index to prevent multiple reads from the same storage slot
uint256 valueIndex = set._indexes[value];
if (valueIndex != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 toDeleteIndex = valueIndex - 1;
uint256 lastIndex = set._values.length - 1;
if (lastIndex != toDeleteIndex) {
bytes32 lastvalue = set._values[lastIndex];
// Move the last value to the index where the value to delete is
set._values[toDeleteIndex] = lastvalue;
// Update the index for the moved value
set._indexes[lastvalue] = valueIndex; // Replace lastvalue's index to valueIndex
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the index for the deleted slot
delete set._indexes[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._indexes[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
return _values(set._inner);
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
assembly {
result := store
}
return result;
}
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
/**
* @title FeeLookups
* @author Non-Fungible Technologies, Inc.
*
* Enumerates unique identifiers for fee identifiers
* that the lending protocol uses.
*/
abstract contract FeeLookups {
/// @dev Origination fees: amount in bps, payable in loan token
bytes32 public constant FL_01 = keccak256("BORROWER_ORIGINATION_FEE");
bytes32 public constant FL_02 = keccak256("LENDER_ORIGINATION_FEE");
/// @dev Rollover fees: amount in bps, payable in loan token
bytes32 public constant FL_03 = keccak256("BORROWER_ROLLOVER_FEE");
bytes32 public constant FL_04 = keccak256("LENDER_ROLLOVER_FEE");
/// @dev Loan closure fees: amount in bps, payable in loan token
bytes32 public constant FL_05 = keccak256("LENDER_DEFAULT_FEE");
bytes32 public constant FL_06 = keccak256("LENDER_INTEREST_FEE");
bytes32 public constant FL_07 = keccak256("LENDER_PRINCIPAL_FEE");
bytes32 public constant FL_08 = keccak256("LENDER_REDEEM_FEE");
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev External interface of AccessControl declared to support ERC165 detection.
*/
interface IAccessControl {
/**
* @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
*
* `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
* {RoleAdminChanged} not being emitted signaling this.
*
* _Available since v3.1._
*/
event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
/**
* @dev Emitted when `account` is granted `role`.
*
* `sender` is the account that originated the contract call, an admin role
* bearer except when using {AccessControl-_setupRole}.
*/
event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Emitted when `account` is revoked `role`.
*
* `sender` is the account that originated the contract call:
* - if using `revokeRole`, it is the admin role bearer
* - if using `renounceRole`, it is the role bearer (i.e. `account`)
*/
event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) external view returns (bool);
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {AccessControl-_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) external view returns (bytes32);
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) external;
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
/**
* @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
*/
interface IAccessControlEnumerable is IAccessControl {
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) external view returns (address);
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) external view returns (uint256);
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*
* _Available since v3.1._
*/
interface IERC1155 is IERC165 {
/**
* @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(
address indexed operator,
address indexed from,
address indexed to,
uint256[] ids,
uint256[] values
);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the amount of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(address[] calldata accounts, uint256[] calldata ids)
external
view
returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must be have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(
address from,
address to,
uint256 id,
uint256 amount,
bytes calldata data
) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] calldata ids,
uint256[] calldata amounts,
bytes calldata data
) external;
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC1271 standard signature validation method for
* contracts as defined in https://eips.ethereum.org/EIPS/eip-1271[ERC-1271].
*
* _Available since v4.1._
*/
interface IERC1271 {
/**
* @dev Should return whether the signature provided is valid for the provided data
* @param hash Hash of the data to be signed
* @param signature Signature byte array associated with _data
*/
function isValidSignature(bytes32 hash, bytes memory signature) external view returns (bytes4 magicValue);
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `recipient`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address recipient, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `sender` to `recipient` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address sender,
address recipient,
uint256 amount
) external returns (bool);
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool _approved) external;
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes calldata data
) external;
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Enumerable is IERC721 {
/**
* @dev Returns the total amount of tokens stored by the contract.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns a token ID owned by `owner` at a given `index` of its token list.
* Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
*/
function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256 tokenId);
/**
* @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
* Use along with {totalSupply} to enumerate all tokens.
*/
function tokenByIndex(uint256 index) external view returns (uint256);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
interface IERC721Permit is IERC721 {
// ================ Permit Functionality ================
function permit(
address owner,
address spender,
uint256 tokenId,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
// ================ View Functions ================
function nonces(address owner) external view returns (uint256);
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
interface IFeeController {
// ================ Structs ================
struct FeesOrigination {
uint16 borrowerOriginationFee;
uint16 lenderOriginationFee;
uint16 lenderDefaultFee;
uint16 lenderInterestFee;
uint16 lenderPrincipalFee;
}
struct FeesRollover {
uint16 borrowerRolloverFee;
uint16 lenderRolloverFee;
}
// ================ Events =================
event SetLendingFee(bytes32 indexed id, uint16 fee);
event SetVaultMintFee(uint64 fee);
// ================ Getter/Setter =================
function setLendingFee(bytes32 id, uint16 fee) external;
function setVaultMintFee(uint64 fee) external;
function getLendingFee(bytes32 id) external view returns (uint16);
function getVaultMintFee() external view returns (uint64);
function getFeesOrigination() external view returns (FeesOrigination memory);
function getFeesRollover() external view returns (FeesRollover memory);
function getMaxLendingFee(bytes32 id) external view returns (uint16);
function getMaxVaultMintFee() external view returns (uint64);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "../libraries/LoanLibrary.sol";
import "./IPromissoryNote.sol";
interface ILoanCore {
// ================ Data Types =================
struct AffiliateSplit {
address affiliate;
uint96 splitBps;
}
struct NoteReceipt {
address token;
uint256 amount;
}
// ================ Events =================
event LoanStarted(uint256 loanId, address lender, address borrower);
event LoanRepaid(uint256 loanId);
event ForceRepay(uint256 loanId);
event LoanRolledOver(uint256 oldLoanId, uint256 newLoanId);
event LoanClaimed(uint256 loanId);
event NoteRedeemed(address indexed token, address indexed caller, address indexed to, uint256 tokenId, uint256 amount);
event NonceUsed(address indexed user, uint160 nonce);
event FeesWithdrawn(address indexed token, address indexed caller, address indexed to, uint256 amount);
event AffiliateSet(bytes32 indexed code, address indexed affiliate, uint96 splitBps);
// ============== Lifecycle Operations ==============
function startLoan(
address lender,
address borrower,
LoanLibrary.LoanTerms calldata terms,
uint256 _amountFromLender,
uint256 _amountToBorrower,
LoanLibrary.FeeSnapshot calldata feeSnapshot
) external returns (uint256 loanId);
function repay(
uint256 loanId,
address payer,
uint256 _amountFromPayer,
uint256 _amountToLender
) external;
function forceRepay(
uint256 loanId,
address payer,
uint256 _amountFromPayer,
uint256 _amountToLender
) external;
function claim(
uint256 loanId,
uint256 _amountFromLender
) external;
function redeemNote(
uint256 loanId,
uint256 _amountFromLender,
address to
) external;
function rollover(
uint256 oldLoanId,
address borrower,
address lender,
LoanLibrary.LoanTerms calldata terms,
uint256 _settledAmount,
uint256 _amountToOldLender,
uint256 _amountToLender,
uint256 _amountToBorrower
) external returns (uint256 newLoanId);
// ============== Nonce Management ==============
function consumeNonce(address user, uint160 nonce) external;
function cancelNonce(uint160 nonce) external;
// ============== Fee Management ==============
function withdraw(address token, uint256 amount, address to) external;
function withdrawProtocolFees(address token, address to) external;
// ============== Admin Operations ==============
function setAffiliateSplits(bytes32[] calldata codes, AffiliateSplit[] calldata splits) external;
// ============== View Functions ==============
function getLoan(uint256 loanId) external view returns (LoanLibrary.LoanData calldata loanData);
function getNoteReceipt(uint256 loanId) external view returns (address token, uint256 amount);
function isNonceUsed(address user, uint160 nonce) external view returns (bool);
function borrowerNote() external view returns (IPromissoryNote);
function lenderNote() external view returns (IPromissoryNote);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
interface INFTWithDescriptor {
// ============= Events ==============
event SetDescriptor(address indexed caller, address indexed descriptor);
// ================ Resource Metadata ================
function tokenURI(uint256 tokenId) external view returns (string memory);
function setDescriptor(address descriptor) external;
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "../libraries/LoanLibrary.sol";
interface IOriginationController {
// ================ Data Types =============
struct Currency {
bool isAllowed;
uint256 minPrincipal;
}
enum Side {
BORROW,
LEND
}
struct Signature {
uint8 v;
bytes32 r;
bytes32 s;
bytes extraData;
}
struct RolloverAmounts {
uint256 needFromBorrower;
uint256 leftoverPrincipal;
uint256 amountFromLender;
uint256 amountToOldLender;
uint256 amountToLender;
uint256 amountToBorrower;
}
// ================ Events =================
event Approval(address indexed owner, address indexed signer, bool isApproved);
event SetAllowedVerifier(address indexed verifier, bool isAllowed);
event SetAllowedCurrency(address indexed currency, bool isAllowed, uint256 minPrincipal);
event SetAllowedCollateral(address indexed collateral, bool isAllowed);
// ============== Origination Operations ==============
function initializeLoan(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce
) external returns (uint256 loanId);
function initializeLoanWithItems(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
LoanLibrary.Predicate[] calldata itemPredicates
) external returns (uint256 loanId);
function initializeLoanWithCollateralPermit(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
Signature calldata collateralSig,
uint256 permitDeadline
) external returns (uint256 loanId);
function initializeLoanWithCollateralPermitAndItems(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
Signature calldata collateralSig,
uint256 permitDeadline,
LoanLibrary.Predicate[] calldata itemPredicates
) external returns (uint256 loanId);
function rolloverLoan(
uint256 oldLoanId,
LoanLibrary.LoanTerms calldata loanTerms,
address lender,
Signature calldata sig,
uint160 nonce
) external returns (uint256 newLoanId);
function rolloverLoanWithItems(
uint256 oldLoanId,
LoanLibrary.LoanTerms calldata loanTerms,
address lender,
Signature calldata sig,
uint160 nonce,
LoanLibrary.Predicate[] calldata itemPredicates
) external returns (uint256 newLoanId);
// ================ Permission Management =================
function approve(address signer, bool approved) external;
function isApproved(address owner, address signer) external returns (bool);
function isSelfOrApproved(address target, address signer) external returns (bool);
function isApprovedForContract(
address target,
Signature calldata sig,
bytes32 sighash
) external returns (bool);
// ============== Signature Verification ==============
function recoverTokenSignature(
LoanLibrary.LoanTerms calldata loanTerms,
Signature calldata sig,
uint160 nonce,
Side side
) external view returns (bytes32 sighash, address signer);
function recoverItemsSignature(
LoanLibrary.LoanTerms calldata loanTerms,
Signature calldata sig,
uint160 nonce,
Side side,
bytes32 itemsHash
) external view returns (bytes32 sighash, address signer);
// ============== Admin Operations ==============
function setAllowedPayableCurrencies(address[] memory _tokenAddress, Currency[] calldata currencyData) external;
function setAllowedCollateralAddresses(address[] memory _tokenAddress, bool[] calldata isAllowed) external;
function setAllowedVerifiers(address[] calldata verifiers, bool[] calldata isAllowed) external;
function isAllowedCurrency(address token) external view returns (bool);
function isAllowedCollateral(address token) external view returns (bool);
function isAllowedVerifier(address verifier) external view returns (bool);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Enumerable.sol";
import "./INFTWithDescriptor.sol";
interface IPromissoryNote is INFTWithDescriptor, IERC721Enumerable {
// ============== Token Operations ==============
function mint(address to, uint256 loanId) external returns (uint256);
function burn(uint256 tokenId) external;
// ============== Initializer ==============
function initialize(address loanCore) external;
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
interface ISignatureVerifier {
// ============== Collateral Verification ==============
function verifyPredicates(
address borrower,
address lender,
address collateralAddress,
uint256 collateralId,
bytes calldata predicates
) external view returns (bool);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "./INFTWithDescriptor.sol";
interface IVaultFactory is INFTWithDescriptor {
// ============= Events ==============
event VaultCreated(address vault, address to);
event ClaimFees(address owner, uint256 amount);
// ================ View Functions ================
function isInstance(address instance) external view returns (bool validity);
function instanceCount() external view returns (uint256);
function instanceAt(uint256 tokenId) external view returns (address);
function instanceAtIndex(uint256 index) external view returns (address);
// ================ Factory Operations ================
function initializeBundle(address to) external payable returns (uint256);
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
/**
* @title InterestCalculator
* @author Non-Fungible Technologies, Inc.
*
* Interface for calculating the interest amount
* given an interest rate and principal amount. Assumes
* that the interestRate is already expressed over the desired
* time period.
*/
abstract contract InterestCalculator {
// ============================================ STATE ==============================================
/// @dev The units of precision equal to the minimum interest of 1 basis point.
uint256 public constant INTEREST_RATE_DENOMINATOR = 1e18;
uint256 public constant BASIS_POINTS_DENOMINATOR = 1e4;
// ======================================== CALCULATIONS ===========================================
/**
* @notice Calculate the interest due over a full term.
*
* @dev Interest and principal must be entered with 18 units of
* precision from the basis point unit (e.g. 1e18 == 0.01%)
*
* @param principal Principal amount in the loan terms.
* @param proratedInterestRate Interest rate in the loan terms, prorated over loan duration.
*
* @return interest The amount of interest due.
*/
function getInterestAmount(uint256 principal, uint256 proratedInterestRate) public pure returns (uint256) {
return principal * proratedInterestRate / (INTEREST_RATE_DENOMINATOR * BASIS_POINTS_DENOMINATOR);
}
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "../libraries/LoanLibrary.sol";
/**
* @title LendingErrors
* @author Non-Fungible Technologies, Inc.
*
* This file contains custom errors for the core lending protocol contracts, with errors
* prefixed by the contract that throws them (e.g., "OC_" for OriginationController).
* Errors located in one place to make it possible to holistically look at all
* protocol failure cases.
*/
// ==================================== ORIGINATION CONTROLLER ======================================
/// @notice All errors prefixed with OC_, to separate from other contracts in the protocol.
/**
* @notice Zero address passed in where not allowed.
*
* @param addressType The name of the parameter for which a zero address was provided.
*/
error OC_ZeroAddress(string addressType);
/**
* @notice Ensure valid loan state for loan lifceycle operations.
*
* @param state Current state of a loan according to LoanState enum.
*/
error OC_InvalidState(LoanLibrary.LoanState state);
/**
* @notice Loan duration must be greater than 1hr and less than 3yrs.
*
* @param durationSecs Total amount of time in seconds.
*/
error OC_LoanDuration(uint256 durationSecs);
/**
* @notice Interest must be greater than 0.01% and less than 10,000%. (interestRate / 1e18 >= 1)
*
* @param interestRate InterestRate with 1e18 multiplier.
*/
error OC_InterestRate(uint256 interestRate);
/**
* @notice One of the predicates for item verification failed.
*
* @param borrower The address of the borrower.
* @param lender The address of the lender.
* @param verifier The address of the verifier contract.
* @param collateralAddress The address of the collateral token.
* @param collateralId The token ID of the collateral.
* @param data The verification data (to be parsed by verifier).
*/
error OC_PredicateFailed(
address borrower,
address lender,
address verifier,
address collateralAddress,
uint256 collateralId,
bytes data
);
/**
* @notice The predicates array is empty.
*/
error OC_PredicatesArrayEmpty();
/**
* @notice A caller attempted to approve themselves.
*
* @param caller The caller of the approve function.
*/
error OC_SelfApprove(address caller);
/**
* @notice A caller attempted to originate a loan with their own signature.
*
* @param caller The caller of the approve function, who was also the signer.
*/
error OC_ApprovedOwnLoan(address caller);
/**
* @notice The signature could not be recovered to the counterparty or approved party.
*
* @param target The target party of the signature, which should either be the signer,
* or someone who has approved the signer.
* @param signer The signer determined from ECDSA.recover.
*/
error OC_InvalidSignature(address target, address signer);
/**
* @notice The verifier contract specified in a predicate has not been whitelisted.
*
* @param verifier The verifier the caller attempted to use.
*/
error OC_InvalidVerifier(address verifier);
/**
* @notice The function caller was neither borrower or lender, and was not approved by either.
*
* @param caller The unapproved function caller.
*/
error OC_CallerNotParticipant(address caller);
/**
* @notice Signer is attempting to take the wrong side of the loan.
*
* @param signer The address of the external signer.
*/
error OC_SideMismatch(address signer);
/**
* @notice Two related parameters for batch operations did not match in length.
*/
error OC_BatchLengthMismatch();
/**
* @notice Principal must be greater than 9999 Wei.
*
* @param principal Principal in ether.
*/
error OC_PrincipalTooLow(uint256 principal);
/**
* @notice Signature must not be expired.
*
* @param deadline Deadline in seconds.
*/
error OC_SignatureIsExpired(uint256 deadline);
/**
* @notice New currency does not match for a loan rollover request.
*
* @param oldCurrency The currency of the active loan.
* @param newCurrency The currency of the new loan.
*/
error OC_RolloverCurrencyMismatch(address oldCurrency, address newCurrency);
/**
* @notice New currency does not match for a loan rollover request.
*
* @param oldCollateralAddress The address of the active loan's collateral.
* @param newCollateralAddress The token ID of the active loan's collateral.
* @param oldCollateralId The address of the new loan's collateral.
* @param newCollateralId The token ID of the new loan's collateral.
*/
error OC_RolloverCollateralMismatch(
address oldCollateralAddress,
uint256 oldCollateralId,
address newCollateralAddress,
uint256 newCollateralId
);
/**
* @notice Provided payable currency address is not approved for lending.
*
* @param payableCurrency ERC20 token address supplied in loan terms.
*/
error OC_InvalidCurrency(address payableCurrency);
/**
* @notice Provided collateral address is not approved for lending.
*
* @param collateralAddress ERC721 or ERC1155 token address supplied in loan terms.
*/
error OC_InvalidCollateral(address collateralAddress);
/**
* @notice Provided token array does not hold any token addresses.
*/
error OC_ZeroArrayElements();
/**
* @notice Provided token array holds more than 50 token addresses.
*/
error OC_ArrayTooManyElements();
// ==================================== ITEMS VERIFIER ======================================
/// @notice All errors prefixed with IV_, to separate from other contracts in the protocol.
/**
* @notice The predicate payload was decoded successfully, but list of predicates is empty.
*/
error IV_NoPredicates();
/**
* @notice Provided SignatureItem is missing an address.
*/
error IV_ItemMissingAddress();
/**
* @notice Provided SignatureItem has an invalid collateral type.
* @dev Should never actually fire, since cType is defined by an enum, so will fail on decode.
*
* @param asset The NFT contract being checked.
* @param cType The collateralTytpe provided.
*/
error IV_InvalidCollateralType(address asset, uint256 cType);
/**
* @notice Provided signature item with no required amount. For single ERC721s, specify 1.
*
* @param asset The NFT contract being checked.
* @param amount The amount provided (should be 0).
*/
error IV_NoAmount(address asset, uint256 amount);
/**
* @notice Provided a wildcard for a non-ERC721.
*
* @param asset The NFT contract being checked.
*/
error IV_InvalidWildcard(address asset);
/**
* @notice The provided token ID is out of bounds for the given collection.
*
* @param tokenId The token ID provided.
*/
error IV_InvalidTokenId(int256 tokenId);
/**
* @notice The provided project ID does not exist on the target contract. Only
* used for ArtBlocks.
*
* @param projectId The project ID provided.
* @param nextProjectId The contract's reported nextProjectId.
*/
error IV_InvalidProjectId(uint256 projectId, uint256 nextProjectId);
/**
* @notice The provided collateralId converts to a vault, but
* the vault's address does not convert back to the provided collateralId
* when casted to a uint256.
*/
error IV_InvalidCollateralId(uint256 collateralId);
// ==================================== REPAYMENT CONTROLLER ======================================
/// @notice All errors prefixed with RC_, to separate from other contracts in the protocol.
/**
* @notice Zero address passed in where not allowed.
*
* @param addressType The name of the parameter for which a zero address was provided.
*/
error RC_ZeroAddress(string addressType);
/**
* @notice Could not dereference loan from loan ID.
*
* @param target The loanId being checked.
*/
error RC_CannotDereference(uint256 target);
/**
* @notice Ensure valid loan state for loan lifceycle operations.
*
* @param state Current state of a loan according to LoanState enum.
*/
error RC_InvalidState(LoanLibrary.LoanState state);
/**
* @notice Caller is not the owner of lender note.
*
* @param lender The owner of the lender note.
* @param caller Msg.sender of the function call.
*/
error RC_OnlyLender(address lender, address caller);
// ==================================== Loan Core ======================================
/// @notice All errors prefixed with LC_, to separate from other contracts in the protocol.
/**
* @notice Zero address passed in where not allowed.
*
* @param addressType The name of the parameter for which a zero address was provided.
*/
error LC_ZeroAddress(string addressType);
/// @notice Borrower address is same as lender address.
error LC_ReusedNote();
/// @notice Zero amount passed in where not allowed.
error LC_ZeroAmount();
/**
* @notice Check collateral is not already used in a active loan.
*
* @param collateralAddress Address of the collateral.
* @param collateralId ID of the collateral token.
*/
error LC_CollateralInUse(address collateralAddress, uint256 collateralId);
/**
* @notice The reported settlements are invalid, and LoanCore would lose tokens
* attempting to perform the requested operations.
*
*
* @param payout Amount of tokens to be paid out.
* @param collected Amount of tokens to collect - should be fewer than payout.
*/
error LC_CannotSettle(uint256 payout, uint256 collected);
/**
* @notice User attempted to withdraw a pending balance that was in excess
* of what is available.
*
* @param amount Amount of tokens to be withdrawn.
* @param available Amount of tokens available to withdraw.
*/
error LC_CannotWithdraw(uint256 amount, uint256 available);
/**
* @notice Two arrays were provided that must be of matching length, but were not.
*
*/
error LC_ArrayLengthMismatch();
/**
* @notice A proposed affiliate split was submitted that is over the maximum.
*
* @param splitBps The proposed affiliate split.
* @param maxSplitBps The maximum allowed affiliate split.
*
*/
error LC_OverMaxSplit(uint96 splitBps, uint96 maxSplitBps);
/**
* @notice Ensure valid loan state for loan lifceycle operations.
*
* @param state Current state of a loan according to LoanState enum.
*/
error LC_InvalidState(LoanLibrary.LoanState state);
/**
* @notice Loan duration has not expired.
*
* @param dueDate Timestamp of the end of the loan duration.
*/
error LC_NotExpired(uint256 dueDate);
/**
* @notice User address and the specified nonce have already been used.
*
* @param user Address of collateral owner.
* @param nonce Represents the number of transactions sent by address.
*/
error LC_NonceUsed(address user, uint160 nonce);
/**
* @notice Protocol attempted to set an affiliate code which already exists. Affiliate
* codes are immutable.
*
* @param affiliateCode The affiliate code being set.
*/
error LC_AffiliateCodeAlreadySet(bytes32 affiliateCode);
/**
* @notice Specified note token ID does not have a redeemable receipt.
*
* @param loanId The loanId being checked.
*/
error LC_NoReceipt(uint256 loanId);
/**
* @notice Only Loan Core contract can call this function.
*/
error LC_CallerNotLoanCore();
/**
* @notice The loan core contract has been irreversibly shut down.
*/
error LC_Shutdown();
// ==================================== Promissory Note ======================================
/// @notice All errors prefixed with PN_, to separate from other contracts in the protocol.
/**
* @notice Zero address passed in where not allowed.
*
* @param addressType The name of the parameter for which a zero address was provided.
*/
error PN_ZeroAddress(string addressType);
/**
* @notice Caller of mint function must have the MINTER_ROLE in AccessControl.
*
* @param caller Address of the function caller.
*/
error PN_MintingRole(address caller);
/**
* @notice Caller of burn function must have the BURNER_ROLE in AccessControl.
*
* @param caller Address of the function caller.
*/
error PN_BurningRole(address caller);
/**
* @notice Non-existant token id provided as argument.
*
* @param tokenId The ID of the token to lookup the URI for.
*/
error PN_DoesNotExist(uint256 tokenId);
// ==================================== Fee Controller ======================================
/// @notice All errors prefixed with FC_, to separate from other contracts in the protocol.
/**
* @notice Caller attempted to set a lending fee which is larger than the global maximum.
*/
error FC_LendingFeeOverMax(bytes32 selector, uint256 fee, uint256 maxFee);
/**
* @notice Caller attempted to set a vault mint fee which is larger than the global maximum.
*/
error FC_VaultMintFeeOverMax(uint256 fee, uint256 maxFee);
// ==================================== ERC721 Permit ======================================
/// @notice All errors prefixed with ERC721P_, to separate from other contracts in the protocol.
/**
* @notice Deadline for the permit has expired.
*
* @param deadline Permit deadline parameter as a timestamp.
*/
error ERC721P_DeadlineExpired(uint256 deadline);
/**
* @notice Address of the owner to also be the owner of the tokenId.
*
* @param owner Owner parameter for the function call.
*/
error ERC721P_NotTokenOwner(address owner);
/**
* @notice Invalid signature.
*
* @param signer Signer recovered from ECDSA sugnature hash.
*/
error ERC721P_InvalidSignature(address signer);
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
/**
* @title LoanLibrary
* @author Non-Fungible Technologies, Inc.
*
* Contains all data types used across Arcade lending contracts.
*/
library LoanLibrary {
/**
* @dev Enum describing the current state of a loan.
* State change flow:
* Created -> Active -> Repaid
* -> Defaulted
*/
enum LoanState {
// We need a default that is not 'Created' - this is the zero value
DUMMY_DO_NOT_USE,
// The loan has been initialized, funds have been delivered to the borrower and the collateral is held.
Active,
// The loan has been repaid, and the collateral has been returned to the borrower. This is a terminal state.
Repaid,
// The loan was delinquent and collateral claimed by the lender. This is a terminal state.
Defaulted
}
/**
* @dev The raw terms of a loan.
*/
struct LoanTerms {
// Interest expressed as a rate, unlike V1 gross value.
// Input conversion: 0.01% = (1 * 10**18) , 10.00% = (1000 * 10**18)
// This represents the rate over the lifetime of the loan, not APR.
// 0.01% is the minimum interest rate allowed by the protocol.
uint256 proratedInterestRate;
/// @dev Full-slot variables
// The amount of principal in terms of the payableCurrency.
uint256 principal;
// The token ID of the address holding the collateral.
/// @dev Can be an AssetVault, or the NFT contract for unbundled collateral
address collateralAddress;
/// @dev Packed variables
// The number of seconds representing relative due date of the loan.
/// @dev Max is 94,608,000, fits in 96 bits
uint96 durationSecs;
// The token ID of the collateral.
uint256 collateralId;
// The payable currency for the loan principal and interest.
address payableCurrency;
// Timestamp for when signature for terms expires
uint96 deadline;
// Affiliate code used to start the loan.
bytes32 affiliateCode;
}
/**
* @dev Modification of loan terms, used for signing only.
* Instead of a collateralId, a list of predicates
* is defined by 'bytes' in items.
*/
struct LoanTermsWithItems {
// Interest expressed as a rate, unlike V1 gross value.
// Input conversion: 0.01% = (1 * 10**18) , 10.00% = (1000 * 10**18)
// This represents the rate over the lifetime of the loan, not APR.
// 0.01% is the minimum interest rate allowed by the protocol.
uint256 proratedInterestRate;
/// @dev Full-slot variables
// The amount of principal in terms of the payableCurrency.
uint256 principal;
// The tokenID of the address holding the collateral
address collateralAddress;
/// @dev Packed variables
// The number of seconds representing relative due date of the loan.
/// @dev Max is 94,608,000, fits in 96 bits
uint96 durationSecs;
// An encoded list of predicates, along with their verifiers.
bytes items;
// The payable currency for the loan principal and interest.
address payableCurrency;
// Timestamp for when signature for terms expires
uint96 deadline;
// Affiliate code used to start the loan.
bytes32 affiliateCode;
}
/**
* @dev Predicate for item-based verifications
*/
struct Predicate {
// The encoded predicate, to decoded and parsed by the verifier contract.
bytes data;
// The verifier contract.
address verifier;
}
/**
* @dev Snapshot of lending fees at the time of loan creation.
*/
struct FeeSnapshot {
// The fee taken when lender claims defaulted collateral.
uint16 lenderDefaultFee;
// The fee taken from the borrower's interest repayment.
uint16 lenderInterestFee;
// The fee taken from the borrower's principal repayment.
uint16 lenderPrincipalFee;
}
/**
* @dev The data of a loan. This is stored once the loan is Active
*/
struct LoanData {
/// @dev Packed variables
// The current state of the loan.
LoanState state;
// Start date of the loan, using block.timestamp.
uint160 startDate;
/// @dev Full-slot variables
// The raw terms of the loan.
LoanTerms terms;
// Record of lending fees at the time of loan creation.
FeeSnapshot feeSnapshot;
}
}
// SPDX-License-Identifier: MIT
pragma solidity 0.8.18;
import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
import "@openzeppelin/contracts/interfaces/IERC1271.sol";
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "@openzeppelin/contracts/utils/cryptography/draft-EIP712.sol";
import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
import "./interfaces/IOriginationController.sol";
import "./interfaces/ILoanCore.sol";
import "./interfaces/IERC721Permit.sol";
import "./interfaces/ISignatureVerifier.sol";
import "./interfaces/IFeeController.sol";
import "./libraries/InterestCalculator.sol";
import "./libraries/FeeLookups.sol";
import "./verifiers/ArcadeItemsVerifier.sol";
import {
OC_ZeroAddress,
OC_InvalidState,
OC_InvalidVerifier,
OC_BatchLengthMismatch,
OC_PredicateFailed,
OC_PredicatesArrayEmpty,
OC_SelfApprove,
OC_ApprovedOwnLoan,
OC_InvalidSignature,
OC_CallerNotParticipant,
OC_SideMismatch,
OC_PrincipalTooLow,
OC_LoanDuration,
OC_InterestRate,
OC_SignatureIsExpired,
OC_RolloverCurrencyMismatch,
OC_RolloverCollateralMismatch,
OC_InvalidCurrency,
OC_InvalidCollateral,
OC_ZeroArrayElements,
OC_ArrayTooManyElements
} from "./errors/Lending.sol";
/**
* @title OriginationController
* @author Non-Fungible Technologies, Inc.
*
* The Origination Controller is the entry point for all new loans
* in the Arcade.xyz lending protocol. This contract has the exclusive
* responsibility of creating new loans in LoanCore. All permissioning,
* signature verification, and collateral verification takes place in
* this contract. To originate a loan, the controller also takes custody
* of both the collateral and loan principal.
*/
contract OriginationController is
IOriginationController,
InterestCalculator,
FeeLookups,
EIP712,
ReentrancyGuard,
AccessControlEnumerable
{
using SafeERC20 for IERC20;
// ============================================ STATE ==============================================
// =================== Constants =====================
bytes32 public constant ADMIN_ROLE = keccak256("ADMIN");
bytes32 public constant WHITELIST_MANAGER_ROLE = keccak256("WHITELIST_MANAGER");
/// @notice EIP712 type hash for bundle-based signatures.
bytes32 private constant _TOKEN_ID_TYPEHASH =
keccak256(
// solhint-disable-next-line max-line-length
"LoanTerms(uint256 proratedInterestRate,uint256 principal,address collateralAddress,uint96 durationSecs,uint256 collateralId,address payableCurrency,uint96 deadline,bytes32 affiliateCode,uint160 nonce,uint8 side)"
);
/// @notice EIP712 type hash for item-based signatures.
bytes32 private constant _ITEMS_TYPEHASH =
keccak256(
// solhint-disable max-line-length
"LoanTermsWithItems(uint256 proratedInterestRate,uint256 principal,address collateralAddress,uint96 durationSecs,Predicate[] items,address payableCurrency,uint96 deadline,bytes32 affiliateCode,uint160 nonce,uint8 side)Predicate(bytes data,address verifier)"
);
/// @notice EIP712 type hash for Predicate.
bytes32 public constant _PREDICATE_TYPEHASH =
keccak256(
"Predicate(bytes data,address verifier)"
);
// =============== Contract References ===============
ILoanCore private immutable loanCore;
IFeeController private immutable feeController;
// ================= Approval State ==================
/// @notice Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _signerApprovals;
/// @notice Mapping from address to whether that verifier contract has been whitelisted
mapping(address => bool) public allowedVerifiers;
/// @notice Mapping from ERC20 token address to boolean indicating allowed payable currencies and set minimums
mapping(address => Currency) public allowedCurrencies;
/// @notice Mapping from ERC721 or ERC1155 token address to boolean indicating allowed collateral types
mapping(address => bool) public allowedCollateral;
// ========================================== CONSTRUCTOR ===========================================
/**
* @notice Creates a new origination controller contract, also initializing
* the parent signature verifier.
*
* @dev For this controller to work, it needs to be granted the ORIGINATOR_ROLE
* in loan core after deployment.
*
* @param _loanCore The address of the loan core logic of the protocol.
* @param _feeController The address of the fee logic of the protocol.
*/
constructor(address _loanCore, address _feeController) EIP712("OriginationController", "3") {
if (_loanCore == address(0)) revert OC_ZeroAddress("loanCore");
if (_feeController == address(0)) revert OC_ZeroAddress("feeController");
_setupRole(ADMIN_ROLE, msg.sender);
_setRoleAdmin(ADMIN_ROLE, ADMIN_ROLE);
_setupRole(WHITELIST_MANAGER_ROLE, msg.sender);
_setRoleAdmin(WHITELIST_MANAGER_ROLE, ADMIN_ROLE);
loanCore = ILoanCore(_loanCore);
feeController = IFeeController(_feeController);
}
// ==================================== ORIGINATION OPERATIONS ======================================
/**
* @notice Initializes a loan with Loan Core.
* @notice Works with either wrapped bundles with an ID, or specific ERC721 unwrapped NFTs.
* In that case, collateralAddress should be the token contract.
*
* @dev The caller must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must come from the opposite side of the loan as the caller.
*
* @param loanTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields, and a nonce.
* @param nonce The signature nonce.
*
* @return loanId The unique ID of the new loan.
*/
function initializeLoan(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce
) public override returns (uint256 loanId) {
_validateLoanTerms(loanTerms);
// Determine if signature needs to be on the borrow or lend side
Side neededSide = isSelfOrApproved(borrower, msg.sender) ? Side.LEND : Side.BORROW;
(bytes32 sighash, address externalSigner) = recoverTokenSignature(
loanTerms,
sig,
nonce,
neededSide
);
_validateCounterparties(borrower, lender, msg.sender, externalSigner, sig, sighash, neededSide);
loanCore.consumeNonce(externalSigner, nonce);
loanId = _initialize(loanTerms, borrower, lender);
}
/**
* @notice Initializes a loan with Loan Core.
* @notice Compared to initializeLoan, this uses custom predicates to verify collateral.
*
* @dev The caller must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must come from the opposite side of the loan as the caller.
*
* @param loanTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields, and a nonce.
* @param nonce The signature nonce.
* @param itemPredicates The predicate rules for the items in the bundle.
*
* @return loanId The unique ID of the new loan.
*/
function initializeLoanWithItems(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
LoanLibrary.Predicate[] calldata itemPredicates
) public override returns (uint256 loanId) {
_validateLoanTerms(loanTerms);
if (itemPredicates.length == 0) revert OC_PredicatesArrayEmpty();
bytes32 encodedPredicates = _encodePredicates(itemPredicates);
// Determine if signature needs to be on the borrow or lend side
Side neededSide = isSelfOrApproved(borrower, msg.sender) ? Side.LEND : Side.BORROW;
(bytes32 sighash, address externalSigner) = recoverItemsSignature(
loanTerms,
sig,
nonce,
neededSide,
encodedPredicates
);
_validateCounterparties(borrower, lender, msg.sender, externalSigner, sig, sighash, neededSide);
loanCore.consumeNonce(externalSigner, nonce);
loanId = _initialize(loanTerms, borrower, lender);
// Run predicates check at the end of the function, after vault is in escrow. This makes sure
// that re-entrancy was not employed to withdraw collateral after the predicates check occurs.
_runPredicatesCheck(borrower, lender, loanTerms, itemPredicates);
}
/**
* @notice Initializes a loan with Loan Core, with a permit signature instead of pre-approved collateral.
*
* @dev The caller must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must come from the opposite side of the loan as the caller.
*
* @param loanTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields.
* @param nonce The signature nonce for the loan terms signature.
* @param collateralSig The collateral permit signature, with v, r, s fields.
* @param permitDeadline The last timestamp for which the signature is valid.
*
* @return loanId The unique ID of the new loan.
*/
function initializeLoanWithCollateralPermit(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
Signature calldata collateralSig,
uint256 permitDeadline
) external override returns (uint256 loanId) {
IERC721Permit(loanTerms.collateralAddress).permit(
borrower,
address(loanCore),
loanTerms.collateralId,
permitDeadline,
collateralSig.v,
collateralSig.r,
collateralSig.s
);
loanId = initializeLoan(loanTerms, borrower, lender, sig, nonce);
}
/**
* @notice Initializes a loan with Loan Core, with a permit signature instead of pre-approved collateral.
* @notice Compared to initializeLoanWithCollateralPermit, this verifies the specific items in a bundle.
*
* @dev The caller must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must be a borrower or lender, or approved by a borrower or lender.
* @dev The external signer must come from the opposite side of the loan as the caller.
*
* @param loanTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields.
* @param nonce The signature nonce for the loan terms signature.
* @param collateralSig The collateral permit signature, with v, r, s fields.
* @param permitDeadline The last timestamp for which the signature is valid.
* @param itemPredicates The predicate rules for the items in the bundle.
*
* @return loanId The unique ID of the new loan.
*/
function initializeLoanWithCollateralPermitAndItems(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender,
Signature calldata sig,
uint160 nonce,
Signature calldata collateralSig,
uint256 permitDeadline,
LoanLibrary.Predicate[] calldata itemPredicates
) external override returns (uint256 loanId) {
IERC721Permit(loanTerms.collateralAddress).permit(
borrower,
address(loanCore),
loanTerms.collateralId,
permitDeadline,
collateralSig.v,
collateralSig.r,
collateralSig.s
);
loanId = initializeLoanWithItems(loanTerms, borrower, lender, sig, nonce, itemPredicates);
}
/**
* @notice Rolls over an existing loan via Loan Core, using a signature for
* a new loan to be created. The lender can be the same lender as the
* loan to be rolled over, or a new lender. The net funding between the
* old and new loan is calculated, with funds withdrawn from relevant
* parties.
*
* @param oldLoanId The ID of the old loan.
* @param loanTerms The terms agreed by the lender and borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields.
* @param nonce The signature nonce for the loan terms signature.
*
* @return newLoanId The unique ID of the new loan.
*/
function rolloverLoan(
uint256 oldLoanId,
LoanLibrary.LoanTerms calldata loanTerms,
address lender,
Signature calldata sig,
uint160 nonce
) public override returns (uint256 newLoanId) {
_validateLoanTerms(loanTerms);
LoanLibrary.LoanData memory data = loanCore.getLoan(oldLoanId);
if (data.state != LoanLibrary.LoanState.Active) revert OC_InvalidState(data.state);
_validateRollover(data.terms, loanTerms);
address borrower = IERC721(loanCore.borrowerNote()).ownerOf(oldLoanId);
// Determine if signature needs to be on the borrow or lend side
Side neededSide = isSelfOrApproved(borrower, msg.sender) ? Side.LEND : Side.BORROW;
(bytes32 sighash, address externalSigner) = recoverTokenSignature(
loanTerms,
sig,
nonce,
neededSide
);
_validateCounterparties(borrower, lender, msg.sender, externalSigner, sig, sighash, neededSide);
loanCore.consumeNonce(externalSigner, nonce);
newLoanId = _rollover(oldLoanId, loanTerms, borrower, lender);
}
/**
* @notice Rolls over an existing loan via Loan Core, using a signature
* for a new loan to create (of items type). The lender can be the same lender
* in the loan to be rolled over, or a new lender. The net funding between
* the old and new loan is calculated, with funds withdrawn from relevant
* parties.
*
* @param oldLoanId The ID of the old loan.
* @param loanTerms The terms agreed by the lender and borrower.
* @param lender Address of the lender.
* @param sig The loan terms signature, with v, r, s fields.
* @param nonce The signature nonce for the loan terms signature.
* @param itemPredicates The predicate rules for the items in the bundle.
*
* @return newLoanId The unique ID of the new loan.
*/
function rolloverLoanWithItems(
uint256 oldLoanId,
LoanLibrary.LoanTerms calldata loanTerms,
address lender,
Signature calldata sig,
uint160 nonce,
LoanLibrary.Predicate[] calldata itemPredicates
) public override returns (uint256 newLoanId) {
_validateLoanTerms(loanTerms);
if (itemPredicates.length == 0) revert OC_PredicatesArrayEmpty();
LoanLibrary.LoanData memory data = loanCore.getLoan(oldLoanId);
if (data.state != LoanLibrary.LoanState.Active) revert OC_InvalidState(data.state);
_validateRollover(data.terms, loanTerms);
address borrower = IERC721(loanCore.borrowerNote()).ownerOf(oldLoanId);
bytes32 encodedPredicates = _encodePredicates(itemPredicates);
// Determine if signature needs to be on the borrow or lend side
Side neededSide = isSelfOrApproved(borrower, msg.sender) ? Side.LEND : Side.BORROW;
(bytes32 sighash, address externalSigner) = recoverItemsSignature(
loanTerms,
sig,
nonce,
neededSide,
encodedPredicates
);
_validateCounterparties(borrower, lender, msg.sender, externalSigner, sig, sighash, neededSide);
loanCore.consumeNonce(externalSigner, nonce);
newLoanId = _rollover(oldLoanId, loanTerms, borrower, lender);
// Run predicates check at the end of the function, after vault is in escrow. This makes sure
// that re-entrancy was not employed to withdraw collateral after the predicates check occurs.
_runPredicatesCheck(borrower, lender, loanTerms, itemPredicates);
}
// ==================================== PERMISSION MANAGEMENT =======================================
/**
* @notice Approve a third party to sign or initialize loans on a counterparty's behalf.
* @notice Useful to multisig counterparties (who cannot sign themselves) or third-party integrations.
*
* @param signer The party to set approval for.
* @param approved Whether the party should be approved.
*/
function approve(address signer, bool approved) public override {
if (signer == msg.sender) revert OC_SelfApprove(msg.sender);
_signerApprovals[msg.sender][signer] = approved;
emit Approval(msg.sender, signer, approved);
}
/**
* @notice Reports whether a party is approved to act on a counterparty's behalf.
*
* @param owner The grantor of permission.
* @param signer The grantee of permission.
*
* @return isApproved Whether the grantee has been approved by the grantor.
*/
function isApproved(address owner, address signer) public view virtual override returns (bool) {
return _signerApprovals[owner][signer];
}
/**
* @notice Reports whether the signer matches the target or is approved by the target.
*
* @param target The grantor of permission - should be a smart contract.
* @param sig A struct containing the signature data (for checking EIP-1271).
* @param sighash The hash of the signature payload (used for EIP-1271 check).
*
* @return bool Whether the signer is either the grantor themselves, or approved.
*/
function isApprovedForContract(
address target,
Signature memory sig,
bytes32 sighash
) public view override returns (bool) {
bytes memory signature = abi.encodePacked(sig.r, sig.s, sig.v);
// Append extra data if it exists
bytes memory zeroBytes = new bytes(0);
if (keccak256(sig.extraData) != keccak256(zeroBytes)) {
signature = bytes.concat(signature, sig.extraData);
}
// Convert sig struct to bytes
(bool success, bytes memory result) = target.staticcall(
abi.encodeWithSelector(IERC1271.isValidSignature.selector, sighash, signature)
);
return (success && result.length == 32 && abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector);
}
/**
* @notice Reports whether the signer matches the target or is approved by the target.
*
* @param target The grantor of permission.
* @param signer The grantee of permission.
*
* @return isSelfOrApproved Whether the signer is either the grantor themselves, or approved.
*/
function isSelfOrApproved(address target, address signer) public view override returns (bool) {
return target == signer || isApproved(target, signer);
}
// ==================================== SIGNATURE VERIFICATION ======================================
/**
* @notice Determine the external signer for a signature specifying only a collateral address and ID.
*
* @param loanTerms The terms of the loan.
* @param sig The signature, with v, r, s fields.
* @param nonce The signature nonce.
* @param side The side of the loan being signed.
*
* @return sighash The hash that was signed.
* @return signer The address of the recovered signer.
*/
function recoverTokenSignature(
LoanLibrary.LoanTerms calldata loanTerms,
Signature calldata sig,
uint160 nonce,
Side side
) public view override returns (bytes32 sighash, address signer) {
bytes32 loanHash = keccak256(
abi.encode(
_TOKEN_ID_TYPEHASH,
loanTerms.proratedInterestRate,
loanTerms.principal,
loanTerms.collateralAddress,
loanTerms.durationSecs,
loanTerms.collateralId,
loanTerms.payableCurrency,
loanTerms.deadline,
loanTerms.affiliateCode,
nonce,
uint8(side)
)
);
sighash = _hashTypedDataV4(loanHash);
signer = ECDSA.recover(sighash, sig.v, sig.r, sig.s);
}
/**
* @notice Determine the external signer for a signature specifying specific items.
* @dev Bundle ID should _not_ be included in this signature, because the loan
* can be initiated with any arbitrary bundle - as long as the bundle contains the items.
*
* @param loanTerms The terms of the loan.
* @param sig The loan terms signature, with v, r, s fields.
* @param nonce The signature nonce.
* @param side The side of the loan being signed.
* @param itemsHash The required items in the specified bundle.
*
* @return sighash The hash that was signed.
* @return signer The address of the recovered signer.
*/
function recoverItemsSignature(
LoanLibrary.LoanTerms calldata loanTerms,
Signature calldata sig,
uint160 nonce,
Side side,
bytes32 itemsHash
) public view override returns (bytes32 sighash, address signer) {
bytes32 loanHash = keccak256(
abi.encode(
_ITEMS_TYPEHASH,
loanTerms.proratedInterestRate,
loanTerms.principal,
loanTerms.collateralAddress,
loanTerms.durationSecs,
itemsHash,
loanTerms.payableCurrency,
loanTerms.deadline,
loanTerms.affiliateCode,
nonce,
uint8(side)
)
);
sighash = _hashTypedDataV4(loanHash);
signer = ECDSA.recover(sighash, sig.v, sig.r, sig.s);
}
// ===================================== WHITELIST MANAGER UTILS =====================================
/**
* @notice Adds an array of payable currencies to the allowed currencies mapping.
*
* @dev Only callable by the whitelist manager role. Entire transaction reverts if one of the
* addresses is the zero address. The array of addresses passed to this
* function is limited to 50 elements.
*
* @param tokens Array of token addresses to add.
* @param currencyData Whether the token is allowed or not, and the minimum loan size.
*/
function setAllowedPayableCurrencies(
address[] calldata tokens,
Currency[] calldata currencyData
) external override onlyRole(WHITELIST_MANAGER_ROLE) {
if (tokens.length == 0) revert OC_ZeroArrayElements();
if (tokens.length > 50) revert OC_ArrayTooManyElements();
if (tokens.length != currencyData.length) revert OC_BatchLengthMismatch();
for (uint256 i = 0; i < tokens.length;) {
if (tokens[i] == address(0)) revert OC_ZeroAddress("token");
allowedCurrencies[tokens[i]] = currencyData[i];
emit SetAllowedCurrency(tokens[i], currencyData[i].isAllowed, currencyData[i].minPrincipal);
// Can never overflow because length is bounded by 50
unchecked {
i++;
}
}
}
/**
* @notice Return whether the address can be used as a loan funding currency.
*
* @param token The token to query.
*
* @return isAllowed Whether the contract is verified.
*/
function isAllowedCurrency(address token) public view override returns (bool) {
return allowedCurrencies[token].isAllowed;
}
/**
* @notice Adds an array collateral tokens to the allowed collateral mapping.
*
* @dev Only callable by the whitelist manager role. Entire transaction reverts if one of the
* addresses is the zero address. The array of addresses passed to this
* function is limited to 50 elements.
*
* @param tokens Array of token addresses to add.
* @param isAllowed Whether the token is allowed or not.
*/
function setAllowedCollateralAddresses(
address[] calldata tokens,
bool[] calldata isAllowed
) external override onlyRole(WHITELIST_MANAGER_ROLE) {
if (tokens.length == 0) revert OC_ZeroArrayElements();
if (tokens.length > 50) revert OC_ArrayTooManyElements();
if (tokens.length != isAllowed.length) revert OC_BatchLengthMismatch();
for (uint256 i = 0; i < tokens.length;) {
if (tokens[i] == address(0)) revert OC_ZeroAddress("token");
allowedCollateral[tokens[i]] = isAllowed[i];
emit SetAllowedCollateral(tokens[i], isAllowed[i]);
// Can never overflow because length is bounded by 50
unchecked {
i++;
}
}
}
/**
* @notice Return whether the address can be used as collateral.
*
* @param token The token to query.
*
* @return isAllowed Whether the token can be used as collateral.
*/
function isAllowedCollateral(address token) public view override returns (bool) {
return allowedCollateral[token];
}
/**
* @notice Batch update for verification whitelist, in case of multiple verifiers
* active in production.
*
* @param verifiers The list of specified verifier contracts, should implement ISignatureVerifier.
* @param isAllowed Whether the specified contracts should be allowed, respectively.
*/
function setAllowedVerifiers(
address[] calldata verifiers,
bool[] calldata isAllowed
) external override onlyRole(WHITELIST_MANAGER_ROLE) {
if (verifiers.length == 0) revert OC_ZeroArrayElements();
if (verifiers.length > 50) revert OC_ArrayTooManyElements();
if (verifiers.length != isAllowed.length) revert OC_BatchLengthMismatch();
for (uint256 i = 0; i < verifiers.length;) {
if (verifiers[i] == address(0)) revert OC_ZeroAddress("verifier");
allowedVerifiers[verifiers[i]] = isAllowed[i];
emit SetAllowedVerifier(verifiers[i], isAllowed[i]);
// Can never overflow because length is bounded by 50
unchecked {
i++;
}
}
}
/**
* @notice Return whether the address can be used as a verifier.
*
* @param verifier The verifier contract to query.
*
* @return isVerified Whether the contract is verified.
*/
function isAllowedVerifier(address verifier) public view override returns (bool) {
return allowedVerifiers[verifier];
}
// =========================================== HELPERS ==============================================
/**
* @dev Validates argument bounds for the loan terms.
*
* @param terms The terms of the loan.
*/
// solhint-disable-next-line code-complexity
function _validateLoanTerms(LoanLibrary.LoanTerms memory terms) internal virtual view {
// validate payable currency
if (!allowedCurrencies[terms.payableCurrency].isAllowed) revert OC_InvalidCurrency(terms.payableCurrency);
// principal must be greater than or equal to the configured minimum
if (terms.principal < allowedCurrencies[terms.payableCurrency].minPrincipal) revert OC_PrincipalTooLow(terms.principal);
// loan duration must be greater or equal to 1 hr and less or equal to 3 years
if (terms.durationSecs < 3600 || terms.durationSecs > 94_608_000) revert OC_LoanDuration(terms.durationSecs);
// interest rate must be greater than or equal to 0.01%
// and less or equal to 10,000% (1e6 basis points)
if (terms.proratedInterestRate < 1e18 || terms.proratedInterestRate > 1e24) revert OC_InterestRate(terms.proratedInterestRate);
// signature must not have already expired
if (terms.deadline < block.timestamp) revert OC_SignatureIsExpired(terms.deadline);
// validate collateral
if (!allowedCollateral[terms.collateralAddress]) revert OC_InvalidCollateral(terms.collateralAddress);
}
/**
* @dev Validate the rules for rolling over a loan - must be using the same
* currency and collateral.
*
* @param oldTerms The terms of the old loan, fetched from LoanCore.
* @param newTerms The terms of the new loan, provided by the caller.
*/
function _validateRollover(LoanLibrary.LoanTerms memory oldTerms, LoanLibrary.LoanTerms memory newTerms)
internal
pure
{
if (newTerms.payableCurrency != oldTerms.payableCurrency)
revert OC_RolloverCurrencyMismatch(oldTerms.payableCurrency, newTerms.payableCurrency);
if (newTerms.collateralAddress != oldTerms.collateralAddress || newTerms.collateralId != oldTerms.collateralId)
revert OC_RolloverCollateralMismatch(
oldTerms.collateralAddress,
oldTerms.collateralId,
newTerms.collateralAddress,
newTerms.collateralId
);
}
/**
* @dev Ensure that one counterparty has signed the loan terms, and the other
* has initiated the transaction.
*
* @param borrower The specified borrower for the loan.
* @param lender The specified lender for the loan.
* @param caller The address initiating the transaction.
* @param signer The address recovered from the loan terms signature.
* @param sig A struct containing the signature data (for checking EIP-1271).
* @param sighash The hash of the signature payload (used for EIP-1271 check).
* @param neededSide The side of the loan the signature will take (lend or borrow).
*/
// solhint-disable-next-line code-complexity
function _validateCounterparties(
address borrower,
address lender,
address caller,
address signer,
Signature calldata sig,
bytes32 sighash,
Side neededSide
) internal view {
address signingCounterparty = neededSide == Side.LEND ? lender : borrower;
address callingCounterparty = neededSide == Side.LEND ? borrower : lender;
// Make sure the signer recovered from the loan terms is not the caller,
// and even if the caller is approved, the caller is not the signing counterparty
if (caller == signer || caller == signingCounterparty) revert OC_ApprovedOwnLoan(caller);
// Check that caller can actually call this function - neededSide assignment
// defaults to BORROW if the signature is not approved by the borrower, but it could
// also not be a participant
if (!isSelfOrApproved(callingCounterparty, caller) && !isApprovedForContract(callingCounterparty, sig, sighash)) {
revert OC_CallerNotParticipant(msg.sender);
}
// Check signature validity
if (!isSelfOrApproved(signingCounterparty, signer) && !isApprovedForContract(signingCounterparty, sig, sighash)) {
revert OC_InvalidSignature(signingCounterparty, signer);
}
// Revert if the signer is the calling counterparty
if (signer == callingCounterparty) revert OC_SideMismatch(signer);
}
/**
* @notice Hashes each item in Predicate[] separately and concatenates these hashes for
* inclusion in _ITEMS_TYPEHASH.
*
* @dev Solidity does not support array or nested struct hashing in the keccak256 function
* hence the multi-step hash creation process.
*
* @param predicates The predicate items array.
*
* @return itemsHash The concatenated hash of all items in the Predicate array.
*/
function _encodePredicates(LoanLibrary.Predicate[] memory predicates) public pure returns (bytes32 itemsHash) {
bytes32[] memory itemHashes = new bytes32[](predicates.length);
for (uint i = 0; i < predicates.length;){
itemHashes[i] = keccak256(
abi.encode(
_PREDICATE_TYPEHASH,
keccak256(predicates[i].data),
predicates[i].verifier
)
);
// Predicates is calldata, overflow is impossible bc of calldata
// size limits vis-a-vis gas
unchecked {
i++;
}
}
// concatenate all predicate hashes
itemsHash = keccak256(abi.encodePacked(itemHashes));
}
/**
* @dev Run the predicates check for an items signature, sending the defined
* predicate payload to each defined verifier contract, and reverting
* if a verifier returns false.
*
* @param borrower The borrower of the loan.
* @param lender The lender of the loan.
* @param loanTerms The terms of the loan.
* @param itemPredicates The array of predicates to check.
*/
function _runPredicatesCheck(
address borrower,
address lender,
LoanLibrary.LoanTerms memory loanTerms,
LoanLibrary.Predicate[] calldata itemPredicates
) internal view {
for (uint256 i = 0; i < itemPredicates.length;) {
// Verify items are held in the wrapper
address verifier = itemPredicates[i].verifier;
if (!isAllowedVerifier(verifier)) revert OC_InvalidVerifier(verifier);
if (!ISignatureVerifier(verifier).verifyPredicates(
borrower,
lender,
loanTerms.collateralAddress,
loanTerms.collateralId,
itemPredicates[i].data
)) {
revert OC_PredicateFailed(
verifier,
borrower,
lender,
loanTerms.collateralAddress,
loanTerms.collateralId,
itemPredicates[i].data
);
}
// Predicates is calldata, overflow is impossible bc of calldata
// size limits vis-a-vis gas
unchecked {
i++;
}
}
}
/**
* @dev Perform loan initialization. Take custody of both principal and
* collateral, and tell LoanCore to create and start a loan.
*
* @param loanTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
*
* @return loanId The unique ID of the new loan.
*/
function _initialize(
LoanLibrary.LoanTerms calldata loanTerms,
address borrower,
address lender
) internal nonReentrant returns (uint256 loanId) {
// get lending origination fees from fee controller
IFeeController.FeesOrigination memory feeData = feeController.getFeesOrigination();
// create LoanLibrary.FeeSnapshot struct from feeData
LoanLibrary.FeeSnapshot memory feeSnapshot = LoanLibrary.FeeSnapshot({
lenderDefaultFee: feeData.lenderDefaultFee,
lenderInterestFee: feeData.lenderInterestFee,
lenderPrincipalFee: feeData.lenderPrincipalFee
});
uint256 borrowerFee = (loanTerms.principal * feeData.borrowerOriginationFee) / BASIS_POINTS_DENOMINATOR;
uint256 lenderFee = (loanTerms.principal * feeData.lenderOriginationFee) / BASIS_POINTS_DENOMINATOR;
// Determine settlement amounts based on fees
uint256 amountFromLender = loanTerms.principal + lenderFee;
uint256 amountToBorrower = loanTerms.principal - borrowerFee;
loanId = loanCore.startLoan(lender, borrower, loanTerms, amountFromLender, amountToBorrower, feeSnapshot);
}
/**
* @dev Perform loan rollover. Take custody of both principal and
* collateral, and tell LoanCore to roll over the existing loan.
*
* @param oldLoanId The ID of the loan to be rolled over.
* @param newTerms The terms agreed by the lender and borrower.
* @param borrower Address of the borrower.
* @param lender Address of the lender.
*
* @return loanId The unique ID of the new loan.
*/
function _rollover(
uint256 oldLoanId,
LoanLibrary.LoanTerms calldata newTerms,
address borrower,
address lender
) internal nonReentrant returns (uint256 loanId) {
LoanLibrary.LoanData memory oldLoanData = loanCore.getLoan(oldLoanId);
LoanLibrary.LoanTerms memory oldTerms = oldLoanData.terms;
address oldLender = loanCore.lenderNote().ownerOf(oldLoanId);
IERC20 payableCurrency = IERC20(oldTerms.payableCurrency);
// Calculate settle amounts
RolloverAmounts memory amounts = _calculateRolloverAmounts(
oldTerms,
newTerms,
lender,
oldLender
);
// Collect funds based on settle amounts and total them
uint256 settledAmount;
if (lender != oldLender) {
// If new lender, take new principal from new lender
payableCurrency.safeTransferFrom(lender, address(this), amounts.amountFromLender);
settledAmount += amounts.amountFromLender;
}
if (amounts.needFromBorrower > 0) {
// Borrower owes from old loan
payableCurrency.safeTransferFrom(borrower, address(this), amounts.needFromBorrower);
settledAmount += amounts.needFromBorrower;
} else if (amounts.leftoverPrincipal > 0 && lender == oldLender) {
// If same lender, and new amount from lender is greater than old loan repayment amount,
// take the difference from the lender
payableCurrency.safeTransferFrom(lender, address(this), amounts.leftoverPrincipal);
settledAmount += amounts.leftoverPrincipal;
}
// approve LoanCore to take the total settled amount
payableCurrency.approve(address(loanCore), settledAmount);
loanId = loanCore.rollover(
oldLoanId,
borrower,
lender,
newTerms,
settledAmount,
amounts.amountToOldLender,
amounts.amountToLender,
amounts.amountToBorrower
);
}
/**
* @dev Calculate the net amounts needed for the rollover from each party - the
* borrower, the new lender, and the old lender (can be same as new lender).
* Determine the amount to either pay or withdraw from the borrower, and
* any payments to be sent to the old lender.
*
* @param oldTerms The terms struct for the old loan.
* @param newTerms The terms struct for the new loan.
* @param lender The lender for the new loan.
* @param oldLender The lender for the existing loan.
*
* @return amounts The net amounts owed to each party.
*/
function _calculateRolloverAmounts(
LoanLibrary.LoanTerms memory oldTerms,
LoanLibrary.LoanTerms calldata newTerms,
address lender,
address oldLender
) internal view returns (RolloverAmounts memory amounts) {
// get rollover fees
IFeeController.FeesRollover memory feeData = feeController.getFeesRollover();
// Calculate repay amount of old loan
uint256 interest = getInterestAmount(oldTerms.principal, oldTerms.proratedInterestRate);
uint256 repayAmount = oldTerms.principal + interest;
// Calculate amount to be sent to borrower for new loan minus rollover fees
uint256 borrowerFee = (newTerms.principal * feeData.borrowerRolloverFee) / BASIS_POINTS_DENOMINATOR;
uint256 borrowerOwedForNewLoan = newTerms.principal - borrowerFee;
// Calculate amount to be collected from the lender for new loan plus rollover fees
uint256 lenderFee = (newTerms.principal * feeData.lenderRolloverFee) / BASIS_POINTS_DENOMINATOR;
amounts.amountFromLender = newTerms.principal + lenderFee;
// Calculate net amounts based on if repayment amount for old loan is greater than
// new loan principal minus fees
if (repayAmount > borrowerOwedForNewLoan) {
// amount to collect from borrower
// new loan principal is less than old loan repayment amount
unchecked {
amounts.needFromBorrower = repayAmount - borrowerOwedForNewLoan;
}
} else {
// amount to collect from lender (either old or new)
amounts.leftoverPrincipal = amounts.amountFromLender - repayAmount;
// amount to send to borrower
unchecked {
amounts.amountToBorrower = borrowerOwedForNewLoan - repayAmount;
}
}
// Calculate lender amounts based on if the lender is the same as the old lender
if (lender != oldLender) {
// different lenders, repay old lender
amounts.amountToOldLender = repayAmount;
// different lender, new lender is owed zero tokens
amounts.amountToLender = 0;
} else {
// same lender
amounts.amountToOldLender = 0;
// same lender, so check if the amount to collect from the lender is less than
// the amount the lender is owed for the old loan. If so, the lender is owed the
// difference
if (amounts.needFromBorrower > 0 && repayAmount > amounts.amountFromLender) {
unchecked {
amounts.amountToLender = repayAmount - amounts.amountFromLender;
}
}
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev Contract module that helps prevent reentrant calls to a function.
*
* Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
* available, which can be applied to functions to make sure there are no nested
* (reentrant) calls to them.
*
* Note that because there is a single `nonReentrant` guard, functions marked as
* `nonReentrant` may not call one another. This can be worked around by making
* those functions `private`, and then adding `external` `nonReentrant` entry
* points to them.
*
* TIP: If you would like to learn more about reentrancy and alternative ways
* to protect against it, check out our blog post
* https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
*/
abstract contract ReentrancyGuard {
// Booleans are more expensive than uint256 or any type that takes up a full
// word because each write operation emits an extra SLOAD to first read the
// slot's contents, replace the bits taken up by the boolean, and then write
// back. This is the compiler's defense against contract upgrades and
// pointer aliasing, and it cannot be disabled.
// The values being non-zero value makes deployment a bit more expensive,
// but in exchange the refund on every call to nonReentrant will be lower in
// amount. Since refunds are capped to a percentage of the total
// transaction's gas, it is best to keep them low in cases like this one, to
// increase the likelihood of the full refund coming into effect.
uint256 private constant _NOT_ENTERED = 1;
uint256 private constant _ENTERED = 2;
uint256 private _status;
constructor() {
_status = _NOT_ENTERED;
}
/**
* @dev Prevents a contract from calling itself, directly or indirectly.
* Calling a `nonReentrant` function from another `nonReentrant`
* function is not supported. It is possible to prevent this from happening
* by making the `nonReentrant` function external, and make it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
// On the first call to nonReentrant, _notEntered will be true
require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
// Any calls to nonReentrant after this point will fail
_status = _ENTERED;
_;
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
_status = _NOT_ENTERED;
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
function safeTransfer(
IERC20 token,
address to,
uint256 value
) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
function safeTransferFrom(
IERC20 token,
address from,
address to,
uint256 value
) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(
IERC20 token,
address spender,
uint256 value
) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
function safeIncreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
uint256 newAllowance = token.allowance(address(this), spender) + value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
function safeDecreaseAllowance(
IERC20 token,
address spender,
uint256 value
) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
uint256 newAllowance = oldAllowance - value;
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
}
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
if (returndata.length > 0) {
// Return data is optional
require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _HEX_SYMBOLS = "0123456789abcdef";
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
// Inspired by OraclizeAPI's implementation - MIT licence
// https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol
if (value == 0) {
return "0";
}
uint256 temp = value;
uint256 digits;
while (temp != 0) {
digits++;
temp /= 10;
}
bytes memory buffer = new bytes(digits);
while (value != 0) {
digits -= 1;
buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
value /= 10;
}
return string(buffer);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
if (value == 0) {
return "0x00";
}
uint256 temp = value;
uint256 length = 0;
while (temp != 0) {
length++;
temp >>= 8;
}
return toHexString(value, length);
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _HEX_SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "./ECDSA.sol";
/**
* @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
*
* The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
* thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
* they need in their contracts using a combination of `abi.encode` and `keccak256`.
*
* This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
* scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
* ({_hashTypedDataV4}).
*
* The implementation of the domain separator was designed to be as efficient as possible while still properly updating
* the chain id to protect against replay attacks on an eventual fork of the chain.
*
* NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
* https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
*
* _Available since v3.4._
*/
abstract contract EIP712 {
/* solhint-disable var-name-mixedcase */
// Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to
// invalidate the cached domain separator if the chain id changes.
bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;
uint256 private immutable _CACHED_CHAIN_ID;
bytes32 private immutable _HASHED_NAME;
bytes32 private immutable _HASHED_VERSION;
bytes32 private immutable _TYPE_HASH;
/* solhint-enable var-name-mixedcase */
/**
* @dev Initializes the domain separator and parameter caches.
*
* The meaning of `name` and `version` is specified in
* https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
*
* - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
* - `version`: the current major version of the signing domain.
*
* NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
* contract upgrade].
*/
constructor(string memory name, string memory version) {
bytes32 hashedName = keccak256(bytes(name));
bytes32 hashedVersion = keccak256(bytes(version));
bytes32 typeHash = keccak256(
"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)"
);
_HASHED_NAME = hashedName;
_HASHED_VERSION = hashedVersion;
_CACHED_CHAIN_ID = block.chainid;
_CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);
_TYPE_HASH = typeHash;
}
/**
* @dev Returns the domain separator for the current chain.
*/
function _domainSeparatorV4() internal view returns (bytes32) {
if (block.chainid == _CACHED_CHAIN_ID) {
return _CACHED_DOMAIN_SEPARATOR;
} else {
return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);
}
}
function _buildDomainSeparator(
bytes32 typeHash,
bytes32 nameHash,
bytes32 versionHash
) private view returns (bytes32) {
return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, address(this)));
}
/**
* @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
* function returns the hash of the fully encoded EIP712 message for this domain.
*
* This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
*
* ```solidity
* bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
* keccak256("Mail(address to,string contents)"),
* mailTo,
* keccak256(bytes(mailContents))
* )));
* address signer = ECDSA.recover(digest, signature);
* ```
*/
function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);
}
}
{
"compilationTarget": {
"contracts/OriginationController.sol": "OriginationController"
},
"evmVersion": "paris",
"libraries": {},
"metadata": {
"bytecodeHash": "none"
},
"optimizer": {
"enabled": true,
"runs": 200
},
"remappings": []
}
[{"inputs":[{"internalType":"address","name":"_loanCore","type":"address"},{"internalType":"address","name":"_feeController","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"OC_ApprovedOwnLoan","type":"error"},{"inputs":[],"name":"OC_ArrayTooManyElements","type":"error"},{"inputs":[],"name":"OC_BatchLengthMismatch","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"OC_CallerNotParticipant","type":"error"},{"inputs":[{"internalType":"uint256","name":"interestRate","type":"uint256"}],"name":"OC_InterestRate","type":"error"},{"inputs":[{"internalType":"address","name":"collateralAddress","type":"address"}],"name":"OC_InvalidCollateral","type":"error"},{"inputs":[{"internalType":"address","name":"payableCurrency","type":"address"}],"name":"OC_InvalidCurrency","type":"error"},{"inputs":[{"internalType":"address","name":"target","type":"address"},{"internalType":"address","name":"signer","type":"address"}],"name":"OC_InvalidSignature","type":"error"},{"inputs":[{"internalType":"enum LoanLibrary.LoanState","name":"state","type":"uint8"}],"name":"OC_InvalidState","type":"error"},{"inputs":[{"internalType":"address","name":"verifier","type":"address"}],"name":"OC_InvalidVerifier","type":"error"},{"inputs":[{"internalType":"uint256","name":"durationSecs","type":"uint256"}],"name":"OC_LoanDuration","type":"error"},{"inputs":[{"internalType":"address","name":"borrower","type":"address"},{"internalType":"address","name":"lender","type":"address"},{"internalType":"address","name":"verifier","type":"address"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"OC_PredicateFailed","type":"error"},{"inputs":[],"name":"OC_PredicatesArrayEmpty","type":"error"},{"inputs":[{"internalType":"uint256","name":"principal","type":"uint256"}],"name":"OC_PrincipalTooLow","type":"error"},{"inputs":[{"internalType":"address","name":"oldCollateralAddress","type":"address"},{"internalType":"uint256","name":"oldCollateralId","type":"uint256"},{"internalType":"address","name":"newCollateralAddress","type":"address"},{"internalType":"uint256","name":"newCollateralId","type":"uint256"}],"name":"OC_RolloverCollateralMismatch","type":"error"},{"inputs":[{"internalType":"address","name":"oldCurrency","type":"address"},{"internalType":"address","name":"newCurrency","type":"address"}],"name":"OC_RolloverCurrencyMismatch","type":"error"},{"inputs":[{"internalType":"address","name":"caller","type":"address"}],"name":"OC_SelfApprove","type":"error"},{"inputs":[{"internalType":"address","name":"signer","type":"address"}],"name":"OC_SideMismatch","type":"error"},{"inputs":[{"internalType":"uint256","name":"deadline","type":"uint256"}],"name":"OC_SignatureIsExpired","type":"error"},{"inputs":[{"internalType":"string","name":"addressType","type":"string"}],"name":"OC_ZeroAddress","type":"error"},{"inputs":[],"name":"OC_ZeroArrayElements","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"signer","type":"address"},{"indexed":false,"internalType":"bool","name":"isApproved","type":"bool"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"collateral","type":"address"},{"indexed":false,"internalType":"bool","name":"isAllowed","type":"bool"}],"name":"SetAllowedCollateral","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"currency","type":"address"},{"indexed":false,"internalType":"bool","name":"isAllowed","type":"bool"},{"indexed":false,"internalType":"uint256","name":"minPrincipal","type":"uint256"}],"name":"SetAllowedCurrency","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"verifier","type":"address"},{"indexed":false,"internalType":"bool","name":"isAllowed","type":"bool"}],"name":"SetAllowedVerifier","type":"event"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BASIS_POINTS_DENOMINATOR","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_01","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_02","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_03","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_04","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_05","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_06","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_07","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"FL_08","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"INTEREST_RATE_DENOMINATOR","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"WHITELIST_MANAGER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"_PREDICATE_TYPEHASH","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"address","name":"verifier","type":"address"}],"internalType":"struct LoanLibrary.Predicate[]","name":"predicates","type":"tuple[]"}],"name":"_encodePredicates","outputs":[{"internalType":"bytes32","name":"itemsHash","type":"bytes32"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"allowedCollateral","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"allowedCurrencies","outputs":[{"internalType":"bool","name":"isAllowed","type":"bool"},{"internalType":"uint256","name":"minPrincipal","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"allowedVerifiers","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"signer","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"}],"name":"getInterestAmount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"borrower","type":"address"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"}],"name":"initializeLoan","outputs":[{"internalType":"uint256","name":"loanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"borrower","type":"address"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"collateralSig","type":"tuple"},{"internalType":"uint256","name":"permitDeadline","type":"uint256"}],"name":"initializeLoanWithCollateralPermit","outputs":[{"internalType":"uint256","name":"loanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"borrower","type":"address"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"collateralSig","type":"tuple"},{"internalType":"uint256","name":"permitDeadline","type":"uint256"},{"components":[{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"address","name":"verifier","type":"address"}],"internalType":"struct LoanLibrary.Predicate[]","name":"itemPredicates","type":"tuple[]"}],"name":"initializeLoanWithCollateralPermitAndItems","outputs":[{"internalType":"uint256","name":"loanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"borrower","type":"address"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"components":[{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"address","name":"verifier","type":"address"}],"internalType":"struct LoanLibrary.Predicate[]","name":"itemPredicates","type":"tuple[]"}],"name":"initializeLoanWithItems","outputs":[{"internalType":"uint256","name":"loanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"isAllowedCollateral","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"token","type":"address"}],"name":"isAllowedCurrency","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"verifier","type":"address"}],"name":"isAllowedVerifier","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"signer","type":"address"}],"name":"isApproved","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"bytes32","name":"sighash","type":"bytes32"}],"name":"isApprovedForContract","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"},{"internalType":"address","name":"signer","type":"address"}],"name":"isSelfOrApproved","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"internalType":"enum IOriginationController.Side","name":"side","type":"uint8"},{"internalType":"bytes32","name":"itemsHash","type":"bytes32"}],"name":"recoverItemsSignature","outputs":[{"internalType":"bytes32","name":"sighash","type":"bytes32"},{"internalType":"address","name":"signer","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"internalType":"enum IOriginationController.Side","name":"side","type":"uint8"}],"name":"recoverTokenSignature","outputs":[{"internalType":"bytes32","name":"sighash","type":"bytes32"},{"internalType":"address","name":"signer","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"oldLoanId","type":"uint256"},{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"}],"name":"rolloverLoan","outputs":[{"internalType":"uint256","name":"newLoanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"oldLoanId","type":"uint256"},{"components":[{"internalType":"uint256","name":"proratedInterestRate","type":"uint256"},{"internalType":"uint256","name":"principal","type":"uint256"},{"internalType":"address","name":"collateralAddress","type":"address"},{"internalType":"uint96","name":"durationSecs","type":"uint96"},{"internalType":"uint256","name":"collateralId","type":"uint256"},{"internalType":"address","name":"payableCurrency","type":"address"},{"internalType":"uint96","name":"deadline","type":"uint96"},{"internalType":"bytes32","name":"affiliateCode","type":"bytes32"}],"internalType":"struct LoanLibrary.LoanTerms","name":"loanTerms","type":"tuple"},{"internalType":"address","name":"lender","type":"address"},{"components":[{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"},{"internalType":"bytes","name":"extraData","type":"bytes"}],"internalType":"struct IOriginationController.Signature","name":"sig","type":"tuple"},{"internalType":"uint160","name":"nonce","type":"uint160"},{"components":[{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"address","name":"verifier","type":"address"}],"internalType":"struct LoanLibrary.Predicate[]","name":"itemPredicates","type":"tuple[]"}],"name":"rolloverLoanWithItems","outputs":[{"internalType":"uint256","name":"newLoanId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"tokens","type":"address[]"},{"internalType":"bool[]","name":"isAllowed","type":"bool[]"}],"name":"setAllowedCollateralAddresses","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"tokens","type":"address[]"},{"components":[{"internalType":"bool","name":"isAllowed","type":"bool"},{"internalType":"uint256","name":"minPrincipal","type":"uint256"}],"internalType":"struct IOriginationController.Currency[]","name":"currencyData","type":"tuple[]"}],"name":"setAllowedPayableCurrencies","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"verifiers","type":"address[]"},{"internalType":"bool[]","name":"isAllowed","type":"bool[]"}],"name":"setAllowedVerifiers","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"}]